@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,443 +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
|
-
// checkpointStore.js reads LOWDEFY_DIRECTORY_CONFIG for where to store
|
|
23
|
-
// checkpoints, and lib/build/config.js (imported transitively by
|
|
24
|
-
// loadState.js -> getBrowser.js) reads build/config.json from
|
|
25
|
-
// process.cwd() at import time — one fixture dir serves both, mirroring
|
|
26
|
-
// screenshotPage.test.mjs / configCheckpoints.test.mjs.
|
|
27
|
-
const originalCwd = process.cwd();
|
|
28
|
-
const previousConfigDirectory = process.env.LOWDEFY_DIRECTORY_CONFIG;
|
|
29
|
-
const fixtureDir = fs.mkdtempSync(path.join(os.tmpdir(), 'lowdefy-state-checkpoints-test-'));
|
|
30
|
-
fs.mkdirSync(path.join(fixtureDir, 'build'), { recursive: true });
|
|
31
|
-
fs.writeFileSync(path.join(fixtureDir, 'build', 'config.json'), JSON.stringify({ basePath: '' }));
|
|
32
|
-
fs.writeFileSync(
|
|
33
|
-
path.join(fixtureDir, 'build', 'routes.json'),
|
|
34
|
-
JSON.stringify([
|
|
35
|
-
{ pageId: 'home', path: 'home' },
|
|
36
|
-
{ pageId: 'ticket', path: 'tickets/{space}/{ticket_id}' },
|
|
37
|
-
])
|
|
38
|
-
);
|
|
39
|
-
process.chdir(fixtureDir);
|
|
40
|
-
process.env.LOWDEFY_DIRECTORY_CONFIG = fixtureDir;
|
|
41
|
-
|
|
42
|
-
// A real headless load needs an installed browser, which jest can't rely on —
|
|
43
|
-
// loadState's registry-only mode (the only mode under test here) never
|
|
44
|
-
// calls getBrowser(), but chromium is mocked anyway so importing
|
|
45
|
-
// getBrowser.js can never accidentally launch a real browser.
|
|
46
|
-
jest.unstable_mockModule('playwright-core', () => ({
|
|
47
|
-
chromium: { launch: jest.fn().mockRejectedValue(new Error("Executable doesn't exist")) },
|
|
48
|
-
}));
|
|
49
|
-
// A missing shell would otherwise start a real download.
|
|
50
|
-
jest.unstable_mockModule('./installHeadlessShell.js', () => ({ default: () => null }));
|
|
51
|
-
|
|
52
|
-
const mockInspectState = jest.fn();
|
|
53
|
-
jest.unstable_mockModule('./inspectState.js', () => ({
|
|
54
|
-
default: mockInspectState,
|
|
55
|
-
}));
|
|
56
|
-
|
|
57
|
-
const {
|
|
58
|
-
checkpointExists,
|
|
59
|
-
getStateCheckpointsRoot,
|
|
60
|
-
listStateCheckpoints,
|
|
61
|
-
readCheckpoint,
|
|
62
|
-
writeCheckpoint,
|
|
63
|
-
} = await import('./checkpointStore.js');
|
|
64
|
-
const { clearMocks, getMock, listMocks, loadMocks } = await import('./devMockRegistry.js');
|
|
65
|
-
const { default: checkpointToMocks } = await import('./checkpointToMocks.js');
|
|
66
|
-
const { default: snapshotState } = await import('./snapshotState.js');
|
|
67
|
-
const { default: loadState } = await import('./loadState.js');
|
|
68
|
-
|
|
69
|
-
afterAll(() => {
|
|
70
|
-
process.chdir(originalCwd);
|
|
71
|
-
fs.rmSync(fixtureDir, { recursive: true, force: true });
|
|
72
|
-
if (previousConfigDirectory === undefined) {
|
|
73
|
-
delete process.env.LOWDEFY_DIRECTORY_CONFIG;
|
|
74
|
-
} else {
|
|
75
|
-
process.env.LOWDEFY_DIRECTORY_CONFIG = previousConfigDirectory;
|
|
76
|
-
}
|
|
77
|
-
});
|
|
78
|
-
|
|
79
|
-
afterEach(() => {
|
|
80
|
-
clearMocks();
|
|
81
|
-
});
|
|
82
|
-
|
|
83
|
-
function buildSnapshot(overrides = {}) {
|
|
84
|
-
return {
|
|
85
|
-
pageId: 'home',
|
|
86
|
-
url: 'http://localhost:3111/home',
|
|
87
|
-
state: { count: 1 },
|
|
88
|
-
urlQuery: '?a=1',
|
|
89
|
-
input: { fromInput: true },
|
|
90
|
-
user: { id: 'u1' },
|
|
91
|
-
global: { g: 1 },
|
|
92
|
-
requests: {
|
|
93
|
-
req1: [{ payload: { a: 1 }, response: { ok: true }, error: null, responseTime: 12 }],
|
|
94
|
-
},
|
|
95
|
-
apiResponses: {
|
|
96
|
-
ep1: { payload: {}, response: { v: 1 } },
|
|
97
|
-
},
|
|
98
|
-
...overrides,
|
|
99
|
-
};
|
|
100
|
-
}
|
|
101
|
-
|
|
102
|
-
describe('checkpointStore', () => {
|
|
103
|
-
test('writeCheckpoint writes a manifest and per-part files, including per-request/api files on disk', () => {
|
|
104
|
-
const snapshot = buildSnapshot();
|
|
105
|
-
const { dir, parts } = writeCheckpoint({ name: 'cp-roundtrip', snapshot, notes: 'a note' });
|
|
106
|
-
|
|
107
|
-
expect(dir).toBe(path.join(getStateCheckpointsRoot(), 'cp-roundtrip'));
|
|
108
|
-
expect(parts.sort()).toEqual(
|
|
109
|
-
[
|
|
110
|
-
'checkpoint.json',
|
|
111
|
-
'state.json',
|
|
112
|
-
'urlQuery.json',
|
|
113
|
-
'pathParams.json',
|
|
114
|
-
'inputs.json',
|
|
115
|
-
'user.json',
|
|
116
|
-
'global.json',
|
|
117
|
-
'requests/req1.json',
|
|
118
|
-
'api/ep1.json',
|
|
119
|
-
].sort()
|
|
120
|
-
);
|
|
121
|
-
expect(fs.existsSync(path.join(dir, 'requests', 'req1.json'))).toBe(true);
|
|
122
|
-
expect(fs.existsSync(path.join(dir, 'api', 'ep1.json'))).toBe(true);
|
|
123
|
-
|
|
124
|
-
const result = readCheckpoint({ name: 'cp-roundtrip' });
|
|
125
|
-
expect(result.checkpoint.pageId).toBe('home');
|
|
126
|
-
expect(result.checkpoint.url).toBe('http://localhost:3111/home');
|
|
127
|
-
expect(result.checkpoint.notes).toBe('a note');
|
|
128
|
-
expect(typeof result.checkpoint.capturedAt).toBe('string');
|
|
129
|
-
expect(result.state).toEqual({ count: 1 });
|
|
130
|
-
expect(result.urlQuery).toBe('?a=1');
|
|
131
|
-
expect(result.pathParams).toEqual({});
|
|
132
|
-
expect(result.input).toEqual({ fromInput: true });
|
|
133
|
-
expect(result.user).toEqual({ id: 'u1' });
|
|
134
|
-
expect(result.global).toEqual({ g: 1 });
|
|
135
|
-
expect(result.requests).toEqual({
|
|
136
|
-
req1: { payload: { a: 1 }, response: { ok: true }, error: null, responseTime: 12 },
|
|
137
|
-
});
|
|
138
|
-
expect(result.api).toEqual({
|
|
139
|
-
ep1: { payload: {}, response: { v: 1 }, error: undefined, responseTime: undefined },
|
|
140
|
-
});
|
|
141
|
-
});
|
|
142
|
-
|
|
143
|
-
test('writeCheckpoint throws an actionable error for an invalid checkpoint name', () => {
|
|
144
|
-
expect(() => writeCheckpoint({ name: 'bad name!', snapshot: buildSnapshot() })).toThrow(
|
|
145
|
-
/invalid/
|
|
146
|
-
);
|
|
147
|
-
});
|
|
148
|
-
|
|
149
|
-
test('writeCheckpoint refuses to overwrite an existing checkpoint unless overwrite: true', () => {
|
|
150
|
-
writeCheckpoint({ name: 'cp-overwrite', snapshot: buildSnapshot() });
|
|
151
|
-
|
|
152
|
-
expect(() => writeCheckpoint({ name: 'cp-overwrite', snapshot: buildSnapshot() })).toThrow(
|
|
153
|
-
'Checkpoint "cp-overwrite" already exists. Pass overwrite: true to replace it.'
|
|
154
|
-
);
|
|
155
|
-
|
|
156
|
-
const fewerRequests = buildSnapshot({ requests: {}, apiResponses: {} });
|
|
157
|
-
const { dir } = writeCheckpoint({
|
|
158
|
-
name: 'cp-overwrite',
|
|
159
|
-
snapshot: fewerRequests,
|
|
160
|
-
overwrite: true,
|
|
161
|
-
});
|
|
162
|
-
// Overwriting replaces the whole folder, so stale per-request files from
|
|
163
|
-
// the first write must not linger.
|
|
164
|
-
expect(fs.existsSync(path.join(dir, 'requests', 'req1.json'))).toBe(false);
|
|
165
|
-
});
|
|
166
|
-
|
|
167
|
-
test('readCheckpoint throws when the checkpoint does not exist', () => {
|
|
168
|
-
expect(() => readCheckpoint({ name: 'does-not-exist' })).toThrow(
|
|
169
|
-
'Checkpoint "does-not-exist" not found.'
|
|
170
|
-
);
|
|
171
|
-
});
|
|
172
|
-
|
|
173
|
-
test('readCheckpoint is tolerant of missing parts', () => {
|
|
174
|
-
const dir = path.join(getStateCheckpointsRoot(), 'cp-partial');
|
|
175
|
-
fs.mkdirSync(dir, { recursive: true });
|
|
176
|
-
fs.writeFileSync(path.join(dir, 'checkpoint.json'), JSON.stringify({ pageId: 'home' }));
|
|
177
|
-
// Deliberately no state.json/urlQuery.json/etc, no requests/ dir.
|
|
178
|
-
|
|
179
|
-
const result = readCheckpoint({ name: 'cp-partial' });
|
|
180
|
-
expect(result.state).toEqual({});
|
|
181
|
-
expect(result.urlQuery).toBe('');
|
|
182
|
-
expect(result.pathParams).toEqual({});
|
|
183
|
-
expect(result.input).toEqual({});
|
|
184
|
-
expect(result.user).toBe(null);
|
|
185
|
-
expect(result.global).toEqual({});
|
|
186
|
-
expect(result.requests).toEqual({});
|
|
187
|
-
expect(result.api).toEqual({});
|
|
188
|
-
});
|
|
189
|
-
|
|
190
|
-
test('checkpointExists reflects whether a checkpoint folder exists', () => {
|
|
191
|
-
writeCheckpoint({ name: 'cp-exists', snapshot: buildSnapshot() });
|
|
192
|
-
expect(checkpointExists({ name: 'cp-exists' })).toBe(true);
|
|
193
|
-
expect(checkpointExists({ name: 'cp-does-not-exist' })).toBe(false);
|
|
194
|
-
});
|
|
195
|
-
|
|
196
|
-
test('listStateCheckpoints lists checkpoints with requestCount, most recent first', async () => {
|
|
197
|
-
writeCheckpoint({ name: 'cp-list-a', snapshot: buildSnapshot() });
|
|
198
|
-
await new Promise((resolve) => setTimeout(resolve, 5));
|
|
199
|
-
writeCheckpoint({
|
|
200
|
-
name: 'cp-list-b',
|
|
201
|
-
snapshot: buildSnapshot({ requests: {}, apiResponses: {} }),
|
|
202
|
-
});
|
|
203
|
-
|
|
204
|
-
const checkpoints = listStateCheckpoints();
|
|
205
|
-
const a = checkpoints.find((checkpoint) => checkpoint.name === 'cp-list-a');
|
|
206
|
-
const b = checkpoints.find((checkpoint) => checkpoint.name === 'cp-list-b');
|
|
207
|
-
expect(a.requestCount).toBe(1);
|
|
208
|
-
expect(b.requestCount).toBe(0);
|
|
209
|
-
expect(checkpoints.indexOf(b)).toBeLessThan(checkpoints.indexOf(a));
|
|
210
|
-
});
|
|
211
|
-
});
|
|
212
|
-
|
|
213
|
-
describe('devMockRegistry', () => {
|
|
214
|
-
test('loadMocks + getMock replay a recorded response by pageId/requestId', () => {
|
|
215
|
-
loadMocks({ pageId: 'home', mocks: { req1: { response: { ok: true }, error: null } } });
|
|
216
|
-
expect(getMock({ pageId: 'home', requestId: 'req1' })).toEqual({
|
|
217
|
-
pageId: 'home',
|
|
218
|
-
requestId: 'req1',
|
|
219
|
-
response: { ok: true },
|
|
220
|
-
error: null,
|
|
221
|
-
});
|
|
222
|
-
expect(getMock({ pageId: 'other', requestId: 'req1' })).toBeUndefined();
|
|
223
|
-
});
|
|
224
|
-
|
|
225
|
-
test('listMocks reports whether each entry has a response or an error', () => {
|
|
226
|
-
loadMocks({
|
|
227
|
-
pageId: 'home',
|
|
228
|
-
mocks: {
|
|
229
|
-
req1: { response: { ok: true } },
|
|
230
|
-
req2: { error: new Error('boom') },
|
|
231
|
-
},
|
|
232
|
-
});
|
|
233
|
-
const mocks = listMocks().sort((m1, m2) => m1.requestId.localeCompare(m2.requestId));
|
|
234
|
-
expect(mocks).toEqual([
|
|
235
|
-
{ pageId: 'home', requestId: 'req1', hasResponse: true, hasError: false },
|
|
236
|
-
{ pageId: 'home', requestId: 'req2', hasResponse: false, hasError: true },
|
|
237
|
-
]);
|
|
238
|
-
});
|
|
239
|
-
|
|
240
|
-
test('clearMocks removes all recorded mocks', () => {
|
|
241
|
-
loadMocks({ pageId: 'home', mocks: { req1: { response: { ok: true } } } });
|
|
242
|
-
clearMocks();
|
|
243
|
-
expect(listMocks()).toEqual([]);
|
|
244
|
-
expect(getMock({ pageId: 'home', requestId: 'req1' })).toBeUndefined();
|
|
245
|
-
});
|
|
246
|
-
});
|
|
247
|
-
|
|
248
|
-
describe('checkpointToMocks', () => {
|
|
249
|
-
test('converts a checkpoint into the loadStaticMocks input shape', () => {
|
|
250
|
-
writeCheckpoint({
|
|
251
|
-
name: 'cp-to-mocks',
|
|
252
|
-
snapshot: buildSnapshot({
|
|
253
|
-
requests: {
|
|
254
|
-
req1: [{ response: { ok: true } }],
|
|
255
|
-
req2: [{ error: new Error('request failed') }],
|
|
256
|
-
},
|
|
257
|
-
apiResponses: {
|
|
258
|
-
ep1: [{ response: { v: 1 } }],
|
|
259
|
-
},
|
|
260
|
-
}),
|
|
261
|
-
});
|
|
262
|
-
|
|
263
|
-
const result = checkpointToMocks({ name: 'cp-to-mocks' });
|
|
264
|
-
|
|
265
|
-
expect(result.requests.sort((a, b) => a.requestId.localeCompare(b.requestId))).toEqual([
|
|
266
|
-
{ requestId: 'req1', pageId: 'home', response: { ok: true } },
|
|
267
|
-
{ requestId: 'req2', pageId: 'home', error: 'request failed' },
|
|
268
|
-
]);
|
|
269
|
-
expect(result.api).toEqual([{ endpointId: 'ep1', response: { v: 1 } }]);
|
|
270
|
-
expect(result.yaml).toEqual(expect.any(String));
|
|
271
|
-
expect(result.yaml).toContain('requestId: req1');
|
|
272
|
-
expect(result.yaml).toContain('endpointId: ep1');
|
|
273
|
-
});
|
|
274
|
-
|
|
275
|
-
test('returns an error when the checkpoint does not exist', () => {
|
|
276
|
-
expect(checkpointToMocks({ name: 'does-not-exist' })).toEqual({
|
|
277
|
-
error: 'Checkpoint "does-not-exist" not found.',
|
|
278
|
-
});
|
|
279
|
-
});
|
|
280
|
-
});
|
|
281
|
-
|
|
282
|
-
describe('snapshotState', () => {
|
|
283
|
-
test('snapshots inspectState output into a checkpoint and returns its location', async () => {
|
|
284
|
-
mockInspectState.mockResolvedValue({
|
|
285
|
-
pageId: 'home',
|
|
286
|
-
state: { count: 2 },
|
|
287
|
-
requests: {},
|
|
288
|
-
urlQuery: '',
|
|
289
|
-
source: 'headless',
|
|
290
|
-
});
|
|
291
|
-
|
|
292
|
-
const result = await snapshotState({
|
|
293
|
-
origin: 'http://localhost:3111',
|
|
294
|
-
pageId: 'home',
|
|
295
|
-
name: 'cp-snapshot',
|
|
296
|
-
});
|
|
297
|
-
|
|
298
|
-
expect(result.error).toBeUndefined();
|
|
299
|
-
expect(result.name).toBe('cp-snapshot');
|
|
300
|
-
expect(result.source).toBe('headless');
|
|
301
|
-
expect(result.parts).toContain('state.json');
|
|
302
|
-
|
|
303
|
-
const stored = readCheckpoint({ name: 'cp-snapshot' });
|
|
304
|
-
expect(stored.state).toEqual({ count: 2 });
|
|
305
|
-
expect(stored.checkpoint.url).toBe('http://localhost:3111/home');
|
|
306
|
-
});
|
|
307
|
-
|
|
308
|
-
test('keeps the pathParams of the instance it snapshots', async () => {
|
|
309
|
-
mockInspectState.mockResolvedValue({
|
|
310
|
-
pageId: 'ticket',
|
|
311
|
-
pathParams: { space: 's', ticket_id: '1' },
|
|
312
|
-
state: { subject: 'One' },
|
|
313
|
-
requests: {},
|
|
314
|
-
urlQuery: '?tab=notes',
|
|
315
|
-
source: 'tab',
|
|
316
|
-
});
|
|
317
|
-
|
|
318
|
-
const result = await snapshotState({
|
|
319
|
-
origin: 'http://localhost:3111',
|
|
320
|
-
pageId: 'ticket',
|
|
321
|
-
name: 'cp-snapshot-instance',
|
|
322
|
-
});
|
|
323
|
-
|
|
324
|
-
expect(result.error).toBeUndefined();
|
|
325
|
-
expect(result.parts).toContain('pathParams.json');
|
|
326
|
-
expect(mockInspectState).toHaveBeenCalledWith(
|
|
327
|
-
expect.objectContaining({ pageId: 'ticket', pathParams: undefined })
|
|
328
|
-
);
|
|
329
|
-
const stored = readCheckpoint({ name: 'cp-snapshot-instance' });
|
|
330
|
-
expect(stored.pathParams).toEqual({ space: 's', ticket_id: '1' });
|
|
331
|
-
expect(stored.checkpoint.url).toBe('http://localhost:3111/tickets/s/1?tab=notes');
|
|
332
|
-
});
|
|
333
|
-
|
|
334
|
-
test('returns the inspectState error instead of writing a checkpoint', async () => {
|
|
335
|
-
mockInspectState.mockResolvedValue({ error: 'No live context for page "home".' });
|
|
336
|
-
|
|
337
|
-
const result = await snapshotState({
|
|
338
|
-
origin: 'http://localhost:3111',
|
|
339
|
-
pageId: 'home',
|
|
340
|
-
name: 'cp-snapshot-error',
|
|
341
|
-
});
|
|
342
|
-
|
|
343
|
-
expect(result).toEqual({ error: 'No live context for page "home".' });
|
|
344
|
-
expect(checkpointExists({ name: 'cp-snapshot-error' })).toBe(false);
|
|
345
|
-
});
|
|
346
|
-
|
|
347
|
-
test('validates required fields before calling inspectState', async () => {
|
|
348
|
-
const result = await snapshotState({ origin: 'http://localhost:3111', name: 'cp-x' });
|
|
349
|
-
expect(result.error).toMatch(/requires a "pageId" string/);
|
|
350
|
-
expect(mockInspectState).not.toHaveBeenCalled();
|
|
351
|
-
});
|
|
352
|
-
});
|
|
353
|
-
|
|
354
|
-
describe('loadState', () => {
|
|
355
|
-
test('registry-only mode loads recorded requests into devMockRegistry and returns a bootstrap URL', async () => {
|
|
356
|
-
writeCheckpoint({
|
|
357
|
-
name: 'cp-load-registry',
|
|
358
|
-
snapshot: buildSnapshot({ urlQuery: '?a=1' }),
|
|
359
|
-
});
|
|
360
|
-
|
|
361
|
-
const result = await loadState({
|
|
362
|
-
origin: 'http://localhost:3111',
|
|
363
|
-
name: 'cp-load-registry',
|
|
364
|
-
mode: 'registry-only',
|
|
365
|
-
});
|
|
366
|
-
|
|
367
|
-
expect(result.error).toBeUndefined();
|
|
368
|
-
expect(result.url).toBe('http://localhost:3111/home?a=1&_checkpoint=cp-load-registry');
|
|
369
|
-
expect(result.instructions).toMatch(/Open this URL/);
|
|
370
|
-
expect(getMock({ pageId: 'home', requestId: 'req1' })).toEqual({
|
|
371
|
-
pageId: 'home',
|
|
372
|
-
requestId: 'req1',
|
|
373
|
-
response: { ok: true },
|
|
374
|
-
error: null,
|
|
375
|
-
});
|
|
376
|
-
});
|
|
377
|
-
|
|
378
|
-
test('registry-only mode opens the page instance the checkpoint names', async () => {
|
|
379
|
-
writeCheckpoint({
|
|
380
|
-
name: 'cp-load-instance',
|
|
381
|
-
snapshot: buildSnapshot({
|
|
382
|
-
pageId: 'ticket',
|
|
383
|
-
pathParams: { space: 's', ticket_id: '1' },
|
|
384
|
-
urlQuery: '?tab=notes',
|
|
385
|
-
}),
|
|
386
|
-
});
|
|
387
|
-
|
|
388
|
-
const result = await loadState({
|
|
389
|
-
origin: 'http://localhost:3111',
|
|
390
|
-
name: 'cp-load-instance',
|
|
391
|
-
mode: 'registry-only',
|
|
392
|
-
});
|
|
393
|
-
|
|
394
|
-
expect(result.error).toBeUndefined();
|
|
395
|
-
expect(result.url).toBe(
|
|
396
|
-
'http://localhost:3111/tickets/s/1?tab=notes&_checkpoint=cp-load-instance'
|
|
397
|
-
);
|
|
398
|
-
});
|
|
399
|
-
|
|
400
|
-
test('refuses a checkpoint whose pathParams miss a placeholder of its page', async () => {
|
|
401
|
-
writeCheckpoint({
|
|
402
|
-
name: 'cp-load-missing',
|
|
403
|
-
snapshot: buildSnapshot({ pageId: 'ticket', pathParams: { space: 's' }, urlQuery: '' }),
|
|
404
|
-
});
|
|
405
|
-
|
|
406
|
-
const result = await loadState({
|
|
407
|
-
origin: 'http://localhost:3111',
|
|
408
|
-
name: 'cp-load-missing',
|
|
409
|
-
mode: 'registry-only',
|
|
410
|
-
});
|
|
411
|
-
|
|
412
|
-
expect(result.error).toMatch(
|
|
413
|
-
/Checkpoint "cp-load-missing" cannot open its page: .*placeholder "ticket_id"/
|
|
414
|
-
);
|
|
415
|
-
});
|
|
416
|
-
|
|
417
|
-
test('returns an error when the checkpoint does not exist', async () => {
|
|
418
|
-
const result = await loadState({
|
|
419
|
-
origin: 'http://localhost:3111',
|
|
420
|
-
name: 'does-not-exist',
|
|
421
|
-
mode: 'registry-only',
|
|
422
|
-
});
|
|
423
|
-
expect(result).toEqual({ error: 'Checkpoint "does-not-exist" not found.' });
|
|
424
|
-
});
|
|
425
|
-
|
|
426
|
-
test('rejects a user in registry-only mode as invalid input', async () => {
|
|
427
|
-
writeCheckpoint({
|
|
428
|
-
name: 'cp-load-registry-user',
|
|
429
|
-
snapshot: buildSnapshot({ urlQuery: '' }),
|
|
430
|
-
});
|
|
431
|
-
|
|
432
|
-
const result = await loadState({
|
|
433
|
-
origin: 'http://localhost:3111',
|
|
434
|
-
name: 'cp-load-registry-user',
|
|
435
|
-
mode: 'registry-only',
|
|
436
|
-
user: { roles: ['admin'] },
|
|
437
|
-
});
|
|
438
|
-
|
|
439
|
-
expect(result.invalidInput).toBe(true);
|
|
440
|
-
expect(result.error).toMatch(/cannot apply "user" in "registry-only" mode/);
|
|
441
|
-
expect(result.url).toBeUndefined();
|
|
442
|
-
});
|
|
443
|
-
});
|
|
@@ -1,47 +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 { get, type } from '@lowdefy/helpers';
|
|
18
|
-
|
|
19
|
-
// Only these kinds are loaded by the server process and cached in its ESM
|
|
20
|
-
// module cache. blocks, actions and operators.client are bundled by Vite,
|
|
21
|
-
// which rebuilds and hot-reloads them itself.
|
|
22
|
-
const serverSideKinds = [
|
|
23
|
-
'agents',
|
|
24
|
-
'connections',
|
|
25
|
-
'notifications',
|
|
26
|
-
'operators.server',
|
|
27
|
-
'requests',
|
|
28
|
-
'websockets',
|
|
29
|
-
'auth.adapters',
|
|
30
|
-
'auth.providers',
|
|
31
|
-
'auth.strategies',
|
|
32
|
-
];
|
|
33
|
-
|
|
34
|
-
function listServerSidePackages({ customTypesMap }) {
|
|
35
|
-
const packages = new Set();
|
|
36
|
-
for (const kind of serverSideKinds) {
|
|
37
|
-
const store = get(customTypesMap, kind, { default: {} });
|
|
38
|
-
for (const definition of Object.values(store ?? {})) {
|
|
39
|
-
if (type.isString(definition?.package)) {
|
|
40
|
-
packages.add(definition.package);
|
|
41
|
-
}
|
|
42
|
-
}
|
|
43
|
-
}
|
|
44
|
-
return packages;
|
|
45
|
-
}
|
|
46
|
-
|
|
47
|
-
export default listServerSidePackages;
|
|
@@ -1,38 +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 listServerSidePackages from './listServerSidePackages.mjs';
|
|
18
|
-
|
|
19
|
-
test('listServerSidePackages lists packages with server-side types once each, not client-only ones', () => {
|
|
20
|
-
const customTypesMap = {
|
|
21
|
-
actions: { Do: { package: '@app/ui-plugin', version: '1.0.0' } },
|
|
22
|
-
auth: { providers: { Corp: { package: '@app/auth-plugin', version: '1.0.0' } } },
|
|
23
|
-
blocks: { Fancy: { package: '@app/mixed-plugin', version: '1.0.0' } },
|
|
24
|
-
operators: {
|
|
25
|
-
client: { _ui: { package: '@app/ui-plugin', version: '1.0.0' } },
|
|
26
|
-
server: { _srv: { package: '@app/mixed-plugin', version: '1.0.0' } },
|
|
27
|
-
},
|
|
28
|
-
requests: {
|
|
29
|
-
Find: { package: '@app/mixed-plugin', version: '1.0.0' },
|
|
30
|
-
Insert: { package: '@app/mixed-plugin', version: '1.0.0' },
|
|
31
|
-
},
|
|
32
|
-
};
|
|
33
|
-
|
|
34
|
-
expect([...listServerSidePackages({ customTypesMap })].sort()).toEqual([
|
|
35
|
-
'@app/auth-plugin',
|
|
36
|
-
'@app/mixed-plugin',
|
|
37
|
-
]);
|
|
38
|
-
});
|
|
@@ -1,28 +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 createConfigCheckpoint from '../../../lib/docs/createConfigCheckpoint.js';
|
|
18
|
-
|
|
19
|
-
// Lets an agent snapshot the config directory before an experimental change,
|
|
20
|
-
// so it can revert cleanly with POST /lowdefy-docs/checkpoints/revert if the
|
|
21
|
-
// change doesn't work out.
|
|
22
|
-
async function docsCheckpointsCreateHandler(c) {
|
|
23
|
-
const body = await c.req.json().catch(() => ({}));
|
|
24
|
-
const result = createConfigCheckpoint({ label: body.label });
|
|
25
|
-
return c.json(result);
|
|
26
|
-
}
|
|
27
|
-
|
|
28
|
-
export default docsCheckpointsCreateHandler;
|
|
@@ -1,70 +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 evalOperator from '../../../lib/docs/evalOperator.js';
|
|
18
|
-
import parsePathParamsParam from './parsePathParamsParam.js';
|
|
19
|
-
import parseUserParam from './parseUserParam.js';
|
|
20
|
-
|
|
21
|
-
async function docsEvalOperatorHandler(c) {
|
|
22
|
-
const body = await c.req.json().catch(() => ({}));
|
|
23
|
-
const { pageId, source } = body;
|
|
24
|
-
// "operator" is accepted as an alias for "expression" — agents commonly
|
|
25
|
-
// guess it as the body key for this endpoint.
|
|
26
|
-
const expression = body.expression ?? body.operator;
|
|
27
|
-
if (expression === undefined) {
|
|
28
|
-
return c.json(
|
|
29
|
-
{
|
|
30
|
-
error:
|
|
31
|
-
'POST /lowdefy-docs/eval-operator requires an "expression" in the JSON body — the operator expression to evaluate, e.g. {"pageId": "home", "expression": {"_state": "key"}}.',
|
|
32
|
-
},
|
|
33
|
-
400
|
|
34
|
-
);
|
|
35
|
-
}
|
|
36
|
-
// Derived from the incoming request rather than a config value — this is
|
|
37
|
-
// the origin an agent can actually reach the dev server on (host/port it
|
|
38
|
-
// just connected to), regardless of how the server is bound.
|
|
39
|
-
const origin = new URL(c.req.url).origin;
|
|
40
|
-
|
|
41
|
-
const { user, error: userError } = parseUserParam({ value: body.user });
|
|
42
|
-
if (userError) {
|
|
43
|
-
return c.json({ error: userError }, 400);
|
|
44
|
-
}
|
|
45
|
-
|
|
46
|
-
const { pathParams, error: pathParamsError } = parsePathParamsParam({ value: body.pathParams });
|
|
47
|
-
if (pathParamsError) {
|
|
48
|
-
return c.json({ error: pathParamsError }, 400);
|
|
49
|
-
}
|
|
50
|
-
|
|
51
|
-
const result = await evalOperator({
|
|
52
|
-
origin,
|
|
53
|
-
pageId,
|
|
54
|
-
pathParams,
|
|
55
|
-
expression,
|
|
56
|
-
source,
|
|
57
|
-
user,
|
|
58
|
-
data: body.data,
|
|
59
|
-
});
|
|
60
|
-
if (result.error) {
|
|
61
|
-
// A contradictory call (`user` with `source: 'tab'`) is the caller's
|
|
62
|
-
// mistake, not a failed render — 502 would read as "the renderer broke" and
|
|
63
|
-
// invite a pointless retry of the same request.
|
|
64
|
-
const status = result.invalidInput ? 400 : 502;
|
|
65
|
-
return c.json({ error: result.error, source: result.source }, status);
|
|
66
|
-
}
|
|
67
|
-
return c.json(result);
|
|
68
|
-
}
|
|
69
|
-
|
|
70
|
-
export default docsEvalOperatorHandler;
|
|
@@ -1,59 +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 inspectState from '../../../lib/docs/inspectState.js';
|
|
18
|
-
import parsePathParamsParam from './parsePathParamsParam.js';
|
|
19
|
-
import parseUserParam from './parseUserParam.js';
|
|
20
|
-
|
|
21
|
-
async function docsInspectStateHandler(c) {
|
|
22
|
-
const pageId = c.req.param('pageId');
|
|
23
|
-
const source = c.req.query('source');
|
|
24
|
-
// Derived from the incoming request rather than a config value — this is
|
|
25
|
-
// the origin an agent can actually reach the dev server on (host/port it
|
|
26
|
-
// just connected to), regardless of how the server is bound.
|
|
27
|
-
const origin = new URL(c.req.url).origin;
|
|
28
|
-
|
|
29
|
-
const { user, error: userError } = parseUserParam({ value: c.req.query('user') });
|
|
30
|
-
if (userError) {
|
|
31
|
-
return c.json({ error: userError }, 400);
|
|
32
|
-
}
|
|
33
|
-
|
|
34
|
-
const { pathParams, error: pathParamsError } = parsePathParamsParam({
|
|
35
|
-
value: c.req.query('pathParams'),
|
|
36
|
-
});
|
|
37
|
-
if (pathParamsError) {
|
|
38
|
-
return c.json({ error: pathParamsError }, 400);
|
|
39
|
-
}
|
|
40
|
-
|
|
41
|
-
const result = await inspectState({
|
|
42
|
-
origin,
|
|
43
|
-
pageId,
|
|
44
|
-
pathParams,
|
|
45
|
-
source,
|
|
46
|
-
user,
|
|
47
|
-
data: c.req.query('data'),
|
|
48
|
-
});
|
|
49
|
-
if (result.error) {
|
|
50
|
-
// A contradictory call (`user` with `source=tab`) is the caller's mistake,
|
|
51
|
-
// not a failed render — 502 would read as "the renderer broke" and invite a
|
|
52
|
-
// pointless retry of the same request.
|
|
53
|
-
const status = result.invalidInput ? 400 : 502;
|
|
54
|
-
return c.json({ error: result.error, source: result.source }, status);
|
|
55
|
-
}
|
|
56
|
-
return c.json(result);
|
|
57
|
-
}
|
|
58
|
-
|
|
59
|
-
export default docsInspectStateHandler;
|