@lynxship/expo 0.1.0 → 0.1.2

package/README.md

@@ -7,7 +7,12 @@ embedded `main.lynx.bundle` fallback.
 
 ## Install
 
+Build the Lynx output before the native prebuild. The plugin then copies the
+whole Rspeedy output directory, including `static/` assets, into the generated
+Android and iOS hosts and records hashes in a managed manifest.
+
 ```bash
+lynxship build --local
 npx expo install @lynxship/expo
 npx expo prebuild
 npx pod-install
@@ -37,6 +42,8 @@ options are needed, add the config plugin manually:
             "release-key-1": "-----BEGIN PUBLIC KEY-----\n...\n-----END PUBLIC KEY-----"
           },
           "embeddedBundle": "main.lynx.bundle",
+          "bundlePath": "../lynx-app/dist/main.lynx.bundle",
+          "syncBundle": true,
           "lynxVersion": "auto"
         }
       ]
@@ -49,6 +56,19 @@ For a dynamic config, keep the same `plugins` entry in the returned Expo
 configuration. Expo cannot safely rewrite JavaScript or TypeScript config
 files automatically.
 
+`bundlePath` points to the generated `.lynx.bundle` and is resolved relative
+to the Expo project. All files beside that bundle are copied so Rspeedy's
+`static/` resources remain available at runtime. The default is
+`dist/main.lynx.bundle`. `syncBundle` defaults to `true`; set it to `false`
+only when a different native asset pipeline owns the bundle. Prebuild fails
+with a repair command if the configured bundle is missing, rather than
+producing a native app that opens to a blank Lynx view.
+
+The sync is deterministic and idempotent. LynxShip updates files previously
+owned by its manifest, removes only stale files from that manifest, and refuses
+to overwrite a developer-owned native asset. The iOS output is added as a
+folder resource so nested asset paths are preserved.
+
 The endpoint must be HTTPS outside localhost. The public verification key is
 safe to ship in the application; private signing keys must remain in the
 LynxShip CLI or CI secret store.
@@ -88,7 +108,7 @@ modules and Lynx runtime changes still require a new binary.
 
 ## Build workflow
 
-From the Expo project:
+From the Lynx project, after the bundle has been generated:
 
 ```bash
 lynxship init
