react-native-webrtc-kaleidoscope 2.0.0 → 2.1.0

package/plugin/build/android/assets.js

@@ -0,0 +1,45 @@
+// @generated by `bun run build:plugin`; DO NOT EDIT THIS FILE.
+// Source of truth: plugin/src/. Edit the TypeScript there, then run
+// `bun run build:plugin` to regenerate this committed output.
+// Committed (not in dist/) because Expo loads the config plugin via
+// app.plugin.js -> ./plugin/build at prebuild time, including on EAS workers
+// where the library's dist/ and node_modules are absent.
+
+'use strict';
+var __importDefault =
+  (this && this.__importDefault) ||
+  function (mod) {
+    return mod && mod.__esModule ? mod : { default: mod };
+  };
+Object.defineProperty(exports, '__esModule', { value: true });
+exports.copyAndroidAssets = copyAndroidAssets;
+const node_path_1 = __importDefault(require('node:path'));
+const constants_1 = require('../lib/constants');
+const file_manipulation_1 = require('../lib/file-manipulation');
+const preset_book_1 = require('../lib/preset-book');
+/**
+ * Merge every referenced image AND composite thumbnail into the Android
+ * app's assets/images, so CompositeFactory and the picker resolve each by the
+ * same basename id JS sends. One flat dir; the `-thumb` suffix on thumbnails
+ * keeps the two families disjoint. Idempotent; non-fatal (returns quietly when
+ * the consumer declares no preset book).
+ */
+function copyAndroidAssets(projectRoot, platformProjectRoot) {
+  const assets = (0, preset_book_1.collectReferencedAssets)(projectRoot);
+  if (!assets) return;
+  const destDir = node_path_1.default.join(
+    platformProjectRoot,
+    'app',
+    'src',
+    'main',
+    'assets',
+    'images',
+  );
+  const images = (0, file_manipulation_1.copyRefs)(assets.images, destDir);
+  const thumbs = (0, file_manipulation_1.copyRefs)(assets.thumbs, destDir);
+  if (images.length + thumbs.length > 0) {
+    console.log(
+      `${constants_1.LOG_TAG} Copied ${images.length} image(s) and ${thumbs.length} thumbnail(s) into the Android bundle from ${preset_book_1.PRESET_BOOK_FILENAME}.`,
+    );
+  }
+}

package/plugin/build/android/index.js

@@ -0,0 +1,34 @@
+// @generated by `bun run build:plugin`; DO NOT EDIT THIS FILE.
+// Source of truth: plugin/src/. Edit the TypeScript there, then run
+// `bun run build:plugin` to regenerate this committed output.
+// Committed (not in dist/) because Expo loads the config plugin via
+// app.plugin.js -> ./plugin/build at prebuild time, including on EAS workers
+// where the library's dist/ and node_modules are absent.
+
+'use strict';
+Object.defineProperty(exports, '__esModule', { value: true });
+exports.withKaleidoscopeAndroid = withKaleidoscopeAndroid;
+const constants_1 = require('../lib/constants');
+const mods_1 = require('../lib/mods');
+const assets_1 = require('./assets');
+/**
+ * Android prebuild patch: copy every referenced image + composite
+ * thumbnail into the app bundle. Registered as a chained dangerous mod (see
+ * registerDangerousPatch). Non-fatal.
+ */
+function withKaleidoscopeAndroid(config) {
+  return (0, mods_1.registerDangerousPatch)(
+    config,
+    'android',
+    ({ projectRoot, platformProjectRoot }) => {
+      if (!(projectRoot && platformProjectRoot)) return;
+      try {
+        (0, assets_1.copyAndroidAssets)(projectRoot, platformProjectRoot);
+      } catch (error) {
+        console.warn(
+          `${constants_1.LOG_TAG} Could not copy resources into the Android bundle; bundled images/thumbnails may be missing at runtime. ${String(error)}`,
+        );
+      }
+    },
+  );
+}

package/plugin/build/index.js

