@appium/coresim 1.0.0

package/lib/src/commands/darwin-notification.d.ts

@@ -0,0 +1,36 @@
+import type { NativeSimctl } from '../native-simctl.js';
+declare module '../native-simctl.js' {
+    interface NativeSimctl {
+        getDarwinNotificationState(udid: string, name: string): Promise<bigint>;
+        setDarwinNotificationState(udid: string, name: string, state: bigint): Promise<void>;
+        postDarwinNotification(udid: string, name: string): Promise<void>;
+    }
+}
+/**
+ * The "state" here is Darwin's low-level `notify(3)` per-name state value (`notify_get_state`) —
+ * a full 64-bit integer any process can attach to a notification name independently of posting
+ * it, so a reader can check the last-set value without having been listening at post time.
+ * Returned as `bigint`, not `number` — a JS `number` only has 53 bits of safe integer precision,
+ * not enough for an arbitrary 64-bit counter or bit field another process may have stored.
+ *
+ * @see https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man3/notify.3.html
+ * @param udid — UDID of the device to read from
+ * @param name — Darwin notification name
+ * @returns the last-set state value for that notification (`0n` if never set)
+ */
+export declare function getDarwinNotificationState(this: NativeSimctl, udid: string, name: string): Promise<bigint>;
+/**
+ * Sets the state value of a Darwin notification on the given device, without posting it (see
+ * {@link getDarwinNotificationState} for what "state" means here — `notify(3)`'s `notify_set_state`).
+ *
+ * @param udid — UDID of the target device
+ * @param name — Darwin notification name
+ * @param state — state value to store; must fit in an unsigned 64-bit integer (`0n` to `2n**64n-1n`)
+ */
+export declare function setDarwinNotificationState(this: NativeSimctl, udid: string, name: string, state: bigint): Promise<void>;
+/**
+ * @param udid — UDID of the target device
+ * @param name — Darwin notification name to post
+ */
+export declare function postDarwinNotification(this: NativeSimctl, udid: string, name: string): Promise<void>;
+//# sourceMappingURL=darwin-notification.d.ts.map

package/lib/src/commands/darwin-notification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"darwin-notification.d.ts","sourceRoot":"","sources":["../../../src/commands/darwin-notification.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,qBAAqB,CAAC;AAGtD,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,YAAY;QACpB,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QACxE,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QACrF,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACnE;CACF;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,0BAA0B,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEhH;AAED;;;;;;;GAOG;AACH,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1G"}

package/lib/src/commands/darwin-notification.js

@@ -0,0 +1,35 @@
+import { runCatchingAsync } from '../utils/index.js';
+/**
+ * The "state" here is Darwin's low-level `notify(3)` per-name state value (`notify_get_state`) —
+ * a full 64-bit integer any process can attach to a notification name independently of posting
+ * it, so a reader can check the last-set value without having been listening at post time.
+ * Returned as `bigint`, not `number` — a JS `number` only has 53 bits of safe integer precision,
+ * not enough for an arbitrary 64-bit counter or bit field another process may have stored.
+ *
+ * @see https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man3/notify.3.html
+ * @param udid — UDID of the device to read from
+ * @param name — Darwin notification name
+ * @returns the last-set state value for that notification (`0n` if never set)
+ */
+export async function getDarwinNotificationState(udid, name) {
+    return runCatchingAsync(async () => (await this._findDevice(udid)).darwinNotificationGetState(name));
+}
+/**
+ * Sets the state value of a Darwin notification on the given device, without posting it (see
+ * {@link getDarwinNotificationState} for what "state" means here — `notify(3)`'s `notify_set_state`).
+ *
+ * @param udid — UDID of the target device
+ * @param name — Darwin notification name
+ * @param state — state value to store; must fit in an unsigned 64-bit integer (`0n` to `2n**64n-1n`)
+ */
+export async function setDarwinNotificationState(udid, name, state) {
+    return runCatchingAsync(async () => (await this._findDevice(udid)).darwinNotificationSetState(name, state));
+}
+/**
+ * @param udid — UDID of the target device
+ * @param name — Darwin notification name to post
+ */
+export async function postDarwinNotification(udid, name) {
+    return runCatchingAsync(async () => (await this._findDevice(udid)).postDarwinNotification(name));
+}
+//# sourceMappingURL=darwin-notification.js.map

package/lib/src/commands/darwin-notification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"darwin-notification.js","sourceRoot":"","sources":["../../../src/commands/darwin-notification.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,gBAAgB,EAAC,MAAM,mBAAmB,CAAC;AAUnD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAqB,IAAY,EAAE,IAAY;IAC7F,OAAO,gBAAgB,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,0BAA0B,CAAC,IAAI,CAAC,CAAC,CAAC;AACvG,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAE9C,IAAY,EACZ,IAAY,EACZ,KAAa;IAEb,OAAO,gBAAgB,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,0BAA0B,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;AAC9G,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAqB,IAAY,EAAE,IAAY;IACzF,OAAO,gBAAgB,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC;AACnG,CAAC"}

