@lowdefy/server-dev 7.1.0 → 7.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (439) 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 +101 -143
  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.js +6 -5
  106. package/lib/docs/isHeadlessShellIncomplete.test.mjs +4 -1
  107. package/lib/docs/isPageReady.test.mjs +1 -0
  108. package/lib/docs/journeyMutantCookie.chromium.test.mjs +3 -3
  109. package/lib/docs/journeyRunRecording.test.mjs +1 -0
  110. package/lib/docs/keepEventStreamAlive.test.mjs +1 -0
  111. package/lib/docs/launchBrowser.test.mjs +8 -8
  112. package/lib/docs/listTypes.js +58 -8
  113. package/lib/docs/loadFrameworkHazards.test.mjs +1 -0
  114. package/lib/docs/matchJourneyRoute.test.mjs +1 -0
  115. package/lib/docs/observe/createJourneyAppErrors.test.mjs +18 -4
  116. package/lib/docs/observe/evaluateInvariants.js +23 -0
  117. package/lib/docs/observe/evaluateInvariants.test.mjs +27 -0
  118. package/lib/docs/observe/hasNoEffect.test.mjs +1 -0
  119. package/lib/docs/observe/toAppErrorFailure.js +7 -4
  120. package/lib/docs/observe/watchJourneyContext.js +1 -0
  121. package/lib/docs/observe/withAppErrors.test.mjs +22 -0
  122. package/lib/docs/openJourneyEmail.test.mjs +6 -6
  123. package/lib/docs/pageBuildStatus.test.mjs +6 -6
  124. package/lib/docs/pollTab.js +100 -0
  125. package/lib/docs/pollTab.test.mjs +64 -0
  126. package/lib/docs/rails/authEngineActions.test.mjs +1 -0
  127. package/lib/docs/rails/authEngineMethods.test.mjs +2 -1
  128. package/lib/docs/rails/checkAuthActionsRan.test.mjs +5 -5
  129. package/lib/docs/rails/createDataSetRails.test.mjs +1 -0
  130. package/lib/docs/rails/findExternalBlocks.test.mjs +1 -0
  131. package/lib/docs/readJourneyEmailMatch.test.mjs +2 -2
  132. package/lib/docs/readJourneySession.js +1 -1
  133. package/lib/docs/reportDevToolFault.js +29 -0
  134. package/lib/docs/reportDevToolFault.test.mjs +34 -0
  135. package/lib/docs/requestRestart.test.mjs +1 -0
  136. package/lib/docs/resolvePageInstance.test.mjs +1 -0
  137. package/lib/docs/resolveSource.js +2 -2
  138. package/lib/docs/resolveSource.test.mjs +6 -6
  139. package/lib/docs/reviewPageBuilds.test.mjs +2 -2
  140. package/lib/docs/runCheck.test.mjs +3 -3
  141. package/lib/docs/runCheckChild.js +2 -1
  142. package/lib/docs/runEndpoint.js +23 -10
  143. package/lib/docs/runEndpoint.test.mjs +42 -37
  144. package/lib/docs/runErrorBuffers.test.mjs +1 -0
  145. package/lib/docs/runJourney.js +21 -1
  146. package/lib/docs/runJourney.test.mjs +119 -99
  147. package/lib/docs/runJourneyDataSet.test.mjs +25 -25
  148. package/lib/docs/runJourneySteps.js +8 -29
  149. package/lib/docs/runRequest.js +6 -6
  150. package/lib/docs/runRequest.test.mjs +22 -22
  151. package/lib/docs/screenshotPage.js +6 -7
  152. package/lib/docs/screenshotPage.test.mjs +46 -46
  153. package/lib/docs/screenshotPageClip.test.mjs +10 -10
  154. package/lib/docs/searchDocs.test.mjs +1 -0
  155. package/lib/docs/searchIcons.test.mjs +5 -5
  156. package/lib/docs/selectFinalState.test.mjs +1 -0
  157. package/lib/docs/serverErrorStore.test.mjs +4 -4
  158. package/lib/docs/setupTestFixtures.mjs +25 -0
  159. package/lib/docs/splitSearchTerms.test.mjs +1 -0
  160. package/lib/docs/tabAvailable.js +1 -1
  161. package/lib/docs/tabChannel.js +90 -14
  162. package/lib/docs/tabChannel.test.mjs +40 -15
  163. package/lib/docs/validateJourneyTimeout.test.mjs +1 -0
  164. package/lib/docs/validateStateSelection.test.mjs +1 -0
  165. package/lib/docs/validateViewport.test.mjs +1 -0
  166. package/lib/docs/waitForBuild.test.mjs +1 -0
  167. package/lib/docs/withBrowserSlot.test.mjs +5 -5
  168. package/lib/server/applyDataSetRedirect.test.mjs +2 -2
  169. package/lib/server/applyDataSetRedirectTenantReach.test.mjs +1 -0
  170. package/lib/server/applyDataSetRedirectWalled.test.mjs +1 -0
  171. package/lib/server/auth/getHeadlessUser.js +6 -0
  172. package/lib/server/auth/getHeadlessUser.test.mjs +13 -2
  173. package/lib/server/auth/resolveHeadlessUser.test.mjs +1 -0
  174. package/lib/server/contextMapBudget.test.mjs +3 -3
  175. package/lib/server/continueJitKeys.test.mjs +1 -0
  176. package/lib/server/createLowdefyContext.js +5 -1
  177. package/lib/server/createLowdefyContext.test.mjs +32 -32
  178. package/lib/server/getClientAddress.test.mjs +2 -2
  179. package/lib/server/getPageJitEnrichment.test.mjs +1 -0
  180. package/lib/server/importAppCode.test.mjs +2 -2
  181. package/lib/server/jitPageBuilder.js +27 -3
  182. package/lib/server/jitPageBuilder.mobileTypes.test.mjs +65 -0
  183. package/lib/server/jitPageBuilder.skipPluginChecks.test.mjs +5 -6
  184. package/lib/server/jitPageBuilder.test.mjs +4 -4
  185. package/lib/server/journeyCookies.test.mjs +1 -0
  186. package/lib/server/loadDynamicJsMap.js +10 -1
  187. package/lib/server/log/createHandleError.js +10 -5
  188. package/lib/server/log/createHandleError.test.mjs +19 -8
  189. package/lib/server/log/createLogger.test.mjs +2 -2
  190. package/lib/server/mutantDataSetWrappers.test.mjs +1 -0
  191. package/lib/server/mutants/listMutants.test.mjs +1 -0
  192. package/lib/server/mutants/mutantRuns.test.mjs +1 -0
  193. package/lib/server/mutants/operators.test.mjs +1 -0
  194. package/lib/server/pageBuildRecords.test.mjs +1 -0
  195. package/lib/server/pageCache.test.mjs +1 -0
  196. package/lib/server/pageRebuilds.test.mjs +3 -3
  197. package/{src/routes/docs/examples.js → lib/server/pairingHeaders.js} +8 -15
  198. package/lib/server/pruneJitMaps.test.mjs +1 -0
  199. package/lib/server/readBuildApiArtifacts.test.mjs +1 -0
  200. package/lib/server/readInstanceRecord.test.mjs +24 -8
  201. package/lib/server/readMergedMaps.test.mjs +1 -0
  202. package/lib/server/recording/errorRecordingStamp.test.mjs +1 -0
  203. package/lib/server/recording/readRecordingCookie.test.mjs +2 -0
  204. package/lib/server/recording/servedBuilds.test.mjs +1 -0
  205. package/lib/server/sinkExternalConnections.test.mjs +6 -6
  206. package/lib/server/skipStaleMapWrites.test.mjs +12 -12
  207. package/lib/server/startIdleGc.test.mjs +25 -9
  208. package/lib/server/testFixtures/importAppCodeTwice.mjs +2 -2
  209. package/lib/vite/createDevServerExclude.test.mjs +1 -0
  210. package/lib/vite/keepIdleConnectionsOpen.js +36 -0
  211. package/lib/vite/keepIdleConnectionsOpen.test.mjs +104 -0
  212. package/manager/getContext.mjs +9 -0
  213. package/manager/processes/checkPendingPlugins.mjs +49 -0
  214. package/manager/processes/checkPendingPlugins.test.mjs +107 -0
  215. package/manager/processes/createIdleChild.mjs +141 -0
  216. package/manager/processes/createIdleChild.test.mjs +209 -0
  217. package/manager/processes/initialBuild.mjs +2 -15
  218. package/manager/processes/initialBuild.test.mjs +8 -40
  219. package/manager/processes/lowdefyBuild.mjs +7 -4
  220. package/manager/processes/lowdefyBuild.skipPluginChecks.test.mjs +13 -13
  221. package/manager/processes/lowdefyBuild.test.mjs +17 -15
  222. package/manager/processes/restartServer.test.mjs +63 -15
  223. package/manager/processes/shutdownServer.test.mjs +3 -3
  224. package/manager/processes/startFirstServer.test.mjs +23 -22
  225. package/manager/processes/startMailSink.mjs +11 -3
  226. package/manager/processes/startMailSink.test.mjs +28 -2
  227. package/manager/processes/startProxy.mjs +167 -29
  228. package/manager/processes/startProxy.pairing.test.mjs +204 -0
  229. package/manager/processes/startProxy.test.mjs +130 -5
  230. package/manager/processes/startServer.mjs +5 -7
  231. package/manager/processes/startServer.test.mjs +10 -9
  232. package/manager/processes/syncServer.mjs +31 -4
  233. package/manager/processes/syncServer.test.mjs +71 -6
  234. package/manager/processes/waitForDevServer.test.mjs +21 -6
  235. package/manager/run.mjs +32 -8
  236. package/manager/utils/BatchChanges.mjs +1 -1
  237. package/manager/utils/BatchChanges.test.mjs +4 -4
  238. package/manager/utils/acquireDevInstance.test.mjs +1 -0
  239. package/manager/utils/checkPairing.mjs +45 -0
  240. package/manager/utils/checkPairing.test.mjs +53 -0
  241. package/manager/utils/createBuildActivity.mjs +5 -1
  242. package/manager/utils/createBuildActivity.test.mjs +2 -2
  243. package/manager/utils/createChangeSignal.test.mjs +5 -5
  244. package/manager/utils/createCustomPluginMessagesMap.mjs +8 -3
  245. package/manager/utils/createCustomPluginTypesMap.mjs +48 -12
  246. package/manager/utils/createCustomPluginTypesMap.test.mjs +181 -19
  247. package/manager/utils/createDotPathIgnore.test.mjs +1 -0
  248. package/manager/utils/createGlobIgnore.mjs +45 -0
  249. package/manager/utils/createGlobIgnore.test.mjs +58 -0
  250. package/manager/utils/createGlobWatchPaths.mjs +75 -0
  251. package/manager/utils/createGlobWatchPaths.test.mjs +67 -0
  252. package/manager/utils/createIdleGc.test.mjs +31 -15
  253. package/{src/routes/docs/content.js → manager/utils/createLanPairing.mjs} +14 -13
  254. package/manager/utils/createLanPairing.test.mjs +46 -0
  255. package/manager/utils/createRequestActivity.mjs +30 -3
  256. package/manager/utils/createRequestActivity.test.mjs +76 -22
  257. package/manager/utils/createServerArtifactTracker.mjs +1 -0
  258. package/manager/utils/createServerArtifactTracker.test.mjs +1 -0
  259. package/manager/utils/findBuildFilesOutsideWatch.test.mjs +1 -0
  260. package/{client/recorder/collectEventActions.js → manager/utils/findSignInCode.mjs} +13 -10
  261. package/manager/utils/findSignInCode.test.mjs +33 -0
  262. package/manager/utils/formatLanPairing.mjs +32 -0
  263. package/manager/utils/formatLanPairing.test.mjs +40 -0
  264. package/manager/utils/getLanAddress.mjs +83 -0
  265. package/manager/utils/getLanAddress.test.mjs +70 -0
  266. package/manager/utils/importFresh.test.mjs +1 -0
  267. package/{src/routes/docs/icons.js → manager/utils/isLoopbackAddress.mjs} +11 -10
  268. package/manager/utils/pluginTypeCache.mjs +100 -0
  269. package/manager/utils/pluginTypeCache.test.mjs +141 -0
  270. package/manager/utils/pruneRecordings.test.mjs +1 -0
  271. package/manager/utils/publishBuildDirectory.order.test.mjs +2 -2
  272. package/manager/utils/publishBuildDirectory.test.mjs +6 -7
  273. package/manager/utils/readBasePath.test.mjs +1 -0
  274. package/manager/utils/readManagerVersion.test.mjs +1 -0
  275. package/manager/utils/readPluginDefinitions.mjs +6 -6
  276. package/manager/utils/renderTerminalQr.mjs +54 -0
  277. package/manager/utils/resolveDevAuthUrl.test.mjs +1 -0
  278. package/manager/utils/setupWatcher.mjs +19 -4
  279. package/manager/utils/startRecordingPruner.test.mjs +24 -8
  280. package/manager/utils/waitForChildExit.test.mjs +2 -2
  281. package/manager/utils/writeBuildStatus.test.mjs +1 -0
  282. package/manager/watchers/envWatcher.mjs +3 -0
  283. package/manager/watchers/envWatcher.test.mjs +19 -7
  284. package/manager/watchers/listServerPluginFiles.mjs +188 -0
  285. package/manager/watchers/listServerPluginFiles.test.mjs +257 -0
  286. package/manager/watchers/lowdefyBuildWatcher.mjs +5 -0
  287. package/manager/watchers/lowdefyBuildWatcher.test.mjs +63 -10
  288. package/manager/watchers/pluginSourceWatcher.mjs +45 -17
  289. package/manager/watchers/pluginSourceWatcher.test.mjs +97 -21
  290. package/manager/watchers/resolveFile.mjs +46 -0
  291. package/manager/watchers/resolveFile.test.mjs +67 -0
  292. package/manager/watchers/resolvePackageSpecifier.mjs +127 -0
  293. package/manager/watchers/resolvePackageSpecifier.test.mjs +151 -0
  294. package/manager/watchers/restartRequestWatcher.mjs +7 -4
  295. package/manager/watchers/restartRequestWatcher.test.mjs +43 -6
  296. package/manager/watchers/selectLocalPluginPackages.test.mjs +1 -0
  297. package/package.json +54 -53
  298. package/package.original.json +54 -53
  299. package/src/app.js +83 -85
  300. package/src/html/renderDevPage.test.mjs +1 -0
  301. package/src/lib/getPathSegments.js +16 -1
  302. package/src/{routes/docs/checkpointsList.js → lib/getRequestSurface.js} +6 -4
  303. package/src/lib/isTabAnswer.js +32 -0
  304. package/src/lib/isTabChannelCaller.js +35 -0
  305. package/src/middleware/apiContext.js +4 -2
  306. package/src/middleware/createSameOriginGuard.test.mjs +1 -0
  307. package/src/middleware/errorHandler.js +33 -45
  308. package/src/middleware/errorHandler.test.mjs +10 -10
  309. package/src/middleware/isRebindingSafeHost.test.mjs +1 -0
  310. package/src/middleware/localDevToolsOnly.js +13 -1
  311. package/src/middleware/localDevToolsOnly.test.mjs +36 -2
  312. package/src/middleware/noStore.test.mjs +1 -0
  313. package/src/middleware/requestTimeout.js +7 -1
  314. package/src/middleware/staleFlag.test.mjs +1 -0
  315. package/src/middleware/stampCaller.test.mjs +1 -0
  316. package/src/routes/agentBearer.test.mjs +183 -0
  317. package/src/routes/auth.test.mjs +10 -10
  318. package/src/routes/clientError.js +21 -4
  319. package/src/routes/clientError.test.mjs +127 -0
  320. package/src/routes/devInspect.js +6 -51
  321. package/src/routes/devInspect.test.mjs +128 -3
  322. package/src/routes/devRecording.js +6 -17
  323. package/src/routes/devRecording.test.mjs +54 -3
  324. package/src/routes/docs/buildStatus.test.mjs +6 -6
  325. package/src/routes/docs/events.test.mjs +4 -4
  326. package/src/routes/docs/find.js +3 -3
  327. package/src/routes/docs/journey.test.mjs +8 -8
  328. package/src/routes/docs/journeyRefusals.test.mjs +9 -9
  329. package/src/routes/docs/loadDocsRoutes.js +70 -0
  330. package/src/routes/docs/loadDocsRoutes.test.mjs +110 -0
  331. package/src/routes/docs/mcp.test.mjs +5 -5
  332. package/src/routes/docs/mutants.js +7 -0
  333. package/src/routes/docs/mutants.test.mjs +20 -6
  334. package/src/routes/docs/parsePathParamsParam.test.mjs +1 -0
  335. package/src/routes/docs/parseUserParam.test.mjs +1 -0
  336. package/src/routes/docs/restart.test.mjs +1 -0
  337. package/src/routes/endpoints.js +24 -0
  338. package/src/routes/endpointsLink.test.mjs +111 -0
  339. package/src/routes/endpointsTextAnswer.test.mjs +8 -8
  340. package/src/routes/jitPage.js +13 -1
  341. package/src/routes/jitPage.test.mjs +36 -11
  342. package/src/routes/mcp.js +6 -0
  343. package/src/routes/mcp.test.mjs +23 -8
  344. package/src/routes/mcpMemberToken.test.mjs +8 -8
  345. package/src/routes/mcpProtectedResourceMetadata.test.mjs +2 -2
  346. package/src/routes/{docs/checkpointsRevert.js → mobileRoot.js} +10 -13
  347. package/src/routes/mobileRoutes.test.mjs +223 -0
  348. package/src/routes/mobileSignIn.js +58 -0
  349. package/src/routes/mobileSignIn.test.mjs +59 -0
  350. package/src/routes/mobileSignInCallback.js +34 -0
  351. package/src/routes/mobileSignInCallback.test.mjs +51 -0
  352. package/src/routes/mountDevPageRoutes.js +10 -2
  353. package/src/routes/mountDevPageRoutes.test.mjs +25 -1
  354. package/src/routes/mountMobileWellKnown.js +35 -0
  355. package/src/routes/mountMobileWellKnown.test.mjs +79 -0
  356. package/src/routes/mountOauthDiscovery.test.mjs +5 -5
  357. package/src/routes/normalizeMcpProtocolVersionHeader.test.mjs +1 -0
  358. package/src/routes/reload.js +101 -20
  359. package/src/routes/reload.test.mjs +153 -0
  360. package/src/routes/request.js +1 -22
  361. package/src/routes/request.test.mjs +7 -24
  362. package/src/routes/requestBody.test.mjs +14 -27
  363. package/src/routes/websocket.test.mjs +2 -2
  364. package/src/routes/wellKnownFallback.test.mjs +2 -2
  365. package/src/websocket/devWebSocket.test.mjs +12 -12
  366. package/vite.config.js +15 -1
  367. package/client/feedback/FeedbackMount.jsx +0 -83
  368. package/client/feedback/FeedbackOverlay.jsx +0 -904
  369. package/client/feedback/captureTabScreenshot.js +0 -84
  370. package/client/feedback/copyToClipboard.js +0 -45
  371. package/client/feedback/drawAnnotationsSvg.js +0 -119
  372. package/client/feedback/feedbackStyles.js +0 -304
  373. package/client/feedback/pinResponsiveImages.js +0 -59
  374. package/client/feedback/sendFeedback.js +0 -39
  375. package/client/feedback/useFeedbackToggle.js +0 -70
  376. package/client/recorder/buildEngineRecord.js +0 -37
  377. package/client/recorder/buildInteractionRecord.js +0 -64
  378. package/client/recorder/buildTraceEvent.js +0 -57
  379. package/client/recorder/buildTraceEvent.test.mjs +0 -81
  380. package/client/recorder/chunkRecords.js +0 -69
  381. package/client/recorder/chunkRecords.test.mjs +0 -59
  382. package/client/recorder/collectEventEndpoints.js +0 -40
  383. package/client/recorder/collectEventRequests.js +0 -39
  384. package/client/recorder/createPairingBuffer.js +0 -187
  385. package/client/recorder/createPasswordRedactor.js +0 -84
  386. package/client/recorder/createRecordBatcher.js +0 -54
  387. package/client/recorder/createRecordBatcher.test.mjs +0 -76
  388. package/client/recorder/createRecordingSession.js +0 -61
  389. package/client/recorder/createRecordingSession.test.mjs +0 -72
  390. package/client/recorder/diffStateWrites.js +0 -77
  391. package/client/recorder/diffStateWrites.test.mjs +0 -66
  392. package/client/recorder/isEventCall.js +0 -30
  393. package/client/recorder/jsonType.js +0 -39
  394. package/client/recorder/sendRecords.js +0 -40
  395. package/lib/docs/captureAnnotatedScreenshot.js +0 -99
  396. package/lib/docs/checkpointPaths.js +0 -91
  397. package/lib/docs/checkpointStore.js +0 -243
  398. package/lib/docs/checkpointToMocks.js +0 -65
  399. package/lib/docs/configCheckpoints.test.mjs +0 -156
  400. package/lib/docs/createConfigCheckpoint.js +0 -92
  401. package/lib/docs/devMockRegistry.js +0 -68
  402. package/lib/docs/enrichFeedback.js +0 -71
  403. package/lib/docs/evalOperator.js +0 -49
  404. package/lib/docs/evalOperator.test.mjs +0 -157
  405. package/lib/docs/evalOperatorHeadless.js +0 -159
  406. package/lib/docs/evalOperatorHeadless.test.mjs +0 -78
  407. package/lib/docs/evalOperatorInTab.js +0 -49
  408. package/lib/docs/formatFeedback.js +0 -142
  409. package/lib/docs/formatFeedback.test.mjs +0 -252
  410. package/lib/docs/getPluginDoc.js +0 -53
  411. package/lib/docs/listConfigCheckpoints.js +0 -55
  412. package/lib/docs/loadState.js +0 -220
  413. package/lib/docs/revertConfigCheckpoint.js +0 -73
  414. package/lib/docs/saveAnnotatedScreenshot.js +0 -43
  415. package/lib/docs/scaffoldPage.js +0 -77
  416. package/lib/docs/scaffoldPage.test.mjs +0 -97
  417. package/lib/docs/snapshotState.js +0 -67
  418. package/lib/docs/stateCheckpoints.test.mjs +0 -443
  419. package/manager/watchers/listServerSidePackages.mjs +0 -47
  420. package/manager/watchers/listServerSidePackages.test.mjs +0 -38
  421. package/src/routes/docs/checkpointsCreate.js +0 -28
  422. package/src/routes/docs/evalOperator.js +0 -70
  423. package/src/routes/docs/inspectState.js +0 -59
  424. package/src/routes/docs/loadState.js +0 -51
  425. package/src/routes/docs/pluginDoc.js +0 -33
  426. package/src/routes/docs/plugins.js +0 -23
  427. package/src/routes/docs/runEndpoint.js +0 -54
  428. package/src/routes/docs/runEndpoint.test.mjs +0 -165
  429. package/src/routes/docs/runRequest.js +0 -53
  430. package/src/routes/docs/runRequest.test.mjs +0 -92
  431. package/src/routes/docs/schema.js +0 -37
  432. package/src/routes/docs/screenshot.js +0 -120
  433. package/src/routes/docs/screenshot.test.mjs +0 -117
  434. package/src/routes/docs/search.js +0 -40
  435. package/src/routes/docs/snapshotState.js +0 -50
  436. package/src/routes/docs/stateCheckpointsList.js +0 -26
  437. package/src/routes/docs/types.js +0 -33
  438. package/src/routes/feedback.js +0 -107
  439. package/src/routes/feedback.test.mjs +0 -204
