@absolutejs/absolute 0.20.0-beta.3 → 0.20.0-beta.4

package/dist/mobile/index.js

@@ -2533,14 +2533,582 @@ var createAbsoluteIosNativeWatcher = async (options) => {
   return { close };
 };
 var isAbsoluteIosNativeRootInput = (path) => ROOT_NATIVE_INPUTS.has(basename(path));
+// src/mobile/remoteMacProtocol.ts
+import { createHash as createHash7, randomUUID as randomUUID3 } from "crypto";
+import { chmod, mkdir as mkdir6, readFile as readFile8, rename as rename7, writeFile as writeFile7 } from "fs/promises";
+import { homedir as homedir2 } from "os";
+import {
+  dirname as dirname5,
+  isAbsolute as isAbsolute5,
+  join as join7,
+  posix,
+  relative as relative6,
+  resolve as resolvePath2,
+  sep as sep5
+} from "path";
+
+// src/mobile/remoteMacWire.ts
+var ABSOLUTE_REMOTE_MAC_EVENT_PREFIX = "ABSOLUTE_REMOTE_MAC\t";
+var ABSOLUTE_REMOTE_MAC_PROTOCOL_VERSION = 1;
+
+// src/mobile/remoteMacProtocol.ts
+var PROFILE_FORMAT = 1;
+var PROFILE_NAME = /^[a-z0-9](?:[a-z0-9._-]{0,62}[a-z0-9])?$/u;
+var SSH_DESTINATION = /^(?:[A-Za-z0-9._-]+@)?[A-Za-z0-9._:-]+$/u;
+var defaultProfilePath = () => join7(homedir2(), ".absolutejs", "mobile", "remote-macs.json");
+var emptyStore = () => ({
+  format: PROFILE_FORMAT,
+  profiles: {}
+});
+var loadStore = async (path = defaultProfilePath()) => {
+  try {
+    const parsed = JSON.parse(await readFile8(path, "utf8"));
+    if (parsed.format !== PROFILE_FORMAT || typeof parsed.profiles !== "object" || parsed.profiles === null || Array.isArray(parsed.profiles))
+      throw new Error("Unsupported remote Mac profile format.");
+    for (const [key, profile] of Object.entries(parsed.profiles)) {
+      if (typeof profile !== "object" || profile === null || validateAbsoluteRemoteMacProfileName(key) !== key || profile.name !== key || validateAbsoluteSshDestination(profile.destination) !== profile.destination || validatePort(profile.port) !== profile.port || typeof profile.createdAt !== "string" || !profile.createdAt || typeof profile.bunPath !== "string" || !profile.bunPath.startsWith("/") || /[\r\n\0]/u.test(profile.bunPath) || typeof profile.workspaceRoot !== "string" || !profile.workspaceRoot.startsWith("/") || profile.workspaceRoot === "/" || /[\r\n\0]/u.test(profile.workspaceRoot) || typeof profile.xcodeVersion !== "string" || !profile.xcodeVersion.startsWith("Xcode "))
+        throw new Error(`Remote Mac profile ${JSON.stringify(key)} is invalid.`);
+    }
+    if (parsed.defaultProfile !== undefined && !parsed.profiles[parsed.defaultProfile])
+      throw new Error("The default remote Mac profile does not exist.");
+    return parsed;
+  } catch (error) {
+    if (error.code === "ENOENT")
+      return emptyStore();
+    throw error;
+  }
+};
+var saveStore = async (store, path = defaultProfilePath()) => {
+  await mkdir6(dirname5(path), { recursive: true });
+  const temporary = `${path}.${randomUUID3()}.tmp`;
+  await writeFile7(temporary, `${JSON.stringify(store, null, 2)}
+`, {
+    mode: 384
+  });
+  await rename7(temporary, path);
+  await chmod(path, 384);
+};
+var validateAbsoluteRemoteMacProfileName = (name) => {
+  const normalized = name.trim().toLowerCase();
+  if (!PROFILE_NAME.test(normalized))
+    throw new TypeError("Remote Mac profile names must use 1-64 lowercase letters, digits, dots, dashes, or underscores.");
+  return normalized;
+};
+var validateAbsoluteSshDestination = (destination) => {
+  const normalized = destination.trim();
+  if (!SSH_DESTINATION.test(normalized) || normalized.startsWith("-"))
+    throw new TypeError("Remote Mac SSH destination must be a host, SSH alias, or user@host without command-line options.");
+  return normalized;
+};
+var validatePort = (port) => {
+  if (port !== undefined && (!Number.isInteger(port) || port < 1 || port > 65535))
+    throw new TypeError("Remote Mac SSH port must be between 1 and 65535.");
+  return port;
+};
+var shellQuote = (value) => `'${value.replaceAll("'", "'\\''")}'`;
+var absoluteRemoteMacSshBase = (profile, options = {}) => [
+  "ssh",
+  "-o",
+  "BatchMode=yes",
+  "-o",
+  "ConnectTimeout=10",
+  "-o",
+  "ServerAliveInterval=15",
+  "-o",
+  "ServerAliveCountMax=3",
+  "-o",
+  `StrictHostKeyChecking=${options.acceptNew ? "accept-new" : "yes"}`,
+  ...profile.port ? ["-p", String(profile.port)] : [],
+  profile.destination
+];
+var localCapture = async (command) => {
+  const process2 = Bun.spawn(command, {
+    stderr: "pipe",
+    stdin: "ignore",
+    stdout: "pipe"
+  });
+  const [exitCode, stdout, stderr] = await Promise.all([
+    process2.exited,
+    new Response(process2.stdout).text(),
+    new Response(process2.stderr).text()
+  ]);
+  return { exitCode, stderr, stdout };
+};
+var defaultTransport = {
+  capture: localCapture,
+  spawn: (command, options) => Bun.spawn(command, {
+    signal: options.signal,
+    stderr: "pipe",
+    stdin: "pipe",
+    stdout: "pipe"
+  })
+};
+var requireRemoteSuccess = (result, label) => {
+  if (result.exitCode !== 0)
+    throw new Error(`${label} failed: ${(result.stderr || result.stdout).trim() || `status ${result.exitCode}`}`);
+  return result.stdout.trim();
+};
+var getAbsoluteRemoteMacProfile = async (name, profilePath) => {
+  const store = await loadStore(profilePath);
+  const selected = name ?? process.env.ABSOLUTE_IOS_REMOTE ?? store.defaultProfile;
+  if (!selected)
+    return;
+  const profile = store.profiles[selected];
+  if (!profile)
+    throw new Error(`Remote Mac profile ${JSON.stringify(selected)} was not found.`);
+  return profile;
+};
+var inspectAbsoluteRemoteMac = async (destination, options = {}) => {
+  const profile = {
+    destination: validateAbsoluteSshDestination(destination),
+    port: validatePort(options.port)
+  };
+  const capture = options.transport?.capture ?? defaultTransport.capture;
+  const command = [
+    ...absoluteRemoteMacSshBase(profile, {
+      acceptNew: options.acceptNew === true
+    }),
+    "/bin/sh -lc",
+    shellQuote(`bun_path="$(command -v bun || true)"; if [ -z "$bun_path" ] && [ -x "$HOME/.bun/bin/bun" ]; then bun_path="$HOME/.bun/bin/bun"; fi; printf '%s\\n' "$(uname -s)" "$HOME" "$bun_path" "$(/usr/bin/xcodebuild -version 2>/dev/null | tr '\\n' ' ' || true)"`)
+  ];
+  const lines = requireRemoteSuccess(await capture(command), "Remote Mac handshake").split(/\r?\n/u);
+  const [operatingSystem, home, bunPath, xcodeVersion] = lines;
+  if (operatingSystem !== "Darwin")
+    throw new Error("The SSH target is not a Mac.");
+  if (!home?.startsWith("/") || !bunPath?.startsWith("/"))
+    throw new Error("The remote Mac must have Bun installed and available to SSH.");
+  if (!xcodeVersion?.startsWith("Xcode "))
+    throw new Error("The remote Mac must have full Xcode installed and selected.");
+  return { bunPath, home, os: operatingSystem, xcodeVersion };
+};
+var listAbsoluteRemoteMacProfiles = async (profilePath) => {
+  const store = await loadStore(profilePath);
+  return {
+    defaultProfile: store.defaultProfile,
+    profiles: Object.values(store.profiles).sort((left, right) => left.name.localeCompare(right.name))
+  };
+};
+var pairAbsoluteRemoteMac = async (options) => {
+  const name = validateAbsoluteRemoteMacProfileName(options.name);
+  const destination = validateAbsoluteSshDestination(options.destination);
+  const port = validatePort(options.port);
+  const inspection = await inspectAbsoluteRemoteMac(destination, {
+    acceptNew: true,
+    port,
+    transport: options.transport
+  });
+  const workspaceRoot = options.workspaceRoot ? options.workspaceRoot.trim() : posix.join(inspection.home, ".absolutejs", "remote-ios");
+  if (!workspaceRoot.startsWith("/") || workspaceRoot === "/" || /[\r\n\0]/u.test(workspaceRoot))
+    throw new TypeError("Remote Mac workspace must be an absolute macOS path.");
+  const profile = {
+    bunPath: inspection.bunPath,
+    createdAt: new Date().toISOString(),
+    destination,
+    name,
+    ...port ? { port } : {},
+    workspaceRoot,
+    xcodeVersion: inspection.xcodeVersion
+  };
+  const store = await loadStore(options.profilePath);
+  store.profiles[name] = profile;
+  store.defaultProfile = name;
+  await saveStore(store, options.profilePath);
+  return profile;
+};
+var removeAbsoluteRemoteMacProfile = async (name, profilePath) => {
+  const normalized = validateAbsoluteRemoteMacProfileName(name);
+  const store = await loadStore(profilePath);
+  if (!store.profiles[normalized])
+    return false;
+  delete store.profiles[normalized];
+  if (store.defaultProfile === normalized) {
+    const [nextDefault] = Object.keys(store.profiles).sort();
+    store.defaultProfile = nextDefault;
+  }
+  await saveStore(store, profilePath);
+  return true;
+};
+var projectIdentity = (projectRoot, appId) => createHash7("sha256").update(`${resolvePath2(projectRoot)}\x00${appId}`).digest("hex").slice(0, 20);
+var createAbsoluteRemoteIosDevProject = (config, projectRoot, profile) => ({
+  cap: join7(resolvePath2(projectRoot), "node_modules", ".bin", "cap"),
+  config,
+  nativeDirectory: join7(config.nativeProjectDirectory, "ios"),
+  profile,
+  projectRoot: resolvePath2(projectRoot),
+  remote: true,
+  remoteProjectRoot: posix.join(profile.workspaceRoot, "projects", projectIdentity(projectRoot, config.appId), "current"),
+  xcodebuild: "remote:xcodebuild",
+  xcrun: "remote:xcrun"
+});
+var installAbsoluteRemoteMacAgent = async (project) => {
+  const artifact = await materializeAbsoluteRemoteMacAgent(project.projectRoot);
+  const directory = posix.join(project.profile.workspaceRoot, "agents", `protocol-${ABSOLUTE_REMOTE_MAC_PROTOCOL_VERSION}`, artifact.sha256);
+  const remotePath = posix.join(directory, "agent.js");
+  const verifyScript = `test -f ${shellQuote(remotePath)} && ` + `test "$(shasum -a 256 ${shellQuote(remotePath)} | awk '{print $1}')" = ${shellQuote(artifact.sha256)}`;
+  const verified = await defaultTransport.capture([
+    ...absoluteRemoteMacSshBase(project.profile),
+    "/bin/sh -lc",
+    shellQuote(verifyScript)
+  ]);
+  if (verified.exitCode === 0)
+    return { ...artifact, remotePath, uploaded: false };
+  const temporary = posix.join(directory, `.agent-${randomUUID3()}.tmp`);
+  const installScript = [
+    "set -eu",
+    "umask 077",
+    `mkdir -p ${shellQuote(directory)}`,
+    `cat > ${shellQuote(temporary)}`,
+    `test "$(shasum -a 256 ${shellQuote(temporary)} | awk '{print $1}')" = ${shellQuote(artifact.sha256)}`,
+    `chmod 600 ${shellQuote(temporary)}`,
+    `mv ${shellQuote(temporary)} ${shellQuote(remotePath)}`
+  ].join("; ");
+  const upload = Bun.spawn([
+    ...absoluteRemoteMacSshBase(project.profile),
+    "/bin/sh -lc",
+    shellQuote(installScript)
+  ], {
+    stderr: "pipe",
+    stdin: Bun.file(artifact.path),
+    stdout: "pipe"
+  });
+  const [exitCode, stderr] = await Promise.all([
+    upload.exited,
+    new Response(upload.stderr).text()
+  ]);
+  if (exitCode !== 0)
+    throw new Error(`Remote Mac agent installation failed: ${stderr.trim() || `status ${exitCode}`}`);
+  return { ...artifact, remotePath, uploaded: true };
+};
+var materializeAbsoluteRemoteMacAgent = async (projectRoot) => {
+  const shippedCandidates = [
+    join7(import.meta.dir, "remoteMacAgentEntry.js"),
+    join7(import.meta.dir, "..", "mobile", "remoteMacAgentEntry.js")
+  ];
+  let path;
+  for (const candidate of shippedCandidates) {
+    if (await Bun.file(candidate).exists()) {
+      path = candidate;
+      break;
+    }
+  }
+  if (!path) {
+    const sourceCandidates = [
+      join7(import.meta.dir, "remoteMacAgentEntry.ts"),
+      join7(import.meta.dir, "..", "..", "src", "mobile", "remoteMacAgentEntry.ts")
+    ];
+    const source = await sourceCandidates.reduce(async (found, candidate) => await found ?? (await Bun.file(candidate).exists() ? candidate : undefined), Promise.resolve(undefined));
+    if (!source)
+      throw new Error("The AbsoluteJS installation does not contain its remote Mac agent artifact.");
+    const outdir = join7(resolvePath2(projectRoot), ".absolutejs", "mobile", "remote-agent");
+    await mkdir6(outdir, { recursive: true });
+    const result = await Bun.build({
+      entrypoints: [source],
+      minify: true,
+      outdir,
+      target: "bun"
+    });
+    if (!result.success)
+      throw new AggregateError(result.logs, "Failed to build the AbsoluteJS remote Mac agent.");
+    path = join7(outdir, "remoteMacAgentEntry.js");
+  }
+  const bytes = await Bun.file(path).arrayBuffer();
+  const sha256 = createHash7("sha256").update(new Uint8Array(bytes)).digest("hex");
+  return { bytes: bytes.byteLength, path, sha256 };
+};
+var portableRelativePath = (root, path) => relative6(root, path).split(sep5).join(posix.sep);
+var portableMobileConfig = (project) => ({
+  appId: project.config.appId,
+  appName: project.config.appName,
+  bundleDirectory: portableRelativePath(project.projectRoot, project.config.bundleDirectory),
+  ...project.config.deepLinkScheme || project.config.deepLinkHosts.length > 1 || project.config.appleAppIdPrefix ? {
+    deepLinks: {
+      ...project.config.deepLinkScheme ? { scheme: project.config.deepLinkScheme } : {},
+      hosts: project.config.deepLinkHosts,
+      ...project.config.appleAppIdPrefix ? {
+        apple: {
+          appIdPrefix: project.config.appleAppIdPrefix
+        }
+      } : {}
+    }
+  } : {},
+  entry: project.config.entry,
+  ...project.config.iosVersion ? { ios: { version: project.config.iosVersion } } : {},
+  nativeProject: {
+    directory: portableRelativePath(project.projectRoot, project.config.nativeProjectDirectory),
+    mode: "source"
+  },
+  platforms: ["ios"],
+  server: { productionOrigin: project.config.productionOrigin }
+});
+var absoluteRemoteProjectSyncCommands = (project) => {
+  const current = project.remoteProjectRoot;
+  const parent = posix.dirname(current);
+  const staging = posix.join(parent, `.incoming-${randomUUID3()}`);
+  const previous = posix.join(parent, ".previous");
+  const script = [
+    "set -eu",
+    `mkdir -p ${shellQuote(staging)}`,
+    `tar -xf - -C ${shellQuote(staging)}`,
+    `if [ -d ${shellQuote(posix.join(current, "node_modules"))} ]; then mv ${shellQuote(posix.join(current, "node_modules"))} ${shellQuote(posix.join(staging, "node_modules"))}; fi`,
+    `if [ -d ${shellQuote(posix.join(current, ".absolutejs"))} ]; then mv ${shellQuote(posix.join(current, ".absolutejs"))} ${shellQuote(posix.join(staging, ".absolutejs"))}; fi`,
+    `rm -rf ${shellQuote(previous)}`,
+    `if [ -d ${shellQuote(current)} ]; then mv ${shellQuote(current)} ${shellQuote(previous)}; fi`,
+    `mv ${shellQuote(staging)} ${shellQuote(current)}`,
+    `rm -rf ${shellQuote(previous)}`
+  ].join("; ");
+  return {
+    remote: [
+      ...absoluteRemoteMacSshBase(project.profile),
+      "/bin/sh -lc",
+      shellQuote(script)
+    ],
+    tar: [
+      "tar",
+      "--exclude=.git",
+      "--exclude=node_modules",
+      "--exclude=build",
+      "--exclude=.absolutejs",
+      "-cf",
+      "-",
+      "-C",
+      project.projectRoot,
+      "."
+    ]
+  };
+};
+var syncAbsoluteRemoteMacProject = async (project) => {
+  const commands = absoluteRemoteProjectSyncCommands(project);
+  const archive = Bun.spawn(commands.tar, {
+    stderr: "pipe",
+    stdout: "pipe"
+  });
+  const upload = Bun.spawn(commands.remote, {
+    stderr: "pipe",
+    stdin: archive.stdout,
+    stdout: "pipe"
+  });
+  const [archiveExit, uploadExit, archiveError, uploadError] = await Promise.all([
+    archive.exited,
+    upload.exited,
+    new Response(archive.stderr).text(),
+    new Response(upload.stderr).text()
+  ]);
+  if (archiveExit !== 0 || uploadExit !== 0)
+    throw new Error(`Remote Mac project synchronization failed: ${(archiveError || uploadError).trim()}`);
+  const install = await defaultTransport.capture([
+    ...absoluteRemoteMacSshBase(project.profile),
+    "/bin/sh -lc",
+    shellQuote(`cd ${shellQuote(project.remoteProjectRoot)} && ${shellQuote(project.profile.bunPath)} install --frozen-lockfile`)
+  ]);
+  requireRemoteSuccess(install, "Remote Mac dependency installation");
+};
+var consumeLines2 = async (stream, onLine) => {
+  const reader = stream.getReader();
+  const decoder = new TextDecoder;
+  let buffered = "";
+  try {
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done)
+        break;
+      buffered += decoder.decode(value, { stream: true });
+      const lines = buffered.split(/\r?\n/u);
+      buffered = lines.pop() ?? "";
+      lines.forEach(onLine);
+    }
+    buffered += decoder.decode();
+    if (buffered)
+      onLine(buffered);
+  } finally {
+    reader.releaseLock();
+  }
+};
+var startAbsoluteRemoteIosDevSession = async (options) => {
+  const startedAt = performance.now();
+  const transport = options.transport ?? defaultTransport;
+  const installAgent = options.installAgent ?? installAbsoluteRemoteMacAgent;
+  const syncProject = options.syncProject ?? syncAbsoluteRemoteMacProject;
+  const agentStartedAt = performance.now();
+  const agent = await installAgent(options.project);
+  const agentDuration = performance.now() - agentStartedAt;
+  const syncStartedAt = performance.now();
+  await syncProject(options.project);
+  const syncDuration = performance.now() - syncStartedAt;
+  const encodedConfig = Buffer.from(JSON.stringify(portableMobileConfig(options.project))).toString("base64url");
+  const remoteCommand = [
+    `cd ${shellQuote(options.project.remoteProjectRoot)}`,
+    "&&",
+    "exec",
+    shellQuote(options.project.profile.bunPath),
+    shellQuote(agent.remotePath),
+    "--port",
+    String(options.port),
+    "--mobile-config",
+    shellQuote(encodedConfig),
+    ...options.https ? ["--https"] : []
+  ].join(" ");
+  const command = [
+    ...absoluteRemoteMacSshBase(options.project.profile),
+    "-o",
+    "ExitOnForwardFailure=yes",
+    "-R",
+    `${options.port}:127.0.0.1:${options.port}`,
+    "/bin/sh -lc",
+    shellQuote(remoteCommand)
+  ];
+  const connectStartedAt = performance.now();
+  const process2 = transport.spawn(command, { signal: options.signal });
+  let state = "syncing";
+  let ready;
+  let fatal;
+  const pending = new Map;
+  let resolveReady;
+  let rejectReady;
+  const readyPromise = new Promise((resolve6, reject) => {
+    resolveReady = resolve6;
+    rejectReady = reject;
+  });
+  const handleEvent = (event) => {
+    if (event.v !== ABSOLUTE_REMOTE_MAC_PROTOCOL_VERSION) {
+      rejectReady(new Error("Remote Mac protocol version mismatch."));
+      return;
+    }
+    if (event.type === "log")
+      options.log?.(event.message);
+    if (event.type === "native-log")
+      options.nativeLog?.(event.entry);
+    if (event.type === "state") {
+      ({ state } = event);
+      options.onStateChange?.(state);
+    }
+    if (event.type === "timing")
+      options.onPhaseTiming?.(event);
+    if (event.type === "ready") {
+      ready = event;
+      resolveReady();
+    }
+    if (event.type === "fatal") {
+      fatal = new Error(event.error);
+      rejectReady(fatal);
+    }
+    if (event.type === "response") {
+      const request2 = pending.get(event.id);
+      if (!request2)
+        return;
+      pending.delete(event.id);
+      if (event.ok)
+        request2.resolve(event.result);
+      else
+        request2.reject(new Error(event.error ?? "Remote command failed."));
+    }
+  };
+  const stdoutDone = consumeLines2(process2.stdout, (line) => {
+    if (!line.startsWith(ABSOLUTE_REMOTE_MAC_EVENT_PREFIX))
+      return;
+    try {
+      handleEvent(JSON.parse(line.slice(ABSOLUTE_REMOTE_MAC_EVENT_PREFIX.length)));
+    } catch {
+      options.log?.(`Remote Mac emitted an invalid protocol event.`);
+    }
+  }).catch((error) => {
+    fatal = error instanceof Error ? error : new Error("Failed to read the remote Mac protocol stream.");
+    rejectReady(fatal);
+  });
+  const stderrDone = consumeLines2(process2.stderr, (line) => options.log?.(`[remote] ${line}`)).catch((error) => options.log?.(`[remote] ${error instanceof Error ? error.message : "Failed to read SSH stderr."}`));
+  process2.exited.then(async (exitCode) => {
+    await Promise.all([stdoutDone, stderrDone]);
+    const error = fatal ?? new Error(`Remote Mac connection closed with status ${exitCode}.`);
+    if (!ready)
+      rejectReady(error);
+    pending.forEach(({ reject }) => reject(error));
+    pending.clear();
+    return;
+  });
+  await readyPromise;
+  if (!ready)
+    throw fatal ?? new Error("Remote Mac did not become ready.");
+  const totalDuration = performance.now() - startedAt;
+  let currentReady = {
+    ...ready,
+    timings: {
+      ...ready.timings,
+      "remote-agent": agentDuration,
+      "remote-connect": performance.now() - connectStartedAt,
+      "remote-sync": syncDuration,
+      total: totalDuration
+    }
+  };
+  options.log?.(`Remote Mac connected (${options.project.profile.name}); agent ${agent.uploaded ? "uploaded" : "cache hit"}, project synced, and iOS ready in ${totalDuration.toFixed(2)}ms.`);
+  const request = (commandName) => {
+    const id = randomUUID3();
+    const response = new Promise((resolve6, reject) => pending.set(id, { reject, resolve: resolve6 }));
+    process2.stdin.write(`${JSON.stringify({ command: commandName, id, v: 1 })}
+`);
+    process2.stdin.flush();
+    return response;
+  };
+  let closed = false;
+  const close = async () => {
+    if (closed)
+      return;
+    closed = true;
+    await request("close").catch(() => {
+      return;
+    });
+    process2.stdin.end();
+    await process2.exited.catch(() => {
+      return;
+    });
+  };
+  const makeSession = () => ({
+    close,
+    nativeCacheHit: currentReady.nativeCacheHit,
+    startedSimulator: currentReady.startedSimulator,
+    timings: currentReady.timings,
+    udid: currentReady.udid,
+    rebuild: async () => {
+      const rebuildStartedAt = performance.now();
+      const rebuildSyncStartedAt = performance.now();
+      await syncProject(options.project);
+      const rebuildSyncDuration = performance.now() - rebuildSyncStartedAt;
+      const result = await request("rebuild");
+      currentReady = {
+        ...result,
+        timings: {
+          ...result.timings,
+          "remote-sync": rebuildSyncDuration,
+          total: performance.now() - rebuildStartedAt
+        }
+      };
+      return makeSession();
+    },
+    relaunch: async () => {
+      await request("relaunch");
+    },
+    screenshot: async (destination) => {
+      const result = await request("screenshot");
+      const target = resolvePath2(options.project.projectRoot, destination);
+      const targetRelative = relative6(options.project.projectRoot, target);
+      if (targetRelative.startsWith("..") || isAbsolute5(targetRelative))
+        throw new Error("iOS screenshot must remain inside the project.");
+      await mkdir6(dirname5(target), { recursive: true });
+      await writeFile7(target, Buffer.from(result.data, "base64"));
+      return target;
+    },
+    get state() {
+      return state;
+    }
+  });
+  return makeSession();
+};
 // src/mobile/associationFiles.ts
 import {
   access as access7,
-  mkdir as mkdir6,
-  readFile as readFile8,
-  rename as rename7,
+  mkdir as mkdir7,
+  readFile as readFile9,
+  rename as rename8,
   rm as rm6,
-  writeFile as writeFile7
+  writeFile as writeFile8
 } from "fs/promises";
 import { resolve as resolve7 } from "path";
 import { Elysia } from "elysia";
