expo-modules-core 1.11.13 → 1.12.1

package/ios/Fabric/ExpoFabricView.swift

@@ -21,11 +21,10 @@ public class ExpoFabricView: ExpoFabricViewObjC {
     return appContext?.moduleRegistry.get(moduleHolderForName: moduleName)
   }
 
-
   /**
    A dictionary of prop objects that contain prop setters.
    */
-  lazy var viewManagerPropDict: [String: AnyViewProp]? = moduleHolder?.viewManager?.propsDict()
+  lazy var viewManagerPropDict: [String: AnyViewProp]? = moduleHolder?.definition.view?.propsDict()
 
   // MARK: - Initializers
 
@@ -62,10 +61,10 @@ public class ExpoFabricView: ExpoFabricViewObjC {
    Calls lifecycle methods registered by `OnViewDidUpdateProps` definition component.
    */
   public override func viewDidUpdateProps() {
-    guard let view = contentView, let viewManager = moduleHolder?.definition.viewManager else {
+    guard let view = contentView, let viewDefinition = moduleHolder?.definition.view else {
       return
     }
-    viewManager.callLifecycleMethods(withType: .didUpdateProps, forView: view)
+    viewDefinition.callLifecycleMethods(withType: .didUpdateProps, forView: view)
   }
 
   /**
@@ -110,7 +109,7 @@ public class ExpoFabricView: ExpoFabricViewObjC {
     guard let appContext = appContext else {
       fatalError(Exceptions.AppContextLost().reason)
     }
-    guard let view = moduleHolder?.definition.viewManager?.createView(appContext: appContext) else {
+    guard let view = moduleHolder?.definition.view?.createView(appContext: appContext) else {
       fatalError("Cannot create a view from module '\(moduleName)'")
     }
     // Setting the content view automatically adds the view as a subview.
@@ -125,7 +124,7 @@ public class ExpoFabricView: ExpoFabricViewObjC {
     guard let view = contentView, let moduleHolder = moduleHolder else {
       return
     }
-    moduleHolder.viewManager?.eventNames.forEach { eventName in
+    moduleHolder.definition.view?.eventNames.forEach { eventName in
       installEventDispatcher(forEvent: eventName, onView: view) { [weak self] (body: [String: Any]) in
         if let self = self {
           self.dispatchEvent(eventName, payload: body)

package/ios/FileSystemUtilities/FileSystemLegacyUtilities.swift

@@ -0,0 +1,111 @@
+// Copyright 2023-present 650 Industries. All rights reserved.
+
+import Foundation
+
+@objc(EXFileSystemLegacyUtilities)
+public class FileSystemLegacyUtilities: NSObject, EXInternalModule, EXFileSystemInterface, EXFilePermissionModuleInterface {
+  @objc
+  public var documentDirectory: String
+
+  @objc
+  public var cachesDirectory: String
+
+  var isScoped: Bool = false
+
+  @objc
+  public init(documentDirectory: String, cachesDirectory: String) {
+    self.documentDirectory = documentDirectory
+    self.cachesDirectory = cachesDirectory
+    self.isScoped = true
+
+    super.init()
+    ensureDirExists(withPath: self.cachesDirectory)
+    ensureDirExists(withPath: self.documentDirectory)
+  }
+
+  required public override init() {
+    let documentPaths = NSSearchPathForDirectoriesInDomains(.documentDirectory, .userDomainMask, true)
+    self.documentDirectory = documentPaths[0]
+
+    let cachesPaths = NSSearchPathForDirectoriesInDomains(.cachesDirectory, .userDomainMask, true)
+    self.cachesDirectory = cachesPaths[0]
+
+    super.init()
+    ensureDirExists(withPath: self.cachesDirectory)
+    ensureDirExists(withPath: self.documentDirectory)
+  }
+
+  public static func exportedInterfaces() -> [Protocol] {
+    return [EXFileSystemInterface.self, EXFilePermissionModuleInterface.self]
+  }
+
+  @objc
+  public func permissions(forURI uri: URL) -> EXFileSystemPermissionFlags {
+    let validSchemas = [
+      "assets-library",
+      "http",
+      "https",
+      "ph"
+    ]
+
+    if validSchemas.contains(uri.scheme ?? "") {
+      return EXFileSystemPermissionFlags.read
+    }
+    if uri.scheme == "file" {
+      return getPathPermissions(uri.absoluteString)
+    }
+    return []
+  }
+
+  @objc
+  public func generatePath(inDirectory directory: String, withExtension ext: String) -> String {
+    let fileName = "\(UUID().uuidString)\(ext)"
+    ensureDirExists(withPath: directory)
+    return (directory as NSString).appendingPathComponent(fileName)
+  }
+
+  @objc
+  public func ensureDirExists(withPath path: String) -> Bool {
+    let url = URL(fileURLWithPath: path)
+    return FileSystemUtilities.ensureDirExists(at: url)
+  }
+
+  @objc
+  public func getPathPermissions(_ path: String) -> EXFileSystemPermissionFlags {
+    guard let url = URL(string: path) else {
+      return []
+    }
+    let permissionsForInternalDirectories = getInternalPathPermissions(url)
+    if !permissionsForInternalDirectories.isEmpty {
+      return permissionsForInternalDirectories
+    }
+    return getExternalPathPermissions(url)
+  }
+
+  @objc
+  public func getInternalPathPermissions(_ url: URL) -> EXFileSystemPermissionFlags {
+    let scopedDirs: [String] = [cachesDirectory, documentDirectory]
+    let standardizedPath = url.standardized.path
+    for scopedDirectory in scopedDirs {
+      if standardizedPath.hasPrefix(scopedDirectory + "/") || standardizedPath == scopedDirectory {
+        return [.read, .write]
+      }
+    }
+    return []
+  }
+
+  @objc
+  public func getExternalPathPermissions(_ url: URL) -> EXFileSystemPermissionFlags {
+    if self.isScoped && url.path.contains("ExponentExperienceData") {
+      return []
+    }
+    var filePermissions: EXFileSystemPermissionFlags = []
+    if FileManager.default.isReadableFile(atPath: url.absoluteString) {
+      filePermissions.insert(.read)
+    }
+    if FileManager.default.isWritableFile(atPath: url.absoluteString) {
+      filePermissions.insert(.write)
+    }
+    return filePermissions
+  }
+}

package/ios/JSI/EXJSIInstaller.h

@@ -6,6 +6,15 @@
 @class EXAppContext;
 @class EXRuntime;
 
+#if __has_include(<ReactCommon/RCTRuntimeExecutor.h>)
+@class RCTRuntimeExecutor;
+#endif // React Native >=0.74
+
+/**
+ Property name of the core object in the global scope of the Expo JS runtime.
+ */
+extern NSString * _Nonnull const EXGlobalCoreObjectPropertyName;
+
 @interface EXJavaScriptRuntimeManager : NSObject
 
 /**
@@ -14,10 +23,29 @@
  */
 + (nullable EXRuntime *)runtimeFromBridge:(nonnull RCTBridge *)bridge NS_SWIFT_NAME(runtime(fromBridge:));
 
+#if __has_include(<ReactCommon/RCTRuntimeExecutor.h>)
++ (nullable EXRuntime *)runtimeFromBridge:(nonnull RCTBridge *)bridge withExecutor:(nonnull RCTRuntimeExecutor *)executor;
+#endif // React Native >=0.74
+
 /**
  Installs ExpoModules host object in the runtime of the given app context.
  Returns a bool value whether the installation succeeded.
  */
 + (BOOL)installExpoModulesHostObject:(nonnull EXAppContext *)appContext;
 
+/**
+ Installs the base class for shared objects, i.e. `global.expo.SharedObject`.
+ */
++ (void)installSharedObjectClass:(nonnull EXRuntime *)runtime releaser:(void(^)(long))releaser;
+
+/**
+ Installs the EventEmitter class in the given runtime as `global.expo.EventEmitter`.
+ */
++ (void)installEventEmitterClass:(nonnull EXRuntime *)runtime;
+
+/**
+ Installs the NativeModule class in the given runtime as `global.expo.NativeModule`.
+ */
++ (void)installNativeModuleClass:(nonnull EXRuntime *)runtime;
+
 @end

package/ios/JSI/EXJSIInstaller.mm

@@ -1,22 +1,30 @@
 // Copyright 2018-present 650 Industries. All rights reserved.
 
+#if __has_include(<ReactCommon/RCTRuntimeExecutor.h>)
+#import <ReactCommon/RCTRuntimeExecutor.h>
+#endif // React Native >=0.74
+
 #import <ExpoModulesCore/EXJSIInstaller.h>
 #import <ExpoModulesCore/EXJavaScriptRuntime.h>
 #import <ExpoModulesCore/ExpoModulesHostObject.h>
+#import <ExpoModulesCore/BridgelessJSCallInvoker.h>
 #import <ExpoModulesCore/LazyObject.h>
+#import <ExpoModulesCore/SharedObject.h>
+#import <ExpoModulesCore/EventEmitter.h>
+#import <ExpoModulesCore/NativeModule.h>
 #import <ExpoModulesCore/Swift.h>
 
 namespace jsi = facebook::jsi;
 
 /**
- Property name used to define the modules host object in the main object of the Expo JS runtime.
+ Property name of the core object in the global scope of the Expo JS runtime.
  */
-static NSString *modulesHostObjectPropertyName = @"modules";
+NSString *const EXGlobalCoreObjectPropertyName = @"expo";
 
 /**
- Property name used to define the modules host object in the global object of the Expo JS runtime (legacy).
+ Property name used to define the modules host object in the main object of the Expo JS runtime.
  */
-static NSString *modulesHostObjectLegacyPropertyName = @"ExpoModules";
+static NSString *modulesHostObjectPropertyName = @"modules";
 
 @interface RCTBridge (ExpoBridgeWithRuntime)
 
@@ -29,10 +37,31 @@ static NSString *modulesHostObjectLegacyPropertyName = @"ExpoModules";
 
 + (nullable EXRuntime *)runtimeFromBridge:(nonnull RCTBridge *)bridge
 {
-  jsi::Runtime *jsiRuntime = [bridge respondsToSelector:@selector(runtime)] ? reinterpret_cast<jsi::Runtime *>(bridge.runtime) : nullptr;
+  jsi::Runtime *jsiRuntime = reinterpret_cast<jsi::Runtime *>(bridge.runtime);
   return jsiRuntime ? [[EXRuntime alloc] initWithRuntime:jsiRuntime callInvoker:bridge.jsCallInvoker] : nil;
 }
 
+#if __has_include(<ReactCommon/RCTRuntimeExecutor.h>)
++ (nullable EXRuntime *)runtimeFromBridge:(nonnull RCTBridge *)bridge withExecutor:(nonnull RCTRuntimeExecutor *)executor
+{
+  jsi::Runtime *jsiRuntime = reinterpret_cast<jsi::Runtime *>(bridge.runtime);
+
+  // Create a call invoker based on the given runtime executor.
+  auto callInvoker = std::make_shared<expo::BridgelessJSCallInvoker>([executor](std::function<void(jsi::Runtime &runtime)> &&callback) {
+    // Convert to Objective-C block so it can be captured properly.
+    __block auto callbackBlock = callback;
+
+    [executor execute:^(jsi::Runtime &runtime) {
+      callbackBlock(runtime);
+    }];
+  });
+
+  return jsiRuntime ? [[EXRuntime alloc] initWithRuntime:jsiRuntime callInvoker:callInvoker] : nil;
+}
+#endif // React Native >=0.74
+
+#pragma mark - Installing JSI bindings
+
 + (BOOL)installExpoModulesHostObject:(nonnull EXAppContext *)appContext
 {
   EXRuntime *runtime = [appContext _runtime];
@@ -43,7 +72,9 @@ static NSString *modulesHostObjectLegacyPropertyName = @"ExpoModules";
   }
 
   EXJavaScriptObject *global = [runtime global];
-  EXJavaScriptObject *coreObject = [runtime coreObject];
+  EXJavaScriptValue *coreProperty = [global getProperty:EXGlobalCoreObjectPropertyName];
+  NSAssert([coreProperty isObject], @"The global core property should be an object");
+  EXJavaScriptObject *coreObject = [coreProperty getObject];
 
   if ([coreObject hasProperty:modulesHostObjectPropertyName]) {
     return false;
@@ -57,11 +88,24 @@ static NSString *modulesHostObjectLegacyPropertyName = @"ExpoModules";
                        value:modulesHostObject
                      options:EXJavaScriptObjectPropertyDescriptorEnumerable];
 
-  // Also define `global.ExpoModules` for backwards compatibility (used before SDK47, can be removed in SDK48).
-  [global defineProperty:modulesHostObjectLegacyPropertyName
-                   value:modulesHostObject
-                 options:EXJavaScriptObjectPropertyDescriptorEnumerable];
   return true;
 }
 
++ (void)installSharedObjectClass:(nonnull EXRuntime *)runtime releaser:(void(^)(long))releaser
+{
+  expo::SharedObject::installBaseClass(*[runtime get], [releaser](expo::SharedObject::ObjectId objectId) {
+    releaser(objectId);
+  });
+}
+
++ (void)installEventEmitterClass:(nonnull EXRuntime *)runtime
+{
+  expo::EventEmitter::installClass(*[runtime get]);
+}
+
++ (void)installNativeModuleClass:(nonnull EXRuntime *)runtime
+{
+  expo::NativeModule::installClass(*[runtime get]);
+}
+
 @end

package/ios/JSI/EXJSIUtils.h

@@ -20,17 +20,6 @@ using PromiseInvocationBlock = void (^)(RCTPromiseResolveBlock resolveWrapper, R
 
 void callPromiseSetupWithBlock(jsi::Runtime &runtime, std::shared_ptr<react::CallInvoker> jsInvoker, std::shared_ptr<react::Promise> promise, PromiseInvocationBlock setupBlock);
 
-#pragma mark - Classes
-
-using ClassConstructor = std::function<void(jsi::Runtime &runtime, const jsi::Value &thisValue, const jsi::Value *args, size_t count)>;
-
-std::shared_ptr<jsi::Function> createClass(jsi::Runtime &runtime, const char *name, ClassConstructor constructor);
-
-/**
- Creates a new object, using the provided object as the prototype.
- */
-std::shared_ptr<jsi::Object> createObjectWithPrototype(jsi::Runtime &runtime, std::shared_ptr<jsi::Object> prototype);
-
 #pragma mark - Weak objects
 
 /**
@@ -60,3 +49,18 @@ jsi::Value makeCodedError(jsi::Runtime &runtime, NSString *code, NSString *messa
 } // namespace expo
 
 #endif
+
+#import <ExpoModulesCore/EXJavaScriptObject.h>
+#import <ExpoModulesCore/EXJavaScriptRuntime.h>
+
+NS_SWIFT_NAME(JSIUtils)
+@interface EXJSIUtils : NSObject
+
++ (nonnull EXJavaScriptObject *)createNativeModuleObject:(nonnull EXJavaScriptRuntime *)runtime;
+
++ (void)emitEvent:(nonnull NSString *)eventName
+         toObject:(nonnull EXJavaScriptObject *)object
+    withArguments:(nonnull NSArray<id> *)arguments
+        inRuntime:(nonnull EXJavaScriptRuntime *)runtime;
+
+@end

package/ios/JSI/EXJSIUtils.mm

@@ -6,6 +6,8 @@
 #import <ExpoModulesCore/EXJSIConversions.h>
 #import <ExpoModulesCore/EXJSIUtils.h>
 #import <ExpoModulesCore/JSIUtils.h>
+#import <ExpoModulesCore/NativeModule.h>
+#import <ExpoModulesCore/EventEmitter.h>
 
 namespace expo {
 
@@ -87,55 +89,6 @@ void callPromiseSetupWithBlock(jsi::Runtime &runtime, std::shared_ptr<CallInvoke
   setupBlock(resolveBlock, rejectBlock);
 }
 
-std::shared_ptr<jsi::Function> createClass(jsi::Runtime &runtime, const char *name, ClassConstructor constructor) {
-  std::string nativeConstructorKey("__native_constructor__");
-
-  // Create a string buffer of the source code to evaluate.
-  std::stringstream source;
-  source << "(function " << name << "(...args) { this." << nativeConstructorKey << "(...args); return this; })";
-  std::shared_ptr<jsi::StringBuffer> sourceBuffer = std::make_shared<jsi::StringBuffer>(source.str());
-
-  // Evaluate the code and obtain returned value (the constructor function).
-  jsi::Object klass = runtime.evaluateJavaScript(sourceBuffer, "").asObject(runtime);
-
-  // Set the native constructor in the prototype.
-  jsi::Object prototype = klass.getPropertyAsObject(runtime, "prototype");
-  jsi::PropNameID nativeConstructorPropId = jsi::PropNameID::forAscii(runtime, nativeConstructorKey);
-  jsi::Function nativeConstructor = jsi::Function::createFromHostFunction(
-    runtime,
-    nativeConstructorPropId,
-    // The paramCount is not obligatory to match, it only affects the `length` property of the function.
-    0,
-    [constructor](jsi::Runtime &runtime, const jsi::Value &thisValue, const jsi::Value *args, size_t count) -> jsi::Value {
-      constructor(runtime, thisValue, args, count);
-      return jsi::Value::undefined();
-    });
-
-  jsi::Object descriptor(runtime);
-  descriptor.setProperty(runtime, "value", jsi::Value(runtime, nativeConstructor));
-
-  common::definePropertyOnJSIObject(runtime, &prototype, nativeConstructorKey.c_str(), std::move(descriptor));
-
-  return std::make_shared<jsi::Function>(klass.asFunction(runtime));
-}
-
-std::shared_ptr<jsi::Object> createObjectWithPrototype(jsi::Runtime &runtime, std::shared_ptr<jsi::Object> prototype) {
-  // Get the "Object" class.
-  jsi::Object objectClass = runtime
-    .global()
-    .getPropertyAsObject(runtime, "Object");
-
-  // Call "Object.create(prototype)" to create an object with the given prototype without calling the constructor.
-  jsi::Object object = objectClass
-    .getPropertyAsFunction(runtime, "create")
-    .callWithThis(runtime, objectClass, {
-      jsi::Value(runtime, *prototype)
-    })
-    .asObject(runtime);
-
-  return std::make_shared<jsi::Object>(std::move(object));
-}
-
 #pragma mark - Weak objects
 
 bool isWeakRefSupported(jsi::Runtime &runtime) {
@@ -183,3 +136,22 @@ jsi::Value makeCodedError(jsi::Runtime &runtime, NSString *code, NSString *messa
 }
 
 } // namespace expo
+
+@implementation EXJSIUtils
+
++ (nonnull EXJavaScriptObject *)createNativeModuleObject:(nonnull EXJavaScriptRuntime *)runtime
+{
+  std::shared_ptr<jsi::Object> nativeModule = std::make_shared<jsi::Object>(expo::NativeModule::createInstance(*[runtime get]));
+  return [[EXJavaScriptObject alloc] initWith:nativeModule runtime:runtime];
+}
+
++ (void)emitEvent:(nonnull NSString *)eventName
+         toObject:(nonnull EXJavaScriptObject *)object
+    withArguments:(nonnull NSArray<id> *)arguments
+        inRuntime:(nonnull EXJavaScriptRuntime *)runtime
+{
+  const std::vector<jsi::Value> argumentsVector(expo::convertNSArrayToStdVector(*[runtime get], arguments));
+  expo::EventEmitter::emitEvent(*[runtime get], *[object get], [eventName UTF8String], std::move(argumentsVector));
+}
+
+@end

package/ios/JSI/EXJavaScriptObject.mm

@@ -76,7 +76,7 @@
   jsi::Runtime *runtime = [_runtime get];
   jsi::Object *jsThis = _jsObjectPtr.get();
 
-  expo::common::definePropertyOnJSIObject(*runtime, jsThis, [name UTF8String], std::move(*[descriptor get]));
+  expo::common::defineProperty(*runtime, jsThis, [name UTF8String], std::move(*[descriptor get]));
 }
 
 - (void)defineProperty:(nonnull NSString *)name value:(nullable id)value options:(EXJavaScriptObjectPropertyDescriptor)options
@@ -87,7 +87,7 @@
   jsi::Object descriptor = [self preparePropertyDescriptorWithOptions:options];
   descriptor.setProperty(*runtime, "value", expo::convertObjCObjectToJSIValue(*runtime, value));
 
-  expo::common::definePropertyOnJSIObject(*runtime, jsThis, [name UTF8String], std::move(descriptor));
+  expo::common::defineProperty(*runtime, jsThis, [name UTF8String], std::move(descriptor));
 }
 
 #pragma mark - WeakObject

package/ios/JSI/EXJavaScriptRuntime.h

@@ -14,6 +14,9 @@ namespace react = facebook::react;
 
 @class EXJavaScriptValue;
 @class EXJavaScriptObject;
+@class EXJavaScriptSharedObject;
+
+typedef void (^JSRuntimeExecutionBlock)();
 
 typedef void (^JSAsyncFunctionBlock)(EXJavaScriptValue * _Nonnull thisValue,
                                      NSArray<EXJavaScriptValue *> * _Nonnull arguments,
@@ -102,6 +105,11 @@ typedef void (^ClassConstructorBlock)(EXJavaScriptObject * _Nonnull thisValue, N
  */
 - (nullable EXJavaScriptObject *)createObjectWithPrototype:(nonnull EXJavaScriptObject *)prototype;
 
+#pragma mark - Shared objects
+
+- (nonnull EXJavaScriptObject *)createSharedObjectClass:(nonnull NSString *)name
+                                            constructor:(nonnull ClassConstructorBlock)constructor;
+
 #pragma mark - Script evaluation
 
 /**
@@ -109,4 +117,11 @@ typedef void (^ClassConstructorBlock)(EXJavaScriptObject * _Nonnull thisValue, N
  */
 - (nonnull EXJavaScriptValue *)evaluateScript:(nonnull NSString *)scriptSource NS_REFINED_FOR_SWIFT;
 
+#pragma mark - Runtime execution
+
+/**
+ Schedules a block to be executed with granted synchronized access to the JS runtime.
+ */
+- (void)schedule:(nonnull JSRuntimeExecutionBlock)block priority:(int)priority NS_REFINED_FOR_SWIFT;
+
 @end

package/ios/JSI/EXJavaScriptRuntime.mm

@@ -18,28 +18,9 @@
 #import <ExpoModulesCore/ExpoModulesHostObject.h>
 #import <ExpoModulesCore/EXJSIUtils.h>
 #import <ExpoModulesCore/EXJSIConversions.h>
+#import <ExpoModulesCore/SharedObject.h>
 #import <ExpoModulesCore/Swift.h>
-
-namespace {
-
-/**
- * Dummy CallInvoker that invokes everything immediately.
- * Used in the test environment to check the async flow.
- */
-class SyncCallInvoker : public react::CallInvoker {
-public:
-  void invokeAsync(std::function<void()> &&func) override {
-    func();
-  }
-
-  void invokeSync(std::function<void()> &&func) override {
-    func();
-  }
-
-  ~SyncCallInvoker() override = default;
-};
-
-} // namespace
+#import <ExpoModulesCore/TestingSyncJSCallInvoker.h>
 
 @implementation EXJavaScriptRuntime {
   std::shared_ptr<jsi::Runtime> _runtime;
@@ -70,7 +51,7 @@ public:
 #else
     _runtime = jsc::makeJSCRuntime();
 #endif
-    _jsCallInvoker = std::make_shared<SyncCallInvoker>();
+    _jsCallInvoker = std::make_shared<expo::TestingSyncJSCallInvoker>(_runtime);
   }
   return self;
 }
@@ -131,7 +112,20 @@ public:
       if (error == nil) {
         return expo::convertObjCObjectToJSIValue(runtime, result);
       } else {
-        throw jsi::JSError(runtime, [error.userInfo[@"message"] UTF8String]);
+        // `expo::makeCodedError` doesn't work during unit tests, so we construct Error and add a code,
+        // instead of using the CodedError subclass.
+        jsi::String jsCode = expo::convertNSStringToJSIString(runtime, error.userInfo[@"code"]);
+        jsi::String jsMessage = expo::convertNSStringToJSIString(runtime, error.userInfo[@"message"]);
+        jsi::Value error = runtime
+          .global()
+          .getProperty(runtime, "Error")
+          .asObject(runtime)
+          .asFunction(runtime)
+          .callAsConstructor(runtime, {
+            jsi::Value(runtime, jsMessage)
+          });
+        error.asObject(runtime).setProperty(runtime, "code", jsi::Value(runtime, jsCode));
+        throw jsi::JSError(runtime, jsi::Value(runtime, error));
       }
     };
   return [self createHostFunction:name argsCount:argsCount block:hostFunctionBlock];
