@fluentui-react-native/desktop-driver 0.2.0

package/lib/runner/StoryTestRunner.test.js

@@ -0,0 +1,349 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { ArtifactManager } from '../artifacts/ArtifactManager.js';
+import { createDesktopDriverClient } from '../client/DesktopDriverClient.js';
+import { createDesktopDriverStoryHarness } from '../testing/protocolHarness.js';
+import { runDesktopStoryTests, selectDesktopStoryTests } from './StoryTestRunner.js';
+import { findDesktopElements } from './StoryTestRunner.js';
+const passingPlan = {
+    version: 1,
+    tests: [
+        {
+            id: 'button-contract',
+            requires: ['focus', 'keyboard', 'screenshot', 'wheel'],
+            steps: [
+                { action: 'wait', target: { testId: 'button-primary' }, timeoutMs: 100 },
+                { expect: { state: 'role', target: { testId: 'button-primary' }, value: 'button' } },
+                { expect: { state: 'enabled', target: { testId: 'button-primary' }, value: true } },
+                { action: 'click', target: { testId: 'button-primary' } },
+                { expect: { state: 'focused', target: { testId: 'button-primary' }, value: true } },
+                { action: 'type', target: { testId: 'input-name' }, text: 'Ada' },
+                { expect: { state: 'value', target: { testId: 'input-name' }, value: 'Ada' } },
+                { action: 'keys', value: ['\uE004'] },
+                { action: 'scroll', deltaY: 120 },
+                { action: 'setArgs', args: { disabled: false } },
+                { action: 'screenshot', name: 'button' },
+                { action: 'source', name: 'source' },
+            ],
+            title: 'Button contract',
+        },
+    ],
+};
+describe('runDesktopStoryTests', () => {
+    test('runs a portable plan and writes a stable evidence report', async () => {
+        const manifest = makeManifest(passingPlan);
+        const harness = await createDesktopDriverStoryHarness(manifest);
+        const temporaryDirectory = fs.mkdtempSync(path.join(os.tmpdir(), 'desktop-driver-run-'));
+        try {
+            const client = createDesktopDriverClient({ url: harness.server.url });
+            const session = await client.newSession({
+                alwaysMatch: { platformName: 'windows', 'furn:target': harness.target.id },
+            });
+            const result = await runDesktopStoryTests({
+                artifacts: new ArtifactManager(temporaryDirectory),
+                endpoint: 'windows',
+                manifest,
+                platformName: 'windows',
+                runId: 'run',
+                session,
+                targetId: harness.target.id,
+            });
+            expect(result).toMatchObject({
+                status: 'passed',
+                tests: [
+                    {
+                        status: 'passed',
+                        steps: expect.arrayContaining([expect.objectContaining({ status: 'passed' })]),
+                    },
+                ],
+            });
+            expect(result.tests[0].artifacts.map(({ kind }) => kind)).toEqual(['screenshot', 'source']);
+            expect(harness.storyOrchestrator?.argUpdates).toEqual([{ args: { disabled: false }, storyId: 'components-button--default' }]);
+            expect(JSON.parse(fs.readFileSync(path.join(temporaryDirectory, 'run.json'), 'utf8'))).toMatchObject({
+                runId: 'run',
+                status: 'passed',
+            });
+            expect(JSON.parse(fs.readFileSync(path.join(temporaryDirectory, 'host.json'), 'utf8'))).toMatchObject({
+                endpoint: 'windows',
+                targetId: harness.target.id,
+            });
+            await session.delete();
+        }
+        finally {
+            await harness.close();
+            fs.rmSync(temporaryDirectory, { force: true, recursive: true });
+        }
+    });
+    test('distinguishes assertion failures and captures failure evidence', async () => {
+        const manifest = makeManifest({
+            version: 1,
+            tests: [
+                {
+                    id: 'fails',
+                    steps: [{ expect: { state: 'role', target: { testId: 'button-primary' }, value: 'checkbox' } }],
+                },
+            ],
+        });
+        const harness = await createDesktopDriverStoryHarness(manifest);
+        const temporaryDirectory = fs.mkdtempSync(path.join(os.tmpdir(), 'desktop-driver-failure-'));
+        try {
+            const client = createDesktopDriverClient({ url: harness.server.url });
+            const session = await client.newSession({
+                alwaysMatch: { platformName: 'windows', 'furn:target': harness.target.id },
+            });
+            const result = await runDesktopStoryTests({
+                artifacts: new ArtifactManager(temporaryDirectory),
+                endpoint: 'windows',
+                manifest,
+                platformName: 'windows',
+                session,
+                targetId: harness.target.id,
+            });
+            expect(result.status).toBe('failed');
+            expect(result.tests[0]).toMatchObject({
+                status: 'failed',
+                error: expect.stringContaining('checkbox'),
+            });
+            expect(result.tests[0].artifacts.map(({ name }) => name)).toEqual(['failure', 'failure-source', 'failure-tree']);
+            await session.delete();
+        }
+        finally {
+            await harness.close();
+            fs.rmSync(temporaryDirectory, { force: true, recursive: true });
+        }
+    });
+    test('filters and deterministically shards plans', () => {
+        const manifest = makeManifest({
+            version: 1,
+            tests: [
+                { id: 'one', steps: [{ action: 'note', message: 'one' }] },
+                { id: 'two', steps: [{ action: 'note', message: 'two' }] },
+                { id: 'three', steps: [{ action: 'note', message: 'three' }] },
+                { id: 'four', steps: [{ action: 'note', message: 'four' }] },
+            ],
+        });
+        const first = selectDesktopStoryTests(manifest, 'windows', { shardCount: 2, shardIndex: 0 });
+        const second = selectDesktopStoryTests(manifest, 'windows', { shardCount: 2, shardIndex: 1 });
+        expect([...first, ...second].map(({ test }) => test.id).sort()).toEqual(['four', 'one', 'three', 'two']);
+        expect(first).toHaveLength(2);
+        expect(second).toHaveLength(2);
+    });
+    test('does not turn an unsupported runtime property into a passing skip', async () => {
+        const manifest = makeManifest({
+            version: 1,
+            tests: [
+                {
+                    id: 'unsupported-checked',
+                    steps: [{ expect: { state: 'checked', target: { testId: 'button-primary' }, value: true } }],
+                },
+            ],
+        });
+        const harness = await createDesktopDriverStoryHarness(manifest);
+        harness.host.setElementStateUnsupported('button', 'checked', 'not exposed by this platform');
+        try {
+            const client = createDesktopDriverClient({ url: harness.server.url });
+            const session = await client.newSession({
+                alwaysMatch: { platformName: 'windows', 'furn:target': harness.target.id },
+            });
+            const result = await runDesktopStoryTests({
+                endpoint: 'windows',
+                manifest,
+                platformName: 'windows',
+                session,
+                targetId: harness.target.id,
+            });
+            expect(result).toMatchObject({
+                status: 'failed',
+                tests: [{ status: 'failed', error: expect.stringContaining('not exposed') }],
+            });
+            await session.delete();
+        }
+        finally {
+            await harness.close();
+        }
+    });
+    test('matches text independently from accessible name', async () => {
+        const harness = await createDesktopDriverStoryHarness(makeManifest(passingPlan), {
+            windows: [
+                {
+                    id: 'window-1',
+                    title: 'Text selector',
+                    elements: [
+                        {
+                            id: 'label',
+                            rect: { height: 20, width: 100, x: 0, y: 0 },
+                            role: 'text',
+                            scope: 'preview',
+                            text: 'Visible text',
+                            windowId: 'window-1',
+                        },
+                        {
+                            id: 'story-root',
+                            automationId: 'story-root',
+                            name: JSON.stringify({ previewGeneration: 0, storyId: 'initial--story' }),
+                            rect: { height: 100, width: 100, x: 0, y: 0 },
+                            role: 'group',
+                            scope: 'preview',
+                            windowId: 'window-1',
+                        },
+                    ],
+                },
+            ],
+        });
+        try {
+            const client = createDesktopDriverClient({ url: harness.server.url });
+            const session = await client.newSession({
+                alwaysMatch: { platformName: 'windows', 'furn:target': harness.target.id },
+            });
+            await expect(findDesktopElements(session, { text: 'Visible' })).resolves.toHaveLength(1);
+            await session.delete();
+        }
+        finally {
+            await harness.close();
+        }
+    });
+    test('cancels an in-flight wait and releases input before the next test', async () => {
+        const manifest = makeManifest({
+            version: 1,
+            tests: [
+                {
+                    id: 'cancelled-wait',
+                    steps: [{ action: 'wait', target: { testId: 'missing' }, timeoutMs: 1000 }],
+                },
+            ],
+        });
+        const harness = await createDesktopDriverStoryHarness(manifest);
+        const controller = new AbortController();
+        try {
+            const client = createDesktopDriverClient({ url: harness.server.url });
+            const session = await client.newSession({
+                alwaysMatch: { platformName: 'windows', 'furn:target': harness.target.id },
+            });
+            setTimeout(() => controller.abort(), 20);
+            const started = Date.now();
+            const result = await runDesktopStoryTests({
+                endpoint: 'windows',
+                manifest,
+                platformName: 'windows',
+                session,
+                signal: controller.signal,
+                targetId: harness.target.id,
+            });
+            expect(Date.now() - started).toBeLessThan(500);
+            expect(result).toMatchObject({ status: 'failed', tests: [{ status: 'cancelled' }] });
+            expect(harness.host.actions).toContainEqual({ type: 'release-actions' });
+            await session.delete();
+        }
+        finally {
+            await harness.close();
+        }
+    });
+    test('skips a declared focus requirement when focused state is unavailable', async () => {
+        const manifest = makeManifest({
+            version: 1,
+            tests: [
+                {
+                    id: 'focus-required',
+                    requires: ['focus'],
+                    steps: [{ expect: { state: 'focused', target: { testId: 'button-primary' }, value: true } }],
+                },
+            ],
+        });
+        const harness = await createDesktopDriverStoryHarness(manifest, { features: { focus: false } });
+        try {
+            const client = createDesktopDriverClient({ url: harness.server.url });
+            const session = await client.newSession({
+                alwaysMatch: { platformName: 'windows', 'furn:target': harness.target.id },
+            });
+            const result = await runDesktopStoryTests({
+                endpoint: 'windows',
+                manifest,
+                platformName: 'windows',
+                session,
+                targetId: harness.target.id,
+            });
+            expect(result).toMatchObject({
+                status: 'passed',
+                tests: [{ skipReason: 'Unsupported capabilities: focus', status: 'skipped', steps: [] }],
+            });
+            await session.delete();
+        }
+        finally {
+            await harness.close();
+        }
+    });
+    test('drains an aborted native action before releasing input', async () => {
+        const manifest = makeManifest({
+            version: 1,
+            tests: [
+                {
+                    id: 'cancelled-action',
+                    steps: [
+                        {
+                            action: 'actions',
+                            sequences: [{ id: 'key', type: 'key', actions: [{ type: 'keyDown', value: 'A' }] }],
+                        },
+                    ],
+                },
+            ],
+        });
+        const harness = await createDesktopDriverStoryHarness(manifest, { actionDelayMs: 50 });
+        const controller = new AbortController();
+        try {
+            const client = createDesktopDriverClient({ url: harness.server.url });
+            const session = await client.newSession({
+                alwaysMatch: { platformName: 'windows', 'furn:target': harness.target.id },
+            });
+            const running = runDesktopStoryTests({
+                endpoint: 'windows',
+                manifest,
+                platformName: 'windows',
+                session,
+                signal: controller.signal,
+                targetId: harness.target.id,
+            });
+            await waitUntil(() => harness.host.actions.some(({ type }) => type === 'actions-start'));
+            controller.abort();
+            const result = await running;
+            expect(result).toMatchObject({ status: 'failed', tests: [{ status: 'cancelled' }] });
+            const completed = harness.host.actions.findIndex(({ type }) => type === 'actions');
+            const released = harness.host.actions.findIndex(({ type }) => type === 'release-actions');
+            expect(completed).toBeGreaterThan(-1);
+            expect(released).toBeGreaterThan(completed);
+            await session.delete();
+        }
+        finally {
+            await harness.close();
+        }
+    });
+});
+function makeManifest(tests) {
+    return {
+        endpoint: 'windows',
+        entries: [
+            {
+                id: 'components-button--default',
+                name: 'Default',
+                packageName: '@fluentui-react-native/components',
+                sourcePath: 'src/components/button/button.stories.tsx',
+                tags: ['e2e', 'story'],
+                tests,
+                title: 'Components/Button',
+            },
+        ],
+        platformManifestDigest: 'platform-digest',
+        portablePlanDigest: 'portable-digest',
+        schemaVersion: 1,
+    };
+}
+async function waitUntil(predicate, timeoutMs = 1000) {
+    const deadline = Date.now() + timeoutMs;
+    while (!predicate()) {
+        if (Date.now() >= deadline) {
+            throw new Error('Timed out waiting for the expected test condition.');
+        }
+        await new Promise((resolve) => setTimeout(resolve, 1));
+    }
+}
+//# sourceMappingURL=StoryTestRunner.test.js.map

