@appium/types 0.2.3 → 0.2.4

package/lib/index.ts

@@ -1,514 +1,49 @@
-import type { Method as _Method } from 'axios';
-import type { EventEmitter } from 'events';
-import type { Server } from 'http';
-import type { Logger } from 'npmlog';
-import type { Class as _Class, MultidimensionalReadonlyArray } from 'type-fest';
-import { ServerArgs } from './config';
-import { Capabilities, W3CCapabilities } from './capabilities';
-
-export { AppiumW3CCapabilities } from './capabilities';
-export { AppiumConfig, NormalizedAppiumConfig } from './config';
+import type {Method as _Method} from 'axios';
+import type {Server} from 'http';
+import type {Class as _Class, ConditionalPick, MultidimensionalReadonlyArray} from 'type-fest';
+import {ServerArgs} from './config';
+import {Capabilities, W3CCapabilities} from './capabilities';
+import type {Express} from 'express';
+import {ExternalDriver} from './driver';
+import type {Logger} from 'npmlog';
+
+export * from './driver';
+export * from './plugin';
+export {AppiumW3CCapabilities} from './capabilities';
+export {AppiumConfig, NormalizedAppiumConfig} from './config';
 export * from './appium-config';
-export { ServerArgs, Capabilities, W3CCapabilities };
+export {ServerArgs, Capabilities, W3CCapabilities};
 
 /**
- * Methods and properties which both `AppiumDriver` and `BaseDriver` inherit.
+ * A log prefix for {@linkcode AppiumLogger}
+ *
+ * If a function, the function will return the prefix.  Log messages will be prefixed with this value.
  */
-export interface Core {
-  sessionId: string | null;
-  opts: ServerArgs;
-  initialOpts: ServerArgs;
-  caps?: Capabilities;
-  originalCaps?: W3CCapabilities;
-  protocol?: string;
-  helpers: DriverHelpers;
-  basePath: string;
-  relaxedSecurityEnabled: boolean;
-  allowInsecure: string[];
-  denyInsecure: string[];
-  newCommandTimeoutMs: number;
-  implicitWaitMs: number;
-  locatorStrategies: string[];
-  webLocatorStrategies: string[];
-  eventEmitter: EventEmitter;
-  settings: DeviceSettings;
-  log: AppiumLogger;
-  driverData?: DriverData;
-  isCommandsQueueEnabled: boolean;
-  eventHistory: EventHistory;
-  desiredCapConstraints: Constraints;
-  onUnexpectedShutdown(handler: () => any): void;
-  getStatus(): Promise<unknown>;
-  logExtraCaps(caps: Capabilities): void;
-  sessionExists(sessionId: string): boolean;
-  validateDesiredCaps(caps: Capabilities): boolean;
-  isW3CProtocol(): boolean;
-  isMjsonwpProtocol(): boolean;
-  isFeatureEnabled(name: string): boolean;
-  ensureFeatureEnabled(name: string): void;
-  validateLocatorStrategy(strategy: string, webContext?: boolean): void;
-  proxyActive(sessionId?: string): boolean;
-  getProxyAvoidList(sessionId?: string): [string, RegExp][];
-  canProxy(sessionId?: string): boolean;
-  proxyRouteIsAvoided(sessionId: string, method: string, url: string): boolean;
-  addManagedDriver(driver: Driver): void;
-  getManagedDrivers(): Driver[];
-  clearNewCommandTimeout(): Promise<void>;
-  logEvent(eventName: string): void;
-}
-
-export interface Driver
-  extends SessionCommands,
-    LogCommands,
-    FindCommands,
-    SettingsCommands,
-    TimeoutCommands,
-    EventCommands,
-    SessionHandler<[string, any], void>,
-    Core {
-  // The following methods are implemented by `BaseDriver`.
-  executeCommand(cmd: string, ...args: any[]): Promise<any>;
-  startUnexpectedShutdown(err?: Error): Promise<void>;
-  startNewCommandTimeout(): Promise<void>;
-  reset(): Promise<void>;
-
-  assignServer?(
-    server: AppiumServer,
-    host: string,
-    port: number,
-    path: string,
-  ): void;
-}
+export type AppiumLoggerPrefix = string | (() => string);
 
 /**
- * External drivers must subclass `BaseDriver`, and can implement any of these methods.
- * None of these are implemented within Appium itself.
+ * Possible "log levels" for {@linkcode AppiumLogger}.
+ *
+ * Extracted from `npmlog`.
  */