@@ -0,0 +1,39 @@
+// @generated by `bun run build:plugin`; DO NOT EDIT THIS FILE.
+// Source of truth: plugin/src/. Edit the TypeScript there, then run
+// `bun run build:plugin` to regenerate this committed output.
+// Committed (not in dist/) because Expo loads the config plugin via
+// app.plugin.js -> ./plugin/build at prebuild time, including on EAS workers
+// where the library's dist/ and node_modules are absent.
+
+'use strict';
+// Expo config plugin (the prebuild precompiler) for react-native-webrtc-kaleidoscope.
+//
+// This is the TypeScript SOURCE. It is compiled offline to plugin/build/ (real
+// node16 CommonJS) by `bun run build:plugin`, and that compiled output is
+// COMMITTED to git. The repo-root app.plugin.js is a one-line shim that does
+// `module.exports = require('./plugin/build')`; Expo's plugin resolver loads it
+// with require() and unwraps the default export.
+//
+// WHY a committed compiled plugin, and why it touches nothing but Node builtins
+// at load time:
+//   Expo's plugin resolver hardcodes the entry filename to `app.plugin.js` and
+//   loads it with require() from the file's REAL path. The demo consumes this
+//   library via `file:..`, so on EAS the realpath is the repo root, where neither
+//   the library's node_modules NOR its (gitignored) dist/ is present. A committed
+//   plugin/build/ is the only output guaranteed to exist at that realpath. For the
+//   same reason, the patches register their mods by mutating `config.mods.<plat>`
+//   directly instead of importing `withDangerousMod` from @expo/config-plugins,
+//   and @expo/config-plugins is require()'d only LAZILY, resolved from the
+//   CONSUMER's node_modules at mod-execution time (see ios-assets.ts), where it is
+//   installed. The result loads identically from a published tarball, the
+//   symlinked demo, and the EAS worker.
+//
+// The native frame-processor registration itself happens via the Expo Module's
+// OnCreate hook (KaleidoscopeModule.{kt,swift}), not here. This plugin's job is
+// the iOS Podfile / deployment-target patches and the curated asset copy.
+Object.defineProperty(exports, '__esModule', { value: true });
+const android_1 = require('./android');
+const ios_1 = require('./ios');
+const withKaleidoscope = (config) =>
+  (0, ios_1.withKaleidoscopeIos)((0, android_1.withKaleidoscopeAndroid)(config));
+exports.default = withKaleidoscope;

package/plugin/build/ios/assets.js

