@appium/plugin-test-support 1.0.4 → 1.1.0

package/build/lib/harness.d.ts

@@ -1,114 +1,6 @@
+import type { E2ESetupOpts } from './types';
 /**
  * Creates hooks to install a driver and a plugin and starts an Appium server w/ the given extensions.
- * @param {E2ESetupOpts} opts
- * @returns {void}
  */
-export function pluginE2EHarness(opts: E2ESetupOpts): void;
-export type E2ESetupOpts = {
-    /**
-     * - Path to Appium home directory
-     */
-    appiumHome?: string | undefined;
-    /**
-     * - Mocha "before all" hook function
-     */
-    before: Mocha.HookFunction<Mocha.Hook>;
-    /**
-     * - Mocha "after all" hook function
-     */
-    after: Mocha.HookFunction<Mocha.Hook>;
-    /**
-     * - Arguments to pass to Appium server
-     */
-    serverArgs?: Partial<{
-        subcommand?: import("appium/types").CliCommand | undefined;
-        configFile?: string | undefined;
-        showConfig?: boolean | undefined;
-        showDebugInfo?: boolean | undefined;
-        shell?: boolean | undefined;
-        throwInsteadOfExit?: boolean | undefined;
-        logHandler?: ((...args: any[]) => void) | undefined;
-        appiumHome?: string | undefined;
-        showBuildInfo?: boolean | undefined;
-        address?: string | undefined;
-        allowCors?: NonNullable<boolean | undefined> | undefined;
-        allowInsecure?: import("@appium/types").AllowInsecureConfig | undefined;
-        basePath?: string | undefined;
-        callbackAddress?: string | undefined;
-        callbackPort?: number | undefined;
-        debugLogSpacing?: NonNullable<boolean | undefined> | undefined;
-        defaultCapabilities?: import("@appium/types").DefaultCapabilitiesConfig | undefined;
-        denyInsecure?: import("@appium/types").DenyInsecureConfig | undefined;
-        driver?: import("@appium/types").DriverConfig | undefined;
-        keepAliveTimeout?: number | undefined;
-        requestTimeout?: number | undefined;
-        localTimezone?: NonNullable<boolean | undefined> | undefined;
-        logFile?: string | undefined;
-        logFilters?: import("@appium/types").LogFiltersConfig | undefined;
-        loglevel?: NonNullable<import("@appium/types").LogLevelConfig | undefined> | undefined;
-        logFormat?: NonNullable<import("@appium/types").LogFormatConfig | undefined> | undefined;
-        logNoColors?: NonNullable<boolean | undefined> | undefined;
-        logTimestamp?: NonNullable<boolean | undefined> | undefined;
-        pluginsImportChunkSize?: number | undefined;
-        driversImportChunkSize?: number | undefined;
-        longStacktrace?: NonNullable<boolean | undefined> | undefined;
-        noPermsCheck?: NonNullable<boolean | undefined> | undefined;
-        nodeconfig?: import("@appium/types").NodeconfigConfig | undefined;
-        plugin?: import("@appium/types").PluginConfig | undefined;
-        port?: number | undefined;
-        relaxedSecurityEnabled?: NonNullable<boolean | undefined> | undefined;
-        shutdownTimeout?: number | undefined;
-        sessionOverride?: NonNullable<boolean | undefined> | undefined;
-        sslCertificatePath?: string | undefined;
-        sslKeyPath?: string | undefined;
-        strictCaps?: NonNullable<boolean | undefined> | undefined;
-        tmpDir?: string | undefined;
-        traceDir?: string | undefined;
-        useDrivers?: import("@appium/types").UseDriversConfig | undefined;
-        usePlugins?: import("@appium/types").UsePluginsConfig | undefined;
-        webhook?: string | undefined;
-    }> | undefined;
-    /**
-     * - Source of driver to install
-     */
-    driverSource: import("appium/types").InstallType & string;
-    /**
-     * - Package name of driver to install
-     */
-    driverPackage?: string | undefined;
-    /**
-     * - Name of driver to install
-     */
-    driverName: string;
-    /**
-     * - Spec of driver to install
-     */
-    driverSpec: string;
-    /**
-     * - Source of plugin to install
-     */
-    pluginSource: import("appium/types").InstallType & string;
-    /**
-     * - Package name of plugin to install
-     */
-    pluginPackage?: string | undefined;
-    /**
-     * - Spec of plugin to install
-     */
-    pluginSpec: string;
-    /**
-     * - Name of plugin to install
-     */
-    pluginName: string;
-    /**
-     * - Port to use for Appium server
-     */
-    port?: number | undefined;
-    /**
-     * - Host to use for Appium server
-     */
-    host?: string | undefined;
-};
-export type AppiumServer = import("@appium/types").AppiumServer;
-export type AppiumEnv = import("appium/types").AppiumEnv;
+export declare function pluginE2EHarness(opts: E2ESetupOpts): void;
 //# sourceMappingURL=harness.d.ts.map