package/lib/src/commands/interaction.d.ts

@@ -0,0 +1,48 @@
+import type { NativeSimctl } from '../native-simctl.js';
+import type { PushNotificationPayload } from '../types.js';
+declare module '../native-simctl.js' {
+    interface NativeSimctl {
+        getEnv(udid: string, name: string): Promise<string>;
+        openUrl(udid: string, url: string): Promise<void>;
+        setLocation(udid: string, latitude: number, longitude: number): Promise<void>;
+        clearLocation(udid: string): Promise<void>;
+        pushNotification(udid: string, bundleId: string, payload: PushNotificationPayload): Promise<void>;
+    }
+}
+/**
+ * @param udid — UDID of the (booted) device to read from
+ * @param name — environment variable name
+ * @returns the variable's value
+ */
+export declare function getEnv(this: NativeSimctl, udid: string, name: string): Promise<string>;
+/**
+ * Opens a URL on the given device; iOS resolves the app matching the URL's scheme.
+ *
+ * @param udid — UDID of the target device
+ * @param url — the URL to open, e.g. `https://appium.io`
+ */
+export declare function openUrl(this: NativeSimctl, udid: string, url: string): Promise<void>;
+/**
+ * Sets the given device's simulated GPS location.
+ *
+ * @param udid — UDID of the target device
+ * @param latitude — location latitude
+ * @param longitude — location longitude
+ */
+export declare function setLocation(this: NativeSimctl, udid: string, latitude: number, longitude: number): Promise<void>;
+/**
+ * Stops simulating a GPS location previously set via {@link setLocation}, reverting the device to
+ * its default (no simulated location) behavior.
+ *
+ * @param udid — UDID of the target device
+ */
+export declare function clearLocation(this: NativeSimctl, udid: string): Promise<void>;
+/**
+ * Delivers a simulated push notification to the given device.
+ *
+ * @param udid — UDID of the target device
+ * @param bundleId — bundle identifier of the app to receive the notification
+ * @param payload — see {@link PushNotificationPayload}
+ */
+export declare function pushNotification(this: NativeSimctl, udid: string, bundleId: string, payload: PushNotificationPayload): Promise<void>;
+//# sourceMappingURL=interaction.d.ts.map

package/lib/src/commands/interaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction.d.ts","sourceRoot":"","sources":["../../../src/commands/interaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAC,uBAAuB,EAAC,MAAM,aAAa,CAAC;AAGzD,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,YAAY;QACpB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QACpD,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAClD,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC9E,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3C,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACnG;CACF;AAED;;;;GAIG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE5F;AAED;;;;;GAKG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1F;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnF;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/lib/src/commands/interaction.js

@@ -0,0 +1,48 @@
+import { runCatchingAsync } from '../utils/index.js';
+/**
+ * @param udid — UDID of the (booted) device to read from
+ * @param name — environment variable name
+ * @returns the variable's value
+ */
+export async function getEnv(udid, name) {
+    return runCatchingAsync(async () => (await this._findDevice(udid)).getenv(name));
+}
+/**
+ * Opens a URL on the given device; iOS resolves the app matching the URL's scheme.
+ *
+ * @param udid — UDID of the target device
+ * @param url — the URL to open, e.g. `https://appium.io`
+ */
+export async function openUrl(udid, url) {
+    return runCatchingAsync(async () => (await this._findDevice(udid)).openUrl(url));
+}
+/**
+ * Sets the given device's simulated GPS location.
+ *
+ * @param udid — UDID of the target device
+ * @param latitude — location latitude
+ * @param longitude — location longitude
+ */
+export async function setLocation(udid, latitude, longitude) {
+    return runCatchingAsync(async () => (await this._findDevice(udid)).setLocation(latitude, longitude));
+}
+/**
+ * Stops simulating a GPS location previously set via {@link setLocation}, reverting the device to
+ * its default (no simulated location) behavior.
+ *
+ * @param udid — UDID of the target device
+ */
+export async function clearLocation(udid) {
+    return runCatchingAsync(async () => (await this._findDevice(udid)).clearLocation());
+}
+/**
+ * Delivers a simulated push notification to the given device.
+ *
+ * @param udid — UDID of the target device
+ * @param bundleId — bundle identifier of the app to receive the notification
+ * @param payload — see {@link PushNotificationPayload}
+ */
+export async function pushNotification(udid, bundleId, payload) {
+    return runCatchingAsync(async () => (await this._findDevice(udid)).sendPushNotification(bundleId, payload));
+}
+//# sourceMappingURL=interaction.js.map