@@ -0,0 +1,110 @@
+// @generated by `bun run build:plugin`; DO NOT EDIT THIS FILE.
+// Source of truth: plugin/src/. Edit the TypeScript there, then run
+// `bun run build:plugin` to regenerate this committed output.
+// Committed (not in dist/) because Expo loads the config plugin via
+// app.plugin.js -> ./plugin/build at prebuild time, including on EAS workers
+// where the library's dist/ and node_modules are absent.
+
+'use strict';
+var __importDefault =
+  (this && this.__importDefault) ||
+  function (mod) {
+    return mod && mod.__esModule ? mod : { default: mod };
+  };
+Object.defineProperty(exports, '__esModule', { value: true });
+exports.copyIosAssets = copyIosAssets;
+const node_fs_1 = __importDefault(require('node:fs'));
+const node_path_1 = __importDefault(require('node:path'));
+const constants_1 = require('../lib/constants');
+const file_manipulation_1 = require('../lib/file-manipulation');
+const preset_book_1 = require('../lib/preset-book');
+// Lazy-resolve @expo/config-plugins' XcodeUtils from the CONSUMER. A top-level
+// import would throw module-not-found on an EAS worker, where this plugin loads
+// from a realpath with no node_modules (see ios/index.ts). Returns null (warn) on
+// failure so the caller bails non-fatally.
+function loadXcodeUtils(projectRoot) {
+  try {
+    const configPlugins = require(
+      require.resolve('@expo/config-plugins', { paths: [projectRoot] }),
+    );
+    return configPlugins.IOSConfig.XcodeUtils;
+  } catch (error) {
+    console.warn(
+      `${constants_1.LOG_TAG} Could not load @expo/config-plugins to register iOS resources; bundled images/thumbnails may be missing at runtime. ${String(error)}`,
+    );
+    return null;
+  }
+}
+// The app-target name is the `<name>.xcodeproj` basename under the iOS project
+// root. Returns null (warn) when it isn't there yet.
+function findProjectName(platformProjectRoot) {
+  try {
+    const xcodeprojDir = node_fs_1.default
+      .readdirSync(platformProjectRoot)
+      .find((entry) => entry.endsWith('.xcodeproj'));
+    if (!xcodeprojDir) {
+      console.warn(
+        `${constants_1.LOG_TAG} No .xcodeproj under the iOS project root yet; skipping iOS resource registration.`,
+      );
+      return null;
+    }
+    return xcodeprojDir.replace(/\.xcodeproj$/, '');
+  } catch (error) {
+    console.warn(
+      `${constants_1.LOG_TAG} Could not locate the iOS .xcodeproj; skipping iOS resource registration. ${String(error)}`,
+    );
+    return null;
+  }
+}
+/**
+ * Copy every referenced image AND composite thumbnail into the iOS app
+ * target's resources, then register each in the pbxproj's Copy Bundle Resources
+ * phase so the WebP ships in the .app. Xcode flattens resource refs into the
+ * bundle root, so each lands as `<id>.webp` in Bundle.main; CompositeProcessor and
+ * the picker resolve by that basename. Idempotent; non-fatal (warn, never throw).
+ */
+function copyIosAssets(projectRoot, platformProjectRoot) {
+  const assets = (0, preset_book_1.collectReferencedAssets)(projectRoot);
+  if (!assets) return;
+  const refs = [...assets.images, ...assets.thumbs];
+  if (refs.length === 0) return;
+  const xcodeUtils = loadXcodeUtils(projectRoot);
+  if (!xcodeUtils) return;
+  const projectName = findProjectName(platformProjectRoot);
+  if (!projectName) return;
+  const copiedIds = (0, file_manipulation_1.copyRefs)(
+    refs,
+    node_path_1.default.join(platformProjectRoot, projectName),
+  );
+  if (copiedIds.length === 0) {
+    console.warn(
+      `${constants_1.LOG_TAG} No iOS resources resolved; skipping pbxproj resource registration.`,
+    );
+    return;
+  }
+  let project;
+  try {
+    project = xcodeUtils.getPbxproj(projectRoot);
+  } catch (error) {
+    console.warn(
+      `${constants_1.LOG_TAG} Could not read the iOS pbxproj to register resources; bundled images/thumbnails may be missing at runtime. ${String(error)}`,
+    );
+    return;
+  }
+  for (const id of copiedIds) {
+    xcodeUtils.addResourceFileToGroup({
+      filepath: `${projectName}/${id}.webp`,
+      groupName: projectName,
+      isBuildFile: true,
+      project,
+      verbose: false,
+    });
+  }
+  node_fs_1.default.writeFileSync(
+    node_path_1.default.join(platformProjectRoot, `${projectName}.xcodeproj`, 'project.pbxproj'),
+    project.writeSync(),
+  );
+  console.log(
+    `${constants_1.LOG_TAG} Bundled ${copiedIds.length} resource(s) into the iOS app target from ${preset_book_1.PRESET_BOOK_FILENAME}.`,
+  );
+}

package/plugin/build/ios/deployment-target.js