@@ -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 fs from 'node:fs';
18
- import { type } from '@lowdefy/helpers';
19
-
20
- import listPackageDocFiles from './listPackageDocFiles.js';
21
- import readBuildArtifact from './readBuildArtifact.js';
22
- import readPluginPackages from './readPluginPackages.js';
23
- import resolvePluginDir from './resolvePluginDir.js';
24
-
25
- // The package name comes from the caller, and a name such as "../../x" would
26
- // resolve outside node_modules, so only the app's own plugins are read.
27
- function isAppPlugin({ packageName }) {
28
- const installed = readBuildArtifact({ name: 'installedPluginPackages.json' }) ?? [];
29
- if (installed.includes(packageName)) {
30
- return true;
31
- }
32
- return readPluginPackages().some((plugin) => plugin.package === packageName);
33
- }
34
-
35
- // Every markdown file a plugin package ships, joined into one document.
36
- function getPluginDoc({ packageName }) {
37
- if (!isAppPlugin({ packageName })) {
38
- return null;
39
- }
40
- const pluginDir = resolvePluginDir({ packageName });
41
- if (type.isNone(pluginDir)) {
42
- return null;
43
- }
44
- const { readme, docs } = listPackageDocFiles({ dir: pluginDir });
45
- const files = type.isNone(readme) ? docs : [readme, ...docs];
46
- if (files.length === 0) {
47
- return null;
48
- }
49
- const sections = files.map((filePath) => fs.readFileSync(filePath, 'utf8'));
50
- return { package: packageName, markdown: sections.join('\n\n---\n\n') };
51
- }
52
-
53
- export default getPluginDoc;
@@ -1,55 +0,0 @@
1
- /*
2
- Copyright 2020-2026 Lowdefy, Inc
3
-
4
- Licensed under the Apache License, Version 2.0 (the "License");
5
- you may not use this file except in compliance with the License.
6
- You may obtain a copy of the License at
7
-
8
- http://www.apache.org/licenses/LICENSE-2.0
9
-
10
- Unless required by applicable law or agreed to in writing, software
11
- distributed under the License is distributed on an "AS IS" BASIS,
12
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
- See the License for the specific language governing permissions and
14
- limitations under the License.
15
- */
16
-
17
- import fs from 'fs';
18
- import path from 'path';
19
-
20
- import { getCheckpointsRoot, MANIFEST_FILE_NAME } from './checkpointPaths.js';
21
-
22
- // Lists stored config checkpoints, most recent first. Reads manifest.json
23
- // from each snapshot directory rather than re-scanning the config
24
- // directory — the manifest is the source of truth for what a checkpoint
25
- // contains, and stays accurate even after later checkpoints or reverts.
26
- function listConfigCheckpoints() {
27
- const checkpointsRoot = getCheckpointsRoot();
28
- if (!fs.existsSync(checkpointsRoot)) {
29
- return [];
30
- }
31
-
32
- const checkpoints = fs
33
- .readdirSync(checkpointsRoot, { withFileTypes: true })
34
- .filter((entry) => entry.isDirectory())
35
- .map((entry) => {
36
- const manifestPath = path.join(checkpointsRoot, entry.name, MANIFEST_FILE_NAME);
37
- if (!fs.existsSync(manifestPath)) {
38
- // A checkpoint directory without a manifest is not one this module
39
- // wrote (or was interrupted mid-write) — skip rather than guess.
40
- return null;
41
- }
42
- const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
43
- return {
44
- id: manifest.id,
45
- label: manifest.label,
46
- createdAt: manifest.createdAt,
47
- fileCount: manifest.files.length,
48
- };
49
- })
50
- .filter((checkpoint) => checkpoint !== null);
51
-
52
- return checkpoints.sort((a, b) => (a.id < b.id ? 1 : -1));
53
- }
54
-
55
- export default listConfigCheckpoints;
@@ -1,220 +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, urlQuery as urlQueryFn } from '@lowdefy/helpers';
18
-
19
- import { buildPageUrl, getBrowser, openPage } from './getBrowser.js';
20
- import noBrowserError from './noBrowserError.js';
21
- import { loadMocks } from './devMockRegistry.js';
22
- import { readCheckpoint } from './checkpointStore.js';
23
- import resolvePageInstance from './resolvePageInstance.js';
24
- import resolveToolCaller from './resolveToolCaller.js';
25
- import unsettledPageNote from './unsettledPageNote.js';
26
- import withBrowserSlot from './withBrowserSlot.js';
27
- import withDataSession from './withDataSession.js';
28
-
29
- const VERIFY_KEY_COUNT = 3;
30
- const READY_TIMEOUT = 15000;
31
-
32
- // Loads a state checkpoint's recorded requests into devMockRegistry (shared
33
- // by both modes below — src/routes/request.js consults it regardless of how
34
- // the page was opened), then either:
35
- // - 'headless': drives a headless page to the checkpoint's page instance
36
- // (pageId, pathParams) and urlQuery, injects its recorded state directly
37
- // into that instance's context, and verifies
38
- // a few keys round-tripped. Good for an agent verifying its own change.
39
- // Takes a `user` (and `data`, see resolveToolCaller) so a checkpoint
40
- // captured on a role-gated page restores into a page that actually
41
- // renders (see resolveHeadlessUser.js).
42
- // - 'registry-only': just returns a URL a human can open in a real browser
43
- // tab — client/Inspector.jsx's `?_checkpoint=` bootstrap does the state
44
- // injection client-side once that tab loads.
45
- async function loadState({ origin, name, mode = 'headless', user, data }) {
46
- if (type.isNone(name) || !type.isString(name)) {
47
- return { error: `loadState requires a "name" string. Received ${JSON.stringify(name)}.` };
48
- }
49
-
50
- // `user` only reaches a page this function opens itself. In 'registry-only'
51
- // mode the developer opens the returned URL in their own browser, carrying
52
- // their own session, so an injected caller would be silently dropped.
53
- if ((!type.isNone(user) || !type.isNone(data)) && mode === 'registry-only') {
54
- const param = type.isNone(user) ? 'data' : 'user';
55
- return {
56
- error: `loadState cannot apply "${param}" in "registry-only" mode — the developer opens the returned URL in their own browser, carrying their own session and database. Use the default "headless" mode.`,
57
- invalidInput: true,
58
- };
59
- }
60
-
61
- let checkpoint;
62
- try {
63
- checkpoint = readCheckpoint({ name });
64
- } catch (error) {
65
- return { error: error.message };
66
- }
67
-
68
- const pageId = checkpoint.checkpoint.pageId;
69
- if (type.isNone(pageId)) {
70
- return { error: `Checkpoint "${name}" has no recorded pageId.` };
71
- }
72
-
73
- const { pathParams } = checkpoint;
74
- const instance = resolvePageInstance({ pageId, pathParams });
75
- if (!type.isUndefined(instance.error)) {
76
- return { error: `Checkpoint "${name}" cannot open its page: ${instance.error}` };
77
- }
78
-
79
- loadMocks({ pageId, mocks: checkpoint.requests });
80
-
81
- // The checkpoint keeps the query string the page was captured at.
82
- const urlQuery = urlQueryFn.parse(checkpoint.urlQuery);
83
-
84
- if (mode === 'registry-only') {
85
- const url = buildPageUrl({
86
- origin,
87
- pageId,
88
- path: instance.path,
89
- pathParams,
90
- urlQuery: { ...urlQuery, _checkpoint: name },
91
- });
92
- return {
93
- url,
94
- instructions:
95
- 'Open this URL in a browser — state is injected on load, requests serve recorded data.',
96
- };
97
- }
98
-
99
- if (mode !== 'headless') {
100
- return {
101
- error: `loadState "mode" must be "headless" or "registry-only". Received ${JSON.stringify(
102
- mode
103
- )}.`,
104
- };
105
- }
106
-
107
- if (type.isNone(origin) || !type.isString(origin)) {
108
- return { error: `loadState requires an "origin" string. Received ${JSON.stringify(origin)}.` };
109
- }
110
-
111
- const caller = await resolveToolCaller({ user, data });
112
- if (!type.isUndefined(caller.error)) {
113
- return caller;
114
- }
115
-
116
- return withBrowserSlot({
117
- task: () =>
118
- withDataSession({
119
- dataSet: caller.dataSet,
120
- task: ({ dataCookie }) =>
121
- loadStateInBrowser({
122
- origin,
123
- name,
124
- mode,
125
- user: caller.user,
126
- dataCookie,
127
- pageId,
128
- instance,
129
- pathParams,
130
- urlQuery,
131
- checkpoint,
132
- }),
133
- }),
134
- });
135
- }
136
-
137
- // The part of loadState that runs in the browser, inside a browser slot.
138
- async function loadStateInBrowser({
139
- origin,
140
- name,
141
- mode,
142
- user,
143
- dataCookie,
144
- pageId,
145
- instance,
146
- pathParams,
147
- urlQuery,
148
- checkpoint,
149
- }) {
150
- let browser;
151
- try {
152
- browser = await getBrowser();
153
- } catch (error) {
154
- return { error: noBrowserError(error) };
155
- }
156
-
157
- let context;
158
- try {
159
- const opened = await openPage({
160
- browser,
161
- origin,
162
- pageId,
163
- path: instance.path,
164
- pathParams,
165
- urlQuery,
166
- user,
167
- dataCookie,
168
- timeout: READY_TIMEOUT,
169
- });
170
- context = opened.context;
171
- const { page } = opened;
172
-
173
- await page.waitForFunction(
174
- (contextKey) => Boolean(window.lowdefy?.contexts?.[contextKey]),
175
- instance.instanceKey,
176
- {
177
- timeout: READY_TIMEOUT,
178
- }
179
- );
180
-
181
- const stateEntries = Object.entries(checkpoint.state ?? {});
182
- await page.evaluate(
183
- ({ contextKey, entries }) => {
184
- const pageContext = window.lowdefy.contexts[contextKey];
185
- entries.forEach(([key, value]) => {
186
- pageContext._internal.State.set(key, value);
187
- });
188
- pageContext._internal.update();
189
- },
190
- { contextKey: instance.instanceKey, entries: stateEntries }
191
- );
192
-
193
- const verifyKeys = stateEntries.slice(0, VERIFY_KEY_COUNT).map(([key]) => key);
194
- const verifiedKeys = await page.evaluate(
195
- ({ contextKey, keys }) => {
196
- const pageContext = window.lowdefy.contexts[contextKey];
197
- const result = {};
198
- keys.forEach((key) => {
199
- result[key] = pageContext.state?.[key];
200
- });
201
- return result;
202
- },
203
- { contextKey: instance.instanceKey, keys: verifyKeys }
204
- );
205
-
206
- const result = { loaded: true, mode, url: opened.url, verifiedKeys };
207
- if (!opened.ready) {
208
- return { ...result, ready: false, note: unsettledPageNote({ timeout: READY_TIMEOUT }) };
209
- }
210
- return result;
211
- } catch (error) {
212
- return { error: `Failed to load checkpoint "${name}": ${error.message}` };
213
- } finally {
214
- if (context) {
215
- await context.close();
216
- }
217
- }
218
- }
219
-
220
- export default loadState;
@@ -1,73 +0,0 @@
1
- /*
2
- Copyright 2020-2026 Lowdefy, Inc
3
-
4
- Licensed under the Apache License, Version 2.0 (the "License");
5
- you may not use this file except in compliance with the License.
6
- You may obtain a copy of the License at
7
-
8
- http://www.apache.org/licenses/LICENSE-2.0
9
-
10
- Unless required by applicable law or agreed to in writing, software
11
- distributed under the License is distributed on an "AS IS" BASIS,
12
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
- See the License for the specific language governing permissions and
14
- limitations under the License.
15
- */
16
-
17
- import fs from 'fs';
18
- import path from 'path';
19
- import { type } from '@lowdefy/helpers';
20
-
21
- import {
22
- getCheckpointsRoot,
23
- getConfigDirectory,
24
- listConfigFiles,
25
- MANIFEST_FILE_NAME,
26
- } from './checkpointPaths.js';
27
-
28
- function copyFromSnapshot({ snapshotDirectory, configDirectory, relativeFilePath }) {
29
- const source = path.join(snapshotDirectory, relativeFilePath);
30
- const destination = path.join(configDirectory, relativeFilePath);
31
- fs.mkdirSync(path.dirname(destination), { recursive: true });
32
- fs.copyFileSync(source, destination);
33
- }
34
-
35
- // Restores the config directory to exactly the state captured by checkpoint
36
- // `id`: every file the manifest lists is copied back (covering both
37
- // modified files and files deleted after the checkpoint was taken), and any
38
- // config-relevant file that exists now but isn't in the manifest is deleted
39
- // (covering files added after the checkpoint). The manifest — not a diff
40
- // against the live directory — is the single source of truth for what
41
- // "restored" means, so reverts are exact and repeatable.
42
- function revertConfigCheckpoint({ id }) {
43
- if (type.isNone(id) || !type.isString(id)) {
44
- throw new Error(
45
- `revertConfigCheckpoint requires an "id" string. Received ${JSON.stringify(id)}.`
46
- );
47
- }
48
-
49
- const checkpointsRoot = getCheckpointsRoot();
50
- const snapshotDirectory = path.join(checkpointsRoot, id);
51
- const manifestPath = path.join(snapshotDirectory, MANIFEST_FILE_NAME);
52
- if (!fs.existsSync(manifestPath)) {
53
- throw new Error(`Config checkpoint "${id}" not found.`);
54
- }
55
-
56
- const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
57
- const configDirectory = getConfigDirectory();
58
-
59
- manifest.files.forEach((relativeFilePath) => {
60
- copyFromSnapshot({ snapshotDirectory, configDirectory, relativeFilePath });
61
- });
62
-
63
- const manifestFiles = new Set(manifest.files);
64
- const currentFiles = listConfigFiles({ configDirectory });
65
- const deleted = currentFiles.filter((relativeFilePath) => !manifestFiles.has(relativeFilePath));
66
- deleted.forEach((relativeFilePath) => {
67
- fs.rmSync(path.join(configDirectory, relativeFilePath));
68
- });
69
-
70
- return { restored: manifest.files, deleted };
71
- }
72
-
73
- export default revertConfigCheckpoint;
@@ -1,43 +0,0 @@
1
- /*
2
- Copyright 2020-2026 Lowdefy, Inc
3
-
4
- Licensed under the Apache License, Version 2.0 (the "License");
5
- you may not use this file except in compliance with the License.
6
- You may obtain a copy of the License at
7
-
8
- http://www.apache.org/licenses/LICENSE-2.0
9
-
10
- Unless required by applicable law or agreed to in writing, software
11
- distributed under the License is distributed on an "AS IS" BASIS,
12
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
- See the License for the specific language governing permissions and
14
- limitations under the License.
15
- */
16
-
17
- import fs from 'node:fs';
18
- import path from 'node:path';
19
-
20
- const PNG_DATA_URL_PREFIX = 'data:image/png;base64,';
21
-
22
- // Saves a tab-captured annotated screenshot (PNG data URL POSTed with the
23
- // feedback batch) under the config dir's .lowdefy/annotations/ — the same
24
- // location and naming captureAnnotatedScreenshot.js uses, so formatFeedback's
25
- // screenshotPath contract is identical for both capture paths. Never throws —
26
- // returns { path } or { error }.
27
- function saveAnnotatedScreenshot({ dataUrl, fileName }) {
28
- if (typeof dataUrl !== 'string' || !dataUrl.startsWith(PNG_DATA_URL_PREFIX)) {
29
- return { error: 'Screenshot is not a PNG data URL.' };
30
- }
31
- try {
32
- const buffer = Buffer.from(dataUrl.slice(PNG_DATA_URL_PREFIX.length), 'base64');
33
- const configDirectory = process.env.LOWDEFY_DIRECTORY_CONFIG || process.cwd();
34
- const dir = path.join(configDirectory, '.lowdefy', 'annotations');
35
- fs.mkdirSync(dir, { recursive: true });
36
- fs.writeFileSync(path.join(dir, fileName), buffer);
37
- return { path: path.posix.join('.lowdefy', 'annotations', fileName) };
38
- } catch (error) {
39
- return { error: `Failed to save annotated screenshot: ${error.message}` };
40
- }
41
- }
42
-
43
- export default saveAnnotatedScreenshot;
@@ -1,77 +0,0 @@
1
- /*
2
- Copyright 2020-2026 Lowdefy, Inc
3
-
4
- Licensed under the Apache License, Version 2.0 (the "License");
5
- you may not use this file except in compliance with the License.
6
- You may obtain a copy of the License at
7
-
8
- http://www.apache.org/licenses/LICENSE-2.0
9
-
10
- Unless required by applicable law or agreed to in writing, software
11
- distributed under the License is distributed on an "AS IS" BASIS,
12
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
- See the License for the specific language governing permissions and
14
- limitations under the License.
15
- */
16
-
17
- import fs from 'fs';
18
- import path from 'path';
19
- import { type } from '@lowdefy/helpers';
20
-
21
- import readBuildArtifact from './readBuildArtifact.js';
22
-
23
- const pageIdPattern = /^[a-z0-9-_]+$/i;
24
-
25
- function buildPageYaml({ pageId, title }) {
26
- const titleJson = JSON.stringify(title);
27
- return `id: ${pageId}
28
- type: PageHeaderMenu
29
- properties:
30
- title: ${titleJson}
31
- blocks:
32
- - id: ${pageId}_title
33
- type: Title
34
- properties:
35
- content: ${titleJson}
36
- `;
37
- }
38
-
39
- // Scaffolds a new page config file for an AI agent to wire up — it never edits lowdefy.yaml
40
- // itself, since that would risk destroying the user's comments and formatting.
41
- function scaffoldPage({ pageId, title }) {
42
- if (type.isNone(pageId) || !pageIdPattern.test(pageId)) {
43
- return {
44
- error: `Invalid page id ${JSON.stringify(
45
- pageId
46
- )}. Page ids may only contain letters, numbers, "-" and "_".`,
47
- };
48
- }
49
-
50
- const configDirectory = process.env.LOWDEFY_DIRECTORY_CONFIG || process.cwd();
51
- const pageRelativePath = path.join('pages', `${pageId}.yaml`);
52
- // _ref paths in config use forward slashes on every platform.
53
- const pageRefPath = path.posix.join('pages', `${pageId}.yaml`);
54
- const pageFilePath = path.join(configDirectory, pageRelativePath);
55
-
56
- if (fs.existsSync(pageFilePath)) {
57
- return { error: `"${pageRelativePath}" already exists.` };
58
- }
59
-
60
- const pageRegistry = readBuildArtifact({ name: 'pageRegistry.json' }) ?? {};
61
- if (Object.keys(pageRegistry).includes(pageId)) {
62
- return {
63
- error: `Page id "${pageId}" is already used by another page in the build (see build/pageRegistry.json). Choose a different id.`,
64
- };
65
- }
66
-
67
- const pageTitle = title ?? pageId;
68
- fs.mkdirSync(path.dirname(pageFilePath), { recursive: true });
69
- fs.writeFileSync(pageFilePath, buildPageYaml({ pageId, title: pageTitle }));
70
-
71
- return {
72
- created: pageRelativePath,
73
- next: `Add \`- _ref: ${pageRefPath}\` under \`pages:\` in lowdefy.yaml (or the relevant pages file), then check lowdefy_build_status.`,
74
- };
75
- }
76
-
77
- export default scaffoldPage;
@@ -1,97 +0,0 @@
1
- /*
2
- Copyright 2020-2026 Lowdefy, Inc
3
-
4
- Licensed under the Apache License, Version 2.0 (the "License");
5
- you may not use this file except in compliance with the License.
6
- You may obtain a copy of the License at
7
-
8
- http://www.apache.org/licenses/LICENSE-2.0
9
-
10
- Unless required by applicable law or agreed to in writing, software
11
- distributed under the License is distributed on an "AS IS" BASIS,
12
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
- See the License for the specific language governing permissions and
14
- limitations under the License.
15
- */
16
-
17
- import fs from 'fs';
18
- import os from 'os';
19
- import path from 'path';
20
-
21
- import scaffoldPage from './scaffoldPage.js';
22
-
23
- let configDirectory;
24
- let previousConfigDirectory;
25
- let previousCwd;
26
-
27
- beforeEach(() => {
28
- configDirectory = fs.mkdtempSync(path.join(os.tmpdir(), 'lowdefy-scaffold-page-test-'));
29
- previousConfigDirectory = process.env.LOWDEFY_DIRECTORY_CONFIG;
30
- process.env.LOWDEFY_DIRECTORY_CONFIG = configDirectory;
31
- // readBuildArtifact.js (used to check pageRegistry.json) reads from process.cwd(), which is
32
- // the same directory as LOWDEFY_DIRECTORY_CONFIG in a real dev server run.
33
- previousCwd = process.cwd();
34
- process.chdir(configDirectory);
35
- });
36
-
37
- afterEach(() => {
38
- process.chdir(previousCwd);
39
- fs.rmSync(configDirectory, { recursive: true, force: true });
40
- if (previousConfigDirectory === undefined) {
41
- delete process.env.LOWDEFY_DIRECTORY_CONFIG;
42
- } else {
43
- process.env.LOWDEFY_DIRECTORY_CONFIG = previousConfigDirectory;
44
- }
45
- });
46
-
47
- test('scaffoldPage writes a canonical page file and reports the next step', () => {
48
- const result = scaffoldPage({ pageId: 'reports', title: 'Reports' });
49
-
50
- expect(result).toEqual({
51
- created: path.join('pages', 'reports.yaml'),
52
- next: 'Add `- _ref: pages/reports.yaml` under `pages:` in lowdefy.yaml (or the relevant pages file), then check lowdefy_build_status.',
53
- });
54
-
55
- const written = fs.readFileSync(path.join(configDirectory, 'pages', 'reports.yaml'), 'utf8');
56
- expect(written).toContain('id: reports');
57
- expect(written).toContain('type: PageHeaderMenu');
58
- expect(written).toContain('title: "Reports"');
59
- expect(written).toContain('type: Title');
60
- expect(written).toContain('content: "Reports"');
61
- });
62
-
63
- test('scaffoldPage defaults the title to the pageId when no title is given', () => {
64
- scaffoldPage({ pageId: 'dashboard' });
65
-
66
- const written = fs.readFileSync(path.join(configDirectory, 'pages', 'dashboard.yaml'), 'utf8');
67
- expect(written).toContain('title: "dashboard"');
68
- });
69
-
70
- test('scaffoldPage refuses an invalid page id', () => {
71
- const result = scaffoldPage({ pageId: 'has a space' });
72
-
73
- expect(result.error).toContain('Invalid page id');
74
- expect(fs.existsSync(path.join(configDirectory, 'pages', 'has a space.yaml'))).toBe(false);
75
- });
76
-
77
- test('scaffoldPage refuses when the page file already exists', () => {
78
- fs.mkdirSync(path.join(configDirectory, 'pages'), { recursive: true });
79
- fs.writeFileSync(path.join(configDirectory, 'pages', 'reports.yaml'), 'id: reports\n');
80
-
81
- const result = scaffoldPage({ pageId: 'reports' });
82
-
83
- expect(result.error).toEqual(`"${path.join('pages', 'reports.yaml')}" already exists.`);
84
- });
85
-
86
- test('scaffoldPage refuses when the pageId is already used in the build registry', () => {
87
- fs.mkdirSync(path.join(configDirectory, 'build'), { recursive: true });
88
- fs.writeFileSync(
89
- path.join(configDirectory, 'build', 'pageRegistry.json'),
90
- JSON.stringify({ reports: {} })
91
- );
92
-
93
- const result = scaffoldPage({ pageId: 'reports' });
94
-
95
- expect(result.error).toContain('Page id "reports" is already used');
96
- expect(fs.existsSync(path.join(configDirectory, 'pages', 'reports.yaml'))).toBe(false);
97
- });
@@ -1,67 +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 { buildPageUrl } from './getBrowser.js';
20
- import inspectState from './inspectState.js';
21
- import readPagePath from './readPagePath.js';
22
- import { writeCheckpoint } from './checkpointStore.js';
23
-
24
- // Snapshots the running app (page state + recorded request/api responses)
25
- // into a checkpoint folder under .lowdefy — see checkpointStore.js for the
26
- // on-disk layout. Reuses inspectState.js's tab-first/headless-fallback
27
- // snapshot rather than driving a browser directly, so a snapshot always
28
- // reflects whatever a developer is actually looking at when one is
29
- // available. With only a `pageId`, a tab's snapshot is of the instance it
30
- // names (see findPageInstance in tabChannel.js), and the checkpoint keeps that
31
- // instance's pathParams.
32
- async function snapshotState({ origin, pageId, pathParams, name, notes, source, overwrite }) {
33
- if (type.isNone(pageId) || !type.isString(pageId)) {
34
- return {
35
- error: `snapshotState requires a "pageId" string. Received ${JSON.stringify(pageId)}.`,
36
- };
37
- }
38
- if (type.isNone(name) || !type.isString(name)) {
39
- return { error: `snapshotState requires a "name" string. Received ${JSON.stringify(name)}.` };
40
- }
41
-
42
- const snapshot = await inspectState({ origin, pageId, pathParams, source });
43
- if (snapshot?.error) {
44
- return { error: snapshot.error, invalidInput: snapshot.invalidInput };
45
- }
46
-
47
- const url = `${buildPageUrl({
48
- origin,
49
- pageId,
50
- path: readPagePath({ pageId }),
51
- pathParams: snapshot.pathParams,
52
- })}${snapshot.urlQuery ?? ''}`;
53
-
54
- try {
55
- const { dir, parts } = writeCheckpoint({
56
- name,
57
- snapshot: { ...snapshot, url },
58
- notes,
59
- overwrite,
60
- });
61
- return { name, dir, parts, source: snapshot.source };
62
- } catch (error) {
63
- return { error: error.message };
64
- }
65
- }
66
-
67
- export default snapshotState;