mobilewright 0.0.26 → 0.0.28

package/dist/device-pool/application/device-pool.js

@@ -0,0 +1,174 @@
+import { DeviceSlot } from '../domain/device-slot.js';
+import { Allocation } from '../domain/allocation.js';
+import { NoDeviceAvailableError } from './ports.js';
+export class DevicePool {
+    constructor(options) {
+        this.slots = [];
+        this.allocations = new Map();
+        this.waiters = [];
+        this.inFlightWaiters = new Set();
+        this.isShutdown = false;
+        this.allocator = options.allocator;
+        this.maxSlots = options.maxSlots;
+        this.allocationTimeoutMs = options.allocationTimeoutMs ?? 600_000;
+    }
+    allocate(criteria) {
+        if (this.isShutdown) {
+            return Promise.reject(new Error('device pool is shut down'));
+        }
+        return new Promise((resolve, reject) => {
+            this.waiters.push({ criteria, resolve, reject });
+            this.pump();
+        });
+    }
+    async shutdown() {
+        this.isShutdown = true;
+        const drained = this.waiters.splice(0);
+        for (const waiter of drained) {
+            waiter.reject(new Error('device pool shutdown'));
+        }
+        for (const waiter of this.inFlightWaiters) {
+            waiter.reject(new Error('device pool shutdown'));
+        }
+        this.inFlightWaiters.clear();
+        const releases = [];
+        for (const slot of this.slots) {
+            if (slot.state !== 'allocating' && slot.deviceId !== undefined) {
+                releases.push(this.allocator.release(slot.deviceId).catch(() => { }));
+            }
+        }
+        await Promise.all(releases);
+        this.slots.length = 0;
+        this.allocations.clear();
+    }
+    async release(allocationId) {
+        const allocation = this.allocations.get(allocationId);
+        if (!allocation) {
+            return;
+        }
+        this.allocations.delete(allocationId);
+        this.slots[allocation.slotIndex].release();
+        this.pump();
+    }
+    recordAppInstalled(allocationId, bundleId) {
+        const allocation = this.allocations.get(allocationId);
+        if (!allocation) {
+            throw new Error(`unknown allocationId: ${allocationId}`);
+        }
+        this.slots[allocation.slotIndex].recordAppInstalled(bundleId);
+    }
+    isAppInstalled(allocationId, bundleId) {
+        const allocation = this.allocations.get(allocationId);
+        if (!allocation) {
+            throw new Error(`unknown allocationId: ${allocationId}`);
+        }
+        return this.slots[allocation.slotIndex].isAppInstalled(bundleId);
+    }
+    pump() {
+        while (this.waiters.length > 0) {
+            const waiter = this.waiters[0];
+            const slotIndex = this.findFreeSlot(waiter.criteria);
+            if (slotIndex !== -1) {
+                this.waiters.shift();
+                this.grantSlot(slotIndex, waiter);
+                continue;
+            }
+            if (this.slots.length < this.maxSlots) {
+                this.waiters.shift();
+                void this.startAllocationForWaiter(waiter);
+                continue;
+            }
+            return;
+        }
+    }
+    findFreeSlot(criteria) {
+        for (let i = 0; i < this.slots.length; i++) {
+            const slot = this.slots[i];
+            if (slot.state === 'available' && slotMatches(slot, criteria)) {
+                return i;
+            }
+        }
+        return -1;
+    }
+    grantSlot(slotIndex, waiter) {
+        const slot = this.slots[slotIndex];
+        const deviceId = slot.deviceId;
+        const platform = slot.platform;
+        if (deviceId === undefined || platform === undefined) {
+            waiter.reject(new Error('internal: slot missing deviceId/platform'));
+            return;
+        }
+        const allocation = Allocation.create({ deviceId, platform, slotIndex });
+        slot.claim(allocation.allocationId);
+        this.allocations.set(allocation.allocationId, allocation);
+        waiter.resolve({
+            allocationId: allocation.allocationId,
+            deviceId: allocation.deviceId,
+            platform: allocation.platform,
+        });
+    }
+    async startAllocationForWaiter(waiter) {
+        const slot = new DeviceSlot();
+        this.slots.push(slot);
+        const slotIndex = this.slots.length - 1;
+        this.inFlightWaiters.add(waiter);
+        const abortController = new AbortController();
+        const timer = setTimeout(() => abortController.abort(), this.allocationTimeoutMs);
+        let result;
+        try {
+            result = await this.allocator.allocate(waiter.criteria, this.takenDeviceIds(), abortController.signal);
+        }
+        catch (err) {
+            clearTimeout(timer);
+            if (!this.inFlightWaiters.delete(waiter)) {
+                // Shutdown already rejected this waiter.
+                return;
+            }
+            this.slots.splice(slotIndex, 1);
+            if (abortController.signal.aborted) {
+                waiter.reject(new Error(`device allocation timed out after ${this.allocationTimeoutMs}ms`));
+                this.pump();
+                return;
+            }
+            // NoDeviceAvailableError is a temporary condition: all matching devices
+            // are currently taken. Re-queue the waiter so it is served when an
+            // existing slot releases its device.
+            if (err instanceof NoDeviceAvailableError) {
+                this.waiters.push(waiter);
+                // Only pump if a free slot appeared concurrently while we were allocating.
+                const hasFreeSlot = this.findFreeSlot(waiter.criteria) !== -1;
+                if (hasFreeSlot) {
+                    this.pump();
+                }
+                return;
+            }
+            waiter.reject(err);
+            this.pump();
+            return;
+        }
+        clearTimeout(timer);
+        if (!this.inFlightWaiters.delete(waiter)) {
+            // Shutdown already rejected this waiter; just discard the device.
+            this.allocator.release(result.deviceId).catch(() => { });
+            return;
+        }
+        slot.markAvailable(result.deviceId, result.platform);
+        this.waiters.unshift(waiter);
+        this.pump();
+    }
+    takenDeviceIds() {
+        return new Set(this.slots
+            .map((slot) => slot.deviceId)
+            .filter((id) => id !== undefined));
+    }
+}
+function slotMatches(slot, criteria) {
+    if (criteria.platform && slot.platform !== criteria.platform) {
+        return false;
+    }
+    if (criteria.deviceId && slot.deviceId !== criteria.deviceId) {
+        return false;
+    }
+    return true;
+}
+//# sourceMappingURL=device-pool.js.map

