@lynxship/expo 0.1.5 → 0.1.7

package/README.md

@@ -19,9 +19,10 @@ npx pod-install
 ```
 
 `@lynxship/expo` uses the `expo-modules-core` implementation supplied by the
-installed Expo SDK. The package keeps it as a development dependency for its
-own native-module build, so installing `@lynxship/expo` does not require a
-second manual native dependency in the application.
+installed Expo SDK. It is declared as a peer dependency so Expo Doctor can
+validate the application explicitly; `npx expo install @lynxship/expo` should
+select the SDK-compatible version. The workspace keeps a matching development
+dependency for its own native-module build.
 
 When the project uses a static `app.json` or `app.config.json`, the Expo CLI
 automatically adds `@lynxship/expo` to `expo.plugins` during `npx expo install`.
@@ -43,6 +44,12 @@ options are needed, add the config plugin manually:
           "projectId": "00000000-0000-4000-8000-000000000000",
           "channel": "production",
           "runtimeVersion": "lynx-runtime-2026-01",
+          "notifications": {
+            "enabled": true,
+            "enableBackgroundRemoteNotifications": true,
+            "communicationNotifications": true,
+            "android": { "defaultChannel": "default" }
+          },
           "publicKeys": {
             "release-key-1": "-----BEGIN PUBLIC KEY-----\n...\n-----END PUBLIC KEY-----"
           },
@@ -90,6 +97,32 @@ you intentionally operate a pinned native compatibility lane; do not put
 `latest` in a production lockfile without reviewing the resulting native
 build.
 
+## Optional push notifications
+
+When an Expo app also uses `@lynxship/notifications/expo`, set
+`notifications.enabled` to `true` in this plugin. LynxShip delegates the
+native permission, FCM/APNs token acquisition and build-time configuration to
+the official `expo-notifications` package, then the JavaScript adapter sends
+the token to the authenticated backend. Install the SDK-selected native
+package first:
+
+```bash
+npx expo install expo-notifications expo-constants
+```
+
+The app must call `LynxShipNotifications.register(...)` with its authenticated
+user/project identity and HTTPS registration endpoint. This is intentionally
+not guessed by the plugin: app identity and backend authorization are
+application data. FCM/APNs credentials also remain in EAS/CI secrets.
+
+For message or presence notifications with profile images, pass an HTTPS
+`imageUrl` from the backend payload. Android can render the image directly
+through FCM. iOS requires a separate Notification Service Extension target;
+use the template published by `@lynxship/notifications` and add it to the Expo
+iOS project before an EAS build. The extension is a separately signed native
+target, so it cannot be created safely by the JavaScript `LynxView` component
+at runtime.
+
 ## Use the view
 
 ```tsx

package/android/src/main/java/com/lynxship/expo/LynxShipExpoView.kt

@@ -1,5 +1,6 @@
 package com.lynxship.expo
 
+import android.app.Application
 import android.content.Context
 import android.content.SharedPreferences
 import android.os.Bundle
@@ -19,7 +20,7 @@ import com.lynx.tasm.provider.AbsTemplateProvider
 import com.lynx.tasm.service.LynxServiceCenter
 import com.lynxship.sdk.android.LynxShipOtaClient
 import expo.modules.kotlin.AppContext
-import expo.modules.kotlin.events.EventDispatcher
+import expo.modules.kotlin.viewevent.EventDispatcher
 import expo.modules.kotlin.views.ExpoView
 import java.io.ByteArrayOutputStream
 import java.io.File