package/lib/src/commands/interaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction.js","sourceRoot":"","sources":["../../../src/commands/interaction.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,gBAAgB,EAAC,MAAM,mBAAmB,CAAC;AAYnD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAqB,IAAY,EAAE,IAAY;IACzE,OAAO,gBAAgB,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;AACnF,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAqB,IAAY,EAAE,GAAW;IACzE,OAAO,gBAAgB,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;AACnF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAE/B,IAAY,EACZ,QAAgB,EAChB,SAAiB;IAEjB,OAAO,gBAAgB,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;AACvG,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAqB,IAAY;IAClE,OAAO,gBAAgB,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC;AACtF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAEpC,IAAY,EACZ,QAAgB,EAChB,OAAgC;IAEhC,OAAO,gBAAgB,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,oBAAoB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;AAC9G,CAAC"}

package/lib/src/commands/keychain.d.ts

@@ -0,0 +1,25 @@
+import type { NativeSimctl } from '../native-simctl.js';
+declare module '../native-simctl.js' {
+    interface NativeSimctl {
+        addCertificate(udid: string, cert: string | Buffer): Promise<void>;
+        addRootCertificate(udid: string, cert: string | Buffer): Promise<void>;
+        resetKeychain(udid: string): Promise<void>;
+    }
+}
+/**
+ * Adds a certificate to the given device's keychain (not trusted as root).
+ *
+ * @param udid — UDID of the target device
+ * @param cert — path to a `.cert`/`.pem` file on disk, or the raw certificate content
+ */
+export declare function addCertificate(this: NativeSimctl, udid: string, cert: string | Buffer): Promise<void>;
+/**
+ * Adds a certificate to the given device's Trusted Root Store.
+ *
+ * @param udid — UDID of the target device
+ * @param cert — path to a `.cert`/`.pem` file on disk, or the raw certificate content
+ */
+export declare function addRootCertificate(this: NativeSimctl, udid: string, cert: string | Buffer): Promise<void>;
+/** @param udid — UDID of the device whose keychain should be reset */
+export declare function resetKeychain(this: NativeSimctl, udid: string): Promise<void>;
+//# sourceMappingURL=keychain.d.ts.map

package/lib/src/commands/keychain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keychain.d.ts","sourceRoot":"","sources":["../../../src/commands/keychain.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,qBAAqB,CAAC;AAGtD,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,YAAY;QACpB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QACnE,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QACvE,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAC5C;CACF;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAO3G;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAO/G;AAED,sEAAsE;AACtE,wBAAsB,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnF"}

package/lib/src/commands/keychain.js

@@ -0,0 +1,52 @@
+import { randomUUID } from 'node:crypto';
+import { rm, writeFile } from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { runCatchingAsync } from '../utils/index.js';
+/**
+ * Adds a certificate to the given device's keychain (not trusted as root).
+ *
+ * @param udid — UDID of the target device
+ * @param cert — path to a `.cert`/`.pem` file on disk, or the raw certificate content
+ */
+export async function addCertificate(udid, cert) {
+    const { path: certPath, cleanup } = await resolveCertPath(cert);
+    try {
+        return await runCatchingAsync(async () => (await this._findDevice(udid)).addCertificate(certPath, false));
+    }
+    finally {
+        await cleanup();
+    }
+}
+/**
+ * Adds a certificate to the given device's Trusted Root Store.
+ *
+ * @param udid — UDID of the target device
+ * @param cert — path to a `.cert`/`.pem` file on disk, or the raw certificate content
+ */
+export async function addRootCertificate(udid, cert) {
+    const { path: certPath, cleanup } = await resolveCertPath(cert);
+    try {
+        return await runCatchingAsync(async () => (await this._findDevice(udid)).addCertificate(certPath, true));
+    }
+    finally {
+        await cleanup();
+    }
+}
+/** @param udid — UDID of the device whose keychain should be reset */
+export async function resetKeychain(udid) {
+    return runCatchingAsync(async () => (await this._findDevice(udid)).resetKeychain());
+}
+/**
+ * The native call only accepts a file path — a `Buffer` is written to a throwaway temp file first,
+ * cleaned up by the caller once done.
+ */
+async function resolveCertPath(cert) {
+    if (typeof cert === 'string') {
+        return { path: cert, cleanup: async () => { } };
+    }
+    const tmpPath = path.join(os.tmpdir(), `${randomUUID()}.pem`);
+    await writeFile(tmpPath, cert);
+    return { path: tmpPath, cleanup: () => rm(tmpPath, { force: true }) };
+}
+//# sourceMappingURL=keychain.js.map

