@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
|
@@ -19,12 +19,12 @@ import fs from 'fs';
|
|
|
19
19
|
import os from 'os';
|
|
20
20
|
import path from 'path';
|
|
21
21
|
import { Hono } from 'hono';
|
|
22
|
-
import {
|
|
22
|
+
import { vi, afterAll, afterEach, expect, test } from 'vitest';
|
|
23
23
|
|
|
24
|
-
const mockLaunch =
|
|
25
|
-
|
|
24
|
+
const mockLaunch = vi.fn();
|
|
25
|
+
vi.doMock('playwright-core', () => ({
|
|
26
26
|
chromium: { launch: mockLaunch },
|
|
27
|
-
selectors: { register:
|
|
27
|
+
selectors: { register: vi.fn(async () => {}) },
|
|
28
28
|
}));
|
|
29
29
|
|
|
30
30
|
// openPage takes its browser as a parameter, so a fake one covers the cookie
|
|
@@ -56,26 +56,26 @@ afterEach(async () => {
|
|
|
56
56
|
});
|
|
57
57
|
|
|
58
58
|
function createBrowser() {
|
|
59
|
-
const addCookies =
|
|
59
|
+
const addCookies = vi.fn();
|
|
60
60
|
const page = {
|
|
61
|
-
goto:
|
|
62
|
-
waitForFunction:
|
|
61
|
+
goto: vi.fn().mockResolvedValue(undefined),
|
|
62
|
+
waitForFunction: vi.fn().mockResolvedValue(undefined),
|
|
63
63
|
};
|
|
64
64
|
// Like Playwright's, the context emits close once, when it first closes.
|
|
65
65
|
const context = Object.assign(new EventEmitter(), {
|
|
66
66
|
addCookies,
|
|
67
|
-
newPage:
|
|
68
|
-
route:
|
|
67
|
+
newPage: vi.fn().mockResolvedValue(page),
|
|
68
|
+
route: vi.fn().mockResolvedValue(undefined),
|
|
69
69
|
});
|
|
70
70
|
let closed = false;
|
|
71
|
-
context.close =
|
|
71
|
+
context.close = vi.fn(async () => {
|
|
72
72
|
if (closed) return;
|
|
73
73
|
closed = true;
|
|
74
74
|
context.emit('close');
|
|
75
75
|
});
|
|
76
76
|
openedContexts.push(context);
|
|
77
77
|
return {
|
|
78
|
-
browser: { newContext:
|
|
78
|
+
browser: { newContext: vi.fn().mockResolvedValue(context) },
|
|
79
79
|
addCookies,
|
|
80
80
|
context,
|
|
81
81
|
page,
|
|
@@ -465,7 +465,7 @@ test('openPage aborts and records a data set journey request to the dev server p
|
|
|
465
465
|
}
|
|
466
466
|
const route = {
|
|
467
467
|
request: () => ({ url: () => 'http://127.0.0.1:3001/api/page/tickets' }),
|
|
468
|
-
abort:
|
|
468
|
+
abort: vi.fn(async () => {}),
|
|
469
469
|
};
|
|
470
470
|
await handle(route);
|
|
471
471
|
expect(route.abort).toHaveBeenCalledTimes(1);
|
|
@@ -489,11 +489,27 @@ test('openPage routes nothing and records no departures without a dataCookie', a
|
|
|
489
489
|
});
|
|
490
490
|
|
|
491
491
|
test('a failed openPage closes its context, so the idle browser still closes', async () => {
|
|
492
|
-
|
|
492
|
+
vi.useFakeTimers({
|
|
493
|
+
toFake: [
|
|
494
|
+
'Date',
|
|
495
|
+
'hrtime',
|
|
496
|
+
'queueMicrotask',
|
|
497
|
+
'requestAnimationFrame',
|
|
498
|
+
'cancelAnimationFrame',
|
|
499
|
+
'requestIdleCallback',
|
|
500
|
+
'cancelIdleCallback',
|
|
501
|
+
'setImmediate',
|
|
502
|
+
'clearImmediate',
|
|
503
|
+
'setInterval',
|
|
504
|
+
'clearInterval',
|
|
505
|
+
'setTimeout',
|
|
506
|
+
'clearTimeout',
|
|
507
|
+
],
|
|
508
|
+
});
|
|
493
509
|
try {
|
|
494
510
|
const { browser, page } = createBrowser();
|
|
495
511
|
browser.isConnected = () => true;
|
|
496
|
-
browser.close =
|
|
512
|
+
browser.close = vi.fn(async () => {});
|
|
497
513
|
mockLaunch.mockResolvedValue(browser);
|
|
498
514
|
page.goto.mockRejectedValue(new Error('net::ERR_CONNECTION_REFUSED'));
|
|
499
515
|
|
|
@@ -501,13 +517,13 @@ test('a failed openPage closes its context, so the idle browser still closes', a
|
|
|
501
517
|
await expect(
|
|
502
518
|
openPage({ browser: launched, origin: 'http://localhost:3001', pageId: 'home' })
|
|
503
519
|
).rejects.toThrow('net::ERR_CONNECTION_REFUSED');
|
|
504
|
-
|
|
520
|
+
vi.advanceTimersByTime(45_000);
|
|
505
521
|
for (let i = 0; i < 5; i += 1) {
|
|
506
522
|
await Promise.resolve();
|
|
507
523
|
}
|
|
508
524
|
|
|
509
525
|
expect(browser.close).toHaveBeenCalledTimes(1);
|
|
510
526
|
} finally {
|
|
511
|
-
|
|
527
|
+
vi.useRealTimers();
|
|
512
528
|
}
|
|
513
529
|
});
|
|
@@ -17,6 +17,7 @@
|
|
|
17
17
|
import fs from 'node:fs';
|
|
18
18
|
import os from 'node:os';
|
|
19
19
|
import path from 'node:path';
|
|
20
|
+
import { afterEach, expect, test } from 'vitest';
|
|
20
21
|
|
|
21
22
|
// getBuildId reads build/buildStatus.json and build/invalidatePages from
|
|
22
23
|
// process.cwd(): point it at a throwaway server directory.
|
|
@@ -32,6 +32,30 @@ function splitByBuild({ entries, buildId }) {
|
|
|
32
32
|
};
|
|
33
33
|
}
|
|
34
34
|
|
|
35
|
+
// buildStatus.json covers the config build only; pages build later, on first
|
|
36
|
+
// request. So that build.status alone answers "does the app build", an ok
|
|
37
|
+
// config build with a failed page reads pages_failed, and failedPages names
|
|
38
|
+
// those pages. A failed page changed since that build is left out: its failure
|
|
39
|
+
// may already be fixed, and pages.changedSinceBuild lists it until it is
|
|
40
|
+
// rebuilt. A config build that is not ok keeps its status and names no pages,
|
|
41
|
+
// since the config is what to fix first. The page errors stay under
|
|
42
|
+
// pages.failed either way. configStatus keeps the config build's own status for
|
|
43
|
+
// callers that wait on a published config build, whatever the pages do.
|
|
44
|
+
function withFailedPages({ build, pages }) {
|
|
45
|
+
const configBuild = { ...build, configStatus: build.status };
|
|
46
|
+
if (build.status !== 'ok') {
|
|
47
|
+
return configBuild;
|
|
48
|
+
}
|
|
49
|
+
const changedSinceBuild = new Set(pages.changedSinceBuild ?? []);
|
|
50
|
+
const failedPages = (pages.failed ?? [])
|
|
51
|
+
.map(({ pageId }) => pageId)
|
|
52
|
+
.filter((pageId) => !changedSinceBuild.has(pageId));
|
|
53
|
+
if (failedPages.length === 0) {
|
|
54
|
+
return configBuild;
|
|
55
|
+
}
|
|
56
|
+
return { ...configBuild, status: 'pages_failed', failedPages };
|
|
57
|
+
}
|
|
58
|
+
|
|
35
59
|
// Notices about Lowdefy's agent block (see checkAgentFiles), checked on every
|
|
36
60
|
// read: the root files are not watched, so a stored result would outlive a fix.
|
|
37
61
|
async function getAgentFiles() {
|
|
@@ -43,7 +67,8 @@ async function getAgentFiles() {
|
|
|
43
67
|
}
|
|
44
68
|
|
|
45
69
|
// Feedback loop for agents: build status (written by the build manager to
|
|
46
|
-
// build/buildStatus.json
|
|
70
|
+
// build/buildStatus.json, with page failures folded in by withFailedPages),
|
|
71
|
+
// the page builds (see getPageBuildStatus), plus
|
|
47
72
|
// recent browser errors reported via POST /api/client-error, plus recent server
|
|
48
73
|
// errors (request, endpoint, MCP and agent tool failures) collected by
|
|
49
74
|
// createHandleError. Lets an agent check "did my last edit work?" without
|
|
@@ -61,10 +86,11 @@ async function getBuildStatus({ checked } = {}) {
|
|
|
61
86
|
const buildId = getBuildId();
|
|
62
87
|
const clientErrors = splitByBuild({ entries: clientErrorStore.list(), buildId });
|
|
63
88
|
const serverErrors = splitByBuild({ entries: serverErrorStore.list(), buildId });
|
|
89
|
+
const pages = await getPageBuildStatus({ checked });
|
|
64
90
|
const status = {
|
|
65
91
|
buildId,
|
|
66
|
-
build,
|
|
67
|
-
pages
|
|
92
|
+
build: withFailedPages({ build, pages }),
|
|
93
|
+
pages,
|
|
68
94
|
clientErrors: clientErrors.current,
|
|
69
95
|
serverErrors: serverErrors.current,
|
|
70
96
|
};
|
|
@@ -17,21 +17,117 @@
|
|
|
17
17
|
import fs from 'fs';
|
|
18
18
|
import os from 'os';
|
|
19
19
|
import path from 'path';
|
|
20
|
-
import {
|
|
21
|
-
|
|
22
|
-
const mockClientErrors =
|
|
23
|
-
|
|
24
|
-
const mockServerErrors =
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
const mockGetPageBuildStatus =
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
}));
|
|
20
|
+
import { vi, afterEach, beforeEach, describe, expect, test } from 'vitest';
|
|
21
|
+
|
|
22
|
+
const mockClientErrors = vi.fn();
|
|
23
|
+
vi.doMock('./clientErrorStore.js', () => ({ default: { list: mockClientErrors } }));
|
|
24
|
+
const mockServerErrors = vi.fn();
|
|
25
|
+
vi.doMock('./serverErrorStore.js', () => ({ default: { list: mockServerErrors } }));
|
|
26
|
+
vi.doMock('./getBuildId.js', () => ({ default: () => 'build-2' }));
|
|
27
|
+
const mockGetPageBuildStatus = vi.fn(() => ({ unbuilt: 0 }));
|
|
28
|
+
vi.doMock('./getPageBuildStatus.js', () => ({ default: mockGetPageBuildStatus }));
|
|
29
|
+
const okBuild = () => ({ status: 'ok', errors: [], warnings: ['a build warning'] });
|
|
30
|
+
const mockReadBuildArtifact = vi.fn(okBuild);
|
|
31
|
+
vi.doMock('./readBuildArtifact.js', () => ({ default: mockReadBuildArtifact }));
|
|
32
32
|
|
|
33
33
|
const { default: getBuildStatus } = await import('./getBuildStatus.js');
|
|
34
34
|
|
|
35
|
+
describe('page failures in build.status', () => {
|
|
36
|
+
const failed = [
|
|
37
|
+
{ pageId: 'orders', errors: [{ type: 'ConfigError', message: 'Bad.', source: null }] },
|
|
38
|
+
{ pageId: 'invoices', errors: [{ type: 'ConfigError', message: 'Worse.', source: null }] },
|
|
39
|
+
];
|
|
40
|
+
|
|
41
|
+
beforeEach(() => {
|
|
42
|
+
mockClientErrors.mockReturnValue([]);
|
|
43
|
+
mockServerErrors.mockReturnValue([]);
|
|
44
|
+
});
|
|
45
|
+
|
|
46
|
+
afterEach(() => {
|
|
47
|
+
mockReadBuildArtifact.mockImplementation(okBuild);
|
|
48
|
+
mockGetPageBuildStatus.mockImplementation(() => ({ unbuilt: 0 }));
|
|
49
|
+
});
|
|
50
|
+
|
|
51
|
+
test('reads pages_failed and names the pages when the config builds but a page fails', async () => {
|
|
52
|
+
mockGetPageBuildStatus.mockResolvedValue({ failed, unbuilt: 0 });
|
|
53
|
+
|
|
54
|
+
const status = await getBuildStatus();
|
|
55
|
+
|
|
56
|
+
expect(status.build).toEqual({
|
|
57
|
+
status: 'pages_failed',
|
|
58
|
+
configStatus: 'ok',
|
|
59
|
+
errors: [],
|
|
60
|
+
warnings: ['a build warning'],
|
|
61
|
+
failedPages: ['orders', 'invoices'],
|
|
62
|
+
});
|
|
63
|
+
expect(status.pages.failed).toEqual(failed);
|
|
64
|
+
});
|
|
65
|
+
|
|
66
|
+
test('keeps error and names no pages when the config build failed too', async () => {
|
|
67
|
+
mockReadBuildArtifact.mockReturnValue({
|
|
68
|
+
status: 'error',
|
|
69
|
+
errors: ['Bad config.'],
|
|
70
|
+
warnings: [],
|
|
71
|
+
});
|
|
72
|
+
mockGetPageBuildStatus.mockResolvedValue({ failed: failed.slice(0, 1), unbuilt: 0 });
|
|
73
|
+
|
|
74
|
+
const status = await getBuildStatus();
|
|
75
|
+
|
|
76
|
+
expect(status.build.status).toBe('error');
|
|
77
|
+
expect(status.build.configStatus).toBe('error');
|
|
78
|
+
expect(status.build).not.toHaveProperty('failedPages');
|
|
79
|
+
expect(status.pages.failed).toEqual(failed.slice(0, 1));
|
|
80
|
+
});
|
|
81
|
+
|
|
82
|
+
test('keeps unknown and names no pages before the first config build is written', async () => {
|
|
83
|
+
mockReadBuildArtifact.mockReturnValue(null);
|
|
84
|
+
mockGetPageBuildStatus.mockResolvedValue({ failed, unbuilt: 0 });
|
|
85
|
+
|
|
86
|
+
const { build } = await getBuildStatus();
|
|
87
|
+
|
|
88
|
+
expect(build.status).toBe('unknown');
|
|
89
|
+
expect(build.configStatus).toBe('unknown');
|
|
90
|
+
expect(build).not.toHaveProperty('failedPages');
|
|
91
|
+
});
|
|
92
|
+
|
|
93
|
+
test('leaves out a failed page changed since its last build, since its failure may be fixed', async () => {
|
|
94
|
+
mockGetPageBuildStatus.mockResolvedValue({
|
|
95
|
+
failed,
|
|
96
|
+
changedSinceBuild: ['orders'],
|
|
97
|
+
unbuilt: 0,
|
|
98
|
+
});
|
|
99
|
+
|
|
100
|
+
const { build } = await getBuildStatus();
|
|
101
|
+
|
|
102
|
+
expect(build.status).toBe('pages_failed');
|
|
103
|
+
expect(build.failedPages).toEqual(['invoices']);
|
|
104
|
+
});
|
|
105
|
+
|
|
106
|
+
test('stays ok when every failed page has changed since its last build', async () => {
|
|
107
|
+
mockGetPageBuildStatus.mockResolvedValue({
|
|
108
|
+
failed: failed.slice(0, 1),
|
|
109
|
+
changedSinceBuild: ['orders', 'home'],
|
|
110
|
+
unbuilt: 0,
|
|
111
|
+
});
|
|
112
|
+
|
|
113
|
+
const status = await getBuildStatus();
|
|
114
|
+
|
|
115
|
+
expect(status.build.status).toBe('ok');
|
|
116
|
+
expect(status.build).not.toHaveProperty('failedPages');
|
|
117
|
+
expect(status.pages.failed).toEqual(failed.slice(0, 1));
|
|
118
|
+
});
|
|
119
|
+
|
|
120
|
+
test('stays ok with no failedPages when every built page builds', async () => {
|
|
121
|
+
mockGetPageBuildStatus.mockResolvedValue({ checked: ['orders'], unbuilt: 2 });
|
|
122
|
+
|
|
123
|
+
const { build } = await getBuildStatus({ checked: ['orders'] });
|
|
124
|
+
|
|
125
|
+
expect(build.status).toBe('ok');
|
|
126
|
+
expect(build.configStatus).toBe('ok');
|
|
127
|
+
expect(build).not.toHaveProperty('failedPages');
|
|
128
|
+
});
|
|
129
|
+
});
|
|
130
|
+
|
|
35
131
|
test('getBuildStatus lists errors from earlier builds apart from the current ones', async () => {
|
|
36
132
|
mockClientErrors.mockReturnValue([
|
|
37
133
|
{ message: 'old render error', buildId: 'build-1' },
|
|
@@ -14,20 +14,20 @@
|
|
|
14
14
|
limitations under the License.
|
|
15
15
|
*/
|
|
16
16
|
|
|
17
|
-
import {
|
|
17
|
+
import { vi, beforeEach, expect, test } from 'vitest';
|
|
18
18
|
|
|
19
|
-
const mockWaitForBuild =
|
|
20
|
-
|
|
21
|
-
const mockBuildEditedPages =
|
|
22
|
-
|
|
23
|
-
const mockGetBuildStatus =
|
|
24
|
-
|
|
19
|
+
const mockWaitForBuild = vi.fn();
|
|
20
|
+
vi.doMock('./waitForBuild.js', () => ({ default: mockWaitForBuild }));
|
|
21
|
+
const mockBuildEditedPages = vi.fn();
|
|
22
|
+
vi.doMock('./buildEditedPages.js', () => ({ default: mockBuildEditedPages }));
|
|
23
|
+
const mockGetBuildStatus = vi.fn(({ checked } = {}) => ({ build: { status: 'ok' }, checked }));
|
|
24
|
+
vi.doMock('./getBuildStatus.js', () => ({ default: mockGetBuildStatus }));
|
|
25
25
|
|
|
26
26
|
const { default: getBuildStatusAfterEdits } = await import('./getBuildStatusAfterEdits.js');
|
|
27
27
|
const { default: readProxyBuildWait } = await import('./readProxyBuildWait.js');
|
|
28
28
|
|
|
29
29
|
beforeEach(() => {
|
|
30
|
-
|
|
30
|
+
vi.clearAllMocks();
|
|
31
31
|
});
|
|
32
32
|
|
|
33
33
|
test('getBuildStatusAfterEdits builds the edited pages once the edits are processed', async () => {
|
|
@@ -14,10 +14,8 @@
|
|
|
14
14
|
limitations under the License.
|
|
15
15
|
*/
|
|
16
16
|
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
function docsAppMapHandler(c) {
|
|
20
|
-
return c.json(getAppMap());
|
|
17
|
+
function getConfigDirectory() {
|
|
18
|
+
return process.env.LOWDEFY_DIRECTORY_CONFIG || process.cwd();
|
|
21
19
|
}
|
|
22
20
|
|
|
23
|
-
export default
|
|
21
|
+
export default getConfigDirectory;
|
package/lib/docs/getHazards.js
CHANGED
|
@@ -15,10 +15,13 @@
|
|
|
15
15
|
*/
|
|
16
16
|
import { type } from '@lowdefy/helpers';
|
|
17
17
|
|
|
18
|
+
import createLogger from '../server/log/createLogger.js';
|
|
18
19
|
import loadFrameworkHazards from './loadFrameworkHazards.js';
|
|
19
20
|
import normalizeTypeKind from './normalizeTypeKind.js';
|
|
20
21
|
import readBuildArtifact from './readBuildArtifact.js';
|
|
21
22
|
|
|
23
|
+
const logger = createLogger();
|
|
24
|
+
|
|
22
25
|
// Where each kind's plugin-declared hazards land in the build: block metas
|
|
23
26
|
// pick them from meta.hazards, request metas ride along whole, operators
|
|
24
27
|
// get a dedicated metas artifact (they carry no other meta).
|
|
@@ -74,7 +77,7 @@ function hazardApplies({ hazard, kind, typeName, connectionId }) {
|
|
|
74
77
|
if (type.isNone(condition)) {
|
|
75
78
|
if (!warnedUnknownWhen.has(when)) {
|
|
76
79
|
warnedUnknownWhen.add(when);
|
|
77
|
-
|
|
80
|
+
logger.warn(
|
|
78
81
|
`Hazard "${hazard.id}" declares unknown when condition ${JSON.stringify(
|
|
79
82
|
when
|
|
80
83
|
)} and was skipped.`
|
|
@@ -13,7 +13,7 @@
|
|
|
13
13
|
See the License for the specific language governing permissions and
|
|
14
14
|
limitations under the License.
|
|
15
15
|
*/
|
|
16
|
-
import {
|
|
16
|
+
import { vi, afterEach, beforeEach, expect, test } from 'vitest';
|
|
17
17
|
|
|
18
18
|
import setupTestFixtures from './setupTestFixtures.mjs';
|
|
19
19
|
|
|
@@ -24,11 +24,14 @@ process.chdir(fixtureDir);
|
|
|
24
24
|
|
|
25
25
|
// The framework list ships in @lowdefy/docs-content; mock the loader so each
|
|
26
26
|
// test controls the list (and the "package not installed" case).
|
|
27
|
-
const mockLoadFrameworkHazards =
|
|
28
|
-
|
|
27
|
+
const mockLoadFrameworkHazards = vi.fn();
|
|
28
|
+
vi.doMock('./loadFrameworkHazards.js', () => ({
|
|
29
29
|
default: mockLoadFrameworkHazards,
|
|
30
30
|
}));
|
|
31
31
|
|
|
32
|
+
const mockLogger = { info: vi.fn(), warn: vi.fn() };
|
|
33
|
+
vi.doMock('../server/log/createLogger.js', () => ({ default: () => mockLogger }));
|
|
34
|
+
|
|
32
35
|
const { default: getHazards } = await import('./getHazards.js');
|
|
33
36
|
|
|
34
37
|
const frameworkHazards = [
|
|
@@ -63,12 +66,11 @@ let warnSpy;
|
|
|
63
66
|
beforeEach(() => {
|
|
64
67
|
mockLoadFrameworkHazards.mockReset();
|
|
65
68
|
mockLoadFrameworkHazards.mockReturnValue(frameworkHazards);
|
|
66
|
-
warnSpy =
|
|
69
|
+
warnSpy = mockLogger.warn;
|
|
70
|
+
warnSpy.mockClear();
|
|
67
71
|
});
|
|
68
72
|
|
|
69
|
-
afterEach(() => {
|
|
70
|
-
warnSpy.mockRestore();
|
|
71
|
-
});
|
|
73
|
+
afterEach(() => {});
|
|
72
74
|
|
|
73
75
|
test('getHazards returns type-attached hazards only when no framework hazard applies', () => {
|
|
74
76
|
mockLoadFrameworkHazards.mockReturnValue([]);
|
package/lib/docs/getOverview.js
CHANGED
|
@@ -57,7 +57,7 @@ function patternedPageLines() {
|
|
|
57
57
|
return [
|
|
58
58
|
'## Pages with path parameters',
|
|
59
59
|
'',
|
|
60
|
-
'These pages are served at a URL pattern with placeholders. Pass `pathParams` with a value for each placeholder (e.g. `{"ticket_id": "1"}`) to `lowdefy_screenshot_page`, `lowdefy_inspect_state
|
|
60
|
+
'These pages are served at a URL pattern with placeholders. Pass `pathParams` with a value for each placeholder (e.g. `{"ticket_id": "1"}`) to `lowdefy_screenshot_page`, `lowdefy_inspect_state` and `lowdefy_run_journey`. A live tab is read at the instance it shows without them.',
|
|
61
61
|
'',
|
|
62
62
|
...patterned.map((route) => `- \`${route.pageId}\`: \`${route.path}\``),
|
|
63
63
|
'',
|
|
@@ -107,73 +107,51 @@ function getOverview() {
|
|
|
107
107
|
'',
|
|
108
108
|
'## How to use this (recommended order)',
|
|
109
109
|
'',
|
|
110
|
-
'
|
|
111
|
-
'2. **Get the exact contract**: `GET /lowdefy-docs/schema/{kind}/{type}` (e.g. `/lowdefy-docs/schema/blocks/Button`) — or `lowdefy_get_schema`. JSON Schema of all properties.',
|
|
112
|
-
'3. **See real usage**: `GET /lowdefy-docs/examples/{type}` — or `lowdefy_get_examples`. YAML examples for block types.',
|
|
113
|
-
'4. **Read concept docs**: `GET /lowdefy-docs/content/{slug}` (e.g. `/lowdefy-docs/content/operators/_get`) — or `lowdefy_get_doc`. Start with `concepts/lowdefy-schema`, `concepts/blocks`, `concepts/events-and-actions`, `concepts/connections-and-requests`, `concepts/operators`.',
|
|
114
|
-
'5. **Search**: `GET /lowdefy-docs/search?q=...` — or `lowdefy_search_docs`. The query is split into words and pages are ranked by how many match, title matches first. Each hit names its `source` (`core`, `plugin`, `local-plugin` or `module`), package and version; `&source=` narrows the search to one source.',
|
|
115
|
-
'6. **Icons**: `GET /lowdefy-docs/icons?q=...` — or `lowdefy_search_icons`. Use a semantic name (`icon: edit`); otherwise use a Lucide name in PascalCase (`icon: Receipt`) found by search. Never invent a name. In HTML use `<i data-icon="edit"></i>`, `data-tooltip` and `data-popover`.',
|
|
116
|
-
"7. **Plugin and module docs**: search and `lowdefy_get_doc` also cover the docs this app's own plugins and modules ship, local ones included: each README (`plugins/{package}`, `modules/{id}`), each `docs/*.md` file (`plugins/{package}/{file}`, `modules/{id}/{file}`), and for each module a generated page of the components, exports and vars its `module.lowdefy.yaml` declares (`modules/{id}/manifest`). `GET /lowdefy-docs/plugins` lists every installed plugin; `GET /lowdefy-docs/plugin-doc/{package}` returns all the markdown one plugin ships as one page.",
|
|
110
|
+
'Agents use these through the MCP endpoint (`/lowdefy-docs/mcp`, or `lowdefy mcp` set up by `lowdefy agent-setup`).',
|
|
117
111
|
'',
|
|
118
|
-
'
|
|
112
|
+
'1. **List what exists**: `lowdefy_list_types` with a kind (blocks, operators, actions, connections, requests, ...). Each entry names its package and doc slug.',
|
|
113
|
+
"2. **Get the exact contract**: `lowdefy_get_schema` for the JSON Schema of a type's properties.",
|
|
114
|
+
'3. **See real usage**: `lowdefy_get_examples` for YAML examples of a block type.',
|
|
115
|
+
'4. **Read concept docs**: `lowdefy_get_doc` with a slug (e.g. `operators/_get`). Start with `concepts/lowdefy-schema`, `concepts/blocks`, `concepts/events-and-actions`, `concepts/connections-and-requests`, `concepts/operators`.',
|
|
116
|
+
'5. **Search**: `lowdefy_search_docs`. The query is split into words and pages are ranked by how many match, title matches first. Each hit names its `source` (`core`, `plugin`, `local-plugin` or `module`), package and version; `source` narrows the search to one source.',
|
|
117
|
+
'6. **Icons**: `lowdefy_search_icons`. Use a semantic name (`icon: edit`); otherwise use a Lucide name in PascalCase (`icon: Receipt`) found by search. Never invent a name. In HTML use `<i data-icon="edit"></i>`, `data-tooltip` and `data-popover`.',
|
|
118
|
+
"7. **Plugin and module docs**: search and `lowdefy_get_doc` also cover the docs this app's own plugins and modules ship, local ones included: each README (`plugins/{package}`, `modules/{id}`), each `docs/*.md` file (`plugins/{package}/{file}`, `modules/{id}/{file}`), and for each module a generated page of the components, exports and vars its `module.lowdefy.yaml` declares (`modules/{id}/manifest`).",
|
|
119
|
+
'',
|
|
120
|
+
'A `stale` field on a JSON response, a `> STALE:` banner on markdown, an `X-Lowdefy-Stale` header or a tool result that begins with `STALE:` means the last build FAILED and the served build is behind the source — this answer predates your latest edits. Call `GET /lowdefy-docs/build-status` (`lowdefy_build_status`) and fix the errors before trusting anything else.',
|
|
119
121
|
'',
|
|
120
122
|
'## The feedback loop (after every edit)',
|
|
121
123
|
'',
|
|
122
124
|
'The dev server rebuilds automatically when config files change. After EVERY edit:',
|
|
123
125
|
'',
|
|
124
|
-
'1. **Check what broke**: `GET /lowdefy-docs/build-status?wait=true` — or `lowdefy_build_status` with `wait: true`, which answers once your latest edit has been processed and the pages it touched have been built.
|
|
125
|
-
' Or subscribe instead of polling: `GET /lowdefy-docs/events` streams `build`, `client_error`, `server_error` and `restart` events over SSE (MCP clients receive the same as `notifications/message` from logger `lowdefy`).',
|
|
126
|
+
'1. **Check what broke**: `GET /lowdefy-docs/build-status?wait=true` — or `lowdefy_build_status` with `wait: true`, which answers once your latest edit has been processed and the pages it touched have been built. `build.status` is `ok` when the config builds and no page failed its latest build: `pages_failed` (with `build.failedPages` naming the pages) when a page failed its latest build and has not changed since, `error` when the config build fails. Then the build errors and warnings and the errors of each failed page, with source file locations, plus recent browser runtime errors. Errors from before the latest edit come apart under `earlierErrors`.',
|
|
127
|
+
' Or subscribe instead of polling: `GET /lowdefy-docs/events` streams `build`, `client_error`, `server_error` and `restart` events over SSE (MCP clients receive the same as `notifications/message` from logger `lowdefy`). A `build` event covers the config build only, so check build status for pages that fail to build.',
|
|
126
128
|
'2. **Verify the page**: `GET /lowdefy-docs/page-config/{pageId}` — or `lowdefy_get_page_config`. The fully built page config, or its structured build errors.',
|
|
127
|
-
|
|
128
|
-
'4. **Verify behaviour**: `POST /lowdefy-docs/journey` `{pageId, steps, user, urlQuery, state}` — or `lowdefy_run_journey`. Drive the page headless with declarative steps (`click`, `fill`, `select`, `press`, `back`, `goto`, `email`, `as`, `wait`, `screenshot`, `expect: { state | visible | text | url | title }`) and assert what happens. `user: "none"` injects no caller, so sign-up, sign-in and invitations run through the app\'s own auth.
|
|
129
|
+
'3. **See it rendered**: `lowdefy_screenshot_page`. PNG of the page in headless Chromium; `width` and `colorScheme` check a phone layout in dark mode.',
|
|
130
|
+
'4. **Verify behaviour**: `POST /lowdefy-docs/journey` `{pageId, steps, user, urlQuery, state}` — or `lowdefy_run_journey`. Drive the page headless with declarative steps (`click`, `fill`, `select`, `press`, `back`, `goto`, `email`, `as`, `wait`, `screenshot`, `expect: { state | visible | text | url | title }`) and assert what happens. `user: "none"` injects no caller, so sign-up, sign-in and invitations run through the app\'s own auth. A failing step stops the journey and returns `passed: false` with `failure: { index, step, expected, actual, message }` and the final page `state` — data, not an error. `lowdefy_get_schema` with kind `journey-step` returns the step grammar.',
|
|
129
131
|
'5. **Locate config**: `GET /lowdefy-docs/find/{id}?pageId=...` — or `lowdefy_find_config`. Which yaml file defines a page/block/request id.',
|
|
130
|
-
'6. **Scaffold**: `lowdefy_scaffold_page` creates a canonical new page file (then register it in lowdefy.yaml).',
|
|
131
132
|
'',
|
|
132
133
|
'## Live state and testing',
|
|
133
134
|
'',
|
|
134
|
-
"1. **Inspect live state**: `
|
|
135
|
-
'2. **Evaluate operators**: `
|
|
136
|
-
'3. **Run a request**: `
|
|
137
|
-
'4. **Run an endpoint**: `
|
|
138
|
-
'5. **Understand the app**: `
|
|
139
|
-
'6. **
|
|
140
|
-
"7. **State checkpoints**: `POST /lowdefy-docs/state-checkpoints/snapshot` `{pageId, name}` captures live page state + request responses into .lowdefy/state-checkpoints/<name>/ (gitignored — checkpoints contain user/session data); `POST /lowdefy-docs/state-checkpoints/load` `{name, mode}` restores it — 'registry-only' mode returns a ?_checkpoint URL a human can open to test the app in that exact state. `lowdefy_checkpoint_to_mocks` converts one into e2e mocks.yaml fixtures.",
|
|
141
|
-
'8. **Restart the server**: `POST /lowdefy-docs/restart` `{reason}` — or `lowdefy_restart` (through `lowdefy mcp`: `lowdefy_dev_start` with `restart: true`, a full process restart when the hub runs the server). Only when the server seems stuck or build-status looks stale, or after secrets a wrapper (for example infisical) injects have changed. Answers before the restart lands: then call `GET /lowdefy-docs/build-status?wait=true`, which answers once the restarted server is ready. `.env` edits and local plugin code need no restart: `.env` is watched and restarts the server, and a local plugin change rebuilds, restarting the server when the plugin has server-side types.',
|
|
142
|
-
'',
|
|
143
|
-
'## Visual feedback (annotation helper)',
|
|
144
|
-
'',
|
|
145
|
-
'The developer can press Cmd/Ctrl+/ in the running app to point at elements, draw, and comment; the helper copies an agent-readable feedback block to their clipboard which they paste into their agent session. Pasted blocks start with "Feedback:" and carry the blockId, resolved config file:line, drawn shapes (usable as screenshot clip geometry), and recent console entries — treat them as precise UI feedback.',
|
|
135
|
+
"1. **Inspect live state**: `lowdefy_inspect_state`. The actual state, request results, and event log of a running page. Reads the developer's open browser tab when connected (ask them to interact, then inspect), else runs the page headless.",
|
|
136
|
+
'2. **Evaluate operators**: `lowdefy_inspect_state` with `expression`. A REPL for config: run any operator expression against live page state; the result names the paths it read.',
|
|
137
|
+
'3. **Run a request**: `lowdefy_run_request`. Verify the data shape a request returns. The page is rebuilt first when it changed since its last build. Read-only types always run; writes need `cli.agentTools.allowWriteRequests: true` in lowdefy.yaml. A response over 40,000 characters is written in full to `responseFile` under `.lowdefy/responses/`; add `saveResponse: true` to always write it there.',
|
|
138
|
+
'4. **Run an endpoint**: `lowdefy_run_endpoint`. Run an Api routine headlessly and see what it returns, rejects or throws — a `:reject` comes back as `status: "reject"` with the routine\'s own error, not as a failure. Always needs `cli.agentTools.allowWriteRequests: true` (routines are not classified read-only). Add `system: true` to run a scheduled or detached-only `InternalApi` routine as a system context (no `_user`, auth not checked), the way cron does — not combinable with `user`.',
|
|
139
|
+
'5. **Understand the app**: `lowdefy_app_map`. Every page, menu, connection, endpoint, agent, and websocket in one call.',
|
|
140
|
+
'6. **Restart the server**: `POST /lowdefy-docs/restart` `{reason}` — or `lowdefy_restart` (through `lowdefy mcp`: `lowdefy_dev_start` with `restart: true`, a full process restart when the hub runs the server). Only when the server seems stuck or build-status looks stale, or after secrets a wrapper (for example infisical) injects have changed. Answers before the restart lands: then call `GET /lowdefy-docs/build-status?wait=true`, which answers once the restarted server is ready. `.env` edits and local plugin code need no restart: `.env` is watched and restarts the server, and a local plugin change rebuilds, restarting the server when the plugin has server-side types.',
|
|
146
141
|
'',
|
|
147
142
|
'## Routes',
|
|
148
143
|
'',
|
|
149
144
|
'| Route | Purpose |',
|
|
150
145
|
'| --- | --- |',
|
|
151
146
|
'| `GET /lowdefy-docs` | This overview |',
|
|
152
|
-
'| `GET /lowdefy-docs/{kind}` | List all available types of a kind (blocks, operators, actions, connections, requests, agents, notifications, websockets) |',
|
|
153
|
-
'| `GET /lowdefy-docs/plugins` | Installed plugin packages and the types each provides |',
|
|
154
|
-
'| `GET /lowdefy-docs/schema/{kind}/{type}` | JSON schema for a type |',
|
|
155
|
-
'| `GET /lowdefy-docs/examples/{type}` | Example yaml for a block type |',
|
|
156
|
-
'| `GET /lowdefy-docs/content/{slug}` | A doc page as markdown: core, plugin or module |',
|
|
157
|
-
'| `GET /lowdefy-docs/search?q={query}&source={source}` | Search the docs, ranked by matching words |',
|
|
158
|
-
'| `GET /lowdefy-docs/icons?q={query}` | Search icon names (semantic names first, then Lucide names, then installed icon sets) |',
|
|
159
|
-
'| `GET /lowdefy-docs/plugin-doc/{package}` | Markdown shipped inside a plugin package |',
|
|
160
147
|
'| `GET /lowdefy-docs/build-status` | Current build errors/warnings, failing pages + recent browser errors |',
|
|
161
148
|
'| `GET /lowdefy-docs/events` | SSE push channel: `restart` on connect, then `build`, `client_error`, `server_error` events as they happen (build events carry `stale`) |',
|
|
162
149
|
'| `GET /lowdefy-docs/page-config/{pageId}` | Fully built page config, or its build errors |',
|
|
163
|
-
'| `GET /lowdefy-docs/screenshot/{pageId}` | PNG screenshot of the rendered page |',
|
|
164
150
|
'| `POST /lowdefy-docs/journey` | Drive a page headless through declarative steps (click, fill, select, press, back, goto, email, as, wait, screenshot, expect) and assert state, visibility, text, url or title; screenshots returned as base64 |',
|
|
165
151
|
'| `POST /lowdefy-docs/mutants` | Config mutants on what journeys exercised `{pages, requests, endpoints, appEvents, operators}`: each with a stable `id`, its anchor and source line (for `lowdefy journeys harden`) |',
|
|
166
152
|
'| `GET /lowdefy-docs/find/{id}?pageId=` | Locate where a page/block/request id is defined |',
|
|
167
|
-
'| `GET /lowdefy-docs/inspect-state/{pageId}?source=` | Live state/requests/eventLog of a running page (tab or headless) |',
|
|
168
|
-
'| `POST /lowdefy-docs/eval-operator` | Evaluate an operator expression against live page state |',
|
|
169
|
-
'| `POST /lowdefy-docs/run-request` | Execute a request with a test payload (read-only unless opted in) |',
|
|
170
|
-
'| `POST /lowdefy-docs/run-endpoint` | Execute an Api endpoint routine with a test payload and caller, or `system: true` for a cron-style system run (needs agent write access; rejects return as data) |',
|
|
171
|
-
'| `GET /lowdefy-docs/app-map` | Whole-app graph: pages, menus, connections, endpoints, agents |',
|
|
172
|
-
'| `GET/POST /lowdefy-docs/checkpoints` + `/revert` | Config-file checkpoints: list, create, revert |',
|
|
173
|
-
'| `GET/POST /lowdefy-docs/state-checkpoints` + `/snapshot`, `/load` | State & data checkpoints: capture/restore live app state |',
|
|
174
153
|
'| `POST /lowdefy-docs/restart` | Restart the dev server process (answers before the restart lands; then `build-status?wait=true` answers once it is back) |',
|
|
175
|
-
'| `
|
|
176
|
-
'| `ALL /lowdefy-docs/mcp` | MCP endpoint (streamable HTTP) exposing all of the above as tools |',
|
|
154
|
+
'| `ALL /lowdefy-docs/mcp` | MCP endpoint (streamable HTTP) exposing every dev tool |',
|
|
177
155
|
];
|
|
178
156
|
return lines.join('\n');
|
|
179
157
|
}
|
|
@@ -18,6 +18,7 @@ import fs from 'fs';
|
|
|
18
18
|
import path from 'path';
|
|
19
19
|
|
|
20
20
|
import setupTestFixtures from './setupTestFixtures.mjs';
|
|
21
|
+
import { expect, test } from 'vitest';
|
|
21
22
|
|
|
22
23
|
// lib/build/config.js reads build/config.json from process.cwd() at import
|
|
23
24
|
// time, so the fixture carries the basePath before getOverview is imported.
|
|
@@ -17,6 +17,7 @@
|
|
|
17
17
|
import fs from 'fs';
|
|
18
18
|
import os from 'os';
|
|
19
19
|
import path from 'path';
|
|
20
|
+
import { expect, test } from 'vitest';
|
|
20
21
|
|
|
21
22
|
// getStaleStatus reads build/buildStatus.json from process.cwd() — point it at
|
|
22
23
|
// a throwaway server directory before the module is imported.
|