@@ -167,23 +161,43 @@ public:
 - (nonnull EXJavaScriptObject *)createClass:(nonnull NSString *)name
                                 constructor:(nonnull ClassConstructorBlock)constructor
 {
-  expo::ClassConstructor jsConstructor = [self, constructor](jsi::Runtime &runtime, const jsi::Value &thisValue, const jsi::Value *args, size_t count) {
+  expo::common::ClassConstructor jsConstructor = [self, constructor](jsi::Runtime &runtime, const jsi::Value &thisValue, const jsi::Value *args, size_t count) -> jsi::Value {
     std::shared_ptr<jsi::Object> thisPtr = std::make_shared<jsi::Object>(thisValue.asObject(runtime));
     EXJavaScriptObject *caller = [[EXJavaScriptObject alloc] initWith:thisPtr runtime:self];
     NSArray<EXJavaScriptValue *> *arguments = expo::convertJSIValuesToNSArray(self, args, count);
 
+    // Returning something else than `this` is not supported in native constructors.
     constructor(caller, arguments);
+
+    return jsi::Value(runtime, thisValue);
   };
-  std::shared_ptr<jsi::Function> klass = expo::createClass(*_runtime, [name UTF8String], jsConstructor);
+  std::shared_ptr<jsi::Function> klass = std::make_shared<jsi::Function>(expo::common::createClass(*_runtime, [name UTF8String], jsConstructor));
   return [[EXJavaScriptObject alloc] initWith:klass runtime:self];
 }
 
 - (nullable EXJavaScriptObject *)createObjectWithPrototype:(nonnull EXJavaScriptObject *)prototype
 {
-  std::shared_ptr<jsi::Object> object = expo::createObjectWithPrototype(*_runtime, [prototype getShared]);
+  std::shared_ptr<jsi::Object> object = std::make_shared<jsi::Object>(expo::common::createObjectWithPrototype(*_runtime, [prototype getShared].get()));
   return object ? [[EXJavaScriptObject alloc] initWith:object runtime:self] : nil;
 }
 
+#pragma mark - Shared objects
+
+- (nonnull EXJavaScriptObject *)createSharedObjectClass:(nonnull NSString *)name
+                                            constructor:(nonnull ClassConstructorBlock)constructor
+{
+  expo::common::ClassConstructor jsConstructor = [self, constructor](jsi::Runtime &runtime, const jsi::Value &thisValue, const jsi::Value *args, size_t count) {
+    std::shared_ptr<jsi::Object> thisPtr = std::make_shared<jsi::Object>(thisValue.asObject(runtime));
+    EXJavaScriptObject *caller = [[EXJavaScriptObject alloc] initWith:thisPtr runtime:self];
+    NSArray<EXJavaScriptValue *> *arguments = expo::convertJSIValuesToNSArray(self, args, count);
+
+    constructor(caller, arguments);
+    return jsi::Value(runtime, thisValue);
+  };
+  std::shared_ptr<jsi::Function> klass = std::make_shared<jsi::Function>(expo::SharedObject::createClass(*_runtime, [name UTF8String], jsConstructor));
+  return [[EXJavaScriptObject alloc] initWith:klass runtime:self];
+}
+
 #pragma mark - Script evaluation
 
 - (nonnull EXJavaScriptValue *)evaluateScript:(nonnull NSString *)scriptSource
@@ -211,6 +225,19 @@ public:
   return [[EXJavaScriptValue alloc] initWithRuntime:self value:result];
 }
 