package/lib/src/commands/keychain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keychain.js","sourceRoot":"","sources":["../../../src/commands/keychain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,aAAa,CAAC;AACvC,OAAO,EAAC,EAAE,EAAE,SAAS,EAAC,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAC,gBAAgB,EAAC,MAAM,mBAAmB,CAAC;AAUnD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAqB,IAAY,EAAE,IAAqB;IAC1F,MAAM,EAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAC,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;IAC9D,IAAI,CAAC;QACH,OAAO,MAAM,gBAAgB,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;IAC5G,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,EAAE,CAAC;IAClB,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAqB,IAAY,EAAE,IAAqB;IAC9F,MAAM,EAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAC,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;IAC9D,IAAI,CAAC;QACH,OAAO,MAAM,gBAAgB,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;IAC3G,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,EAAE,CAAC;IAClB,CAAC;AACH,CAAC;AAED,sEAAsE;AACtE,MAAM,CAAC,KAAK,UAAU,aAAa,CAAqB,IAAY;IAClE,OAAO,gBAAgB,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC;AACtF,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,eAAe,CAAC,IAAqB;IAClD,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,EAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC,EAAC,CAAC;IAC/C,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,GAAG,UAAU,EAAE,MAAM,CAAC,CAAC;IAC9D,MAAM,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC/B,OAAO,EAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,EAAC,KAAK,EAAE,IAAI,EAAC,CAAC,EAAC,CAAC;AACpE,CAAC"}

package/lib/src/commands/lifecycle.d.ts

@@ -0,0 +1,101 @@
+import type { NativeSimctl } from '../native-simctl.js';
+import { type SimBootInfo, type SimDeviceInfo } from '../types.js';
+import type { SimDeviceTypeInfo, SimRuntimeInfo } from '../types.js';
+declare module '../native-simctl.js' {
+    interface NativeSimctl {
+        getDevices(): Promise<SimDeviceInfo[]>;
+        getSupportedDeviceTypes(): Promise<SimDeviceTypeInfo[]>;
+        getSupportedRuntimes(): Promise<SimRuntimeInfo[]>;
+        createDevice(name: string, deviceTypeIdentifier: string, runtimeIdentifier: string): Promise<SimDeviceInfo>;
+        deleteDevice(udid: string): Promise<void>;
+        bootDevice(udid: string, options?: Record<string, unknown>): Promise<void>;
+        getBootStatus(udid: string): Promise<SimBootInfo | null>;
+        waitForBoot(udid: string, options?: {
+            timeoutMs?: number;
+        }): Promise<void>;
+        shutdownDevice(udid: string): Promise<void>;
+        shutdownAllDevices(): Promise<void>;
+        eraseDevice(udid: string): Promise<void>;
+    }
+}
+/** @returns every device in the default device set. */
+export declare function getDevices(this: NativeSimctl): Promise<SimDeviceInfo[]>;
+/** @returns every simulator device type this CoreSimulator install supports (e.g. "iPhone 15"). */
+export declare function getSupportedDeviceTypes(this: NativeSimctl): Promise<SimDeviceTypeInfo[]>;
+/** @returns every simulator runtime this CoreSimulator install supports (e.g. iOS 17.4). */
+export declare function getSupportedRuntimes(this: NativeSimctl): Promise<SimRuntimeInfo[]>;
+/**
+ * Creates a new device in the default device set. Settles into the `Shutdown` state — never
+ * observed as `Creating` (see CLAUDE.md).
+ *
+ * @param name — display name for the new device
+ * @param deviceTypeIdentifier — e.g. `com.apple.CoreSimulator.SimDeviceType.iPhone-15`
+ * @param runtimeIdentifier — e.g. `com.apple.CoreSimulator.SimRuntime.iOS-17-4`
+ * @returns the newly created device
+ */
+export declare function createDevice(this: NativeSimctl, name: string, deviceTypeIdentifier: string, runtimeIdentifier: string): Promise<SimDeviceInfo>;
+/**
+ * Deletes the given device from the default device set. Returns before the underlying
+ * filesystem cleanup finishes — eventually consistent (see CLAUDE.md).
+ *
+ * @param udid — UDID of the device to delete
+ */
+export declare function deleteDevice(this: NativeSimctl, udid: string): Promise<void>;
+/**
+ * Boots the given device; resolves only once CoreSimulator's own async completion handler
+ * fires (see CLAUDE.md for a rare eventual-consistency caveat on the resulting `state`).
+ *
+ * @param udid — UDID of the device to boot
+ * @param options — passed through to `bootWithOptions:`/`bootAsyncWithOptions:...:`; the
+ * option-dictionary keys are currently unverified (see CLAUDE.md)
+ */
+export declare function bootDevice(this: NativeSimctl, udid: string, options?: Record<string, unknown>): Promise<void>;
+/**
+ * Reads the device's current boot-progress status — the same underlying signal `simctl bootstatus`
+ * itself monitors (see CLAUDE.md), distinct from and more granular than `SimDeviceState`.
+ *
+ * @param udid — UDID of the device to read from
+ * @returns `null` if the device has never been booted; otherwise its most recent {@link SimBootInfo}.
+ * Confirmed empirically to **not** reset after shutdown — a shut-down device that was booted
+ * before still reports its last boot's terminal status, so check `getDevices()`'s `state` too if
+ * you need to know whether the device is *currently* booted (see {@link waitForBoot}, which does).
+ */
+export declare function getBootStatus(this: NativeSimctl, udid: string): Promise<SimBootInfo | null>;
+/**
+ * Waits for the given device's boot to fully settle — matching `simctl bootstatus`'s own notion of
+ * "done" (`SimBootInfo.isTerminal`), not just `SimDeviceState` reaching `Booted`, which happens
+ * *tens of seconds* earlier while data migration/system-app startup are still in progress (see
+ * CLAUDE.md). Returns immediately if the device is already fully booted (its very first status
+ * check already sees `isTerminal`).
+ *
+ * @param udid — UDID of the device to monitor
+ * @param options.timeoutMs — how long to wait before giving up (default 4 minutes, matching
+ * `simctl bootstatus`'s own default timeout)
+ * @throws if the device isn't currently `Booting` or `Booted` — there's nothing to monitor
+ * @throws if the device stops booting (e.g. is shut down) before it finishes
+ * @throws if `timeoutMs` elapses before boot settles
+ */
+export declare function waitForBoot(this: NativeSimctl, udid: string, options?: {
+    timeoutMs?: number;
+}): Promise<void>;
+/**
+ * @param udid — UDID of the device to shut down
+ * @throws if the device is already `Shutdown` — this is not an idempotent no-op
+ */
+export declare function shutdownDevice(this: NativeSimctl, udid: string): Promise<void>;
+/**
+ * Best-effort shutdown of every device in the default device set that isn't already `Shutdown` —
+ * the native equivalent of `xcrun simctl shutdown all`. A fan-out over {@link shutdownDevice}
+ * rather than `SimDeviceSet`'s own bulk method, whose completion-block signature couldn't be
+ * confirmed safely (see commit message). Per-device failures are swallowed.
+ */
+export declare function shutdownAllDevices(this: NativeSimctl): Promise<void>;
+/**
+ * Resets the given device's content and settings. Requires it to already be `Shutdown` — call
+ * {@link shutdownDevice} first if it's booted (see CLAUDE.md).
+ *
+ * @param udid — UDID of the device to erase
+ * @throws if the device isn't currently `Shutdown`
+ */
+export declare function eraseDevice(this: NativeSimctl, udid: string): Promise<void>;
+//# sourceMappingURL=lifecycle.d.ts.map

