@fluentui-react-native/desktop-driver 0.2.0

package/lib/protocol/actions.js

@@ -0,0 +1,137 @@
+import { invalidArgument } from './errors.js';
+export function createInputState() {
+    return { pressedButtons: new Set(), pressedKeys: new Set() };
+}
+export function parseActionSequences(value, current) {
+    if (!Array.isArray(value)) {
+        throw invalidArgument('"actions" must be an array.');
+    }
+    const nextState = {
+        pressedButtons: new Set(current.pressedButtons),
+        pressedKeys: new Set(current.pressedKeys),
+    };
+    const sourceIds = new Set();
+    const actions = value.map((item, index) => parseSource(item, index, sourceIds, nextState));
+    return { actions, nextState };
+}
+function parseSource(value, index, sourceIds, state) {
+    const source = requireObject(value, `actions[${index}]`);
+    if (typeof source.id !== 'string' || !source.id) {
+        throw invalidArgument(`actions[${index}].id must be a non-empty string.`);
+    }
+    if (sourceIds.has(source.id)) {
+        throw invalidArgument(`Action source id "${source.id}" is duplicated.`);
+    }
+    sourceIds.add(source.id);
+    if (source.type !== 'key' && source.type !== 'none' && source.type !== 'pointer' && source.type !== 'wheel') {
+        throw invalidArgument(`actions[${index}].type is not a supported input source.`);
+    }
+    if (!Array.isArray(source.actions)) {
+        throw invalidArgument(`actions[${index}].actions must be an array.`);
+    }
+    if (source.type === 'pointer' && source.parameters !== undefined) {
+        const parameters = requireObject(source.parameters, `actions[${index}].parameters`);
+        if (parameters.pointerType !== undefined &&
+            parameters.pointerType !== 'mouse' &&
+            parameters.pointerType !== 'pen' &&
+            parameters.pointerType !== 'touch') {
+            throw invalidArgument(`actions[${index}].parameters.pointerType is invalid.`);
+        }
+    }
+    const parsedActions = source.actions.map((action, actionIndex) => parseAction(action, source.type, `actions[${index}].actions[${actionIndex}]`, state));
+    return {
+        id: source.id,
+        type: source.type,
+        ...(source.parameters === undefined ? {} : { parameters: source.parameters }),
+        actions: parsedActions,
+    };
+}
+function parseAction(value, sourceType, path, state) {
+    const action = requireObject(value, path);
+    if (typeof action.type !== 'string') {
+        throw invalidArgument(`${path}.type must be a string.`);
+    }
+    if (action.type === 'pause') {
+        validateDuration(action.duration, path);
+        return action;
+    }
+    if (sourceType === 'none') {
+        throw invalidArgument(`${path}.type must be "pause" for a none input source.`);
+    }
+    if (sourceType === 'key') {
+        if (action.type !== 'keyDown' && action.type !== 'keyUp') {
+            throw invalidArgument(`${path}.type is invalid for a key input source.`);
+        }
+        if (typeof action.value !== 'string' || action.value.length === 0) {
+            throw invalidArgument(`${path}.value must be a non-empty string.`);
+        }
+        if (action.type === 'keyDown') {
+            state.pressedKeys.add(action.value);
+        }
+        else {
+            state.pressedKeys.delete(action.value);
+        }
+        return action;
+    }
+    if (sourceType === 'pointer') {
+        if (action.type === 'pointerCancel') {
+            state.pressedButtons.clear();
+            return action;
+        }
+        if (action.type === 'pointerDown' || action.type === 'pointerUp') {
+            if (!Number.isInteger(action.button) || action.button < 0) {
+                throw invalidArgument(`${path}.button must be a non-negative integer.`);
+            }
+            if (action.type === 'pointerDown') {
+                state.pressedButtons.add(action.button);
+            }
+            else {
+                state.pressedButtons.delete(action.button);
+            }
+            return action;
+        }
+        if (action.type === 'pointerMove') {
+            validateCoordinates(action, path);
+            validateDuration(action.duration, path);
+            validateOrigin(action.origin, path);
+            return action;
+        }
+        throw invalidArgument(`${path}.type is invalid for a pointer input source.`);
+    }
+    if (action.type !== 'scroll') {
+        throw invalidArgument(`${path}.type is invalid for a wheel input source.`);
+    }
+    validateCoordinates(action, path);
+    if (typeof action.deltaX !== 'number' || typeof action.deltaY !== 'number') {
+        throw invalidArgument(`${path}.deltaX and deltaY must be numbers.`);
+    }
+    validateDuration(action.duration, path);
+    validateOrigin(action.origin, path);
+    return action;
+}
+function validateCoordinates(action, path) {
+    if (typeof action.x !== 'number' || typeof action.y !== 'number') {
+        throw invalidArgument(`${path}.x and y must be numbers.`);
+    }
+}
+function validateDuration(value, path) {
+    if (value !== undefined && (!Number.isInteger(value) || value < 0)) {
+        throw invalidArgument(`${path}.duration must be a non-negative integer.`);
+    }
+}
+function validateOrigin(value, path) {
+    if (value === undefined || value === 'viewport' || value === 'pointer') {
+        return;
+    }
+    if (value && typeof value === 'object' && typeof value['element-6066-11e4-a52e-4f735466cecf'] === 'string') {
+        return;
+    }
+    throw invalidArgument(`${path}.origin must be "viewport", "pointer", or a WebDriver element reference.`);
+}
+function requireObject(value, path) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw invalidArgument(`${path} must be an object.`);
+    }
+    return value;
+}
+//# sourceMappingURL=actions.js.map