@@ -2742,7 +3310,7 @@ var createAbsoluteMobileAssociationPlugin = (mobile, projectRoot, options = {})
 var writeAtomic = async (path, source) => {
   let current;
   try {
-    current = await readFile8(path, "utf8");
+    current = await readFile9(path, "utf8");
   } catch (error) {
     if (!(error instanceof Error) || !("code" in error) || error.code !== "ENOENT") {
       throw error;
@@ -2751,8 +3319,8 @@ var writeAtomic = async (path, source) => {
   if (current === source)
     return false;
   const temporary = `${path}.${crypto.randomUUID()}.tmp`;
-  await writeFile7(temporary, source, { flag: "wx" });
-  await rename7(temporary, path);
+  await writeFile8(temporary, source, { flag: "wx" });
+  await rename8(temporary, path);
   return true;
 };
 var exists2 = async (path) => {
@@ -2767,7 +3335,7 @@ var assertOwnedOutput = async (root) => {
   const path = resolve7(root, OWNERSHIP_FILE);
   let ownership;
   try {
-    ownership = JSON.parse(await readFile8(path, "utf8"));
+    ownership = JSON.parse(await readFile9(path, "utf8"));
   } catch {
     throw new TypeError(`Association output ${root} already exists and is not owned by AbsoluteJS.`);
   }
@@ -2781,12 +3349,12 @@ var publishGeneratedDirectory = async (temporary, root) => {
     await assertOwnedOutput(root);
   const backup = `${root}.${crypto.randomUUID()}.previous`;
   if (hasCurrent)
-    await rename7(root, backup);
+    await rename8(root, backup);
   try {
-    await rename7(temporary, root);
+    await rename8(temporary, root);
   } catch (error) {
     if (hasCurrent)
-      await rename7(backup, root);
+      await rename8(backup, root);
     throw error;
   }
   if (hasCurrent)
@@ -2794,7 +3362,7 @@ var publishGeneratedDirectory = async (temporary, root) => {
 };
 var materializeHost = async (root, host, files) => {
   const directory = resolve7(root, host, ".well-known");
-  await mkdir6(directory, { recursive: true });
+  await mkdir7(directory, { recursive: true });
   return Promise.all(files.map(async ([name, document]) => {
     const path = resolve7(directory, name);
     await writeAtomic(path, `${JSON.stringify(document, null, 2)}
@@ -2832,7 +3400,7 @@ var materializeAbsoluteMobileAssociationFiles = async (config, outputDirectory)
   if (documents.apple) {
     files.push(["apple-app-site-association", documents.apple]);
   }
-  await mkdir6(temporary, { recursive: true });
+  await mkdir7(temporary, { recursive: true });
   try {
     const temporaryPaths = (await Promise.all(config.deepLinkHosts.map((host) => materializeHost(temporary, host, files)))).flat();
     await writeAtomic(resolve7(temporary, OWNERSHIP_FILE), `${JSON.stringify({ format: 1, hosts: config.deepLinkHosts }, null, 2)}
@@ -2903,15 +3471,15 @@ var parseAbsoluteMobileBuildPageMetadata = (value) => {
   };
 };
 // src/mobile/buildPipeline.ts
-import { readFile as readFile12 } from "fs/promises";
-import { join as join10, resolve as resolve10 } from "path";
+import { readFile as readFile13 } from "fs/promises";
+import { join as join11, resolve as resolve10 } from "path";
 import { pathToFileURL as pathToFileURL2 } from "url";
 
 // src/mobile/buildRelease.ts
-import { createHash as createHash7 } from "crypto";
-import { readFile as readFile9 } from "fs/promises";
-import { join as join7, relative as relative6, resolve as resolve8 } from "path";
-var sha256 = (bytes) => createHash7("sha256").update(bytes).digest("hex");
+import { createHash as createHash8 } from "crypto";
+import { readFile as readFile10 } from "fs/promises";
+import { join as join8, relative as relative7, resolve as resolve8 } from "path";
+var sha256 = (bytes) => createHash8("sha256").update(bytes).digest("hex");
 var readPageMetadata = (route) => parseAbsoluteMobileBuildPageMetadata(route.hooks?.detail?.[ABSOLUTE_MOBILE_ROUTE_DETAIL]);
 var resolveAssetPath = (buildDirectory, assetPath) => {
   const resolvedBuildDirectory = resolve8(buildDirectory);
@@ -2919,7 +3487,7 @@ var resolveAssetPath = (buildDirectory, assetPath) => {
   if (resolvedAsset.startsWith(`${resolvedBuildDirectory}/`)) {
     return resolvedAsset;
   }
-  return join7(buildDirectory, assetPath.replace(/^\/+/, ""));
+  return join8(buildDirectory, assetPath.replace(/^\/+/, ""));
 };
 var pageFor = async (metadata, manifest, buildDirectory) => {
   const assetPath = manifest[metadata.bundleKey];
@@ -2927,8 +3495,8 @@ var pageFor = async (metadata, manifest, buildDirectory) => {
     throw new TypeError(`Mobile page ${metadata.pageId} references missing manifest asset ${metadata.bundleKey}.`);
   }
   const resolvedAssetPath = resolveAssetPath(buildDirectory, assetPath);
-  const bytes = await readFile9(resolvedAssetPath);
-  const bundlePath = `/${relative6(resolve8(buildDirectory), resolvedAssetPath).replaceAll("\\", "/")}`;
+  const bytes = await readFile10(resolvedAssetPath);
+  const bundlePath = `/${relative7(resolve8(buildDirectory), resolvedAssetPath).replaceAll("\\", "/")}`;
   return {
     bundleHash: sha256(bytes),
     bundlePath,
@@ -2941,7 +3509,7 @@ var pageFor = async (metadata, manifest, buildDirectory) => {
 var buildAbsoluteMobileCompatibilityRelease = async (options) => {
   const [captured, producerBytes] = await Promise.all([
     captureAbsoluteMobileRouteGraph(options.app),
-    readFile9(options.producerPath)
+    readFile10(options.producerPath)
   ]);
   if (captured.length === 0) {
     throw new TypeError("No instrumented AbsoluteJS mobile page routes were found in the finalized Elysia route graph.");
@@ -3022,15 +3590,15 @@ var captureAbsoluteMobileRouteGraph = async (app) => {
 // src/mobile/capacitorBundle.ts
 import {
   copyFile as copyFile5,
-  mkdir as mkdir7,
+  mkdir as mkdir8,
   mkdtemp as mkdtemp4,
-  readFile as readFile10,
-  rename as rename8,
+  readFile as readFile11,
+  rename as rename9,
   rm as rm7,
-  writeFile as writeFile8
+  writeFile as writeFile9
 } from "fs/promises";
 import { existsSync as existsSync2 } from "fs";
-import { basename as basename2, dirname as dirname5, extname, join as join8, resolve as resolve9 } from "path";
+import { basename as basename2, dirname as dirname6, extname, join as join9, resolve as resolve9 } from "path";
 
 // src/mobile/routeMatcher.ts
 var REGEXP_SPECIAL_CHARACTERS = /[.*+?^${}()|[\]\\]/g;
@@ -3464,7 +4032,7 @@ var INDEX_FILE = "index.html";
 var CLIENT_IMPORT_PATTERN = /(?:\bfrom\s*|\bimport\s*\(\s*|\bimport\s*)["'](\/[^"']+)["']/gu;
 var errorHasCode2 = (error, code) => typeof error === "object" && error !== null && Reflect.get(error, "code") === code;
 var shellBootstrapModule = () => {
-  const candidate = ["js", "ts"].map((extension) => join8(import.meta.dir, `shellBootstrap.${extension}`)).find(existsSync2);
+  const candidate = ["js", "ts"].map((extension) => join9(import.meta.dir, `shellBootstrap.${extension}`)).find(existsSync2);
   if (candidate)
     return candidate;
   throw new TypeError("AbsoluteJS mobile shell bootstrap module is missing.");
@@ -3494,8 +4062,8 @@ var sourceAssetPath = (buildDirectory, bundlePath) => {
 };
 var buildShellBootstrap = async (staging) => {
   const modulePath = shellBootstrapModule();
-  const entryPath = join8(staging, ".absolute-mobile-entry.ts");
-  await writeFile8(entryPath, `import { startAbsoluteMobileShell } from ${JSON.stringify(modulePath)};
+  const entryPath = join9(staging, ".absolute-mobile-entry.ts");
+  await writeFile9(entryPath, `import { startAbsoluteMobileShell } from ${JSON.stringify(modulePath)};
 void startAbsoluteMobileShell();
 `);
   const build = await Bun.build({
@@ -3507,7 +4075,7 @@ void startAbsoluteMobileShell();
   if (!build.success || build.outputs.length !== 1) {
     throw new AggregateError(build.logs, "Failed to build the AbsoluteJS Capacitor shell.");
   }
-  await rename8(build.outputs[0]?.path ?? "", join8(staging, BOOTSTRAP_FILE));
+  await rename9(build.outputs[0]?.path ?? "", join9(staging, BOOTSTRAP_FILE));
   await rm7(entryPath, { force: true });
 };
 var removePreviousBundle = async (backup, moved) => {
@@ -3518,20 +4086,20 @@ var removePreviousBundle = async (backup, moved) => {
 var restorePreviousBundle = async (backup, destination, moved) => {
   if (!moved)
     return;
-  await rename8(backup, destination);
+  await rename9(backup, destination);
 };
 var installBundle = async (staging, destination) => {
   const backup = `${destination}.previous-${crypto.randomUUID()}`;
   let movedPrevious = false;
   try {
-    await rename8(destination, backup);
+    await rename9(destination, backup);
     movedPrevious = true;
   } catch (error) {
     if (!errorHasCode2(error, "ENOENT"))
       throw error;
   }
   try {
-    await rename8(staging, destination);
+    await rename9(staging, destination);
     await removePreviousBundle(backup, movedPrevious);
   } catch (error) {
     await restorePreviousBundle(backup, destination, movedPrevious);
@@ -3545,12 +4113,12 @@ var copyClientPage = async (page, buildDirectory, staging, copiedDependencies) =
   const extension = extname(page.bundlePath) || ".js";
   const localBundlePath = `./pages/${page.bundleHash}${extension}`;
   const source = sourceAssetPath(buildDirectory, page.bundlePath);
-  await copyFile5(source, join8(staging, localBundlePath));
+  await copyFile5(source, join9(staging, localBundlePath));
   await copyAbsoluteClientDependencies(source, buildDirectory, staging, copiedDependencies);
   return { ...page, localBundlePath };
 };
 var absoluteClientImports = async (sourcePath) => {
-  const source = await readFile10(sourcePath, "utf8");
+  const source = await readFile11(sourcePath, "utf8");
   return [...source.matchAll(CLIENT_IMPORT_PATTERN)].flatMap((match) => {
     const [specifier] = match.slice(1);
     return specifier ? [specifier.split(/[?#]/u, 1)[0] ?? specifier] : [];
@@ -3561,8 +4129,8 @@ var copyAbsoluteClientDependency = async (specifier, buildDirectory, staging, co
     return;
   copied.add(specifier);
   const source = sourceAssetPath(buildDirectory, specifier);
-  const destination = join8(staging, specifier.replace(/^\/+/, ""));
-  await mkdir7(dirname5(destination), { recursive: true });
+  const destination = join9(staging, specifier.replace(/^\/+/, ""));
+  await mkdir8(dirname6(destination), { recursive: true });
   await copyFile5(source, destination);
   await copyAbsoluteClientDependencies(source, buildDirectory, staging, copied);
 };
@@ -3575,11 +4143,11 @@ var materializeAbsoluteCapacitorWebBundle = async (options) => {
     throw new TypeError(`mobile.entry ${options.config.entry} is not a captured mobile page route.`);
   }
   const destination = options.config.bundleDirectory;
-  await mkdir7(dirname5(destination), { recursive: true });
-  const staging = await mkdtemp4(join8(dirname5(destination), `.${basename2(destination)}.stage-`));
+  await mkdir8(dirname6(destination), { recursive: true });
+  const staging = await mkdtemp4(join9(dirname6(destination), `.${basename2(destination)}.stage-`));
   try {
-    const pageDirectory = join8(staging, "pages");
-    await mkdir7(pageDirectory, { recursive: true });
+    const pageDirectory = join9(staging, "pages");
+    await mkdir8(pageDirectory, { recursive: true });
     const copiedDependencies = new Set;
     const pages = await Promise.all(options.artifact.pages.map((page) => copyClientPage(page, options.buildDirectory, staging, copiedDependencies)));
     const manifest = {
@@ -3596,9 +4164,9 @@ var materializeAbsoluteCapacitorWebBundle = async (options) => {
       runtime: options.artifact.runtime
     };
     await Promise.all([
-      writeFile8(join8(staging, MANIFEST_FILE), `${JSON.stringify(manifest, null, "\t")}
+      writeFile9(join9(staging, MANIFEST_FILE), `${JSON.stringify(manifest, null, "\t")}
 `),
-      writeFile8(join8(staging, INDEX_FILE), indexHtml(options.config.appName)),
+      writeFile9(join9(staging, INDEX_FILE), indexHtml(options.config.appName)),
       buildShellBootstrap(staging)
     ]);
     await installBundle(staging, destination);
@@ -3610,17 +4178,17 @@ var materializeAbsoluteCapacitorWebBundle = async (options) => {
 };
 
 // src/mobile/materializedBundle.ts
-import { createHash as createHash8 } from "crypto";
+import { createHash as createHash9 } from "crypto";
 import {
   access as access8,
-  mkdir as mkdir8,
+  mkdir as mkdir9,
   mkdtemp as mkdtemp5,
-  readFile as readFile11,
-  rename as rename9,
+  readFile as readFile12,
+  rename as rename10,
   rm as rm8,
-  writeFile as writeFile9
+  writeFile as writeFile10
 } from "fs/promises";
-import { dirname as dirname6, join as join9, resolve as resolvePath2 } from "path";
+import { dirname as dirname7, join as join10, resolve as resolvePath3 } from "path";
 import { pathToFileURL } from "url";
 var ABSOLUTE_MOBILE_MATERIALIZED_BUNDLE_FORMAT = 1;
 var CURRENT_BUNDLE_FILE = "current.json";
@@ -3634,7 +4202,7 @@ var bundleIdFor = (currentReleaseId, releases) => {
     currentReleaseId,
     releases: releases.map(({ releaseId }) => releaseId)
   });
-  return `amb_${createHash8("sha256").update(identity).digest("hex")}`;
+  return `amb_${createHash9("sha256").update(identity).digest("hex")}`;
 };
 var parseBundleIndex = (value) => {
   if (!isRecord7(value) || value.format !== ABSOLUTE_MOBILE_MATERIALIZED_BUNDLE_FORMAT || typeof value.bundleId !== "string" || !BUNDLE_ID_PATTERN.test(value.bundleId) || typeof value.currentReleaseId !== "string" || !Array.isArray(value.releases)) {
@@ -3660,17 +4228,17 @@ var parseBundleIndex = (value) => {
   };
 };
 var writeRelease = async (root, release) => {
-  const directory = join9(root, release.artifact.releaseId);
-  const producerPath = join9(directory, release.artifact.producer.module);
-  await mkdir8(dirname6(producerPath), { recursive: true });
+  const directory = join10(root, release.artifact.releaseId);
+  const producerPath = join10(directory, release.artifact.producer.module);
+  await mkdir9(dirname7(producerPath), { recursive: true });
   await Promise.all([
-    writeFile9(join9(directory, ARTIFACT_FILE2), `${JSON.stringify(release.artifact, null, "\t")}
+    writeFile10(join10(directory, ARTIFACT_FILE2), `${JSON.stringify(release.artifact, null, "\t")}
 `),
-    writeFile9(producerPath, new Uint8Array(await release.producer.arrayBuffer()))
+    writeFile10(producerPath, new Uint8Array(await release.producer.arrayBuffer()))
   ]);
 };
 var installImmutableBundle = async (bundlesRoot, bundleId, releases) => {
-  const destination = join9(bundlesRoot, bundleId);
+  const destination = join10(bundlesRoot, bundleId);
   try {
     await access8(destination);
     return destination;
@@ -3678,10 +4246,10 @@ var installImmutableBundle = async (bundlesRoot, bundleId, releases) => {
     if (!errorHasCode3(error, "ENOENT"))
       throw error;
   }
-  const staging = await mkdtemp5(join9(bundlesRoot, ".stage-"));
+  const staging = await mkdtemp5(join10(bundlesRoot, ".stage-"));
   try {
     await Promise.all(releases.map((release) => writeRelease(staging, release)));
-    await rename9(staging, destination);
+    await rename10(staging, destination);
   } catch (error) {
     await rm8(staging, { force: true, recursive: true });
     if (errorHasCode3(error, "EEXIST") || errorHasCode3(error, "ENOTEMPTY")) {
@@ -3711,16 +4279,16 @@ var resolveProducerHandler = (loaded, exportName) => {
   };
 };
 var loadAbsoluteMobileMaterializedBundle = async (root) => {
-  const resolvedRoot = resolvePath2(root);
-  const serialized = await readFile11(join9(resolvedRoot, CURRENT_BUNDLE_FILE), "utf8");
+  const resolvedRoot = resolvePath3(root);
+  const serialized = await readFile12(join10(resolvedRoot, CURRENT_BUNDLE_FILE), "utf8");
   const parsed = JSON.parse(serialized);
   const index = parseBundleIndex(parsed);
-  const bundleRoot = join9(resolvedRoot, BUNDLES_DIRECTORY, index.bundleId);
+  const bundleRoot = join10(resolvedRoot, BUNDLES_DIRECTORY, index.bundleId);
   return {
     artifacts: index.releases,
     currentReleaseId: index.currentReleaseId,
     loadProducer: async (artifact) => {
-      const modulePath = join9(bundleRoot, artifact.releaseId, artifact.producer.module);
+      const modulePath = join10(bundleRoot, artifact.releaseId, artifact.producer.module);
       await verifyAbsoluteMobileCompatibilityProducer({
         artifact,
         producer: Bun.file(modulePath)
@@ -3746,9 +4314,9 @@ var materializeAbsoluteMobileCompatibilityBundle = async (input) => {
     }
     return release;
   });
-  const root = resolvePath2(input.root);
-  const bundlesRoot = join9(root, BUNDLES_DIRECTORY);
-  await mkdir8(bundlesRoot, { recursive: true });
+  const root = resolvePath3(input.root);
+  const bundlesRoot = join10(root, BUNDLES_DIRECTORY);
+  await mkdir9(bundlesRoot, { recursive: true });
   const bundleId = bundleIdFor(input.currentReleaseId, artifacts);
   await installImmutableBundle(bundlesRoot, bundleId, orderedReleases);
   const index = {
@@ -3757,22 +4325,22 @@ var materializeAbsoluteMobileCompatibilityBundle = async (input) => {
     format: ABSOLUTE_MOBILE_MATERIALIZED_BUNDLE_FORMAT,
     releases: artifacts
   };
-  const pointerPath = join9(root, CURRENT_BUNDLE_FILE);
-  const temporaryPointerPath = join9(root, `.current-${crypto.randomUUID()}.json`);
-  await writeFile9(temporaryPointerPath, `${JSON.stringify(index, null, "\t")}
+  const pointerPath = join10(root, CURRENT_BUNDLE_FILE);
+  const temporaryPointerPath = join10(root, `.current-${crypto.randomUUID()}.json`);
+  await writeFile10(temporaryPointerPath, `${JSON.stringify(index, null, "\t")}
 `, { flag: "wx" });
-  await rename9(temporaryPointerPath, pointerPath);
+  await rename10(temporaryPointerPath, pointerPath);
   return index;
 };
 var readAbsoluteMobileMaterializedReleases = async (root) => {
-  const resolvedRoot = resolvePath2(root);
+  const resolvedRoot = resolvePath3(root);
   try {
-    const serialized = await readFile11(join9(resolvedRoot, CURRENT_BUNDLE_FILE), "utf8");
+    const serialized = await readFile12(join10(resolvedRoot, CURRENT_BUNDLE_FILE), "utf8");
     const parsed = JSON.parse(serialized);
     const index = parseBundleIndex(parsed);
-    const bundleRoot = join9(resolvedRoot, BUNDLES_DIRECTORY, index.bundleId);
+    const bundleRoot = join10(resolvedRoot, BUNDLES_DIRECTORY, index.bundleId);
     return Promise.all(index.releases.map(async (artifact) => {
-      const producer = Bun.file(join9(bundleRoot, artifact.releaseId, artifact.producer.module));
+      const producer = Bun.file(join10(bundleRoot, artifact.releaseId, artifact.producer.module));
       await verifyAbsoluteMobileCompatibilityProducer({
         artifact,
         producer
@@ -3823,9 +4391,9 @@ var loadServerApp = async (producerPath) => {
 var finalizeAbsoluteMobileCompatibilityBuild = async (options) => {
   const buildDirectory = resolve10(options.buildDirectory);
   const mobile = normalizeAbsoluteMobileConfig(options.mobile, options.projectRoot);
-  const root = join10(buildDirectory, ".absolutejs", "mobile-compatibility");
+  const root = join11(buildDirectory, ".absolutejs", "mobile-compatibility");
   const [manifestSource, previous] = await Promise.all([
-    readFile12(join10(buildDirectory, "manifest.json"), "utf8"),
+    readFile13(join11(buildDirectory, "manifest.json"), "utf8"),
     readAbsoluteMobileMaterializedReleases(root)
   ]);
   const manifest = JSON.parse(manifestSource);
@@ -3941,20 +4509,20 @@ var createAbsoluteMobileCompatibilityDispatcher = (options) => {
   }).as("global");
 };
 // src/mobile/nativeDeepLinks.ts
-import { readFile as readFile13, rename as rename10, writeFile as writeFile10 } from "fs/promises";
-import { join as join11 } from "path";
+import { readFile as readFile14, rename as rename11, writeFile as writeFile11 } from "fs/promises";
+import { join as join12 } from "path";
 var START_MARKER = "<!-- absolutejs:deep-links:start -->";
 var END_MARKER = "<!-- absolutejs:deep-links:end -->";
 var IOS_ENTITLEMENTS = "App/AbsoluteJS.entitlements";
 var NOT_FOUND = -1;
 var escapeXml = (value) => value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("'", "&apos;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
 var writeChangedFile = async (path, source) => {
-  const current = await readFile13(path, "utf8");
+  const current = await readFile14(path, "utf8");
   if (current === source)
     return false;
   const temporary = `${path}.${crypto.randomUUID()}.tmp`;
-  await writeFile10(temporary, source, { flag: "wx" });
-  await rename10(temporary, path);
+  await writeFile11(temporary, source, { flag: "wx" });
+  await rename11(temporary, path);
   return true;
 };
 var replaceManagedRegion = (source, region, insertAt) => {
@@ -3999,8 +4567,8 @@ ${hosts}
 `;
 };
 var configureAndroid = async (config) => {
-  const path = join11(config.nativeProjectDirectory, "android/app/src/main/AndroidManifest.xml");
-  const source = await readFile13(path, "utf8");
+  const path = join12(config.nativeProjectDirectory, "android/app/src/main/AndroidManifest.xml");
+  const source = await readFile14(path, "utf8");
   const mainActivity = source.indexOf('android:name=".MainActivity"');
   if (mainActivity === NOT_FOUND) {
     throw new TypeError("Android MainActivity was not found.");
@@ -4025,8 +4593,8 @@ var iosSchemeRegion = (scheme) => `	${START_MARKER}
 	${END_MARKER}
 `;
 var configureIosInfo = async (config) => {
-  const path = join11(config.nativeProjectDirectory, "ios/App/App/Info.plist");
-  const source = await readFile13(path, "utf8");
+  const path = join12(config.nativeProjectDirectory, "ios/App/App/Info.plist");
+  const source = await readFile14(path, "utf8");
   const region = config.deepLinkScheme ? iosSchemeRegion(config.deepLinkScheme) : `	${START_MARKER}
 	${END_MARKER}
 `;
@@ -4049,10 +4617,10 @@ ${domains}
 `;
 };
 var configureIosEntitlements = async (config) => {
-  const path = join11(config.nativeProjectDirectory, "ios/App/AbsoluteJS.entitlements");
+  const path = join12(config.nativeProjectDirectory, "ios/App/AbsoluteJS.entitlements");
   let current = "";
   try {
-    current = await readFile13(path, "utf8");
+    current = await readFile14(path, "utf8");
   } catch (error) {
     if (!(error instanceof Error) || !("code" in error) || error.code !== "ENOENT") {
       throw error;
@@ -4062,13 +4630,13 @@ var configureIosEntitlements = async (config) => {
   if (current === source)
     return false;
   const temporary = `${path}.${crypto.randomUUID()}.tmp`;
-  await writeFile10(temporary, source, { flag: "wx" });
-  await rename10(temporary, path);
+  await writeFile11(temporary, source, { flag: "wx" });
+  await rename11(temporary, path);
   return true;
 };
 var configureIosProject = async (config) => {
-  const path = join11(config.nativeProjectDirectory, "ios/App/App.xcodeproj/project.pbxproj");
-  const source = await readFile13(path, "utf8");
+  const path = join12(config.nativeProjectDirectory, "ios/App/App.xcodeproj/project.pbxproj");
+  const source = await readFile14(path, "utf8");
   const declarations = [
     ...source.matchAll(/CODE_SIGN_ENTITLEMENTS = ([^;]+);/g)
   ].map((match) => match[1]);
@@ -4107,7 +4675,7 @@ var applyAbsoluteNativeDeepLinks = async (config, platforms = config.platforms)
 };
 // src/mobile/releasePublisher.ts
 import { access as access9 } from "fs/promises";
-import { isAbsolute as isAbsolute5, relative as relative7, resolve as resolve11, sep as sep5 } from "path";
+import { isAbsolute as isAbsolute6, relative as relative8, resolve as resolve11, sep as sep6 } from "path";
 import { pathToFileURL as pathToFileURL3 } from "url";
 var prepareAbsoluteIosRelease = async (publisher, options) => {
   if (typeof publisher.prepareIosRelease !== "function") {
@@ -4135,8 +4703,8 @@ var isPublisher = (value) => isRecord8(value) && typeof value.publish === "funct
 var publisherModulePath = (projectRoot, requested) => {
   const root = resolve11(projectRoot);
   const path = resolve11(root, requested);
-  const projectRelative = relative7(root, path);
-  if (projectRelative === ".." || projectRelative.startsWith(`..${sep5}`) || isAbsolute5(projectRelative)) {
+  const projectRelative = relative8(root, path);
+  if (projectRelative === ".." || projectRelative.startsWith(`..${sep6}`) || isAbsolute6(projectRelative)) {
     throw new TypeError("mobile publish --registry must remain inside the project.");
   }
   return path;
@@ -4205,13 +4773,13 @@ var publishAbsoluteIosRelease = async (options) => {
 };
 // src/mobile/routeMetadataTransform.ts
 import { existsSync as existsSync3, readFileSync as readFileSync2 } from "fs";
-import { dirname as dirname7, extname as extname2, relative as relative8, resolve as resolve12 } from "path";
+import { dirname as dirname8, extname as extname2, relative as relative9, resolve as resolve12 } from "path";
 import ts from "typescript";
 var ROUTE_METHODS = new Set(["get", "head"]);
 var SOURCE_FILTER = /\.[cm]?[jt]sx?$/;
 var PAGE_HANDLER = "handleReactPageRequest";
 var posixPath = (value) => value.replace(/\\/g, "/");
-var findTsconfig = (entry, projectRoot) => ts.findConfigFile(dirname7(entry), existsSync3, "tsconfig.json") ?? ts.findConfigFile(projectRoot, existsSync3, "tsconfig.json");
+var findTsconfig = (entry, projectRoot) => ts.findConfigFile(dirname8(entry), existsSync3, "tsconfig.json") ?? ts.findConfigFile(projectRoot, existsSync3, "tsconfig.json");
 var createProgram = (entry, projectRoot) => {
   const configPath = findTsconfig(entry, projectRoot);
   if (!configPath) {
@@ -4223,7 +4791,7 @@ var createProgram = (entry, projectRoot) => {
       target: ts.ScriptTarget.ESNext
     });
   }
-  const parsed = ts.parseJsonConfigFileContent(ts.readConfigFile(configPath, (path) => readFileSync2(path, "utf8")).config, ts.sys, dirname7(configPath));
+  const parsed = ts.parseJsonConfigFileContent(ts.readConfigFile(configPath, (path) => readFileSync2(path, "utf8")).config, ts.sys, dirname8(configPath));
   if (!parsed.fileNames.includes(entry))
     parsed.fileNames.push(entry);
   return ts.createProgram(parsed.fileNames, parsed.options);
@@ -4329,7 +4897,7 @@ var resolvePageIdentity = (expression, sourceFile, checker, projectRoot) => {
   const declaration = symbol?.declarations?.[0];
   const file = declaration?.getSourceFile().fileName ?? sourceFile.fileName;
   const exportedName = symbol?.name ?? expression.getText(sourceFile);
-  const source = posixPath(relative8(projectRoot, file));
+  const source = posixPath(relative9(projectRoot, file));
   return `${source}#${exportedName}`;
 };
 var resolveAlias = (symbol, checker) => {
@@ -4543,7 +5111,7 @@ var inspectAbsoluteMobileRouteMetadata = (options) => {
   const entry = resolve12(options.entry);
   const analyzed = analyzeProgram(createProgram(entry, projectRoot), projectRoot);
   return [...analyzed.entries()].flatMap(([file, analysis]) => [...analysis.byRouteCall.values()].map(({ metadata }) => ({
-    file: posixPath(relative8(projectRoot, file)),
+    file: posixPath(relative9(projectRoot, file)),
     metadata
   })));
 };
@@ -4552,6 +5120,10 @@ export {
   waitForAbsoluteIosHmrLog,
   verifyAbsoluteMobileCompatibilityProducer,
   verifyAbsoluteMobileAssociationFiles,
+  validateAbsoluteSshDestination,
+  validateAbsoluteRemoteMacProfileName,
+  syncAbsoluteRemoteMacProject,
+  startAbsoluteRemoteIosDevSession,
   startAbsoluteIosDevSession,
   runWithAbsoluteMobileProducer,
   retainAbsoluteMobileCompatibilityArtifacts,
@@ -4559,6 +5131,7 @@ export {
   resolveAbsoluteMobileDeepLink,
   resolveAbsoluteMobileCompatibilityRelease,
   repairAbsoluteIosDevSession,
+  removeAbsoluteRemoteMacProfile,
   redactAbsoluteIosLog,
   readAbsoluteMobileMaterializedReleases,
   publishAbsoluteIosRelease,
@@ -4575,23 +5148,30 @@ export {
   parseAbsoluteMobileBuildPageMetadata,
   parseAbsoluteIosLogLine,
   parseAbsoluteIosHmrLog,
+  pairAbsoluteRemoteMac,
   normalizeAbsoluteMobileConfig,
   navigateAbsoluteMobilePage,
+  materializeAbsoluteRemoteMacAgent,
   materializeAbsoluteMobileCompatibilityBundle,
   materializeAbsoluteMobileAssociationFiles,
   materializeAbsoluteCapacitorWebBundle,
   matchesAbsoluteMobileRoutePattern,
   loadAbsoluteNativeReleasePublisher,
   loadAbsoluteMobileMaterializedBundle,
+  listAbsoluteRemoteMacProfiles,
   isAbsoluteIosNativeRootInput,
+  installAbsoluteRemoteMacAgent,
+  inspectAbsoluteRemoteMac,
   inspectAbsoluteMobileRouteMetadata,
   hashAbsoluteMobilePropsSchema,
   getCurrentAbsoluteMobileProducerContext,
+  getAbsoluteRemoteMacProfile,
   fingerprintAbsoluteIosNativeProject,
   fingerprintAbsoluteIosDevProject,
   finalizeAbsoluteMobilePage,
   finalizeAbsoluteMobileCompatibilityBuild,
   fetchAbsoluteMobilePage,
+  createAbsoluteRemoteIosDevProject,
   createAbsoluteMobileUpgradeResponse,
   createAbsoluteMobileRouteMetadataPlugin,
   createAbsoluteMobilePageRequest,
@@ -4612,10 +5192,14 @@ export {
   applyAbsoluteNativeDeepLinks,
   activateAbsoluteMobilePage,
   acceptsAbsoluteMobilePage,
+  absoluteRemoteProjectSyncCommands,
+  absoluteRemoteMacSshBase,
   MOBILE_PAGE_REQUEST_HEADERS,
   AbsoluteMobilePageProtocolError,
   APPLE_ASSOCIATION_PATH,
   ANDROID_ASSOCIATION_PATH,
+  ABSOLUTE_REMOTE_MAC_PROTOCOL_VERSION,
+  ABSOLUTE_REMOTE_MAC_EVENT_PREFIX,
   ABSOLUTE_MOBILE_TRANSFORM_PROTOCOL,
   ABSOLUTE_MOBILE_ROUTE_DETAIL,
   ABSOLUTE_MOBILE_RETAINED_GENERATIONS,
@@ -4629,5 +5213,5 @@ export {
   ABSOLUTE_ANDROID_RELEASE_FORMAT
 };
 
-//# debugId=048422942BB9C32864756E2164756E21
+//# debugId=5FE7B7589D1661C064756E2164756E21
 //# sourceMappingURL=index.js.map