@appsent-co/react-native-watchos 0.1.0

package/plugin/src/withWatchAutolinking.js

@@ -0,0 +1,106 @@
+// @ts-check
+const fs = require('fs');
+const path = require('path');
+const { withDangerousMod } = require('@expo/config-plugins');
+
+// Stamped at the top of every generated `pods.rb` so we can recognize and
+// safely overwrite our own output on the next prebuild. A user who hand-edits
+// `targets/<name>/pods.rb` (removing the marker) is left alone.
+const MARKER =
+  '# [RNW-AUTOLINK] Auto-generated by @appsent-co/react-native-watchos.';
+
+/**
+ * Writes a `targets/<targetName>/pods.rb` file that:
+ *   1. Sets `platform :watchos, <deploymentTarget>` for the target.
+ *   2. Requires `cocoapods/autolink.rb` from the npm-installed
+ *      `@appsent-co/react-native-watchos` package.
+ *   3. Calls `use_watchos_modules!` so every third-party RN module whose
+ *      podspec declares `:watchos =>` gets linked into the watch target.
+ *
+ * The Podfile that `@bacons/apple-targets` injects already auto-loads every
+ * `targets/<name>/pods.rb` inside a matching `target '<name>' do ... end`
+ * block (see the `apple-targets-extension-loader` glob at the bottom of the
+ * generated Podfile), so we don't need to touch the Podfile itself.
+ *
+ * Bare-RN consumers (no Expo prebuild) skip this plugin entirely and hand-
+ * write the equivalent block in their own Podfile.
+ *
+ * @typedef {object} Opts
+ * @property {string} targetName - Watch target name; matches the
+ *   `targets/<targetName>/` directory.
+ * @property {string} [watchosDeploymentTarget] - Minimum watchOS version.
+ *   Defaults to `"9.0"`, matching `WATCHOS_DEPLOYMENT_TARGET` in
+ *   `scripts/build-xcframework.sh`.
+ *
+ * @param {import('@expo/config-plugins').ExpoConfig} config
+ * @param {Opts} opts
+ */
+const withWatchAutolinking = (
+  config,
+  { targetName, watchosDeploymentTarget }
+) => {
+  return withDangerousMod(config, [
+    'ios',
+    (cfg) => {
+      const projectRoot = cfg.modRequest.projectRoot;
+      const targetDir = path.join(projectRoot, 'targets', targetName);
+      if (!fs.existsSync(targetDir)) {
+        // No matching target dir — apple-targets hasn't been set up, or the
+        // user gave a wrong targetName. Other plugins in the chain will surface
+        // a clearer error; silently skip here.
+        return cfg;
+      }
+
+      // Resolve the absolute path to our shipped Ruby helper, then compute
+      // a path relative to the generated `pods.rb` so the file is portable
+      // across machines / pnpm-symlinked node_modules layouts.
+      const pkgJsonPath = require.resolve(
+        '@appsent-co/react-native-watchos/package.json',
+        {
+          paths: [projectRoot],
+        }
+      );
+      const pkgDir = path.dirname(pkgJsonPath);
+      const helperAbs = path.join(pkgDir, 'cocoapods', 'autolink.rb');
+      const helperRel = path.relative(targetDir, helperAbs);
+
+      const deploymentTarget = watchosDeploymentTarget || '9.0';
+
+      // Reuse the iOS Podfile's resolver (Expo's autolinker, with a
+      // community-CLI fallback gated by EXPO_USE_COMMUNITY_AUTOLINKING) so
+      // both targets see byte-identical podspec paths. pnpm symlinks can
+      // otherwise route the two invocations to different physical paths
+      // and CocoaPods will reject the duplicate.
+      const contents = [
+        MARKER,
+        '# Re-run `expo prebuild` to regenerate.',
+        '',
+        `platform :watchos, '${deploymentTarget}'`,
+        '',
+        `require_relative File.join(__dir__, '${helperRel}')`,
+        '',
+        "if ENV['EXPO_USE_COMMUNITY_AUTOLINKING'] == '1'",
+        "  config_command = ['node', '-e', \"process.argv=['', '', 'config'];require('@react-native-community/cli').run()\"]",
+        'else',
+        "  config_command = ['node', '--no-warnings', '--eval', \"require('expo/bin/autolinking')\", 'expo-modules-autolinking', 'react-native-config', '--json', '--platform', 'ios']",
+        'end',
+        '',
+        'use_watchos_modules!(:config_command => config_command)',
+        '',
+      ].join('\n');
+
+      const podsRbPath = path.join(targetDir, 'pods.rb');
+      if (fs.existsSync(podsRbPath)) {
+        const existing = fs.readFileSync(podsRbPath, 'utf8');
+        if (!existing.startsWith(MARKER)) {
+          // User has a hand-managed pods.rb; leave it alone.
+          return cfg;
+        }
+      }
+      fs.writeFileSync(podsRbPath, contents);
+      return cfg;
+    },
+  ]);
+};
+
+module.exports = withWatchAutolinking;