package/lib/src/commands/lifecycle.d.ts.map

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

package/lib/src/commands/lifecycle.js

@@ -0,0 +1,165 @@
+import { waitForCondition } from 'asyncbox';
+import { SimDeviceState } from '../types.js';
+import { runCatchingAsync } from '../utils/index.js';
+const DEFAULT_BOOT_TIMEOUT_MS = 240_000;
+/** @returns every device in the default device set. */
+export async function getDevices() {
+    return runCatchingAsync(async () => {
+        const deviceSet = await this._deviceSet();
+        return (await deviceSet.devices()).map(toDeviceInfo);
+    });
+}
+/** @returns every simulator device type this CoreSimulator install supports (e.g. "iPhone 15"). */
+export async function getSupportedDeviceTypes() {
+    return runCatchingAsync(async () => (await this._serviceContext()).supportedDeviceTypes());
+}
+/** @returns every simulator runtime this CoreSimulator install supports (e.g. iOS 17.4). */
+export async function getSupportedRuntimes() {
+    return runCatchingAsync(async () => (await this._serviceContext()).supportedRuntimes());
+}
+/**
+ * Creates a new device in the default device set. Settles into the `Shutdown` state — never
+ * observed as `Creating` (see CLAUDE.md).
+ *
+ * @param name — display name for the new device
+ * @param deviceTypeIdentifier — e.g. `com.apple.CoreSimulator.SimDeviceType.iPhone-15`
+ * @param runtimeIdentifier — e.g. `com.apple.CoreSimulator.SimRuntime.iOS-17-4`
+ * @returns the newly created device
+ */
+export async function createDevice(name, deviceTypeIdentifier, runtimeIdentifier) {
+    return runCatchingAsync(async () => {
+        const deviceSet = await this._deviceSet();
+        return toDeviceInfo(await deviceSet.createDevice(deviceTypeIdentifier, runtimeIdentifier, name));
+    });
+}
+/**
+ * Deletes the given device from the default device set. Returns before the underlying
+ * filesystem cleanup finishes — eventually consistent (see CLAUDE.md).
+ *
+ * @param udid — UDID of the device to delete
+ */
+export async function deleteDevice(udid) {
+    return runCatchingAsync(async () => {
+        const [deviceSet, device] = await Promise.all([this._deviceSet(), this._findDevice(udid)]);
+        await deviceSet.deleteDevice(device);
+    });
+}
+/**
+ * Boots the given device; resolves only once CoreSimulator's own async completion handler
+ * fires (see CLAUDE.md for a rare eventual-consistency caveat on the resulting `state`).
+ *
+ * @param udid — UDID of the device to boot
+ * @param options — passed through to `bootWithOptions:`/`bootAsyncWithOptions:...:`; the
+ * option-dictionary keys are currently unverified (see CLAUDE.md)
+ */
+export async function bootDevice(udid, options = {}) {
+    return runCatchingAsync(async () => (await this._findDevice(udid)).boot(options));
+}
+/**
+ * Reads the device's current boot-progress status — the same underlying signal `simctl bootstatus`
+ * itself monitors (see CLAUDE.md), distinct from and more granular than `SimDeviceState`.
+ *
+ * @param udid — UDID of the device to read from
+ * @returns `null` if the device has never been booted; otherwise its most recent {@link SimBootInfo}.
+ * Confirmed empirically to **not** reset after shutdown — a shut-down device that was booted
+ * before still reports its last boot's terminal status, so check `getDevices()`'s `state` too if
+ * you need to know whether the device is *currently* booted (see {@link waitForBoot}, which does).
+ */
+export async function getBootStatus(udid) {
+    return runCatchingAsync(async () => (await this._findDevice(udid)).getBootStatus());
+}
+/**
+ * Waits for the given device's boot to fully settle — matching `simctl bootstatus`'s own notion of
+ * "done" (`SimBootInfo.isTerminal`), not just `SimDeviceState` reaching `Booted`, which happens
+ * *tens of seconds* earlier while data migration/system-app startup are still in progress (see
+ * CLAUDE.md). Returns immediately if the device is already fully booted (its very first status
+ * check already sees `isTerminal`).
+ *
+ * @param udid — UDID of the device to monitor
+ * @param options.timeoutMs — how long to wait before giving up (default 4 minutes, matching
+ * `simctl bootstatus`'s own default timeout)
+ * @throws if the device isn't currently `Booting` or `Booted` — there's nothing to monitor
+ * @throws if the device stops booting (e.g. is shut down) before it finishes
+ * @throws if `timeoutMs` elapses before boot settles
+ */
+export async function waitForBoot(udid, options = {}) {
+    const { timeoutMs = DEFAULT_BOOT_TIMEOUT_MS } = options;
+    return runCatchingAsync(async () => {
+        const initialState = (await this._findDevice(udid)).state();
+        if (initialState !== SimDeviceState.Booting && initialState !== SimDeviceState.Booted) {
+            throw new Error(`Device '${udid}' is not booting or booted (state: ${initialState})`);
+        }
+        // Re-resolves the device handle on every check (never caches it across the wait), matching
+        // every other method here — a device deleted mid-wait then surfaces as a normal "not found"
+        // error instead of a stale native reference failing in some less obvious way.
+        await waitForCondition(async () => {
+            const device = await this._findDevice(udid);
+            const stateBefore = device.state();
+            if (stateBefore !== SimDeviceState.Booting && stateBefore !== SimDeviceState.Booted) {
+                // getBootStatus()'s isTerminal is confirmed to never reset on shutdown, so it would
+                // still read true from a *previous* boot session here if the device stopped booting
+                // partway through this wait (e.g. shut down by another caller) — checking current state
+                // too prevents reporting that stale old boot as this wait having succeeded.
+                throw new Error(`Device '${udid}' stopped booting before it finished (state: ${stateBefore})`);
+            }
+            const bootInfo = await device.getBootStatus();
+            // getBootStatus() is itself an async native call — the device can stop booting while it's
+            // in flight, which would otherwise let a stale isTerminal from the check above pass this
+            // predicate. Rechecking afterward, and requiring Booted specifically (not just Booting):
+            // isTerminal only ever turns true once state has already reached Booted (see CLAUDE.md —
+            // SimDeviceState reaches Booted well before boot info settles), so Booting + isTerminal can
+            // only mean a stale status from a previous boot session, never real completion.
+            const stateAfter = device.state();
+            if (stateAfter !== SimDeviceState.Booting && stateAfter !== SimDeviceState.Booted) {
+                throw new Error(`Device '${udid}' stopped booting before it finished (state: ${stateAfter})`);
+            }
+            return stateAfter === SimDeviceState.Booted && bootInfo?.isTerminal === true;
+        }, {
+            waitMs: timeoutMs,
+            intervalMs: 500,
+            error: `Device '${udid}' did not finish booting within ${timeoutMs}ms`,
+        });
+    });
+}
+/**
+ * @param udid — UDID of the device to shut down
+ * @throws if the device is already `Shutdown` — this is not an idempotent no-op
+ */
+export async function shutdownDevice(udid) {
+    return runCatchingAsync(async () => (await this._findDevice(udid)).shutdown());
+}
+/**
+ * Best-effort shutdown of every device in the default device set that isn't already `Shutdown` —
+ * the native equivalent of `xcrun simctl shutdown all`. A fan-out over {@link shutdownDevice}
+ * rather than `SimDeviceSet`'s own bulk method, whose completion-block signature couldn't be
+ * confirmed safely (see commit message). Per-device failures are swallowed.
+ */
+export async function shutdownAllDevices() {
+    return runCatchingAsync(async () => {
+        const deviceSet = await this._deviceSet();
+        const devices = await deviceSet.devices();
+        await Promise.all(devices
+            .filter((device) => device.state() !== SimDeviceState.Shutdown)
+            .map((device) => device.shutdown().catch(() => { })));
+    });
+}
+/**
+ * Resets the given device's content and settings. Requires it to already be `Shutdown` — call
+ * {@link shutdownDevice} first if it's booted (see CLAUDE.md).
+ *
+ * @param udid — UDID of the device to erase
+ * @throws if the device isn't currently `Shutdown`
+ */
+export async function eraseDevice(udid) {
+    return runCatchingAsync(async () => (await this._findDevice(udid)).erase());
+}
+function toDeviceInfo(device) {
+    return {
+        udid: device.udid(),
+        name: device.name(),
+        state: device.state(),
+        deviceTypeIdentifier: device.deviceTypeIdentifier(),
+        runtimeIdentifier: device.runtimeIdentifier(),
+    };
+}
+//# sourceMappingURL=lifecycle.js.map