@@ -100,6 +120,20 @@ lynxship ota doctor --platform android
 lynxship ota doctor --platform ios
 ```
 
+For a separate Lynx and Expo checkout, keep the bundle path in the Expo plugin
+configuration and run the two build stages in this order:
+
+```bash
+lynxship --project-dir ../lynx-app build --local
+npx expo prebuild --clean
+npx eas-cli@latest build --platform android --profile preview
+```
+
+EAS receives the Expo project directory, so the Lynx bundle must be generated
+and embedded before the cloud upload (or by an explicitly configured CI build
+step). Config plugins do not run arbitrary network downloads or compilers
+during `prebuild`.
+
 The package does not silently replace an existing native host. `expo prebuild`
 and the official Lynx dependencies remain the source of truth for native
 project generation. iOS builds still require macOS/Xcode; Android builds use

package/app.plugin.cjs

@@ -1,10 +1,15 @@
 const {
   withAndroidManifest,
+  withDangerousMod,
   withGradleProperties,
   withInfoPlist,
   withPodfile,
   withSettingsGradle,
+  withXcodeProject,
+  IOSConfig,
 } = require("@expo/config-plugins");
+const path = require("node:path");
+const { syncLynxAssets } = require("./asset-sync.cjs");
 
 const MARKER = "# @lynxship/expo managed";
 const DEFAULT_LYNX_VERSION = "auto";
@@ -58,6 +63,33 @@ function assertOptions(options) {
       "@lynxship/expo lynxVersion must be auto, latest, or an exact semver",
     );
   }
+  if (
+    options.bundlePath !== undefined &&
+    (typeof options.bundlePath !== "string" ||
+      options.bundlePath.trim() === "" ||
+      options.bundlePath.includes("\0"))
+  ) {
+    throw new Error(
+      "@lynxship/expo bundlePath must be a non-empty path without null bytes",
+    );
+  }
+  if (
+    options.syncBundle !== undefined &&
+    typeof options.syncBundle !== "boolean"
+  )
+    throw new Error("@lynxship/expo syncBundle must be a boolean");
+  if (
+    options.embeddedBundle !== undefined &&
+    (typeof options.embeddedBundle !== "string" ||
+      options.embeddedBundle.trim() === "" ||
+      options.embeddedBundle.startsWith("/") ||
+      options.embeddedBundle.includes("\\") ||
+      options.embeddedBundle.split("/").includes(".."))
+  ) {
+    throw new Error(
+      "@lynxship/expo embeddedBundle must be a portable relative path without '..'",
+    );
+  }
   return options;
 }
 
@@ -185,20 +217,84 @@ function withLynxShipPodfile(config, options) {
   });
 }
 
+function withLynxShipAndroidAssets(config, options) {
+  if (options.syncBundle === false) return config;
+  return withDangerousMod(config, [
+    "android",
+    async (value) => {
+      await syncLynxAssets(value.modRequest.projectRoot, {
+        ...options,
+        platform: "android",
+      });
+      return value;
+    },
+  ]);
+}
+
+function addIosFolderResource(project, folderPath, groupName) {
+  const group = project.pbxGroupByName(groupName);
+  if (!group)
+    throw new Error(`@lynxship/expo could not find iOS group ${groupName}`);
+  const groups = project.hash.project.objects.PBXGroup || {};
+  const groupKey = Object.keys(groups).find(
+    (key) => !key.endsWith("_comment") && groups[key] === group,
+  );
+  if (!groupKey)
+    throw new Error(`@lynxship/expo could not resolve iOS group ${groupName}`);
+  const existing = group.children?.find(
+    (child) => child.comment === path.basename(folderPath),
+  );
+  if (existing) return;
+  const file = project.addFile(folderPath, groupKey, {
+    lastKnownFileType: "folder",
+    sourceTree: "<group>",
+  });
+  if (!file) return;
+  file.uuid = project.generateUuid();
+  const target = project.getTarget("com.apple.product-type.application");
+  if (!target)
+    throw new Error("@lynxship/expo could not find the iOS application target");
+  file.target = target.uuid;
+  project.addToPbxBuildFileSection(file);
+  project.addToPbxResourcesBuildPhase(file);
+}
+
+function withLynxShipIosAssets(config, options) {
+  if (options.syncBundle === false) return config;
+  const withCopiedAssets = withDangerousMod(config, [
+    "ios",
+    async (value) => {
+      const sourceRoot = IOSConfig.Paths.getSourceRoot(
+        value.modRequest.projectRoot,
+      );
+      await syncLynxAssets(value.modRequest.projectRoot, {
+        ...options,
+        platform: "ios",
+        iosSourceRoot: sourceRoot,
+      });
+      return value;
+    },
+  ]);
+  return withXcodeProject(withCopiedAssets, (value) => {
+    const sourceRoot = IOSConfig.Paths.getSourceRoot(
+      value.modRequest.projectRoot,
+    );
+    const projectName = path.basename(sourceRoot);
+    const folderPath = `${projectName}/LynxShipAssets`;
+    addIosFolderResource(value.modResults, folderPath, projectName);
+    return value;
+  });
+}
+
 function withLynxShipExpo(config, props = {}) {
   const options = assertOptions({ ...getOptions(config), ...props });
-  return withLynxShipPodfile(
-    withLynxShipAndroidSdk(
-      withLynxShipGradle(
-        withLynxShipInfoPlist(
-          withLynxShipAndroidManifest(config, options),
-          options,
-        ),
-        options,
-      ),
-    ),
-    options,
-  );
+  let result = withLynxShipAndroidManifest(config, options);
+  result = withLynxShipInfoPlist(result, options);
+  result = withLynxShipGradle(result, options);
+  result = withLynxShipAndroidSdk(result);
+  result = withLynxShipAndroidAssets(result, options);
+  result = withLynxShipIosAssets(result, options);
+  return withLynxShipPodfile(result, options);
 }
 
 module.exports = withLynxShipExpo;

package/asset-sync.cjs

@@ -0,0 +1,264 @@
+const crypto = require("node:crypto");
+const fs = require("node:fs");
+const fsp = require("node:fs/promises");
+const path = require("node:path");
+
+const MANIFEST_VERSION = 1;
+
+function isAbsoluteAny(value) {
+  return path.isAbsolute(value) || path.win32.isAbsolute(value);
+}
+
+function safeRelative(value, label) {
+  if (typeof value !== "string" || value.trim() === "") {
+    throw new Error(`@lynxship/expo ${label} must be a non-empty path`);
+  }
+  const normalized = value.replaceAll("\\", "/");
+  if (
+    isAbsoluteAny(value) ||
+    normalized.startsWith("/") ||
+    normalized.split("/").some((part) => part === "..") ||
+    normalized.includes("\0")
+  ) {
+    throw new Error(
+      `@lynxship/expo ${label} must be a portable relative path without '..'`,
+    );
+  }
+  return normalized.replace(/^\.\//, "");
+}
+
+function destinationPath(root, relativePath) {
+  const normalized = safeRelative(relativePath, "embeddedBundle");
+  const destination = path.resolve(root, ...normalized.split("/"));
+  const relative = path.relative(root, destination);
+  if (
+    relative === "" ||
+    relative.startsWith(".." + path.sep) ||
+    path.isAbsolute(relative)
+  ) {
+    throw new Error(
+      "@lynxship/expo embeddedBundle must stay in the asset root",
+    );
+  }
+  return { normalized, destination };
+}
+
+async function collectFiles(directory, prefix = "") {
+  const entries = await fsp.readdir(directory, { withFileTypes: true });
+  entries.sort((left, right) => left.name.localeCompare(right.name));
+  const files = [];
+  for (const entry of entries) {
+    const relative = prefix ? `${prefix}/${entry.name}` : entry.name;
+    const absolute = path.join(directory, entry.name);
+    if (entry.isSymbolicLink()) {
+      throw new Error(
+        `@lynxship/expo refuses symbolic links in the Lynx output: ${relative}`,
+      );
+    }
+    if (entry.isDirectory()) {
+      files.push(...(await collectFiles(absolute, relative)));
+    } else if (entry.isFile()) {
+      files.push({ absolute, relative: relative.replaceAll("\\", "/") });
+    } else {
+      throw new Error(
+        `@lynxship/expo found an unsupported filesystem entry in the Lynx output: ${relative}`,
+      );
+    }
+  }
+  return files;
+}
+
+async function createBundlePlan(projectRoot, options = {}) {
+  const bundlePath = options.bundlePath || "dist/main.lynx.bundle";
+  if (typeof bundlePath !== "string" || bundlePath.trim() === "") {
+    throw new Error("@lynxship/expo bundlePath must be a non-empty path");
+  }
+  const sourceBundle = path.resolve(projectRoot, bundlePath);
+  const sourceDirectory = path.dirname(sourceBundle);
+  const sourceStat = await fsp.stat(sourceBundle).catch(() => undefined);
+  if (!sourceStat || !sourceStat.isFile() || sourceStat.size === 0) {
+    throw new Error(
+      `Lynx bundle not found or empty: ${sourceBundle}. Build Rspeedy first (for example: lynxship build --local), or set expo.plugins[@lynxship/expo].bundlePath to the generated .lynx.bundle.`,
+    );
+  }
+  const embeddedBundle = safeRelative(
+    options.embeddedBundle || "main.lynx.bundle",
+    "embeddedBundle",
+  );
+  const files = await collectFiles(sourceDirectory);
+  const plan = files.map((file) => ({
+    ...file,
+    destination:
+      path.resolve(sourceDirectory, file.relative) === sourceBundle
+        ? embeddedBundle
+        : safeRelative(file.relative, "bundle output file"),
+  }));
+  const seen = new Set();
+  for (const file of plan) {
+    if (seen.has(file.destination)) {
+      throw new Error(
+        `@lynxship/expo found duplicate embedded asset path: ${file.destination}`,
+      );
+    }
+    seen.add(file.destination);
+  }
+  return {
+    sourceBundle,
+    sourceDirectory,
+    bundlePath,
+    embeddedBundle,
+    files: plan,
+  };
+}
+
+async function sha256File(file) {
+  const hash = crypto.createHash("sha256");
+  hash.update(await fsp.readFile(file));
+  return hash.digest("hex");
+}
+
+async function readManifest(file) {
+  try {
+    const value = JSON.parse(await fsp.readFile(file, "utf8"));
+    if (value.version !== MANIFEST_VERSION || !Array.isArray(value.files)) {
+      return { files: [] };
+    }
+    return value;
+  } catch {
+    return { files: [] };
+  }
+}
+
+function manifestPaths(manifest) {
+  return new Set(
+    manifest.files
+      .map((file) => file && file.path)
+      .filter((file) => typeof file === "string")
+      .map((file) => safeRelative(file, "managed asset path")),
+  );
+}
+
+async function syncBundleDirectory({
+  projectRoot,
+  plan,
+  destinationRoot,
+  manifestPath,
+  platform,
+}) {
+  await fsp.mkdir(destinationRoot, { recursive: true });
+  const previous = await readManifest(manifestPath);
+  const previouslyManaged = manifestPaths(previous);
+  const desired = new Set(plan.files.map((file) => file.destination));
+
+  for (const file of plan.files) {
+    const { destination } = destinationPath(destinationRoot, file.destination);
+    const existing = await fsp.lstat(destination).catch(() => undefined);
+    if (existing && !previouslyManaged.has(file.destination)) {
+      throw new Error(
+        `@lynxship/expo will not overwrite an unmanaged ${platform} asset: ${destination}. Choose another embeddedBundle path or remove the conflicting file yourself.`,
+      );
+    }
+    if (existing && !existing.isFile()) {
+      throw new Error(
+        `@lynxship/expo cannot replace a non-file ${platform} asset: ${destination}`,
+      );
+    }
+  }
+
+  for (const stale of previouslyManaged) {
+    if (desired.has(stale)) continue;
+    const { destination } = destinationPath(destinationRoot, stale);
+    const existing = await fsp.lstat(destination).catch(() => undefined);
+    if (existing?.isFile()) await fsp.rm(destination);
+  }
+
+  const manifestFiles = [];
+  for (const file of plan.files) {
+    const { destination } = destinationPath(destinationRoot, file.destination);
+    await fsp.mkdir(path.dirname(destination), { recursive: true });
+    await fsp.copyFile(file.absolute, destination);
+    const stat = await fsp.stat(destination);
+    manifestFiles.push({
+      path: file.destination,
+      size: stat.size,
+      sha256: await sha256File(destination),
+    });
+  }
+
+  await fsp.mkdir(path.dirname(manifestPath), { recursive: true });
+  const source = path
+    .relative(projectRoot, plan.sourceDirectory)
+    .replaceAll("\\", "/");
+  await fsp.writeFile(
+    manifestPath,
+    JSON.stringify(
+      {
+        version: MANIFEST_VERSION,
+        platform,
+        source: source || ".",
+        bundlePath: plan.bundlePath,
+        embeddedBundle: plan.embeddedBundle,
+        files: manifestFiles,
+      },
+      null,
+      2,
+    ) + "\n",
+    "utf8",
+  );
+  return {
+    platform,
+    sourceBundle: plan.sourceBundle,
+    destinationRoot,
+    manifestPath,
+    files: manifestFiles,
+  };
+}
+
+async function syncLynxAssets(projectRoot, options = {}) {
+  const plan = await createBundlePlan(projectRoot, options);
+  const platform = options.platform;
+  if (platform === "android") {
+    const destinationRoot = path.join(
+      projectRoot,
+      "android",
+      "app",
+      "src",
+      "main",
+      "assets",
+    );
+    if (!fs.existsSync(path.join(projectRoot, "android"))) {
+      throw new Error(
+        "Android native project is missing. Run `npx expo prebuild --platform android` before syncing the Lynx bundle.",
+      );
+    }
+    return syncBundleDirectory({
+      projectRoot,
+      plan,
+      destinationRoot,
+      manifestPath: path.join(projectRoot, "android", ".lynxship-assets.json"),
+      platform,
+    });
+  }
+  if (platform === "ios") {
+    const iosSourceRoot = options.iosSourceRoot;
+    if (!iosSourceRoot) {
+      throw new Error(
+        "iOS native source root is unavailable. Run `npx expo prebuild --platform ios` before syncing the Lynx bundle.",
+      );
+    }
+    return syncBundleDirectory({
+      projectRoot,
+      plan,
+      destinationRoot: path.join(iosSourceRoot, "LynxShipAssets"),
+      manifestPath: path.join(projectRoot, "ios", ".lynxship-assets.json"),
+      platform,
+    });
+  }
+  throw new Error(`@lynxship/expo does not support asset sync for ${platform}`);
+}
+
+module.exports = {
+  createBundlePlan,
+  syncBundleDirectory,
+  syncLynxAssets,
+};

package/dist/config.d.ts

@@ -5,6 +5,10 @@ export interface LynxShipExpoConfig {
     runtimeVersion?: string;
     publicKeys?: Record<string, string>;
     embeddedBundle?: string;
+    /** Relative path to the generated .lynx.bundle, normally dist/main.lynx.bundle. */
+    bundlePath?: string;
+    /** Copy the Lynx output into generated Android/iOS hosts during prebuild. */
+    syncBundle?: boolean;
     lynxVersion?: string;
     maxReleaseBytes?: number;
 }

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAKD,wBAAgB,0BAA0B,CACxC,KAAK,GAAE,kBAAuB,GAC7B,kBAAkB,CAkCpB"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAKD,wBAAgB,0BAA0B,CACxC,KAAK,GAAE,kBAAuB,GAC7B,kBAAkB,CAgDpB"}

package/dist/config.js

@@ -17,6 +17,14 @@ function validateLynxShipExpoConfig(value = {}) {
         if (!Number.isInteger(value.maxReleaseBytes) || value.maxReleaseBytes < 1)
             throw new Error("LynxShip Expo maxReleaseBytes must be a positive integer");
     }
+    if (value.bundlePath !== undefined) {
+        if (typeof value.bundlePath !== "string" ||
+            value.bundlePath.trim().length === 0 ||
+            value.bundlePath.includes("\0"))
+            throw new Error("LynxShip Expo bundlePath must be a non-empty path without null bytes");
+    }
+    if (value.syncBundle !== undefined && typeof value.syncBundle !== "boolean")
+        throw new Error("LynxShip Expo syncBundle must be a boolean");
     if (value.lynxVersion !== undefined &&
         value.lynxVersion !== "auto" &&
         value.lynxVersion !== "latest" &&
@@ -27,6 +35,8 @@ function validateLynxShipExpoConfig(value = {}) {
         ...value,
         channel: value.channel ?? "production",
         embeddedBundle: value.embeddedBundle ?? "main.lynx.bundle",
+        bundlePath: value.bundlePath ?? "dist/main.lynx.bundle",
+        syncBundle: value.syncBundle ?? true,
         lynxVersion: value.lynxVersion ?? DEFAULT_LYNX_VERSION,
     };
 }

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { type ComponentType } from "react";
+import { type ComponentType, type ReactNode } from "react";
 import type { ViewProps } from "react-native";
 import { type LynxShipExpoConfig } from "./config.js";
 export type { LynxShipExpoConfig } from "./config.js";
@@ -15,7 +15,7 @@ export interface LynxViewProps extends ViewProps {
  * A LynxView that can be placed anywhere in an Expo/React Native view tree.
  * Native OTA configuration is supplied by the LynxShip config plugin.
  */
-export declare function LynxView(props: LynxViewProps): unknown;
+export declare function LynxView(props: LynxViewProps): ReactNode;
 export declare const LynxShipView: ComponentType<LynxViewProps>;
 export declare function defineLynxShipExpoConfig(config: LynxShipExpoConfig): LynxShipExpoConfig;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,OAAO,CAAC;AAE1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,aAAa,CAAC;AAErB,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAEzD,MAAM,WAAW,aAAc,SAAQ,SAAS;IAC9C,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAID;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAOtD;AAED,eAAO,MAAM,YAAY,EAAE,aAAa,CAAC,aAAa,CAAY,CAAC;AAEnE,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,kBAAkB,GACzB,kBAAkB,CAEpB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAE1E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,aAAa,CAAC;AAErB,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAEzD,MAAM,WAAW,aAAc,SAAQ,SAAS;IAC9C,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAID;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,CAOxD;AAED,eAAO,MAAM,YAAY,EAAE,aAAa,CAAC,aAAa,CAAY,CAAC;AAEnE,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,kBAAkB,GACzB,kBAAkB,CAEpB"}

package/ios/LynxShipExpoView.swift

@@ -113,7 +113,10 @@ public final class LynxShipExpoView: ExpoView {
     guard !path.isEmpty, !path.hasPrefix("/"), !path.contains(".."), !path.contains("\\") else {
       throw NSError(domain: "LynxShip", code: 2, userInfo: [NSLocalizedDescriptionKey: "Unsafe Lynx asset path"])
     }
-    guard let url = Bundle.main.url(forResource: path, withExtension: nil) ?? Bundle.main.url(forResource: path, withExtension: "bundle") else {
+    guard let url = Bundle.main.url(forResource: path, withExtension: nil, subdirectory: "LynxShipAssets")
+      ?? Bundle.main.url(forResource: path, withExtension: "bundle", subdirectory: "LynxShipAssets")
+      ?? Bundle.main.url(forResource: path, withExtension: nil)
+      ?? Bundle.main.url(forResource: path, withExtension: "bundle") else {
       throw NSError(domain: "LynxShip", code: 3, userInfo: [NSLocalizedDescriptionKey: "Embedded Lynx bundle not found: \(path)"])
     }
     return try Data(contentsOf: url)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lynxship/expo",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Expo native LynxView with LynxShip OTA delivery and cache support.",
   "license": "MIT",
   "main": "dist/index.js",
@@ -12,6 +12,7 @@
     "src",
     "app.plugin.js",
     "app.plugin.cjs",
+    "asset-sync.cjs",
     "expo-module.config.json",
     "lynxship-expo.podspec",
     "README.md"

package/src/config.ts

@@ -5,6 +5,10 @@ export interface LynxShipExpoConfig {
   runtimeVersion?: string;
   publicKeys?: Record<string, string>;
   embeddedBundle?: string;
+  /** Relative path to the generated .lynx.bundle, normally dist/main.lynx.bundle. */
+  bundlePath?: string;
+  /** Copy the Lynx output into generated Android/iOS hosts during prebuild. */
+  syncBundle?: boolean;
   lynxVersion?: string;
   maxReleaseBytes?: number;
 }
@@ -32,6 +36,18 @@ export function validateLynxShipExpoConfig(
         "LynxShip Expo maxReleaseBytes must be a positive integer",
       );
   }
+  if (value.bundlePath !== undefined) {
+    if (
+      typeof value.bundlePath !== "string" ||
+      value.bundlePath.trim().length === 0 ||
+      value.bundlePath.includes("\0")
+    )
+      throw new Error(
+        "LynxShip Expo bundlePath must be a non-empty path without null bytes",
+      );
+  }
+  if (value.syncBundle !== undefined && typeof value.syncBundle !== "boolean")
+    throw new Error("LynxShip Expo syncBundle must be a boolean");
   if (
     value.lynxVersion !== undefined &&
     value.lynxVersion !== "auto" &&
@@ -46,6 +62,8 @@ export function validateLynxShipExpoConfig(
     ...value,
     channel: value.channel ?? "production",
     embeddedBundle: value.embeddedBundle ?? "main.lynx.bundle",
+    bundlePath: value.bundlePath ?? "dist/main.lynx.bundle",
+    syncBundle: value.syncBundle ?? true,
     lynxVersion: value.lynxVersion ?? DEFAULT_LYNX_VERSION,
   };
 }

package/src/externals.d.ts

@@ -1,11 +1,12 @@
 declare module "react" {
+  export type ReactNode = unknown;
   export type ComponentType<Props = Record<string, unknown>> = (
     props: Props,
-  ) => unknown;
+  ) => ReactNode;
   export function createElement(
     type: unknown,
     props: Record<string, unknown> | null,
-  ): unknown;
+  ): ReactNode;
 }
 
 declare module "react-native" {
@@ -19,5 +20,5 @@ declare module "react-native" {
 declare module "expo-modules-core" {
   export function requireNativeViewManager<Props = Record<string, unknown>>(
     moduleName: string,
-  ): (props: Props) => unknown;
+  ): (props: Props) => import("react").ReactNode;
 }

package/src/index.ts

@@ -1,4 +1,4 @@
-import { createElement, type ComponentType } from "react";
+import { createElement, type ComponentType, type ReactNode } from "react";
 import { requireNativeViewManager } from "expo-modules-core";
 import type { ViewProps } from "react-native";
 import {
@@ -25,7 +25,7 @@ const NativeLynxView = requireNativeViewManager<LynxViewProps>("LynxShip");
  * A LynxView that can be placed anywhere in an Expo/React Native view tree.
  * Native OTA configuration is supplied by the LynxShip config plugin.
  */
-export function LynxView(props: LynxViewProps): unknown {
+export function LynxView(props: LynxViewProps): ReactNode {
   return createElement(NativeLynxView, {
     bundle: props.bundle ?? "main.lynx.bundle",
     initialData: props.initialData ?? "",