@lowdefy/server-dev 7.1.0 → 7.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/client/Inspector.jsx +24 -75
- package/client/Page.jsx +8 -0
- package/client/Routing.jsx +0 -2
- package/client/clientBuildImports.test.mjs +5 -3
- package/client/devStreamConnections.test.mjs +1 -0
- package/client/journeyObserver/startJourneyObserver.test.mjs +11 -11
- package/client/openInEditor/OpenInEditorListener.jsx +36 -29
- package/client/openInEditor/OpenInEditorListener.test.mjs +116 -0
- package/client/{feedback → openInEditor}/elementInspect.js +9 -44
- package/client/openInEditor/findBlockLocation.js +2 -2
- package/client/openInEditor/openInEditorStyles.js +56 -0
- package/client/recorder/createPairingBuffer.test.mjs +27 -9
- package/client/recorder/createRecorder.js +11 -7
- package/client/recorder/createRecorder.test.mjs +9 -9
- package/client/recorder/isPasswordElement.js +41 -0
- package/client/recorder/keyChord.test.mjs +1 -0
- package/{client/recorder/toJsonSafe.js → lib/build/mobileConfig.js} +9 -12
- package/lib/client/auth/AuthConfigured.jsx +75 -48
- package/lib/client/auth/authNotConfiguredParity.test.mjs +1 -0
- package/lib/client/auth/authTemplateSync.test.mjs +1 -0
- package/lib/client/auth/betterAuthSessionContract.test.mjs +2 -1
- package/lib/client/auth/sessionCaller.js +56 -0
- package/lib/client/auth/sessionCaller.test.mjs +78 -0
- package/lib/client/getPagePath.test.mjs +1 -0
- package/lib/client/utils/formatErrorsForCopy.test.mjs +1 -0
- package/lib/client/utils/getErrorBarColor.test.mjs +1 -0
- package/lib/client/utils/usePageConfig.test.mjs +15 -15
- package/lib/configTree/buildConfigTree.test.mjs +6 -8
- package/lib/configTree/collectConfigText.test.mjs +1 -0
- package/lib/configTree/runConfigTreeBuild.mjs +2 -1
- package/lib/configTree/runConfigTreeBuild.skipPluginChecks.test.mjs +11 -11
- package/lib/configTree/runConfigTreeBuild.test.mjs +2 -2
- package/lib/docs/addNestedEndpoints.test.mjs +1 -0
- package/lib/docs/checkAgentFiles.test.mjs +1 -0
- package/lib/docs/checkStepReferences.test.mjs +3 -3
- package/lib/docs/clientErrorStore.test.mjs +4 -4
- package/lib/docs/createBrowserLifecycle.test.mjs +40 -24
- package/lib/docs/createDocsMcpServer.js +195 -138
- package/lib/docs/createDocsMcpServer.test.mjs +331 -25
- package/lib/docs/createDocsMcpServerRunJourney.test.mjs +5 -5
- package/lib/docs/createJourneyActors.chromium.test.mjs +3 -3
- package/lib/docs/createJourneyActors.test.mjs +4 -4
- package/lib/docs/dataSets/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 +87 -135
- package/lib/docs/device/buildDeviceCommand.js +103 -0
- package/lib/docs/device/buildDeviceCommand.test.mjs +142 -0
- package/lib/docs/device/captureDevice.js +85 -0
- package/lib/docs/device/checkShownPage.js +56 -0
- package/lib/docs/device/createFakePhoneTab.mjs +77 -0
- package/lib/docs/device/deviceAction.js +74 -0
- package/lib/docs/device/deviceTools.test.mjs +604 -0
- package/lib/docs/device/findDeviceTab.js +50 -0
- package/lib/docs/device/findDeviceTarget.js +73 -0
- package/lib/docs/device/injectDevice.js +160 -0
- package/lib/docs/device/listDevices.js +100 -0
- package/lib/docs/device/listDevices.test.mjs +105 -0
- package/lib/docs/device/runDeviceJourney.js +68 -0
- package/lib/docs/device/runDeviceSteps.js +164 -0
- package/lib/docs/device/screenshotDevice.js +68 -0
- package/lib/docs/device/sendDeviceStep.js +52 -0
- package/lib/docs/device/startDevice.js +150 -0
- package/lib/docs/docs.test.mjs +44 -28
- package/lib/docs/docsIndex.test.mjs +1 -0
- package/lib/docs/findConfig.js +3 -4
- package/lib/docs/findPageBlock.js +35 -0
- package/lib/docs/findPageBlock.test.mjs +45 -0
- package/lib/docs/fitResponse.js +18 -17
- package/lib/docs/fitResponse.test.mjs +18 -0
- package/lib/docs/getBrowser.js +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.test.mjs +1 -0
- package/lib/docs/isPageReady.test.mjs +1 -0
- package/lib/docs/journeyMutantCookie.chromium.test.mjs +3 -3
- package/lib/docs/journeyRunRecording.test.mjs +1 -0
- package/lib/docs/keepEventStreamAlive.test.mjs +1 -0
- package/lib/docs/launchBrowser.test.mjs +8 -8
- package/lib/docs/listTypes.js +58 -8
- package/lib/docs/loadFrameworkHazards.test.mjs +1 -0
- package/lib/docs/matchJourneyRoute.test.mjs +1 -0
- package/lib/docs/observe/createJourneyAppErrors.test.mjs +3 -3
- package/lib/docs/observe/evaluateInvariants.test.mjs +1 -0
- package/lib/docs/observe/hasNoEffect.test.mjs +1 -0
- package/lib/docs/observe/withAppErrors.test.mjs +1 -0
- package/lib/docs/openJourneyEmail.test.mjs +6 -6
- package/lib/docs/pageBuildStatus.test.mjs +6 -6
- package/lib/docs/pollTab.js +100 -0
- package/lib/docs/pollTab.test.mjs +64 -0
- package/lib/docs/rails/authEngineActions.test.mjs +1 -0
- package/lib/docs/rails/authEngineMethods.test.mjs +2 -1
- package/lib/docs/rails/checkAuthActionsRan.test.mjs +5 -5
- package/lib/docs/rails/createDataSetRails.test.mjs +1 -0
- package/lib/docs/rails/findExternalBlocks.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/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 +158 -27
- package/manager/processes/startProxy.pairing.test.mjs +204 -0
- package/manager/processes/startProxy.test.mjs +127 -2
- package/manager/processes/startServer.mjs +5 -7
- package/manager/processes/startServer.test.mjs +10 -9
- package/manager/processes/syncServer.mjs +31 -4
- package/manager/processes/syncServer.test.mjs +71 -6
- package/manager/processes/waitForDevServer.test.mjs +21 -6
- package/manager/run.mjs +32 -8
- package/manager/utils/BatchChanges.mjs +1 -1
- package/manager/utils/BatchChanges.test.mjs +4 -4
- package/manager/utils/acquireDevInstance.test.mjs +1 -0
- package/manager/utils/checkPairing.mjs +45 -0
- package/manager/utils/checkPairing.test.mjs +53 -0
- package/manager/utils/createBuildActivity.mjs +5 -1
- package/manager/utils/createBuildActivity.test.mjs +2 -2
- package/manager/utils/createChangeSignal.test.mjs +5 -5
- package/manager/utils/createCustomPluginMessagesMap.mjs +8 -3
- package/manager/utils/createCustomPluginTypesMap.mjs +48 -12
- package/manager/utils/createCustomPluginTypesMap.test.mjs +181 -19
- package/manager/utils/createDotPathIgnore.test.mjs +1 -0
- package/manager/utils/createGlobIgnore.mjs +45 -0
- package/manager/utils/createGlobIgnore.test.mjs +58 -0
- package/manager/utils/createGlobWatchPaths.mjs +75 -0
- package/manager/utils/createGlobWatchPaths.test.mjs +67 -0
- package/manager/utils/createIdleGc.test.mjs +31 -15
- package/{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 +50 -49
- package/package.original.json +50 -49
- package/src/app.js +83 -85
- package/src/html/renderDevPage.test.mjs +1 -0
- package/src/lib/getPathSegments.js +16 -1
- package/src/{routes/docs/checkpointsList.js → lib/getRequestSurface.js} +6 -4
- package/src/lib/isTabAnswer.js +32 -0
- package/src/lib/isTabChannelCaller.js +35 -0
- package/src/middleware/apiContext.js +4 -2
- package/src/middleware/createSameOriginGuard.test.mjs +1 -0
- package/src/middleware/errorHandler.js +33 -45
- package/src/middleware/errorHandler.test.mjs +10 -10
- package/src/middleware/isRebindingSafeHost.test.mjs +1 -0
- package/src/middleware/localDevToolsOnly.js +13 -1
- package/src/middleware/localDevToolsOnly.test.mjs +36 -2
- package/src/middleware/noStore.test.mjs +1 -0
- package/src/middleware/staleFlag.test.mjs +1 -0
- package/src/middleware/stampCaller.test.mjs +1 -0
- package/src/routes/agentBearer.test.mjs +183 -0
- package/src/routes/auth.test.mjs +10 -10
- package/src/routes/clientError.js +21 -4
- package/src/routes/clientError.test.mjs +127 -0
- package/src/routes/devInspect.js +6 -51
- package/src/routes/devInspect.test.mjs +128 -3
- package/src/routes/devRecording.js +6 -17
- package/src/routes/devRecording.test.mjs +54 -3
- package/src/routes/docs/buildStatus.test.mjs +6 -6
- package/src/routes/docs/events.test.mjs +4 -4
- package/src/routes/docs/find.js +3 -3
- package/src/routes/docs/journey.test.mjs +8 -8
- package/src/routes/docs/journeyRefusals.test.mjs +9 -9
- package/src/routes/docs/loadDocsRoutes.js +70 -0
- package/src/routes/docs/loadDocsRoutes.test.mjs +110 -0
- package/src/routes/docs/mcp.test.mjs +5 -5
- package/src/routes/docs/mutants.js +7 -0
- package/src/routes/docs/mutants.test.mjs +20 -6
- package/src/routes/docs/parsePathParamsParam.test.mjs +1 -0
- package/src/routes/docs/parseUserParam.test.mjs +1 -0
- package/src/routes/docs/restart.test.mjs +1 -0
- package/src/routes/endpoints.js +24 -0
- package/src/routes/endpointsLink.test.mjs +111 -0
- package/src/routes/endpointsTextAnswer.test.mjs +8 -8
- package/src/routes/jitPage.js +13 -1
- package/src/routes/jitPage.test.mjs +36 -11
- package/src/routes/mcp.js +6 -0
- package/src/routes/mcp.test.mjs +23 -8
- package/src/routes/mcpMemberToken.test.mjs +8 -8
- package/src/routes/mcpProtectedResourceMetadata.test.mjs +2 -2
- package/src/routes/{docs/checkpointsRevert.js → mobileRoot.js} +10 -13
- package/src/routes/mobileRoutes.test.mjs +223 -0
- package/src/routes/mobileSignIn.js +58 -0
- package/src/routes/mobileSignIn.test.mjs +59 -0
- package/src/routes/mobileSignInCallback.js +34 -0
- package/src/routes/mobileSignInCallback.test.mjs +51 -0
- package/src/routes/mountDevPageRoutes.js +10 -2
- package/src/routes/mountDevPageRoutes.test.mjs +25 -1
- package/src/routes/mountMobileWellKnown.js +35 -0
- package/src/routes/mountMobileWellKnown.test.mjs +79 -0
- package/src/routes/mountOauthDiscovery.test.mjs +5 -5
- package/src/routes/normalizeMcpProtocolVersionHeader.test.mjs +1 -0
- package/src/routes/reload.js +101 -20
- package/src/routes/reload.test.mjs +153 -0
- package/src/routes/request.js +1 -22
- package/src/routes/request.test.mjs +7 -24
- package/src/routes/requestBody.test.mjs +14 -27
- package/src/routes/websocket.test.mjs +2 -2
- package/src/routes/wellKnownFallback.test.mjs +2 -2
- package/src/websocket/devWebSocket.test.mjs +12 -12
- package/vite.config.js +13 -1
- package/client/feedback/FeedbackMount.jsx +0 -83
- package/client/feedback/FeedbackOverlay.jsx +0 -904
- package/client/feedback/captureTabScreenshot.js +0 -84
- package/client/feedback/copyToClipboard.js +0 -45
- package/client/feedback/drawAnnotationsSvg.js +0 -119
- package/client/feedback/feedbackStyles.js +0 -304
- package/client/feedback/pinResponsiveImages.js +0 -59
- package/client/feedback/sendFeedback.js +0 -39
- package/client/feedback/useFeedbackToggle.js +0 -70
- package/client/recorder/buildEngineRecord.js +0 -37
- package/client/recorder/buildInteractionRecord.js +0 -64
- package/client/recorder/buildTraceEvent.js +0 -57
- package/client/recorder/buildTraceEvent.test.mjs +0 -81
- package/client/recorder/chunkRecords.js +0 -69
- package/client/recorder/chunkRecords.test.mjs +0 -59
- package/client/recorder/collectEventEndpoints.js +0 -40
- package/client/recorder/collectEventRequests.js +0 -39
- package/client/recorder/createPairingBuffer.js +0 -187
- package/client/recorder/createPasswordRedactor.js +0 -84
- package/client/recorder/createRecordBatcher.js +0 -54
- package/client/recorder/createRecordBatcher.test.mjs +0 -76
- package/client/recorder/createRecordingSession.js +0 -61
- package/client/recorder/createRecordingSession.test.mjs +0 -72
- package/client/recorder/diffStateWrites.js +0 -77
- package/client/recorder/diffStateWrites.test.mjs +0 -66
- package/client/recorder/isEventCall.js +0 -30
- package/client/recorder/jsonType.js +0 -39
- package/client/recorder/sendRecords.js +0 -40
- package/lib/docs/captureAnnotatedScreenshot.js +0 -99
- package/lib/docs/checkpointPaths.js +0 -91
- package/lib/docs/checkpointStore.js +0 -243
- package/lib/docs/checkpointToMocks.js +0 -65
- package/lib/docs/configCheckpoints.test.mjs +0 -156
- package/lib/docs/createConfigCheckpoint.js +0 -92
- package/lib/docs/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
|
@@ -14,10 +14,10 @@
|
|
|
14
14
|
limitations under the License.
|
|
15
15
|
*/
|
|
16
16
|
|
|
17
|
-
import fs from 'fs';
|
|
18
17
|
import path from 'path';
|
|
19
18
|
import createPluginSourceIgnore from './createPluginSourceIgnore.mjs';
|
|
20
|
-
import
|
|
19
|
+
import listServerPluginFiles from './listServerPluginFiles.mjs';
|
|
20
|
+
import { clearPluginTypeCache } from '../utils/pluginTypeCache.mjs';
|
|
21
21
|
import readPluginDefinitions from '../utils/readPluginDefinitions.mjs';
|
|
22
22
|
import selectLocalPluginPackages from './selectLocalPluginPackages.mjs';
|
|
23
23
|
import setupWatcher from '../utils/setupWatcher.mjs';
|
|
@@ -27,19 +27,51 @@ function isInside({ filePath, dir }) {
|
|
|
27
27
|
return !relative.startsWith('..') && !path.isAbsolute(relative);
|
|
28
28
|
}
|
|
29
29
|
|
|
30
|
+
// The server process caches the modules of server-side types (requests,
|
|
31
|
+
// connections, operators, ...), so a change to one of the files it imports
|
|
32
|
+
// restarts it. Any other file of the package - a block, an action, a client
|
|
33
|
+
// operator - is Vite's to hot-replace, and a restart would only drop the page
|
|
34
|
+
// loads and tool calls in flight for the length of a child start. The import
|
|
35
|
+
// graph is walked after the build, which rewrites the server's plugin import
|
|
36
|
+
// files when a type is added or removed. The graph alone decides, so a
|
|
37
|
+
// server file in a plugin that only holds steps, or a helper a connection
|
|
38
|
+
// imports from another local plugin, restarts too. A package.json can change
|
|
39
|
+
// what the server's imports resolve to, so it restarts for a package the
|
|
40
|
+
// server imports from.
|
|
41
|
+
function isServerCodeChange({ changedFiles, context, packages }) {
|
|
42
|
+
const { files, unsureDirs } = listServerPluginFiles({
|
|
43
|
+
directories: context.directories,
|
|
44
|
+
packages,
|
|
45
|
+
});
|
|
46
|
+
const serverDirs = packages
|
|
47
|
+
.map(({ dir }) => dir)
|
|
48
|
+
.filter(
|
|
49
|
+
(dir) => unsureDirs.has(dir) || [...files].some((filePath) => isInside({ filePath, dir }))
|
|
50
|
+
);
|
|
51
|
+
return changedFiles.some((filePath) => {
|
|
52
|
+
if (files.has(filePath)) {
|
|
53
|
+
return true;
|
|
54
|
+
}
|
|
55
|
+
const dir = serverDirs.find((serverDir) => isInside({ filePath, dir: serverDir }));
|
|
56
|
+
if (dir === undefined) {
|
|
57
|
+
return false;
|
|
58
|
+
}
|
|
59
|
+
return unsureDirs.has(dir) || path.basename(filePath) === 'package.json';
|
|
60
|
+
});
|
|
61
|
+
}
|
|
62
|
+
|
|
30
63
|
// A local plugin's code can change while the dev server runs, and nothing
|
|
31
64
|
// else watches it when it lives outside the config directory. The config
|
|
32
|
-
// build reads each plugin's type list,
|
|
33
|
-
// clears a build a broken plugin failed.
|
|
34
|
-
//
|
|
35
|
-
//
|
|
36
|
-
// is Vite's to hot-replace. Only code files anywhere in the package are
|
|
65
|
+
// build reads each plugin's type list, and block source for the page CSS, so
|
|
66
|
+
// any change rebuilds - which also clears a build a broken plugin failed.
|
|
67
|
+
// Only a change to code the server imports restarts it (see
|
|
68
|
+
// isServerCodeChange). Only code files anywhere in the package are
|
|
37
69
|
// watched: a plugin may be imported from its sources or from a build output
|
|
38
70
|
// its own watcher writes, but non-code files (public/, YAML, Markdown) are
|
|
39
71
|
// never plugin code, and a package that is also the config directory writes
|
|
40
72
|
// some of them on every build (see createPluginSourceIgnore).
|
|
41
73
|
async function pluginSourceWatcher(context) {
|
|
42
|
-
const plugins = await readPluginDefinitions({ directories: context.directories });
|
|
74
|
+
const { plugins } = await readPluginDefinitions({ directories: context.directories });
|
|
43
75
|
const packages = selectLocalPluginPackages({
|
|
44
76
|
directories: context.directories,
|
|
45
77
|
packageNames: plugins.map((plugin) => plugin.name),
|
|
@@ -50,19 +82,15 @@ async function pluginSourceWatcher(context) {
|
|
|
50
82
|
|
|
51
83
|
const callback = async (filePaths) => {
|
|
52
84
|
const changedFiles = filePaths.flat();
|
|
53
|
-
const customTypesMap = JSON.parse(
|
|
54
|
-
fs.readFileSync(path.join(context.directories.build, 'customTypesMap.json'), 'utf8')
|
|
55
|
-
);
|
|
56
|
-
const serverSide = listServerSidePackages({ customTypesMap });
|
|
57
|
-
const restart = packages.some(
|
|
58
|
-
({ package: packageName, dir }) =>
|
|
59
|
-
serverSide.has(packageName) && changedFiles.some((filePath) => isInside({ filePath, dir }))
|
|
60
|
-
);
|
|
61
85
|
context.logger.info({ spin: 'start' }, 'Local plugin source changed, rebuilding.');
|
|
86
|
+
// The plugin type cache can not see every file a plugin's types import.
|
|
87
|
+
clearPluginTypeCache();
|
|
62
88
|
try {
|
|
63
89
|
await context.lowdefyBuild();
|
|
64
90
|
} finally {
|
|
65
|
-
await context.syncServer({
|
|
91
|
+
await context.syncServer({
|
|
92
|
+
restart: isServerCodeChange({ changedFiles, context, packages }),
|
|
93
|
+
});
|
|
66
94
|
await context.reloadClients();
|
|
67
95
|
}
|
|
68
96
|
};
|
|
@@ -17,27 +17,24 @@
|
|
|
17
17
|
import fs from 'fs';
|
|
18
18
|
import os from 'os';
|
|
19
19
|
import path from 'path';
|
|
20
|
-
import {
|
|
20
|
+
import { vi, afterEach, beforeEach, describe, expect, test } from 'vitest';
|
|
21
21
|
|
|
22
22
|
import flushFsEvents from '../../test-utils/flushFsEvents.mjs';
|
|
23
23
|
import waitFor from '../../test-utils/waitFor.mjs';
|
|
24
24
|
|
|
25
|
+
const mockClearPluginTypeCache = vi.fn();
|
|
26
|
+
vi.doMock('../utils/pluginTypeCache.mjs', () => ({
|
|
27
|
+
clearPluginTypeCache: mockClearPluginTypeCache,
|
|
28
|
+
}));
|
|
25
29
|
const { default: pluginSourceWatcher } = await import('./pluginSourceWatcher.mjs');
|
|
26
30
|
|
|
27
31
|
// macOS can hold file events back for tens of seconds on a busy machine.
|
|
28
|
-
|
|
32
|
+
vi.setConfig({ testTimeout: 180000, hookTimeout: 180000 });
|
|
29
33
|
|
|
30
34
|
let root;
|
|
31
35
|
let context;
|
|
32
36
|
let watcher;
|
|
33
37
|
|
|
34
|
-
function writeCustomTypesMap(customTypesMap) {
|
|
35
|
-
fs.writeFileSync(
|
|
36
|
-
path.join(context.directories.build, 'customTypesMap.json'),
|
|
37
|
-
JSON.stringify(customTypesMap)
|
|
38
|
-
);
|
|
39
|
-
}
|
|
40
|
-
|
|
41
38
|
function writeLowdefyYaml(pluginNames) {
|
|
42
39
|
fs.writeFileSync(
|
|
43
40
|
path.join(context.directories.config, 'lowdefy.yaml'),
|
|
@@ -65,20 +62,20 @@ function addLinkedPackage(name) {
|
|
|
65
62
|
}
|
|
66
63
|
|
|
67
64
|
beforeEach(() => {
|
|
65
|
+
mockClearPluginTypeCache.mockClear();
|
|
68
66
|
root = fs.mkdtempSync(path.join(os.tmpdir(), 'lowdefy-plugin-watcher-test-'));
|
|
69
67
|
const config = path.join(root, 'app');
|
|
70
68
|
const server = path.join(config, '.lowdefy', 'dev');
|
|
71
69
|
fs.mkdirSync(path.join(server, 'node_modules'), { recursive: true });
|
|
72
70
|
fs.mkdirSync(path.join(server, 'build'), { recursive: true });
|
|
73
71
|
context = {
|
|
74
|
-
buildActivity: { setBusy:
|
|
72
|
+
buildActivity: { setBusy: vi.fn() },
|
|
75
73
|
directories: { build: path.join(server, 'build'), config, server },
|
|
76
|
-
logger: { info:
|
|
77
|
-
lowdefyBuild:
|
|
78
|
-
reloadClients:
|
|
79
|
-
syncServer:
|
|
74
|
+
logger: { info: vi.fn(), warn: vi.fn(), error: vi.fn() },
|
|
75
|
+
lowdefyBuild: vi.fn(async () => {}),
|
|
76
|
+
reloadClients: vi.fn(async () => {}),
|
|
77
|
+
syncServer: vi.fn(async () => {}),
|
|
80
78
|
};
|
|
81
|
-
writeCustomTypesMap({});
|
|
82
79
|
});
|
|
83
80
|
|
|
84
81
|
afterEach(async () => {
|
|
@@ -95,27 +92,106 @@ test('pluginSourceWatcher watches nothing when lowdefy.yaml lists no local plugi
|
|
|
95
92
|
await expect(pluginSourceWatcher(context)).resolves.toBeUndefined();
|
|
96
93
|
});
|
|
97
94
|
|
|
95
|
+
// The server imports a plugin's server-side types of a kind through the
|
|
96
|
+
// build's plugin import file for that kind, here src/server.js, which imports
|
|
97
|
+
// src/find.js. Without a kind the server imports nothing from the plugin.
|
|
98
|
+
function writePlugin(dir, kind) {
|
|
99
|
+
const exports = { './blocks': './src/blocks.js' };
|
|
100
|
+
if (kind) {
|
|
101
|
+
exports[`./${kind}`] = './src/server.js';
|
|
102
|
+
}
|
|
103
|
+
fs.writeFileSync(
|
|
104
|
+
path.join(dir, 'package.json'),
|
|
105
|
+
JSON.stringify({ name: '@app/plugin', type: 'module', exports })
|
|
106
|
+
);
|
|
107
|
+
fs.writeFileSync(
|
|
108
|
+
path.join(dir, 'src', 'server.js'),
|
|
109
|
+
"export { default as Find } from './find.js';\n"
|
|
110
|
+
);
|
|
111
|
+
fs.writeFileSync(path.join(dir, 'src', 'blocks.js'), "export { default } from './Fancy.js';\n");
|
|
112
|
+
fs.writeFileSync(path.join(dir, 'src', 'find.js'), 'export default 1;');
|
|
113
|
+
fs.writeFileSync(path.join(dir, 'src', 'Fancy.js'), 'export default 1;');
|
|
114
|
+
fs.mkdirSync(path.join(context.directories.build, 'plugins'), { recursive: true });
|
|
115
|
+
fs.writeFileSync(
|
|
116
|
+
path.join(context.directories.build, 'plugins', 'blocks.js'),
|
|
117
|
+
"import Fancy from '@app/plugin/blocks';\nexport default { Fancy };\n"
|
|
118
|
+
);
|
|
119
|
+
if (kind) {
|
|
120
|
+
fs.writeFileSync(
|
|
121
|
+
path.join(context.directories.build, 'plugins', `${kind}.js`),
|
|
122
|
+
`import { Find as Find } from '@app/plugin/${kind}';\nexport default { Find };\n`
|
|
123
|
+
);
|
|
124
|
+
}
|
|
125
|
+
}
|
|
126
|
+
|
|
98
127
|
test.each([
|
|
99
|
-
['a server-side plugin rebuilds and restarts the server', '
|
|
100
|
-
['a
|
|
101
|
-
['a plugin
|
|
128
|
+
['a server-side plugin rebuilds and restarts the server', 'connections', 'src/find.js', true],
|
|
129
|
+
['a plugin that only holds steps rebuilds and restarts the server', 'steps', 'src/find.js', true],
|
|
130
|
+
['a block-only plugin rebuilds without a restart', null, 'src/Fancy.js', false],
|
|
131
|
+
['a plugin imported from its build output rebuilds', null, 'dist/Fancy.js', false],
|
|
132
|
+
[
|
|
133
|
+
'a block in a plugin with server-side types rebuilds without a restart',
|
|
134
|
+
'connections',
|
|
135
|
+
'src/Fancy.js',
|
|
136
|
+
false,
|
|
137
|
+
],
|
|
138
|
+
[
|
|
139
|
+
'the package.json of a plugin with server-side types rebuilds and restarts',
|
|
140
|
+
'connections',
|
|
141
|
+
'package.json',
|
|
142
|
+
true,
|
|
143
|
+
],
|
|
144
|
+
[
|
|
145
|
+
'the package.json of a block-only plugin rebuilds without a restart',
|
|
146
|
+
null,
|
|
147
|
+
'package.json',
|
|
148
|
+
false,
|
|
149
|
+
],
|
|
102
150
|
])('editing %s', async (_, kind, file, restart) => {
|
|
103
151
|
const dir = addLinkedPackage('@app/plugin');
|
|
104
|
-
|
|
152
|
+
writePlugin(dir, kind);
|
|
153
|
+
if (file !== 'package.json') {
|
|
154
|
+
fs.writeFileSync(path.join(dir, file), 'export default 1;');
|
|
155
|
+
}
|
|
105
156
|
writeLowdefyYaml(['@app/plugin']);
|
|
106
|
-
writeCustomTypesMap({ [kind]: { Type: { package: '@app/plugin', version: '1.0.0' } } });
|
|
107
157
|
|
|
108
158
|
await startWatcher();
|
|
109
|
-
|
|
159
|
+
if (file === 'package.json') {
|
|
160
|
+
fs.appendFileSync(path.join(dir, file), '\n');
|
|
161
|
+
} else {
|
|
162
|
+
fs.writeFileSync(path.join(dir, file), 'export default 2;');
|
|
163
|
+
}
|
|
110
164
|
await waitFor(() => context.reloadClients.mock.calls.length > 0, {
|
|
111
165
|
description: 'clients to reload',
|
|
112
166
|
});
|
|
113
167
|
|
|
114
168
|
expect(context.lowdefyBuild).toHaveBeenCalledTimes(1);
|
|
169
|
+
expect(mockClearPluginTypeCache).toHaveBeenCalledTimes(1);
|
|
170
|
+
expect(mockClearPluginTypeCache.mock.invocationCallOrder[0]).toBeLessThan(
|
|
171
|
+
context.lowdefyBuild.mock.invocationCallOrder[0]
|
|
172
|
+
);
|
|
115
173
|
expect(context.syncServer).toHaveBeenCalledWith({ restart });
|
|
116
174
|
expect(context.buildActivity.setBusy.mock.calls[0]).toEqual([true]);
|
|
117
175
|
});
|
|
118
176
|
|
|
177
|
+
test('editing a server-side plugin whose server code imports a computed path restarts the server', async () => {
|
|
178
|
+
const dir = addLinkedPackage('@app/plugin');
|
|
179
|
+
writePlugin(dir, 'connections');
|
|
180
|
+
fs.writeFileSync(
|
|
181
|
+
path.join(dir, 'src', 'find.js'),
|
|
182
|
+
'export default (name) => import(`./handlers/${name}.js`);'
|
|
183
|
+
);
|
|
184
|
+
writeLowdefyYaml(['@app/plugin']);
|
|
185
|
+
|
|
186
|
+
await startWatcher();
|
|
187
|
+
fs.writeFileSync(path.join(dir, 'src', 'Fancy.js'), 'export default 2;');
|
|
188
|
+
await waitFor(() => context.reloadClients.mock.calls.length > 0, {
|
|
189
|
+
description: 'clients to reload',
|
|
190
|
+
});
|
|
191
|
+
|
|
192
|
+
expect(context.syncServer).toHaveBeenCalledWith({ restart: true });
|
|
193
|
+
});
|
|
194
|
+
|
|
119
195
|
test('a fix to a plugin whose edit failed the build rebuilds again', async () => {
|
|
120
196
|
const dir = addLinkedPackage('@app/plugin');
|
|
121
197
|
fs.writeFileSync(path.join(dir, 'src', 'types.js'), 'export default {};');
|
|
@@ -0,0 +1,46 @@
|
|
|
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 path from 'path';
|
|
19
|
+
|
|
20
|
+
const EXTENSIONS = ['.js', '.mjs', '.cjs', '.jsx', '.ts', '.tsx', '.json'];
|
|
21
|
+
|
|
22
|
+
// TypeScript sources import each other by the name of their output
|
|
23
|
+
// ('./find.js' for find.ts), which Vite resolves to the source.
|
|
24
|
+
const TYPESCRIPT_SOURCES = {
|
|
25
|
+
'.js': ['.ts', '.tsx'],
|
|
26
|
+
'.jsx': ['.tsx'],
|
|
27
|
+
};
|
|
28
|
+
|
|
29
|
+
// The real path of the file an import of `base` loads, trying the extensions
|
|
30
|
+
// and index files Vite tries, or null when there is none.
|
|
31
|
+
function resolveFile(base) {
|
|
32
|
+
const extension = path.extname(base);
|
|
33
|
+
const stem = base.slice(0, base.length - extension.length);
|
|
34
|
+
const candidates = [
|
|
35
|
+
base,
|
|
36
|
+
...(TYPESCRIPT_SOURCES[extension] ?? []).map((source) => `${stem}${source}`),
|
|
37
|
+
...EXTENSIONS.map((candidate) => `${base}${candidate}`),
|
|
38
|
+
...EXTENSIONS.map((candidate) => path.join(base, `index${candidate}`)),
|
|
39
|
+
];
|
|
40
|
+
const found = candidates.find((candidate) =>
|
|
41
|
+
fs.statSync(candidate, { throwIfNoEntry: false })?.isFile()
|
|
42
|
+
);
|
|
43
|
+
return found ? fs.realpathSync(found) : null;
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
export default resolveFile;
|
|
@@ -0,0 +1,67 @@
|
|
|
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 { afterEach, beforeEach, expect, test } from 'vitest';
|
|
21
|
+
|
|
22
|
+
import resolveFile from './resolveFile.mjs';
|
|
23
|
+
|
|
24
|
+
let dir;
|
|
25
|
+
|
|
26
|
+
function write(relative) {
|
|
27
|
+
const filePath = path.join(dir, relative);
|
|
28
|
+
fs.mkdirSync(path.dirname(filePath), { recursive: true });
|
|
29
|
+
fs.writeFileSync(filePath, '');
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
beforeEach(() => {
|
|
33
|
+
dir = fs.realpathSync(fs.mkdtempSync(path.join(os.tmpdir(), 'lowdefy-resolve-file-test-')));
|
|
34
|
+
});
|
|
35
|
+
|
|
36
|
+
afterEach(() => {
|
|
37
|
+
fs.rmSync(dir, { recursive: true, force: true });
|
|
38
|
+
});
|
|
39
|
+
|
|
40
|
+
test('resolveFile returns the file a full path names', () => {
|
|
41
|
+
write('Api.js');
|
|
42
|
+
|
|
43
|
+
expect(resolveFile(path.join(dir, 'Api.js'))).toBe(path.join(dir, 'Api.js'));
|
|
44
|
+
});
|
|
45
|
+
|
|
46
|
+
test('resolveFile adds an extension or an index file', () => {
|
|
47
|
+
write('request.mjs');
|
|
48
|
+
write('Api/index.ts');
|
|
49
|
+
|
|
50
|
+
expect(resolveFile(path.join(dir, 'request'))).toBe(path.join(dir, 'request.mjs'));
|
|
51
|
+
expect(resolveFile(path.join(dir, 'Api'))).toBe(path.join(dir, 'Api', 'index.ts'));
|
|
52
|
+
});
|
|
53
|
+
|
|
54
|
+
test('resolveFile resolves a TypeScript output name to its source', () => {
|
|
55
|
+
write('find.ts');
|
|
56
|
+
write('Card.tsx');
|
|
57
|
+
|
|
58
|
+
expect(resolveFile(path.join(dir, 'find.js'))).toBe(path.join(dir, 'find.ts'));
|
|
59
|
+
expect(resolveFile(path.join(dir, 'Card.jsx'))).toBe(path.join(dir, 'Card.tsx'));
|
|
60
|
+
});
|
|
61
|
+
|
|
62
|
+
test('resolveFile returns null when no file matches', () => {
|
|
63
|
+
fs.mkdirSync(path.join(dir, 'empty'));
|
|
64
|
+
|
|
65
|
+
expect(resolveFile(path.join(dir, 'missing.js'))).toBe(null);
|
|
66
|
+
expect(resolveFile(path.join(dir, 'empty'))).toBe(null);
|
|
67
|
+
});
|
|
@@ -0,0 +1,127 @@
|
|
|
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 path from 'path';
|
|
19
|
+
import { type } from '@lowdefy/helpers';
|
|
20
|
+
|
|
21
|
+
import resolveFile from './resolveFile.mjs';
|
|
22
|
+
|
|
23
|
+
// The conditions Vite's SSR resolver matches for an import in the dev server
|
|
24
|
+
// (ssr.resolve.conditions in development, plus 'import'), so a package that
|
|
25
|
+
// exports a CommonJS build beside its ES modules resolves to the modules the
|
|
26
|
+
// server loads.
|
|
27
|
+
const CONDITIONS = new Set(['default', 'development', 'import', 'module', 'node']);
|
|
28
|
+
|
|
29
|
+
function resolveTarget(target) {
|
|
30
|
+
if (type.isString(target)) {
|
|
31
|
+
return target;
|
|
32
|
+
}
|
|
33
|
+
if (type.isArray(target)) {
|
|
34
|
+
for (const item of target) {
|
|
35
|
+
const resolved = resolveTarget(item);
|
|
36
|
+
if (resolved !== null) {
|
|
37
|
+
return resolved;
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
return null;
|
|
41
|
+
}
|
|
42
|
+
if (type.isObject(target)) {
|
|
43
|
+
for (const [condition, value] of Object.entries(target)) {
|
|
44
|
+
if (CONDITIONS.has(condition)) {
|
|
45
|
+
const resolved = resolveTarget(value);
|
|
46
|
+
if (resolved !== null) {
|
|
47
|
+
return resolved;
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
return null;
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
// An exact key wins; otherwise the pattern key with the longest prefix before
|
|
56
|
+
// its '*', the order Node and Vite match subpath patterns in.
|
|
57
|
+
function matchSubpath({ map, subpath }) {
|
|
58
|
+
if (Object.hasOwn(map, subpath)) {
|
|
59
|
+
return resolveTarget(map[subpath]);
|
|
60
|
+
}
|
|
61
|
+
let best = null;
|
|
62
|
+
for (const key of Object.keys(map)) {
|
|
63
|
+
const star = key.indexOf('*');
|
|
64
|
+
if (star === -1) {
|
|
65
|
+
continue;
|
|
66
|
+
}
|
|
67
|
+
const prefix = key.slice(0, star);
|
|
68
|
+
const suffix = key.slice(star + 1);
|
|
69
|
+
const matches =
|
|
70
|
+
subpath.length >= prefix.length + suffix.length &&
|
|
71
|
+
subpath.startsWith(prefix) &&
|
|
72
|
+
subpath.endsWith(suffix);
|
|
73
|
+
if (matches && (best === null || prefix.length > best.prefix.length)) {
|
|
74
|
+
best = { key, prefix, value: subpath.slice(prefix.length, subpath.length - suffix.length) };
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
if (best === null) {
|
|
78
|
+
return null;
|
|
79
|
+
}
|
|
80
|
+
const target = resolveTarget(map[best.key]);
|
|
81
|
+
return target === null ? null : target.replaceAll('*', best.value);
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
// exports is either a subpath map ({ './connections': ... }) or the target of
|
|
85
|
+
// the package root alone (a string, an array or a conditions object).
|
|
86
|
+
function exportsMap(exports) {
|
|
87
|
+
if (type.isObject(exports) && Object.keys(exports).some((key) => key.startsWith('.'))) {
|
|
88
|
+
return exports;
|
|
89
|
+
}
|
|
90
|
+
return { '.': exports };
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
// Where a local package's own specifier leads: a package subpath
|
|
94
|
+
// ('@app/plugin/connections') through the package's exports, or a
|
|
95
|
+
// subpath import ('#lib/query.js') through its imports. Returns { filePath },
|
|
96
|
+
// { specifier } when an import names another package, or null when the
|
|
97
|
+
// package does not map the specifier or the file it names is missing.
|
|
98
|
+
function resolvePackageSpecifier({ dir, packageName, specifier }) {
|
|
99
|
+
const packageJson = JSON.parse(fs.readFileSync(path.join(dir, 'package.json'), 'utf8'));
|
|
100
|
+
let target;
|
|
101
|
+
if (specifier.startsWith('#')) {
|
|
102
|
+
target = matchSubpath({ map: packageJson.imports ?? {}, subpath: specifier });
|
|
103
|
+
} else {
|
|
104
|
+
const subpath = `.${specifier.slice(packageName.length)}`;
|
|
105
|
+
if (type.isNone(packageJson.exports)) {
|
|
106
|
+
const main = packageJson.module ?? packageJson.main ?? './index.js';
|
|
107
|
+
target = subpath === '.' ? `./${path.posix.normalize(main)}` : subpath;
|
|
108
|
+
} else {
|
|
109
|
+
target = matchSubpath({ map: exportsMap(packageJson.exports), subpath });
|
|
110
|
+
}
|
|
111
|
+
}
|
|
112
|
+
if (target === null) {
|
|
113
|
+
return null;
|
|
114
|
+
}
|
|
115
|
+
if (target.startsWith('./')) {
|
|
116
|
+
const filePath = resolveFile(path.resolve(dir, target));
|
|
117
|
+
return filePath === null ? null : { filePath };
|
|
118
|
+
}
|
|
119
|
+
// As in Node, only an import may name another package, and not through
|
|
120
|
+
// another subpath import.
|
|
121
|
+
if (specifier.startsWith('#') && !target.startsWith('#')) {
|
|
122
|
+
return { specifier: target };
|
|
123
|
+
}
|
|
124
|
+
return null;
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
export default resolvePackageSpecifier;
|
|
@@ -0,0 +1,151 @@
|
|
|
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 { afterEach, beforeEach, expect, test } from 'vitest';
|
|
21
|
+
|
|
22
|
+
import resolvePackageSpecifier from './resolvePackageSpecifier.mjs';
|
|
23
|
+
|
|
24
|
+
let dir;
|
|
25
|
+
|
|
26
|
+
function write(relative, content) {
|
|
27
|
+
const filePath = path.join(dir, relative);
|
|
28
|
+
fs.mkdirSync(path.dirname(filePath), { recursive: true });
|
|
29
|
+
fs.writeFileSync(filePath, content);
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
function resolve({ packageJson, specifier }) {
|
|
33
|
+
write('package.json', JSON.stringify({ name: '@app/plugin', ...packageJson }));
|
|
34
|
+
return resolvePackageSpecifier({ dir, packageName: '@app/plugin', specifier });
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
beforeEach(() => {
|
|
38
|
+
dir = fs.realpathSync(fs.mkdtempSync(path.join(os.tmpdir(), 'lowdefy-resolve-specifier-test-')));
|
|
39
|
+
write('dist/connections.js', '');
|
|
40
|
+
write('dist/esm/connections.js', '');
|
|
41
|
+
write('dist/cjs/connections.cjs', '');
|
|
42
|
+
write('src/connections.js', '');
|
|
43
|
+
write('src/lib/query.js', '');
|
|
44
|
+
write('index.js', '');
|
|
45
|
+
});
|
|
46
|
+
|
|
47
|
+
afterEach(() => {
|
|
48
|
+
fs.rmSync(dir, { recursive: true, force: true });
|
|
49
|
+
});
|
|
50
|
+
|
|
51
|
+
test('resolvePackageSpecifier resolves a subpath through a string export', () => {
|
|
52
|
+
expect(
|
|
53
|
+
resolve({
|
|
54
|
+
packageJson: { exports: { './connections': './dist/connections.js' } },
|
|
55
|
+
specifier: '@app/plugin/connections',
|
|
56
|
+
})
|
|
57
|
+
).toEqual({ filePath: path.join(dir, 'dist/connections.js') });
|
|
58
|
+
});
|
|
59
|
+
|
|
60
|
+
test('resolvePackageSpecifier takes the import condition over require', () => {
|
|
61
|
+
expect(
|
|
62
|
+
resolve({
|
|
63
|
+
packageJson: {
|
|
64
|
+
exports: {
|
|
65
|
+
'./connections': {
|
|
66
|
+
require: './dist/cjs/connections.cjs',
|
|
67
|
+
import: './dist/esm/connections.js',
|
|
68
|
+
},
|
|
69
|
+
},
|
|
70
|
+
},
|
|
71
|
+
specifier: '@app/plugin/connections',
|
|
72
|
+
})
|
|
73
|
+
).toEqual({ filePath: path.join(dir, 'dist/esm/connections.js') });
|
|
74
|
+
});
|
|
75
|
+
|
|
76
|
+
test('resolvePackageSpecifier takes the development condition in key order', () => {
|
|
77
|
+
expect(
|
|
78
|
+
resolve({
|
|
79
|
+
packageJson: {
|
|
80
|
+
exports: {
|
|
81
|
+
'./connections': {
|
|
82
|
+
development: './src/connections.js',
|
|
83
|
+
default: './dist/connections.js',
|
|
84
|
+
},
|
|
85
|
+
},
|
|
86
|
+
},
|
|
87
|
+
specifier: '@app/plugin/connections',
|
|
88
|
+
})
|
|
89
|
+
).toEqual({ filePath: path.join(dir, 'src/connections.js') });
|
|
90
|
+
});
|
|
91
|
+
|
|
92
|
+
test('resolvePackageSpecifier matches the subpath pattern with the longest prefix', () => {
|
|
93
|
+
expect(
|
|
94
|
+
resolve({
|
|
95
|
+
packageJson: { exports: { './*': './nothing/*.js', './conn*': './dist/conn*.js' } },
|
|
96
|
+
specifier: '@app/plugin/connections',
|
|
97
|
+
})
|
|
98
|
+
).toEqual({ filePath: path.join(dir, 'dist/connections.js') });
|
|
99
|
+
});
|
|
100
|
+
|
|
101
|
+
test('resolvePackageSpecifier resolves the package root through a conditions object', () => {
|
|
102
|
+
expect(
|
|
103
|
+
resolve({ packageJson: { exports: { import: './index.js' } }, specifier: '@app/plugin' })
|
|
104
|
+
).toEqual({ filePath: path.join(dir, 'index.js') });
|
|
105
|
+
});
|
|
106
|
+
|
|
107
|
+
test('resolvePackageSpecifier resolves a package without exports from its files', () => {
|
|
108
|
+
expect(resolve({ packageJson: {}, specifier: '@app/plugin' })).toEqual({
|
|
109
|
+
filePath: path.join(dir, 'index.js'),
|
|
110
|
+
});
|
|
111
|
+
expect(resolve({ packageJson: {}, specifier: '@app/plugin/src/connections' })).toEqual({
|
|
112
|
+
filePath: path.join(dir, 'src/connections.js'),
|
|
113
|
+
});
|
|
114
|
+
});
|
|
115
|
+
|
|
116
|
+
test('resolvePackageSpecifier resolves a subpath import through the imports field', () => {
|
|
117
|
+
expect(
|
|
118
|
+
resolve({ packageJson: { imports: { '#lib/*': './src/lib/*' } }, specifier: '#lib/query.js' })
|
|
119
|
+
).toEqual({ filePath: path.join(dir, 'src/lib/query.js') });
|
|
120
|
+
});
|
|
121
|
+
|
|
122
|
+
test('resolvePackageSpecifier returns the package a subpath import names', () => {
|
|
123
|
+
expect(
|
|
124
|
+
resolve({ packageJson: { imports: { '#lodash': 'lodash' } }, specifier: '#lodash' })
|
|
125
|
+
).toEqual({ specifier: 'lodash' });
|
|
126
|
+
});
|
|
127
|
+
|
|
128
|
+
test('resolvePackageSpecifier returns null when the package does not map the specifier', () => {
|
|
129
|
+
expect(
|
|
130
|
+
resolve({
|
|
131
|
+
packageJson: { exports: { './blocks': './dist/blocks.js' } },
|
|
132
|
+
specifier: '@app/plugin/connections',
|
|
133
|
+
})
|
|
134
|
+
).toBe(null);
|
|
135
|
+
expect(
|
|
136
|
+
resolve({
|
|
137
|
+
packageJson: { exports: { './connections': { require: './dist/cjs/connections.cjs' } } },
|
|
138
|
+
specifier: '@app/plugin/connections',
|
|
139
|
+
})
|
|
140
|
+
).toBe(null);
|
|
141
|
+
expect(resolve({ packageJson: { imports: { '#a': '#b' } }, specifier: '#a' })).toBe(null);
|
|
142
|
+
});
|
|
143
|
+
|
|
144
|
+
test('resolvePackageSpecifier returns null when the exported file is missing', () => {
|
|
145
|
+
expect(
|
|
146
|
+
resolve({
|
|
147
|
+
packageJson: { exports: { './connections': './dist/missing.js' } },
|
|
148
|
+
specifier: '@app/plugin/connections',
|
|
149
|
+
})
|
|
150
|
+
).toBe(null);
|
|
151
|
+
});
|