package/lib/protocol/actions.js.map

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

package/lib/protocol/capabilities.d.ts

@@ -0,0 +1,11 @@
+import type { DesktopHostInfo, DesktopTarget } from '../host/types.js';
+import type { DesktopClickMode, NewSessionCapabilities } from './types.js';
+export type MatchedCapabilities = {
+    clickMode: DesktopClickMode;
+    requested: Record<string, unknown>;
+    target: DesktopTarget;
+};
+export declare function getCapabilityCandidates(capabilities: NewSessionCapabilities): Record<string, unknown>[];
+export declare function matchCapabilities(capabilities: NewSessionCapabilities, targets: readonly DesktopTarget[]): Promise<MatchedCapabilities>;
+export declare function createReturnedCapabilities(matched: MatchedCapabilities, host: DesktopHostInfo, timeouts: Record<string, number>): Record<string, unknown>;
+//# sourceMappingURL=capabilities.d.ts.map

package/lib/protocol/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/protocol/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAgB3E,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,MAAM,EAAE,aAAa,CAAC;CACvB,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAmBvG;AAED,wBAAsB,iBAAiB,CACrC,YAAY,EAAE,sBAAsB,EACpC,OAAO,EAAE,SAAS,aAAa,EAAE,GAChC,OAAO,CAAC,mBAAmB,CAAC,CA6B9B;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,mBAAmB,EAC5B,IAAI,EAAE,eAAe,EACrB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYzB"}

package/lib/protocol/capabilities.js