package/lib/runner/StoryTestRunner.test.js.map

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

package/lib/runner/index.d.ts

@@ -0,0 +1,3 @@
+export { assertDesktopExpectation, DesktopAssertionError, findDesktopElement, findDesktopElements, runDesktopStoryTests, selectDesktopStoryTests, } from './StoryTestRunner.js';
+export type { DesktopStoryTestRunnerOptions, DesktopStoryTestSelection } from './StoryTestRunner.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runner/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,6BAA6B,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC"}

package/lib/runner/index.js

@@ -0,0 +1,2 @@
+export { assertDesktopExpectation, DesktopAssertionError, findDesktopElement, findDesktopElements, runDesktopStoryTests, selectDesktopStoryTests, } from './StoryTestRunner.js';
+//# sourceMappingURL=index.js.map

package/lib/runner/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runner/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,sBAAsB,CAAC"}

package/lib/server/SessionManager.d.ts

@@ -0,0 +1,52 @@
+import type { ApplicationLease, DesktopHostInfo, DesktopTarget, DesktopWindow, NativeElementScope, NativeElementSnapshot } from '../host/types.js';
+import type { WebDriverInputState } from '../protocol/actions.js';
+import type { DesktopClickMode, DesktopTimeouts, WebDriverTimeouts } from '../protocol/types.js';
+export type ElementRecord = {
+    id: string;
+    nativeId: string;
+    previewGeneration: number;
+    scope: NativeElementScope;
+};
+export type DesktopSession = {
+    clickMode: DesktopClickMode;
+    currentWindowId: string;
+    desktopTimeouts: DesktopTimeouts;
+    elements: Map<string, ElementRecord>;
+    elementIdsByNativeId: Map<string, string>;
+    hostInfo: DesktopHostInfo;
+    id: string;
+    inputState: WebDriverInputState;
+    issuedElementIds: Set<string>;
+    lease: ApplicationLease;
+    previewGeneration: number;
+    story: {
+        previewGeneration: number;
+        runId: string;
+        storyId: string;
+    } | null;
+    target: DesktopTarget;
+    timeouts: WebDriverTimeouts;
+    windows: DesktopWindow[];
+};
+export declare class SessionManager {
+    private readonly sessions;
+    private readonly sessionsByTarget;
+    private readonly reservedTargets;
+    private readonly commandQueues;
+    private readonly inFlightCreates;
+    private inputQueue;
+    private closing;
+    create(target: DesktopTarget, hostInfo: DesktopHostInfo, clickMode: DesktopClickMode, launchMode: 'attach' | 'launch'): Promise<DesktopSession>;
+    beginClose(): void;
+    waitForCreates(): Promise<void>;
+    private createSession;
+    get(id: string): DesktopSession;
+    runCommand<T>(sessionId: string, operation: () => Promise<T>): Promise<T>;
+    runInputCommand<T>(operation: () => Promise<T>): Promise<T>;
+    delete(id: string): Promise<void>;
+    deleteAll(): Promise<void>;
+    registerElement(session: DesktopSession, snapshot: NativeElementSnapshot): ElementRecord;
+    resolveElement(session: DesktopSession, id: string): ElementRecord;
+    invalidatePreview(session: DesktopSession): void;
+}
+//# sourceMappingURL=SessionManager.d.ts.map