package/plugin/src/withWatchBundleScript.js

@@ -0,0 +1,216 @@
+// @ts-check
+const fs = require('fs');
+const path = require('path');
+const { withFinalizedMod } = require('@expo/config-plugins');
+
+const PHASE_NAME = '[RNW] Bundle React Native (watchOS)';
+
+/**
+ * Adds a Run Script Build Phase to the watch target that, in Release
+ * builds, invokes `expo export:embed --platform watchos` to produce a
+ * minified JS bundle and writes it into the watch app's resources
+ * (`Bundle.main`). In Debug builds the script no-ops so the dev-server
+ * flow remains untouched.
+ *
+ * Registered as a `finalized` mod so it runs after @bacons/apple-targets
+ * has created the watch target. Pbxproj is read / parsed / mutated /
+ * written directly using the `xcode` library (a transitive of
+ * `@expo/config-plugins`).
+ *
+ * @typedef {object} Opts
+ * @property {string} targetName - Watch target name in pbxproj.
+ * @property {string} [bundleName] - Output filename without extension.
+ *   Defaults to `"main"` (→ `main.jsbundle`).
+ * @property {string} [entryFile] - Path (relative to project root) of the
+ *   JS entry. Defaults to auto-detecting `index.watchos.{tsx,ts,jsx,js}`.
+ *   Required because `expo export:embed` resolves the entry from
+ *   `package.json#main` and doesn't apply platform-suffix resolution at
+ *   the entry-file level, so without an override it would bundle the iOS
+ *   `index.js` (which pulls in `react-native` and crashes on
+ *   `__fbBatchedBridgeConfig is not set`).
+ *
+ * @param {import('@expo/config-plugins').ExpoConfig} config
+ * @param {Opts} opts
+ */
+const withWatchBundleScript = (
+  config,
+  { targetName, bundleName = 'main', entryFile }
+) => {
+  return withFinalizedMod(config, [
+    'ios',
+    async (cfg) => {
+      const platformRoot = cfg.modRequest.platformProjectRoot;
+      const pbxprojPath = findPbxproj(platformRoot);
+
+      const xcode = require('xcode');
+      const project = xcode.project(pbxprojPath);
+      await new Promise((resolve, reject) => {
+        project.parse((err) => (err ? reject(err) : resolve()));
+      });
+
+      const objects = project.hash.project.objects;
+
+      // -------------------------------------------------------------
+      // Find the watch target by name
+      // -------------------------------------------------------------
+      const nativeTargets = objects.PBXNativeTarget || {};
+      let targetKey = null;
+      for (const key of Object.keys(nativeTargets)) {
+        if (key.endsWith('_comment')) continue;
+        if (stripQuotes(nativeTargets[key].name) === targetName) {
+          targetKey = key;
+          break;
+        }
+      }
+      if (!targetKey) {
+        const available = Object.keys(nativeTargets)
+          .filter((k) => !k.endsWith('_comment'))
+          .map((k) => stripQuotes(nativeTargets[k].name));
+        throw new Error(
+          `[@appsent-co/react-native-watchos] Target "${targetName}" not found in pbxproj. ` +
+            `Available: [${available.join(', ')}].`
+        );
+      }
+      const target = nativeTargets[targetKey];
+
+      // -------------------------------------------------------------
+      // Idempotency: bail if our phase is already there. Re-running
+      // `expo prebuild` without --clean must not duplicate the phase.
+      // -------------------------------------------------------------
+      const shellPhases = objects.PBXShellScriptBuildPhase || {};
+      for (const phaseRef of target.buildPhases || []) {
+        const existing = shellPhases[phaseRef.value];
+        if (existing && stripQuotes(existing.name || '') === PHASE_NAME) {
+          fs.writeFileSync(pbxprojPath, project.writeSync());
+          return cfg;
+        }
+      }
+
+      // -------------------------------------------------------------
+      // Shell script body. Skips Debug (dev server handles those),
+      // cd's from $PROJECT_DIR (ios/) to the project root (where
+      // package.json + metro.config.js live), and writes the bundle
+      // straight into the .app's resource folder.
+      //
+      // Xcode launches build phases with a minimal PATH that excludes
+      // Homebrew/nvm. Source `.xcode.env(.local)` (the standard RN
+      // convention) for NODE_BINARY, then prepend its directory to
+      // PATH so the `npx` shim next to `node` is reachable.
+      // -------------------------------------------------------------
+      const scriptBody = [
+        'set -e',
+        'if [ "$CONFIGURATION" = "Debug" ]; then',
+        '  echo "@appsent-co/react-native-watchos: skipping JS bundle for Debug"',
+        '  exit 0',
+        'fi',
+        'if [ -f "$PROJECT_DIR/.xcode.env" ]; then',
+        '  . "$PROJECT_DIR/.xcode.env"',
+        'fi',
+        'if [ -f "$PROJECT_DIR/.xcode.env.local" ]; then',
+        '  . "$PROJECT_DIR/.xcode.env.local"',
+        'fi',
+        'if [ -z "$NODE_BINARY" ]; then',
+        '  NODE_BINARY="$(command -v node || true)"',
+        'fi',
+        'if [ -z "$NODE_BINARY" ]; then',
+        '  echo "error: NODE_BINARY not set and \\`node\\` not on PATH. ' +
+          'Set NODE_BINARY in ios/.xcode.env(.local)." >&2',
+        '  exit 1',
+        'fi',
+        'export PATH="$(dirname "$NODE_BINARY"):$PATH"',
+        'cd "$PROJECT_DIR/.."',
+        'DEST="$CONFIGURATION_BUILD_DIR/$UNLOCALIZED_RESOURCES_FOLDER_PATH"',
+        'mkdir -p "$DEST"',
+        // expo export:embed resolves entry from package.json#main with no
+        // platform-suffix support, so we pass --entry-file ourselves.
+        // Metro resolves --entry-file relative to its server root (the
+        // pnpm workspace root in a monorepo), so use an absolute path to
+        // avoid surprises.
+        ...(entryFile
+          ? [`ENTRY="$(pwd)/${entryFile}"`]
+          : [
+              'ENTRY=""',
+              'for ext in tsx ts jsx js; do',
+              '  if [ -f "index.watchos.$ext" ]; then',
+              '    ENTRY="$(pwd)/index.watchos.$ext"',
+              '    break',
+              '  fi',
+              'done',
+              'if [ -z "$ENTRY" ]; then',
+              '  echo "error: no index.watchos.{tsx,ts,jsx,js} found in $(pwd). ' +
+                'Add one, or set entryFile in the @appsent-co/react-native-watchos plugin opts." >&2',
+              '  exit 1',
+              'fi',
+            ]),
+        'npx expo export:embed \\',
+        '  --platform watchos \\',
+        '  --entry-file "$ENTRY" \\',
+        `  --bundle-output "$DEST/${bundleName}.jsbundle" \\`,
+        '  --dev false \\',
+        '  --minify true \\',
+        '  --bytecode false \\',
+        '  --assets-dest "$DEST"',
+      ].join('\n');
+
+      // -------------------------------------------------------------
+      // Create the PBXShellScriptBuildPhase
+      // -------------------------------------------------------------
+      const phaseId = project.generateUuid();
+      objects.PBXShellScriptBuildPhase = objects.PBXShellScriptBuildPhase || {};
+      objects.PBXShellScriptBuildPhase[phaseId] = {
+        isa: 'PBXShellScriptBuildPhase',
+        buildActionMask: 2147483647,
+        files: [],
+        inputPaths: [],
+        outputPaths: [
+          `"$(CONFIGURATION_BUILD_DIR)/$(UNLOCALIZED_RESOURCES_FOLDER_PATH)/${bundleName}.jsbundle"`,
+        ],
+        runOnlyForDeploymentPostprocessing: 0,
+        shellPath: '/bin/sh',
+        shellScript: JSON.stringify(scriptBody),
+        name: `"${PHASE_NAME}"`,
+      };
+      objects.PBXShellScriptBuildPhase[`${phaseId}_comment`] = PHASE_NAME;
+
+      // Insert after Sources so a Compile error fails the build fast
+      // before we spend time bundling. If there's no Sources phase
+      // (unlikely), append.
+      target.buildPhases = target.buildPhases || [];
+      const sourcesIdx = target.buildPhases.findIndex(
+        (p) =>
+          objects.PBXSourcesBuildPhase && objects.PBXSourcesBuildPhase[p.value]
+      );
+      const insertAt =
+        sourcesIdx >= 0 ? sourcesIdx + 1 : target.buildPhases.length;
+      target.buildPhases.splice(insertAt, 0, {
+        value: phaseId,
+        comment: PHASE_NAME,
+      });
+
+      fs.writeFileSync(pbxprojPath, project.writeSync());
+      return cfg;
+    },
+  ]);
+};
+
+function findPbxproj(platformRoot) {
+  const xcodeproj = fs
+    .readdirSync(platformRoot)
+    .find((name) => name.endsWith('.xcodeproj'));
+  if (!xcodeproj) {
+    throw new Error(
+      `[@appsent-co/react-native-watchos] No .xcodeproj found in ${platformRoot}`
+    );
+  }
+  return path.join(platformRoot, xcodeproj, 'project.pbxproj');
+}
+
+function stripQuotes(s) {
+  if (typeof s !== 'string') return s;
+  if (s.length >= 2 && s.startsWith('"') && s.endsWith('"')) {
+    return s.slice(1, -1);
+  }
+  return s;
+}
+
+module.exports = withWatchBundleScript;