@lowdefy/server-dev 7.0.0 → 7.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (445) hide show
  1. package/client/Inspector.jsx +24 -75
  2. package/client/Page.jsx +8 -0
  3. package/client/Routing.jsx +0 -2
  4. package/client/clientBuildImports.test.mjs +5 -3
  5. package/client/devStreamConnections.test.mjs +1 -0
  6. package/client/journeyObserver/startJourneyObserver.test.mjs +11 -11
  7. package/client/openInEditor/OpenInEditorListener.jsx +36 -29
  8. package/client/openInEditor/OpenInEditorListener.test.mjs +116 -0
  9. package/client/{feedback → openInEditor}/elementInspect.js +9 -44
  10. package/client/openInEditor/findBlockLocation.js +2 -2
  11. package/client/openInEditor/openInEditorStyles.js +56 -0
  12. package/client/recorder/createPairingBuffer.test.mjs +27 -9
  13. package/client/recorder/createRecorder.js +11 -7
  14. package/client/recorder/createRecorder.test.mjs +9 -9
  15. package/client/recorder/isPasswordElement.js +41 -0
  16. package/client/recorder/keyChord.test.mjs +1 -0
  17. package/{client/recorder/toJsonSafe.js → lib/build/mobileConfig.js} +9 -12
  18. package/lib/client/auth/AuthConfigured.jsx +75 -48
  19. package/lib/client/auth/authNotConfiguredParity.test.mjs +1 -0
  20. package/lib/client/auth/authTemplateSync.test.mjs +1 -0
  21. package/lib/client/auth/betterAuthSessionContract.test.mjs +2 -1
  22. package/lib/client/auth/sessionCaller.js +56 -0
  23. package/lib/client/auth/sessionCaller.test.mjs +78 -0
  24. package/lib/client/getPagePath.test.mjs +1 -0
  25. package/lib/client/utils/formatErrorsForCopy.test.mjs +1 -0
  26. package/lib/client/utils/getErrorBarColor.test.mjs +1 -0
  27. package/lib/client/utils/usePageConfig.test.mjs +15 -15
  28. package/lib/configTree/buildConfigTree.test.mjs +6 -8
  29. package/lib/configTree/collectConfigText.test.mjs +1 -0
  30. package/lib/configTree/runConfigTreeBuild.mjs +2 -1
  31. package/lib/configTree/runConfigTreeBuild.skipPluginChecks.test.mjs +11 -11
  32. package/lib/configTree/runConfigTreeBuild.test.mjs +2 -2
  33. package/lib/docs/addNestedEndpoints.test.mjs +1 -0
  34. package/lib/docs/checkAgentFiles.test.mjs +1 -0
  35. package/lib/docs/checkStepReferences.test.mjs +3 -3
  36. package/lib/docs/clientErrorStore.test.mjs +4 -4
  37. package/lib/docs/createBrowserLifecycle.test.mjs +40 -24
  38. package/lib/docs/createDocsMcpServer.js +195 -138
  39. package/lib/docs/createDocsMcpServer.test.mjs +331 -25
  40. package/lib/docs/createDocsMcpServerRunJourney.test.mjs +5 -5
  41. package/lib/docs/createJourneyActors.chromium.test.mjs +3 -3
  42. package/lib/docs/createJourneyActors.test.mjs +4 -4
  43. package/lib/docs/dataSets/checkSharedCollectionIds.js +20 -9
  44. package/lib/docs/dataSets/dataSetJourneys.chromium.mongodb.test.mjs +59 -11
  45. package/{src/routes/docs/content.js → lib/docs/dataSets/describeTargetKey.js} +10 -14
  46. package/lib/docs/dataSets/drainSessionWork.test.mjs +21 -5
  47. package/lib/docs/dataSets/getDataStore.js +11 -3
  48. package/lib/docs/dataSets/getDataStore.mongodb.test.mjs +3 -3
  49. package/lib/docs/dataSets/getDataStore.test.mjs +32 -20
  50. package/lib/docs/dataSets/groupDataSetByCollection.js +19 -11
  51. package/lib/docs/dataSets/mergeCollectionIndexes.test.mjs +1 -0
  52. package/lib/docs/dataSets/openDataSession.js +36 -20
  53. package/lib/docs/dataSets/openDataSession.mongodb.test.mjs +175 -7
  54. package/lib/docs/dataSets/pickDataStorePort.test.mjs +2 -2
  55. package/lib/docs/dataSets/readDataSession.test.mjs +1 -0
  56. package/lib/docs/dataSets/readDataSet.js +34 -19
  57. package/lib/docs/dataSets/readDataSet.test.mjs +57 -25
  58. package/lib/docs/dataSets/resolveJourneyDataSet.test.mjs +1 -0
  59. package/lib/docs/dataSets/sessionDatabaseName.js +32 -0
  60. package/lib/docs/dataSets/sweepOrphanDatabases.js +7 -4
  61. package/lib/docs/dataSets/test/app/lowdefy.yaml +22 -0
  62. package/lib/docs/dataSets/test/app/tests/data/shop.yaml +4 -0
  63. package/lib/docs/dataSets/test/buildTestApp.mjs +1 -1
  64. package/lib/docs/devEventBus.js +7 -2
  65. package/lib/docs/devEventBus.test.mjs +12 -10
  66. package/lib/docs/devToolDefinitions.js +87 -135
  67. package/lib/docs/device/buildDeviceCommand.js +103 -0
  68. package/lib/docs/device/buildDeviceCommand.test.mjs +142 -0
  69. package/lib/docs/device/captureDevice.js +85 -0
  70. package/lib/docs/device/checkShownPage.js +56 -0
  71. package/lib/docs/device/createFakePhoneTab.mjs +77 -0
  72. package/lib/docs/device/deviceAction.js +74 -0
  73. package/lib/docs/device/deviceTools.test.mjs +604 -0
  74. package/lib/docs/device/findDeviceTab.js +50 -0
  75. package/lib/docs/device/findDeviceTarget.js +73 -0
  76. package/lib/docs/device/injectDevice.js +160 -0
  77. package/lib/docs/device/listDevices.js +100 -0
  78. package/lib/docs/device/listDevices.test.mjs +105 -0
  79. package/lib/docs/device/runDeviceJourney.js +68 -0
  80. package/lib/docs/device/runDeviceSteps.js +164 -0
  81. package/lib/docs/device/screenshotDevice.js +68 -0
  82. package/lib/docs/device/sendDeviceStep.js +52 -0
  83. package/lib/docs/device/startDevice.js +150 -0
  84. package/lib/docs/docs.test.mjs +44 -28
  85. package/lib/docs/docsIndex.test.mjs +1 -0
  86. package/lib/docs/findConfig.js +3 -4
  87. package/lib/docs/findPageBlock.js +35 -0
  88. package/lib/docs/findPageBlock.test.mjs +45 -0
  89. package/lib/docs/fitResponse.js +18 -17
  90. package/lib/docs/fitResponse.test.mjs +18 -0
  91. package/lib/docs/getBrowser.js +4 -4
  92. package/lib/docs/getBrowser.test.mjs +32 -16
  93. package/lib/docs/getBuildId.test.mjs +1 -0
  94. package/lib/docs/getBuildStatus.js +29 -3
  95. package/lib/docs/getBuildStatus.test.mjs +108 -12
  96. package/lib/docs/getBuildStatusAfterEdits.test.mjs +8 -8
  97. package/{src/routes/docs/appMap.js → lib/docs/getConfigDirectory.js} +3 -5
  98. package/lib/docs/getHazards.js +4 -1
  99. package/lib/docs/getHazards.test.mjs +9 -7
  100. package/lib/docs/getOverview.js +22 -44
  101. package/lib/docs/getOverviewBasePath.test.mjs +1 -0
  102. package/lib/docs/getStaleStatus.test.mjs +1 -0
  103. package/lib/docs/inspectState.js +78 -3
  104. package/lib/docs/inspectState.test.mjs +61 -9
  105. package/lib/docs/inspectStateFromTab.js +38 -6
  106. package/lib/docs/inspectStateFromTab.test.mjs +79 -0
  107. package/lib/docs/inspectStateHeadless.js +98 -34
  108. package/lib/docs/inspectStateHeadless.test.mjs +17 -5
  109. package/lib/docs/installHeadlessShell.failure.test.mjs +9 -5
  110. package/lib/docs/installHeadlessShell.js +5 -2
  111. package/lib/docs/installHeadlessShell.test.mjs +8 -5
  112. package/lib/docs/installHeadlessShell.timeout.test.mjs +32 -12
  113. package/lib/docs/isDeepEqual.js +37 -0
  114. package/lib/docs/isHeadlessShellIncomplete.test.mjs +1 -0
  115. package/lib/docs/isPageReady.test.mjs +1 -0
  116. package/lib/docs/journeyMutantCookie.chromium.test.mjs +3 -3
  117. package/lib/docs/journeyRunRecording.test.mjs +1 -0
  118. package/lib/docs/keepEventStreamAlive.test.mjs +1 -0
  119. package/lib/docs/launchBrowser.test.mjs +8 -8
  120. package/lib/docs/listTypes.js +58 -8
  121. package/lib/docs/loadFrameworkHazards.test.mjs +1 -0
  122. package/lib/docs/matchJourneyRoute.test.mjs +1 -0
  123. package/lib/docs/observe/createJourneyAppErrors.test.mjs +3 -3
  124. package/lib/docs/observe/evaluateInvariants.test.mjs +1 -0
  125. package/lib/docs/observe/hasNoEffect.test.mjs +1 -0
  126. package/lib/docs/observe/withAppErrors.test.mjs +1 -0
  127. package/lib/docs/openJourneyEmail.test.mjs +6 -6
  128. package/lib/docs/pageBuildStatus.test.mjs +6 -6
  129. package/lib/docs/pollTab.js +100 -0
  130. package/lib/docs/pollTab.test.mjs +64 -0
  131. package/lib/docs/rails/authEngineActions.test.mjs +1 -0
  132. package/lib/docs/rails/authEngineMethods.test.mjs +2 -1
  133. package/lib/docs/rails/checkAuthActionsRan.test.mjs +5 -5
  134. package/lib/docs/rails/createDataSetRails.test.mjs +1 -0
  135. package/lib/docs/rails/findExternalBlocks.js +3 -3
  136. package/lib/docs/rails/findExternalBlocks.test.mjs +1 -0
  137. package/lib/docs/readJourneyEmailMatch.test.mjs +2 -2
  138. package/lib/docs/readJourneySession.js +1 -1
  139. package/lib/docs/reportDevToolFault.js +29 -0
  140. package/lib/docs/reportDevToolFault.test.mjs +34 -0
  141. package/lib/docs/requestRestart.test.mjs +1 -0
  142. package/lib/docs/resolvePageInstance.test.mjs +1 -0
  143. package/lib/docs/resolveSource.js +2 -2
  144. package/lib/docs/resolveSource.test.mjs +6 -6
  145. package/lib/docs/reviewPageBuilds.test.mjs +2 -2
  146. package/lib/docs/runCheck.test.mjs +3 -3
  147. package/lib/docs/runCheckChild.js +2 -1
  148. package/lib/docs/runEndpoint.js +23 -10
  149. package/lib/docs/runEndpoint.test.mjs +42 -37
  150. package/lib/docs/runErrorBuffers.test.mjs +1 -0
  151. package/lib/docs/runJourney.js +21 -1
  152. package/lib/docs/runJourney.test.mjs +119 -99
  153. package/lib/docs/runJourneyDataSet.test.mjs +26 -26
  154. package/lib/docs/runJourneySteps.js +8 -29
  155. package/lib/docs/runRequest.js +6 -6
  156. package/lib/docs/runRequest.test.mjs +22 -22
  157. package/lib/docs/screenshotPage.js +6 -7
  158. package/lib/docs/screenshotPage.test.mjs +46 -46
  159. package/lib/docs/screenshotPageClip.test.mjs +10 -10
  160. package/lib/docs/searchDocs.test.mjs +1 -0
  161. package/lib/docs/searchIcons.test.mjs +5 -5
  162. package/lib/docs/selectFinalState.test.mjs +1 -0
  163. package/lib/docs/serverErrorStore.test.mjs +4 -4
  164. package/lib/docs/setupTestFixtures.mjs +25 -0
  165. package/lib/docs/splitSearchTerms.test.mjs +1 -0
  166. package/lib/docs/tabAvailable.js +1 -1
  167. package/lib/docs/tabChannel.js +90 -14
  168. package/lib/docs/tabChannel.test.mjs +40 -15
  169. package/lib/docs/validateJourneyTimeout.test.mjs +1 -0
  170. package/lib/docs/validateStateSelection.test.mjs +1 -0
  171. package/lib/docs/validateViewport.test.mjs +1 -0
  172. package/lib/docs/waitForBuild.test.mjs +1 -0
  173. package/lib/docs/withBrowserSlot.test.mjs +5 -5
  174. package/lib/docs/withDataSession.js +2 -2
  175. package/lib/server/applyDataSetRedirect.js +14 -5
  176. package/lib/server/applyDataSetRedirect.test.mjs +121 -15
  177. package/lib/server/applyDataSetRedirectTenantReach.test.mjs +5 -1
  178. package/lib/server/applyDataSetRedirectWalled.test.mjs +5 -1
  179. package/lib/server/auth/getHeadlessUser.js +6 -0
  180. package/lib/server/auth/getHeadlessUser.test.mjs +13 -2
  181. package/lib/server/auth/resolveHeadlessUser.test.mjs +1 -0
  182. package/lib/server/contextMapBudget.test.mjs +3 -3
  183. package/lib/server/continueJitKeys.test.mjs +1 -0
  184. package/lib/server/createLowdefyContext.js +8 -4
  185. package/lib/server/createLowdefyContext.test.mjs +38 -35
  186. package/lib/server/getClientAddress.test.mjs +2 -2
  187. package/lib/server/getPageJitEnrichment.test.mjs +1 -0
  188. package/lib/server/importAppCode.test.mjs +2 -2
  189. package/lib/server/jitPageBuilder.js +27 -3
  190. package/lib/server/jitPageBuilder.mobileTypes.test.mjs +65 -0
  191. package/lib/server/jitPageBuilder.skipPluginChecks.test.mjs +5 -6
  192. package/lib/server/jitPageBuilder.test.mjs +4 -4
  193. package/lib/server/journeyCookies.test.mjs +1 -0
  194. package/lib/server/loadDynamicJsMap.js +10 -1
  195. package/lib/server/log/createHandleError.js +10 -5
  196. package/lib/server/log/createHandleError.test.mjs +19 -8
  197. package/lib/server/log/createLogger.test.mjs +2 -2
  198. package/lib/server/mutantDataSetWrappers.test.mjs +5 -1
  199. package/lib/server/mutants/listMutants.test.mjs +1 -0
  200. package/lib/server/mutants/mutantRuns.test.mjs +1 -0
  201. package/lib/server/mutants/operators.test.mjs +1 -0
  202. package/lib/server/pageBuildRecords.test.mjs +1 -0
  203. package/lib/server/pageCache.test.mjs +1 -0
  204. package/lib/server/pageRebuilds.test.mjs +3 -3
  205. package/{src/routes/docs/examples.js → lib/server/pairingHeaders.js} +8 -15
  206. package/lib/server/pruneJitMaps.test.mjs +1 -0
  207. package/lib/server/readBuildApiArtifacts.test.mjs +1 -0
  208. package/lib/server/readInstanceRecord.test.mjs +24 -8
  209. package/lib/server/readMergedMaps.test.mjs +1 -0
  210. package/lib/server/recording/errorRecordingStamp.test.mjs +1 -0
  211. package/lib/server/recording/readRecordingCookie.test.mjs +2 -0
  212. package/lib/server/recording/servedBuilds.test.mjs +1 -0
  213. package/lib/server/sinkExternalConnections.test.mjs +6 -6
  214. package/lib/server/skipStaleMapWrites.test.mjs +12 -12
  215. package/lib/server/startIdleGc.test.mjs +25 -9
  216. package/lib/server/testFixtures/importAppCodeTwice.mjs +2 -2
  217. package/lib/vite/createDevServerExclude.test.mjs +1 -0
  218. package/manager/getContext.mjs +11 -2
  219. package/manager/processes/checkPendingPlugins.mjs +49 -0
  220. package/manager/processes/checkPendingPlugins.test.mjs +107 -0
  221. package/manager/processes/createIdleChild.mjs +141 -0
  222. package/manager/processes/createIdleChild.test.mjs +209 -0
  223. package/manager/processes/initialBuild.mjs +4 -15
  224. package/manager/processes/initialBuild.test.mjs +8 -37
  225. package/manager/processes/lowdefyBuild.mjs +11 -7
  226. package/manager/processes/lowdefyBuild.skipPluginChecks.test.mjs +23 -13
  227. package/manager/processes/lowdefyBuild.test.mjs +17 -15
  228. package/manager/processes/restartServer.test.mjs +63 -15
  229. package/manager/processes/shutdownServer.test.mjs +3 -3
  230. package/manager/processes/startFirstServer.test.mjs +23 -22
  231. package/manager/processes/startMailSink.mjs +11 -3
  232. package/manager/processes/startMailSink.test.mjs +28 -2
  233. package/manager/processes/startProxy.mjs +158 -27
  234. package/manager/processes/startProxy.pairing.test.mjs +204 -0
  235. package/manager/processes/startProxy.test.mjs +127 -2
  236. package/manager/processes/startServer.mjs +5 -7
  237. package/manager/processes/startServer.test.mjs +10 -9
  238. package/manager/processes/syncServer.mjs +31 -4
  239. package/manager/processes/syncServer.test.mjs +71 -6
  240. package/manager/processes/waitForDevServer.test.mjs +21 -6
  241. package/manager/run.mjs +32 -8
  242. package/manager/utils/BatchChanges.mjs +1 -1
  243. package/manager/utils/BatchChanges.test.mjs +4 -4
  244. package/manager/utils/acquireDevInstance.test.mjs +1 -0
  245. package/manager/utils/checkPairing.mjs +45 -0
  246. package/manager/utils/checkPairing.test.mjs +53 -0
  247. package/manager/utils/createBuildActivity.mjs +5 -1
  248. package/manager/utils/createBuildActivity.test.mjs +2 -2
  249. package/manager/utils/createChangeSignal.test.mjs +5 -5
  250. package/manager/utils/createCustomPluginMessagesMap.mjs +8 -3
  251. package/manager/utils/createCustomPluginTypesMap.mjs +48 -12
  252. package/manager/utils/createCustomPluginTypesMap.test.mjs +181 -19
  253. package/manager/utils/createDotPathIgnore.test.mjs +1 -0
  254. package/manager/utils/createGlobIgnore.mjs +45 -0
  255. package/manager/utils/createGlobIgnore.test.mjs +58 -0
  256. package/manager/utils/createGlobWatchPaths.mjs +75 -0
  257. package/manager/utils/createGlobWatchPaths.test.mjs +67 -0
  258. package/manager/utils/createIdleGc.test.mjs +31 -15
  259. package/manager/utils/createLanPairing.mjs +34 -0
  260. package/manager/utils/createLanPairing.test.mjs +46 -0
  261. package/manager/utils/createRequestActivity.mjs +30 -3
  262. package/manager/utils/createRequestActivity.test.mjs +76 -22
  263. package/manager/utils/createServerArtifactTracker.mjs +1 -0
  264. package/manager/utils/createServerArtifactTracker.test.mjs +1 -0
  265. package/manager/utils/findBuildFilesOutsideWatch.test.mjs +1 -0
  266. package/{client/recorder/collectEventActions.js → manager/utils/findSignInCode.mjs} +13 -10
  267. package/manager/utils/findSignInCode.test.mjs +33 -0
  268. package/manager/utils/formatLanPairing.mjs +32 -0
  269. package/manager/utils/formatLanPairing.test.mjs +40 -0
  270. package/manager/utils/getLanAddress.mjs +83 -0
  271. package/manager/utils/getLanAddress.test.mjs +70 -0
  272. package/manager/utils/importFresh.test.mjs +1 -0
  273. package/{src/routes/docs/icons.js → manager/utils/isLoopbackAddress.mjs} +11 -10
  274. package/manager/utils/pluginTypeCache.mjs +100 -0
  275. package/manager/utils/pluginTypeCache.test.mjs +141 -0
  276. package/manager/utils/pruneRecordings.test.mjs +1 -0
  277. package/manager/utils/publishBuildDirectory.order.test.mjs +2 -2
  278. package/manager/utils/publishBuildDirectory.test.mjs +6 -7
  279. package/manager/utils/readBasePath.test.mjs +1 -0
  280. package/manager/utils/readManagerVersion.test.mjs +1 -0
  281. package/manager/utils/readPluginDefinitions.mjs +6 -6
  282. package/manager/utils/renderTerminalQr.mjs +54 -0
  283. package/manager/utils/resolveDevAuthUrl.test.mjs +1 -0
  284. package/manager/utils/setupWatcher.mjs +19 -4
  285. package/manager/utils/startRecordingPruner.test.mjs +24 -8
  286. package/manager/utils/waitForChildExit.test.mjs +2 -2
  287. package/manager/utils/writeBuildStatus.test.mjs +1 -0
  288. package/manager/watchers/envWatcher.mjs +3 -0
  289. package/manager/watchers/envWatcher.test.mjs +19 -7
  290. package/manager/watchers/listServerPluginFiles.mjs +188 -0
  291. package/manager/watchers/listServerPluginFiles.test.mjs +257 -0
  292. package/manager/watchers/lowdefyBuildWatcher.mjs +5 -0
  293. package/manager/watchers/lowdefyBuildWatcher.test.mjs +63 -10
  294. package/manager/watchers/pluginSourceWatcher.mjs +45 -17
  295. package/manager/watchers/pluginSourceWatcher.test.mjs +97 -21
  296. package/manager/watchers/resolveFile.mjs +46 -0
  297. package/manager/watchers/resolveFile.test.mjs +67 -0
  298. package/manager/watchers/resolvePackageSpecifier.mjs +127 -0
  299. package/manager/watchers/resolvePackageSpecifier.test.mjs +151 -0
  300. package/manager/watchers/restartRequestWatcher.mjs +7 -4
  301. package/manager/watchers/restartRequestWatcher.test.mjs +43 -6
  302. package/manager/watchers/selectLocalPluginPackages.test.mjs +1 -0
  303. package/package.json +50 -49
  304. package/package.original.json +50 -49
  305. package/src/app.js +83 -85
  306. package/src/html/renderDevPage.test.mjs +1 -0
  307. package/src/lib/getPathSegments.js +16 -1
  308. package/src/{routes/docs/checkpointsList.js → lib/getRequestSurface.js} +6 -4
  309. package/src/lib/isTabAnswer.js +32 -0
  310. package/src/lib/isTabChannelCaller.js +35 -0
  311. package/src/middleware/apiContext.js +4 -2
  312. package/src/middleware/createSameOriginGuard.test.mjs +1 -0
  313. package/src/middleware/errorHandler.js +33 -45
  314. package/src/middleware/errorHandler.test.mjs +10 -10
  315. package/src/middleware/isRebindingSafeHost.test.mjs +1 -0
  316. package/src/middleware/localDevToolsOnly.js +13 -1
  317. package/src/middleware/localDevToolsOnly.test.mjs +36 -2
  318. package/src/middleware/noStore.test.mjs +1 -0
  319. package/src/middleware/staleFlag.test.mjs +1 -0
  320. package/src/middleware/stampCaller.test.mjs +1 -0
  321. package/src/routes/agentBearer.test.mjs +183 -0
  322. package/src/routes/auth.test.mjs +10 -10
  323. package/src/routes/clientError.js +21 -4
  324. package/src/routes/clientError.test.mjs +127 -0
  325. package/src/routes/devInspect.js +6 -51
  326. package/src/routes/devInspect.test.mjs +128 -3
  327. package/src/routes/devRecording.js +6 -17
  328. package/src/routes/devRecording.test.mjs +54 -3
  329. package/src/routes/docs/buildStatus.test.mjs +6 -6
  330. package/src/routes/docs/events.test.mjs +4 -4
  331. package/src/routes/docs/find.js +3 -3
  332. package/src/routes/docs/journey.test.mjs +8 -8
  333. package/src/routes/docs/journeyRefusals.test.mjs +9 -9
  334. package/src/routes/docs/loadDocsRoutes.js +70 -0
  335. package/src/routes/docs/loadDocsRoutes.test.mjs +110 -0
  336. package/src/routes/docs/mcp.test.mjs +5 -5
  337. package/src/routes/docs/mutants.js +7 -0
  338. package/src/routes/docs/mutants.test.mjs +20 -6
  339. package/src/routes/docs/parsePathParamsParam.test.mjs +1 -0
  340. package/src/routes/docs/parseUserParam.test.mjs +1 -0
  341. package/src/routes/docs/restart.test.mjs +1 -0
  342. package/src/routes/endpoints.js +24 -0
  343. package/src/routes/endpointsLink.test.mjs +111 -0
  344. package/src/routes/endpointsTextAnswer.test.mjs +8 -8
  345. package/src/routes/jitPage.js +13 -1
  346. package/src/routes/jitPage.test.mjs +36 -11
  347. package/src/routes/mcp.js +6 -0
  348. package/src/routes/mcp.test.mjs +23 -8
  349. package/src/routes/mcpMemberToken.test.mjs +8 -8
  350. package/src/routes/mcpProtectedResourceMetadata.test.mjs +2 -2
  351. package/src/routes/{docs/checkpointsRevert.js → mobileRoot.js} +10 -13
  352. package/src/routes/mobileRoutes.test.mjs +223 -0
  353. package/src/routes/mobileSignIn.js +58 -0
  354. package/src/routes/mobileSignIn.test.mjs +59 -0
  355. package/src/routes/mobileSignInCallback.js +34 -0
  356. package/src/routes/mobileSignInCallback.test.mjs +51 -0
  357. package/src/routes/mountDevPageRoutes.js +10 -2
  358. package/src/routes/mountDevPageRoutes.test.mjs +25 -1
  359. package/src/routes/mountMobileWellKnown.js +35 -0
  360. package/src/routes/mountMobileWellKnown.test.mjs +79 -0
  361. package/src/routes/mountOauthDiscovery.test.mjs +5 -5
  362. package/src/routes/normalizeMcpProtocolVersionHeader.test.mjs +1 -0
  363. package/src/routes/reload.js +101 -20
  364. package/src/routes/reload.test.mjs +153 -0
  365. package/src/routes/request.js +1 -22
  366. package/src/routes/request.test.mjs +7 -24
  367. package/src/routes/requestBody.test.mjs +14 -27
  368. package/src/routes/websocket.test.mjs +2 -2
  369. package/src/routes/wellKnownFallback.test.mjs +2 -2
  370. package/src/websocket/devWebSocket.test.mjs +12 -12
  371. package/vite.config.js +13 -1
  372. package/client/feedback/FeedbackMount.jsx +0 -83
  373. package/client/feedback/FeedbackOverlay.jsx +0 -904
  374. package/client/feedback/captureTabScreenshot.js +0 -84
  375. package/client/feedback/copyToClipboard.js +0 -45
  376. package/client/feedback/drawAnnotationsSvg.js +0 -119
  377. package/client/feedback/feedbackStyles.js +0 -304
  378. package/client/feedback/pinResponsiveImages.js +0 -59
  379. package/client/feedback/sendFeedback.js +0 -39
  380. package/client/feedback/useFeedbackToggle.js +0 -70
  381. package/client/recorder/buildEngineRecord.js +0 -37
  382. package/client/recorder/buildInteractionRecord.js +0 -64
  383. package/client/recorder/buildTraceEvent.js +0 -57
  384. package/client/recorder/buildTraceEvent.test.mjs +0 -81
  385. package/client/recorder/chunkRecords.js +0 -69
  386. package/client/recorder/chunkRecords.test.mjs +0 -59
  387. package/client/recorder/collectEventEndpoints.js +0 -40
  388. package/client/recorder/collectEventRequests.js +0 -39
  389. package/client/recorder/createPairingBuffer.js +0 -187
  390. package/client/recorder/createPasswordRedactor.js +0 -84
  391. package/client/recorder/createRecordBatcher.js +0 -54
  392. package/client/recorder/createRecordBatcher.test.mjs +0 -76
  393. package/client/recorder/createRecordingSession.js +0 -61
  394. package/client/recorder/createRecordingSession.test.mjs +0 -72
  395. package/client/recorder/diffStateWrites.js +0 -77
  396. package/client/recorder/diffStateWrites.test.mjs +0 -66
  397. package/client/recorder/isEventCall.js +0 -30
  398. package/client/recorder/jsonType.js +0 -39
  399. package/client/recorder/sendRecords.js +0 -40
  400. package/lib/docs/captureAnnotatedScreenshot.js +0 -99
  401. package/lib/docs/checkpointPaths.js +0 -91
  402. package/lib/docs/checkpointStore.js +0 -243
  403. package/lib/docs/checkpointToMocks.js +0 -65
  404. package/lib/docs/configCheckpoints.test.mjs +0 -156
  405. package/lib/docs/createConfigCheckpoint.js +0 -92
  406. package/lib/docs/dataSets/findCollectionCollisions.js +0 -52
  407. package/lib/docs/devMockRegistry.js +0 -68
  408. package/lib/docs/enrichFeedback.js +0 -71
  409. package/lib/docs/evalOperator.js +0 -49
  410. package/lib/docs/evalOperator.test.mjs +0 -157
  411. package/lib/docs/evalOperatorHeadless.js +0 -159
  412. package/lib/docs/evalOperatorHeadless.test.mjs +0 -78
  413. package/lib/docs/evalOperatorInTab.js +0 -49
  414. package/lib/docs/formatFeedback.js +0 -142
  415. package/lib/docs/formatFeedback.test.mjs +0 -252
  416. package/lib/docs/getPluginDoc.js +0 -53
  417. package/lib/docs/listConfigCheckpoints.js +0 -55
  418. package/lib/docs/loadState.js +0 -220
  419. package/lib/docs/revertConfigCheckpoint.js +0 -73
  420. package/lib/docs/saveAnnotatedScreenshot.js +0 -43
  421. package/lib/docs/scaffoldPage.js +0 -77
  422. package/lib/docs/scaffoldPage.test.mjs +0 -97
  423. package/lib/docs/snapshotState.js +0 -67
  424. package/lib/docs/stateCheckpoints.test.mjs +0 -443
  425. package/manager/watchers/listServerSidePackages.mjs +0 -47
  426. package/manager/watchers/listServerSidePackages.test.mjs +0 -38
  427. package/src/routes/docs/checkpointsCreate.js +0 -28
  428. package/src/routes/docs/evalOperator.js +0 -70
  429. package/src/routes/docs/inspectState.js +0 -59
  430. package/src/routes/docs/loadState.js +0 -51
  431. package/src/routes/docs/pluginDoc.js +0 -33
  432. package/src/routes/docs/plugins.js +0 -23
  433. package/src/routes/docs/runEndpoint.js +0 -54
  434. package/src/routes/docs/runEndpoint.test.mjs +0 -165
  435. package/src/routes/docs/runRequest.js +0 -53
  436. package/src/routes/docs/runRequest.test.mjs +0 -92
  437. package/src/routes/docs/schema.js +0 -37
  438. package/src/routes/docs/screenshot.js +0 -120
  439. package/src/routes/docs/screenshot.test.mjs +0 -117
  440. package/src/routes/docs/search.js +0 -40
  441. package/src/routes/docs/snapshotState.js +0 -50
  442. package/src/routes/docs/stateCheckpointsList.js +0 -26
  443. package/src/routes/docs/types.js +0 -33
  444. package/src/routes/feedback.js +0 -107
  445. 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 listServerSidePackages from './listServerSidePackages.mjs';
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, so any change rebuilds - which also
33
- // clears a build a broken plugin failed. The server process caches the
34
- // modules of server-side types (requests, connections, operators, ...), so a
35
- // change to a plugin that has them also restarts the server; client code
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({ restart });
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 { jest } from '@jest/globals';
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
- jest.setTimeout(180000);
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: jest.fn() },
72
+ buildActivity: { setBusy: vi.fn() },
75
73
  directories: { build: path.join(server, 'build'), config, server },
76
- logger: { info: jest.fn(), warn: jest.fn(), error: jest.fn() },
77
- lowdefyBuild: jest.fn(async () => {}),
78
- reloadClients: jest.fn(async () => {}),
79
- syncServer: jest.fn(async () => {}),
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', 'requests', 'src/find.js', true],
100
- ['a block-only plugin rebuilds without a restart', 'blocks', 'src/Fancy.js', false],
101
- ['a plugin imported from its build output rebuilds', 'blocks', 'dist/Fancy.js', false],
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
- fs.writeFileSync(path.join(dir, file), 'export default 1;');
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
- fs.writeFileSync(path.join(dir, file), 'export default 2;');
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
+ });