package/lib/server/SessionManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionManager.d.ts","sourceRoot":"","sources":["../../src/server/SessionManager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAGlE,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEjG,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,kBAAkB,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,EAAE,gBAAgB,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,eAAe,CAAC;IACjC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACrC,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,QAAQ,EAAE,eAAe,CAAC;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,mBAAmB,CAAC;IAChC,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,KAAK,EAAE,gBAAgB,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE;QAAE,iBAAiB,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC5E,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B,CAAC;AAEF,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqC;IAC9D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA6B;IAC9D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;IACrD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAoC;IAClE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA4B;IAC5D,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,OAAO,CAAS;IAExB,MAAM,CACJ,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,eAAe,EACzB,SAAS,EAAE,gBAAgB,EAC3B,UAAU,EAAE,QAAQ,GAAG,QAAQ,GAC9B,OAAO,CAAC,cAAc,CAAC,CAYzB;IAED,UAAU,IAAI,IAAI,CAEjB;IAEK,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAEpC;YAEa,aAAa;IAmG3B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,CAM9B;IAED,UAAU,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAcxE;IAED,eAAe,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAO1D;IAEK,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoCtC;IAEK,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAY/B;IAED,eAAe,CAAC,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,qBAAqB,GAAG,aAAa,CAevF;IAED,cAAc,CAAC,OAAO,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,GAAG,aAAa,CAYjE;IAED,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAQ/C;CACF"}