@@ -0,0 +1,103 @@
+import { invalidArgument, WebDriverError } from './errors.js';
+import { withCommandTimeout } from './timeouts.js';
+const standardCapabilities = new Set([
+    'acceptInsecureCerts',
+    'browserName',
+    'browserVersion',
+    'pageLoadStrategy',
+    'platformName',
+    'proxy',
+    'setWindowRect',
+    'strictFileInteractability',
+    'timeouts',
+    'unhandledPromptBehavior',
+    'webSocketUrl',
+]);
+export function getCapabilityCandidates(capabilities) {
+    if (!capabilities || typeof capabilities !== 'object' || Array.isArray(capabilities)) {
+        throw invalidArgument('"capabilities" must be an object.');
+    }
+    const alwaysMatch = validateCapabilityObject(capabilities.alwaysMatch ?? {}, 'alwaysMatch');
+    const firstMatch = capabilities.firstMatch ?? [{}];
+    if (!Array.isArray(firstMatch) || firstMatch.length === 0) {
+        throw invalidArgument('"firstMatch" must be a non-empty array when provided.');
+    }
+    return firstMatch.map((entry, index) => {
+        const candidate = validateCapabilityObject(entry, `firstMatch[${index}]`);
+        for (const key of Object.keys(candidate)) {
+            if (key in alwaysMatch) {
+                throw invalidArgument(`Capability "${key}" appears in both alwaysMatch and firstMatch[${index}].`);
+            }
+        }
+        return { ...alwaysMatch, ...candidate };
+    });
+}
+export async function matchCapabilities(capabilities, targets) {
+    const candidates = getCapabilityCandidates(capabilities);
+    for (const requested of candidates) {
+        validateCapabilityNames(requested);
+        const targetId = requested['furn:target'];
+        const candidatesForTarget = typeof targetId === 'string' ? targets.filter((target) => target.id === targetId) : targets.length === 1 ? targets : [];
+        for (const target of candidatesForTarget) {
+            if (requested.browserName !== undefined && requested.browserName !== 'furn-native-desktop') {
+                continue;
+            }
+            if (requested.platformName !== undefined && requested.platformName !== target.platformName) {
+                continue;
+            }
+            if (requested['furn:endpoint'] !== undefined && requested['furn:endpoint'] !== target.endpoint) {
+                continue;
+            }
+            if (requested['furn:renderer'] !== undefined && requested['furn:renderer'] !== target.renderer) {
+                continue;
+            }
+            const host = await withCommandTimeout((signal) => target.host.probe(signal), 10_000, `Probing target "${target.id}"`);
+            const clickMode = resolveClickMode(requested['furn:clickMode'], host);
+            return { clickMode, requested, target };
+        }
+    }
+    throw new WebDriverError('session not created', 'No registered desktop target matched the requested capabilities.');
+}
+export function createReturnedCapabilities(matched, host, timeouts) {
+    return {
+        browserName: 'furn-native-desktop',
+        platformName: matched.target.platformName,
+        setWindowRect: host.features.setWindowRect,
+        timeouts,
+        'furn:clickMode': matched.clickMode,
+        'furn:endpoint': matched.target.endpoint,
+        'furn:features': host.features,
+        'furn:renderer': matched.target.renderer,
+        'furn:target': matched.target.id,
+    };
+}
+function validateCapabilityObject(value, name) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw invalidArgument(`"${name}" must be an object.`);
+    }
+    return value;
+}
+function validateCapabilityNames(capabilities) {
+    for (const name of Object.keys(capabilities)) {
+        if (!standardCapabilities.has(name) && !name.includes(':')) {
+            throw invalidArgument(`Extension capability "${name}" must contain a vendor prefix followed by ":".`);
+        }
+    }
+}
+function resolveClickMode(requested, host) {
+    const clickMode = requested ?? 'auto';
+    if (clickMode !== 'auto' && clickMode !== 'physical' && clickMode !== 'accessibility') {
+        throw invalidArgument('"furn:clickMode" must be "auto", "physical", or "accessibility".');
+    }
+    if (clickMode === 'physical' && !host.features.physicalClick) {
+        throw new WebDriverError('session not created', 'The target does not support physical click input.');
+    }
+    if (clickMode === 'accessibility' && !host.features.accessibilityClick) {
+        throw new WebDriverError('session not created', 'The target does not support accessibility click input.');
+    }
+    if (clickMode === 'auto' && !host.features.physicalClick && !host.features.accessibilityClick) {
+        throw new WebDriverError('session not created', 'The target does not support any click input mode.');
+    }
+    return clickMode === 'auto' ? (host.features.physicalClick ? 'physical' : 'accessibility') : clickMode;
+}
+//# sourceMappingURL=capabilities.js.map

