@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
@@ -0,0 +1,73 @@
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 { findAndroidTool } from '@lowdefy/node-utils';
18
+
19
+ import listDevices from './listDevices.js';
20
+
21
+ /**
22
+ * What can reach a phone tab from outside the app, for the operations a simulator or emulator does
23
+ * more faithfully than Lowdefy Dev itself (a screenshot with the system UI, a real location or
24
+ * push). Resolves one of:
25
+ * - `{ kind: 'simulator', udid, name }`: the one booted iOS simulator (`xcrun simctl`).
26
+ * - `{ kind: 'android', serial, emulator, adb }`: the one Android device adb sees, an emulator or a
27
+ * USB phone through adb reverse.
28
+ * - `{ kind: 'view', reason }`: only Lowdefy Dev itself: a phone paired over the network, or no
29
+ * single simulator or device it could be.
30
+ * A tab on this computer's localhost is a simulator or an adb-reversed device, but with several
31
+ * booted the dev server cannot tell which one the tab is in, so it uses Lowdefy Dev's own capture.
32
+ *
33
+ * @param {Object} params
34
+ * @param {Object} params.tab The registered tab (tabChannel getTab), with its `device`.
35
+ * @param {Object} [params.devices] Options for listDevices (`run`, `adb`, `platform`).
36
+ */
37
+ async function findDeviceTarget({ tab, devices = {} }) {
38
+ const { platform, paired } = tab.device;
39
+ if (paired) {
40
+ return { kind: 'view', reason: 'the phone is paired over the network' };
41
+ }
42
+ if (platform !== 'ios' && platform !== 'android') {
43
+ return { kind: 'view', reason: 'Lowdefy Dev did not report its platform' };
44
+ }
45
+ const adb = devices.adb ?? findAndroidTool({ name: 'adb' });
46
+ const listed = await listDevices({ ...devices, adb, only: platform });
47
+ if (platform === 'ios') {
48
+ if (listed.simulators.length === 1) {
49
+ const [{ udid, name }] = listed.simulators;
50
+ return { kind: 'simulator', udid, name };
51
+ }
52
+ return {
53
+ kind: 'view',
54
+ reason:
55
+ listed.simulators.length === 0
56
+ ? `no booted iOS simulator was found (${listed.unavailable.join(' ') || 'none booted'})`
57
+ : `${listed.simulators.length} iOS simulators are booted, and the tab could be in any`,
58
+ };
59
+ }
60
+ if (listed.android.length === 1) {
61
+ const [{ serial, emulator }] = listed.android;
62
+ return { kind: 'android', serial, emulator, adb };
63
+ }
64
+ return {
65
+ kind: 'view',
66
+ reason:
67
+ listed.android.length === 0
68
+ ? `adb lists no Android device (${listed.unavailable.join(' ') || 'none connected'})`
69
+ : `adb lists ${listed.android.length} Android devices, and the tab could be on any`,
70
+ };
71
+ }
72
+
73
+ export default findDeviceTarget;
@@ -0,0 +1,160 @@
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 { type } from '@lowdefy/helpers';
22
+ import { runDeviceTool } from '@lowdefy/node-utils';
23
+
24
+ import buildDeviceCommand, { SIMCTL_PRIVACY_SERVICES } from './buildDeviceCommand.js';
25
+ import findDeviceTab from './findDeviceTab.js';
26
+ import findDeviceTarget from './findDeviceTarget.js';
27
+ import { requestFromTab } from '../tabChannel.js';
28
+
29
+ // The kinds an iOS simulator also does itself, more faithfully than Lowdefy Dev's own answer.
30
+ const SIMULATOR_KINDS = ['location', 'push', 'permission'];
31
+
32
+ // Lowdefy Dev's bundle id (shell.dev.json), for a shell that did not report its own.
33
+ const LOWDEFY_DEV_APP_ID = 'com.lowdefy.dev';
34
+
35
+ function appId(tab) {
36
+ return tab.device.app ?? LOWDEFY_DEV_APP_ID;
37
+ }
38
+
39
+ async function runWithFile({ contents, task }) {
40
+ const directory = await fs.promises.mkdtemp(path.join(os.tmpdir(), 'lowdefy-device-'));
41
+ const file = path.join(directory, 'payload.json');
42
+ try {
43
+ await fs.promises.writeFile(file, contents);
44
+ return await task(file);
45
+ } finally {
46
+ await fs.promises.rm(directory, { recursive: true, force: true });
47
+ }
48
+ }
49
+
50
+ // An APNs payload ({ aps }) on a simulator is delivered by simctl alone, as Apple's push service
51
+ // would deliver it. Any other push goes to Lowdefy Dev, which shows it with expo-notifications and
52
+ // can tap it or press a button.
53
+ function isApnsPayload(value) {
54
+ return type.isObject(value) && type.isObject(value.aps);
55
+ }
56
+
57
+ async function pushToSimulator({ tab, target, value, run }) {
58
+ await runWithFile({
59
+ contents: JSON.stringify(value),
60
+ task: (file) =>
61
+ run(
62
+ buildDeviceCommand({
63
+ action: 'simulator-push',
64
+ udid: target.udid,
65
+ bundleId: appId(tab),
66
+ file,
67
+ })
68
+ ),
69
+ });
70
+ return { ok: true, kind: 'push', via: 'simctl', simulator: target.name };
71
+ }
72
+
73
+ async function applyOnSimulator({ tab, target, kind, name, value, run }) {
74
+ if (kind === 'location') {
75
+ await run(buildDeviceCommand({ action: 'simulator-location', udid: target.udid, value }));
76
+ return { ok: true, simulator: target.name };
77
+ }
78
+ if (!SIMCTL_PRIVACY_SERVICES.includes(name)) {
79
+ return {
80
+ ok: false,
81
+ note: `The simulator has no privacy service "${name}" (simctl privacy knows ${SIMCTL_PRIVACY_SERVICES.join(
82
+ ', '
83
+ )}), so only Lowdefy Dev's answer was set.`,
84
+ };
85
+ }
86
+ await run(
87
+ buildDeviceCommand({
88
+ action: 'simulator-privacy',
89
+ udid: target.udid,
90
+ answer: value,
91
+ service: name,
92
+ bundleId: appId(tab),
93
+ })
94
+ );
95
+ return {
96
+ ok: true,
97
+ simulator: target.name,
98
+ note: 'iOS may restart the app when a permission changes; Lowdefy Dev then joins as a new tab (lowdefy_device list).',
99
+ };
100
+ }
101
+
102
+ /**
103
+ * lowdefy_device `inject`: fakes the phone's next device result. The injection goes to Lowdefy
104
+ * Dev's dev-tab client (`inject`, `{ kind, value, name }`), which device actions read, so it works
105
+ * on every phone. On an iOS simulator a location and a permission are also set on the simulator
106
+ * (`xcrun simctl location`, `simctl privacy`), and an APNs payload ({ aps }) is delivered by
107
+ * `simctl push` alone; any other push is shown by Lowdefy Dev.
108
+ * Resolves `{ device, kind, app, simulator? }` (what Lowdefy Dev answered, and what the simulator
109
+ * did), or `{ error }` with Lowdefy Dev's own message for an injection it refused.
110
+ *
111
+ * @param {Object} params
112
+ * @param {string} params.device The phone's tab id.
113
+ * @param {Object} params.inject `{ kind, value, name }`.
114
+ * @param {Object} [params.devices] Options for listDevices (`adb`, `platform`).
115
+ * @param {Function} [params.run] Runs one device command (runDeviceTool).
116
+ */
117
+ async function injectDevice({ device, inject, devices = {}, run = runDeviceTool }) {
118
+ const { tab, error } = findDeviceTab({ device });
119
+ if (!type.isUndefined(error)) {
120
+ return { error };
121
+ }
122
+ if (!type.isObject(inject) || !type.isString(inject.kind)) {
123
+ return {
124
+ error: `"inject" must be { kind, value, name }, kind one of scan, photo, nfc, transcript, location, permission, network, push, share, clear. Received ${JSON.stringify(
125
+ inject
126
+ )}.`,
127
+ };
128
+ }
129
+ const { kind, name, value } = inject;
130
+ let target = { kind: 'view' };
131
+ if (tab.device.platform === 'ios' && !tab.device.paired && SIMULATOR_KINDS.includes(kind)) {
132
+ target = await findDeviceTarget({ tab, devices: { ...devices, run } });
133
+ }
134
+ if (target.kind === 'simulator' && kind === 'push' && isApnsPayload(value)) {
135
+ try {
136
+ return { device: tab.id, ...(await pushToSimulator({ tab, target, value, run })) };
137
+ } catch (pushError) {
138
+ return { error: pushError.message };
139
+ }
140
+ }
141
+ const answer = await requestFromTab({
142
+ tabId: tab.id,
143
+ event: 'inject',
144
+ payload: { inject: { kind, value, name } },
145
+ });
146
+ if (!type.isUndefined(answer?.error)) {
147
+ return { error: answer.error };
148
+ }
149
+ const result = { device: tab.id, kind, app: answer };
150
+ if (target.kind === 'simulator') {
151
+ try {
152
+ result.simulator = await applyOnSimulator({ tab, target, kind, name, value, run });
153
+ } catch (simulatorError) {
154
+ result.simulator = { ok: false, error: simulatorError.message };
155
+ }
156
+ }
157
+ return result;
158
+ }
159
+
160
+ export default injectDevice;
@@ -0,0 +1,100 @@
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 { findAndroidTool, runDeviceTool } from '@lowdefy/node-utils';
18
+
19
+ import buildDeviceCommand from './buildDeviceCommand.js';
20
+
21
+ function parseSimulators(output) {
22
+ const { devices } = JSON.parse(output);
23
+ return Object.entries(devices ?? {})
24
+ .filter(([runtime]) => runtime.includes('.iOS-'))
25
+ .flatMap(([runtime, simulators]) =>
26
+ simulators
27
+ .filter((simulator) => simulator.state === 'Booted')
28
+ .map(({ udid, name }) => ({ udid, name, runtime: runtime.split('.').pop() }))
29
+ );
30
+ }
31
+
32
+ // `adb devices -l`: a header line, then `<serial> <state> key:value ...` per device.
33
+ function parseAndroidDevices(output) {
34
+ return output
35
+ .split('\n')
36
+ .slice(1)
37
+ .map((line) => line.trim().split(/\s+/))
38
+ .filter(([serial, state]) => serial && state === 'device')
39
+ .map(([serial, , ...details]) => {
40
+ const model = details.find((detail) => detail.startsWith('model:'));
41
+ return {
42
+ serial,
43
+ emulator: serial.startsWith('emulator-'),
44
+ model: model === undefined ? null : model.slice('model:'.length),
45
+ };
46
+ });
47
+ }
48
+
49
+ async function listSimulators({ platform, result, run }) {
50
+ if (platform !== 'darwin') {
51
+ result.unavailable.push('iOS simulators: they run only on macOS.');
52
+ return;
53
+ }
54
+ try {
55
+ result.simulators = parseSimulators(
56
+ await run(buildDeviceCommand({ action: 'list-simulators' }))
57
+ );
58
+ } catch (error) {
59
+ result.unavailable.push(`iOS simulators: ${error.message}`);
60
+ }
61
+ }
62
+
63
+ async function listAndroid({ adb, result, run }) {
64
+ try {
65
+ result.android = parseAndroidDevices(
66
+ await run(buildDeviceCommand({ action: 'list-android', adb }))
67
+ );
68
+ } catch (error) {
69
+ result.unavailable.push(`Android devices: ${error.message}`);
70
+ }
71
+ }
72
+
73
+ /**
74
+ * The booted iOS simulators and the Android devices (emulators and USB phones) on this computer,
75
+ * as `{ simulators, android, unavailable }`. A tool that is not installed lists nothing, and
76
+ * `unavailable` says which and why, so a Linux machine without Xcode still lists its emulators.
77
+ *
78
+ * @param {Object} [params]
79
+ * @param {string} [params.adb] The adb executable.
80
+ * @param {string} [params.platform] process.platform.
81
+ * @param {Function} [params.run] Runs one device command (runDeviceTool).
82
+ * @param {string} [params.only] 'ios' or 'android' to list one kind only.
83
+ */
84
+ async function listDevices({
85
+ adb = findAndroidTool({ name: 'adb' }),
86
+ only,
87
+ platform = process.platform,
88
+ run = runDeviceTool,
89
+ } = {}) {
90
+ const result = { simulators: [], android: [], unavailable: [] };
91
+ if (only !== 'android') {
92
+ await listSimulators({ platform, result, run });
93
+ }
94
+ if (only !== 'ios') {
95
+ await listAndroid({ adb, result, run });
96
+ }
97
+ return result;
98
+ }
99
+
100
+ export default listDevices;
@@ -0,0 +1,105 @@
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 { expect, test } from 'vitest';
18
+ import listDevices from './listDevices.js';
19
+
20
+ const SIMULATORS = JSON.stringify({
21
+ devices: {
22
+ 'com.apple.CoreSimulator.SimRuntime.iOS-18-2': [
23
+ { udid: 'SIM-1', name: 'iPhone 16', state: 'Booted' },
24
+ { udid: 'SIM-2', name: 'iPhone 16 Pro', state: 'Shutdown' },
25
+ ],
26
+ 'com.apple.CoreSimulator.SimRuntime.watchOS-11-2': [
27
+ { udid: 'WATCH-1', name: 'Apple Watch', state: 'Booted' },
28
+ ],
29
+ },
30
+ });
31
+
32
+ const ANDROID = [
33
+ 'List of devices attached',
34
+ 'emulator-5554 device product:sdk_gphone64 model:sdk_gphone64_arm64 device:emu64a transport_id:1',
35
+ 'R58N12ABC device usb:1-1 product:a52 model:SM_A525F device:a52q transport_id:2',
36
+ 'emulator-5556 offline transport_id:3',
37
+ '',
38
+ ].join('\n');
39
+
40
+ function fakeRun({ simulators = SIMULATORS, android = ANDROID } = {}) {
41
+ const calls = [];
42
+ async function run({ command, args }) {
43
+ calls.push([command, ...args]);
44
+ if (command === 'xcrun') {
45
+ if (simulators instanceof Error) throw simulators;
46
+ return simulators;
47
+ }
48
+ if (android instanceof Error) throw android;
49
+ return android;
50
+ }
51
+ return { calls, run };
52
+ }
53
+
54
+ test('listDevices lists the booted iOS simulators and the Android devices adb sees', async () => {
55
+ const { calls, run } = fakeRun();
56
+ const result = await listDevices({ adb: 'adb', platform: 'darwin', run });
57
+ expect(result).toEqual({
58
+ simulators: [{ udid: 'SIM-1', name: 'iPhone 16', runtime: 'iOS-18-2' }],
59
+ android: [
60
+ { serial: 'emulator-5554', emulator: true, model: 'sdk_gphone64_arm64' },
61
+ { serial: 'R58N12ABC', emulator: false, model: 'SM_A525F' },
62
+ ],
63
+ unavailable: [],
64
+ });
65
+ expect(calls).toEqual([
66
+ ['xcrun', 'simctl', 'list', 'devices', 'booted', '--json'],
67
+ ['adb', 'devices', '-l'],
68
+ ]);
69
+ });
70
+
71
+ test('listDevices runs no xcrun off macOS and says why', async () => {
72
+ const { calls, run } = fakeRun();
73
+ const result = await listDevices({ adb: 'adb', platform: 'linux', run });
74
+ expect(result.simulators).toEqual([]);
75
+ expect(result.android).toHaveLength(2);
76
+ expect(result.unavailable).toEqual(['iOS simulators: they run only on macOS.']);
77
+ expect(calls).toEqual([['adb', 'devices', '-l']]);
78
+ });
79
+
80
+ test('listDevices lists nothing for a tool that is not installed, and says which', async () => {
81
+ const { run } = fakeRun({
82
+ simulators: new Error('xcrun simctl list devices booted --json failed: spawn xcrun ENOENT'),
83
+ android: new Error('adb devices -l failed: spawn adb ENOENT'),
84
+ });
85
+ const result = await listDevices({ adb: 'adb', platform: 'darwin', run });
86
+ expect(result).toEqual({
87
+ simulators: [],
88
+ android: [],
89
+ unavailable: [
90
+ 'iOS simulators: xcrun simctl list devices booted --json failed: spawn xcrun ENOENT',
91
+ 'Android devices: adb devices -l failed: spawn adb ENOENT',
92
+ ],
93
+ });
94
+ });
95
+
96
+ test('listDevices lists one kind only when asked', async () => {
97
+ const ios = fakeRun();
98
+ expect(
99
+ (await listDevices({ adb: 'adb', platform: 'darwin', run: ios.run, only: 'ios' })).android
100
+ ).toEqual([]);
101
+ expect(ios.calls).toEqual([['xcrun', 'simctl', 'list', 'devices', 'booted', '--json']]);
102
+ const android = fakeRun();
103
+ await listDevices({ adb: 'adb', platform: 'darwin', run: android.run, only: 'android' });
104
+ expect(android.calls).toEqual([['adb', 'devices', '-l']]);
105
+ });
@@ -0,0 +1,68 @@
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 checkShownPage from './checkShownPage.js';
20
+ import findDeviceTab from './findDeviceTab.js';
21
+ import inspectStateFromTab from '../inspectStateFromTab.js';
22
+ import runDeviceSteps from './runDeviceSteps.js';
23
+ import selectFinalState from '../selectFinalState.js';
24
+
25
+ /**
26
+ * lowdefy_run_journey on a phone: the steps run on the page it shows (runDeviceSteps), and the
27
+ * result has the browser journey's shape: `{ pageId, device, passed, steps, screenshots, state |
28
+ * stateOmitted, failure? }`, with the phone's final page state. Resolves `{ error }` for a call it
29
+ * cannot run (no such phone, another page shown, a step a phone does not run).
30
+ *
31
+ * @param {Object} params
32
+ * @param {string} params.device The phone's tab id.
33
+ * @param {string} params.pageId The page the phone must show when the journey starts.
34
+ * @param {Object} [params.pathParams]
35
+ * @param {Object[]} params.steps
36
+ * @param {number} [params.stepTimeout]
37
+ * @param {boolean|string[]} [params.state] What the result carries of the final state.
38
+ */
39
+ async function runDeviceJourney({ device, pageId, pathParams, steps, stepTimeout, state }) {
40
+ const { tab, error } = findDeviceTab({ device });
41
+ if (!type.isUndefined(error)) {
42
+ return { error };
43
+ }
44
+ const notShown = checkShownPage({ tab, pageId, pathParams });
45
+ if (!type.isUndefined(notShown)) {
46
+ return { error: notShown };
47
+ }
48
+ const ran = await runDeviceSteps({ tabId: tab.id, steps, stepTimeout });
49
+ if (!type.isUndefined(ran.error)) {
50
+ return { error: ran.error };
51
+ }
52
+ const snapshot = await inspectStateFromTab({ tabId: tab.id });
53
+ const finalState = type.isUndefined(snapshot.error) ? snapshot.state : { error: snapshot.error };
54
+ const result = {
55
+ pageId,
56
+ device: tab.id,
57
+ passed: type.isUndefined(ran.failure),
58
+ steps: ran.results,
59
+ screenshots: ran.screenshots,
60
+ ...selectFinalState({ state: finalState, selection: state }),
61
+ };
62
+ if (!type.isUndefined(ran.failure)) {
63
+ result.failure = ran.failure;
64
+ }
65
+ return result;
66
+ }
67
+
68
+ export default runDeviceJourney;
@@ -0,0 +1,164 @@
1
+ /*
2
+ Copyright 2020-2026 Lowdefy, Inc
3
+
4
+ Licensed under the Apache License, Version 2.0 (the "License");
5
+ you may not use this file except in compliance with the License.
6
+ You may obtain a copy of the License at
7
+
8
+ http://www.apache.org/licenses/LICENSE-2.0
9
+
10
+ Unless required by applicable law or agreed to in writing, software
11
+ distributed under the License is distributed on an "AS IS" BASIS,
12
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ See the License for the specific language governing permissions and
14
+ limitations under the License.
15
+ */
16
+
17
+ import { get, type, wait } from '@lowdefy/helpers';
18
+ import { getStepKey } from '@lowdefy/node-utils';
19
+
20
+ import inspectStateFromTab from '../inspectStateFromTab.js';
21
+ import isDeepEqual from '../isDeepEqual.js';
22
+ import JourneyStepError from '../JourneyStepError.js';
23
+ import sendDeviceStep from './sendDeviceStep.js';
24
+
25
+ // The steps Lowdefy Dev runs itself (shell src/dev/steps/createStepRunner.js), by block id.
26
+ const PHONE_STEPS = ['click', 'fill', 'select', 'press', 'wait', 'screenshot'];
27
+ const POLL_MS = 100;
28
+
29
+ function describeUnsupported(step) {
30
+ const key = getStepKey(step);
31
+ if (key === 'expect') {
32
+ return `{"expect": ${JSON.stringify(
33
+ Object.keys(step.expect ?? {})
34
+ )}} (a phone checks only "state")`;
35
+ }
36
+ return `"${key}"`;
37
+ }
38
+
39
+ function isSupported(step) {
40
+ if (!type.isObject(step) || Object.keys(step).length !== 1) {
41
+ return false;
42
+ }
43
+ const key = getStepKey(step);
44
+ if (PHONE_STEPS.includes(key)) {
45
+ return true;
46
+ }
47
+ return (
48
+ key === 'expect' &&
49
+ type.isObject(step.expect) &&
50
+ Object.keys(step.expect).length === 1 &&
51
+ type.isObject(step.expect.state) &&
52
+ type.isString(step.expect.state.path)
53
+ );
54
+ }
55
+
56
+ async function readStateValue({ tabId, path }) {
57
+ const snapshot = await inspectStateFromTab({ tabId });
58
+ if (!type.isUndefined(snapshot.error)) {
59
+ return { error: new Error(snapshot.error) };
60
+ }
61
+ return { value: get(snapshot.state ?? {}, path) ?? null };
62
+ }
63
+
64
+ // Polled, as in the browser: the value a tap leads to often lands once its request has answered.
65
+ async function expectState({ tabId, params, stepTimeout }) {
66
+ const { path, equals } = params;
67
+ const deadline = Date.now() + stepTimeout;
68
+ let read = await readStateValue({ tabId, path });
69
+ while (
70
+ (!type.isUndefined(read.error) || !isDeepEqual(read.value, equals)) &&
71
+ Date.now() < deadline
72
+ ) {
73
+ await wait(POLL_MS);
74
+ read = await readStateValue({ tabId, path });
75
+ }
76
+ if (!type.isUndefined(read.error)) {
77
+ throw read.error;
78
+ }
79
+ if (!isDeepEqual(read.value, equals)) {
80
+ throw new JourneyStepError(
81
+ `Expected state "${path}" to equal ${JSON.stringify(equals)} but found ${JSON.stringify(
82
+ read.value
83
+ )}.`,
84
+ { expected: equals, actual: read.value }
85
+ );
86
+ }
87
+ }
88
+
89
+ function toFailure({ error, index, step }) {
90
+ if (error instanceof JourneyStepError) {
91
+ return {
92
+ index,
93
+ step,
94
+ expected: error.expected,
95
+ actual: type.isUndefined(error.actual) ? null : error.actual,
96
+ message: error.message,
97
+ };
98
+ }
99
+ return {
100
+ index,
101
+ step,
102
+ expected: `step ${index} (${getStepKey(step)}) to complete`,
103
+ actual: error.message,
104
+ message: error.message,
105
+ };
106
+ }
107
+
108
+ /**
109
+ * Runs journey steps on a phone, in order, stopping at the first that fails. Lowdefy Dev runs
110
+ * click, fill, select, press, wait and screenshot itself, by block id, through the engine; an
111
+ * `expect: { state }` is read from its live state. Any other step is refused before the first
112
+ * runs, as `{ error }`. Otherwise resolves `{ results, screenshots, failure }`, as the browser's
113
+ * runner does: a failed step is a result, not an error.
114
+ *
115
+ * @param {Object} params
116
+ * @param {string} params.tabId The phone's tab.
117
+ * @param {Object[]} [params.steps]
118
+ * @param {number} [params.stepTimeout] How long each step waits, in ms.
119
+ */
120
+ async function runDeviceSteps({ tabId, steps = [], stepTimeout = 5000 }) {
121
+ const unsupported = steps.filter((step) => !isSupported(step));
122
+ if (unsupported.length > 0) {
123
+ return {
124
+ error: `A phone runs the steps ${PHONE_STEPS.join(
125
+ ', '
126
+ )} and expect with "state", by blockId. Not supported on a phone: ${unsupported
127
+ .map(describeUnsupported)
128
+ .join(', ')}.`,
129
+ };
130
+ }
131
+ const results = [];
132
+ const screenshots = [];
133
+ let failure;
134
+ for (let index = 0; index < steps.length; index += 1) {
135
+ const step = steps[index];
136
+ if (!type.isUndefined(failure)) {
137
+ results.push({ index, step, status: 'skipped', durationMs: 0 });
138
+ continue;
139
+ }
140
+ const started = Date.now();
141
+ try {
142
+ if (getStepKey(step) === 'expect') {
143
+ await expectState({ tabId, params: step.expect.state, stepTimeout });
144
+ } else {
145
+ const answer = await sendDeviceStep({ tabId, step, stepTimeout });
146
+ if (getStepKey(step) === 'screenshot') {
147
+ screenshots.push({
148
+ name: type.isString(step.screenshot) ? step.screenshot : `step-${index}`,
149
+ data: answer.image,
150
+ mimeType: 'image/png',
151
+ });
152
+ }
153
+ }
154
+ results.push({ index, step, status: 'ok', durationMs: Date.now() - started });
155
+ } catch (error) {
156
+ failure = toFailure({ error, index, step });
157
+ results.push({ index, step, status: 'failed', durationMs: Date.now() - started });
158
+ }
159
+ }
160
+ return { results, screenshots, failure };
161
+ }
162
+
163
+ export { PHONE_STEPS };
164
+ export default runDeviceSteps;