@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.
Files changed (432) 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/dataSetJourneys.chromium.mongodb.test.mjs +6 -6
  44. package/lib/docs/dataSets/drainSessionWork.test.mjs +21 -5
  45. package/lib/docs/dataSets/getDataStore.js +11 -3
  46. package/lib/docs/dataSets/getDataStore.mongodb.test.mjs +3 -3
  47. package/lib/docs/dataSets/getDataStore.test.mjs +32 -20
  48. package/lib/docs/dataSets/mergeCollectionIndexes.test.mjs +1 -0
  49. package/lib/docs/dataSets/openDataSession.js +4 -2
  50. package/lib/docs/dataSets/openDataSession.mongodb.test.mjs +25 -7
  51. package/lib/docs/dataSets/pickDataStorePort.test.mjs +2 -2
  52. package/lib/docs/dataSets/readDataSession.test.mjs +1 -0
  53. package/lib/docs/dataSets/readDataSet.test.mjs +1 -0
  54. package/lib/docs/dataSets/resolveJourneyDataSet.test.mjs +1 -0
  55. package/lib/docs/dataSets/test/buildTestApp.mjs +1 -1
  56. package/lib/docs/devEventBus.js +7 -2
  57. package/lib/docs/devEventBus.test.mjs +12 -10
  58. package/lib/docs/devToolDefinitions.js +87 -135
  59. package/lib/docs/device/buildDeviceCommand.js +103 -0
  60. package/lib/docs/device/buildDeviceCommand.test.mjs +142 -0
  61. package/lib/docs/device/captureDevice.js +85 -0
  62. package/lib/docs/device/checkShownPage.js +56 -0
  63. package/lib/docs/device/createFakePhoneTab.mjs +77 -0
  64. package/lib/docs/device/deviceAction.js +74 -0
  65. package/lib/docs/device/deviceTools.test.mjs +604 -0
  66. package/lib/docs/device/findDeviceTab.js +50 -0
  67. package/lib/docs/device/findDeviceTarget.js +73 -0
  68. package/lib/docs/device/injectDevice.js +160 -0
  69. package/lib/docs/device/listDevices.js +100 -0
  70. package/lib/docs/device/listDevices.test.mjs +105 -0
  71. package/lib/docs/device/runDeviceJourney.js +68 -0
  72. package/lib/docs/device/runDeviceSteps.js +164 -0
  73. package/lib/docs/device/screenshotDevice.js +68 -0
  74. package/lib/docs/device/sendDeviceStep.js +52 -0
  75. package/lib/docs/device/startDevice.js +150 -0
  76. package/lib/docs/docs.test.mjs +44 -28
  77. package/lib/docs/docsIndex.test.mjs +1 -0
  78. package/lib/docs/findConfig.js +3 -4
  79. package/lib/docs/findPageBlock.js +35 -0
  80. package/lib/docs/findPageBlock.test.mjs +45 -0
  81. package/lib/docs/fitResponse.js +18 -17
  82. package/lib/docs/fitResponse.test.mjs +18 -0
  83. package/lib/docs/getBrowser.js +3 -3
  84. package/lib/docs/getBrowser.test.mjs +32 -16
  85. package/lib/docs/getBuildId.test.mjs +1 -0
  86. package/lib/docs/getBuildStatus.test.mjs +11 -11
  87. package/lib/docs/getBuildStatusAfterEdits.test.mjs +8 -8
  88. package/{src/routes/docs/appMap.js → lib/docs/getConfigDirectory.js} +3 -5
  89. package/lib/docs/getHazards.js +4 -1
  90. package/lib/docs/getHazards.test.mjs +9 -7
  91. package/lib/docs/getOverview.js +20 -42
  92. package/lib/docs/getOverviewBasePath.test.mjs +1 -0
  93. package/lib/docs/getStaleStatus.test.mjs +1 -0
  94. package/lib/docs/inspectState.js +78 -3
  95. package/lib/docs/inspectState.test.mjs +61 -9
  96. package/lib/docs/inspectStateFromTab.js +38 -6
  97. package/lib/docs/inspectStateFromTab.test.mjs +79 -0
  98. package/lib/docs/inspectStateHeadless.js +98 -34
  99. package/lib/docs/inspectStateHeadless.test.mjs +17 -5
  100. package/lib/docs/installHeadlessShell.failure.test.mjs +9 -5
  101. package/lib/docs/installHeadlessShell.js +5 -2
  102. package/lib/docs/installHeadlessShell.test.mjs +8 -5
  103. package/lib/docs/installHeadlessShell.timeout.test.mjs +32 -12
  104. package/lib/docs/isDeepEqual.js +37 -0
  105. package/lib/docs/isHeadlessShellIncomplete.test.mjs +1 -0
  106. package/lib/docs/isPageReady.test.mjs +1 -0
  107. package/lib/docs/journeyMutantCookie.chromium.test.mjs +3 -3
  108. package/lib/docs/journeyRunRecording.test.mjs +1 -0
  109. package/lib/docs/keepEventStreamAlive.test.mjs +1 -0
  110. package/lib/docs/launchBrowser.test.mjs +8 -8
  111. package/lib/docs/listTypes.js +58 -8
  112. package/lib/docs/loadFrameworkHazards.test.mjs +1 -0
  113. package/lib/docs/matchJourneyRoute.test.mjs +1 -0
  114. package/lib/docs/observe/createJourneyAppErrors.test.mjs +3 -3
  115. package/lib/docs/observe/evaluateInvariants.test.mjs +1 -0
  116. package/lib/docs/observe/hasNoEffect.test.mjs +1 -0
  117. package/lib/docs/observe/withAppErrors.test.mjs +1 -0
  118. package/lib/docs/openJourneyEmail.test.mjs +6 -6
  119. package/lib/docs/pageBuildStatus.test.mjs +6 -6
  120. package/lib/docs/pollTab.js +100 -0
  121. package/lib/docs/pollTab.test.mjs +64 -0
  122. package/lib/docs/rails/authEngineActions.test.mjs +1 -0
  123. package/lib/docs/rails/authEngineMethods.test.mjs +2 -1
  124. package/lib/docs/rails/checkAuthActionsRan.test.mjs +5 -5
  125. package/lib/docs/rails/createDataSetRails.test.mjs +1 -0
  126. package/lib/docs/rails/findExternalBlocks.test.mjs +1 -0
  127. package/lib/docs/readJourneyEmailMatch.test.mjs +2 -2
  128. package/lib/docs/readJourneySession.js +1 -1
  129. package/lib/docs/reportDevToolFault.js +29 -0
  130. package/lib/docs/reportDevToolFault.test.mjs +34 -0
  131. package/lib/docs/requestRestart.test.mjs +1 -0
  132. package/lib/docs/resolvePageInstance.test.mjs +1 -0
  133. package/lib/docs/resolveSource.js +2 -2
  134. package/lib/docs/resolveSource.test.mjs +6 -6
  135. package/lib/docs/reviewPageBuilds.test.mjs +2 -2
  136. package/lib/docs/runCheck.test.mjs +3 -3
  137. package/lib/docs/runCheckChild.js +2 -1
  138. package/lib/docs/runEndpoint.js +23 -10
  139. package/lib/docs/runEndpoint.test.mjs +42 -37
  140. package/lib/docs/runErrorBuffers.test.mjs +1 -0
  141. package/lib/docs/runJourney.js +21 -1
  142. package/lib/docs/runJourney.test.mjs +119 -99
  143. package/lib/docs/runJourneyDataSet.test.mjs +25 -25
  144. package/lib/docs/runJourneySteps.js +8 -29
  145. package/lib/docs/runRequest.js +6 -6
  146. package/lib/docs/runRequest.test.mjs +22 -22
  147. package/lib/docs/screenshotPage.js +6 -7
  148. package/lib/docs/screenshotPage.test.mjs +46 -46
  149. package/lib/docs/screenshotPageClip.test.mjs +10 -10
  150. package/lib/docs/searchDocs.test.mjs +1 -0
  151. package/lib/docs/searchIcons.test.mjs +5 -5
  152. package/lib/docs/selectFinalState.test.mjs +1 -0
  153. package/lib/docs/serverErrorStore.test.mjs +4 -4
  154. package/lib/docs/setupTestFixtures.mjs +25 -0
  155. package/lib/docs/splitSearchTerms.test.mjs +1 -0
  156. package/lib/docs/tabAvailable.js +1 -1
  157. package/lib/docs/tabChannel.js +90 -14
  158. package/lib/docs/tabChannel.test.mjs +40 -15
  159. package/lib/docs/validateJourneyTimeout.test.mjs +1 -0
  160. package/lib/docs/validateStateSelection.test.mjs +1 -0
  161. package/lib/docs/validateViewport.test.mjs +1 -0
  162. package/lib/docs/waitForBuild.test.mjs +1 -0
  163. package/lib/docs/withBrowserSlot.test.mjs +5 -5
  164. package/lib/server/applyDataSetRedirect.test.mjs +2 -2
  165. package/lib/server/applyDataSetRedirectTenantReach.test.mjs +1 -0
  166. package/lib/server/applyDataSetRedirectWalled.test.mjs +1 -0
  167. package/lib/server/auth/getHeadlessUser.js +6 -0
  168. package/lib/server/auth/getHeadlessUser.test.mjs +13 -2
  169. package/lib/server/auth/resolveHeadlessUser.test.mjs +1 -0
  170. package/lib/server/contextMapBudget.test.mjs +3 -3
  171. package/lib/server/continueJitKeys.test.mjs +1 -0
  172. package/lib/server/createLowdefyContext.js +5 -1
  173. package/lib/server/createLowdefyContext.test.mjs +32 -32
  174. package/lib/server/getClientAddress.test.mjs +2 -2
  175. package/lib/server/getPageJitEnrichment.test.mjs +1 -0
  176. package/lib/server/importAppCode.test.mjs +2 -2
  177. package/lib/server/jitPageBuilder.js +27 -3
  178. package/lib/server/jitPageBuilder.mobileTypes.test.mjs +65 -0
  179. package/lib/server/jitPageBuilder.skipPluginChecks.test.mjs +5 -6
  180. package/lib/server/jitPageBuilder.test.mjs +4 -4
  181. package/lib/server/journeyCookies.test.mjs +1 -0
  182. package/lib/server/loadDynamicJsMap.js +10 -1
  183. package/lib/server/log/createHandleError.js +10 -5
  184. package/lib/server/log/createHandleError.test.mjs +19 -8
  185. package/lib/server/log/createLogger.test.mjs +2 -2
  186. package/lib/server/mutantDataSetWrappers.test.mjs +1 -0
  187. package/lib/server/mutants/listMutants.test.mjs +1 -0
  188. package/lib/server/mutants/mutantRuns.test.mjs +1 -0
  189. package/lib/server/mutants/operators.test.mjs +1 -0
  190. package/lib/server/pageBuildRecords.test.mjs +1 -0
  191. package/lib/server/pageCache.test.mjs +1 -0
  192. package/lib/server/pageRebuilds.test.mjs +3 -3
  193. package/{src/routes/docs/examples.js → lib/server/pairingHeaders.js} +8 -15
  194. package/lib/server/pruneJitMaps.test.mjs +1 -0
  195. package/lib/server/readBuildApiArtifacts.test.mjs +1 -0
  196. package/lib/server/readInstanceRecord.test.mjs +24 -8
  197. package/lib/server/readMergedMaps.test.mjs +1 -0
  198. package/lib/server/recording/errorRecordingStamp.test.mjs +1 -0
  199. package/lib/server/recording/readRecordingCookie.test.mjs +2 -0
  200. package/lib/server/recording/servedBuilds.test.mjs +1 -0
  201. package/lib/server/sinkExternalConnections.test.mjs +6 -6
  202. package/lib/server/skipStaleMapWrites.test.mjs +12 -12
  203. package/lib/server/startIdleGc.test.mjs +25 -9
  204. package/lib/server/testFixtures/importAppCodeTwice.mjs +2 -2
  205. package/lib/vite/createDevServerExclude.test.mjs +1 -0
  206. package/manager/getContext.mjs +9 -0
  207. package/manager/processes/checkPendingPlugins.mjs +49 -0
  208. package/manager/processes/checkPendingPlugins.test.mjs +107 -0
  209. package/manager/processes/createIdleChild.mjs +141 -0
  210. package/manager/processes/createIdleChild.test.mjs +209 -0
  211. package/manager/processes/initialBuild.mjs +2 -15
  212. package/manager/processes/initialBuild.test.mjs +8 -40
  213. package/manager/processes/lowdefyBuild.mjs +7 -4
  214. package/manager/processes/lowdefyBuild.skipPluginChecks.test.mjs +13 -13
  215. package/manager/processes/lowdefyBuild.test.mjs +17 -15
  216. package/manager/processes/restartServer.test.mjs +63 -15
  217. package/manager/processes/shutdownServer.test.mjs +3 -3
  218. package/manager/processes/startFirstServer.test.mjs +23 -22
  219. package/manager/processes/startMailSink.mjs +11 -3
  220. package/manager/processes/startMailSink.test.mjs +28 -2
  221. package/manager/processes/startProxy.mjs +158 -27
  222. package/manager/processes/startProxy.pairing.test.mjs +204 -0
  223. package/manager/processes/startProxy.test.mjs +127 -2
  224. package/manager/processes/startServer.mjs +5 -7
  225. package/manager/processes/startServer.test.mjs +10 -9
  226. package/manager/processes/syncServer.mjs +31 -4
  227. package/manager/processes/syncServer.test.mjs +71 -6
  228. package/manager/processes/waitForDevServer.test.mjs +21 -6
  229. package/manager/run.mjs +32 -8
  230. package/manager/utils/BatchChanges.mjs +1 -1
  231. package/manager/utils/BatchChanges.test.mjs +4 -4
  232. package/manager/utils/acquireDevInstance.test.mjs +1 -0
  233. package/manager/utils/checkPairing.mjs +45 -0
  234. package/manager/utils/checkPairing.test.mjs +53 -0
  235. package/manager/utils/createBuildActivity.mjs +5 -1
  236. package/manager/utils/createBuildActivity.test.mjs +2 -2
  237. package/manager/utils/createChangeSignal.test.mjs +5 -5
  238. package/manager/utils/createCustomPluginMessagesMap.mjs +8 -3
  239. package/manager/utils/createCustomPluginTypesMap.mjs +48 -12
  240. package/manager/utils/createCustomPluginTypesMap.test.mjs +181 -19
  241. package/manager/utils/createDotPathIgnore.test.mjs +1 -0
  242. package/manager/utils/createGlobIgnore.mjs +45 -0
  243. package/manager/utils/createGlobIgnore.test.mjs +58 -0
  244. package/manager/utils/createGlobWatchPaths.mjs +75 -0
  245. package/manager/utils/createGlobWatchPaths.test.mjs +67 -0
  246. package/manager/utils/createIdleGc.test.mjs +31 -15
  247. package/{src/routes/docs/content.js → manager/utils/createLanPairing.mjs} +14 -13
  248. package/manager/utils/createLanPairing.test.mjs +46 -0
  249. package/manager/utils/createRequestActivity.mjs +30 -3
  250. package/manager/utils/createRequestActivity.test.mjs +76 -22
  251. package/manager/utils/createServerArtifactTracker.mjs +1 -0
  252. package/manager/utils/createServerArtifactTracker.test.mjs +1 -0
  253. package/manager/utils/findBuildFilesOutsideWatch.test.mjs +1 -0
  254. package/{client/recorder/collectEventActions.js → manager/utils/findSignInCode.mjs} +13 -10
  255. package/manager/utils/findSignInCode.test.mjs +33 -0
  256. package/manager/utils/formatLanPairing.mjs +32 -0
  257. package/manager/utils/formatLanPairing.test.mjs +40 -0
  258. package/manager/utils/getLanAddress.mjs +83 -0
  259. package/manager/utils/getLanAddress.test.mjs +70 -0
  260. package/manager/utils/importFresh.test.mjs +1 -0
  261. package/{src/routes/docs/icons.js → manager/utils/isLoopbackAddress.mjs} +11 -10
  262. package/manager/utils/pluginTypeCache.mjs +100 -0
  263. package/manager/utils/pluginTypeCache.test.mjs +141 -0
  264. package/manager/utils/pruneRecordings.test.mjs +1 -0
  265. package/manager/utils/publishBuildDirectory.order.test.mjs +2 -2
  266. package/manager/utils/publishBuildDirectory.test.mjs +6 -7
  267. package/manager/utils/readBasePath.test.mjs +1 -0
  268. package/manager/utils/readManagerVersion.test.mjs +1 -0
  269. package/manager/utils/readPluginDefinitions.mjs +6 -6
  270. package/manager/utils/renderTerminalQr.mjs +54 -0
  271. package/manager/utils/resolveDevAuthUrl.test.mjs +1 -0
  272. package/manager/utils/setupWatcher.mjs +19 -4
  273. package/manager/utils/startRecordingPruner.test.mjs +24 -8
  274. package/manager/utils/waitForChildExit.test.mjs +2 -2
  275. package/manager/utils/writeBuildStatus.test.mjs +1 -0
  276. package/manager/watchers/envWatcher.mjs +3 -0
  277. package/manager/watchers/envWatcher.test.mjs +19 -7
  278. package/manager/watchers/listServerPluginFiles.mjs +188 -0
  279. package/manager/watchers/listServerPluginFiles.test.mjs +257 -0
  280. package/manager/watchers/lowdefyBuildWatcher.mjs +5 -0
  281. package/manager/watchers/lowdefyBuildWatcher.test.mjs +63 -10
  282. package/manager/watchers/pluginSourceWatcher.mjs +45 -17
  283. package/manager/watchers/pluginSourceWatcher.test.mjs +97 -21
  284. package/manager/watchers/resolveFile.mjs +46 -0
  285. package/manager/watchers/resolveFile.test.mjs +67 -0
  286. package/manager/watchers/resolvePackageSpecifier.mjs +127 -0
  287. package/manager/watchers/resolvePackageSpecifier.test.mjs +151 -0
  288. package/manager/watchers/restartRequestWatcher.mjs +7 -4
  289. package/manager/watchers/restartRequestWatcher.test.mjs +43 -6
  290. package/manager/watchers/selectLocalPluginPackages.test.mjs +1 -0
  291. package/package.json +50 -49
  292. package/package.original.json +50 -49
  293. package/src/app.js +83 -85
  294. package/src/html/renderDevPage.test.mjs +1 -0
  295. package/src/lib/getPathSegments.js +16 -1
  296. package/src/{routes/docs/checkpointsList.js → lib/getRequestSurface.js} +6 -4
  297. package/src/lib/isTabAnswer.js +32 -0
  298. package/src/lib/isTabChannelCaller.js +35 -0
  299. package/src/middleware/apiContext.js +4 -2
  300. package/src/middleware/createSameOriginGuard.test.mjs +1 -0
  301. package/src/middleware/errorHandler.js +33 -45
  302. package/src/middleware/errorHandler.test.mjs +10 -10
  303. package/src/middleware/isRebindingSafeHost.test.mjs +1 -0
  304. package/src/middleware/localDevToolsOnly.js +13 -1
  305. package/src/middleware/localDevToolsOnly.test.mjs +36 -2
  306. package/src/middleware/noStore.test.mjs +1 -0
  307. package/src/middleware/staleFlag.test.mjs +1 -0
  308. package/src/middleware/stampCaller.test.mjs +1 -0
  309. package/src/routes/agentBearer.test.mjs +183 -0
  310. package/src/routes/auth.test.mjs +10 -10
  311. package/src/routes/clientError.js +21 -4
  312. package/src/routes/clientError.test.mjs +127 -0
  313. package/src/routes/devInspect.js +6 -51
  314. package/src/routes/devInspect.test.mjs +128 -3
  315. package/src/routes/devRecording.js +6 -17
  316. package/src/routes/devRecording.test.mjs +54 -3
  317. package/src/routes/docs/buildStatus.test.mjs +6 -6
  318. package/src/routes/docs/events.test.mjs +4 -4
  319. package/src/routes/docs/find.js +3 -3
  320. package/src/routes/docs/journey.test.mjs +8 -8
  321. package/src/routes/docs/journeyRefusals.test.mjs +9 -9
  322. package/src/routes/docs/loadDocsRoutes.js +70 -0
  323. package/src/routes/docs/loadDocsRoutes.test.mjs +110 -0
  324. package/src/routes/docs/mcp.test.mjs +5 -5
  325. package/src/routes/docs/mutants.js +7 -0
  326. package/src/routes/docs/mutants.test.mjs +20 -6
  327. package/src/routes/docs/parsePathParamsParam.test.mjs +1 -0
  328. package/src/routes/docs/parseUserParam.test.mjs +1 -0
  329. package/src/routes/docs/restart.test.mjs +1 -0
  330. package/src/routes/endpoints.js +24 -0
  331. package/src/routes/endpointsLink.test.mjs +111 -0
  332. package/src/routes/endpointsTextAnswer.test.mjs +8 -8
  333. package/src/routes/jitPage.js +13 -1
  334. package/src/routes/jitPage.test.mjs +36 -11
  335. package/src/routes/mcp.js +6 -0
  336. package/src/routes/mcp.test.mjs +23 -8
  337. package/src/routes/mcpMemberToken.test.mjs +8 -8
  338. package/src/routes/mcpProtectedResourceMetadata.test.mjs +2 -2
  339. package/src/routes/{docs/checkpointsRevert.js → mobileRoot.js} +10 -13
  340. package/src/routes/mobileRoutes.test.mjs +223 -0
  341. package/src/routes/mobileSignIn.js +58 -0
  342. package/src/routes/mobileSignIn.test.mjs +59 -0
  343. package/src/routes/mobileSignInCallback.js +34 -0
  344. package/src/routes/mobileSignInCallback.test.mjs +51 -0
  345. package/src/routes/mountDevPageRoutes.js +10 -2
  346. package/src/routes/mountDevPageRoutes.test.mjs +25 -1
  347. package/src/routes/mountMobileWellKnown.js +35 -0
  348. package/src/routes/mountMobileWellKnown.test.mjs +79 -0
  349. package/src/routes/mountOauthDiscovery.test.mjs +5 -5
  350. package/src/routes/normalizeMcpProtocolVersionHeader.test.mjs +1 -0
  351. package/src/routes/reload.js +101 -20
  352. package/src/routes/reload.test.mjs +153 -0
  353. package/src/routes/request.js +1 -22
  354. package/src/routes/request.test.mjs +7 -24
  355. package/src/routes/requestBody.test.mjs +14 -27
  356. package/src/routes/websocket.test.mjs +2 -2
  357. package/src/routes/wellKnownFallback.test.mjs +2 -2
  358. package/src/websocket/devWebSocket.test.mjs +12 -12
  359. package/vite.config.js +13 -1
  360. package/client/feedback/FeedbackMount.jsx +0 -83
  361. package/client/feedback/FeedbackOverlay.jsx +0 -904
  362. package/client/feedback/captureTabScreenshot.js +0 -84
  363. package/client/feedback/copyToClipboard.js +0 -45
  364. package/client/feedback/drawAnnotationsSvg.js +0 -119
  365. package/client/feedback/feedbackStyles.js +0 -304
  366. package/client/feedback/pinResponsiveImages.js +0 -59
  367. package/client/feedback/sendFeedback.js +0 -39
  368. package/client/feedback/useFeedbackToggle.js +0 -70
  369. package/client/recorder/buildEngineRecord.js +0 -37
  370. package/client/recorder/buildInteractionRecord.js +0 -64
  371. package/client/recorder/buildTraceEvent.js +0 -57
  372. package/client/recorder/buildTraceEvent.test.mjs +0 -81
  373. package/client/recorder/chunkRecords.js +0 -69
  374. package/client/recorder/chunkRecords.test.mjs +0 -59
  375. package/client/recorder/collectEventEndpoints.js +0 -40
  376. package/client/recorder/collectEventRequests.js +0 -39
  377. package/client/recorder/createPairingBuffer.js +0 -187
  378. package/client/recorder/createPasswordRedactor.js +0 -84
  379. package/client/recorder/createRecordBatcher.js +0 -54
  380. package/client/recorder/createRecordBatcher.test.mjs +0 -76
  381. package/client/recorder/createRecordingSession.js +0 -61
  382. package/client/recorder/createRecordingSession.test.mjs +0 -72
  383. package/client/recorder/diffStateWrites.js +0 -77
  384. package/client/recorder/diffStateWrites.test.mjs +0 -66
  385. package/client/recorder/isEventCall.js +0 -30
  386. package/client/recorder/jsonType.js +0 -39
  387. package/client/recorder/sendRecords.js +0 -40
  388. package/lib/docs/captureAnnotatedScreenshot.js +0 -99
  389. package/lib/docs/checkpointPaths.js +0 -91
  390. package/lib/docs/checkpointStore.js +0 -243
  391. package/lib/docs/checkpointToMocks.js +0 -65
  392. package/lib/docs/configCheckpoints.test.mjs +0 -156
  393. package/lib/docs/createConfigCheckpoint.js +0 -92
  394. package/lib/docs/devMockRegistry.js +0 -68
  395. package/lib/docs/enrichFeedback.js +0 -71
  396. package/lib/docs/evalOperator.js +0 -49
  397. package/lib/docs/evalOperator.test.mjs +0 -157
  398. package/lib/docs/evalOperatorHeadless.js +0 -159
  399. package/lib/docs/evalOperatorHeadless.test.mjs +0 -78
  400. package/lib/docs/evalOperatorInTab.js +0 -49
  401. package/lib/docs/formatFeedback.js +0 -142
  402. package/lib/docs/formatFeedback.test.mjs +0 -252
  403. package/lib/docs/getPluginDoc.js +0 -53
  404. package/lib/docs/listConfigCheckpoints.js +0 -55
  405. package/lib/docs/loadState.js +0 -220
  406. package/lib/docs/revertConfigCheckpoint.js +0 -73
  407. package/lib/docs/saveAnnotatedScreenshot.js +0 -43
  408. package/lib/docs/scaffoldPage.js +0 -77
  409. package/lib/docs/scaffoldPage.test.mjs +0 -97
  410. package/lib/docs/snapshotState.js +0 -67
  411. package/lib/docs/stateCheckpoints.test.mjs +0 -443
  412. package/manager/watchers/listServerSidePackages.mjs +0 -47
  413. package/manager/watchers/listServerSidePackages.test.mjs +0 -38
  414. package/src/routes/docs/checkpointsCreate.js +0 -28
  415. package/src/routes/docs/evalOperator.js +0 -70
  416. package/src/routes/docs/inspectState.js +0 -59
  417. package/src/routes/docs/loadState.js +0 -51
  418. package/src/routes/docs/pluginDoc.js +0 -33
  419. package/src/routes/docs/plugins.js +0 -23
  420. package/src/routes/docs/runEndpoint.js +0 -54
  421. package/src/routes/docs/runEndpoint.test.mjs +0 -165
  422. package/src/routes/docs/runRequest.js +0 -53
  423. package/src/routes/docs/runRequest.test.mjs +0 -92
  424. package/src/routes/docs/schema.js +0 -37
  425. package/src/routes/docs/screenshot.js +0 -120
  426. package/src/routes/docs/screenshot.test.mjs +0 -117
  427. package/src/routes/docs/search.js +0 -40
  428. package/src/routes/docs/snapshotState.js +0 -50
  429. package/src/routes/docs/stateCheckpointsList.js +0 -26
  430. package/src/routes/docs/types.js +0 -33
  431. package/src/routes/feedback.js +0 -107
  432. package/src/routes/feedback.test.mjs +0 -204