package/lib/protocol/capabilities.js.map

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

package/lib/protocol/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const webElementIdentifier: 'element-6066-11e4-a52e-4f735466cecf';
+//# sourceMappingURL=constants.d.ts.map

package/lib/protocol/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/protocol/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,EAAG,qCAA8C,CAAC"}

package/lib/protocol/constants.js

@@ -0,0 +1,2 @@
+export const webElementIdentifier = 'element-6066-11e4-a52e-4f735466cecf';
+//# sourceMappingURL=constants.js.map

package/lib/protocol/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/protocol/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG,qCAA8C,CAAC"}

package/lib/protocol/errors.d.ts

@@ -0,0 +1,37 @@
+import type { WebDriverErrorValue } from './types.js';
+declare const errorStatuses: {
+    readonly 'element click intercepted': 400;
+    readonly 'element not interactable': 400;
+    readonly 'invalid argument': 400;
+    readonly 'invalid selector': 400;
+    readonly 'invalid session id': 404;
+    readonly 'javascript error': 500;
+    readonly 'no such element': 404;
+    readonly 'no such window': 404;
+    readonly 'session not created': 500;
+    readonly 'stale element reference': 404;
+    readonly timeout: 500;
+    readonly 'unable to capture screen': 500;
+    readonly 'unknown command': 404;
+    readonly 'unknown error': 500;
+    readonly 'unknown method': 405;
+    readonly 'unsupported operation': 500;
+};
+export type WebDriverErrorCode = keyof typeof errorStatuses;
+export declare class WebDriverError extends Error {
+    readonly code: WebDriverErrorCode;
+    readonly data?: Record<string, unknown>;
+    readonly status: number;
+    constructor(code: WebDriverErrorCode, message: string, data?: Record<string, unknown>);
+    toJSON(): WebDriverErrorValue;
+}
+export declare function invalidArgument(message: string): WebDriverError;
+export declare function toWebDriverError(error: unknown): WebDriverError;
+export declare class HostStaleError extends Error {
+    constructor(message?: string);
+}
+export declare class HostUnsupportedError extends Error {
+    constructor(message: string);
+}
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/lib/protocol/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/protocol/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,QAAA,MAAM,aAAa;aACjB,2BAA2B,EAAE,GAAG;aAChC,0BAA0B,EAAE,GAAG;aAC/B,kBAAkB,EAAE,GAAG;aACvB,kBAAkB,EAAE,GAAG;aACvB,oBAAoB,EAAE,GAAG;aACzB,kBAAkB,EAAE,GAAG;aACvB,iBAAiB,EAAE,GAAG;aACtB,gBAAgB,EAAE,GAAG;aACrB,qBAAqB,EAAE,GAAG;aAC1B,yBAAyB,EAAE,GAAG;aAC9B,OAAO,EAAE,GAAG;aACZ,0BAA0B,EAAE,GAAG;aAC/B,iBAAiB,EAAE,GAAG;aACtB,eAAe,EAAE,GAAG;aACpB,gBAAgB,EAAE,GAAG;aACrB,uBAAuB,EAAE,GAAG;CACpB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,aAAa,CAAC;AAE5D,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,YAAY,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAMpF;IAED,MAAM,IAAI,mBAAmB,CAO5B;CACF;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAE/D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAW/D;AAED,qBAAa,cAAe,SAAQ,KAAK;IACvC,YAAY,OAAO,SAA+C,EAGjE;CACF;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF"}

package/lib/protocol/errors.js

