|
1 | 1 | import type { ProviderPluginHost } from 'agent-device/plugins'; |
2 | | -import type { WebDriverPluginOptions } from 'agent-device/plugins/webdriver'; |
3 | | -import type { ProviderProfileFieldDeclaration } from '@agent-device/contracts/provider-profile-fields'; |
4 | | -import type { ProviderDeviceType } from '@agent-device/contracts/remote'; |
5 | | -import { |
6 | | - buildCloudWebDriverBaseCapabilities, |
7 | | - readFlag, |
8 | | - requireFlag, |
9 | | - requireRequest, |
10 | | - requireRequestPlatform, |
11 | | -} from '@agent-device/provider-webdriver/plugin'; |
12 | 2 | import { createTestMuConnection } from './connection.ts'; |
13 | | -import { requireTestMuCredentials } from './providers.ts'; |
14 | | -import { |
15 | | - buildTestMuCapabilities, |
16 | | - createTestMuUploadApp, |
17 | | - listTestMuCloudArtifacts, |
18 | | - resolveTestMuAppReference, |
19 | | -} from './testmu.ts'; |
20 | | -import { |
21 | | - buildTestMuDeviceFeatureCapabilities, |
22 | | - readTestMuDeviceFeatureFields, |
23 | | - readTestMuDeviceType, |
24 | | -} from './testmu-device-features.ts'; |
25 | | -const TESTMU_WEBDRIVER_ENDPOINT = 'https://mobile-hub.lambdatest.com/wd/hub/'; |
26 | | -const TESTMU_CAPABILITY_OVERRIDES = { |
27 | | - install: { |
28 | | - support: 'partial', |
29 | | - note: 'Local app artifacts are uploaded to TestMu AI as real- or virtual-device apps (lt://), then installed with Appium.', |
30 | | - }, |
31 | | - portReverse: { |
32 | | - support: 'unsupported', |
33 | | - note: 'Use the TestMu AI tunnel for network access to local hosts; agent-device port reverse is not available.', |
34 | | - }, |
35 | | - artifacts: { |
36 | | - support: 'supported', |
37 | | - note: 'TestMu AI session details expose provider-hosted video, Appium logs, device logs, network logs, and dashboard links.', |
38 | | - }, |
39 | | -} as const; |
40 | | - |
41 | | -const TESTMU_PROFILE_FIELDS: ProviderProfileFieldDeclaration = { |
42 | | - provider: 'testmu', |
43 | | - label: 'TestMu AI', |
44 | | - fields: { |
45 | | - providerApp: 'consumed', |
46 | | - providerOsVersion: 'consumed', |
47 | | - providerDeviceType: 'consumed', |
48 | | - providerProject: 'consumed', |
49 | | - providerBuild: 'consumed', |
50 | | - providerSessionName: 'consumed', |
51 | | - providerDeviceOrientation: 'consumed', |
52 | | - providerGeoLocation: 'consumed', |
53 | | - providerTimezone: 'consumed', |
54 | | - providerAppiumVersion: 'consumed', |
55 | | - providerLanguage: 'consumed', |
56 | | - providerLocale: 'consumed', |
57 | | - providerNetworkProfile: 'refused', |
58 | | - providerCustomNetwork: 'refused', |
59 | | - providerNoResignApp: 'refused', |
60 | | - awsProjectArn: 'refused', |
61 | | - awsDeviceArn: 'refused', |
62 | | - awsAppArn: 'refused', |
63 | | - awsRegion: 'refused', |
64 | | - awsInteractionMode: 'refused', |
65 | | - }, |
66 | | -}; |
| 3 | +import { createTestMuWebDriver } from './testmu-webdriver.ts'; |
67 | 4 |
|
68 | 5 | /** The version 1 plugin entry, kept so hosts without the version 2 contract still load this package. */ |
69 | 6 | export default function testMuPlugin(host: ProviderPluginHost) { |
70 | | - return { |
71 | | - webDriver: createTestMuWebDriver(host), |
72 | | - connection: createTestMuConnection(host, TESTMU_PROFILE_FIELDS), |
73 | | - }; |
74 | | -} |
75 | | - |
76 | | -function createTestMuWebDriver(host: ProviderPluginHost): WebDriverPluginOptions { |
77 | | - const env = host.env; |
78 | | - async function listTestMuArtifactsFromEnv( |
79 | | - provider: string, |
80 | | - providerSessionId: string | undefined, |
81 | | - env: ProviderPluginHost['env'], |
82 | | - ) { |
83 | | - return await listTestMuCloudArtifacts(provider, providerSessionId, { |
84 | | - clientVersion: host.clientVersion, |
85 | | - ...requireTestMuCredentials(env, 'TestMu AI artifact lookup'), |
86 | | - endpoint: env.TESTMU_API_ENDPOINT, |
87 | | - }); |
88 | | - } |
89 | | - const webDriver: WebDriverPluginOptions = { |
90 | | - provider: 'testmu', |
91 | | - profileFields: TESTMU_PROFILE_FIELDS, |
92 | | - platform: 'android', |
93 | | - deviceName: 'TestMu AI device', |
94 | | - endpoint: env.TESTMU_WEBDRIVER_ENDPOINT ?? TESTMU_WEBDRIVER_ENDPOINT, |
95 | | - capabilityOverrides: TESTMU_CAPABILITY_OVERRIDES, |
96 | | - listArtifacts: async ({ provider, providerSessionId }) => |
97 | | - await listTestMuArtifactsFromEnv(provider, providerSessionId, env), |
98 | | - prepareSession: async ({ req, lease, base }) => { |
99 | | - const request = requireRequest(req, 'TestMu AI'); |
100 | | - const deviceType = readTestMuDeviceType(request.flags); |
101 | | - const uploadEndpoint = testMuAppUploadEndpoint(env, deviceType); |
102 | | - const credentials = requireTestMuCredentials(env, 'TestMu AI'); |
103 | | - const platform = requireRequestPlatform(request, 'TestMu AI'); |
104 | | - const deviceName = requireFlag(request, 'device', 'TestMu AI requires --device <name>.'); |
105 | | - const osVersion = requireFlag( |
106 | | - request, |
107 | | - 'providerOsVersion', |
108 | | - 'TestMu AI requires --provider-os-version <version>.', |
109 | | - ); |
110 | | - const upload = { |
111 | | - clientVersion: host.clientVersion, |
112 | | - |
113 | | - ...credentials, |
114 | | - deviceType, |
115 | | - endpoint: uploadEndpoint, |
116 | | - }; |
117 | | - const app = await resolveTestMuAppReference( |
118 | | - requireFlag( |
119 | | - request, |
120 | | - 'providerApp', |
121 | | - 'TestMu AI requires --provider-app <lt://app-id, URL, or local path>.', |
122 | | - ), |
123 | | - { ...upload, cwd: request.cwd, signal: request.signal }, |
124 | | - ); |
125 | | - return { |
126 | | - ...base, |
127 | | - platform, |
128 | | - deviceName, |
129 | | - auth: credentials, |
130 | | - uploadApp: createTestMuUploadApp(upload), |
131 | | - webdriverCapabilities: buildTestMuCapabilities({ |
132 | | - platform, |
133 | | - deviceType, |
134 | | - deviceName, |
135 | | - osVersion, |
136 | | - app, |
137 | | - projectName: readFlag(request, 'providerProject'), |
138 | | - buildName: readFlag(request, 'providerBuild') ?? lease.runId, |
139 | | - sessionName: readFlag(request, 'providerSessionName') ?? lease.leaseId, |
140 | | - deviceFeatures: buildTestMuDeviceFeatureCapabilities( |
141 | | - readTestMuDeviceFeatureFields(request.flags), |
142 | | - ), |
143 | | - configured: buildCloudWebDriverBaseCapabilities(platform, deviceName), |
144 | | - }), |
145 | | - }; |
146 | | - }, |
147 | | - }; |
148 | | - return webDriver; |
149 | | -} |
150 | | -/** Each pool has its own upload API, so each has its own override. */ |
151 | | -function testMuAppUploadEndpoint( |
152 | | - env: ProviderPluginHost['env'], |
153 | | - deviceType: ProviderDeviceType, |
154 | | -): string | undefined { |
155 | | - return deviceType === 'real' |
156 | | - ? env.TESTMU_REAL_DEVICE_APP_UPLOAD_ENDPOINT |
157 | | - : env.TESTMU_APP_UPLOAD_ENDPOINT; |
| 7 | + return { webDriver: createTestMuWebDriver(host), connection: createTestMuConnection(host) }; |
158 | 8 | } |
0 commit comments