@@ -0,0 +1,105 @@
+// @generated by `bun run build:plugin`; DO NOT EDIT THIS FILE.
+// Source of truth: plugin/src/. Edit the TypeScript there, then run
+// `bun run build:plugin` to regenerate this committed output.
+// Committed (not in dist/) because Expo loads the config plugin via
+// app.plugin.js -> ./plugin/build at prebuild time, including on EAS workers
+// where the library's dist/ and node_modules are absent.
+
+'use strict';
+var __importDefault =
+  (this && this.__importDefault) ||
+  function (mod) {
+    return mod && mod.__esModule ? mod : { default: mod };
+  };
+Object.defineProperty(exports, '__esModule', { value: true });
+exports.bumpDeploymentTarget = bumpDeploymentTarget;
+const node_fs_1 = __importDefault(require('node:fs'));
+const node_path_1 = __importDefault(require('node:path'));
+const constants_1 = require('../lib/constants');
+// Mirrors ios/Kaleidoscope.podspec :ios => '15.0'. Bumping the podspec requires
+// bumping this constant; the drift cost is a silent pod-install drop (the bug
+// this plugin fixes): expo-modules-autolinking drops any pod whose declared
+// minimum platform exceeds the Podfile platform.
+const IOS_DEPLOYMENT_TARGET = '15.0';
+/**
+ * Compare two dotted version strings element-wise. Returns true iff `existing`
+ * is strictly less than `target`. Missing/empty existing counts as "less than".
+ * No `semver` dependency, so this file stays loadable on an EAS worker with no
+ * node_modules; the iOS deployment target is a plain dotted version like '15.0'.
+ */
+function isVersionLessThan(existing, target) {
+  if (typeof existing !== 'string' || existing.length === 0) return true;
+  const toParts = (s) => s.split('.').map((part) => Number(part) || 0);
+  const a = toParts(existing);
+  const b = toParts(target);
+  const max = Math.max(a.length, b.length);
+  for (let i = 0; i < max; i += 1) {
+    const av = a[i] ?? 0;
+    const bv = b[i] ?? 0;
+    if (av < bv) return true;
+    if (av > bv) return false;
+  }
+  return false; // equal
+}
+/**
+ * Raise `ios.deploymentTarget` in Podfile.properties.json to the library
+ * minimum. The generated Podfile reads `podfile_properties['ios.deploymentTarget']`
+ * at the top, so this is the canonical, no-Podfile-edit override seam. Without
+ * this bump the Kaleidoscope pod is silently dropped and the runtime module
+ * lookup throws. Non-downgrading, idempotent, non-fatal (warn, never throw).
+ *
+ * Reads the file by hand (not readTextOrNull) because it must DISTINGUISH a
+ * missing file (treat as `{}` and write the bump) from an unreadable one (bail
+ * without clobbering); a distinction readTextOrNull deliberately flattens.
+ */
+function bumpDeploymentTarget(platformProjectRoot) {
+  const propsPath = node_path_1.default.join(platformProjectRoot, 'Podfile.properties.json');
+  try {
+    let parsed = {};
+    try {
+      const raw = node_fs_1.default.readFileSync(propsPath, 'utf8');
+      try {
+        const candidate = JSON.parse(raw);
+        if (candidate && typeof candidate === 'object' && !Array.isArray(candidate)) {
+          parsed = candidate;
+        }
+      } catch (jsonError) {
+        // Corrupt JSON: warn but proceed with `{}` so the build still gets the
+        // bump it needs. The next prebuild fully regenerates the file anyway.
+        console.warn(
+          `${constants_1.LOG_TAG} Could not parse ${propsPath}; rewriting with defaults. ${String(jsonError)}`,
+        );
+        parsed = {};
+      }
+    } catch (readError) {
+      const code = readError?.code;
+      if (code === 'ENOENT') {
+        parsed = {};
+      } else {
+        // Transient I/O failure (EACCES, EISDIR, ...). Don't clobber the file
+        // when we could not actually read it; warn and skip the bump.
+        console.warn(
+          `${constants_1.LOG_TAG} Could not read ${propsPath}; skipping iOS deployment-target bump. ${String(readError)}`,
+        );
+        return;
+      }
+    }
+    // Explicit own-key copy into a fresh object to foreclose
+    // `__proto__`-as-literal-key surprises from JSON.parse.
+    const next = {};
+    for (const key of Object.keys(parsed)) {
+      next[key] = parsed[key];
+    }
+    const existing = next['ios.deploymentTarget'];
+    if (
+      isVersionLessThan(typeof existing === 'string' ? existing : undefined, IOS_DEPLOYMENT_TARGET)
+    ) {
+      next['ios.deploymentTarget'] = IOS_DEPLOYMENT_TARGET;
+    }
+    node_fs_1.default.writeFileSync(propsPath, `${JSON.stringify(next, null, 2)}\n`);
+  } catch (error) {
+    console.warn(
+      `${constants_1.LOG_TAG} Could not patch ${propsPath} to raise iOS deployment target; add "ios.deploymentTarget": "${IOS_DEPLOYMENT_TARGET}" to Podfile.properties.json manually. ${String(error)}`,
+    );
+  }
+}

package/plugin/build/ios/index.js

