@lynxship/expo 0.1.6 → 0.1.8

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/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { type ComponentType, type ReactNode } from "react";
+import { type ComponentType } from "react";
 import type { ViewProps } from "react-native";
 import { type LynxShipExpoConfig } from "./config.js";
 export type { LynxShipExpoConfig } from "./config.js";
@@ -8,14 +8,84 @@ export interface LynxViewProps extends ViewProps {
     bundle?: string;
     /** Optional initial data passed to Lynx when the view is rendered. */
     initialData?: string;
+    /** Global props exposed as `lynx.__globalProps` in the loaded Lynx page. */
+    globalProps?: Readonly<Record<string, unknown>>;
+    /** Injects the standard OS, size, safe-area and lifecycle host props. */
+    autoGlobalProps?: boolean;
     /** Requests a fresh render after an OTA candidate has been activated. */
     reloadOnUpdate?: boolean;
+    /** Emitted after Lynx reports that the first screen layout completed. */
+    onReady?: (event: LynxViewReadyEvent) => void;
+    /** Emitted when Lynx begins loading a bundle. */
+    onLoadStart?: (event: LynxViewLoadStartEvent) => void;
+    /** Emitted when the native provider starts fetching bundle bytes. */
+    onResourceFetchStart?: (event: LynxViewResourceFetchStartEvent) => void;
+    /** Emitted when the first rendered screen is available. */
+    onLoadSuccess?: (event: LynxViewReadyEvent) => void;
+    /** Emitted when the native host or bundle provider reports an error. */
+    onError?: (event: LynxViewErrorEvent) => void;
+    /** Emitted after a verified OTA candidate has been activated. */
+    onUpdate?: (event: LynxViewUpdateEvent) => void;
+    /** Emitted when the native Lynx view becomes visible. */
+    onShow?: () => void;
+    /** Emitted when the native Lynx view leaves the window. */
+    onHide?: () => void;
+}
+export interface LynxViewLoadStartEvent {
+    readonly nativeEvent: {
+        readonly bundle: string;
+    };
+}
+export interface LynxViewResourceFetchStartEvent {
+    readonly nativeEvent: {
+        readonly bundle: string;
+    };
+}
+export interface LynxViewReadyEvent {
+    readonly nativeEvent: {
+        readonly bundle: string;
+        readonly sequence: number;
+    };
+}
+export interface LynxViewErrorEvent {
+    readonly nativeEvent: {
+        readonly message: string;
+        readonly recoverable?: boolean;
+    };
+}
+export interface LynxViewUpdateEvent {
+    readonly nativeEvent: {
+        readonly sequence: number;
+    };
+}
+export interface LynxViewViewport {
+    readonly width: number;
+    readonly height: number;
+}
+export type LynxViewLoadState = "idle" | "loading" | "loaded" | "failed" | "released";
+/** Imperative controls implemented by the native LynxView ref. */
+export interface LynxViewRef {
+    getContainerId(): Promise<string>;
+    getLoadState(): Promise<LynxViewLoadState>;
+    isLoadSuccess(): Promise<boolean>;
+    reload(): Promise<void>;
+    /** Updates Lynx initData without remounting the native view. */
+    updateData(data: string, processorName?: string): Promise<void>;
+    updateGlobalProps(props: Readonly<Record<string, unknown>>): Promise<void>;
+    /** Merges a partial global-props patch without remounting the Lynx page. */
+    updateGlobalPropsByIncrement(props: Readonly<Record<string, unknown>>): Promise<void>;
+    sendGlobalEvent(eventName: string, params?: readonly unknown[]): Promise<void>;
+    show(): Promise<void>;
+    hide(): Promise<void>;
+    updateViewport(viewport: LynxViewViewport): Promise<void>;
 }
 /**
  * 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): ReactNode;
+export declare const LynxView: ComponentType<LynxViewProps & {
+    ref?: LynxViewRef | null | undefined;
+}>;
 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,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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LynxShipView = exports.validateLynxShipExpoConfig = void 0;
-exports.LynxView = LynxView;
+exports.LynxShipView = exports.LynxView = exports.validateLynxShipExpoConfig = void 0;
 exports.defineLynxShipExpoConfig = defineLynxShipExpoConfig;
 const react_1 = require("react");
 const expo_modules_core_1 = require("expo-modules-core");
@@ -13,15 +12,16 @@ const NativeLynxView = (0, expo_modules_core_1.requireNativeViewManager)("LynxSh
  * A LynxView that can be placed anywhere in an Expo/React Native view tree.
  * Native OTA configuration is supplied by the LynxShip config plugin.
  */