@@ -1,51 +0,0 @@
1
- /*
2
- Copyright 2020-2026 Lowdefy, Inc
3
-
4
- Licensed under the Apache License, Version 2.0 (the "License");
5
- you may not use this file except in compliance with the License.
6
- You may obtain a copy of the License at
7
-
8
- http://www.apache.org/licenses/LICENSE-2.0
9
-
10
- Unless required by applicable law or agreed to in writing, software
11
- distributed under the License is distributed on an "AS IS" BASIS,
12
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
- See the License for the specific language governing permissions and
14
- limitations under the License.
15
- */
16
-
17
- import { parseRequestBody } from '@lowdefy/api';
18
-
19
- import loadState from '../../../lib/docs/loadState.js';
20
- import parseUserParam from './parseUserParam.js';
21
-
22
- // Loads a state checkpoint back into the running app. mode: 'headless'
23
- // (default) drives a headless page and injects state directly for an agent
24
- // to verify; mode: 'registry-only' just loads the recorded requests into
25
- // devMockRegistry and returns a URL for a human to open in a real browser
26
- // tab (client/Inspector.jsx does the state injection there).
27
- async function docsLoadStateHandler(c) {
28
- const body = parseRequestBody({ text: await c.req.text() });
29
- const { name, mode } = body;
30
- // Derived from the incoming request rather than a config value — this is
31
- // the origin an agent can actually reach the dev server on (host/port it
32
- // just connected to), regardless of how the server is bound.
33
- const origin = new URL(c.req.url).origin;
34
-
35
- const { user, error: userError } = parseUserParam({ value: body.user });
36
- if (userError) {
37
- return c.json({ error: userError }, 400);
38
- }
39
-
40
- const result = await loadState({ origin, name, mode, user, data: body.data });
41
- if (result.error) {
42
- // A contradictory call (`user` in 'registry-only' mode) is the caller's
43
- // mistake, not a failed render — 502 would read as "the renderer broke" and
44
- // invite a pointless retry of the same request.
45
- const status = result.invalidInput ? 400 : 502;
46
- return c.json({ error: result.error }, status);
47
- }
48
- return c.json(result);
49
- }
50
-
51
- export default docsLoadStateHandler;
@@ -1,33 +0,0 @@
1
- /*
2
- Copyright 2020-2026 Lowdefy, Inc
3
-
4
- Licensed under the Apache License, Version 2.0 (the "License");
5
- you may not use this file except in compliance with the License.
6
- You may obtain a copy of the License at
7
-
8
- http://www.apache.org/licenses/LICENSE-2.0
9
-
10
- Unless required by applicable law or agreed to in writing, software
11
- distributed under the License is distributed on an "AS IS" BASIS,
12
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
- See the License for the specific language governing permissions and
14
- limitations under the License.
15
- */
16
-
17
- import getPluginDoc from '../../../lib/docs/getPluginDoc.js';
18
-
19
- function docsPluginDocHandler(c) {
20
- const packageName = c.req.param('package');
21
- const doc = getPluginDoc({ packageName });
22
- if (doc === null) {
23
- return c.json(
24
- {
25
- error: `Package "${packageName}" ships no markdown docs. See GET /lowdefy-docs/plugins for its types.`,
26
- },
27
- 404
28
- );
29
- }
30
- return c.text(doc.markdown, 200, { 'Content-Type': 'text/markdown; charset=utf-8' });
31
- }
32
-
33
- export default docsPluginDocHandler;
@@ -1,23 +0,0 @@
1
- /*
2
- Copyright 2020-2026 Lowdefy, Inc
3
-
4
- Licensed under the Apache License, Version 2.0 (the "License");
5
- you may not use this file except in compliance with the License.
6
- You may obtain a copy of the License at
7
-
8
- http://www.apache.org/licenses/LICENSE-2.0
9
-
10
- Unless required by applicable law or agreed to in writing, software
11
- distributed under the License is distributed on an "AS IS" BASIS,
12
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
- See the License for the specific language governing permissions and
14
- limitations under the License.
15
- */
16
-
17
- import listPlugins from '../../../lib/docs/listPlugins.js';
18
-
19
- function docsPluginsHandler(c) {
20
- return c.json(listPlugins());
21
- }
22
-
23
- export default docsPluginsHandler;
@@ -1,54 +0,0 @@
1
- /*
2
- Copyright 2020-2026 Lowdefy, Inc
3
-
4
- Licensed under the Apache License, Version 2.0 (the "License");
5
- you may not use this file except in compliance with the License.
6
- You may obtain a copy of the License at
7
-
8
- http://www.apache.org/licenses/LICENSE-2.0
9
-
10
- Unless required by applicable law or agreed to in writing, software
11
- distributed under the License is distributed on an "AS IS" BASIS,
12
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
- See the License for the specific language governing permissions and
14
- limitations under the License.
15
- */
16
-
17
- import { ConfigError } from '@lowdefy/errors';
18
-
19
- import parseUserParam from './parseUserParam.js';
20
- import runEndpoint from '../../../lib/docs/runEndpoint.js';
21
-
22
- // Refusals, routine rejects and endpoint errors are returned as 200 data (see
23
- // runEndpoint.js) - only malformed input (missing endpointId or a bad user,
24
- // thrown as a ConfigError) is a 400. Anything else is a fault and propagates to
25
- // the error handler.
26
- async function docsRunEndpointHandler(c) {
27
- // Parse the body from a clone: runEndpoint builds a Lowdefy context whose
28
- // resolveAuthentication reads c.req.raw (headers) to resolve the caller,
29
- // so leave the original request body intact and read our own copy here.
30
- const { endpointId, payload, user, data, system, saveResponse } = await c.req.raw.clone().json();
31
- const { user: parsedUser, error: userError } = parseUserParam({ value: user });
32
- if (userError) {
33
- return c.json({ error: userError }, 400);
34
- }
35
- try {
36
- const result = await runEndpoint({
37
- endpointId,
38
- payload,
39
- user: parsedUser,
40
- data,
41
- system,
42
- saveResponse,
43
- honoContext: c,
44
- });
45
- return c.json(result);
46
- } catch (error) {
47
- if (error instanceof ConfigError) {
48
- return c.json({ error: error.message }, 400);
49
- }
50
- throw error;
51
- }
52
- }
53
-
54
- export default docsRunEndpointHandler;
@@ -1,165 +0,0 @@
1
- /*
2
- Copyright 2020-2026 Lowdefy, Inc
3
-
4
- Licensed under the Apache License, Version 2.0 (the "License");
5
- you may not use this file except in compliance with the License.
6
- You may obtain a copy of the License at
7
-
8
- http://www.apache.org/licenses/LICENSE-2.0
9
-
10
- Unless required by applicable law or agreed to in writing, software
11
- distributed under the License is distributed on an "AS IS" BASIS,
12
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
- See the License for the specific language governing permissions and
14
- limitations under the License.
15
- */
16
-
17
- import { jest } from '@jest/globals';
18
-
19
- const mockRunEndpoint = jest.fn();
20
-
21
- jest.unstable_mockModule('../../../lib/docs/runEndpoint.js', () => ({
22
- default: mockRunEndpoint,
23
- }));
24
-
25
- const { ConfigError } = await import('@lowdefy/errors');
26
- const { default: docsRunEndpointHandler } = await import('./runEndpoint.js');
27
-
28
- function createContext(body) {
29
- const request = new Request('http://localhost:3224/lowdefy-docs/run-endpoint', {
30
- method: 'POST',
31
- headers: { 'content-type': 'application/json' },
32
- body: JSON.stringify(body),
33
- });
34
- const json = jest.fn((data, status) => ({ data, status: status ?? 200 }));
35
- return { req: { raw: request }, json };
36
- }
37
-
38
- beforeEach(() => {
39
- jest.clearAllMocks();
40
- mockRunEndpoint.mockResolvedValue({ refused: false, status: 'success', response: { ok: true } });
41
- });
42
-
43
- test('docsRunEndpointHandler passes endpointId, payload and a user object through to runEndpoint', async () => {
44
- const c = createContext({
45
- endpointId: 'create_order',
46
- payload: { sku: 'A1' },
47
- user: { roles: ['admin'] },
48
- });
49
-
50
- const result = await docsRunEndpointHandler(c);
51
-
52
- expect(mockRunEndpoint).toHaveBeenCalledWith({
53
- endpointId: 'create_order',
54
- payload: { sku: 'A1' },
55
- user: { roles: ['admin'] },
56
- system: undefined,
57
- honoContext: c,
58
- });
59
- expect(result.status).toBe(200);
60
- expect(result.data).toEqual({ refused: false, status: 'success', response: { ok: true } });
61
- });
62
-
63
- test('docsRunEndpointHandler leaves the original request body readable', async () => {
64
- const c = createContext({ endpointId: 'create_order' });
65
-
66
- await docsRunEndpointHandler(c);
67
-
68
- expect(c.req.raw.bodyUsed).toBe(false);
69
- await expect(c.req.raw.json()).resolves.toEqual({ endpointId: 'create_order' });
70
- });
71
-
72
- test('docsRunEndpointHandler returns 400 when user is malformed', async () => {
73
- const c = createContext({ endpointId: 'create_order', user: '{nope' });
74
-
75
- const result = await docsRunEndpointHandler(c);
76
-
77
- expect(result.status).toBe(400);
78
- expect(result.data.error).toMatch(/The "user" param must be JSON/);
79
- expect(mockRunEndpoint).not.toHaveBeenCalled();
80
- });
81
-
82
- test('docsRunEndpointHandler passes a data set user name and data through', async () => {
83
- const c = createContext({ endpointId: 'create_order', user: 'member', data: 'crm' });
84
-
85
- await docsRunEndpointHandler(c);
86
-
87
- expect(mockRunEndpoint).toHaveBeenCalledWith(
88
- expect.objectContaining({ user: 'member', data: 'crm' })
89
- );
90
- });
91
-
92
- test('docsRunEndpointHandler passes an undefined user when the body omits it', async () => {
93
- const c = createContext({ endpointId: 'create_order' });
94
-
95
- await docsRunEndpointHandler(c);
96
-
97
- expect(mockRunEndpoint).toHaveBeenCalledWith({
98
- endpointId: 'create_order',
99
- payload: undefined,
100
- user: undefined,
101
- system: undefined,
102
- honoContext: c,
103
- });
104
- });
105
-
106
- test('docsRunEndpointHandler passes system through to runEndpoint', async () => {
107
- const c = createContext({ endpointId: 'purge_stale', system: true });
108
-
109
- await docsRunEndpointHandler(c);
110
-
111
- expect(mockRunEndpoint).toHaveBeenCalledWith({
112
- endpointId: 'purge_stale',
113
- payload: undefined,
114
- user: undefined,
115
- system: true,
116
- honoContext: c,
117
- });
118
- });
119
-
120
- test('docsRunEndpointHandler returns 400 when system is combined with user', async () => {
121
- mockRunEndpoint.mockRejectedValue(
122
- new ConfigError('run_endpoint "system" cannot be combined with "user".')
123
- );
124
- const c = createContext({ endpointId: 'purge_stale', system: true, user: { roles: ['admin'] } });
125
-
126
- const result = await docsRunEndpointHandler(c);
127
-
128
- expect(result.status).toBe(400);
129
- expect(result.data.error).toMatch(/cannot be combined with "user"/);
130
- });
131
-
132
- test('docsRunEndpointHandler returns 400 when runEndpoint throws a ConfigError', async () => {
133
- mockRunEndpoint.mockRejectedValue(
134
- new ConfigError('run_endpoint requires an "endpointId" string. Received undefined.')
135
- );
136
- const c = createContext({ payload: {} });
137
-
138
- const result = await docsRunEndpointHandler(c);
139
-
140
- expect(result.status).toBe(400);
141
- expect(result.data.error).toMatch(/requires an "endpointId" string/);
142
- });
143
-
144
- test('docsRunEndpointHandler returns refusals and rejects as 200 data', async () => {
145
- mockRunEndpoint.mockResolvedValue({
146
- refused: false,
147
- success: false,
148
- status: 'reject',
149
- error: { name: 'Error', message: 'Out of stock.' },
150
- response: null,
151
- });
152
- const c = createContext({ endpointId: 'create_order' });
153
-
154
- const result = await docsRunEndpointHandler(c);
155
-
156
- expect(result.status).toBe(200);
157
- expect(result.data.status).toBe('reject');
158
- });
159
-
160
- test('docsRunEndpointHandler rethrows faults that are not ConfigErrors', async () => {
161
- mockRunEndpoint.mockRejectedValue(new Error('boom'));
162
- const c = createContext({ endpointId: 'create_order' });
163
-
164
- await expect(docsRunEndpointHandler(c)).rejects.toThrow('boom');
165
- });
@@ -1,53 +0,0 @@
1
- /*
2
- Copyright 2020-2026 Lowdefy, Inc
3
-
4
- Licensed under the Apache License, Version 2.0 (the "License");
5
- you may not use this file except in compliance with the License.
6
- You may obtain a copy of the License at
7
-
8
- http://www.apache.org/licenses/LICENSE-2.0
9
-
10
- Unless required by applicable law or agreed to in writing, software
11
- distributed under the License is distributed on an "AS IS" BASIS,
12
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
- See the License for the specific language governing permissions and
14
- limitations under the License.
15
- */
16
-
17
- import { ConfigError } from '@lowdefy/errors';
18
-
19
- import parseUserParam from './parseUserParam.js';
20
- import runRequest from '../../../lib/docs/runRequest.js';
21
-
22
- // Refusals and request errors are returned as 200 data (see runRequest.js) —
23
- // only malformed input (missing pageId/requestId, thrown as a ConfigError) is a
24
- // 400. Anything else is a fault and propagates to the error handler.
25
- async function docsRunRequestHandler(c) {
26
- // Parse the body from a clone: runRequest builds a Lowdefy context whose
27
- // resolveAuthentication reads c.req.raw (headers) to resolve the caller,
28
- // so leave the original request body intact and read our own copy here.
29
- const { pageId, requestId, payload, user, data, saveResponse } = await c.req.raw.clone().json();
30
- const { user: parsedUser, error: userError } = parseUserParam({ value: user });
31
- if (userError) {
32
- return c.json({ error: userError }, 400);
33
- }
34
- try {
35
- const result = await runRequest({
36
- pageId,
37
- requestId,
38
- payload,
39
- user: parsedUser,
40
- data,
41
- saveResponse,
42
- honoContext: c,
43
- });
44
- return c.json(result);
45
- } catch (error) {
46
- if (error instanceof ConfigError) {
47
- return c.json({ error: error.message }, 400);
48
- }
49
- throw error;
50
- }
51
- }
52
-
53
- export default docsRunRequestHandler;
@@ -1,92 +0,0 @@
1
- /*
2
- Copyright 2020-2026 Lowdefy, Inc
3
-
4
- Licensed under the Apache License, Version 2.0 (the "License");
5
- you may not use this file except in compliance with the License.
6
- You may obtain a copy of the License at
7
-
8
- http://www.apache.org/licenses/LICENSE-2.0
9
-
10
- Unless required by applicable law or agreed to in writing, software
11
- distributed under the License is distributed on an "AS IS" BASIS,
12
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
- See the License for the specific language governing permissions and
14
- limitations under the License.
15
- */
16
-
17
- import { jest } from '@jest/globals';
18
-
19
- const mockRunRequest = jest.fn();
20
-
21
- jest.unstable_mockModule('../../../lib/docs/runRequest.js', () => ({
22
- default: mockRunRequest,
23
- }));
24
-
25
- const { default: docsRunRequestHandler } = await import('./runRequest.js');
26
-
27
- function createContext(body) {
28
- const request = new Request('http://localhost:3204/lowdefy-docs/run-request', {
29
- method: 'POST',
30
- headers: { 'content-type': 'application/json' },
31
- body: JSON.stringify(body),
32
- });
33
- const json = jest.fn((data, status) => ({ data, status: status ?? 200 }));
34
- return { req: { raw: request }, json };
35
- }
36
-
37
- beforeEach(() => {
38
- jest.clearAllMocks();
39
- mockRunRequest.mockResolvedValue({ refused: false, response: [] });
40
- });
41
-
42
- test('docsRunRequestHandler passes a user object through to runRequest', async () => {
43
- const c = createContext({
44
- pageId: 'home',
45
- requestId: 'get_rows',
46
- user: { roles: ['admin'] },
47
- });
48
-
49
- await docsRunRequestHandler(c);
50
-
51
- expect(mockRunRequest).toHaveBeenCalledWith({
52
- pageId: 'home',
53
- requestId: 'get_rows',
54
- payload: undefined,
55
- user: { roles: ['admin'] },
56
- honoContext: c,
57
- });
58
- });
59
-
60
- test('docsRunRequestHandler returns 400 when user is malformed', async () => {
61
- const c = createContext({ pageId: 'home', requestId: 'get_rows', user: 42 });
62
-
63
- const result = await docsRunRequestHandler(c);
64
-
65
- expect(result.status).toBe(400);
66
- expect(result.data.error).toMatch(/must be a user object/);
67
- expect(mockRunRequest).not.toHaveBeenCalled();
68
- });
69
-
70
- test('docsRunRequestHandler passes a data set user name and data through', async () => {
71
- const c = createContext({ pageId: 'home', requestId: 'get_rows', user: 'member', data: 'crm' });
72
-
73
- await docsRunRequestHandler(c);
74
-
75
- expect(mockRunRequest).toHaveBeenCalledWith(
76
- expect.objectContaining({ user: 'member', data: 'crm' })
77
- );
78
- });
79
-
80
- test('docsRunRequestHandler passes an undefined user when the body omits it', async () => {
81
- const c = createContext({ pageId: 'home', requestId: 'get_rows' });
82
-
83
- await docsRunRequestHandler(c);
84
-
85
- expect(mockRunRequest).toHaveBeenCalledWith({
86
- pageId: 'home',
87
- requestId: 'get_rows',
88
- payload: undefined,
89
- user: undefined,
90
- honoContext: c,
91
- });
92
- });
@@ -1,37 +0,0 @@
1
- /*
2
- Copyright 2020-2026 Lowdefy, Inc
3
-
4
- Licensed under the Apache License, Version 2.0 (the "License");
5
- you may not use this file except in compliance with the License.
6
- You may obtain a copy of the License at
7
-
8
- http://www.apache.org/licenses/LICENSE-2.0
9
-
10
- Unless required by applicable law or agreed to in writing, software
11
- distributed under the License is distributed on an "AS IS" BASIS,
12
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
- See the License for the specific language governing permissions and
14
- limitations under the License.
15
- */
16
-
17
- import getSchema from '../../../lib/docs/getSchema.js';
18
-
19
- function docsSchemaHandler(c) {
20
- const kind = c.req.param('kind');
21
- const type = c.req.param('type');
22
- let schema;
23
- try {
24
- schema = getSchema({ kind, type });
25
- } catch (error) {
26
- return c.json({ error: error.message }, 400);
27
- }
28
- if (schema === null) {
29
- return c.json(
30
- { error: `No schema found for ${kind} type "${type}". See GET /lowdefy-docs/${kind} for available types.` },
31
- 404
32
- );
33
- }
34
- return c.json(schema);
35
- }
36
-
37
- export default docsSchemaHandler;
@@ -1,120 +0,0 @@
1
- /*
2
- Copyright 2020-2026 Lowdefy, Inc
3
-
4
- Licensed under the Apache License, Version 2.0 (the "License");
5
- you may not use this file except in compliance with the License.
6
- You may obtain a copy of the License at
7
-
8
- http://www.apache.org/licenses/LICENSE-2.0
9
-
10
- Unless required by applicable law or agreed to in writing, software
11
- distributed under the License is distributed on an "AS IS" BASIS,
12
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
- See the License for the specific language governing permissions and
14
- limitations under the License.
15
- */
16
-
17
- import { type } from '@lowdefy/helpers';
18
-
19
- import parsePathParamsParam from './parsePathParamsParam.js';
20
- import parseUserParam from './parseUserParam.js';
21
- import screenshotPage from '../../../lib/docs/screenshotPage.js';
22
- import validateViewport from '../../../lib/docs/validateViewport.js';
23
-
24
- // Parses a query param as a number, or undefined if absent/not a valid
25
- // number — undefined (not NaN/0) so callers can tell "not provided" apart
26
- // from an explicit 0.
27
- function queryNumber(c, key) {
28
- const raw = c.req.query(key);
29
- if (type.isNone(raw)) {
30
- return undefined;
31
- }
32
- const value = Number(raw);
33
- return Number.isFinite(value) ? value : undefined;
34
- }
35
-
36
- async function docsScreenshotHandler(c) {
37
- const pageId = c.req.param('pageId');
38
- const fullPage = c.req.query('fullPage') === 'true';
39
- // Derived from the incoming request rather than a config value — this is
40
- // the origin an agent can actually reach the dev server on (host/port it
41
- // just connected to), regardless of how the server is bound.
42
- const origin = new URL(c.req.url).origin;
43
-
44
- const clipX = queryNumber(c, 'x');
45
- const clipY = queryNumber(c, 'y');
46
- const clipWidth = queryNumber(c, 'width');
47
- const clipHeight = queryNumber(c, 'height');
48
- // Only build a clip when all four dimensions are present — a partial
49
- // clip is ambiguous, so screenshotPage falls back to a normal viewport
50
- // screenshot in that case (same as an invalid clip).
51
- const clip =
52
- !type.isNone(clipX) &&
53
- !type.isNone(clipY) &&
54
- !type.isNone(clipWidth) &&
55
- !type.isNone(clipHeight)
56
- ? { x: clipX, y: clipY, width: clipWidth, height: clipHeight }
57
- : undefined;
58
- const scrollX = queryNumber(c, 'scrollX') ?? 0;
59
- const scrollY = queryNumber(c, 'scrollY') ?? 0;
60
-
61
- // `width` and `height` name the clip here, so the viewport size takes the
62
- // `viewport` prefix; the MCP tool, which nests the clip, calls them width
63
- // and height.
64
- for (const key of ['viewportWidth', 'viewportHeight']) {
65
- const raw = c.req.query(key);
66
- if (!type.isNone(raw) && type.isUndefined(queryNumber(c, key))) {
67
- return c.json(
68
- {
69
- error: `"${key}" must be a positive integer (CSS pixels). Received ${JSON.stringify(
70
- raw
71
- )}.`,
72
- },
73
- 400
74
- );
75
- }
76
- }
77
- const width = queryNumber(c, 'viewportWidth');
78
- const height = queryNumber(c, 'viewportHeight');
79
- const colorScheme = c.req.query('colorScheme');
80
- const viewportError = validateViewport({ width, height, colorScheme });
81
- if (viewportError) {
82
- return c.json({ error: viewportError }, 400);
83
- }
84
-
85
- const { user, error: userError } = parseUserParam({ value: c.req.query('user') });
86
- if (userError) {
87
- return c.json({ error: userError }, 400);
88
- }
89
-
90
- const { pathParams, error: pathParamsError } = parsePathParamsParam({
91
- value: c.req.query('pathParams'),
92
- });
93
- if (pathParamsError) {
94
- return c.json({ error: pathParamsError }, 400);
95
- }
96
-
97
- const result = await screenshotPage({
98
- origin,
99
- pageId,
100
- pathParams,
101
- fullPage,
102
- clip,
103
- scrollX,
104
- scrollY,
105
- user,
106
- data: c.req.query('data'),
107
- width,
108
- height,
109
- colorScheme,
110
- });
111
- if (result.error) {
112
- // pathParams the page cannot be opened with are the caller's to fix, not a
113
- // failed render.
114
- return c.json({ error: result.error }, result.invalidInput ? 400 : 502);
115
- }
116
- const buffer = Buffer.from(result.data, 'base64');
117
- return c.body(buffer, 200, { 'Content-Type': result.mimeType });
118
- }
119
-
120
- export default docsScreenshotHandler;