@@ -54,7 +55,9 @@ class LynxShipExpoView(context: Context, appContext: AppContext) : ExpoView(cont
 
     init {
         initializeLynx(context)
-        lynxView = LynxViewBuilder().setTemplateProvider(templateProvider).build(applicationContext)
+        // The Lynx view must be created with the host/view context. Keep the
+        // application context only for process-wide services and storage.
+        lynxView = LynxViewBuilder().setTemplateProvider(templateProvider).build(context)
         lynxView.addLynxViewClient(object : LynxViewClient() {
             override fun onFirstScreen() {
                 try {
@@ -62,7 +65,7 @@ class LynxShipExpoView(context: Context, appContext: AppContext) : ExpoView(cont
                 } catch (error: IOException) {
                     onError(mapOf("message" to (error.message ?: "Could not record Lynx launch"), "recoverable" to true))
                 }
-                onReady(mapOf("bundle" to bundleName, "sequence" to (otaClient?.activeSequence ?: 0)))
+                onReady(mapOf("bundle" to bundleName, "sequence" to (otaClient?.activeSequence() ?: 0)))
             }
         })
         addView(lynxView, LayoutParams(LayoutParams.MATCH_PARENT, LayoutParams.MATCH_PARENT))
@@ -98,7 +101,7 @@ class LynxShipExpoView(context: Context, appContext: AppContext) : ExpoView(cont
                 try {
                     otaClient.activateCandidate()
                     post {
-                        onUpdate(mapOf("sequence" to otaClient.activeSequence))
+                        onUpdate(mapOf("sequence" to otaClient.activeSequence()))
                         if (reloadOnUpdate) render()
                     }
                 } catch (error: Exception) {
@@ -168,6 +171,8 @@ class LynxShipExpoView(context: Context, appContext: AppContext) : ExpoView(cont
         synchronized(LynxShipExpoView::class.java) {
             if (!initialized) {
                 val applicationContext = context.applicationContext
+                val application = applicationContext as? Application
+                    ?: throw IllegalStateException("LynxShip requires an Android Application context")
                 // Lynx's official Android integration requires these services
                 // before a LynxView is created. Expo does not give this package
                 // an application subclass, so initialize them once at the
@@ -184,7 +189,7 @@ class LynxShipExpoView(context: Context, appContext: AppContext) : ExpoView(cont
                 LynxServiceCenter.inst().registerService(LynxImageService.getInstance())
                 LynxServiceCenter.inst().registerService(LynxLogService)
                 LynxServiceCenter.inst().registerService(LynxHttpService)
-                LynxEnv.inst().init(applicationContext, null, null, null)
+                LynxEnv.inst().init(application, null, null, null)
                 initialized = true
             }
         }

package/app.plugin.cjs

@@ -7,6 +7,7 @@ const {
   withSettingsGradle,
   withXcodeProject,
   IOSConfig,
+  withPlugins,
 } = require("@expo/config-plugins");
 const path = require("node:path");
 const { syncLynxAssets } = require("./asset-sync.cjs");
@@ -78,6 +79,31 @@ function assertOptions(options) {
     typeof options.syncBundle !== "boolean"
   )
     throw new Error("@lynxship/expo syncBundle must be a boolean");
+  if (options.notifications !== undefined) {
+    if (
+      typeof options.notifications !== "object" ||
+      options.notifications === null ||
+      typeof options.notifications.enabled !== "boolean"
+    )
+      throw new Error(
+        "@lynxship/expo notifications must be an object with boolean enabled",
+      );
+    if (
+      options.notifications.enableBackgroundRemoteNotifications !== undefined &&
+      typeof options.notifications.enableBackgroundRemoteNotifications !==
+        "boolean"
+    )
+      throw new Error(
+        "@lynxship/expo enableBackgroundRemoteNotifications must be a boolean",
+      );
+  }
+  if (
+    options.notifications?.communicationNotifications !== undefined &&
+    typeof options.notifications.communicationNotifications !== "boolean"
+  )
+    throw new Error(
+      "@lynxship/expo communicationNotifications must be a boolean",
+    );
   if (
     options.embeddedBundle !== undefined &&
     (typeof options.embeddedBundle !== "string" ||
@@ -157,6 +183,14 @@ function withLynxShipInfoPlist(config, options) {
       publicKeys: options.publicKeys || {},
       maxReleaseBytes: options.maxReleaseBytes || 104857600,
     };
+    if (options.notifications?.communicationNotifications) {
+      const activityTypes = Array.isArray(value.modResults.NSUserActivityTypes)
+        ? value.modResults.NSUserActivityTypes
+        : [];
+      if (!activityTypes.includes("INSendMessageIntent"))
+        activityTypes.push("INSendMessageIntent");
+      value.modResults.NSUserActivityTypes = activityTypes;
+    }
     return value;
   });
 }
@@ -286,6 +320,28 @@ function withLynxShipIosAssets(config, options) {
   });
 }
 
+function withLynxShipNotifications(config, options) {
+  const notifications = options.notifications;
+  if (!notifications?.enabled) return config;
+  try {
+    return withPlugins(config, [
+      [
+        "expo-notifications",
+        {
+          ...(notifications.android || {}),
+          enableBackgroundRemoteNotifications:
+            notifications.enableBackgroundRemoteNotifications || false,
+        },
+      ],
+    ]);
+  } catch (error) {
+    throw new Error(
+      "@lynxship/expo notifications requires expo-notifications. Install it with `npx expo install expo-notifications`.",
+      { cause: error },
+    );
+  }
+}
+
 function withLynxShipExpo(config, props = {}) {
   const options = assertOptions({ ...getOptions(config), ...props });
   let result = withLynxShipAndroidManifest(config, options);
@@ -294,7 +350,8 @@ function withLynxShipExpo(config, props = {}) {
   result = withLynxShipAndroidSdk(result);
   result = withLynxShipAndroidAssets(result, options);
   result = withLynxShipIosAssets(result, options);
-  return withLynxShipPodfile(result, options);
+  result = withLynxShipPodfile(result, options);
+  return withLynxShipNotifications(result, options);
 }
 
 module.exports = withLynxShipExpo;

package/asset-sync.cjs.d.cts

@@ -0,0 +1,43 @@
+declare const assetSync: {
+  createBundlePlan(
+    projectRoot: string,
+    options?: {
+      bundlePath?: string;
+      embeddedBundle?: string;
+    },
+  ): Promise<{
+    sourceBundle: string;
+    sourceDirectory: string;
+    bundlePath: string;
+    embeddedBundle: string;
+    files: Array<{
+      absolute: string;
+      relative: string;
+      destination: string;
+    }>;
+  }>;
+  syncBundleDirectory(options: {
+    projectRoot: string;
+    plan: Awaited<ReturnType<typeof assetSync.createBundlePlan>>;
+    destinationRoot: string;
+    manifestPath: string;
+    platform: "android" | "ios";
+  }): Promise<{
+    platform: "android" | "ios";
+    sourceBundle: string;
+    destinationRoot: string;
+    manifestPath: string;
+    files: Array<{ path: string; size: number; sha256: string }>;
+  }>;
+  syncLynxAssets(
+    projectRoot: string,
+    options?: {
+      platform?: "android" | "ios";
+      bundlePath?: string;
+      embeddedBundle?: string;
+      iosSourceRoot?: string;
+    },
+  ): Promise<unknown>;
+};
+
+export = assetSync;

package/dist/config.d.ts

@@ -11,6 +11,17 @@ export interface LynxShipExpoConfig {
     syncBundle?: boolean;
     lynxVersion?: string;
     maxReleaseBytes?: number;
+    notifications?: {
+        enabled?: boolean;
+        enableBackgroundRemoteNotifications?: boolean;
+        /** Add the iOS messaging intent declaration for rich communication alerts. */
+        communicationNotifications?: boolean;
+        android?: {
+            icon?: string;
+            color?: string;
+            defaultChannel?: string;
+        };
+    };
 }
 export declare function validateLynxShipExpoConfig(value?: LynxShipExpoConfig): LynxShipExpoConfig;
 //# sourceMappingURL=config.d.ts.map

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,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"}
+{"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;IACzB,aAAa,CAAC,EAAE;QACd,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,mCAAmC,CAAC,EAAE,OAAO,CAAC;QAC9C,8EAA8E;QAC9E,0BAA0B,CAAC,EAAE,OAAO,CAAC;QACrC,OAAO,CAAC,EAAE;YACR,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,cAAc,CAAC,EAAE,MAAM,CAAC;SACzB,CAAC;KACH,CAAC;CACH;AAKD,wBAAgB,0BAA0B,CACxC,KAAK,GAAE,kBAAuB,GAC7B,kBAAkB,CAyEpB"}

package/dist/config.js

@@ -25,6 +25,19 @@ function validateLynxShipExpoConfig(value = {}) {
     }
     if (value.syncBundle !== undefined && typeof value.syncBundle !== "boolean")
         throw new Error("LynxShip Expo syncBundle must be a boolean");
+    if (value.notifications !== undefined) {
+        if (typeof value.notifications !== "object" ||
+            value.notifications === null ||
+            typeof value.notifications.enabled !== "boolean")
+            throw new Error("LynxShip Expo notifications must be an object with boolean enabled");
+        if (value.notifications.enableBackgroundRemoteNotifications !== undefined &&
+            typeof value.notifications.enableBackgroundRemoteNotifications !==
+                "boolean")
+            throw new Error("LynxShip Expo enableBackgroundRemoteNotifications must be a boolean");
+        if (value.notifications.communicationNotifications !== undefined &&
+            typeof value.notifications.communicationNotifications !== "boolean")
+            throw new Error("LynxShip Expo communicationNotifications must be a boolean");
+    }
     if (value.lynxVersion !== undefined &&
         value.lynxVersion !== "auto" &&
         value.lynxVersion !== "latest" &&

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lynxship/expo",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "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.d.cts",
     "asset-sync.cjs",
     "expo-module.config.json",
     "lynxship-expo.podspec",
@@ -42,6 +43,7 @@
   "peerDependencies": {
     "@expo/config-plugins": ">=9",
     "expo": ">=52",
+    "expo-modules-core": ">=52",
     "react": ">=18",
     "react-native": ">=0.76"
   },

package/src/config.ts

@@ -11,6 +11,17 @@ export interface LynxShipExpoConfig {
   syncBundle?: boolean;
   lynxVersion?: string;
   maxReleaseBytes?: number;
+  notifications?: {
+    enabled?: boolean;
+    enableBackgroundRemoteNotifications?: boolean;
+    /** Add the iOS messaging intent declaration for rich communication alerts. */
+    communicationNotifications?: boolean;
+    android?: {
+      icon?: string;
+      color?: string;
+      defaultChannel?: string;
+    };
+  };
 }
 
 /** Let the native package manager resolve the current Lynx SDK by default. */
@@ -48,6 +59,31 @@ export function validateLynxShipExpoConfig(
   }
   if (value.syncBundle !== undefined && typeof value.syncBundle !== "boolean")
     throw new Error("LynxShip Expo syncBundle must be a boolean");
+  if (value.notifications !== undefined) {
+    if (
+      typeof value.notifications !== "object" ||
+      value.notifications === null ||
+      typeof value.notifications.enabled !== "boolean"
+    )
+      throw new Error(
+        "LynxShip Expo notifications must be an object with boolean enabled",
+      );
+    if (
+      value.notifications.enableBackgroundRemoteNotifications !== undefined &&
+      typeof value.notifications.enableBackgroundRemoteNotifications !==
+        "boolean"
+    )
+      throw new Error(
+        "LynxShip Expo enableBackgroundRemoteNotifications must be a boolean",
+      );
+    if (
+      value.notifications.communicationNotifications !== undefined &&
+      typeof value.notifications.communicationNotifications !== "boolean"
+    )
+      throw new Error(
+        "LynxShip Expo communicationNotifications must be a boolean",
+      );
+  }
   if (
     value.lynxVersion !== undefined &&
     value.lynxVersion !== "auto" &&

package/src/externals.d.ts

@@ -1,5 +1,15 @@
 declare module "react" {
-  export type ReactNode = unknown;
+  export interface ReactElement {
+    readonly type: unknown;
+    readonly props: unknown;
+  }
+  export type ReactNode =
+    | ReactElement
+    | string
+    | number
+    | boolean
+    | null
+    | undefined;
   export type ComponentType<Props = Record<string, unknown>> = (
     props: Props,
   ) => ReactNode;