package/dist/device-pool/application/device-pool.js.map

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

package/dist/device-pool/application/device-pool.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=device-pool.test.d.ts.map

package/dist/device-pool/application/device-pool.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-pool.test.d.ts","sourceRoot":"","sources":["../../../src/device-pool/application/device-pool.test.ts"],"names":[],"mappings":""}

package/dist/device-pool/application/device-pool.test.js

@@ -0,0 +1,185 @@
+import { test, expect } from '@playwright/test';
+import { DevicePool } from './device-pool.js';
+import { NoDeviceAvailableError } from './ports.js';
+function makeAllocator(devices) {
+    let i = 0;
+    return {
+        async allocate() {
+            if (i >= devices.length) {
+                throw new Error('no more fake devices');
+            }
+            return devices[i++];
+        },
+        async release() { },
+    };
+}
+test('first allocate spins up a slot and returns a handle', async () => {
+    const allocator = makeAllocator([{ deviceId: 'd1', platform: 'ios' }]);
+    const pool = new DevicePool({ allocator, maxSlots: 2 });
+    const handle = await pool.allocate({ platform: 'ios' });
+    expect(handle.deviceId).toBe('d1');
+    expect(handle.platform).toBe('ios');
+    expect(handle.allocationId).toMatch(/^alloc-/);
+});
+test('a released slot is reused by a subsequent allocate', async () => {
+    const allocator = makeAllocator([{ deviceId: 'd1', platform: 'ios' }]);
+    const pool = new DevicePool({ allocator, maxSlots: 2 });
+    const first = await pool.allocate({ platform: 'ios' });
+    await pool.release(first.allocationId);
+    const second = await pool.allocate({ platform: 'ios' });
+    expect(second.deviceId).toBe('d1');
+    expect(second.allocationId).not.toBe(first.allocationId);
+});
+test('a second concurrent allocate when no free slot triggers parallel allocation', async () => {
+    let calls = 0;
+    const allocator = {
+        async allocate() {
+            calls++;
+            return { deviceId: `d${calls}`, platform: 'ios' };
+        },
+        async release() { },
+    };
+    const pool = new DevicePool({ allocator, maxSlots: 2 });
+    const [a, b] = await Promise.all([
+        pool.allocate({ platform: 'ios' }),
+        pool.allocate({ platform: 'ios' }),
+    ]);
+    const ids = [a.deviceId, b.deviceId].sort();
+    expect(ids).toEqual(['d1', 'd2']);
+    expect(calls).toBe(2);
+});
+test('waiter resolves when an existing allocated slot is released', async () => {
+    const allocator = makeAllocator([{ deviceId: 'd1', platform: 'ios' }]);
+    const pool = new DevicePool({ allocator, maxSlots: 1 });
+    const first = await pool.allocate({ platform: 'ios' });
+    let secondHandle;
+    const secondPromise = pool.allocate({ platform: 'ios' }).then((h) => { secondHandle = h; });
+    await Promise.resolve();
+    expect(secondHandle).toBeUndefined();
+    await pool.release(first.allocationId);
+    await secondPromise;
+    expect(secondHandle?.deviceId).toBe('d1');
+});
+test('NoDeviceAvailableError re-queues the waiter to be served on next release', async () => {
+    // Simulates 3 workers competing for 2 devices.
+    // Workers 0 and 1 allocate. Worker 2 gets NoDeviceAvailableError from the
+    // allocator. It should re-queue and be served when worker 0 releases.
+    let counter = 0;
+    const devices = ['sim-a', 'sim-b'];
+    const allocator = {
+        async allocate(_c, takenDeviceIds) {
+            const available = devices.filter(id => !takenDeviceIds.has(id));
+            if (available.length === 0) {
+                throw new NoDeviceAvailableError('no device available');
+            }
+            const deviceId = available[counter++ % available.length];
+            return { deviceId, platform: 'ios' };
+        },
+        async release() { },
+    };
+    const pool = new DevicePool({ allocator, maxSlots: 3 });
+    const w0 = await pool.allocate({ platform: 'ios' });
+    const w1 = await pool.allocate({ platform: 'ios' });
+    // w2 should block because both devices are taken.
+    let w2Handle;
+    const w2Promise = pool.allocate({ platform: 'ios' }).then(h => { w2Handle = h; });
+    await Promise.resolve();
+    expect(w2Handle).toBeUndefined();
+    // Releasing w0 should unblock w2.
+    await pool.release(w0.allocationId);
+    await w2Promise;
+    expect(w2Handle?.deviceId).toBe('sim-a');
+});
+test('allocation failure rejects the requesting waiter and drops the slot', async () => {
+    let attempts = 0;
+    const allocator = {
+        async allocate() {
+            attempts++;
+            if (attempts === 1) {
+                throw new Error('boom');
+            }
+            return { deviceId: `d${attempts}`, platform: 'ios' };
+        },
+        async release() { },
+    };
+    const pool = new DevicePool({ allocator, maxSlots: 2 });
+    await expect(pool.allocate({ platform: 'ios' })).rejects.toThrow('boom');
+    const handle = await pool.allocate({ platform: 'ios' });
+    expect(handle.deviceId).toBe('d2');
+});
+test('FIFO order across multiple waiters', async () => {
+    const allocator = makeAllocator([{ deviceId: 'd1', platform: 'ios' }]);
+    const pool = new DevicePool({ allocator, maxSlots: 1 });
+    const first = await pool.allocate({ platform: 'ios' });
+    const order = [];
+    const w1 = pool.allocate({ platform: 'ios' }).then((h) => order.push(`w1:${h.allocationId}`));
+    const w2 = pool.allocate({ platform: 'ios' }).then((h) => order.push(`w2:${h.allocationId}`));
+    await pool.release(first.allocationId);
+    await w1;
+    const firstWaiterAllocId = order[0].split(':')[1];
+    await pool.release(firstWaiterAllocId);
+    await w2;
+    expect(order.length).toBe(2);
+    expect(order[0]).toMatch(/^w1:/);
+    expect(order[1]).toMatch(/^w2:/);
+});
+test('isAppInstalled is false until recordAppInstalled is called', async () => {
+    const allocator = makeAllocator([{ deviceId: 'd1', platform: 'ios' }]);
+    const pool = new DevicePool({ allocator, maxSlots: 1 });
+    const handle = await pool.allocate({ platform: 'ios' });
+    expect(pool.isAppInstalled(handle.allocationId, 'app.ipa')).toBe(false);
+    pool.recordAppInstalled(handle.allocationId, 'app.ipa');
+    expect(pool.isAppInstalled(handle.allocationId, 'app.ipa')).toBe(true);
+});
+test('install tracking persists across releases of the same slot', async () => {
+    const allocator = makeAllocator([{ deviceId: 'd1', platform: 'ios' }]);
+    const pool = new DevicePool({ allocator, maxSlots: 1 });
+    const first = await pool.allocate({ platform: 'ios' });
+    pool.recordAppInstalled(first.allocationId, 'app.ipa');
+    await pool.release(first.allocationId);
+    const second = await pool.allocate({ platform: 'ios' });
+    expect(pool.isAppInstalled(second.allocationId, 'app.ipa')).toBe(true);
+});
+test('shutdown calls allocator.release for every available slot', async () => {
+    const released = [];
+    let counter = 0;
+    const allocator = {
+        async allocate() {
+            counter++;
+            return { deviceId: `d${counter}`, platform: 'ios' };
+        },
+        async release(deviceId) { released.push(deviceId); },
+    };
+    const pool = new DevicePool({ allocator, maxSlots: 2 });
+    const a = await pool.allocate({ platform: 'ios' });
+    const b = await pool.allocate({ platform: 'ios' });
+    await pool.release(a.allocationId);
+    await pool.shutdown();
+    expect(released.sort()).toEqual([a.deviceId, b.deviceId].sort());
+});
+test('shutdown rejects in-flight waiters', async () => {
+    const allocator = {
+        async allocate() {
+            return new Promise(() => { });
+        },
+        async release() { },
+    };
+    const pool = new DevicePool({ allocator, maxSlots: 1 });
+    const promise = pool.allocate({ platform: 'ios' });
+    await Promise.resolve();
+    await pool.shutdown();
+    await expect(promise).rejects.toThrow(/shutdown/i);
+});
+test('allocation that exceeds allocationTimeoutMs rejects with timeout error', async () => {
+    const allocator = {
+        async allocate(_c, _t, signal) {
+            return new Promise((_, reject) => {
+                signal?.addEventListener('abort', () => reject(new Error('aborted')));
+            });
+        },
+        async release() { },
+    };
+    const pool = new DevicePool({ allocator, maxSlots: 1, allocationTimeoutMs: 50 });
+    await expect(pool.allocate({ platform: 'ios' })).rejects.toThrow(/timed out/i);
+});
+//# sourceMappingURL=device-pool.test.js.map

