@e2e-dev/eas 0.3.2-nightly-20261015074742 → 0.3.2

package/dist/.build.json

@@ -1 +1 @@
-{"version":"0.3.2-nightly-20261015074742"}
+{"version":"0.3.2"}

package/dist/client.js

@@ -2,6 +2,7 @@
  * EAS Simulators' sessions through Expo's GraphQL API over `fetch`, the API
  * `eas simulator:*` uses, so the integration installs no SDK.
  */
+import { isRecord } from './json.js';
 const GRAPHQL_URL = 'https://api.expo.dev/graphql';
 const CREATE = `mutation ($input: CreateDeviceRunSessionInput!) {
   deviceRunSession { createDeviceRunSession(deviceRunSessionInput: $input) { id app { slug ownerAccount { name } } } }
@@ -26,7 +27,7 @@ const ENDED_JOB = new Set(['ERRORED', 'CANCELED', 'FINISHED', 'PENDING_CANCEL'])
 /** EAS Simulators sessions for one Expo access token or eas-cli session. */
 export function easSessions(credentials) {
     const auth = 'accessToken' in credentials ? { Authorization: `Bearer ${credentials.accessToken}` } : { 'expo-session': credentials.sessionSecret };
-    /** Runs one operation; a GraphQL error throws with EAS's message and error code. */
+    /** Runs one operation and returns its unchecked `data`; a GraphQL error throws with EAS's message and error code. */
     const graphql = async (query, variables, signal) => {
         const response = await fetch(GRAPHQL_URL, {
             method: 'POST',
@@ -42,12 +43,17 @@ export function easSessions(credentials) {
         catch {
             throw new Error(`EAS: HTTP ${response.status}, ${text.trim().slice(0, 200)}`);
         }
-        const error = body.errors?.[0];
-        if (error !== undefined)
-            throw new EasError(error.message ?? `HTTP ${response.status}`, error.extensions?.errorCode);
-        if (!response.ok || body.data == null)
+        const errors = field(body, 'errors');
+        const error = Array.isArray(errors) ? errors[0] : undefined;
+        if (error !== undefined) {
+            const message = field(error, 'message');
+            const code = field(field(error, 'extensions'), 'errorCode');
+            throw new EasError(typeof message === 'string' ? message : `HTTP ${response.status}`, typeof code === 'string' ? code : undefined);
+        }
+        const data = field(body, 'data');
+        if (!response.ok || data == null)
             throw new Error(`EAS: HTTP ${response.status}, no data`);
-        return body.data;
+        return data;
     };
     return {
         async create({ platform, deviceIdentifier, ...fields }, signal) {
@@ -57,42 +63,75 @@ export function easSessions(credentials) {
                 type: 'AGENT_DEVICE',
                 ...(deviceIdentifier === undefined ? {} : { [platform]: { deviceIdentifier } }),
             };
-            const data = await graphql(CREATE, { input }, signal);
-            const { id, app } = data.deviceRunSession.createDeviceRunSession;
-            return { id, url: `https://expo.dev/accounts/${encodeURIComponent(app.ownerAccount.name)}/projects/${encodeURIComponent(app.slug)}/simulator-sessions/${id}` };
+            const created = field(field(await graphql(CREATE, { input }, signal), 'deviceRunSession'), 'createDeviceRunSession');
+            const id = field(created, 'id');
+            const app = field(created, 'app');
+            const slug = field(app, 'slug');
+            const owner = field(field(app, 'ownerAccount'), 'name');
+            if (typeof id !== 'string' || typeof slug !== 'string' || typeof owner !== 'string')
+                throw unexpected('createDeviceRunSession');
+            return { id, url: `https://expo.dev/accounts/${encodeURIComponent(owner)}/projects/${encodeURIComponent(slug)}/simulator-sessions/${id}` };
         },
         async state(id, signal) {
-            const data = await graphql(STATE, { id }, signal);
-            const session = data.deviceRunSessions.byId;
-            const job = session.turtleJobRun?.status;
-            const config = session.remoteConfig;
-            if (session.status === 'STOPPED' || session.status === 'ERRORED')
-                return { phase: 'ended', status: session.status.toLowerCase() };
+            const session = field(field(await graphql(STATE, { id }, signal), 'deviceRunSessions'), 'byId');
+            const status = field(session, 'status');
+            const jobRun = field(session, 'turtleJobRun');
+            const job = field(jobRun, 'status');
+            const config = field(session, 'remoteConfig');
+            const daemonUrl = field(config, 'agentDeviceRemoteSessionUrl');
+            const daemonToken = field(config, 'agentDeviceRemoteSessionToken');
+            const previewUrl = field(config, 'webPreviewUrl');
+            const previewToken = field(config, 'webPreviewToken');
+            if (typeof status !== 'string' ||
+                (jobRun != null && typeof job !== 'string') ||
+                (config != null && !isRecord(config)) ||
+                ![daemonUrl, daemonToken, previewUrl, previewToken].every((value) => value == null || typeof value === 'string')) {
+                throw unexpected('deviceRunSessions.byId');
+            }
+            if (status === 'STOPPED' || status === 'ERRORED')
+                return { phase: 'ended', status: status.toLowerCase() };
             // A job that ended keeps the daemon address it had, which no longer answers.
-            if (job !== undefined && ENDED_JOB.has(job))
+            if (typeof job === 'string' && ENDED_JOB.has(job))
                 return { phase: 'ended', status: `job ${job.toLowerCase()}` };
-            if (config?.agentDeviceRemoteSessionUrl !== undefined && config.agentDeviceRemoteSessionToken !== undefined) {
-                const openPreviewUrl = config.webPreviewToken == null ? (config.webPreviewUrl ?? undefined) : undefined;
-                return { phase: 'ready', daemonUrl: config.agentDeviceRemoteSessionUrl, daemonToken: config.agentDeviceRemoteSessionToken, openPreviewUrl };
+            if (typeof daemonUrl === 'string' && typeof daemonToken === 'string') {
+                const openPreviewUrl = previewToken == null && typeof previewUrl === 'string' ? previewUrl : undefined;
+                return { phase: 'ready', daemonUrl, daemonToken, openPreviewUrl };
             }
-            return { phase: job === undefined || QUEUED_JOB.has(job) ? 'queued' : 'starting' };
+            return { phase: typeof job !== 'string' || QUEUED_JOB.has(job) ? 'queued' : 'starting' };
         },
         async stop(id, signal) {
-            let job;
+            let data;
             try {
-                const data = await graphql(STOP, { id }, signal);
-                job = data.deviceRunSession.ensureDeviceRunSessionStopped.turtleJobRun;
+                data = await graphql(STOP, { id }, signal);
             }
             catch (cause) {
                 if (cause instanceof EasError && cause.code === 'NOT_FOUND_ERROR')
                     return;
                 throw cause;
             }
-            if (job !== null && QUEUED_JOB.has(job.status))
-                await graphql(CANCEL_JOB, { id: job.id }, signal);
+            const stopped = field(field(data, 'deviceRunSession'), 'ensureDeviceRunSessionStopped');
+            if (!isRecord(stopped))
+                throw unexpected('ensureDeviceRunSessionStopped');
+            const job = stopped['turtleJobRun'];
+            if (job === null)
+                return;
+            const jobId = field(job, 'id');
+            const jobStatus = field(job, 'status');
+            if (typeof jobId !== 'string' || typeof jobStatus !== 'string')
+                throw unexpected('ensureDeviceRunSessionStopped');
+            if (QUEUED_JOB.has(jobStatus))
+                await graphql(CANCEL_JOB, { id: jobId }, signal);
         },
     };
 }