-function LynxView(props) {
-    return (0, react_1.createElement)(NativeLynxView, {
-        bundle: props.bundle ?? "main.lynx.bundle",
-        initialData: props.initialData ?? "",
-        reloadOnUpdate: props.reloadOnUpdate ?? true,
-        ...props,
-    });
-}
-exports.LynxShipView = LynxView;
+exports.LynxView = (0, react_1.forwardRef)((props, ref) => (0, react_1.createElement)(NativeLynxView, {
+    bundle: props.bundle ?? "main.lynx.bundle",
+    initialData: props.initialData ?? "",
+    globalProps: props.globalProps ?? {},
+    autoGlobalProps: props.autoGlobalProps ?? true,
+    reloadOnUpdate: props.reloadOnUpdate ?? true,
+    ...props,
+    ref,
+}));
+exports.LynxShipView = exports.LynxView;
 function defineLynxShipExpoConfig(config) {
     return (0, config_js_1.validateLynxShipExpoConfig)(config);
 }

package/ios/LynxShipExpoModule.swift

@@ -4,12 +4,18 @@ public class LynxShipExpoModule: Module {
   public func definition() -> ModuleDefinition {
     Name("LynxShip")
     View(LynxShipExpoView.self) {
-      Events("onReady", "onError", "onUpdate")
+      Events("onReady", "onLoadStart", "onResourceFetchStart", "onLoadSuccess", "onError", "onUpdate", "onShow", "onHide")
       Prop("bundle") { (view: LynxShipExpoView, value: String?) in
-        view.bundleName = value ?? "main.lynx.bundle"
+        view.setBundleName(value ?? "main.lynx.bundle")
       }
       Prop("initialData") { (view: LynxShipExpoView, value: String?) in
-        view.initialData = value ?? ""
+        view.setInitialData(value ?? "")
+      }
+      Prop("globalProps") { (view: LynxShipExpoView, value: [String: Any]?) in
+        view.updateGlobalProps(value ?? [:])
+      }
+      Prop("autoGlobalProps") { (view: LynxShipExpoView, value: Bool?) in
+        view.autoGlobalProps = value ?? true
       }
       Prop("reloadOnUpdate") { (view: LynxShipExpoView, value: Bool?) in
         view.reloadOnUpdate = value ?? true
@@ -17,6 +23,36 @@ public class LynxShipExpoModule: Module {
       AsyncFunction("reload") { (view: LynxShipExpoView) in
         try view.reload()
       }
+      AsyncFunction("getContainerId") { (view: LynxShipExpoView) in
+        view.getContainerId()
+      }
+      AsyncFunction("getLoadState") { (view: LynxShipExpoView) in
+        view.getLoadState()
+      }
+      AsyncFunction("isLoadSuccess") { (view: LynxShipExpoView) in
+        view.isLoadSuccess()
+      }
+      AsyncFunction("updateData") { (view: LynxShipExpoView, data: String, processorName: String?) in
+        try view.updateData(data, processorName: processorName)
+      }
+      AsyncFunction("updateGlobalProps") { (view: LynxShipExpoView, props: [String: Any]) in
+        view.updateGlobalProps(props)
+      }
+      AsyncFunction("updateGlobalPropsByIncrement") { (view: LynxShipExpoView, props: [String: Any]) in
+        view.updateGlobalPropsByIncrement(props)
+      }
+      AsyncFunction("sendGlobalEvent") { (view: LynxShipExpoView, eventName: String, params: [Any]) in
+        try view.sendGlobalEvent(eventName, params: params)
+      }
+      AsyncFunction("show") { (view: LynxShipExpoView) in
+        view.show()
+      }
+      AsyncFunction("hide") { (view: LynxShipExpoView) in
+        view.hide()
+      }
+      AsyncFunction("updateViewport") { (view: LynxShipExpoView, viewport: [String: Double]) in
+        try view.updateViewport(viewport)
+      }
     }
   }
 }

package/ios/LynxShipExpoView.swift

@@ -6,38 +6,79 @@ import UIKit
 
 private final class LynxShipTemplateProvider: NSObject, LynxTemplateProvider {
   private let load: (String) throws -> Data
-  private let onLoaded: () -> Void
+  private let onStart: (String) -> Void
 
-  init(load: @escaping (String) throws -> Data, onLoaded: @escaping () -> Void) {
+  init(load: @escaping (String) throws -> Data, onStart: @escaping (String) -> Void) {
     self.load = load
-    self.onLoaded = onLoaded
+    self.onStart = onStart
   }
 
   func loadTemplate(withUrl url: String!, onComplete callback: LynxTemplateLoadBlock!) {
+    onStart(url ?? "")
     do {
       callback(load(url), nil)
-      onLoaded()
     } catch {
       callback(nil, error)
     }
   }
 }
 
+private final class LynxShipLifecycleClient: NSObject, LynxViewLifecycle {
+  private let onStart: () -> Void
+  private let onFirstScreen: () -> Void
+
+  init(onStart: @escaping () -> Void, onFirstScreen: @escaping () -> Void) {
+    self.onStart = onStart
+    self.onFirstScreen = onFirstScreen
+  }
+
+  func lynxViewDidStartLoading(_ view: LynxView) {
+    onStart()
+  }
+
+  func lynxViewDidFirstScreen(_ view: LynxView) {
+    onFirstScreen()
+  }
+}
+
 public final class LynxShipExpoView: ExpoView {
   let onReady = EventDispatcher()
+  let onLoadStart = EventDispatcher()
+  let onResourceFetchStart = EventDispatcher()
+  let onLoadSuccess = EventDispatcher()
   let onError = EventDispatcher()
   let onUpdate = EventDispatcher()
+  let onShow = EventDispatcher()
+  let onHide = EventDispatcher()
 
   private lazy var templateProvider = LynxShipTemplateProvider(
     load: { [weak self] path in
       guard let self else { throw NSError(domain: "LynxShip", code: 1, userInfo: [NSLocalizedDescriptionKey: "Lynx view was released"]) }
       return try self.otaClient?.openActiveAsset(path) ?? self.readEmbeddedAsset(path)
     },
-    onLoaded: { [weak self] in
+    onStart: { [weak self] bundle in
+      DispatchQueue.main.async { self?.onResourceFetchStart(["bundle": bundle]) }
+    }
+  )
+
+  private lazy var lifecycleClient = LynxShipLifecycleClient(
+    onStart: { [weak self] in
       guard let self else { return }
-      try? self.otaClient?.markLaunchSuccess()
+      self.loadState = "loading"
+      self.onLoadStart(["bundle": self.bundleName])
+    },
+    onFirstScreen: { [weak self] in
+      guard let self else { return }
+      self.loadState = "loaded"
+      do {
+        try self.otaClient?.markLaunchSuccess()
+      } catch {
+        self.onError(["message": error.localizedDescription, "recoverable": true])
+      }
       DispatchQueue.main.async {
-        self.onReady(["bundle": self.bundleName, "sequence": self.otaClient?.activeSequence ?? 0])
+        let event: [String: Any] = ["bundle": self.bundleName, "sequence": self.otaClient?.activeSequence ?? 0]
+        self.onLoadSuccess(event)
+        self.onReady(event)
       }
     }
   )
@@ -51,15 +92,26 @@ public final class LynxShipExpoView: ExpoView {
 
   private var otaClient: LynxShipOtaClient?
   private var hasRendered = false
+  private var loadState = "idle"
   var bundleName = "main.lynx.bundle"
   var initialData = ""
+  private var globalProps: [String: Any] = [:]
   var reloadOnUpdate = true
+  var autoGlobalProps = true {
+    didSet {
+      if hasRendered { pushGlobalProps() }
+    }
+  }
+  private let containerID = UUID().uuidString
+  private let containerInitTime = ISO8601DateFormatter().string(from: Date())
+  private var appInBackground = false
 
   public required init(appContext: AppContext? = nil) {
     super.init(appContext: appContext)
     LynxEnv.sharedInstance()
     otaClient = makeOtaClient()
     addSubview(lynxView)
+    lynxView.addLifecycleClient(lifecycleClient)
   }
 
   public override func layoutSubviews() {
@@ -67,16 +119,30 @@ public final class LynxShipExpoView: ExpoView {
     lynxView.frame = bounds
     lynxView.preferredLayoutWidth = bounds.width
     lynxView.preferredLayoutHeight = bounds.height
+    lynxView.updateViewport(withPreferredLayoutWidth: bounds.width,
+                            preferredLayoutHeight: bounds.height,
+                            needLayout: true)
+    if hasRendered && autoGlobalProps { pushGlobalProps() }
   }
 
   public override func didMoveToWindow() {
     super.didMoveToWindow()
+    appInBackground = window == nil
+    if window != nil {
+      lynxView.onEnterForeground()
+      onShow([:])
+    } else {
+      lynxView.onEnterBackground()
+      onHide([:])
+    }
+    if hasRendered && autoGlobalProps { pushGlobalProps() }
     guard window != nil, !hasRendered else { return }
     do {
       try otaClient?.beginLaunch()
       render()
       checkForUpdate()
     } catch {
+      loadState = "failed"
       onError(["message": error.localizedDescription])
     }
   }
@@ -85,11 +151,167 @@ public final class LynxShipExpoView: ExpoView {
     render()
   }
 
+  func getContainerId() -> String { containerID }
+
+  func getLoadState() -> String { loadState }
+
+  func isLoadSuccess() -> Bool { loadState == "loaded" }
+
+  func updateData(_ data: String, processorName: String? = nil) throws {
+    guard data.utf8.count <= 8 * 1024 * 1024 else {
+      throw NSError(domain: "LynxShip", code: 8, userInfo: [NSLocalizedDescriptionKey: "Lynx update data is larger than 8 MiB"])
+    }
+    guard hasRendered else {
+      throw NSError(domain: "LynxShip", code: 9, userInfo: [NSLocalizedDescriptionKey: "Lynx view has not loaded a bundle"])
+    }
+    if let processorName {
+      guard !processorName.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty,
+            processorName.count <= 256,
+            processorName.rangeOfCharacter(from: .controlCharacters) == nil else {
+        throw NSError(domain: "LynxShip", code: 10, userInfo: [NSLocalizedDescriptionKey: "Lynx data processor name is invalid"])
+      }
+      let templateData = LynxTemplateData(json: data)
+      templateData.markState(processorName)
+      lynxView.updateData(withTemplateData: templateData)
+    } else {
+      lynxView.updateData(withString: data)
+    }
+    initialData = data
+    onUpdate(["bundle": bundleName, "reason": "data"])
+  }
+
+  func setBundleName(_ value: String) {
+    guard value != bundleName else { return }
+    bundleName = value
+    if hasRendered { render() }
+  }
+
+  func setInitialData(_ value: String) {
+    guard value != initialData else { return }
+    initialData = value
+    if hasRendered { render() }
+  }
+
+  func updateGlobalProps(_ props: [String: Any]) {
+    globalProps = props
+    pushGlobalProps()
+  }
+
+  func updateGlobalPropsByIncrement(_ props: [String: Any]) {
+    guard !props.isEmpty else { return }
+    globalProps.merge(props) { _, newValue in newValue }
+    lynxView.updateGlobalProps(withDictionary: props)
+  }
+
+  func sendGlobalEvent(_ eventName: String, params: [Any]) throws {
+    guard !eventName.isEmpty else {
+      throw NSError(domain: "LynxShip", code: 4, userInfo: [NSLocalizedDescriptionKey: "Lynx global event name cannot be empty"])
+    }
+    guard eventName.count <= 256 else {
+      throw NSError(domain: "LynxShip", code: 5, userInfo: [NSLocalizedDescriptionKey: "Lynx global event name is too long"])
+    }
+    guard params.count <= 256 else {
+      throw NSError(domain: "LynxShip", code: 6, userInfo: [NSLocalizedDescriptionKey: "Lynx global event payload is too large"])
+    }
+    lynxView.sendGlobalEvent(eventName, withParams: params)
+  }
+
+  func show() {
+    isHidden = false
+  }
+
+  func hide() {
+    isHidden = true
+  }
+
+  func updateViewport(_ viewport: [String: Double]) throws {
+    let width = viewport["width"] ?? 0
+    let height = viewport["height"] ?? 0
+    guard width.isFinite && height.isFinite && width >= 0 && height >= 0 else {
+      throw NSError(domain: "LynxShip", code: 7, userInfo: [NSLocalizedDescriptionKey: "Lynx viewport dimensions must be finite and non-negative"])
+    }
+    lynxView.updateViewport(withPreferredLayoutWidth: CGFloat(width),
+                            preferredLayoutHeight: CGFloat(height),
+                            needLayout: true)
+  }
+
   private func render() {
+    loadState = "loading"
+    if autoGlobalProps || !globalProps.isEmpty {
+      lynxView.updateGlobalProps(withDictionary: effectiveGlobalProps())
+    }
     lynxView.loadTemplate(fromURL: bundleName, initData: initialData)
     hasRendered = true
   }
 
+  private func pushGlobalProps() {
+    guard autoGlobalProps || !globalProps.isEmpty else { return }
+    lynxView.updateGlobalProps(withDictionary: effectiveGlobalProps())
+  }
+
+  private func effectiveGlobalProps() -> [String: Any] {
+    guard autoGlobalProps else { return globalProps }
+    let screen = window?.screen ?? UIScreen.main
+    let screenSize = screen.bounds.size
+    let insets = safeAreaInsets
+    let width = max(0, bounds.width)
+    let height = max(0, bounds.height)
+    let contentWidth = max(0, width - insets.left - insets.right)
+    let contentHeight = max(0, height - insets.top - insets.bottom)
+    let orientation: String
+    switch window?.windowScene?.interfaceOrientation {
+    case .landscapeLeft: orientation = "landscape-left"
+    case .landscapeRight: orientation = "landscape-right"
+    case .portraitUpsideDown: orientation = "portrait-upside-down"
+    case .portrait: orientation = "portrait"
+    default: orientation = width > height ? "landscape" : "portrait"
+    }
+    let theme: String
+    switch traitCollection.userInterfaceStyle {
+    case .dark: theme = "dark"
+    case .light: theme = "light"
+    default: theme = "system"
+    }
+    let locale = Locale.current.identifier
+    let language = Locale.current.languageCode ?? locale.split(separator: "_").first.map(String.init) ?? locale
+    let isTablet = UIDevice.current.userInterfaceIdiom == .pad
+    let isNotchScreen = UIDevice.current.userInterfaceIdiom == .phone && insets.top > 20
+    var props = globalProps
+    props["os"] = "ios"
+    props["osVersion"] = UIDevice.current.systemVersion
+    props["deviceModel"] = UIDevice.current.model
+    props["containerID"] = containerID
+    props["containerInitTime"] = containerInitTime
+    props["screenWidth"] = screenSize.width
+    props["screenHeight"] = screenSize.height
+    props["contentWidth"] = contentWidth
+    props["contentHeight"] = contentHeight
+    props["safeAreaInsets"] = [
+      "top": insets.top,
+      "right": insets.right,
+      "bottom": insets.bottom,
+      "left": insets.left,
+    ]
+    props["pixelRatio"] = screen.scale
+    props["accessibleMode"] = UIAccessibility.isVoiceOverRunning ? 1 : 0
+    props["isIPhoneX"] = isNotchScreen ? 1 : 0
+    props["isIPhoneXMax"] = isNotchScreen ? 1 : 0
+    props["isPad"] = isTablet ? 1 : 0
+    props["isNotchScreen"] = isNotchScreen
+    props["isLowPowerMode"] = ProcessInfo.processInfo.isLowPowerModeEnabled ? 1 : 0
+    props["orientation"] = orientation
+    props["screenOrientation"] = orientation
+    props["theme"] = theme
+    props["appLanguage"] = language
+    props["appLocale"] = locale
+    props["isAppBackground"] = appInBackground
+    props["queryItems"] = [String: String]()
+    props["topHeight"] = insets.top
+    props["bottomHeight"] = insets.bottom
+    props["safeAreaHeight"] = insets.top
+    return props
+  }
+
   private func checkForUpdate() {
     Task { [weak self] in
       guard let self else { return }
@@ -150,4 +372,9 @@ public final class LynxShipExpoView: ExpoView {
       return nil
     }
   }
+
+  deinit {
+    loadState = "released"
+    lynxView.destroy()
+  }
 }

package/package.json

@@ -1,17 +1,23 @@
 {
   "name": "@lynxship/expo",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Expo native LynxView with LynxShip OTA delivery and cache support.",
   "license": "MIT",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [
     "dist",
-    "android",
-    "ios",
+    "android/build.gradle",
+    "android/consumer-rules.pro",
+    "android/src",
+    "ios/*.podspec",
+    "ios/*.h",
+    "ios/*.m",
+    "ios/*.swift",
     "src",
     "app.plugin.js",
     "app.plugin.cjs",
+    "asset-sync.cjs.d.cts",
     "asset-sync.cjs",
     "expo-module.config.json",
     "lynxship-expo.podspec",
@@ -42,6 +48,7 @@
   "peerDependencies": {
     "@expo/config-plugins": ">=9",
     "expo": ">=52",
+    "expo-modules-core": ">=52",
     "react": ">=18",
     "react-native": ">=0.76"
   },
@@ -49,8 +56,8 @@
     "expo-modules-core": "57.0.13"
   },
   "dependencies": {
-    "@lynxship/sdk-ios": "0.1.0",
-    "@lynxship/sdk-android": "0.1.0"
+    "@lynxship/sdk-android": "0.1.0",
+    "@lynxship/sdk-ios": "0.1.0"
   },
   "scripts": {
     "build": "tsc -b tsconfig.json",

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" &&