package/lib/src/commands/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../../src/commands/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,gBAAgB,EAAC,MAAM,UAAU,CAAC;AAG1C,OAAO,EAAC,cAAc,EAAgE,MAAM,aAAa,CAAC;AAE1G,OAAO,EAAC,gBAAgB,EAAC,MAAM,mBAAmB,CAAC;AAEnD,MAAM,uBAAuB,GAAG,OAAO,CAAC;AAkBxC,uDAAuD;AACvD,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,OAAO,gBAAgB,CAAC,KAAK,IAAI,EAAE;QACjC,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QAC1C,OAAO,CAAC,MAAM,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,mGAAmG;AACnG,MAAM,CAAC,KAAK,UAAU,uBAAuB;IAC3C,OAAO,gBAAgB,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,oBAAoB,EAAE,CAAC,CAAC;AAC7F,CAAC;AAED,4FAA4F;AAC5F,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACxC,OAAO,gBAAgB,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,iBAAiB,EAAE,CAAC,CAAC;AAC1F,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAEhC,IAAY,EACZ,oBAA4B,EAC5B,iBAAyB;IAEzB,OAAO,gBAAgB,CAAC,KAAK,IAAI,EAAE;QACjC,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QAC1C,OAAO,YAAY,CAAC,MAAM,SAAS,CAAC,YAAY,CAAC,oBAAoB,EAAE,iBAAiB,EAAE,IAAI,CAAC,CAAC,CAAC;IACnG,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAqB,IAAY;IACjE,OAAO,gBAAgB,CAAC,KAAK,IAAI,EAAE;QACjC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3F,MAAM,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAE9B,IAAY,EACZ,UAAmC,EAAE;IAErC,OAAO,gBAAgB,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;AACpF,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAqB,IAAY;IAClE,OAAO,gBAAgB,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC;AACtF,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAqB,IAAY,EAAE,UAAgC,EAAE;IACpG,MAAM,EAAC,SAAS,GAAG,uBAAuB,EAAC,GAAG,OAAO,CAAC;IACtD,OAAO,gBAAgB,CAAC,KAAK,IAAI,EAAE;QACjC,MAAM,YAAY,GAAG,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;QAC5D,IAAI,YAAY,KAAK,cAAc,CAAC,OAAO,IAAI,YAAY,KAAK,cAAc,CAAC,MAAM,EAAE,CAAC;YACtF,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,sCAAsC,YAAY,GAAG,CAAC,CAAC;QACxF,CAAC;QACD,2FAA2F;QAC3F,4FAA4F;QAC5F,8EAA8E;QAC9E,MAAM,gBAAgB,CACpB,KAAK,IAAI,EAAE;YACT,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YAC5C,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;YACnC,IAAI,WAAW,KAAK,cAAc,CAAC,OAAO,IAAI,WAAW,KAAK,cAAc,CAAC,MAAM,EAAE,CAAC;gBACpF,oFAAoF;gBACpF,oFAAoF;gBACpF,wFAAwF;gBACxF,4EAA4E;gBAC5E,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,gDAAgD,WAAW,GAAG,CAAC,CAAC;YACjG,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC;YAC9C,0FAA0F;YAC1F,yFAAyF;YACzF,yFAAyF;YACzF,yFAAyF;YACzF,4FAA4F;YAC5F,gFAAgF;YAChF,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;YAClC,IAAI,UAAU,KAAK,cAAc,CAAC,OAAO,IAAI,UAAU,KAAK,cAAc,CAAC,MAAM,EAAE,CAAC;gBAClF,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,gDAAgD,UAAU,GAAG,CAAC,CAAC;YAChG,CAAC;YACD,OAAO,UAAU,KAAK,cAAc,CAAC,MAAM,IAAI,QAAQ,EAAE,UAAU,KAAK,IAAI,CAAC;QAC/E,CAAC,EACD;YACE,MAAM,EAAE,SAAS;YACjB,UAAU,EAAE,GAAG;YACf,KAAK,EAAE,WAAW,IAAI,mCAAmC,SAAS,IAAI;SACvE,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAqB,IAAY;IACnE,OAAO,gBAAgB,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;AACjF,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,OAAO,gBAAgB,CAAC,KAAK,IAAI,EAAE;QACjC,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QAC1C,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,OAAO,EAAE,CAAC;QAC1C,MAAM,OAAO,CAAC,GAAG,CACf,OAAO;aACJ,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,cAAc,CAAC,QAAQ,CAAC;aAC9D,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,CACtD,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAqB,IAAY;IAChE,OAAO,gBAAgB,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,YAAY,CAAC,MAA0B;IAC9C,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE;QACnB,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE;QACnB,KAAK,EAAE,MAAM,CAAC,KAAK,EAAoB;QACvC,oBAAoB,EAAE,MAAM,CAAC,oBAAoB,EAAE;QACnD,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,EAAE;KAC9C,CAAC;AACJ,CAAC"}