+/** `key` of a JSON object; `undefined` for a missing key or a value that is not an object. */
+function field(value, key) {
+    return isRecord(value) ? value[key] : undefined;
+}
+/** The error for an answer without the fields an operation reads; it names no value, since the answer can hold a daemon token. */
+function unexpected(operation) {
+    return new Error(`EAS: unexpected response to ${operation}`);
+}
 /** An error EAS answered with, its `errorCode` kept. */
 class EasError extends Error {
     code;

package/dist/credentials.js

@@ -9,6 +9,7 @@ import { readFile } from 'node:fs/promises';
 import { homedir } from 'node:os';
 import { join } from 'node:path';
 import { envValue } from './env.js';
+import { isRecord } from './json.js';
 export const EXPO_TOKEN = 'EXPO_TOKEN';
 /**
  * `EXPO_TOKEN` from the run's environment, else the `auth.sessionSecret` eas-cli
@@ -36,7 +37,8 @@ export async function expoCredentials(env) {
         // No cause: a JSON parse error quotes the text around the fault, which can be the secret.
         throw new Error(`the eas-cli login at ${path} is not valid JSON; run \`eas login\` again, or set ${EXPO_TOKEN}`);
     }
-    const sessionSecret = state?.auth?.sessionSecret;
+    const auth = isRecord(state) ? state['auth'] : undefined;
+    const sessionSecret = isRecord(auth) ? auth['sessionSecret'] : undefined;
     return typeof sessionSecret === 'string' && sessionSecret.trim() !== '' ? { sessionSecret: sessionSecret.trim() } : undefined;
 }
 /** eas-cli's production `state.json` under the run's home: `USERPROFILE` on Windows and `HOME` elsewhere, as `os.homedir()` resolves it. */

package/dist/json.d.ts

@@ -0,0 +1,2 @@
+/** A plain JSON object, not an array or `null`. */
+export declare function isRecord(value: unknown): value is Record<string, unknown>;

package/dist/json.js

@@ -0,0 +1,4 @@
+/** A plain JSON object, not an array or `null`. */
+export function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}