+#pragma mark - Runtime execution
+
+- (void)schedule:(nonnull JSRuntimeExecutionBlock)block priority:(int)priority
+{
+#if REACT_NATIVE_TARGET_VERSION >= 75
+  _jsCallInvoker->invokeAsync(SchedulerPriority(priority), [block = std::move(block)](jsi::Runtime&) {
+    block();
+  });
+#else
+  _jsCallInvoker->invokeAsync(SchedulerPriority(priority), block);
+#endif
+}
+
 #pragma mark - Private
 
 - (nonnull EXJavaScriptObject *)createHostFunction:(nonnull NSString *)name

package/ios/JSI/EXSharedObjectUtils.h

@@ -0,0 +1,15 @@
+// Copyright 2024-present 650 Industries. All rights reserved.
+
+#import <ExpoModulesCore/EXJavaScriptObject.h>
+
+typedef void (^ObjectReleaser)(long objectId);
+
+NS_SWIFT_NAME(SharedObjectUtils)
+@interface EXSharedObjectUtils : NSObject
+
++ (void)setNativeState:(nonnull EXJavaScriptObject *)object
+               runtime:(nonnull EXJavaScriptRuntime *)runtime
+              objectId:(long)objectId
+              releaser:(nonnull ObjectReleaser)releaser;
+
+@end