package/build/lib/harness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../../lib/harness.js"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,uCAHW,YAAY,GACV,IAAI,CAmIhB;;;;;;;;;;;;;;;;;;;;;;;;uBAnEkD,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA2ExC,OAAO,cAAc,EAAE,WAAW,GAAG,MAAM;;;;;;;;gBAE3C,MAAM;;;;gBACN,MAAM;;;;kBACN,OAAO,cAAc,EAAE,WAAW,GAAG,MAAM;;;;;;;;gBAE3C,MAAM;;;;gBACN,MAAM;;;;;;;;;;2BAMP,OAAO,eAAe,EAAE,YAAY;wBAIpC,OAAO,cAAc,EAAE,SAAS"}
+{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../../lib/harness.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAC,YAAY,EAAY,MAAM,SAAS,CAAC;AAMrD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAoHzD"}

package/build/lib/harness.js

@@ -5,141 +5,98 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.pluginE2EHarness = pluginE2EHarness;
 /* eslint-disable no-console */
+const node_module_1 = require("node:module");
 const support_1 = require("appium/support");
 const appium_1 = require("appium");
 const get_port_1 = __importDefault(require("get-port"));
-// eslint-disable-next-line import/named
-const log_symbols_1 = require("log-symbols");
+const log_symbols_1 = __importDefault(require("log-symbols"));
 const teen_process_1 = require("teen_process");
-const APPIUM_BIN = require.resolve('appium');
+const _require = (0, node_module_1.createRequire)(__filename);
+const APPIUM_BIN = _require.resolve('appium');
 /**
  * Creates hooks to install a driver and a plugin and starts an Appium server w/ the given extensions.
- * @param {E2ESetupOpts} opts
- * @returns {void}
  */
 function pluginE2EHarness(opts) {
-    let { appiumHome, before, after, serverArgs = {}, driverSource, driverPackage, driverName, driverSpec, pluginSource, pluginPackage, pluginSpec, pluginName, port, host, } = opts;
-    /**
-     * @type {AppiumServer}
-     */
+    const { appiumHome, before, after, serverArgs = {}, driverSource, driverPackage, driverName, driverSpec, pluginSource, pluginPackage, pluginSpec, pluginName, port, host, } = opts;
     let server;
-    // eslint-disable-next-line mocha/no-top-level-hooks
     before(async function () {
+        // Lazy-load chai so smoke test (node ./build/lib/index.js --smoke-test) does not require it
         const chai = await import('chai');
-        const chaiAsPromised = await import('chai-as-promised');
-        chai.use(chaiAsPromised.default);
-        chai.should();
+        const chaiAsPromised = (await import('chai-as-promised')).default;
+        chai.use(chaiAsPromised);
         const setupAppiumHome = async () => {
-            /**
-             * @type {AppiumEnv}
-             */
             const env = { ...process.env };
             if (appiumHome) {
                 env.APPIUM_HOME = appiumHome;
                 await support_1.fs.mkdirp(appiumHome);
-                console.log(`${log_symbols_1.info} Set \`APPIUM_HOME\` to ${appiumHome}`);
+                console.log(`${log_symbols_1.default.info} Set \`APPIUM_HOME\` to ${appiumHome}`);
             }
             return env;
         };
-        /**
-         *
-         * @param {AppiumEnv} env
-         */
         const installDriver = async (env) => {
-            console.log(`${log_symbols_1.info} Checking if driver "${driverName}" is installed...`);
+            console.log(`${log_symbols_1.default.info} Checking if driver "${driverName}" is installed...`);
             const driverListArgs = [APPIUM_BIN, 'driver', 'list', '--json'];
-            console.log(`${log_symbols_1.info} Running: ${process.execPath} ${driverListArgs.join(' ')}`);
+            console.log(`${log_symbols_1.default.info} Running: ${process.execPath} ${driverListArgs.join(' ')}`);
             const { stdout: driverListJson } = await (0, teen_process_1.exec)(process.execPath, driverListArgs, {
                 env,
             });
             const installedDrivers = JSON.parse(driverListJson);
             if (!installedDrivers[driverName]?.installed) {
-                console.log(`${log_symbols_1.warning} Driver "${driverName}" not installed; installing...`);
+                console.log(`${log_symbols_1.default.warning} Driver "${driverName}" not installed; installing...`);
                 const driverArgs = [APPIUM_BIN, 'driver', 'install', '--source', driverSource, driverSpec];
                 if (driverPackage) {
                     driverArgs.push('--package', driverPackage);
                 }
-                console.log(`${log_symbols_1.info} Running: ${process.execPath} ${driverArgs.join(' ')}`);
+                console.log(`${log_symbols_1.default.info} Running: ${process.execPath} ${driverArgs.join(' ')}`);
                 await (0, teen_process_1.exec)(process.execPath, driverArgs, {
                     env,
                 });
             }
-            console.log(`${log_symbols_1.success} Installed driver "${driverName}"`);
+            console.log(`${log_symbols_1.default.success} Installed driver "${driverName}"`);
         };
-        /**
-         *
-         * @param {AppiumEnv} env
-         */
         const installPlugin = async (env) => {
-            console.log(`${log_symbols_1.info} Checking if plugin "${pluginName}" is installed...`);
+            console.log(`${log_symbols_1.default.info} Checking if plugin "${pluginName}" is installed...`);
             const pluginListArgs = [APPIUM_BIN, 'plugin', 'list', '--json'];
             const { stdout: pluginListJson } = await (0, teen_process_1.exec)(process.execPath, pluginListArgs, {
                 env,
             });
             const installedPlugins = JSON.parse(pluginListJson);
             if (!installedPlugins[pluginName]?.installed) {
-                console.log(`${log_symbols_1.warning} Plugin "${pluginName}" not installed; installing...`);
+                console.log(`${log_symbols_1.default.warning} Plugin "${pluginName}" not installed; installing...`);
                 const pluginArgs = [APPIUM_BIN, 'plugin', 'install', '--source', pluginSource, pluginSpec];
                 if (pluginPackage) {
                     pluginArgs.push('--package', pluginPackage);
                 }
-                console.log(`${log_symbols_1.info} Running: ${process.execPath} ${pluginArgs.join(' ')}`);
+                console.log(`${log_symbols_1.default.info} Running: ${process.execPath} ${pluginArgs.join(' ')}`);
                 await (0, teen_process_1.exec)(process.execPath, pluginArgs, {
                     env,
                 });
             }
-            console.log(`${log_symbols_1.success} Installed plugin "${pluginName}"`);
+            console.log(`${log_symbols_1.default.success} Installed plugin "${pluginName}"`);
         };
         const createServer = async () => {
-            if (!port) {
-                port = await (0, get_port_1.default)();
-            }
-            console.log(`${log_symbols_1.info} Will use port ${port} for Appium server`);
-            this.port = port;
-            /** @type {import('appium/types').Args} */
+            const resolvedPort = port ?? (await (0, get_port_1.default)());
+            console.log(`${log_symbols_1.default.info} Will use port ${resolvedPort} for Appium server`);
+            this.port = resolvedPort;
             const args = {
-                port,
+                port: resolvedPort,
                 address: host,
                 usePlugins: [pluginName],
                 useDrivers: [driverName],
                 appiumHome,
                 ...serverArgs,
             };
-            server = /** @type {AppiumServer} */ (await (0, appium_1.main)(args));
+            server = (await (0, appium_1.main)(args));
         };
         const env = await setupAppiumHome();
         await installDriver(env);
         await installPlugin(env);
         await createServer();
     });
-    // eslint-disable-next-line mocha/no-top-level-hooks
     after(async function () {
         if (server) {
             await server.close();
         }
     });
 }
-/**
- * @typedef E2ESetupOpts
- * @property {string} [appiumHome] - Path to Appium home directory
- * @property {Mocha.before} before - Mocha "before all" hook function
- * @property {Mocha.after} after - Mocha "after all" hook function
- * @property {Partial<import('appium/types').Args>} [serverArgs] - Arguments to pass to Appium server
- * @property {import('appium/types').InstallType & string} driverSource - Source of driver to install
- * @property {string} [driverPackage] - Package name of driver to install
- * @property {string} driverName - Name of driver to install
- * @property {string} driverSpec - Spec of driver to install
- * @property {import('appium/types').InstallType & string} pluginSource - Source of plugin to install
- * @property {string} [pluginPackage] - Package name of plugin to install
- * @property {string} pluginSpec - Spec of plugin to install
- * @property {string} pluginName - Name of plugin to install
- * @property {number} [port] - Port to use for Appium server
- * @property {string} [host] - Host to use for Appium server
- */
-/**
- * @typedef {import('@appium/types').AppiumServer} AppiumServer
- */
-/**
- * @typedef {import('appium/types').AppiumEnv} AppiumEnv
- */
 //# sourceMappingURL=harness.js.map

package/build/lib/harness.js.map

@@ -1 +1 @@
-{"version":3,"file":"harness.js","sourceRoot":"","sources":["../../lib/harness.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"harness.js","sourceRoot":"","sources":["../../lib/harness.ts"],"names":[],"mappings":"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"}

package/build/lib/index.d.ts

@@ -0,0 +1,3 @@
+export { pluginE2EHarness } from './harness';
+export type { E2ESetupOpts, AppiumEnv } from './types';
+//# sourceMappingURL=index.d.ts.map

package/build/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,gBAAgB,EAAC,MAAM,WAAW,CAAC;AAC3C,YAAY,EAAC,YAAY,EAAE,SAAS,EAAC,MAAM,SAAS,CAAC"}

package/build/lib/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pluginE2EHarness = void 0;
+var harness_1 = require("./harness");
+Object.defineProperty(exports, "pluginE2EHarness", { enumerable: true, get: function () { return harness_1.pluginE2EHarness; } });
+// Handle smoke test flag
+if (require.main === module && process.argv[2] === '--smoke-test') {
+    process.exit(0);
+}
+//# sourceMappingURL=index.js.map

package/build/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../lib/index.ts"],"names":[],"mappings":";;;AAAA,qCAA2C;AAAnC,2GAAA,gBAAgB,OAAA;AAGxB,yBAAyB;AACzB,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,cAAc,EAAE,CAAC;IAClE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/build/lib/types.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Known environment variables concerning Appium
+ */
+export interface AppiumEnv extends NodeJS.ProcessEnv {
+    APPIUM_HOME?: string;
+}
+/**
+ * Options for the plugin E2E harness.
+ */
+export interface E2ESetupOpts {
+    /** Path to Appium home directory */
+    appiumHome?: string;
+    /** Mocha "before all" hook function */
+    before: (fn: (this: Mocha.Context) => Promise<void>) => void;
+    /** Mocha "after all" hook function */
+    after: (fn: (this: Mocha.Context) => Promise<void>) => void;
+    /** Arguments to pass to Appium server */
+    serverArgs?: Record<string, unknown>;
+    /** Source of driver to install (e.g. 'local', 'npm') */
+    driverSource: string;
+    /** Package name of driver to install */
+    driverPackage?: string;
+    /** Name of driver to install */
+    driverName: string;
+    /** Spec of driver to install */
+    driverSpec: string;
+    /** Source of plugin to install (e.g. 'local', 'npm') */
+    pluginSource: string;
+    /** Package name of plugin to install */
+    pluginPackage?: string;
+    /** Spec of plugin to install */
+    pluginSpec: string;
+    /** Name of plugin to install */
+    pluginName: string;
+    /** Port to use for Appium server */
+    port?: number;
+    /** Host to use for Appium server */
+    host?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../lib/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,SAAU,SAAQ,MAAM,CAAC,UAAU;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;IAC7D,sCAAsC;IACtC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;IAC5D,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/build/lib/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/build/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../lib/types.ts"],"names":[],"mappings":""}

package/lib/harness.ts

@@ -0,0 +1,134 @@
+/* eslint-disable no-console */
+import {createRequire} from 'node:module';
+import {fs} from 'appium/support';
+import {main as appiumServer} from 'appium';
+import getPort from 'get-port';
+import logSymbols from 'log-symbols';
+import {exec} from 'teen_process';
+import type {AppiumServer} from '@appium/types';
+import type {E2ESetupOpts, AppiumEnv} from './types';
+
+declare const __filename: string;
+const _require = createRequire(__filename);
+const APPIUM_BIN = _require.resolve('appium') as string;
+
+/**
+ * Creates hooks to install a driver and a plugin and starts an Appium server w/ the given extensions.
+ */
+export function pluginE2EHarness(opts: E2ESetupOpts): void {
+  const {
+    appiumHome,
+    before,
+    after,
+    serverArgs = {},
+    driverSource,
+    driverPackage,
+    driverName,
+    driverSpec,
+    pluginSource,
+    pluginPackage,
+    pluginSpec,
+    pluginName,
+    port,
+    host,
+  } = opts;
+
+  let server: AppiumServer | undefined;
+
+  before(async function (this: Mocha.Context) {
+    // Lazy-load chai so smoke test (node ./build/lib/index.js --smoke-test) does not require it
+    const chai = await import('chai');
+    const chaiAsPromised = (await import('chai-as-promised')).default;
+    chai.use(chaiAsPromised);
+
+    const setupAppiumHome = async (): Promise<AppiumEnv> => {
+      const env: AppiumEnv = {...process.env};
+
+      if (appiumHome) {
+        env.APPIUM_HOME = appiumHome;
+        await fs.mkdirp(appiumHome);
+        console.log(`${logSymbols.info} Set \`APPIUM_HOME\` to ${appiumHome}`);
+      }
+
+      return env;
+    };
+
+    const installDriver = async (env: AppiumEnv): Promise<void> => {
+      console.log(`${logSymbols.info} Checking if driver "${driverName}" is installed...`);
+      const driverListArgs = [APPIUM_BIN, 'driver', 'list', '--json'];
+      console.log(`${logSymbols.info} Running: ${process.execPath} ${driverListArgs.join(' ')}`);
+      const {stdout: driverListJson} = await exec(process.execPath, driverListArgs, {
+        env,
+      });
+      const installedDrivers = JSON.parse(driverListJson) as Record<
+        string,
+        {installed?: boolean}
+      >;
+
+      if (!installedDrivers[driverName]?.installed) {
+        console.log(`${logSymbols.warning} Driver "${driverName}" not installed; installing...`);
+        const driverArgs = [APPIUM_BIN, 'driver', 'install', '--source', driverSource, driverSpec];
+        if (driverPackage) {
+          driverArgs.push('--package', driverPackage);
+        }
+        console.log(`${logSymbols.info} Running: ${process.execPath} ${driverArgs.join(' ')}`);
+        await exec(process.execPath, driverArgs, {
+          env,
+        });
+      }
+      console.log(`${logSymbols.success} Installed driver "${driverName}"`);
+    };
+
+    const installPlugin = async (env: AppiumEnv): Promise<void> => {
+      console.log(`${logSymbols.info} Checking if plugin "${pluginName}" is installed...`);
+      const pluginListArgs = [APPIUM_BIN, 'plugin', 'list', '--json'];
+      const {stdout: pluginListJson} = await exec(process.execPath, pluginListArgs, {
+        env,
+      });
+      const installedPlugins = JSON.parse(pluginListJson) as Record<
+        string,
+        {installed?: boolean}
+      >;
+
+      if (!installedPlugins[pluginName]?.installed) {
+        console.log(`${logSymbols.warning} Plugin "${pluginName}" not installed; installing...`);
+        const pluginArgs = [APPIUM_BIN, 'plugin', 'install', '--source', pluginSource, pluginSpec];
+        if (pluginPackage) {
+          pluginArgs.push('--package', pluginPackage);
+        }
+        console.log(`${logSymbols.info} Running: ${process.execPath} ${pluginArgs.join(' ')}`);
+        await exec(process.execPath, pluginArgs, {
+          env,
+        });
+      }
+      console.log(`${logSymbols.success} Installed plugin "${pluginName}"`);
+    };
+
+    const createServer = async (): Promise<void> => {
+      const resolvedPort = port ?? (await getPort());
+      console.log(`${logSymbols.info} Will use port ${resolvedPort} for Appium server`);
+      (this as Mocha.Context & {port?: number}).port = resolvedPort;
+
+      const args = {
+        port: resolvedPort,
+        address: host,
+        usePlugins: [pluginName],
+        useDrivers: [driverName],
+        appiumHome,
+        ...serverArgs,
+      };
+      server = (await appiumServer(args)) as AppiumServer;
+    };
+
+    const env = await setupAppiumHome();
+    await installDriver(env);
+    await installPlugin(env);
+    await createServer();
+  });
+
+  after(async function () {
+    if (server) {
+      await server.close();
+    }
+  });
+}

package/lib/index.ts

@@ -0,0 +1,7 @@
+export {pluginE2EHarness} from './harness';
+export type {E2ESetupOpts, AppiumEnv} from './types';
+
+// Handle smoke test flag
+if (require.main === module && process.argv[2] === '--smoke-test') {
+  process.exit(0);
+}

package/lib/types.ts

@@ -0,0 +1,40 @@
+/**
+ * Known environment variables concerning Appium
+ */
+export interface AppiumEnv extends NodeJS.ProcessEnv {
+  APPIUM_HOME?: string;
+}
+
+/**
+ * Options for the plugin E2E harness.
+ */
+export interface E2ESetupOpts {
+  /** Path to Appium home directory */
+  appiumHome?: string;
+  /** Mocha "before all" hook function */
+  before: (fn: (this: Mocha.Context) => Promise<void>) => void;
+  /** Mocha "after all" hook function */
+  after: (fn: (this: Mocha.Context) => Promise<void>) => void;
+  /** Arguments to pass to Appium server */
+  serverArgs?: Record<string, unknown>;
+  /** Source of driver to install (e.g. 'local', 'npm') */
+  driverSource: string;
+  /** Package name of driver to install */
+  driverPackage?: string;
+  /** Name of driver to install */
+  driverName: string;
+  /** Spec of driver to install */
+  driverSpec: string;
+  /** Source of plugin to install (e.g. 'local', 'npm') */
+  pluginSource: string;
+  /** Package name of plugin to install */
+  pluginPackage?: string;
+  /** Spec of plugin to install */
+  pluginSpec: string;
+  /** Name of plugin to install */
+  pluginName: string;
+  /** Port to use for Appium server */
+  port?: number;
+  /** Host to use for Appium server */
+  host?: string;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appium/plugin-test-support",
-  "version": "1.0.4",
+  "version": "1.1.0",
   "description": "Testing utilities for Appium plugins",
   "keywords": [
     "automation",
@@ -23,29 +23,28 @@
   },
   "license": "Apache-2.0",
   "author": "https://github.com/appium",
-  "main": "index.js",
-  "types": "build/lib/harness.d.ts",
+  "main": "./build/lib/index.js",
+  "types": "./build/lib/index.d.ts",
   "directories": {
     "lib": "lib"
   },
   "files": [
+    "build/lib",
     "lib",
-    "index.js",
-    "build",
-    "tsconfig.json",
-    "!build/tsconfig.tsbuildinfo"
+    "tsconfig.json"
   ],
   "scripts": {
     "test": "npm run test:unit",
-    "test:smoke": "node ./index.js",
+    "test:smoke": "node ./build/lib/index.js --smoke-test",
     "test:unit": "exit 0"
   },
+  "devDependencies": {
+    "@appium/types": "^1.2.1"
+  },
   "dependencies": {
-    "@appium/types": "^1.1.2",
-    "get-port": "5.1.1",
-    "log-symbols": "4.1.0",
-    "source-map-support": "0.5.21",
-    "teen_process": "3.0.4"
+    "get-port": "7.1.0",
+    "log-symbols": "7.0.1",
+    "teen_process": "4.0.10"
   },
   "peerDependencies": {
     "appium": "^3.0.0-beta.0",
@@ -58,5 +57,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "9004554879687ddad51d3afdf8c711b027efbd99"
+  "gitHead": "980a121804ae006db879fb6860f627ac36174c15"
 }

package/tsconfig.json

@@ -3,12 +3,12 @@
   "compilerOptions": {
     "rootDir": ".",
     "outDir": "build",
-    "checkJs": true,
     "paths": {
       "@appium/types": ["../types"],
-      "appium/support": ["../appium/support"]
+      "appium/support": ["../support"],
+      "appium": ["../appium"]
     },
-    "types": ["mocha", "chai", "sinon", "chai-as-promised"]
+    "types": ["mocha", "chai", "sinon", "chai-as-promised", "node"]
   },
   "include": ["./lib"],
   "references": [{"path": "../types"}, {"path": "../support"}]

package/index.js

@@ -1 +0,0 @@
-module.exports = require('./build/lib/harness');

package/lib/harness.js

@@ -1,171 +0,0 @@
-/* eslint-disable no-console */
-import {fs} from 'appium/support';
-import {main as appiumServer} from 'appium';
-import getPort from 'get-port';
-// eslint-disable-next-line import/named
-import {info, success, warning} from 'log-symbols';
-import {exec} from 'teen_process';
-
-const APPIUM_BIN = require.resolve('appium');
-
-/**
- * Creates hooks to install a driver and a plugin and starts an Appium server w/ the given extensions.
- * @param {E2ESetupOpts} opts
- * @returns {void}
- */
-export function pluginE2EHarness(opts) {
-  let {
-    appiumHome,
-    before,
-    after,
-    serverArgs = {},
-    driverSource,
-    driverPackage,
-    driverName,
-    driverSpec,
-    pluginSource,
-    pluginPackage,
-    pluginSpec,
-    pluginName,
-    port,
-    host,
-  } = opts;
-
-  /**
-   * @type {AppiumServer}
-   */
-  let server;
-
-  // eslint-disable-next-line mocha/no-top-level-hooks
-  before(async function () {
-    const chai = await import('chai');
-    const chaiAsPromised = await import('chai-as-promised');
-    chai.use(chaiAsPromised.default);
-    chai.should();
-
-    const setupAppiumHome = async () => {
-      /**
-       * @type {AppiumEnv}
-       */
-      const env = {...process.env};
-
-      if (appiumHome) {
-        env.APPIUM_HOME = appiumHome;
-        await fs.mkdirp(appiumHome);
-        console.log(`${info} Set \`APPIUM_HOME\` to ${appiumHome}`);
-      }
-
-      return env;
-    };
-
-    /**
-     *
-     * @param {AppiumEnv} env
-     */
-    const installDriver = async (env) => {
-      console.log(`${info} Checking if driver "${driverName}" is installed...`);
-      const driverListArgs = [APPIUM_BIN, 'driver', 'list', '--json'];
-      console.log(`${info} Running: ${process.execPath} ${driverListArgs.join(' ')}`);
-      const {stdout: driverListJson} = await exec(process.execPath, driverListArgs, {
-        env,
-      });
-      const installedDrivers = JSON.parse(driverListJson);
-
-      if (!installedDrivers[driverName]?.installed) {
-        console.log(`${warning} Driver "${driverName}" not installed; installing...`);
-        const driverArgs = [APPIUM_BIN, 'driver', 'install', '--source', driverSource, driverSpec];
-        if (driverPackage) {
-          driverArgs.push('--package', driverPackage);
-        }
-        console.log(`${info} Running: ${process.execPath} ${driverArgs.join(' ')}`);
-        await exec(process.execPath, driverArgs, {
-          env,
-        });
-      }
-      console.log(`${success} Installed driver "${driverName}"`);
-    };
-
-    /**
-     *
-     * @param {AppiumEnv} env
-     */
-    const installPlugin = async (env) => {
-      console.log(`${info} Checking if plugin "${pluginName}" is installed...`);
-      const pluginListArgs = [APPIUM_BIN, 'plugin', 'list', '--json'];
-      const {stdout: pluginListJson} = await exec(process.execPath, pluginListArgs, {
-        env,
-      });
-      const installedPlugins = JSON.parse(pluginListJson);
-
-      if (!installedPlugins[pluginName]?.installed) {
-        console.log(`${warning} Plugin "${pluginName}" not installed; installing...`);
-        const pluginArgs = [APPIUM_BIN, 'plugin', 'install', '--source', pluginSource, pluginSpec];
-        if (pluginPackage) {
-          pluginArgs.push('--package', pluginPackage);
-        }
-        console.log(`${info} Running: ${process.execPath} ${pluginArgs.join(' ')}`);
-        await exec(process.execPath, pluginArgs, {
-          env,
-        });
-      }
-      console.log(`${success} Installed plugin "${pluginName}"`);
-    };
-
-    const createServer = async () => {
-      if (!port) {
-        port = await getPort();
-      }
-      console.log(`${info} Will use port ${port} for Appium server`);
-      this.port = port;
-
-      /** @type {import('appium/types').Args} */
-      const args = {
-        port,
-        address: host,
-        usePlugins: [pluginName],
-        useDrivers: [driverName],
-        appiumHome,
-        ...serverArgs,
-      };
-      server = /** @type {AppiumServer} */ (await appiumServer(args));
-    };
-
-    const env = await setupAppiumHome();
-    await installDriver(env);
-    await installPlugin(env);
-    await createServer();
-  });
-
-  // eslint-disable-next-line mocha/no-top-level-hooks
-  after(async function () {
-    if (server) {
-      await server.close();
-    }
-  });
-}
-
-/**
- * @typedef E2ESetupOpts
- * @property {string} [appiumHome] - Path to Appium home directory
- * @property {Mocha.before} before - Mocha "before all" hook function
- * @property {Mocha.after} after - Mocha "after all" hook function
- * @property {Partial<import('appium/types').Args>} [serverArgs] - Arguments to pass to Appium server
- * @property {import('appium/types').InstallType & string} driverSource - Source of driver to install
- * @property {string} [driverPackage] - Package name of driver to install
- * @property {string} driverName - Name of driver to install
- * @property {string} driverSpec - Spec of driver to install
- * @property {import('appium/types').InstallType & string} pluginSource - Source of plugin to install
- * @property {string} [pluginPackage] - Package name of plugin to install
- * @property {string} pluginSpec - Spec of plugin to install
- * @property {string} pluginName - Name of plugin to install
- * @property {number} [port] - Port to use for Appium server
- * @property {string} [host] - Host to use for Appium server
- */
-
-/**
- * @typedef {import('@appium/types').AppiumServer} AppiumServer
- */
-
-/**
- * @typedef {import('appium/types').AppiumEnv} AppiumEnv
- */