-export interface ExternalDriver extends Driver {
-  // The following properties are assigned by appium */
-  readonly server: AppiumServer;
-  readonly serverHost: string;
-  readonly serverPort: number;
-  readonly serverPath: string;
-
-  // WebDriver
-  setUrl?(url: string): Promise<void>;
-  getUrl?(): Promise<string>;
-  back?(): Promise<void>;
-  forward?(): Promise<void>;
-  refresh?(): Promise<void>;
-  title?(): Promise<string>;
-  getWindowHandle?(): Promise<string>;
-  closeWindow?(): Promise<string[]>;
-  setWindow?(handle: string): Promise<void>;
-  getWindowHandles?(): Promise<string[]>;
-  setFrame?(id: null | number | string): Promise<void>;
-  getWindowRect?(): Promise<Rect>;
-  setWindowRect?(
-    x: number,
-    y: number,
-    width: number,
-    height: number,
-  ): Promise<Rect>;
-  maximizeWindow?(): Promise<Rect>;
-  minimizeWindow?(): Promise<Rect>;
-  fullScreenWindow?(): Promise<Rect>;
-  createNewWindow?(type?: NewWindowType): Promise<NewWindow>;
-  active?(): Promise<Element>;
-  elementSelected?(elementId: string): Promise<boolean>;
-  getAttribute?(name: string, elementId: string): Promise<string | null>;
-  getProperty?(name: string, elementId: string): Promise<string | null>;
-  getCssProperty?(name: string, elementId: string): Promise<string>;
-  getText?(elementId: string): Promise<string>;
-  getName?(elementId: string): Promise<string>;
-  getElementRect?(elementId: string): Promise<Rect>;
-  elementEnabled?(elementId: string): Promise<boolean>;
-  elementDisplayed?(elementId: string): Promise<boolean>;
-  click?(elementId: string): Promise<void>;
-  clear?(elementId: string): Promise<void>;
-  setValue?(text: string, elementId: string): Promise<void>;
-  execute?(script: string, args: unknown[]): Promise<unknown>;
-  executeAsync?(script: string, args: unknown[]): Promise<unknown>;
-  getCookies?(): Promise<Cookie[]>;
-  getCookie?(name: string): Promise<Cookie>;
-  setCookie?(cookie: Cookie): Promise<void>;
-  deleteCookie?(name: string): Promise<void>;
-  deleteCookies?(): Promise<void>;
-  performActions?(actions: Actions[]): Promise<void>;
-  releaseActions?(): Promise<void>;
-  postDismissAlert?(): Promise<void>;
-  postAcceptAlert?(): Promise<void>;
-  getAlertText?(): Promise<string | null>;
-  setAlertText?(text: string): Promise<void>;
-  getScreenshot?(): Promise<string>;
-  getElementScreenshot?(elementId: string): Promise<string>;
-
-  // Appium W3C WebDriver Extension
-  mobileShake?(): Promise<void>;
-  getDeviceTime?(format?: string): Promise<string>;
-  lock?(seconds?: number): Promise<void>;
-  unlock?(): Promise<void>;
-  isLocked?(): Promise<boolean>;
-  startRecordingScreen?(options?: ScreenRecordOptions): Promise<void>;
-  stopRecordingScreen?(options?: ScreenRecordOptions): Promise<string>;
-  getPerformanceDataTypes?(): Promise<string[]>;
-  getPerformanceData?(
-    packageName: string,
-    dataType: string,
-    dataReadTimeout?: number,
-  ): Promise<string[]>;
-  pressKeyCode?(
-    keycode: number,
-    metastate?: number,
-    flags?: number,
-  ): Promise<void>;
-  longPressKeyCode?(
-    keycode: number,
-    metastate?: number,
-    flags?: number,
-  ): Promise<void>;
-  fingerprint?(fingerprintId: number): Promise<void>;
-  sendSMS?(phoneNumber: string, message: string): Promise<void>;
-  gsmCall?(phoneNumber: string, action: string): Promise<void>;
-  gsmSignal?(signalStrength: string): Promise<void>;
-  gsmVoice?(state: string): Promise<void>;
-  powerCapacity?(percent: number): Promise<void>;
-  powerAC?(state: string): Promise<void>;
-  networkSpeed?(netspeed: string): Promise<void>;
-  keyevent?(keycode: string, metastate?: string): Promise<void>;
-  mobileRotation?(
-    x: number,
-    y: number,
-    radius: number,
-    rotation: number,
-    touchCount: number,
-    duration: string,
-    elementId?: string,
-  ): Promise<void>;
-  getCurrentActivity?(): Promise<string>;
-  getCurrentPackage?(): Promise<string>;
-  installApp?(appPath: string, options?: unknown): Promise<void>;
-  activateApp?(appId: string, options?: unknown): Promise<void>;
-  removeApp?(appId: string, options?: unknown): Promise<void>;
-  terminateApp?(appId: string, options?: unknown): Promise<void>;
-  isAppInstalled?(appId: string): Promise<boolean>;
-  queryAppState?(appId: string): Promise<number>;
-  hideKeyboard?(
-    strategy?: string,
-    key?: string,
-    keyCode?: string,
-    keyName?: string,
-  ): Promise<void>;
-  isKeyboardShown?(): Promise<boolean>;
-  pushFile?(path: string, data: string): Promise<void>;
-  pullFile?(path: string): Promise<string>;
-  pullFolder?(path: string): Promise<string>;
-  toggleFlightMode?(): Promise<void>;
-  toggleData?(): Promise<void>;
-  toggleWiFi?(): Promise<void>;
-  toggleLocationServices?(): Promise<void>;
-  openNotifications?(): Promise<void>;
-  startActivity?(
-    appPackage: string,
-    appActivity: string,
-    appWaitPackage?: string,
-    appWaitActivity?: string,
-    intentAction?: string,
-    intentCategory?: string,
-    intentFlags?: string,
-    optionalIntentArguments?: string,
-    dontStopAppOnReset?: boolean,
-  ): Promise<void>;
-  getSystemBars?(): Promise<unknown[]>;
-  getDisplayDensity?(): Promise<number>;
-  touchId?(match: boolean): Promise<void>;
-  toggleEnrollTouchId?(enabled: boolean): Promise<void>;
-  launchApp?(): Promise<void>;
-  closeApp?(): Promise<void>;
-  background?(seconds: null | number): Promise<void>;
-  endCoverage?(intent: string, path: string): Promise<void>;
-  getStrings?(
-    language?: string,
-    stringFile?: string,
-  ): Promise<Record<string, unknown>>;
-  setValueImmediate?(value: string, elementId: string): Promise<void>;
-  replaceValue?(value: string, elementId: string): Promise<void>;
-  receiveAsyncResponse?(response: unknown): Promise<void>;
-  setClipboard?(
-    content: string,
-    contentType?: string,
-    label?: string,
-  ): Promise<void>;
-  getClipboard?(contentType?: string): Promise<string>;
-
-  // JSONWP
-  asyncScriptTimeout?(ms: number): Promise<void>;
-  getWindowSize?(): Promise<Size>;
-  getLocation?(elementId: string): Promise<Position>;
-  getLocationInView?(elementId: string): Promise<Position>;
-  getSize?(elementId: string): Promise<Size>;
-  elementShadowRoot?(elementId: string): Promise<Element>;
-  findElementFromShadowRoot?(
-    strategy: string,
-    selector: string,
-    shadowId: string
-  ): Promise<Element>;
-  findElementsFromShadowRoot?(
-    strategy: string,
-    selector: string,
-    shadowId: string
-  ): Promise<Element[]>;
-  equalsElement?(elementId: string, otherElementId: string): Promise<boolean>;
-  submit?(elementId: string): Promise<void>;
-  keys?(value: string[]): Promise<void>;
-  availableIMEEngines?(): Promise<string[]>;
-  getActiveIMEEngine?(): Promise<string>;
-  isIMEActivated?(): Promise<boolean>;
-  deactivateIMEEngine?(): Promise<void>;
-  activateIMEEngine?(engine: string): Promise<void>;
-  getOrientation?(): Promise<string>;
-  setOrientation?(orientation: string): Promise<void>;
-  moveTo?(
-    element?: null | string,
-    xOffset?: number,
-    yOffset?: number,
-  ): Promise<void>;
-  buttonDown?(button?: number): Promise<void>;
-  buttonUp?(button?: number): Promise<void>;
-  clickCurrent?(button?: number): Promise<void>;
-  doubleClick?(): Promise<void>;
-  touchDown?(x: number, y: number): Promise<void>;
-  touchUp?(x: number, y: number): Promise<void>;
-  touchMove?(x: number, y: number): Promise<void>;
-  touchLongClick?(elementId: string): Promise<void>;
-  flick?(
-    element?: string,
-    xSpeed?: number,
-    ySpeed?: number,
-    xOffset?: number,
-    yOffset?: number,
-    speed?: number,
-  ): Promise<void>;
-  getGeoLocation?(): Promise<Location>;
-  setGeoLocation?(location: Partial<Location>): Promise<void>;
-
-  // MJSONWIRE
-  getCurrentContext?(): Promise<string | null>;
-  setContext?(name: string): Promise<void>;
-  getContexts?(): Promise<string[]>;
-  getPageIndex?(elementId: string): Promise<string>;
-  getNetworkConnection?(): Promise<number>;
-  setNetworkConnection?(type: number): Promise<void>;
-  performTouch?(actions: unknown): Promise<void>;
-  performMultiAction?(actions: unknown, elementId: string): Promise<void>;
-  getRotation?(): Promise<Rotation>;
-  setRotation?(x: number, y: number, z: number): Promise<void>;
-
-  // Chromium DevTools
-  executeCdp?(cmd: string, params: unknown): Promise<unknown>;
-
-  // Web Authentication
-  addVirtualAuthenticator?(
-    protocol: string,
-    transport: string,
-    hasResidentKey?: boolean,
-    hasUserVerification?: boolean,
-    isUserConsenting?: boolean,
-    isUserVerified?: boolean,
-  ): Promise<void>;
-  removeVirtualAuthenticator?(): Promise<void>;
-  addAuthCredential?(
-    credentialId: string,
-    isResidentCredential: boolean,
-    rpId: string,
-    privateKey: string,
-    userHandle?: string,
-    signCount?: number,
-  ): Promise<void>;
-  getAuthCredential?(): Promise<Credential[]>;
-  removeAllAuthCredentials?(): Promise<void>;
-  removeAuthCredential?(): Promise<void>;
-  setUserAuthVerified?(isUserVerified: boolean): Promise<void>;
-
-  proxyCommand?(
-    url: string,
-    method: HTTPMethod,
-    body?: string,
-  ): Promise<unknown>;
-}
-
-export interface Method<T extends ExternalDriver = ExternalDriver> {
-  command?: keyof T; // T[keyof T] needs to return a Promise.
-  neverProxy?: boolean;
-  payloadParams?: PayloadParams;
-}
-
-export interface PayloadParams {
-  wrap?: string;
-  unwrap?: string;
-  required?: Readonly<string[]> | MultidimensionalReadonlyArray<string, 2>;
-  optional?: Readonly<string[]> | MultidimensionalReadonlyArray<string, 2>;
-  validate?: (obj: any, protocol: string) => boolean | string | undefined;
-  makeArgs?: (obj: any) => any;
-}
-
-export type MethodMap<T extends ExternalDriver = ExternalDriver> = Record<string, Record<string, Method<T>>>;
-
-export interface Constraint {
-  presence?: boolean | {allowEmpty: boolean};
-  isString?: boolean;
-  isNumber?: boolean;
-  isBoolean?: boolean;
-  isObject?: boolean;
-  isArray?: boolean;
-  deprecated?: boolean;
-  inclusion?: any[];
-}
-export type Constraints = Record<string, Constraint>;
-
-export interface Element {
-  'element-6066-11e4-a52e-4f735466cecf': string;
-}
-
-export interface DriverHelpers {
-  configureApp: (
-    app: string,
-    supportedAppExtensions: string[],
-  ) => Promise<string>;
-  isPackageOrBundle: (app: string) => boolean;
-  duplicateKeys: <T>(input: T, firstKey: string, secondKey: string) => T;
-  parseCapsArray: (cap: string | string[]) => string[];
-  generateDriverLogPrefix: (obj: Core, sessionId?: string) => string;
-}
-
-export type SettingsUpdateListener<
-  T extends Record<string, unknown> = Record<string, unknown>,
-> = (prop: keyof T, newValue: unknown, curValue: unknown) => Promise<void>;
-
-export interface DeviceSettings<
-  T extends Record<string, unknown> = Record<string, unknown>,
-> {
-  update(newSettings: T): Promise<void>;
-  getSettings(): T;
-}
-
-export interface LogType<TDriver, LogEntry = string> {
-  description: string;
-  getter: (driver: TDriver) => Promise<LogEntry[]>;
-}
-
-// WebDriver
-
-export interface Rect {
-  x: number;
-  y: number;
-  width: number;
-  height: number;
-}
-
-export type NewWindowType = 'tab' | 'window';
-
-export interface NewWindow {
-  handle: string;
-  type: NewWindowType;
-}
-
-export interface Cookie {
-  name: string;
-  value: string;
-  path?: string;
-  domain?: string;
-  secure?: boolean;
-  httpOnly?: boolean;
-  expiry?: number;
-  sameSite?: 'Lax' | 'Strict';
-}
-
-export interface Actions {
-  type?: string;
-  actions: Action[];
-  parameters?: {
-    pointerType?: string;
-  };
-}
-
-export interface Action {
-  duration?: number;
-  type: string;
-  value?: string;
-  x?: number;
-  y?: number;
-  button?: number;
-  origin?: string;
-}
-
-// Appium W3C WebDriver Extension
-
-export interface ScreenRecordOptions {
-  remotePath?: string;
-  username?: string;
-  password?: string;
-  method?: string;
-  forceRestart?: boolean;
-  timeLimit?: string;
-  videoType?: string;
-  videoQuality?: string;
-  videoFps?: string;
-  videoScale?: string;
-  bitRate?: string;
-  videoSize?: string;
-  bugReport?: string;
-}
-
-// JSONWP
-
-export type Size = Pick<Rect, 'width' | 'height'>;
-
-export type Position = Pick<Rect, 'x' | 'y'>;
-
-export interface Location {
-  latitude: number;
-  longitude: number;
-  altitude: number;
-}
-
-export interface Rotation {
-  x: number;
-  y: number;
-  z: number;
-}
-
-// Web Authentication
-
-export interface Credential {
-  credentialId: string;
-  isResidentCredential: boolean;
-  rpId: string;
-  privateKey: string;
-  userHandle?: string;
-  signCount: number;
-  largeBlob?: string;
-}
-
-export interface EventHistory {
-  commands: EventHistoryCommand[];
-  [key: string]: any;
-}
-
-export interface EventHistoryCommand {
-  cmd: string;
-  startTime: number;
-  endTime: number;
-}
-export type HTTPMethod = _Method;
-
-export type Prefix = string|(() => string);
+export type AppiumLoggerLevel = 'silly' | 'verbose' | 'debug' | 'info' | 'http' | 'warn' | 'error';
 