package/ios/JSI/EXSharedObjectUtils.mm

@@ -0,0 +1,18 @@
+// Copyright 2024-present 650 Industries. All rights reserved.
+
+#import <ExpoModulesCore/EXJavaScriptRuntime.h>
+#import <ExpoModulesCore/EXSharedObjectUtils.h>
+#import <ExpoModulesCore/SharedObject.h>
+
+@implementation EXSharedObjectUtils
+
++ (void)setNativeState:(nonnull EXJavaScriptObject *)object
+               runtime:(nonnull EXJavaScriptRuntime *)runtime
+              objectId:(long)objectId
+              releaser:(nonnull ObjectReleaser)releaser
+{
+  auto nativeState = std::make_shared<expo::SharedObject::NativeState>(objectId, releaser);
+  [object get]->setNativeState(*[runtime get], nativeState);
+}
+
+@end

package/ios/JSI/JavaScriptRuntime.swift

@@ -60,6 +60,22 @@ public extension JavaScriptRuntime {
       }
     }
   }
+
+  /**
+   Schedules a block to be executed with granted synchronized access to the JS runtime.
+   */
+  public func schedule(priority: SchedulerPriority = .normal, _ closure: @escaping () -> Void) {
+    __schedule(closure, priority: priority.rawValue)
+  }
+}
+
+// Keep it in sync with the equivalent C++ enum from React Native (see SchedulerPriority.h from React-callinvoker).
+public enum SchedulerPriority: Int32 {
+  case immediate = 1
+  case userBlocking = 2
+  case normal = 3
+  case low = 4
+  case idle = 5
 }
 
 internal final class JavaScriptEvalException: GenericException<NSError> {

package/ios/Legacy/ModuleRegistry/EXModuleRegistry.m

@@ -4,6 +4,7 @@
 
 #import <ExpoModulesCore/EXModuleRegistry.h>
 #import <ExpoModulesCore/EXModuleRegistryConsumer.h>
+#import <ExpoModulesCore/Swift.h>
 
 @interface EXModuleRegistry ()