@@ -0,0 +1,63 @@
+// @generated by `bun run build:plugin`; DO NOT EDIT THIS FILE.
+// Source of truth: plugin/src/. Edit the TypeScript there, then run
+// `bun run build:plugin` to regenerate this committed output.
+// Committed (not in dist/) because Expo loads the config plugin via
+// app.plugin.js -> ./plugin/build at prebuild time, including on EAS workers
+// where the library's dist/ and node_modules are absent.
+
+'use strict';
+var __importDefault =
+  (this && this.__importDefault) ||
+  function (mod) {
+    return mod && mod.__esModule ? mod : { default: mod };
+  };
+Object.defineProperty(exports, '__esModule', { value: true });
+exports.withKaleidoscopeIos = withKaleidoscopeIos;
+const node_fs_1 = __importDefault(require('node:fs'));
+const node_path_1 = __importDefault(require('node:path'));
+const constants_1 = require('../lib/constants');
+const mods_1 = require('../lib/mods');
+const assets_1 = require('./assets');
+const deployment_target_1 = require('./deployment-target');
+const pods_1 = require('./pods');
+/**
+ * iOS prebuild patches, registered as a chained dangerous mod (see
+ * registerDangerousPatch). All idempotent and non-fatal:
+ *   1. declare react-native-webrtc with `:modular_headers => true` in the Podfile,
+ *   2. raise ios.deploymentTarget so autolinking doesn't drop the pod,
+ *   3. copy every referenced image + composite thumbnail into the app target.
+ */
+function withKaleidoscopeIos(config) {
+  return (0, mods_1.registerDangerousPatch)(
+    config,
+    'ios',
+    ({ projectRoot, platformProjectRoot }) => {
+      const pod = (0, pods_1.resolveWebrtcPod)(projectRoot);
+      if (platformProjectRoot && pod) {
+        // Read and write are guarded together: a failure of either falls back to a
+        // logged manual instruction rather than throwing out of prebuild.
+        const podfilePath = node_path_1.default.join(platformProjectRoot, 'Podfile');
+        try {
+          const original = node_fs_1.default.readFileSync(podfilePath, 'utf8');
+          const patched = (0, pods_1.patchPodfile)(original, pod);
+          if (patched !== original) node_fs_1.default.writeFileSync(podfilePath, patched);
+        } catch (error) {
+          const manualLine = `pod '${pod.podName}', :path => '../node_modules/${pod.packageDir}', :modular_headers => true`;
+          console.warn(
+            `${constants_1.LOG_TAG} Could not patch the Podfile to build ${pod.podName} with modular headers; add "${manualLine}" inside your app target manually. ${String(error)}`,
+          );
+        }
+      }
+      if (platformProjectRoot) (0, deployment_target_1.bumpDeploymentTarget)(platformProjectRoot);
+      if (projectRoot && platformProjectRoot) {
+        try {
+          (0, assets_1.copyIosAssets)(projectRoot, platformProjectRoot);
+        } catch (error) {
+          console.warn(
+            `${constants_1.LOG_TAG} Could not bundle resources into the iOS app target; bundled images/thumbnails may be missing at runtime. ${String(error)}`,
+          );
+        }
+      }
+    },
+  );
+}

package/plugin/build/ios/pods.js