@@ -0,0 +1,66 @@
+const errorStatuses = {
+    'element click intercepted': 400,
+    'element not interactable': 400,
+    'invalid argument': 400,
+    'invalid selector': 400,
+    'invalid session id': 404,
+    'javascript error': 500,
+    'no such element': 404,
+    'no such window': 404,
+    'session not created': 500,
+    'stale element reference': 404,
+    timeout: 500,
+    'unable to capture screen': 500,
+    'unknown command': 404,
+    'unknown error': 500,
+    'unknown method': 405,
+    'unsupported operation': 500,
+};
+export class WebDriverError extends Error {
+    code;
+    data;
+    status;
+    constructor(code, message, data) {
+        super(message);
+        this.name = 'WebDriverError';
+        this.code = code;
+        this.data = data;
+        this.status = errorStatuses[code];
+    }
+    toJSON() {
+        return {
+            error: this.code,
+            message: this.message,
+            stacktrace: this.stack ?? '',
+            ...(this.data ? { data: this.data } : {}),
+        };
+    }
+}
+export function invalidArgument(message) {
+    return new WebDriverError('invalid argument', message);
+}
+export function toWebDriverError(error) {
+    if (error instanceof WebDriverError) {
+        return error;
+    }
+    if (error instanceof HostStaleError) {
+        return new WebDriverError('stale element reference', error.message);
+    }
+    if (error instanceof HostUnsupportedError) {
+        return new WebDriverError('unsupported operation', error.message);
+    }
+    return new WebDriverError('unknown error', error instanceof Error ? error.message : String(error));
+}
+export class HostStaleError extends Error {
+    constructor(message = 'The native element is no longer available.') {
+        super(message);
+        this.name = 'HostStaleError';
+    }
+}
+export class HostUnsupportedError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'HostUnsupportedError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/lib/protocol/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/protocol/errors.ts"],"names":[],"mappings":"AAEA,MAAM,aAAa,GAAG;IACpB,2BAA2B,EAAE,GAAG;IAChC,0BAA0B,EAAE,GAAG;IAC/B,kBAAkB,EAAE,GAAG;IACvB,kBAAkB,EAAE,GAAG;IACvB,oBAAoB,EAAE,GAAG;IACzB,kBAAkB,EAAE,GAAG;IACvB,iBAAiB,EAAE,GAAG;IACtB,gBAAgB,EAAE,GAAG;IACrB,qBAAqB,EAAE,GAAG;IAC1B,yBAAyB,EAAE,GAAG;IAC9B,OAAO,EAAE,GAAG;IACZ,0BAA0B,EAAE,GAAG;IAC/B,iBAAiB,EAAE,GAAG;IACtB,eAAe,EAAE,GAAG;IACpB,gBAAgB,EAAE,GAAG;IACrB,uBAAuB,EAAE,GAAG;CACpB,CAAC;AAIX,MAAM,OAAO,cAAe,SAAQ,KAAK;IAC9B,IAAI,CAAqB;IACzB,IAAI,CAA2B;IAC/B,MAAM,CAAS;IAExB,YAAY,IAAwB,EAAE,OAAe,EAAE,IAA8B;QACnF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,MAAM;QACJ,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,IAAI;YAChB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,UAAU,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;YAC5B,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1C,CAAC;IACJ,CAAC;CACF;AAED,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,OAAO,IAAI,cAAc,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;QACpC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;QACpC,OAAO,IAAI,cAAc,CAAC,yBAAyB,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,KAAK,YAAY,oBAAoB,EAAE,CAAC;QAC1C,OAAO,IAAI,cAAc,CAAC,uBAAuB,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,IAAI,cAAc,CAAC,eAAe,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AACrG,CAAC;AAED,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC,YAAY,OAAO,GAAG,4CAA4C;QAChE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF"}

package/lib/protocol/timeouts.d.ts

@@ -0,0 +1,2 @@
+export declare function withCommandTimeout<T>(operation: (signal: AbortSignal) => Promise<T>, timeoutMs: number, description: string): Promise<T>;
+//# sourceMappingURL=timeouts.d.ts.map