package/dist/device-pool/application/device-pool.test.js.map

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

package/dist/device-pool/application/ports.d.ts

@@ -0,0 +1,44 @@
+import type { Platform } from '@mobilewright/protocol';
+/**
+ * Thrown by a DeviceAllocator when no device is currently available but one
+ * may become available later (e.g. all matching devices are already taken).
+ * DevicePool treats this as a temporary condition and re-queues the waiter
+ * rather than rejecting it outright.
+ */
+export declare class NoDeviceAvailableError extends Error {
+    constructor(message: string);
+}
+export interface AllocationCriteria {
+    platform?: Platform;
+    /** Serialized regex source — `RegExp.prototype.source`. The allocator reconstructs `new RegExp(...)`. */
+    deviceNamePattern?: string;
+    deviceId?: string;
+}
+export interface AllocateResult {
+    deviceId: string;
+    platform: Platform;
+}
+/**
+ * Driver-specific allocator. Implementations are at the outer adapter layer.
+ * `takenDeviceIds` lets the allocator avoid handing out devices the pool already has.
+ */
+export interface DeviceAllocator {
+    allocate(criteria: AllocationCriteria, takenDeviceIds: ReadonlySet<string>, signal?: AbortSignal): Promise<AllocateResult>;
+    /** Called at pool shutdown for every slot in `available` or `allocated` state. */
+    release(deviceId: string): Promise<void>;
+}
+export interface AllocationHandle {
+    allocationId: string;
+    deviceId: string;
+    platform: Platform;
+}
+/**
+ * Port consumed by the test fixture. The HTTP adapter is one implementation.
+ */
+export interface DevicePoolClient {
+    allocate(criteria: AllocationCriteria): Promise<AllocationHandle>;
+    release(allocationId: string): Promise<void>;
+    isAppInstalled(allocationId: string, bundleId: string): Promise<boolean>;
+    recordAppInstalled(allocationId: string, bundleId: string): Promise<void>;
+}
+//# sourceMappingURL=ports.d.ts.map