package/lib/src/commands/media.d.ts

@@ -0,0 +1,28 @@
+import type { NativeSimctl } from '../native-simctl.js';
+declare module '../native-simctl.js' {
+    interface NativeSimctl {
+        addMedia(udid: string, filePaths: string[]): Promise<void>;
+        addPhoto(udid: string, filePath: string): Promise<void>;
+        addVideo(udid: string, filePath: string): Promise<void>;
+    }
+}
+/**
+ * Adds one or more photo/video files to the device's Photos library — the native equivalent of
+ * `simctl addmedia`. Each file's type is auto-detected; use {@link addPhoto}/{@link addVideo}
+ * instead when the file's kind is already known.
+ *
+ * @param udid — UDID of the target device
+ * @param filePaths — paths to the media files on the local filesystem
+ */
+export declare function addMedia(this: NativeSimctl, udid: string, filePaths: string[]): Promise<void>;
+/**
+ * @param udid — UDID of the target device
+ * @param filePath — path to a photo file on the local filesystem
+ */
+export declare function addPhoto(this: NativeSimctl, udid: string, filePath: string): Promise<void>;
+/**
+ * @param udid — UDID of the target device
+ * @param filePath — path to a video file on the local filesystem
+ */
+export declare function addVideo(this: NativeSimctl, udid: string, filePath: string): Promise<void>;
+//# sourceMappingURL=media.d.ts.map