package/lib/protocol/timeouts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeouts.d.ts","sourceRoot":"","sources":["../../src/protocol/timeouts.ts"],"names":[],"mappings":"AAEA,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,SAAS,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,EAC9C,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,CAAC,CAAC,CAmBZ"}

package/lib/protocol/timeouts.js

@@ -0,0 +1,23 @@
+import { WebDriverError } from './errors.js';
+export async function withCommandTimeout(operation, timeoutMs, description) {
+    let timer;
+    const controller = new AbortController();
+    try {
+        return await Promise.race([
+            operation(controller.signal),
+            new Promise((_resolve, reject) => {
+                timer = setTimeout(() => {
+                    const error = new WebDriverError('timeout', `${description} exceeded ${timeoutMs}ms.`);
+                    controller.abort(error);
+                    reject(error);
+                }, timeoutMs);
+            }),
+        ]);
+    }
+    finally {
+        if (timer) {
+            clearTimeout(timer);
+        }
+    }
+}
+//# sourceMappingURL=timeouts.js.map

package/lib/protocol/timeouts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeouts.js","sourceRoot":"","sources":["../../src/protocol/timeouts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,SAA8C,EAC9C,SAAiB,EACjB,WAAmB;IAEnB,IAAI,KAAgD,CAAC;IACrD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC;YACxB,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC;YAC5B,IAAI,OAAO,CAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;gBACtC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;oBACtB,MAAM,KAAK,GAAG,IAAI,cAAc,CAAC,SAAS,EAAE,GAAG,WAAW,aAAa,SAAS,KAAK,CAAC,CAAC;oBACvF,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;oBACxB,MAAM,CAAC,KAAK,CAAC,CAAC;gBAChB,CAAC,EAAE,SAAS,CAAC,CAAC;YAChB,CAAC,CAAC;SACH,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,IAAI,KAAK,EAAE,CAAC;YACV,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;AACH,CAAC"}

package/lib/protocol/types.d.ts