package/dist/device-pool/application/ports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../../../src/device-pool/application/ports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD;;;;;GAKG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,yGAAyG;IACzG,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CACN,QAAQ,EAAE,kBAAkB,EAC5B,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,EACnC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,cAAc,CAAC,CAAC;IAE3B,kFAAkF;IAClF,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAClE,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzE,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3E"}

package/dist/device-pool/application/ports.js

@@ -0,0 +1,13 @@
+/**
+ * Thrown by a DeviceAllocator when no device is currently available but one
+ * may become available later (e.g. all matching devices are already taken).
+ * DevicePool treats this as a temporary condition and re-queues the waiter
+ * rather than rejecting it outright.
+ */
+export class NoDeviceAvailableError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'NoDeviceAvailableError';
+    }
+}
+//# sourceMappingURL=ports.js.map

package/dist/device-pool/application/ports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.js","sourceRoot":"","sources":["../../../src/device-pool/application/ports.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC/C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF"}

package/dist/device-pool/client-factory.d.ts

@@ -0,0 +1,8 @@
+import type { DevicePoolClient } from './application/ports.js';
+export declare const COORDINATOR_URL_ENV = "MOBILEWRIGHT_COORDINATOR_URL";
+/**
+ * Internal factory used by the test fixture. Throws if the coordinator was
+ * not started (i.e. the user bypassed `defineConfig`).
+ */
+export declare function createDevicePoolClient(): DevicePoolClient;
+//# sourceMappingURL=client-factory.d.ts.map