@@ -0,0 +1,73 @@
+// @generated by `bun run build:plugin`; DO NOT EDIT THIS FILE.
+// Source of truth: plugin/src/. Edit the TypeScript there, then run
+// `bun run build:plugin` to regenerate this committed output.
+// Committed (not in dist/) because Expo loads the config plugin via
+// app.plugin.js -> ./plugin/build at prebuild time, including on EAS workers
+// where the library's dist/ and node_modules are absent.
+
+'use strict';
+var __importDefault =
+  (this && this.__importDefault) ||
+  function (mod) {
+    return mod && mod.__esModule ? mod : { default: mod };
+  };
+Object.defineProperty(exports, '__esModule', { value: true });
+exports.resolveWebrtcPod = resolveWebrtcPod;
+exports.patchPodfile = patchPodfile;
+const node_fs_1 = __importDefault(require('node:fs'));
+const node_path_1 = __importDefault(require('node:path'));
+// A sentinel comment lets us find our own injection on re-prebuilds and stay
+// idempotent regardless of how Expo regenerates the surrounding Podfile.
+const SENTINEL = '# react-native-webrtc-kaleidoscope: modular headers (managed)';
+/**
+ * Resolve which react-native-webrtc fork the consumer installed, and return its
+ * CocoaPods pod name + npm package directory (used to build the `:path` for the
+ * Podfile declaration). Two forks ship the same surface under different names
+ * (mirrors the dual probe in android/build.gradle):
+ *   - @livekit/react-native-webrtc -> pod `livekit-react-native-webrtc`
+ *   - react-native-webrtc          -> pod `react-native-webrtc`
+ * Prefer the fork when both are present, matching the Swift import order. We
+ * return null (and skip patching) when neither is found, since declaring a pod
+ * for an uninstalled package would break `pod install`.
+ */
+function resolveWebrtcPod(projectRoot) {
+  if (!projectRoot) {
+    return { podName: 'react-native-webrtc', packageDir: 'react-native-webrtc' };
+  }
+  const fork = node_path_1.default.join(
+    projectRoot,
+    'node_modules',
+    '@livekit',
+    'react-native-webrtc',
+  );
+  const upstream = node_path_1.default.join(projectRoot, 'node_modules', 'react-native-webrtc');
+  if (node_fs_1.default.existsSync(fork)) {
+    return { podName: 'livekit-react-native-webrtc', packageDir: '@livekit/react-native-webrtc' };
+  }
+  if (node_fs_1.default.existsSync(upstream)) {
+    return { podName: 'react-native-webrtc', packageDir: 'react-native-webrtc' };
+  }
+  return null;
+}
+/**
+ * Ensure the Podfile builds the resolved react-native-webrtc pod with modular
+ * headers so our Swift can `import` it as a Clang module. Declares with an
+ * explicit `:path` (instead of a bare `pod 'name'`) so the build works even when
+ * RN autolinking does not register the pod for us. Idempotent: running prebuild
+ * twice neither duplicates the line nor corrupts the Podfile.
+ */
+function patchPodfile(contents, pod) {
+  if (contents.includes(SENTINEL)) return contents;
+  const block = `${SENTINEL}\n  pod '${pod.podName}', :path => '../node_modules/${pod.packageDir}', :modular_headers => true`;
+  const lines = contents.split('\n');
+  // Insert just inside the first `target ... do` block so the per-pod
+  // declaration sits in the same scope as the autolinked React Native pods.
+  const targetIndex = lines.findIndex((line) => /^\s*target\s+['"].*['"]\s+do\b/.test(line));
+  if (targetIndex !== -1) {
+    lines.splice(targetIndex + 1, 0, block);
+    return lines.join('\n');
+  }
+  // No `target` block found (unexpected for an Expo-generated Podfile); append
+  // the declaration so the build requirement is at least present.
+  return `${contents.trimEnd()}\n${block}\n`;
+}

package/plugin/build/lib/constants.js

@@ -0,0 +1,15 @@
+// @generated by `bun run build:plugin`; DO NOT EDIT THIS FILE.
+// Source of truth: plugin/src/. Edit the TypeScript there, then run
+// `bun run build:plugin` to regenerate this committed output.
+// Committed (not in dist/) because Expo loads the config plugin via
+// app.plugin.js -> ./plugin/build at prebuild time, including on EAS workers
+// where the library's dist/ and node_modules are absent.
+
+'use strict';
+// Self-contained on purpose: this plugin must not import from the library's
+// src/ (which Metro compiles for the app), because the plugin compiles to its
+// own committed plugin/build and loads on an EAS worker with no library dist.
+Object.defineProperty(exports, '__esModule', { value: true });
+exports.LOG_TAG = void 0;
+/** Prefix on every log/warn line the prebuild plugin emits. */
+exports.LOG_TAG = '[*ੈ✩‧₊˚  react-native-webrtc-kaleidoscope *ੈ✩‧₊˚]';

package/plugin/build/lib/file-manipulation.js

@@ -0,0 +1,57 @@
+// @generated by `bun run build:plugin`; DO NOT EDIT THIS FILE.
+// Source of truth: plugin/src/. Edit the TypeScript there, then run
+// `bun run build:plugin` to regenerate this committed output.
+// Committed (not in dist/) because Expo loads the config plugin via
+// app.plugin.js -> ./plugin/build at prebuild time, including on EAS workers
+// where the library's dist/ and node_modules are absent.
+
+'use strict';
+var __importDefault =
+  (this && this.__importDefault) ||
+  function (mod) {
+    return mod && mod.__esModule ? mod : { default: mod };
+  };
+Object.defineProperty(exports, '__esModule', { value: true });
+exports.readTextOrNull = readTextOrNull;
+exports.copyRefs = copyRefs;
+const node_fs_1 = __importDefault(require('node:fs'));
+const node_path_1 = __importDefault(require('node:path'));
+const constants_1 = require('./constants');
+// Rudimentary, domain-agnostic filesystem tools shared by both platforms' asset
+// copy. These know nothing about presets, layers, or Xcode; they are the "safe"
+// (non-throwing) file primitives the platform modules build on.
+/** Read a UTF-8 text file, returning null on ANY error (missing or unreadable). */
+function readTextOrNull(filePath) {
+  try {
+    return node_fs_1.default.readFileSync(filePath, 'utf8');
+  } catch {
+    return null;
+  }
+}
+/**
+ * Copy each resolvable ref into `destDir` as `<id>.webp`, returning the ids
+ * copied. `mkdir`s the destination, warns (never throws) on an unresolvable ref,
+ * and skips it. The single mover both platforms call; the platform difference (
+ * Android merges into `assets/`, iOS copies into the app target and registers in
+ * the pbxproj) lives in the platform asset modules, not here.
+ */
+function copyRefs(refs, destDir) {
+  if (refs.length === 0) return [];
+  node_fs_1.default.mkdirSync(destDir, { recursive: true });
+  const copied = [];
+  for (const ref of refs) {
+    if (!ref.srcPath) {
+      const spec = ref.specifier ? ` (${ref.specifier})` : '';
+      console.warn(
+        `${constants_1.LOG_TAG} Could not resolve image source for '${ref.id}'${spec}; skipping. Asset references must be statically resolvable.`,
+      );
+      continue;
+    }
+    node_fs_1.default.copyFileSync(
+      ref.srcPath,
+      node_path_1.default.join(destDir, `${ref.id}.webp`),
+    );
+    copied.push(ref.id);
+  }
+  return copied;
+}

package/plugin/build/lib/mods.js

@@ -0,0 +1,36 @@
+// @generated by `bun run build:plugin`; DO NOT EDIT THIS FILE.
+// Source of truth: plugin/src/. Edit the TypeScript there, then run
+// `bun run build:plugin` to regenerate this committed output.
+// Committed (not in dist/) because Expo loads the config plugin via
+// app.plugin.js -> ./plugin/build at prebuild time, including on EAS workers
+// where the library's dist/ and node_modules are absent.
+
+'use strict';
+Object.defineProperty(exports, '__esModule', { value: true });
+exports.registerDangerousPatch = registerDangerousPatch;
+/**
+ * Register a platform "dangerous" mod by mutating `config.mods` DIRECTLY, instead
+ * of @expo/config-plugins' `withDangerousMod` (which we cannot import at load time
+ * on an EAS worker; see index.ts). This owns the subtle, load-bearing contract in
+ * ONE place so the per-platform mods cannot drift from it:
+ *   - initialize `config.mods` / `config.mods[platform]`,
+ *   - CHAIN any previously registered dangerous mod (run it first, cooperate),
+ *   - run `patch` with the resolved mod request,
+ *   - return `result` (the chained mod's config), which is what Expo's dangerous
+ *     base provider asserts on, NOT the original `config`.
+ *
+ * `patch` decides its own guards (which fields of the request it needs) and is
+ * responsible for being non-fatal; the wrapper never throws on its behalf.
+ */
+function registerDangerousPatch(config, platform, patch) {
+  config.mods ??= {};
+  const platformMods = config.mods[platform] ?? {};
+  config.mods[platform] = platformMods;
+  const previous = platformMods.dangerous;
+  platformMods.dangerous = async (modConfig) => {
+    const result = typeof previous === 'function' ? await previous(modConfig) : modConfig;
+    await patch(result.modRequest ?? {});
+    return result;
+  };
+  return config;
+}