package/lib/src/commands/media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../../src/commands/media.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,qBAAqB,CAAC;AAGtD,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,YAAY;QACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3D,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QACxD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACzD;CACF;AAED;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnG;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhG;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhG"}

package/lib/src/commands/media.js

@@ -0,0 +1,27 @@
+import { runCatchingAsync } from '../utils/index.js';
+/**
+ * Adds one or more photo/video files to the device's Photos library — the native equivalent of
+ * `simctl addmedia`. Each file's type is auto-detected; use {@link addPhoto}/{@link addVideo}
+ * instead when the file's kind is already known.
+ *
+ * @param udid — UDID of the target device
+ * @param filePaths — paths to the media files on the local filesystem
+ */
+export async function addMedia(udid, filePaths) {
+    return runCatchingAsync(async () => (await this._findDevice(udid)).addMedia(filePaths));
+}
+/**
+ * @param udid — UDID of the target device
+ * @param filePath — path to a photo file on the local filesystem
+ */
+export async function addPhoto(udid, filePath) {
+    return runCatchingAsync(async () => (await this._findDevice(udid)).addPhoto(filePath));
+}
+/**
+ * @param udid — UDID of the target device
+ * @param filePath — path to a video file on the local filesystem
+ */
+export async function addVideo(udid, filePath) {
+    return runCatchingAsync(async () => (await this._findDevice(udid)).addVideo(filePath));
+}
+//# sourceMappingURL=media.js.map

package/lib/src/commands/media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.js","sourceRoot":"","sources":["../../../src/commands/media.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,gBAAgB,EAAC,MAAM,mBAAmB,CAAC;AAUnD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAqB,IAAY,EAAE,SAAmB;IAClF,OAAO,gBAAgB,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;AAC1F,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAqB,IAAY,EAAE,QAAgB;IAC/E,OAAO,gBAAgB,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;AACzF,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAqB,IAAY,EAAE,QAAgB;IAC/E,OAAO,gBAAgB,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;AACzF,CAAC"}