@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,604 @@
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 { vi, afterEach, expect, test } from 'vitest';
21
+
22
+ import setupTestFixtures from '../setupTestFixtures.mjs';
23
+
24
+ // inspectState imports getBrowser, which reads build/config.json from the working
25
+ // directory at import.
26
+ const fixtureDir = setupTestFixtures();
27
+ process.chdir(fixtureDir);
28
+ process.env.LOWDEFY_DIRECTORY_CONFIG = fixtureDir;
29
+
30
+ vi.doMock('playwright-core', () => ({
31
+ chromium: { launch: vi.fn().mockRejectedValue(new Error("Executable doesn't exist")) },
32
+ }));
33
+ vi.doMock('../installHeadlessShell.js', () => ({ default: () => null }));
34
+
35
+ const { default: createFakePhoneTab, VIEW_PNG } = await import('./createFakePhoneTab.mjs');
36
+ const { default: deviceAction } = await import('./deviceAction.js');
37
+ const { default: injectDevice } = await import('./injectDevice.js');
38
+ const { default: inspectState } = await import('../inspectState.js');
39
+ const { default: runDeviceJourney } = await import('./runDeviceJourney.js');
40
+ const { default: screenshotDevice } = await import('./screenshotDevice.js');
41
+ const { default: startDevice } = await import('./startDevice.js');
42
+ const { registerTab, unregisterTab, updateTabPage } = await import('../tabChannel.js');
43
+
44
+ const TICKET = { pageId: 'ticket', pathParams: {}, instanceKey: 'page:ticket' };
45
+ const SIMULATOR = { shell: '7.1.0', platform: 'ios', app: 'com.lowdefy.dev', paired: false };
46
+ const EMULATOR = { shell: '7.1.0', platform: 'android', app: 'com.lowdefy.dev', paired: false };
47
+ const PAIRED = { shell: '7.1.0', platform: 'ios', app: 'com.lowdefy.dev', paired: true };
48
+
49
+ const ONE_SIMULATOR = JSON.stringify({
50
+ devices: {
51
+ 'com.apple.CoreSimulator.SimRuntime.iOS-18-2': [
52
+ { udid: 'SIM-1', name: 'iPhone 16', state: 'Booted' },
53
+ ],
54
+ },
55
+ });
56
+ const TWO_SIMULATORS = JSON.stringify({
57
+ devices: {
58
+ 'com.apple.CoreSimulator.SimRuntime.iOS-18-2': [
59
+ { udid: 'SIM-1', name: 'iPhone 16', state: 'Booted' },
60
+ { udid: 'SIM-2', name: 'iPhone 16 Pro', state: 'Booted' },
61
+ ],
62
+ },
63
+ });
64
+ const ONE_EMULATOR = 'List of devices attached\nemulator-5554 device model:sdk_gphone64\n';
65
+
66
+ // Stands in for runDeviceTool: records each command line and answers the listings. A simulator
67
+ // screenshot writes its PNG to the file the command names, as simctl does.
68
+ function fakeRun({ simulators = ONE_SIMULATOR, android = ONE_EMULATOR } = {}) {
69
+ const calls = [];
70
+ async function run({ command, args, encoding }) {
71
+ calls.push([command, ...args]);
72
+ if (args.includes('list')) return simulators;
73
+ if (args[0] === 'devices') return android;
74
+ if (args.includes('screenshot')) {
75
+ fs.writeFileSync(args[args.length - 1], 'SIM-PNG');
76
+ return '';
77
+ }
78
+ if (args.includes('screencap')) {
79
+ expect(encoding).toEqual('buffer');
80
+ return Buffer.from('ADB-PNG');
81
+ }
82
+ if (args.includes('push')) {
83
+ calls.push(['payload', JSON.parse(fs.readFileSync(args[args.length - 1], 'utf8'))]);
84
+ }
85
+ return '';
86
+ }
87
+ return { calls, run };
88
+ }
89
+
90
+ const devices = { adb: 'adb', platform: 'darwin' };
91
+
92
+ let phone;
93
+ afterEach(() => {
94
+ phone?.close();
95
+ phone = undefined;
96
+ });
97
+
98
+ function events() {
99
+ return phone.requests.map(({ event, data }) => [event, data.step ?? data.inject ?? null]);
100
+ }
101
+
102
+ test('screenshotDevice runs steps on the phone, then captures a lone simulator with simctl', async () => {
103
+ phone = createFakePhoneTab({ id: 'phone-1', device: SIMULATOR, page: TICKET });
104
+ const { calls, run } = fakeRun();
105
+ const result = await screenshotDevice({
106
+ device: 'phone-1',
107
+ pageId: 'ticket',
108
+ steps: [{ fill: { blockId: 'title', value: 'Leak' } }, { click: 'save' }],
109
+ devices,
110
+ run,
111
+ });
112
+ expect(events()).toEqual([
113
+ ['step-request', { fill: { blockId: 'title', value: 'Leak' } }],
114
+ ['step-request', { click: 'save' }],
115
+ ]);
116
+ expect(result).toMatchObject({
117
+ data: Buffer.from('SIM-PNG').toString('base64'),
118
+ mimeType: 'image/png',
119
+ capture: 'simctl',
120
+ device: 'phone-1',
121
+ screenshots: [],
122
+ });
123
+ expect(result.failure).toBeUndefined();
124
+ expect(calls[0]).toEqual(['xcrun', 'simctl', 'list', 'devices', 'booted', '--json']);
125
+ expect(calls.at(-1).slice(0, 6)).toEqual([
126
+ 'xcrun',
127
+ 'simctl',
128
+ 'io',
129
+ 'SIM-1',
130
+ 'screenshot',
131
+ '--type=png',
132
+ ]);
133
+ });
134
+
135
+ test('screenshotDevice captures a lone Android device with adb', async () => {
136
+ phone = createFakePhoneTab({ id: 'phone-1', device: EMULATOR, page: TICKET });
137
+ const { calls, run } = fakeRun();
138
+ const result = await screenshotDevice({ device: 'phone-1', pageId: 'ticket', devices, run });
139
+ expect(result.capture).toEqual('adb');
140
+ expect(result.data).toEqual(Buffer.from('ADB-PNG').toString('base64'));
141
+ expect(calls.at(-1)).toEqual(['adb', '-s', 'emulator-5554', 'exec-out', 'screencap', '-p']);
142
+ });
143
+
144
+ test('screenshotDevice lets a paired phone capture its own view, running no device tool', async () => {
145
+ phone = createFakePhoneTab({ id: 'phone-1', device: PAIRED, page: TICKET });
146
+ const { calls, run } = fakeRun();
147
+ const result = await screenshotDevice({ device: 'phone-1', pageId: 'ticket', devices, run });
148
+ expect(calls).toEqual([]);
149
+ expect(events()).toEqual([['step-request', { screenshot: null }]]);
150
+ expect(result).toMatchObject({ data: VIEW_PNG, capture: 'view' });
151
+ expect(result.note).toContain('paired over the network');
152
+ });
153
+
154
+ test('screenshotDevice falls back to the view when several simulators could hold the tab', async () => {
155
+ phone = createFakePhoneTab({ id: 'phone-1', device: SIMULATOR, page: TICKET });
156
+ const { run } = fakeRun({ simulators: TWO_SIMULATORS });
157
+ const result = await screenshotDevice({ device: 'phone-1', pageId: 'ticket', devices, run });
158
+ expect(result.capture).toEqual('view');
159
+ expect(result.note).toContain('2 iOS simulators are booted');
160
+ });
161
+
162
+ test('screenshotDevice falls back to the view when simctl fails', async () => {
163
+ phone = createFakePhoneTab({ id: 'phone-1', device: SIMULATOR, page: TICKET });
164
+ const { run: listRun } = fakeRun();
165
+ const run = async (command) => {
166
+ if (command.args.includes('screenshot')) throw new Error('simctl io failed: device busy');
167
+ return listRun(command);
168
+ };
169
+ const result = await screenshotDevice({ device: 'phone-1', pageId: 'ticket', devices, run });
170
+ expect(result.capture).toEqual('view');
171
+ expect(result.note).toContain('simctl io failed: device busy');
172
+ });
173
+
174
+ test('screenshotDevice returns a failed step beside the capture, the later steps skipped', async () => {
175
+ phone = createFakePhoneTab({
176
+ id: 'phone-1',
177
+ device: PAIRED,
178
+ page: TICKET,
179
+ answer: (event, data) =>
180
+ data.step?.click === 'missing' ? { error: 'No block "missing" on the page.' } : undefined,
181
+ });
182
+ const result = await screenshotDevice({
183
+ device: 'phone-1',
184
+ pageId: 'ticket',
185
+ steps: [{ click: 'missing' }, { click: 'save' }],
186
+ devices,
187
+ run: fakeRun().run,
188
+ });
189
+ expect(result.failure).toEqual({
190
+ index: 0,
191
+ step: { click: 'missing' },
192
+ expected: 'step 0 (click) to complete',
193
+ actual: 'No block "missing" on the page.',
194
+ message: 'No block "missing" on the page.',
195
+ });
196
+ expect(events()).toEqual([
197
+ ['step-request', { click: 'missing' }],
198
+ ['step-request', { screenshot: null }],
199
+ ]);
200
+ expect(result.data).toEqual(VIEW_PNG);
201
+ });
202
+
203
+ test('screenshotDevice returns screenshot step captures from the phone', async () => {
204
+ phone = createFakePhoneTab({ id: 'phone-1', device: PAIRED, page: TICKET });
205
+ const result = await screenshotDevice({
206
+ device: 'phone-1',
207
+ pageId: 'ticket',
208
+ steps: [{ screenshot: 'before' }, { click: 'save' }],
209
+ devices,
210
+ run: fakeRun().run,
211
+ });
212
+ expect(result.screenshots).toEqual([{ name: 'before', data: VIEW_PNG, mimeType: 'image/png' }]);
213
+ });
214
+
215
+ test('screenshotDevice refuses a step a phone does not run, before running any', async () => {
216
+ phone = createFakePhoneTab({ id: 'phone-1', device: SIMULATOR, page: TICKET });
217
+ const result = await screenshotDevice({
218
+ device: 'phone-1',
219
+ pageId: 'ticket',
220
+ steps: [{ click: 'save' }, { open: 'status' }, { expect: { visible: 'save' } }],
221
+ devices,
222
+ run: fakeRun().run,
223
+ });
224
+ expect(result.error).toEqual(
225
+ 'A phone runs the steps click, fill, select, press, wait, screenshot and expect with "state", by blockId. Not supported on a phone: "open", {"expect": ["visible"]} (a phone checks only "state").'
226
+ );
227
+ expect(phone.requests).toEqual([]);
228
+ });
229
+
230
+ test('screenshotDevice refuses a page the phone does not show', async () => {
231
+ phone = createFakePhoneTab({ id: 'phone-1', device: SIMULATOR, page: TICKET });
232
+ const result = await screenshotDevice({ device: 'phone-1', pageId: 'home', devices });
233
+ expect(result.error).toContain('shows page "ticket", not "home"');
234
+ expect(phone.requests).toEqual([]);
235
+ });
236
+
237
+ test('screenshotDevice refuses an unknown tab and a browser tab', async () => {
238
+ expect((await screenshotDevice({ device: 'nope', pageId: 'ticket' })).error).toContain(
239
+ 'No phone is connected as tab "nope"'
240
+ );
241
+ registerTab({ id: 'browser-1', send: () => undefined });
242
+ expect((await screenshotDevice({ device: 'browser-1', pageId: 'ticket' })).error).toContain(
243
+ 'is a browser tab, not a phone'
244
+ );
245
+ unregisterTab({ id: 'browser-1' });
246
+ });
247
+
248
+ test('inspectState with device reads that phone, not a browser tab on the same page', async () => {
249
+ registerTab({ id: 'browser-1', send: () => undefined });
250
+ updateTabPage({ id: 'browser-1', ...TICKET });
251
+ phone = createFakePhoneTab({
252
+ id: 'phone-1',
253
+ device: SIMULATOR,
254
+ page: TICKET,
255
+ state: { title: 'From the phone' },
256
+ });
257
+ const result = await inspectState({ pageId: 'ticket', device: 'phone-1' });
258
+ expect(result).toMatchObject({
259
+ source: 'tab',
260
+ device: 'phone-1',
261
+ state: { title: 'From the phone' },
262
+ });
263
+ expect(phone.requests.map(({ event, data }) => [event, data.instanceKey])).toEqual([
264
+ ['inspect-request', 'page:ticket'],
265
+ ]);
266
+ unregisterTab({ id: 'browser-1' });
267
+ });
268
+
269
+ test('inspectState with device refuses source headless, user and a missing phone', async () => {
270
+ phone = createFakePhoneTab({ id: 'phone-1', device: SIMULATOR, page: TICKET });
271
+ expect(
272
+ await inspectState({ pageId: 'ticket', device: 'phone-1', source: 'headless' })
273
+ ).toMatchObject({ invalidInput: true });
274
+ expect(
275
+ (await inspectState({ pageId: 'ticket', device: 'phone-1', user: { roles: ['admin'] } })).error
276
+ ).toContain('cannot apply "user" to a phone');
277
+ expect((await inspectState({ pageId: 'ticket', device: 'gone' })).error).toContain(
278
+ 'No phone is connected as tab "gone"'
279
+ );
280
+ });
281
+
282
+ test('inspectState with device refuses a page the phone has not shown', async () => {
283
+ phone = createFakePhoneTab({ id: 'phone-1', device: SIMULATOR, page: TICKET });
284
+ const result = await inspectState({ pageId: 'home', device: 'phone-1' });
285
+ expect(result.error).toContain('Tab "phone-1" has not shown page "home"');
286
+ });
287
+
288
+ test.each([
289
+ ['scan', { kind: 'scan', value: { data: 'JOB-42' } }],
290
+ ['photo', { kind: 'photo', value: { base64: 'iVBOR' } }],
291
+ ['nfc', { kind: 'nfc', value: { id: '04:A2' } }],
292
+ ['location', { kind: 'location', value: { latitude: -33.92, longitude: 18.42 } }],
293
+ ['permission', { kind: 'permission', name: 'camera', value: 'denied' }],
294
+ ['network', { kind: 'network', value: 'offline' }],
295
+ ['push', { kind: 'push', value: { aps: { alert: 'Hi' } } }],
296
+ ['clear', { kind: 'clear' }],
297
+ ])('injectDevice forwards a %s injection to Lowdefy Dev', async (kind, inject) => {
298
+ phone = createFakePhoneTab({ id: 'phone-1', device: EMULATOR, page: TICKET });
299
+ const { calls, run } = fakeRun();
300
+ const result = await injectDevice({ device: 'phone-1', inject, devices, run });
301
+ expect(phone.requests.map(({ event, data }) => [event, data.inject])).toEqual([
302
+ ['inject', { kind: inject.kind, value: inject.value, name: inject.name }],
303
+ ]);
304
+ expect(result).toEqual({ device: 'phone-1', kind, app: { ok: true, kind } });
305
+ expect(calls).toEqual([]);
306
+ });
307
+
308
+ test('injectDevice returns what Lowdefy Dev refused', async () => {
309
+ phone = createFakePhoneTab({
310
+ id: 'phone-1',
311
+ device: EMULATOR,
312
+ page: TICKET,
313
+ answer: () => ({ error: 'A scan injection needs { data }. Received "JOB-42".' }),
314
+ });
315
+ const result = await injectDevice({
316
+ device: 'phone-1',
317
+ inject: { kind: 'scan', value: 'JOB-42' },
318
+ devices,
319
+ run: fakeRun().run,
320
+ });
321
+ expect(result).toEqual({ error: 'A scan injection needs { data }. Received "JOB-42".' });
322
+ });
323
+
324
+ test('injectDevice also sets a location on the simulator with simctl', async () => {
325
+ phone = createFakePhoneTab({ id: 'phone-1', device: SIMULATOR, page: TICKET });
326
+ const { calls, run } = fakeRun();
327
+ const value = [
328
+ { latitude: -33.92, longitude: 18.42 },
329
+ { latitude: -33.93, longitude: 18.43 },
330
+ ];
331
+ const result = await injectDevice({
332
+ device: 'phone-1',
333
+ inject: { kind: 'location', value },
334
+ devices,
335
+ run,
336
+ });
337
+ expect(phone.requests).toHaveLength(1);
338
+ expect(calls.at(-1)).toEqual([
339
+ 'xcrun',
340
+ 'simctl',
341
+ 'location',
342
+ 'SIM-1',
343
+ 'start',
344
+ '-33.92,18.42',
345
+ '-33.93,18.43',
346
+ ]);
347
+ expect(result.simulator).toEqual({ ok: true, simulator: 'iPhone 16' });
348
+ });
349
+
350
+ test('injectDevice delivers a push to the simulator with simctl alone', async () => {
351
+ phone = createFakePhoneTab({ id: 'phone-1', device: SIMULATOR, page: TICKET });
352
+ const { calls, run } = fakeRun();
353
+ const payload = { aps: { alert: { title: 'New ticket', body: 'Ticket 7' } } };
354
+ const result = await injectDevice({
355
+ device: 'phone-1',
356
+ inject: { kind: 'push', value: payload },
357
+ devices,
358
+ run,
359
+ });
360
+ expect(phone.requests).toEqual([]);
361
+ const push = calls.find((call) => call.includes('push'));
362
+ expect(push.slice(0, 5)).toEqual(['xcrun', 'simctl', 'push', 'SIM-1', 'com.lowdefy.dev']);
363
+ expect(calls.at(-1)).toEqual(['payload', payload]);
364
+ expect(result).toEqual({
365
+ device: 'phone-1',
366
+ ok: true,
367
+ kind: 'push',
368
+ via: 'simctl',
369
+ simulator: 'iPhone 16',
370
+ });
371
+ });
372
+
373
+ test('injectDevice sends a push without aps to Lowdefy Dev, even on a simulator', async () => {
374
+ phone = createFakePhoneTab({ id: 'phone-1', device: SIMULATOR, page: TICKET });
375
+ const { calls, run } = fakeRun();
376
+ const result = await injectDevice({
377
+ device: 'phone-1',
378
+ inject: { kind: 'push', value: { title: 'Hi' } },
379
+ devices,
380
+ run,
381
+ });
382
+ expect(result.error).toBeUndefined();
383
+ expect(phone.requests).toHaveLength(1);
384
+ expect(calls.some((call) => call.includes('push'))).toBe(false);
385
+ });
386
+
387
+ test('injectDevice grants a permission on the simulator after Lowdefy Dev answers it', async () => {
388
+ phone = createFakePhoneTab({ id: 'phone-1', device: SIMULATOR, page: TICKET });
389
+ const { calls, run } = fakeRun();
390
+ const result = await injectDevice({
391
+ device: 'phone-1',
392
+ inject: { kind: 'permission', name: 'location', value: 'granted' },
393
+ devices,
394
+ run,
395
+ });
396
+ expect(phone.requests).toHaveLength(1);
397
+ expect(calls.at(-1)).toEqual([
398
+ 'xcrun',
399
+ 'simctl',
400
+ 'privacy',
401
+ 'SIM-1',
402
+ 'grant',
403
+ 'location',
404
+ 'com.lowdefy.dev',
405
+ ]);
406
+ expect(result.simulator.ok).toBe(true);
407
+ });
408
+
409
+ test('injectDevice leaves a permission the simulator has no service for to Lowdefy Dev', async () => {
410
+ phone = createFakePhoneTab({ id: 'phone-1', device: SIMULATOR, page: TICKET });
411
+ const { calls, run } = fakeRun();
412
+ const result = await injectDevice({
413
+ device: 'phone-1',
414
+ inject: { kind: 'permission', name: 'camera', value: 'denied' },
415
+ devices,
416
+ run,
417
+ });
418
+ expect(calls.some((call) => call.includes('privacy'))).toBe(false);
419
+ expect(result.simulator.ok).toBe(false);
420
+ expect(result.simulator.note).toContain('no privacy service "camera"');
421
+ });
422
+
423
+ test('injectDevice runs no simctl for a phone paired over the network', async () => {
424
+ phone = createFakePhoneTab({ id: 'phone-1', device: PAIRED, page: TICKET });
425
+ const { calls, run } = fakeRun();
426
+ await injectDevice({
427
+ device: 'phone-1',
428
+ inject: { kind: 'location', value: { latitude: 1, longitude: 2 } },
429
+ devices,
430
+ run,
431
+ });
432
+ expect(calls).toEqual([]);
433
+ expect(phone.requests).toHaveLength(1);
434
+ });
435
+
436
+ test('runDeviceJourney runs the steps on the phone and checks its state', async () => {
437
+ phone = createFakePhoneTab({ id: 'phone-1', device: PAIRED, page: TICKET });
438
+ const result = await runDeviceJourney({
439
+ device: 'phone-1',
440
+ pageId: 'ticket',
441
+ steps: [
442
+ { fill: { blockId: 'title', value: 'Leak' } },
443
+ { click: 'save' },
444
+ { expect: { state: { path: 'title', equals: 'Leak' } } },
445
+ ],
446
+ });
447
+ expect(result).toMatchObject({
448
+ pageId: 'ticket',
449
+ device: 'phone-1',
450
+ passed: true,
451
+ state: { title: 'Leak' },
452
+ screenshots: [],
453
+ });
454
+ expect(result.steps.map(({ status }) => status)).toEqual(['ok', 'ok', 'ok']);
455
+ });
456
+
457
+ test('runDeviceJourney fails at an expect state that does not hold, with expected and actual', async () => {
458
+ phone = createFakePhoneTab({ id: 'phone-1', device: PAIRED, page: TICKET, state: { n: 1 } });
459
+ const result = await runDeviceJourney({
460
+ device: 'phone-1',
461
+ pageId: 'ticket',
462
+ steps: [{ expect: { state: { path: 'n', equals: 2 } } }, { click: 'save' }],
463
+ stepTimeout: 50,
464
+ });
465
+ expect(result.passed).toBe(false);
466
+ expect(result.failure).toEqual({
467
+ index: 0,
468
+ step: { expect: { state: { path: 'n', equals: 2 } } },
469
+ expected: 2,
470
+ actual: 1,
471
+ message: 'Expected state "n" to equal 2 but found 1.',
472
+ });
473
+ expect(result.steps.map(({ status }) => status)).toEqual(['failed', 'skipped']);
474
+ });
475
+
476
+ test('startDevice boots a simulator, installs Lowdefy Dev and opens it on this server', async () => {
477
+ const appPath = path.join(fixtureDir, 'LowdefyDev.app');
478
+ fs.mkdirSync(appPath, { recursive: true });
479
+ process.env.LOWDEFY_DEV_APP_IOS = appPath;
480
+ const calls = [];
481
+ const run = async ({ command, args }) => {
482
+ calls.push([command, ...args]);
483
+ if (args.includes('available')) {
484
+ return JSON.stringify({
485
+ devices: {
486
+ 'com.apple.CoreSimulator.SimRuntime.iOS-18-2': [
487
+ { udid: 'SIM-1', name: 'iPhone 16', state: 'Shutdown' },
488
+ ],
489
+ },
490
+ });
491
+ }
492
+ if (args.includes('openurl')) {
493
+ setTimeout(() => {
494
+ phone = createFakePhoneTab({ id: 'phone-new', device: SIMULATOR });
495
+ }, 10);
496
+ }
497
+ return '';
498
+ };
499
+ const result = await startDevice({
500
+ platform: 'ios',
501
+ origin: 'http://localhost:3005',
502
+ hostPlatform: 'darwin',
503
+ run,
504
+ tabTimeout: 2000,
505
+ });
506
+ expect(calls).toEqual([
507
+ ['xcrun', 'simctl', 'list', 'devices', 'available', '--json'],
508
+ ['xcrun', 'simctl', 'boot', 'SIM-1'],
509
+ ['open', '-a', 'Simulator'],
510
+ ['xcrun', 'simctl', 'bootstatus', 'SIM-1'],
511
+ ['xcrun', 'simctl', 'install', 'SIM-1', appPath],
512
+ [
513
+ 'xcrun',
514
+ 'simctl',
515
+ 'openurl',
516
+ 'SIM-1',
517
+ 'lowdefy-dev://connect?url=http%3A%2F%2Flocalhost%3A3005',
518
+ ],
519
+ ]);
520
+ expect(result).toEqual({
521
+ started: true,
522
+ platform: 'ios',
523
+ url: 'http://localhost:3005',
524
+ simulator: { udid: 'SIM-1', name: 'iPhone 16' },
525
+ device: 'phone-new',
526
+ });
527
+ });
528
+
529
+ test('startDevice installs on an Android device, reverses the port and opens the link', async () => {
530
+ const appPath = path.join(fixtureDir, 'lowdefy-dev.apk');
531
+ fs.writeFileSync(appPath, '');
532
+ process.env.LOWDEFY_DEV_APP_ANDROID = appPath;
533
+ const calls = [];
534
+ const run = async ({ command, args }) => {
535
+ calls.push([command, ...args]);
536
+ if (args[0] === 'devices') return 'List of devices attached\nemulator-5554\tdevice\n';
537
+ return '';
538
+ };
539
+ const result = await startDevice({
540
+ platform: 'android',
541
+ origin: 'http://localhost:3005',
542
+ run,
543
+ tabTimeout: 10,
544
+ });
545
+ const adb = calls[0][0];
546
+ expect(calls).toEqual([
547
+ [adb, 'devices'],
548
+ [adb, '-s', 'emulator-5554', 'install', '-r', appPath],
549
+ [adb, '-s', 'emulator-5554', 'reverse', 'tcp:3005', 'tcp:3005'],
550
+ [
551
+ adb,
552
+ '-s',
553
+ 'emulator-5554',
554
+ 'shell',
555
+ 'am',
556
+ 'start',
557
+ '-a',
558
+ 'android.intent.action.VIEW',
559
+ '-d',
560
+ "'lowdefy-dev://connect?url=http%3A%2F%2Flocalhost%3A3005'",
561
+ ],
562
+ ]);
563
+ expect(result.device).toBeNull();
564
+ expect(result.note).toContain('has not joined as a tab');
565
+ });
566
+
567
+ test('startDevice refuses the iOS simulator off macOS and an unknown platform', async () => {
568
+ expect(
569
+ (await startDevice({ platform: 'ios', origin: 'http://localhost:3005', hostPlatform: 'linux' }))
570
+ .error
571
+ ).toContain('runs only on macOS');
572
+ expect((await startDevice({ platform: 'watch', origin: 'http://localhost:3005' })).error).toEqual(
573
+ 'start needs "platform" "ios" or "android". Received "watch".'
574
+ );
575
+ });
576
+
577
+ test('deviceAction list names each connected phone by tab id, and the simulators and devices', async () => {
578
+ registerTab({ id: 'browser-1', send: () => undefined });
579
+ phone = createFakePhoneTab({ id: 'phone-1', device: PAIRED, page: TICKET });
580
+ const result = await deviceAction({ action: 'list', devices: { ...devices, ...fakeRun() } });
581
+ expect(result.phones).toEqual([
582
+ {
583
+ device: 'phone-1',
584
+ platform: 'ios',
585
+ app: 'com.lowdefy.dev',
586
+ shell: '7.1.0',
587
+ paired: true,
588
+ pageId: 'ticket',
589
+ pathParams: {},
590
+ connectedAt: expect.any(Date),
591
+ },
592
+ ]);
593
+ expect(result.simulators).toEqual([{ udid: 'SIM-1', name: 'iPhone 16', runtime: 'iOS-18-2' }]);
594
+ expect(result.android).toEqual([
595
+ { serial: 'emulator-5554', emulator: true, model: 'sdk_gphone64' },
596
+ ]);
597
+ unregisterTab({ id: 'browser-1' });
598
+ });
599
+
600
+ test('deviceAction refuses an unknown action', async () => {
601
+ expect(await deviceAction({ action: 'reboot' })).toEqual({
602
+ error: '"action" must be one of list, start, inject. Received "reboot".',
603
+ });
604
+ });
@@ -0,0 +1,50 @@
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 { getTab } from '../tabChannel.js';
20
+
21
+ /**
22
+ * The phone tab a device tool call names: `{ tab }`, or `{ error }` when no tab has that id or the
23
+ * tab is a browser's. `device` is a tab id from lowdefy_device's `list`.
24
+ *
25
+ * @param {Object} params
26
+ * @param {string} params.device
27
+ */
28
+ function findDeviceTab({ device }) {
29
+ if (!type.isString(device) || device === '') {
30
+ return {
31
+ error: `"device" must be a tab id from lowdefy_device list. Received ${JSON.stringify(
32
+ device
33
+ )}.`,
34
+ };
35
+ }
36
+ const tab = getTab({ id: device });
37
+ if (type.isNone(tab)) {
38
+ return {
39
+ error: `No phone is connected as tab "${device}". Call lowdefy_device with action "list" for the connected phones; a phone that reconnected has a new tab id.`,
40
+ };
41
+ }
42
+ if (type.isNone(tab.device)) {
43
+ return {
44
+ error: `Tab "${device}" is a browser tab, not a phone. Leave "device" out to use the headless browser, or pass a tab from lowdefy_device list.`,
45
+ };
46
+ }
47
+ return { tab };
48
+ }
49
+
50
+ export default findDeviceTab;