@lowdefy/server-dev 7.1.0 → 7.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/client/Inspector.jsx +24 -75
- package/client/Page.jsx +8 -0
- package/client/Routing.jsx +0 -2
- package/client/clientBuildImports.test.mjs +5 -3
- package/client/devStreamConnections.test.mjs +1 -0
- package/client/journeyObserver/startJourneyObserver.test.mjs +11 -11
- package/client/openInEditor/OpenInEditorListener.jsx +36 -29
- package/client/openInEditor/OpenInEditorListener.test.mjs +116 -0
- package/client/{feedback → openInEditor}/elementInspect.js +9 -44
- package/client/openInEditor/findBlockLocation.js +2 -2
- package/client/openInEditor/openInEditorStyles.js +56 -0
- package/client/recorder/createPairingBuffer.test.mjs +27 -9
- package/client/recorder/createRecorder.js +11 -7
- package/client/recorder/createRecorder.test.mjs +9 -9
- package/client/recorder/isPasswordElement.js +41 -0
- package/client/recorder/keyChord.test.mjs +1 -0
- package/{client/recorder/toJsonSafe.js → lib/build/mobileConfig.js} +9 -12
- package/lib/client/auth/AuthConfigured.jsx +75 -48
- package/lib/client/auth/authNotConfiguredParity.test.mjs +1 -0
- package/lib/client/auth/authTemplateSync.test.mjs +1 -0
- package/lib/client/auth/betterAuthSessionContract.test.mjs +2 -1
- package/lib/client/auth/sessionCaller.js +56 -0
- package/lib/client/auth/sessionCaller.test.mjs +78 -0
- package/lib/client/getPagePath.test.mjs +1 -0
- package/lib/client/utils/formatErrorsForCopy.test.mjs +1 -0
- package/lib/client/utils/getErrorBarColor.test.mjs +1 -0
- package/lib/client/utils/usePageConfig.test.mjs +15 -15
- package/lib/configTree/buildConfigTree.test.mjs +6 -8
- package/lib/configTree/collectConfigText.test.mjs +1 -0
- package/lib/configTree/runConfigTreeBuild.mjs +2 -1
- package/lib/configTree/runConfigTreeBuild.skipPluginChecks.test.mjs +11 -11
- package/lib/configTree/runConfigTreeBuild.test.mjs +2 -2
- package/lib/docs/addNestedEndpoints.test.mjs +1 -0
- package/lib/docs/checkAgentFiles.test.mjs +1 -0
- package/lib/docs/checkStepReferences.test.mjs +3 -3
- package/lib/docs/clientErrorStore.test.mjs +4 -4
- package/lib/docs/createBrowserLifecycle.test.mjs +40 -24
- package/lib/docs/createDocsMcpServer.js +195 -138
- package/lib/docs/createDocsMcpServer.test.mjs +331 -25
- package/lib/docs/createDocsMcpServerRunJourney.test.mjs +5 -5
- package/lib/docs/createJourneyActors.chromium.test.mjs +3 -3
- package/lib/docs/createJourneyActors.test.mjs +4 -4
- package/lib/docs/dataSets/dataSetJourneys.chromium.mongodb.test.mjs +6 -6
- package/lib/docs/dataSets/drainSessionWork.test.mjs +21 -5
- package/lib/docs/dataSets/getDataStore.js +11 -3
- package/lib/docs/dataSets/getDataStore.mongodb.test.mjs +3 -3
- package/lib/docs/dataSets/getDataStore.test.mjs +32 -20
- package/lib/docs/dataSets/mergeCollectionIndexes.test.mjs +1 -0
- package/lib/docs/dataSets/openDataSession.js +4 -2
- package/lib/docs/dataSets/openDataSession.mongodb.test.mjs +25 -7
- package/lib/docs/dataSets/pickDataStorePort.test.mjs +2 -2
- package/lib/docs/dataSets/readDataSession.test.mjs +1 -0
- package/lib/docs/dataSets/readDataSet.test.mjs +1 -0
- package/lib/docs/dataSets/resolveJourneyDataSet.test.mjs +1 -0
- package/lib/docs/dataSets/test/buildTestApp.mjs +1 -1
- package/lib/docs/devEventBus.js +7 -2
- package/lib/docs/devEventBus.test.mjs +12 -10
- package/lib/docs/devToolDefinitions.js +101 -143
- package/lib/docs/device/buildDeviceCommand.js +103 -0
- package/lib/docs/device/buildDeviceCommand.test.mjs +142 -0
- package/lib/docs/device/captureDevice.js +85 -0
- package/lib/docs/device/checkShownPage.js +56 -0
- package/lib/docs/device/createFakePhoneTab.mjs +77 -0
- package/lib/docs/device/deviceAction.js +74 -0
- package/lib/docs/device/deviceTools.test.mjs +604 -0
- package/lib/docs/device/findDeviceTab.js +50 -0
- package/lib/docs/device/findDeviceTarget.js +73 -0
- package/lib/docs/device/injectDevice.js +160 -0
- package/lib/docs/device/listDevices.js +100 -0
- package/lib/docs/device/listDevices.test.mjs +105 -0
- package/lib/docs/device/runDeviceJourney.js +68 -0
- package/lib/docs/device/runDeviceSteps.js +164 -0
- package/lib/docs/device/screenshotDevice.js +68 -0
- package/lib/docs/device/sendDeviceStep.js +52 -0
- package/lib/docs/device/startDevice.js +150 -0
- package/lib/docs/docs.test.mjs +44 -28
- package/lib/docs/docsIndex.test.mjs +1 -0
- package/lib/docs/findConfig.js +3 -4
- package/lib/docs/findPageBlock.js +35 -0
- package/lib/docs/findPageBlock.test.mjs +45 -0
- package/lib/docs/fitResponse.js +18 -17
- package/lib/docs/fitResponse.test.mjs +18 -0
- package/lib/docs/getBrowser.js +3 -3
- package/lib/docs/getBrowser.test.mjs +32 -16
- package/lib/docs/getBuildId.test.mjs +1 -0
- package/lib/docs/getBuildStatus.test.mjs +11 -11
- package/lib/docs/getBuildStatusAfterEdits.test.mjs +8 -8
- package/{src/routes/docs/appMap.js → lib/docs/getConfigDirectory.js} +3 -5
- package/lib/docs/getHazards.js +4 -1
- package/lib/docs/getHazards.test.mjs +9 -7
- package/lib/docs/getOverview.js +20 -42
- package/lib/docs/getOverviewBasePath.test.mjs +1 -0
- package/lib/docs/getStaleStatus.test.mjs +1 -0
- package/lib/docs/inspectState.js +78 -3
- package/lib/docs/inspectState.test.mjs +61 -9
- package/lib/docs/inspectStateFromTab.js +38 -6
- package/lib/docs/inspectStateFromTab.test.mjs +79 -0
- package/lib/docs/inspectStateHeadless.js +98 -34
- package/lib/docs/inspectStateHeadless.test.mjs +17 -5
- package/lib/docs/installHeadlessShell.failure.test.mjs +9 -5
- package/lib/docs/installHeadlessShell.js +5 -2
- package/lib/docs/installHeadlessShell.test.mjs +8 -5
- package/lib/docs/installHeadlessShell.timeout.test.mjs +32 -12
- package/lib/docs/isDeepEqual.js +37 -0
- package/lib/docs/isHeadlessShellIncomplete.js +6 -5
- package/lib/docs/isHeadlessShellIncomplete.test.mjs +4 -1
- package/lib/docs/isPageReady.test.mjs +1 -0
- package/lib/docs/journeyMutantCookie.chromium.test.mjs +3 -3
- package/lib/docs/journeyRunRecording.test.mjs +1 -0
- package/lib/docs/keepEventStreamAlive.test.mjs +1 -0
- package/lib/docs/launchBrowser.test.mjs +8 -8
- package/lib/docs/listTypes.js +58 -8
- package/lib/docs/loadFrameworkHazards.test.mjs +1 -0
- package/lib/docs/matchJourneyRoute.test.mjs +1 -0
- package/lib/docs/observe/createJourneyAppErrors.test.mjs +18 -4
- package/lib/docs/observe/evaluateInvariants.js +23 -0
- package/lib/docs/observe/evaluateInvariants.test.mjs +27 -0
- package/lib/docs/observe/hasNoEffect.test.mjs +1 -0
- package/lib/docs/observe/toAppErrorFailure.js +7 -4
- package/lib/docs/observe/watchJourneyContext.js +1 -0
- package/lib/docs/observe/withAppErrors.test.mjs +22 -0
- package/lib/docs/openJourneyEmail.test.mjs +6 -6
- package/lib/docs/pageBuildStatus.test.mjs +6 -6
- package/lib/docs/pollTab.js +100 -0
- package/lib/docs/pollTab.test.mjs +64 -0
- package/lib/docs/rails/authEngineActions.test.mjs +1 -0
- package/lib/docs/rails/authEngineMethods.test.mjs +2 -1
- package/lib/docs/rails/checkAuthActionsRan.test.mjs +5 -5
- package/lib/docs/rails/createDataSetRails.test.mjs +1 -0
- package/lib/docs/rails/findExternalBlocks.test.mjs +1 -0
- package/lib/docs/readJourneyEmailMatch.test.mjs +2 -2
- package/lib/docs/readJourneySession.js +1 -1
- package/lib/docs/reportDevToolFault.js +29 -0
- package/lib/docs/reportDevToolFault.test.mjs +34 -0
- package/lib/docs/requestRestart.test.mjs +1 -0
- package/lib/docs/resolvePageInstance.test.mjs +1 -0
- package/lib/docs/resolveSource.js +2 -2
- package/lib/docs/resolveSource.test.mjs +6 -6
- package/lib/docs/reviewPageBuilds.test.mjs +2 -2
- package/lib/docs/runCheck.test.mjs +3 -3
- package/lib/docs/runCheckChild.js +2 -1
- package/lib/docs/runEndpoint.js +23 -10
- package/lib/docs/runEndpoint.test.mjs +42 -37
- package/lib/docs/runErrorBuffers.test.mjs +1 -0
- package/lib/docs/runJourney.js +21 -1
- package/lib/docs/runJourney.test.mjs +119 -99
- package/lib/docs/runJourneyDataSet.test.mjs +25 -25
- package/lib/docs/runJourneySteps.js +8 -29
- package/lib/docs/runRequest.js +6 -6
- package/lib/docs/runRequest.test.mjs +22 -22
- package/lib/docs/screenshotPage.js +6 -7
- package/lib/docs/screenshotPage.test.mjs +46 -46
- package/lib/docs/screenshotPageClip.test.mjs +10 -10
- package/lib/docs/searchDocs.test.mjs +1 -0
- package/lib/docs/searchIcons.test.mjs +5 -5
- package/lib/docs/selectFinalState.test.mjs +1 -0
- package/lib/docs/serverErrorStore.test.mjs +4 -4
- package/lib/docs/setupTestFixtures.mjs +25 -0
- package/lib/docs/splitSearchTerms.test.mjs +1 -0
- package/lib/docs/tabAvailable.js +1 -1
- package/lib/docs/tabChannel.js +90 -14
- package/lib/docs/tabChannel.test.mjs +40 -15
- package/lib/docs/validateJourneyTimeout.test.mjs +1 -0
- package/lib/docs/validateStateSelection.test.mjs +1 -0
- package/lib/docs/validateViewport.test.mjs +1 -0
- package/lib/docs/waitForBuild.test.mjs +1 -0
- package/lib/docs/withBrowserSlot.test.mjs +5 -5
- package/lib/server/applyDataSetRedirect.test.mjs +2 -2
- package/lib/server/applyDataSetRedirectTenantReach.test.mjs +1 -0
- package/lib/server/applyDataSetRedirectWalled.test.mjs +1 -0
- package/lib/server/auth/getHeadlessUser.js +6 -0
- package/lib/server/auth/getHeadlessUser.test.mjs +13 -2
- package/lib/server/auth/resolveHeadlessUser.test.mjs +1 -0
- package/lib/server/contextMapBudget.test.mjs +3 -3
- package/lib/server/continueJitKeys.test.mjs +1 -0
- package/lib/server/createLowdefyContext.js +5 -1
- package/lib/server/createLowdefyContext.test.mjs +32 -32
- package/lib/server/getClientAddress.test.mjs +2 -2
- package/lib/server/getPageJitEnrichment.test.mjs +1 -0
- package/lib/server/importAppCode.test.mjs +2 -2
- package/lib/server/jitPageBuilder.js +27 -3
- package/lib/server/jitPageBuilder.mobileTypes.test.mjs +65 -0
- package/lib/server/jitPageBuilder.skipPluginChecks.test.mjs +5 -6
- package/lib/server/jitPageBuilder.test.mjs +4 -4
- package/lib/server/journeyCookies.test.mjs +1 -0
- package/lib/server/loadDynamicJsMap.js +10 -1
- package/lib/server/log/createHandleError.js +10 -5
- package/lib/server/log/createHandleError.test.mjs +19 -8
- package/lib/server/log/createLogger.test.mjs +2 -2
- package/lib/server/mutantDataSetWrappers.test.mjs +1 -0
- package/lib/server/mutants/listMutants.test.mjs +1 -0
- package/lib/server/mutants/mutantRuns.test.mjs +1 -0
- package/lib/server/mutants/operators.test.mjs +1 -0
- package/lib/server/pageBuildRecords.test.mjs +1 -0
- package/lib/server/pageCache.test.mjs +1 -0
- package/lib/server/pageRebuilds.test.mjs +3 -3
- package/{src/routes/docs/examples.js → lib/server/pairingHeaders.js} +8 -15
- package/lib/server/pruneJitMaps.test.mjs +1 -0
- package/lib/server/readBuildApiArtifacts.test.mjs +1 -0
- package/lib/server/readInstanceRecord.test.mjs +24 -8
- package/lib/server/readMergedMaps.test.mjs +1 -0
- package/lib/server/recording/errorRecordingStamp.test.mjs +1 -0
- package/lib/server/recording/readRecordingCookie.test.mjs +2 -0
- package/lib/server/recording/servedBuilds.test.mjs +1 -0
- package/lib/server/sinkExternalConnections.test.mjs +6 -6
- package/lib/server/skipStaleMapWrites.test.mjs +12 -12
- package/lib/server/startIdleGc.test.mjs +25 -9
- package/lib/server/testFixtures/importAppCodeTwice.mjs +2 -2
- package/lib/vite/createDevServerExclude.test.mjs +1 -0
- package/lib/vite/keepIdleConnectionsOpen.js +36 -0
- package/lib/vite/keepIdleConnectionsOpen.test.mjs +104 -0
- package/manager/getContext.mjs +9 -0
- package/manager/processes/checkPendingPlugins.mjs +49 -0
- package/manager/processes/checkPendingPlugins.test.mjs +107 -0
- package/manager/processes/createIdleChild.mjs +141 -0
- package/manager/processes/createIdleChild.test.mjs +209 -0
- package/manager/processes/initialBuild.mjs +2 -15
- package/manager/processes/initialBuild.test.mjs +8 -40
- package/manager/processes/lowdefyBuild.mjs +7 -4
- package/manager/processes/lowdefyBuild.skipPluginChecks.test.mjs +13 -13
- package/manager/processes/lowdefyBuild.test.mjs +17 -15
- package/manager/processes/restartServer.test.mjs +63 -15
- package/manager/processes/shutdownServer.test.mjs +3 -3
- package/manager/processes/startFirstServer.test.mjs +23 -22
- package/manager/processes/startMailSink.mjs +11 -3
- package/manager/processes/startMailSink.test.mjs +28 -2
- package/manager/processes/startProxy.mjs +167 -29
- package/manager/processes/startProxy.pairing.test.mjs +204 -0
- package/manager/processes/startProxy.test.mjs +130 -5
- package/manager/processes/startServer.mjs +5 -7
- package/manager/processes/startServer.test.mjs +10 -9
- package/manager/processes/syncServer.mjs +31 -4
- package/manager/processes/syncServer.test.mjs +71 -6
- package/manager/processes/waitForDevServer.test.mjs +21 -6
- package/manager/run.mjs +32 -8
- package/manager/utils/BatchChanges.mjs +1 -1
- package/manager/utils/BatchChanges.test.mjs +4 -4
- package/manager/utils/acquireDevInstance.test.mjs +1 -0
- package/manager/utils/checkPairing.mjs +45 -0
- package/manager/utils/checkPairing.test.mjs +53 -0
- package/manager/utils/createBuildActivity.mjs +5 -1
- package/manager/utils/createBuildActivity.test.mjs +2 -2
- package/manager/utils/createChangeSignal.test.mjs +5 -5
- package/manager/utils/createCustomPluginMessagesMap.mjs +8 -3
- package/manager/utils/createCustomPluginTypesMap.mjs +48 -12
- package/manager/utils/createCustomPluginTypesMap.test.mjs +181 -19
- package/manager/utils/createDotPathIgnore.test.mjs +1 -0
- package/manager/utils/createGlobIgnore.mjs +45 -0
- package/manager/utils/createGlobIgnore.test.mjs +58 -0
- package/manager/utils/createGlobWatchPaths.mjs +75 -0
- package/manager/utils/createGlobWatchPaths.test.mjs +67 -0
- package/manager/utils/createIdleGc.test.mjs +31 -15
- package/{src/routes/docs/content.js → manager/utils/createLanPairing.mjs} +14 -13
- package/manager/utils/createLanPairing.test.mjs +46 -0
- package/manager/utils/createRequestActivity.mjs +30 -3
- package/manager/utils/createRequestActivity.test.mjs +76 -22
- package/manager/utils/createServerArtifactTracker.mjs +1 -0
- package/manager/utils/createServerArtifactTracker.test.mjs +1 -0
- package/manager/utils/findBuildFilesOutsideWatch.test.mjs +1 -0
- package/{client/recorder/collectEventActions.js → manager/utils/findSignInCode.mjs} +13 -10
- package/manager/utils/findSignInCode.test.mjs +33 -0
- package/manager/utils/formatLanPairing.mjs +32 -0
- package/manager/utils/formatLanPairing.test.mjs +40 -0
- package/manager/utils/getLanAddress.mjs +83 -0
- package/manager/utils/getLanAddress.test.mjs +70 -0
- package/manager/utils/importFresh.test.mjs +1 -0
- package/{src/routes/docs/icons.js → manager/utils/isLoopbackAddress.mjs} +11 -10
- package/manager/utils/pluginTypeCache.mjs +100 -0
- package/manager/utils/pluginTypeCache.test.mjs +141 -0
- package/manager/utils/pruneRecordings.test.mjs +1 -0
- package/manager/utils/publishBuildDirectory.order.test.mjs +2 -2
- package/manager/utils/publishBuildDirectory.test.mjs +6 -7
- package/manager/utils/readBasePath.test.mjs +1 -0
- package/manager/utils/readManagerVersion.test.mjs +1 -0
- package/manager/utils/readPluginDefinitions.mjs +6 -6
- package/manager/utils/renderTerminalQr.mjs +54 -0
- package/manager/utils/resolveDevAuthUrl.test.mjs +1 -0
- package/manager/utils/setupWatcher.mjs +19 -4
- package/manager/utils/startRecordingPruner.test.mjs +24 -8
- package/manager/utils/waitForChildExit.test.mjs +2 -2
- package/manager/utils/writeBuildStatus.test.mjs +1 -0
- package/manager/watchers/envWatcher.mjs +3 -0
- package/manager/watchers/envWatcher.test.mjs +19 -7
- package/manager/watchers/listServerPluginFiles.mjs +188 -0
- package/manager/watchers/listServerPluginFiles.test.mjs +257 -0
- package/manager/watchers/lowdefyBuildWatcher.mjs +5 -0
- package/manager/watchers/lowdefyBuildWatcher.test.mjs +63 -10
- package/manager/watchers/pluginSourceWatcher.mjs +45 -17
- package/manager/watchers/pluginSourceWatcher.test.mjs +97 -21
- package/manager/watchers/resolveFile.mjs +46 -0
- package/manager/watchers/resolveFile.test.mjs +67 -0
- package/manager/watchers/resolvePackageSpecifier.mjs +127 -0
- package/manager/watchers/resolvePackageSpecifier.test.mjs +151 -0
- package/manager/watchers/restartRequestWatcher.mjs +7 -4
- package/manager/watchers/restartRequestWatcher.test.mjs +43 -6
- package/manager/watchers/selectLocalPluginPackages.test.mjs +1 -0
- package/package.json +54 -53
- package/package.original.json +54 -53
- package/src/app.js +83 -85
- package/src/html/renderDevPage.test.mjs +1 -0
- package/src/lib/getPathSegments.js +16 -1
- package/src/{routes/docs/checkpointsList.js → lib/getRequestSurface.js} +6 -4
- package/src/lib/isTabAnswer.js +32 -0
- package/src/lib/isTabChannelCaller.js +35 -0
- package/src/middleware/apiContext.js +4 -2
- package/src/middleware/createSameOriginGuard.test.mjs +1 -0
- package/src/middleware/errorHandler.js +33 -45
- package/src/middleware/errorHandler.test.mjs +10 -10
- package/src/middleware/isRebindingSafeHost.test.mjs +1 -0
- package/src/middleware/localDevToolsOnly.js +13 -1
- package/src/middleware/localDevToolsOnly.test.mjs +36 -2
- package/src/middleware/noStore.test.mjs +1 -0
- package/src/middleware/requestTimeout.js +7 -1
- package/src/middleware/staleFlag.test.mjs +1 -0
- package/src/middleware/stampCaller.test.mjs +1 -0
- package/src/routes/agentBearer.test.mjs +183 -0
- package/src/routes/auth.test.mjs +10 -10
- package/src/routes/clientError.js +21 -4
- package/src/routes/clientError.test.mjs +127 -0
- package/src/routes/devInspect.js +6 -51
- package/src/routes/devInspect.test.mjs +128 -3
- package/src/routes/devRecording.js +6 -17
- package/src/routes/devRecording.test.mjs +54 -3
- package/src/routes/docs/buildStatus.test.mjs +6 -6
- package/src/routes/docs/events.test.mjs +4 -4
- package/src/routes/docs/find.js +3 -3
- package/src/routes/docs/journey.test.mjs +8 -8
- package/src/routes/docs/journeyRefusals.test.mjs +9 -9
- package/src/routes/docs/loadDocsRoutes.js +70 -0
- package/src/routes/docs/loadDocsRoutes.test.mjs +110 -0
- package/src/routes/docs/mcp.test.mjs +5 -5
- package/src/routes/docs/mutants.js +7 -0
- package/src/routes/docs/mutants.test.mjs +20 -6
- package/src/routes/docs/parsePathParamsParam.test.mjs +1 -0
- package/src/routes/docs/parseUserParam.test.mjs +1 -0
- package/src/routes/docs/restart.test.mjs +1 -0
- package/src/routes/endpoints.js +24 -0
- package/src/routes/endpointsLink.test.mjs +111 -0
- package/src/routes/endpointsTextAnswer.test.mjs +8 -8
- package/src/routes/jitPage.js +13 -1
- package/src/routes/jitPage.test.mjs +36 -11
- package/src/routes/mcp.js +6 -0
- package/src/routes/mcp.test.mjs +23 -8
- package/src/routes/mcpMemberToken.test.mjs +8 -8
- package/src/routes/mcpProtectedResourceMetadata.test.mjs +2 -2
- package/src/routes/{docs/checkpointsRevert.js → mobileRoot.js} +10 -13
- package/src/routes/mobileRoutes.test.mjs +223 -0
- package/src/routes/mobileSignIn.js +58 -0
- package/src/routes/mobileSignIn.test.mjs +59 -0
- package/src/routes/mobileSignInCallback.js +34 -0
- package/src/routes/mobileSignInCallback.test.mjs +51 -0
- package/src/routes/mountDevPageRoutes.js +10 -2
- package/src/routes/mountDevPageRoutes.test.mjs +25 -1
- package/src/routes/mountMobileWellKnown.js +35 -0
- package/src/routes/mountMobileWellKnown.test.mjs +79 -0
- package/src/routes/mountOauthDiscovery.test.mjs +5 -5
- package/src/routes/normalizeMcpProtocolVersionHeader.test.mjs +1 -0
- package/src/routes/reload.js +101 -20
- package/src/routes/reload.test.mjs +153 -0
- package/src/routes/request.js +1 -22
- package/src/routes/request.test.mjs +7 -24
- package/src/routes/requestBody.test.mjs +14 -27
- package/src/routes/websocket.test.mjs +2 -2
- package/src/routes/wellKnownFallback.test.mjs +2 -2
- package/src/websocket/devWebSocket.test.mjs +12 -12
- package/vite.config.js +15 -1
- package/client/feedback/FeedbackMount.jsx +0 -83
- package/client/feedback/FeedbackOverlay.jsx +0 -904
- package/client/feedback/captureTabScreenshot.js +0 -84
- package/client/feedback/copyToClipboard.js +0 -45
- package/client/feedback/drawAnnotationsSvg.js +0 -119
- package/client/feedback/feedbackStyles.js +0 -304
- package/client/feedback/pinResponsiveImages.js +0 -59
- package/client/feedback/sendFeedback.js +0 -39
- package/client/feedback/useFeedbackToggle.js +0 -70
- package/client/recorder/buildEngineRecord.js +0 -37
- package/client/recorder/buildInteractionRecord.js +0 -64
- package/client/recorder/buildTraceEvent.js +0 -57
- package/client/recorder/buildTraceEvent.test.mjs +0 -81
- package/client/recorder/chunkRecords.js +0 -69
- package/client/recorder/chunkRecords.test.mjs +0 -59
- package/client/recorder/collectEventEndpoints.js +0 -40
- package/client/recorder/collectEventRequests.js +0 -39
- package/client/recorder/createPairingBuffer.js +0 -187
- package/client/recorder/createPasswordRedactor.js +0 -84
- package/client/recorder/createRecordBatcher.js +0 -54
- package/client/recorder/createRecordBatcher.test.mjs +0 -76
- package/client/recorder/createRecordingSession.js +0 -61
- package/client/recorder/createRecordingSession.test.mjs +0 -72
- package/client/recorder/diffStateWrites.js +0 -77
- package/client/recorder/diffStateWrites.test.mjs +0 -66
- package/client/recorder/isEventCall.js +0 -30
- package/client/recorder/jsonType.js +0 -39
- package/client/recorder/sendRecords.js +0 -40
- package/lib/docs/captureAnnotatedScreenshot.js +0 -99
- package/lib/docs/checkpointPaths.js +0 -91
- package/lib/docs/checkpointStore.js +0 -243
- package/lib/docs/checkpointToMocks.js +0 -65
- package/lib/docs/configCheckpoints.test.mjs +0 -156
- package/lib/docs/createConfigCheckpoint.js +0 -92
- package/lib/docs/devMockRegistry.js +0 -68
- package/lib/docs/enrichFeedback.js +0 -71
- package/lib/docs/evalOperator.js +0 -49
- package/lib/docs/evalOperator.test.mjs +0 -157
- package/lib/docs/evalOperatorHeadless.js +0 -159
- package/lib/docs/evalOperatorHeadless.test.mjs +0 -78
- package/lib/docs/evalOperatorInTab.js +0 -49
- package/lib/docs/formatFeedback.js +0 -142
- package/lib/docs/formatFeedback.test.mjs +0 -252
- package/lib/docs/getPluginDoc.js +0 -53
- package/lib/docs/listConfigCheckpoints.js +0 -55
- package/lib/docs/loadState.js +0 -220
- package/lib/docs/revertConfigCheckpoint.js +0 -73
- package/lib/docs/saveAnnotatedScreenshot.js +0 -43
- package/lib/docs/scaffoldPage.js +0 -77
- package/lib/docs/scaffoldPage.test.mjs +0 -97
- package/lib/docs/snapshotState.js +0 -67
- package/lib/docs/stateCheckpoints.test.mjs +0 -443
- package/manager/watchers/listServerSidePackages.mjs +0 -47
- package/manager/watchers/listServerSidePackages.test.mjs +0 -38
- package/src/routes/docs/checkpointsCreate.js +0 -28
- package/src/routes/docs/evalOperator.js +0 -70
- package/src/routes/docs/inspectState.js +0 -59
- package/src/routes/docs/loadState.js +0 -51
- package/src/routes/docs/pluginDoc.js +0 -33
- package/src/routes/docs/plugins.js +0 -23
- package/src/routes/docs/runEndpoint.js +0 -54
- package/src/routes/docs/runEndpoint.test.mjs +0 -165
- package/src/routes/docs/runRequest.js +0 -53
- package/src/routes/docs/runRequest.test.mjs +0 -92
- package/src/routes/docs/schema.js +0 -37
- package/src/routes/docs/screenshot.js +0 -120
- package/src/routes/docs/screenshot.test.mjs +0 -117
- package/src/routes/docs/search.js +0 -40
- package/src/routes/docs/snapshotState.js +0 -50
- package/src/routes/docs/stateCheckpointsList.js +0 -26
- package/src/routes/docs/types.js +0 -33
- package/src/routes/feedback.js +0 -107
- package/src/routes/feedback.test.mjs +0 -204
|
@@ -1,159 +0,0 @@
|
|
|
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 { getBrowser, openPage, buildPageUrl } from './getBrowser.js';
|
|
20
|
-
import noBrowserError from './noBrowserError.js';
|
|
21
|
-
import resolvePageInstance from './resolvePageInstance.js';
|
|
22
|
-
import resolveToolCaller from './resolveToolCaller.js';
|
|
23
|
-
import unsettledPageNote from './unsettledPageNote.js';
|
|
24
|
-
import withBrowserSlot from './withBrowserSlot.js';
|
|
25
|
-
import withDataSession from './withDataSession.js';
|
|
26
|
-
|
|
27
|
-
// Evaluates an operator expression against the live client state of a
|
|
28
|
-
// headless Chromium tab navigated to the page instance's own route (`pathParams`
|
|
29
|
-
// fill a patterned page's placeholders), read under the instance key, using the page's
|
|
30
|
-
// own WebParser instance so results match runtime exactly. Mirrors
|
|
31
|
-
// Inspector.jsx's evalExpression (the live-tab equivalent).
|
|
32
|
-
async function evalOperatorHeadless({
|
|
33
|
-
origin,
|
|
34
|
-
pageId,
|
|
35
|
-
pathParams,
|
|
36
|
-
expression,
|
|
37
|
-
user,
|
|
38
|
-
data,
|
|
39
|
-
timeout = 15000,
|
|
40
|
-
}) {
|
|
41
|
-
if (type.isNone(origin) || !type.isString(origin)) {
|
|
42
|
-
return {
|
|
43
|
-
error: `evalOperatorHeadless requires an "origin" string. Received ${JSON.stringify(
|
|
44
|
-
origin
|
|
45
|
-
)}.`,
|
|
46
|
-
};
|
|
47
|
-
}
|
|
48
|
-
if (type.isNone(pageId) || !type.isString(pageId)) {
|
|
49
|
-
return {
|
|
50
|
-
error: `evalOperatorHeadless requires a "pageId" string. Received ${JSON.stringify(pageId)}.`,
|
|
51
|
-
};
|
|
52
|
-
}
|
|
53
|
-
if (type.isNone(expression)) {
|
|
54
|
-
return { error: 'evalOperatorHeadless requires an "expression".' };
|
|
55
|
-
}
|
|
56
|
-
|
|
57
|
-
const instance = resolvePageInstance({ pageId, pathParams });
|
|
58
|
-
if (!type.isUndefined(instance.error)) {
|
|
59
|
-
return { error: instance.error, invalidInput: true };
|
|
60
|
-
}
|
|
61
|
-
|
|
62
|
-
const caller = await resolveToolCaller({ user, data });
|
|
63
|
-
if (!type.isUndefined(caller.error)) {
|
|
64
|
-
return caller;
|
|
65
|
-
}
|
|
66
|
-
|
|
67
|
-
return withBrowserSlot({
|
|
68
|
-
task: () =>
|
|
69
|
-
withDataSession({
|
|
70
|
-
dataSet: caller.dataSet,
|
|
71
|
-
task: ({ dataCookie }) =>
|
|
72
|
-
evalOperatorInBrowser({
|
|
73
|
-
origin,
|
|
74
|
-
pageId,
|
|
75
|
-
pathParams,
|
|
76
|
-
instance,
|
|
77
|
-
expression,
|
|
78
|
-
user: caller.user,
|
|
79
|
-
dataCookie,
|
|
80
|
-
timeout,
|
|
81
|
-
}),
|
|
82
|
-
}),
|
|
83
|
-
});
|
|
84
|
-
}
|
|
85
|
-
|
|
86
|
-
// The part of evalOperatorHeadless that runs in the browser, inside a browser slot.
|
|
87
|
-
async function evalOperatorInBrowser({
|
|
88
|
-
origin,
|
|
89
|
-
pageId,
|
|
90
|
-
pathParams,
|
|
91
|
-
instance,
|
|
92
|
-
expression,
|
|
93
|
-
user,
|
|
94
|
-
dataCookie,
|
|
95
|
-
timeout,
|
|
96
|
-
}) {
|
|
97
|
-
let browser;
|
|
98
|
-
try {
|
|
99
|
-
browser = await getBrowser();
|
|
100
|
-
} catch (error) {
|
|
101
|
-
return { error: noBrowserError(error) };
|
|
102
|
-
}
|
|
103
|
-
|
|
104
|
-
const url = buildPageUrl({ origin, pageId, path: instance.path, pathParams });
|
|
105
|
-
|
|
106
|
-
let context;
|
|
107
|
-
try {
|
|
108
|
-
const opened = await openPage({
|
|
109
|
-
browser,
|
|
110
|
-
origin,
|
|
111
|
-
pageId,
|
|
112
|
-
path: instance.path,
|
|
113
|
-
pathParams,
|
|
114
|
-
user,
|
|
115
|
-
dataCookie,
|
|
116
|
-
timeout,
|
|
117
|
-
});
|
|
118
|
-
context = opened.context;
|
|
119
|
-
// Passed through as JSON so the page-side parser always receives a plain
|
|
120
|
-
// value, matching how it arrives at Inspector.jsx's eval-request handler.
|
|
121
|
-
const expressionJson = JSON.stringify(expression);
|
|
122
|
-
const result = await opened.page.evaluate(
|
|
123
|
-
({ id, instanceKey, path, exprJson }) => {
|
|
124
|
-
const lowdefy = window.lowdefy;
|
|
125
|
-
const pageContext = lowdefy?.contexts?.[instanceKey];
|
|
126
|
-
if (!pageContext) {
|
|
127
|
-
return { error: `No live context for page "${id}" at "/${path}".` };
|
|
128
|
-
}
|
|
129
|
-
const input = JSON.parse(exprJson);
|
|
130
|
-
const { output, errors } = pageContext._internal.parser.parse({
|
|
131
|
-
input,
|
|
132
|
-
location: 'agent_eval',
|
|
133
|
-
});
|
|
134
|
-
return {
|
|
135
|
-
value: output === undefined ? undefined : JSON.parse(JSON.stringify(output)),
|
|
136
|
-
errors: errors.map((error) => error.message),
|
|
137
|
-
};
|
|
138
|
-
},
|
|
139
|
-
{
|
|
140
|
-
id: pageId,
|
|
141
|
-
instanceKey: instance.instanceKey,
|
|
142
|
-
path: instance.path,
|
|
143
|
-
exprJson: expressionJson,
|
|
144
|
-
}
|
|
145
|
-
);
|
|
146
|
-
if (!opened.ready) {
|
|
147
|
-
return { ...result, ready: false, note: unsettledPageNote({ timeout }) };
|
|
148
|
-
}
|
|
149
|
-
return result;
|
|
150
|
-
} catch (error) {
|
|
151
|
-
return { error: `Failed to evaluate operator at "${url}": ${error.message}` };
|
|
152
|
-
} finally {
|
|
153
|
-
if (context) {
|
|
154
|
-
await context.close();
|
|
155
|
-
}
|
|
156
|
-
}
|
|
157
|
-
}
|
|
158
|
-
|
|
159
|
-
export default evalOperatorHeadless;
|
|
@@ -1,78 +0,0 @@
|
|
|
1
|
-
/*
|
|
2
|
-
Copyright 2020-2026 Lowdefy, Inc
|
|
3
|
-
|
|
4
|
-
Licensed under the Apache License, Version 2.0 (the "License");
|
|
5
|
-
you may not use this file except in compliance with the License.
|
|
6
|
-
You may obtain a copy of the License at
|
|
7
|
-
|
|
8
|
-
http://www.apache.org/licenses/LICENSE-2.0
|
|
9
|
-
|
|
10
|
-
Unless required by applicable law or agreed to in writing, software
|
|
11
|
-
distributed under the License is distributed on an "AS IS" BASIS,
|
|
12
|
-
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
13
|
-
See the License for the specific language governing permissions and
|
|
14
|
-
limitations under the License.
|
|
15
|
-
*/
|
|
16
|
-
|
|
17
|
-
import fs from 'fs';
|
|
18
|
-
import os from 'os';
|
|
19
|
-
import path from 'path';
|
|
20
|
-
import { jest } from '@jest/globals';
|
|
21
|
-
|
|
22
|
-
// A real headless evaluation needs an installed browser, which jest can't
|
|
23
|
-
// rely on, so this only covers the error paths: bad input, and
|
|
24
|
-
// chromium.launch failing (the "no browser installed" case). Mirrors
|
|
25
|
-
// screenshotPage.test.mjs, which exercises the same getBrowser.js singleton.
|
|
26
|
-
jest.unstable_mockModule('playwright-core', () => ({
|
|
27
|
-
chromium: { launch: jest.fn().mockRejectedValue(new Error("Executable doesn't exist")) },
|
|
28
|
-
selectors: { register: jest.fn(async () => {}) },
|
|
29
|
-
}));
|
|
30
|
-
// A missing shell would otherwise start a real download.
|
|
31
|
-
jest.unstable_mockModule('./installHeadlessShell.js', () => ({ default: () => null }));
|
|
32
|
-
|
|
33
|
-
// lib/build/config.js reads build/config.json from process.cwd() at import
|
|
34
|
-
// time — chdir into a fixture that has one before getBrowser.js (which
|
|
35
|
-
// imports it transitively) is loaded. Mirrors the pattern in
|
|
36
|
-
// screenshotPage.test.mjs.
|
|
37
|
-
const originalCwd = process.cwd();
|
|
38
|
-
const fixtureDir = fs.mkdtempSync(path.join(os.tmpdir(), 'lowdefy-eval-operator-test-'));
|
|
39
|
-
fs.mkdirSync(path.join(fixtureDir, 'build'), { recursive: true });
|
|
40
|
-
fs.writeFileSync(path.join(fixtureDir, 'build', 'config.json'), JSON.stringify({ basePath: '' }));
|
|
41
|
-
fs.writeFileSync(path.join(fixtureDir, 'build', 'routes.json'), JSON.stringify([]));
|
|
42
|
-
process.chdir(fixtureDir);
|
|
43
|
-
|
|
44
|
-
const { default: evalOperatorHeadless } = await import('./evalOperatorHeadless.js');
|
|
45
|
-
|
|
46
|
-
afterAll(() => {
|
|
47
|
-
process.chdir(originalCwd);
|
|
48
|
-
fs.rmSync(fixtureDir, { recursive: true, force: true });
|
|
49
|
-
});
|
|
50
|
-
|
|
51
|
-
test('evalOperatorHeadless returns an error when origin is missing', async () => {
|
|
52
|
-
const result = await evalOperatorHeadless({ pageId: 'home', expression: { _state: 'x' } });
|
|
53
|
-
expect(result.error).toMatch(/requires an "origin" string/);
|
|
54
|
-
});
|
|
55
|
-
|
|
56
|
-
test('evalOperatorHeadless returns an error when pageId is missing', async () => {
|
|
57
|
-
const result = await evalOperatorHeadless({
|
|
58
|
-
origin: 'http://localhost:3001',
|
|
59
|
-
expression: { _state: 'x' },
|
|
60
|
-
});
|
|
61
|
-
expect(result.error).toMatch(/requires a "pageId" string/);
|
|
62
|
-
});
|
|
63
|
-
|
|
64
|
-
test('evalOperatorHeadless returns an error when expression is missing', async () => {
|
|
65
|
-
const result = await evalOperatorHeadless({ origin: 'http://localhost:3001', pageId: 'home' });
|
|
66
|
-
expect(result.error).toMatch(/requires an "expression"/);
|
|
67
|
-
});
|
|
68
|
-
|
|
69
|
-
test('evalOperatorHeadless returns an actionable error when no browser is available', async () => {
|
|
70
|
-
const result = await evalOperatorHeadless({
|
|
71
|
-
origin: 'http://localhost:3001',
|
|
72
|
-
pageId: 'home',
|
|
73
|
-
expression: { _state: 'x' },
|
|
74
|
-
});
|
|
75
|
-
expect(result.error).toMatch(
|
|
76
|
-
/No Chromium available. Run: npx playwright install chromium-headless-shell/
|
|
77
|
-
);
|
|
78
|
-
});
|
|
@@ -1,49 +0,0 @@
|
|
|
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, serializer } from '@lowdefy/helpers';
|
|
18
|
-
|
|
19
|
-
import { requestFromTab } from './tabChannel.js';
|
|
20
|
-
|
|
21
|
-
// Evaluates an operator expression against the live client state of a page
|
|
22
|
-
// open in a developer's real browser tab (e.g. `{ _state: 'myInput' }`),
|
|
23
|
-
// using the page's own WebParser instance so results match runtime exactly.
|
|
24
|
-
//
|
|
25
|
-
// requestFromTab resolves directly with whatever the tab posted as `result`
|
|
26
|
-
// (see tabChannel.js) — `{ value, errors }` on success, or an `{ error }`
|
|
27
|
-
// object if no tab is connected, the request timed out, or Inspector.jsx
|
|
28
|
-
// itself failed to evaluate the expression.
|
|
29
|
-
async function evalOperatorInTab({ pageId, pathParams, expression }) {
|
|
30
|
-
if (type.isNone(expression)) {
|
|
31
|
-
throw new Error('evalOperatorInTab requires an "expression".');
|
|
32
|
-
}
|
|
33
|
-
const response = await requestFromTab({
|
|
34
|
-
pageId,
|
|
35
|
-
pathParams,
|
|
36
|
-
event: 'eval-request',
|
|
37
|
-
payload: { expression },
|
|
38
|
-
});
|
|
39
|
-
if (response?.error) {
|
|
40
|
-
return { error: response.error };
|
|
41
|
-
}
|
|
42
|
-
const { value, errors } = response;
|
|
43
|
-
return {
|
|
44
|
-
value: type.isUndefined(value) ? undefined : serializer.deserializeFromString(value),
|
|
45
|
-
errors,
|
|
46
|
-
};
|
|
47
|
-
}
|
|
48
|
-
|
|
49
|
-
export default evalOperatorInTab;
|
|
@@ -1,142 +0,0 @@
|
|
|
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
|
-
// Turns one or more enriched feedback batches (after enrichFeedback.js has
|
|
20
|
-
// attached `annotation.location`) into a single agent-readable text block.
|
|
21
|
-
// The overlay copies this text to the developer's clipboard — they paste it
|
|
22
|
-
// into their agent session. Kept as a pure string formatter — no
|
|
23
|
-
// build-artifact access.
|
|
24
|
-
function formatFeedback({ items }) {
|
|
25
|
-
if (type.isNone(items) || items.length === 0) {
|
|
26
|
-
return 'No pending feedback. The developer has not submitted any annotations yet.';
|
|
27
|
-
}
|
|
28
|
-
return items.map(formatBatch).join('\n\n---\n\n');
|
|
29
|
-
}
|
|
30
|
-
|
|
31
|
-
// A page with placeholders in its path names the instance by its values.
|
|
32
|
-
function hasPathParams(batch) {
|
|
33
|
-
return Object.keys(batch.pathParams ?? {}).length > 0;
|
|
34
|
-
}
|
|
35
|
-
|
|
36
|
-
function describePage(batch) {
|
|
37
|
-
if (!hasPathParams(batch)) {
|
|
38
|
-
return `page "${batch.pageId}"`;
|
|
39
|
-
}
|
|
40
|
-
return `page "${batch.pageId}" with pathParams ${JSON.stringify(batch.pathParams)}`;
|
|
41
|
-
}
|
|
42
|
-
|
|
43
|
-
function inspectStateCall(batch) {
|
|
44
|
-
if (!hasPathParams(batch)) {
|
|
45
|
-
return `lowdefy_inspect_state({ pageId: "${batch.pageId}" })`;
|
|
46
|
-
}
|
|
47
|
-
return `lowdefy_inspect_state({ pageId: "${batch.pageId}", pathParams: ${JSON.stringify(
|
|
48
|
-
batch.pathParams
|
|
49
|
-
)} })`;
|
|
50
|
-
}
|
|
51
|
-
|
|
52
|
-
function formatBatch(batch) {
|
|
53
|
-
const viewport = batch.viewport ?? {};
|
|
54
|
-
const lines = [
|
|
55
|
-
`Feedback: ${batch.annotations?.length ?? 0} annotation(s) on ${describePage(batch)} ` +
|
|
56
|
-
`(${batch.url ?? 'unknown url'}) — viewport ${viewport.width}x${viewport.height} ` +
|
|
57
|
-
`@${viewport.dpr ?? 1}x, scrollY ${viewport.scrollY ?? 0}`,
|
|
58
|
-
'',
|
|
59
|
-
];
|
|
60
|
-
|
|
61
|
-
(batch.annotations ?? []).forEach((annotation, index) => {
|
|
62
|
-
lines.push(formatAnnotation({ annotation, index }));
|
|
63
|
-
});
|
|
64
|
-
|
|
65
|
-
if (batch.screenshotPath) {
|
|
66
|
-
lines.push('');
|
|
67
|
-
lines.push(
|
|
68
|
-
`Annotated screenshot: ${batch.screenshotPath} (read this image to see the drawings)`
|
|
69
|
-
);
|
|
70
|
-
}
|
|
71
|
-
|
|
72
|
-
lines.push('');
|
|
73
|
-
lines.push(`For the page's live state call ${inspectStateCall(batch)}.`);
|
|
74
|
-
|
|
75
|
-
return lines.join('\n');
|
|
76
|
-
}
|
|
77
|
-
|
|
78
|
-
function formatAnnotation({ annotation, index }) {
|
|
79
|
-
const lines = [];
|
|
80
|
-
const num = index + 1;
|
|
81
|
-
const locationText = formatLocation(annotation.location);
|
|
82
|
-
|
|
83
|
-
if (annotation.kind === 'element' && annotation.target) {
|
|
84
|
-
const header = locationText
|
|
85
|
-
? `${num}. Element "${annotation.target.blockId}" (${locationText})`
|
|
86
|
-
: `${num}. Element "${annotation.target.blockId}"`;
|
|
87
|
-
lines.push(header);
|
|
88
|
-
if (annotation.target.ancestorBlockIds?.length > 0) {
|
|
89
|
-
lines.push(` Ancestors: ${annotation.target.ancestorBlockIds.join(' > ')}`);
|
|
90
|
-
}
|
|
91
|
-
if (annotation.target.tag) {
|
|
92
|
-
const text = annotation.target.text ? ` "${annotation.target.text}"` : '';
|
|
93
|
-
lines.push(` Tag: ${annotation.target.tag}${text}`);
|
|
94
|
-
}
|
|
95
|
-
} else {
|
|
96
|
-
lines.push(`${num}. Region`);
|
|
97
|
-
}
|
|
98
|
-
|
|
99
|
-
lines.push(` Comment: ${annotation.comment}`);
|
|
100
|
-
|
|
101
|
-
const shapesSummary = summarizeShapes({
|
|
102
|
-
shapes: annotation.geometry?.shapes,
|
|
103
|
-
hasElementRect: !type.isNone(annotation.geometry?.elementRect),
|
|
104
|
-
});
|
|
105
|
-
if (shapesSummary) {
|
|
106
|
-
lines.push(` Shapes: ${shapesSummary}`);
|
|
107
|
-
}
|
|
108
|
-
|
|
109
|
-
return lines.join('\n');
|
|
110
|
-
}
|
|
111
|
-
|
|
112
|
-
function formatLocation(location) {
|
|
113
|
-
if (type.isNone(location)) {
|
|
114
|
-
return null;
|
|
115
|
-
}
|
|
116
|
-
if (location.source && location.resolvedVia) {
|
|
117
|
-
return `generated at runtime — defined via ancestor "${location.resolvedVia}": ${location.source}`;
|
|
118
|
-
}
|
|
119
|
-
return location.source ?? location.note ?? null;
|
|
120
|
-
}
|
|
121
|
-
|
|
122
|
-
// Counts shapes by type (rect/arrow/freehand) preserving first-seen order,
|
|
123
|
-
// e.g. "1 rect around the element, 1 arrow" — the first counted type is
|
|
124
|
-
// attributed to the targeted element when the annotation carries an
|
|
125
|
-
// elementRect, since that is the shape drawn to select it.
|
|
126
|
-
function summarizeShapes({ shapes, hasElementRect }) {
|
|
127
|
-
if (!shapes || shapes.length === 0) {
|
|
128
|
-
return null;
|
|
129
|
-
}
|
|
130
|
-
const counts = new Map();
|
|
131
|
-
shapes.forEach((shape) => {
|
|
132
|
-
counts.set(shape.type, (counts.get(shape.type) ?? 0) + 1);
|
|
133
|
-
});
|
|
134
|
-
return Array.from(counts.entries())
|
|
135
|
-
.map(([shapeType, shapeCount], index) => {
|
|
136
|
-
const label = `${shapeCount} ${shapeType}${shapeCount > 1 ? 's' : ''}`;
|
|
137
|
-
return index === 0 && hasElementRect ? `${label} around the element` : label;
|
|
138
|
-
})
|
|
139
|
-
.join(', ');
|
|
140
|
-
}
|
|
141
|
-
|
|
142
|
-
export default formatFeedback;
|
|
@@ -1,252 +0,0 @@
|
|
|
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 { jest } from '@jest/globals';
|
|
18
|
-
|
|
19
|
-
const mockFindConfig = jest.fn();
|
|
20
|
-
jest.unstable_mockModule('./findConfig.js', () => ({
|
|
21
|
-
default: mockFindConfig,
|
|
22
|
-
}));
|
|
23
|
-
|
|
24
|
-
const { default: enrichFeedback } = await import('./enrichFeedback.js');
|
|
25
|
-
const { default: formatFeedback } = await import('./formatFeedback.js');
|
|
26
|
-
|
|
27
|
-
beforeEach(() => {
|
|
28
|
-
mockFindConfig.mockReset();
|
|
29
|
-
});
|
|
30
|
-
|
|
31
|
-
// --- enrichFeedback ---
|
|
32
|
-
|
|
33
|
-
test('enrichFeedback attaches a location to annotations with a target blockId', async () => {
|
|
34
|
-
mockFindConfig.mockResolvedValue({
|
|
35
|
-
matches: [
|
|
36
|
-
{
|
|
37
|
-
keyPath: 'root.pages[0:login].blocks[2:submit_button:Button]',
|
|
38
|
-
location: {
|
|
39
|
-
source: 'pages/login.yaml:12',
|
|
40
|
-
config: 'root.pages[0:login].blocks[2:submit_button:Button]',
|
|
41
|
-
},
|
|
42
|
-
},
|
|
43
|
-
],
|
|
44
|
-
});
|
|
45
|
-
const batch = {
|
|
46
|
-
pageId: 'login',
|
|
47
|
-
annotations: [
|
|
48
|
-
{
|
|
49
|
-
id: '1',
|
|
50
|
-
kind: 'element',
|
|
51
|
-
comment: 'too small',
|
|
52
|
-
target: {
|
|
53
|
-
blockId: 'submit_button',
|
|
54
|
-
ancestorBlockIds: ['submit_button', 'login_form'],
|
|
55
|
-
tag: 'BUTTON',
|
|
56
|
-
text: 'Submit',
|
|
57
|
-
},
|
|
58
|
-
geometry: { elementRect: { x: 220, y: 480, width: 96, height: 40 }, shapes: [] },
|
|
59
|
-
},
|
|
60
|
-
],
|
|
61
|
-
};
|
|
62
|
-
|
|
63
|
-
const enriched = await enrichFeedback({ batch });
|
|
64
|
-
|
|
65
|
-
expect(mockFindConfig).toHaveBeenCalledWith({ id: 'submit_button', pageId: 'login' });
|
|
66
|
-
expect(enriched.annotations[0].location).toEqual({
|
|
67
|
-
source: 'pages/login.yaml:12',
|
|
68
|
-
config: 'root.pages[0:login].blocks[2:submit_button:Button]',
|
|
69
|
-
});
|
|
70
|
-
});
|
|
71
|
-
|
|
72
|
-
test('enrichFeedback attaches a note when findConfig finds no matches', async () => {
|
|
73
|
-
mockFindConfig.mockResolvedValue({
|
|
74
|
-
matches: [],
|
|
75
|
-
note: 'Block is generated at runtime — no configured ancestor found on page "login".',
|
|
76
|
-
});
|
|
77
|
-
const batch = {
|
|
78
|
-
pageId: 'login',
|
|
79
|
-
annotations: [{ id: '1', kind: 'element', comment: 'x', target: { blockId: 'missing' } }],
|
|
80
|
-
};
|
|
81
|
-
|
|
82
|
-
const enriched = await enrichFeedback({ batch });
|
|
83
|
-
|
|
84
|
-
expect(enriched.annotations[0].location).toEqual({
|
|
85
|
-
note: 'Block is generated at runtime — no configured ancestor found on page "login".',
|
|
86
|
-
});
|
|
87
|
-
});
|
|
88
|
-
|
|
89
|
-
test('enrichFeedback leaves annotations without a target blockId unchanged', async () => {
|
|
90
|
-
const batch = {
|
|
91
|
-
pageId: 'login',
|
|
92
|
-
annotations: [{ id: '1', kind: 'region', comment: 'x', target: null }],
|
|
93
|
-
};
|
|
94
|
-
|
|
95
|
-
const enriched = await enrichFeedback({ batch });
|
|
96
|
-
|
|
97
|
-
expect(mockFindConfig).not.toHaveBeenCalled();
|
|
98
|
-
expect(enriched.annotations[0]).toEqual({ id: '1', kind: 'region', comment: 'x', target: null });
|
|
99
|
-
});
|
|
100
|
-
|
|
101
|
-
test('enrichFeedback still returns the batch when findConfig throws', async () => {
|
|
102
|
-
mockFindConfig.mockRejectedValue(new Error('boom'));
|
|
103
|
-
const batch = {
|
|
104
|
-
pageId: 'login',
|
|
105
|
-
annotations: [{ id: '1', kind: 'element', comment: 'x', target: { blockId: 'submit_button' } }],
|
|
106
|
-
};
|
|
107
|
-
|
|
108
|
-
const enriched = await enrichFeedback({ batch });
|
|
109
|
-
|
|
110
|
-
expect(enriched.annotations).toHaveLength(1);
|
|
111
|
-
expect(enriched.annotations[0].location.note).toMatch(/Failed to resolve location: boom/);
|
|
112
|
-
});
|
|
113
|
-
|
|
114
|
-
// --- formatFeedback ---
|
|
115
|
-
|
|
116
|
-
test('formatFeedback returns a message when there is no pending feedback', () => {
|
|
117
|
-
expect(formatFeedback({ items: [] })).toMatch(/No pending feedback/);
|
|
118
|
-
});
|
|
119
|
-
|
|
120
|
-
test('formatFeedback formats an element annotation with location, ancestors, comment, shapes, and screenshot', () => {
|
|
121
|
-
const items = [
|
|
122
|
-
{
|
|
123
|
-
pageId: 'login',
|
|
124
|
-
url: '/login?x=1',
|
|
125
|
-
viewport: { width: 1280, height: 720, scrollX: 0, scrollY: 340, dpr: 2 },
|
|
126
|
-
annotations: [
|
|
127
|
-
{
|
|
128
|
-
id: '1',
|
|
129
|
-
kind: 'element',
|
|
130
|
-
comment: 'Button is too small on mobile',
|
|
131
|
-
target: {
|
|
132
|
-
blockId: 'submit_button',
|
|
133
|
-
ancestorBlockIds: ['submit_button', 'login_form'],
|
|
134
|
-
tag: 'BUTTON',
|
|
135
|
-
text: 'Submit',
|
|
136
|
-
},
|
|
137
|
-
geometry: {
|
|
138
|
-
elementRect: { x: 220, y: 480, width: 96, height: 40 },
|
|
139
|
-
shapes: [
|
|
140
|
-
{ type: 'rect', points: [] },
|
|
141
|
-
{ type: 'arrow', points: [] },
|
|
142
|
-
],
|
|
143
|
-
},
|
|
144
|
-
location: {
|
|
145
|
-
source: 'pages/login.yaml:12',
|
|
146
|
-
config: 'root.pages[0:login].blocks[2:submit_button:Button]',
|
|
147
|
-
},
|
|
148
|
-
},
|
|
149
|
-
],
|
|
150
|
-
screenshotPath: '.lowdefy/annotations/login-test.png',
|
|
151
|
-
},
|
|
152
|
-
];
|
|
153
|
-
|
|
154
|
-
const text = formatFeedback({ items });
|
|
155
|
-
|
|
156
|
-
expect(text).toContain('1 annotation(s) on page "login"');
|
|
157
|
-
expect(text).toContain('viewport 1280x720 @2x, scrollY 340');
|
|
158
|
-
expect(text).toContain('Element "submit_button" (pages/login.yaml:12)');
|
|
159
|
-
expect(text).toContain('Ancestors: submit_button > login_form');
|
|
160
|
-
expect(text).toContain('Comment: Button is too small on mobile');
|
|
161
|
-
expect(text).toContain('1 rect around the element, 1 arrow');
|
|
162
|
-
expect(text).toContain('Annotated screenshot: .lowdefy/annotations/login-test.png');
|
|
163
|
-
expect(text).toContain('lowdefy_inspect_state({ pageId: "login" })');
|
|
164
|
-
expect(text).not.toContain('Console');
|
|
165
|
-
});
|
|
166
|
-
|
|
167
|
-
test('formatFeedback formats a region annotation without a target', () => {
|
|
168
|
-
const items = [
|
|
169
|
-
{
|
|
170
|
-
pageId: 'home',
|
|
171
|
-
url: '/home',
|
|
172
|
-
viewport: { width: 1280, height: 720 },
|
|
173
|
-
annotations: [
|
|
174
|
-
{
|
|
175
|
-
id: '1',
|
|
176
|
-
kind: 'region',
|
|
177
|
-
comment: 'Layout looks off here',
|
|
178
|
-
target: null,
|
|
179
|
-
geometry: { elementRect: null, shapes: [{ type: 'freehand', points: [] }] },
|
|
180
|
-
},
|
|
181
|
-
],
|
|
182
|
-
},
|
|
183
|
-
];
|
|
184
|
-
|
|
185
|
-
const text = formatFeedback({ items });
|
|
186
|
-
|
|
187
|
-
expect(text).toContain('1. Region');
|
|
188
|
-
expect(text).toContain('Comment: Layout looks off here');
|
|
189
|
-
expect(text).toContain('1 freehand');
|
|
190
|
-
});
|
|
191
|
-
|
|
192
|
-
test('formatFeedback multiple batches are joined and each keeps its own pageId in instructions', () => {
|
|
193
|
-
const items = [
|
|
194
|
-
{ pageId: 'login', url: '/login', viewport: { width: 100, height: 100 }, annotations: [] },
|
|
195
|
-
{ pageId: 'home', url: '/home', viewport: { width: 100, height: 100 }, annotations: [] },
|
|
196
|
-
];
|
|
197
|
-
|
|
198
|
-
const text = formatFeedback({ items });
|
|
199
|
-
|
|
200
|
-
expect(text).toContain('page "login"');
|
|
201
|
-
expect(text).toContain('page "home"');
|
|
202
|
-
expect(text).toContain('lowdefy_inspect_state({ pageId: "login" })');
|
|
203
|
-
expect(text).toContain('lowdefy_inspect_state({ pageId: "home" })');
|
|
204
|
-
});
|
|
205
|
-
|
|
206
|
-
test('formatFeedback names the page instance by its pathParams', () => {
|
|
207
|
-
const text = formatFeedback({
|
|
208
|
-
items: [
|
|
209
|
-
{
|
|
210
|
-
pageId: 'ticket',
|
|
211
|
-
pathParams: { space: 's', ticket_id: '1' },
|
|
212
|
-
url: '/tickets/s/1',
|
|
213
|
-
viewport: { width: 100, height: 100 },
|
|
214
|
-
annotations: [],
|
|
215
|
-
},
|
|
216
|
-
],
|
|
217
|
-
});
|
|
218
|
-
expect(text).toContain(
|
|
219
|
-
'Feedback: 0 annotation(s) on page "ticket" with pathParams {"space":"s","ticket_id":"1"} (/tickets/s/1)'
|
|
220
|
-
);
|
|
221
|
-
expect(text).toContain(
|
|
222
|
-
'lowdefy_inspect_state({ pageId: "ticket", pathParams: {"space":"s","ticket_id":"1"} })'
|
|
223
|
-
);
|
|
224
|
-
});
|
|
225
|
-
|
|
226
|
-
test('formatFeedback leaves empty pathParams out', () => {
|
|
227
|
-
const text = formatFeedback({
|
|
228
|
-
items: [
|
|
229
|
-
{
|
|
230
|
-
pageId: 'home',
|
|
231
|
-
pathParams: {},
|
|
232
|
-
url: '/home',
|
|
233
|
-
viewport: { width: 100, height: 100 },
|
|
234
|
-
annotations: [],
|
|
235
|
-
},
|
|
236
|
-
],
|
|
237
|
-
});
|
|
238
|
-
expect(text).toContain('Feedback: 0 annotation(s) on page "home" (/home)');
|
|
239
|
-
expect(text).toContain('lowdefy_inspect_state({ pageId: "home" })');
|
|
240
|
-
});
|
|
241
|
-
|
|
242
|
-
test('enrichFeedback keeps the batch pathParams', async () => {
|
|
243
|
-
const enriched = await enrichFeedback({
|
|
244
|
-
batch: {
|
|
245
|
-
pageId: 'ticket',
|
|
246
|
-
pathParams: { space: 's', ticket_id: '1' },
|
|
247
|
-
urlQuery: '',
|
|
248
|
-
annotations: [],
|
|
249
|
-
},
|
|
250
|
-
});
|
|
251
|
-
expect(enriched.pathParams).toEqual({ space: 's', ticket_id: '1' });
|
|
252
|
-
});
|