package/dist/project.js

@@ -8,6 +8,7 @@ import { existsSync } from 'node:fs';
 import { readFile } from 'node:fs/promises';
 import { dirname, join } from 'node:path';
 import { promisify } from 'node:util';
+import { isRecord } from './json.js';
 const execFileAsync = promisify(execFile);
 /** The dynamic app config names Expo resolves, in its order; one of them wins over `app.json`. */
 const DYNAMIC_CONFIGS = ['app.config.ts', 'app.config.mts', 'app.config.cts', 'app.config.mjs', 'app.config.cjs', 'app.config.js'];
@@ -93,7 +94,3 @@ function projectIdOf(config, source) {
         return projectId.trim();
     throw new Error(`${source} has no \`extra.eas.projectId\`; ${PASS_IT}`);
 }
-/** A plain JSON object, not an array or `null`. */
-function isRecord(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
-}

package/dist/provider.d.ts

@@ -21,13 +21,14 @@ export interface EasSimulatorsOptions {
     readonly device?: string | undefined;
     /**
      * Minutes without an agent-device command after which EAS stops the
-     * session. Defaults to 10, or one less than `maxDurationMinutes` when that
+     * session. Must be a non-negative integer; zero omits the idle limit.
+     * Defaults to 10, or one less than `maxDurationMinutes` when that
      * is shorter, since EAS wants it below the duration. A session still
      * queued once another session of the run has been ready for that one's
      * limit fails the lease: EAS is stopping that one.
      */
     readonly maxIdleTimeMinutes?: number | undefined;
-    /** Minutes a session may run once ready before EAS stops it. Absent, the account's cap: 40, or 115 on a high-priority plan. */
+    /** Non-negative integer minutes a session may run once ready before EAS stops it. Absent, the account's cap: 40, or 115 on a high-priority plan. */
     readonly maxDurationMinutes?: number | undefined;
     /**
      * The agent-device version EAS starts the session's daemon at. Defaults to

package/dist/provider.js

@@ -52,6 +52,12 @@ const OPTION_KEYS = Object.keys({
  */
 export function easSimulators(options = {}) {
     rejectUnknownKeys('easSimulators()', options, OPTION_KEYS);
+    for (const key of ['maxIdleTimeMinutes', 'maxDurationMinutes']) {
+        const value = options[key];
+        if (value !== undefined && (!Number.isInteger(value) || value < 0)) {
+            throw new ConfigurationError('INVALID_CONFIG', `easSimulators: \`${key}\` must be a non-negative integer`);
+        }
+    }
     const { projectId, buildId, applicationArchiveUrl, device, maxDurationMinutes, agentDeviceVersion, tags = [] } = options;
     if (buildId !== undefined && applicationArchiveUrl !== undefined) {
         throw new ConfigurationError('INVALID_CONFIG', 'easSimulators: pass `buildId` or `applicationArchiveUrl`, not both');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@e2e-dev/eas",
-  "version": "0.3.2-nightly-20261015074742",
+  "version": "0.3.2",
   "description": "EAS Simulators for e2e: run mobile targets on Expo's hosted iOS simulators and Android emulators",
   "keywords": [
     "e2e",
@@ -45,13 +45,13 @@
     "NOTICE"
   ],
   "peerDependencies": {
-    "@e2e-dev/mobile": "0.12.2-nightly-20261015074742",
-    "e2e": "0.21.1-nightly-20261015074742"
+    "@e2e-dev/mobile": ">=0.8.0 <1",
+    "e2e": ">=0.15.0 <1"
   },
   "devDependencies": {
-    "@e2e-dev/mobile": "0.12.2-nightly-20261015074742",
+    "@e2e-dev/mobile": "0.12.3",
     "@types/node": "26.6.2",
-    "e2e": "0.21.1-nightly-20261015074742",
+    "e2e": "0.21.2",
     "typescript": "7.0.2",
     "vitest": "5.0.1"
   },