package/dist/device-pool/client-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-factory.d.ts","sourceRoot":"","sources":["../../src/device-pool/client-factory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,eAAO,MAAM,mBAAmB,iCAAiC,CAAC;AAElE;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,CAUzD"}

package/dist/device-pool/client-factory.js

@@ -0,0 +1,16 @@
+import { HttpDevicePoolClient } from './adapters/http-client.js';
+export const COORDINATOR_URL_ENV = 'MOBILEWRIGHT_COORDINATOR_URL';
+/**
+ * Internal factory used by the test fixture. Throws if the coordinator was
+ * not started (i.e. the user bypassed `defineConfig`).
+ */
+export function createDevicePoolClient() {
+    const baseUrl = process.env[COORDINATOR_URL_ENV];
+    if (!baseUrl) {
+        throw new Error(`${COORDINATOR_URL_ENV} is not set. ` +
+            'Did you use defineConfig() in your mobilewright.config.ts? ' +
+            'It auto-injects the device-pool coordinator.');
+    }
+    return new HttpDevicePoolClient({ baseUrl });
+}
+//# sourceMappingURL=client-factory.js.map

package/dist/device-pool/client-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-factory.js","sourceRoot":"","sources":["../../src/device-pool/client-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAGjE,MAAM,CAAC,MAAM,mBAAmB,GAAG,8BAA8B,CAAC;AAElE;;;GAGG;AACH,MAAM,UAAU,sBAAsB;IACpC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IACjD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,GAAG,mBAAmB,eAAe;YACrC,6DAA6D;YAC7D,8CAA8C,CAC/C,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,oBAAoB,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;AAC/C,CAAC"}

package/dist/device-pool/domain/allocation.d.ts

@@ -0,0 +1,21 @@
+import type { Platform } from '@mobilewright/protocol';
+export interface AllocationParams {
+    allocationId: string;
+    deviceId: string;
+    platform: Platform;
+    slotIndex: number;
+}
+export interface AllocationCreateParams {
+    deviceId: string;
+    platform: Platform;
+    slotIndex: number;
+}
+export declare class Allocation {
+    readonly allocationId: string;
+    readonly deviceId: string;
+    readonly platform: Platform;
+    readonly slotIndex: number;
+    constructor(params: AllocationParams);
+    static create(params: AllocationCreateParams): Allocation;
+}
+//# sourceMappingURL=allocation.d.ts.map

package/dist/device-pool/domain/allocation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"allocation.d.ts","sourceRoot":"","sources":["../../../src/device-pool/domain/allocation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,UAAU;IACrB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,MAAM,EAAE,gBAAgB;IAOpC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,sBAAsB,GAAG,UAAU;CAI1D"}

package/dist/device-pool/domain/allocation.js

@@ -0,0 +1,14 @@
+import { randomBytes } from 'node:crypto';
+export class Allocation {
+    constructor(params) {
+        this.allocationId = params.allocationId;
+        this.deviceId = params.deviceId;
+        this.platform = params.platform;
+        this.slotIndex = params.slotIndex;
+    }
+    static create(params) {
+        const id = `alloc-${randomBytes(8).toString('hex')}`;
+        return new Allocation({ allocationId: id, ...params });
+    }
+}
+//# sourceMappingURL=allocation.js.map