@@ -0,0 +1,46 @@
+export type DesktopEndpoint = 'macos' | 'windows' | 'win32';
+export type DesktopPlatformName = 'macos' | 'windows';
+export type DesktopRenderer = 'fabric' | 'paper';
+export type DesktopClickMode = 'physical' | 'accessibility' | 'auto';
+export type WebDriverTimeouts = {
+    implicit: number;
+    pageLoad: number;
+    script: number;
+};
+export type DesktopTimeouts = {
+    appLaunch: number;
+    nativeCommand: number;
+    stableLayout: number;
+    storyRender: number;
+};
+export type NewSessionCapabilities = {
+    alwaysMatch?: Record<string, unknown>;
+    firstMatch?: Record<string, unknown>[];
+};
+export type NewSessionRequest = {
+    capabilities: NewSessionCapabilities;
+};
+export type WebDriverElement = {
+    'element-6066-11e4-a52e-4f735466cecf': string;
+};
+export type WebDriverResponse<T = unknown> = {
+    value: T;
+};
+export type WebDriverErrorValue = {
+    error: string;
+    message: string;
+    stacktrace: string;
+    data?: Record<string, unknown>;
+};
+export type WebDriverErrorResponse = WebDriverResponse<WebDriverErrorValue>;
+export type WebDriverAction = {
+    type: string;
+    [key: string]: unknown;
+};
+export type WebDriverActionSequence = {
+    id: string;
+    type: 'key' | 'none' | 'pointer' | 'wheel';
+    parameters?: Record<string, unknown>;
+    actions: WebDriverAction[];
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/protocol/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;AAC5D,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,SAAS,CAAC;AACtD,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,OAAO,CAAC;AACjD,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,eAAe,GAAG,MAAM,CAAC;AAErE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,YAAY,EAAE,sBAAsB,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,qCAAqC,EAAE,MAAM,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,iBAAiB,CAAC,CAAC,GAAG,OAAO,IAAI;IAC3C,KAAK,EAAE,CAAC,CAAC;CACV,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,iBAAiB,CAAC,mBAAmB,CAAC,CAAC;AAE5E,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B,CAAC"}

package/lib/protocol/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/lib/protocol/types.js.map

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

package/lib/runner/StoryTestRunner.d.ts

@@ -0,0 +1,38 @@
+import type { DesktopStoryRunResult } from '../authoring/results.js';
+import type { DesktopStoryExpectation, DesktopStorySelector, DesktopStoryTest } from '../authoring/storyTests.js';
+import type { ArtifactManager } from '../artifacts/ArtifactManager.js';
+import type { DesktopElementClient, DesktopSessionClient } from '../client/DesktopDriverClient.js';
+import type { DesktopEndpoint, DesktopPlatformName } from '../protocol/types.js';
+import type { DesktopStoryManifest, DesktopStoryManifestEntry } from '../storybook.js';
+export type DesktopStoryTestSelection = {
+    shardCount?: number;
+    shardIndex?: number;
+    story?: string;
+    tag?: string;
+    test?: string;
+};
+export type DesktopStoryTestRunnerOptions = {
+    artifacts?: ArtifactManager;
+    endpoint: DesktopEndpoint;
+    manifest: DesktopStoryManifest;
+    platformName: DesktopPlatformName;
+    runId?: string;
+    selection?: DesktopStoryTestSelection;
+    session: DesktopSessionClient;
+    signal?: AbortSignal;
+    targetId: string;
+};
+type SelectedTest = {
+    entry: DesktopStoryManifestEntry;
+    test: DesktopStoryTest;
+};
+export declare function runDesktopStoryTests({ artifacts, endpoint, manifest, platformName, runId, selection, session, signal, targetId, }: DesktopStoryTestRunnerOptions): Promise<DesktopStoryRunResult>;
+export declare function selectDesktopStoryTests(manifest: DesktopStoryManifest, endpoint: DesktopEndpoint, selection?: DesktopStoryTestSelection): SelectedTest[];
+export declare function assertDesktopExpectation(session: DesktopSessionClient, expectation: DesktopStoryExpectation): Promise<void>;
+export declare function findDesktopElement(session: DesktopSessionClient, selector: DesktopStorySelector): Promise<DesktopElementClient>;
+export declare function findDesktopElements(session: DesktopSessionClient, selector: DesktopStorySelector): Promise<DesktopElementClient[]>;
+export declare class DesktopAssertionError extends Error {
+    constructor(message: string);
+}
+export {};
+//# sourceMappingURL=StoryTestRunner.d.ts.map

package/lib/runner/StoryTestRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StoryTestRunner.d.ts","sourceRoot":"","sources":["../../src/runner/StoryTestRunner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,qBAAqB,EAItB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAEV,uBAAuB,EACvB,oBAAoB,EAEpB,gBAAgB,EACjB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAGnG,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAA2B,MAAM,sBAAsB,CAAC;AAC1G,OAAO,KAAK,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAEvF,MAAM,MAAM,yBAAyB,GAAG;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,YAAY,EAAE,mBAAmB,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,yBAAyB,CAAC;IACtC,OAAO,EAAE,oBAAoB,CAAC;IAC9B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,KAAK,YAAY,GAAG;IAClB,KAAK,EAAE,yBAAyB,CAAC;IACjC,IAAI,EAAE,gBAAgB,CAAC;CACxB,CAAC;AAEF,wBAAsB,oBAAoB,CAAC,EACzC,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,KAAoB,EACpB,SAAS,EACT,OAAO,EACP,MAAM,EACN,QAAQ,GACT,EAAE,6BAA6B,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA+ChE;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,oBAAoB,EAC9B,QAAQ,EAAE,eAAe,EACzB,SAAS,GAAE,yBAA8B,GACxC,YAAY,EAAE,CAmBhB;AAwMD,wBAAsB,wBAAwB,CAAC,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkDjI;AA8BD,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAMrI;AAED,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAqBxI;AAsID,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF"}