package/lib/server/SessionManager.js

@@ -0,0 +1,208 @@
+import { randomUUID } from 'node:crypto';
+import { createInputState } from '../protocol/actions.js';
+import { WebDriverError } from '../protocol/errors.js';
+import { withCommandTimeout } from '../protocol/timeouts.js';
+export class SessionManager {
+    sessions = new Map();
+    sessionsByTarget = new Map();
+    reservedTargets = new Set();
+    commandQueues = new Map();
+    inFlightCreates = new Set();
+    inputQueue = Promise.resolve();
+    closing = false;
+    create(target, hostInfo, clickMode, launchMode) {
+        if (this.closing) {
+            return Promise.reject(new WebDriverError('session not created', 'Desktop Driver is shutting down.'));
+        }
+        const result = this.createSession(target, hostInfo, clickMode, launchMode);
+        const settled = result.then(() => undefined, () => undefined);
+        this.inFlightCreates.add(settled);
+        void settled.finally(() => this.inFlightCreates.delete(settled));
+        return result;
+    }
+    beginClose() {
+        this.closing = true;
+    }
+    async waitForCreates() {
+        await Promise.all(this.inFlightCreates);
+    }
+    async createSession(target, hostInfo, clickMode, launchMode) {
+        if (this.sessionsByTarget.has(target.id) || this.reservedTargets.has(target.id)) {
+            throw new WebDriverError('session not created', `Target "${target.id}" already has an active session.`);
+        }
+        this.reservedTargets.add(target.id);
+        let lease;
+        let releaseReservation = true;
+        let leasePromise;
+        try {
+            lease = await withCommandTimeout((signal) => {
+                leasePromise = launchMode === 'attach' ? target.host.attach(target, signal) : target.host.launch(target, signal);
+                return leasePromise;
+            }, 120_000, `${launchMode === 'attach' ? 'Attaching to' : 'Launching'} target "${target.id}"`);
+            const activeLease = lease;
+            const windows = await withCommandTimeout((signal) => target.host.windows(activeLease, signal), 10_000, `Reading windows for target "${target.id}"`);
+            if (windows.length === 0) {
+                throw new WebDriverError('session not created', `Target "${target.id}" did not expose any windows.`);
+            }
+            if (this.closing) {
+                throw new WebDriverError('session not created', 'Desktop Driver shut down while the target was starting.');
+            }
+            const session = {
+                clickMode,
+                currentWindowId: windows[0].id,
+                desktopTimeouts: {
+                    appLaunch: 120_000,
+                    nativeCommand: 10_000,
+                    stableLayout: 1_000,
+                    storyRender: 30_000,
+                },
+                elements: new Map(),
+                elementIdsByNativeId: new Map(),
+                hostInfo,
+                id: randomUUID(),
+                inputState: createInputState(),
+                issuedElementIds: new Set(),
+                lease,
+                previewGeneration: 0,
+                story: null,
+                target,
+                timeouts: {
+                    implicit: 0,
+                    pageLoad: 300_000,
+                    script: 30_000,
+                },
+                windows,
+            };
+            this.sessions.set(session.id, session);
+            this.sessionsByTarget.set(target.id, session.id);
+            return session;
+        }
+        catch (error) {
+            await this.runInputCommand(() => withCommandTimeout((signal) => target.host.releaseActions(signal), 10_000, `Releasing input for target "${target.id}"`)).catch(() => undefined);
+            if (lease) {
+                const failedLease = lease;
+                await withCommandTimeout((signal) => target.host.closeApplication(failedLease, signal), 10_000, `Closing failed target "${target.id}"`).catch(() => undefined);
+            }
+            else if (leasePromise) {
+                releaseReservation = false;
+                void leasePromise
+                    .then(async (lateLease) => {
+                    await this.runInputCommand(() => withCommandTimeout((signal) => target.host.releaseActions(signal), 10_000, `Releasing late input for target "${target.id}"`)).catch(() => undefined);
+                    await withCommandTimeout((signal) => target.host.closeApplication(lateLease, signal), 10_000, `Closing late target "${target.id}"`).catch(() => undefined);
+                })
+                    .catch(() => undefined)
+                    .finally(() => this.reservedTargets.delete(target.id));
+            }
+            throw error;
+        }
+        finally {
+            if (releaseReservation) {
+                this.reservedTargets.delete(target.id);
+            }
+        }
+    }
+    get(id) {
+        const session = this.sessions.get(id);
+        if (!session) {
+            throw new WebDriverError('invalid session id', `Session "${id}" does not exist.`);
+        }
+        return session;
+    }
+    runCommand(sessionId, operation) {
+        const previous = this.commandQueues.get(sessionId) ?? Promise.resolve();
+        const result = previous.catch(() => undefined).then(operation);
+        const tail = result.then(() => undefined, () => undefined);
+        this.commandQueues.set(sessionId, tail);
+        void tail.finally(() => {
+            if (this.commandQueues.get(sessionId) === tail) {
+                this.commandQueues.delete(sessionId);
+            }
+        });
+        return result;
+    }
+    runInputCommand(operation) {
+        const result = this.inputQueue.catch(() => undefined).then(operation);
+        this.inputQueue = result.then(() => undefined, () => undefined);
+        return result;
+    }
+    async delete(id) {
+        const session = this.get(id);
+        this.reservedTargets.add(session.target.id);
+        const failures = [];
+        try {
+            try {
+                await this.runInputCommand(() => withCommandTimeout((signal) => session.target.host.releaseActions(signal), session.desktopTimeouts.nativeCommand, `Releasing input for session "${id}"`));
+            }
+            catch (error) {
+                failures.push(error);
+            }
+            try {
+                await withCommandTimeout((signal) => session.target.host.closeApplication(session.lease, signal), session.desktopTimeouts.nativeCommand, `Closing application for session "${id}"`);
+            }
+            catch (error) {
+                failures.push(error);
+            }
+            if (failures.length === 1) {
+                throw failures[0];
+            }
+            if (failures.length > 1) {
+                throw new AggregateError(failures, `Failed to close session "${id}".`);
+            }
+            this.sessions.delete(id);
+            this.sessionsByTarget.delete(session.target.id);
+        }
+        finally {
+            this.reservedTargets.delete(session.target.id);
+        }
+    }
+    async deleteAll() {
+        const failures = [];
+        for (const id of Array.from(this.sessions.keys())) {
+            try {
+                await this.delete(id);
+            }
+            catch (error) {
+                failures.push(error);
+            }
+        }
+        if (failures.length > 0) {
+            throw new AggregateError(failures, 'One or more desktop sessions failed to close.');
+        }
+    }
+    registerElement(session, snapshot) {
+        const existingId = session.elementIdsByNativeId.get(snapshot.id);
+        if (existingId) {
+            return session.elements.get(existingId);
+        }
+        const record = {
+            id: randomUUID(),
+            nativeId: snapshot.id,
+            previewGeneration: session.previewGeneration,
+            scope: snapshot.scope,
+        };
+        session.elements.set(record.id, record);
+        session.elementIdsByNativeId.set(record.nativeId, record.id);
+        session.issuedElementIds.add(record.id);
+        return record;
+    }
+    resolveElement(session, id) {
+        const element = session.elements.get(id);
+        if (!element) {
+            throw new WebDriverError(session.issuedElementIds.has(id) ? 'stale element reference' : 'no such element', `Element "${id}" is not available in this session.`);
+        }
+        if (element.scope === 'preview' && element.previewGeneration !== session.previewGeneration) {
+            throw new WebDriverError('stale element reference', `Element "${id}" is no longer attached to the current view.`);
+        }
+        return element;
+    }
+    invalidatePreview(session) {
+        session.previewGeneration += 1;
+        for (const [id, element] of session.elements) {
+            if (element.scope === 'preview') {
+                session.elements.delete(id);
+                session.elementIdsByNativeId.delete(element.nativeId);
+            }
+        }
+    }
+}
+//# sourceMappingURL=SessionManager.js.map