package/dist/device-pool/domain/allocation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"allocation.js","sourceRoot":"","sources":["../../../src/device-pool/domain/allocation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAgB1C,MAAM,OAAO,UAAU;IAMrB,YAAY,MAAwB;QAClC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;QACxC,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAChC,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAChC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;IACpC,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,MAA8B;QAC1C,MAAM,EAAE,GAAG,SAAS,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrD,OAAO,IAAI,UAAU,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IACzD,CAAC;CACF"}

package/dist/device-pool/domain/allocation.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=allocation.test.d.ts.map

package/dist/device-pool/domain/allocation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"allocation.test.d.ts","sourceRoot":"","sources":["../../../src/device-pool/domain/allocation.test.ts"],"names":[],"mappings":""}

package/dist/device-pool/domain/allocation.test.js

@@ -0,0 +1,21 @@
+import { test, expect } from '@playwright/test';
+import { Allocation } from './allocation.js';
+test('Allocation carries id, deviceId, platform, and slotIndex', () => {
+    const allocation = new Allocation({
+        allocationId: 'alloc-1',
+        deviceId: 'device-1',
+        platform: 'ios',
+        slotIndex: 3,
+    });
+    expect(allocation.allocationId).toBe('alloc-1');
+    expect(allocation.deviceId).toBe('device-1');
+    expect(allocation.platform).toBe('ios');
+    expect(allocation.slotIndex).toBe(3);
+});
+test('Allocation generates a fresh id when one is not provided', () => {
+    const a = Allocation.create({ deviceId: 'd', platform: 'ios', slotIndex: 0 });
+    const b = Allocation.create({ deviceId: 'd', platform: 'ios', slotIndex: 0 });
+    expect(a.allocationId).toMatch(/^alloc-/);
+    expect(a.allocationId).not.toBe(b.allocationId);
+});
+//# sourceMappingURL=allocation.test.js.map

package/dist/device-pool/domain/allocation.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"allocation.test.js","sourceRoot":"","sources":["../../../src/device-pool/domain/allocation.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,IAAI,CAAC,0DAA0D,EAAE,GAAG,EAAE;IACpE,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC;QAChC,YAAY,EAAE,SAAS;QACvB,QAAQ,EAAE,UAAU;QACpB,QAAQ,EAAE,KAAK;QACf,SAAS,EAAE,CAAC;KACb,CAAC,CAAC;IAEH,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAChD,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC7C,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACvC,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,0DAA0D,EAAE,GAAG,EAAE;IACpE,MAAM,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;IAC9E,MAAM,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;IAC9E,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC1C,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;AAClD,CAAC,CAAC,CAAC"}

package/dist/device-pool/domain/device-slot.d.ts

@@ -0,0 +1,22 @@
+import type { Platform } from '@mobilewright/protocol';
+export type DeviceSlotState = 'allocating' | 'available' | 'allocated';
+export declare class DeviceSlotStateError extends Error {
+    constructor(message: string);
+}
+export declare class DeviceSlot {
+    private _state;
+    private _deviceId?;
+    private _platform?;
+    private _allocationId?;
+    private readonly _installedApps;
+    get state(): DeviceSlotState;
+    get deviceId(): string | undefined;
+    get platform(): Platform | undefined;
+    get allocationId(): string | undefined;
+    markAvailable(deviceId: string, platform: Platform): void;
+    claim(allocationId: string): void;
+    release(): void;
+    recordAppInstalled(bundleId: string): void;
+    isAppInstalled(bundleId: string): boolean;
+}
+//# sourceMappingURL=device-slot.d.ts.map

package/dist/device-pool/domain/device-slot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-slot.d.ts","sourceRoot":"","sources":["../../../src/device-pool/domain/device-slot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,WAAW,GAAG,WAAW,CAAC;AAEvE,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAC,CAAW;IAC7B,OAAO,CAAC,aAAa,CAAC,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;IAEpD,IAAI,KAAK,IAAI,eAAe,CAE3B;IAED,IAAI,QAAQ,IAAI,MAAM,GAAG,SAAS,CAEjC;IAED,IAAI,QAAQ,IAAI,QAAQ,GAAG,SAAS,CAEnC;IAED,IAAI,YAAY,IAAI,MAAM,GAAG,SAAS,CAErC;IAED,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAWzD,KAAK,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAUjC,OAAO,IAAI,IAAI;IAUf,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI1C,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAG1C"}