+/**
+ * Describes the `npmlog`-based internal logger.
+ *
+ * @see https://npm.im/npmlog
+ */
 export interface AppiumLogger {
+  /**
+   * Returns the underlying `npmlog` {@link Logger}.
+   */
   unwrap(): Logger;
-  level: string;
-  levels: string[];
-  prefix?: Prefix,
+  level: AppiumLoggerLevel;
+  levels: AppiumLoggerLevel[];
+  /**
+   * Log prefix, if applicable.
+   */
+  prefix?: AppiumLoggerPrefix;
   debug: (...args: any[]) => void;
   info: (...args: any[]) => void;
   warn: (...args: any[]) => void;
@@ -519,114 +54,59 @@ export interface AppiumLogger {
   errorAndThrow: (...args: any[]) => never;
 }
 
+/**
+ * Appium's slightly-modified {@linkcode Server http.Server}.
+ */
 export type AppiumServer = Omit<Server, 'close'> & {
   close: () => Promise<void>;
 };
 
-export interface TimeoutCommands {
-  timeouts(
-    type: string,
-    ms: number | string,
-    script?: number,
-    pageLoad?: number,
-    implicit?: number | string,
-  ): Promise<void>;
-  setNewCommandTimeout(ms: number): void;
-  implicitWait(ms: number | string): Promise<void>;
-  setImplicitWait(ms: number): void;
-  implicitWaitForCondition(condition: () => Promise<any>): Promise<unknown>;
-  getTimeouts(): Promise<Record<string, number>>;
-  implicitWaitW3C(ms: number): Promise<void>;
-  implicitWaitMJSONWP(ms: number): Promise<void>;
-  pageLoadTimeoutW3C(ms: number): Promise<void>;
-  pageLoadTimeoutMJSONWP(ms: number): Promise<void>;
-  scriptTimeoutW3C(ms: number): Promise<void>;
-  scriptTimeoutMJSONWP(ms: number): Promise<void>;
-  newCommandTimeout(ms: number): Promise<void>;
-  parseTimeoutArgument(ms: number | string): number;
-}
-
-export interface EventCommands {
-  logCustomEvent(vendor: string, event: string): Promise<void>;
-  getLogEvents(type?: string | string[]): Promise<EventHistory | Record<string, number>>;
-}
-
-export interface SessionCommands {
-  getSessions(): Promise<MultiSessionData[]>;
-  getSession(): Promise<SingularSessionData>;
-}
-
-export interface MultiSessionData {
-  id: string;
-  capabilities: Capabilities;
-}
-
-export type SingularSessionData = Capabilities & {events?: EventHistory};
-
-export interface FindCommands {
-  findElement(strategy: string, selector: string): Promise<Element>;
-  findElements(strategy: string, selector: string): Promise<Element[]>;
-  findElementFromElement(
-    strategy: string,
-    selector: string,
-    elementId: string,
-  ): Promise<Element>;
-  findElementsFromElement(
-    strategy: string,
-    selector: string,
-    elementId: string,
-  ): Promise<Element[]>;
-
-  findElOrEls<Mult extends boolean>(
-    strategy: string,
-    selector: string,
-    mult: Mult,
-    context?: string,
-  ): Promise<Mult extends true ? Element[] : Element>;
-
-  findElOrElsWithProcessing<Mult extends boolean>(
-    strategy: string,
-    selector: string,
-    mult: Mult,
-    context?: string,
-  ): Promise<Mult extends true ? Element[] : Element>;
-
-  getPageSource(): Promise<string>;
-}
-
-export interface LogCommands {
-  supportedLogTypes: Record<string, LogType<Driver>>;
-  getLogTypes(): Promise<string[]>;
+/**
+ * The definition of an extension method, which will be provided via Appium's API.
+ *
+ */
+export interface Method<T> {
   /**
-   * Gets logs
-   * 
-   * TODO: `logType` should be a key in `supportedLogTypes`, and the return value of this function
-   * should be the associated `LogType` object's `LogEntry` parameterized type.
-   * @param logType - Name/key of log type as defined in {@linkcode LogCommands.supportedLogTypes}.
+   * Name of the command.
    */
-  getLog(logType: string): Promise<any[]>;
-}
-
-export interface SettingsCommands {
-  updateSettings: (settings: Record<string, any>) => Promise<void>;
-  getSettings(): Promise<Record<string, any>>;
+  command?: keyof ConditionalPick<Required<T>, DriverCommand>;
+  /**
+   * If true, this `Method` will never proxy.
+   */
+  neverProxy?: boolean;
+  /**
+   * Specifies shape of payload
+   */
+  payloadParams?: PayloadParams;
 }
 
-export interface SessionHandler<CreateResult, DeleteResult> {
-  createSession(
-    w3cCaps1: W3CCapabilities,
-    w3cCaps2?: W3CCapabilities,
-    w3cCaps?: W3CCapabilities,
-    driverData?: DriverData[],
-  ): Promise<CreateResult>;
+/**
+ * An instance method of a driver class, whose name may be referenced by {@linkcode Method.command}, and serves as an Appium command.
+ *
+ * Note that this signature differs from a `PluginCommand`.
+ */
+export type DriverCommand<TArgs = any, TRetval = unknown> = (...args: TArgs[]) => Promise<TRetval>;
 
-  deleteSession(
-    sessionId?: string,
-    driverData?: DriverData[],
-  ): Promise<DeleteResult>;
+/**
+ * Defines the shape of a payload for a {@linkcode Method}.
+ */
+export interface PayloadParams {
+  wrap?: string;
+  unwrap?: string;
+  required?: Readonly<string[]> | MultidimensionalReadonlyArray<string, 2>;
+  optional?: Readonly<string[]> | MultidimensionalReadonlyArray<string, 2>;
+  validate?: (obj: any, protocol: string) => boolean | string | undefined;
+  makeArgs?: (obj: any) => any;
 }
-
-export type DriverData = Record<string, unknown>;
+/**
+ * A mapping of URL paths to HTTP methods to {@linkcode Method}s.
+ *
+ * @todo Should use {@linkcode HTTPMethod} here
+ */
+export type MethodMap<Extension = ExternalDriver> = Record<
+  string,
+  Record<string, Method<Extension & ExternalDriver>>
+>;
 
 /**
  * Wraps {@linkcode _Class `type-fest`'s `Class`} to include static members.
@@ -634,5 +114,42 @@ export type DriverData = Record<string, unknown>;
 export type Class<
   Proto,
   StaticMembers extends object = {},
-  Args extends unknown[] = any[],
+  Args extends unknown[] = any[]
 > = _Class<Proto, Args> & StaticMembers;
+
+/**
+ * The string referring to a "driver"-type extension
+ */
+export type DriverType = 'driver';
+
+/**
+ * The string referring to a "plugin"-type extension
+ *
+ */
+export type PluginType = 'plugin';
+
+/**
+ * The strings referring to all extension types.
+ */
+export type ExtensionType = DriverType | PluginType;
+
+/**
+ * Optionally updates an Appium express app and http server, by calling
+ * methods that may mutate those objects. For example, you could call:
+ *
+ * `expressApp.get('/foo', handler)`
+ *
+ * In order to add a new route to Appium with this plugin. Or, you could add
+ * new listeners to the httpServer object.
+ *
+ * @param expressApp - the Express 'app' object used by Appium for route handling
+ * @param httpServer - the node HTTP server that hosts the app
+ */
+export type UpdateServerCallback = (expressApp: Express, httpServer: AppiumServer) => Promise<void>;
+
+/**
+ * Possible HTTP methods, as stolen from `axios`.
+ *
+ * @see https://npm.im/axios
+ */
+export type HTTPMethod = _Method;