@clix-so/react-native-sdk 0.0.2-beta.2 → 0.0.2-beta.3

package/clix-react-native-sdk.podspec

@@ -0,0 +1,19 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name         = 'clix-react-native-sdk'
+  s.version      = package['version']
+  s.summary      = package['description'] || 'Clix React Native SDK'
+  s.description  = package['description'] || 'Clix React Native SDK'
+  s.homepage     = package['homepage']
+  s.license      = { :type => package['license'], :text => 'See LICENSE file' }
+  s.author       = package['author']
+  s.platform     = :ios, '14.0'
+  s.source       = { :git => 'https://github.com/clix-so/clix-react-native-sdk.git', :tag => "v#{package['version']}" }
+  s.source_files = 'ios/**/*.{h,m,mm,swift}'
+  s.requires_arc = true
+
+  s.dependency 'React-Core'
+end

package/ios/ClixAppGroupDirectory.h

@@ -0,0 +1,4 @@
+#import <React/RCTBridgeModule.h>
+
+@interface ClixAppGroupDirectory : NSObject <RCTBridgeModule>
+@end

package/ios/ClixAppGroupDirectory.m

@@ -0,0 +1,75 @@
+#import <Foundation/Foundation.h>
+#import "ClixAppGroupDirectory.h"
+#import <React/RCTLog.h>
+
+@implementation ClixAppGroupDirectory
+
+RCT_EXPORT_MODULE();
+
++ (BOOL)requiresMainQueueSetup
+{
+  return NO;
+}
+
+static NSString *const kClixDefaultBundleIdentifier = @"com.clix.default";
+static NSString *const kClixAppGroupPrefix = @"group.clix.";
+
++ (NSString *)resolvePrimaryBundleIdentifier
+{
+  static NSString *cachedIdentifier = nil;
+  static dispatch_once_t onceToken;
+  dispatch_once(&onceToken, ^{
+    NSString *bundleIdentifier = [[NSBundle mainBundle] bundleIdentifier];
+    if (bundleIdentifier == nil || bundleIdentifier.length == 0) {
+      id infoValue =
+          [[NSBundle mainBundle] objectForInfoDictionaryKey:@"CFBundleIdentifier"];
+      if ([infoValue isKindOfClass:[NSString class]]) {
+        NSString *value = (NSString *)infoValue;
+        if (value.length > 0) {
+          bundleIdentifier = value;
+        }
+      }
+    }
+
+    if (bundleIdentifier == nil || bundleIdentifier.length == 0) {
+      bundleIdentifier = kClixDefaultBundleIdentifier;
+    }
+
+    cachedIdentifier = bundleIdentifier;
+  });
+
+  return cachedIdentifier;
+}
+
++ (NSString *)bundleIdBasedAppGroupId:(NSString *)bundleIdentifier
+{
+  if (bundleIdentifier == nil || bundleIdentifier.length == 0) {
+    return nil;
+  }
+
+  return [NSString stringWithFormat:@"%@%@", kClixAppGroupPrefix, bundleIdentifier];
+}
+
++ (NSString *)resolveAppGroupIdentifier
+{
+  NSString *bundleIdentifier = [ClixAppGroupDirectory resolvePrimaryBundleIdentifier];
+  return [ClixAppGroupDirectory bundleIdBasedAppGroupId:bundleIdentifier];
+}
+
+RCT_EXPORT_BLOCKING_SYNCHRONOUS_METHOD(getAppGroupDirectory)
+{
+  NSString *identifier = [ClixAppGroupDirectory resolveAppGroupIdentifier];
+  if (identifier == nil || identifier.length == 0) {
+    return nil;
+  }
+
+  NSURL *url = [[NSFileManager defaultManager] containerURLForSecurityApplicationGroupIdentifier:identifier];
+  if (url == nil) {
+    RCTLogWarn(@"[Clix] Failed to resolve App Group path for identifier '%@'. Check your entitlements and make sure the group exists.", identifier);
+    return nil;
+  }
+
+  return url.path;
+}
+
+@end

package/lib/module/native/getAppGroupDirectory.js

@@ -0,0 +1,32 @@
+"use strict";
+
+import { NativeModules, Platform } from 'react-native';
+import { ClixLogger } from "../utils/logging/ClixLogger.js";
+const MODULE_NAME = 'ClixAppGroupDirectory';
+const resolveModule = () => {
+  const nativeModule = NativeModules[MODULE_NAME];
+  if (!nativeModule) {
+    return undefined;
+  }
+  return nativeModule;
+};
+export const getAppGroupDirectory = () => {
+  if (Platform.OS !== 'ios') {
+    return undefined;
+  }
+  const nativeModule = resolveModule();
+  if (!nativeModule || typeof nativeModule.getAppGroupDirectory !== 'function') {
+    ClixLogger.debug('App Group directory native module is unavailable. Falling back to default MMKV path.');
+    return undefined;
+  }
+  try {
+    const directory = nativeModule.getAppGroupDirectory();
+    if (typeof directory === 'string' && directory.length > 0) {
+      return directory;
+    }
+  } catch (error) {
+    ClixLogger.warn('Failed to resolve App Group directory', error);
+  }
+  return undefined;
+};
+//# sourceMappingURL=getAppGroupDirectory.js.map

package/lib/module/native/getAppGroupDirectory.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["NativeModules","Platform","ClixLogger","MODULE_NAME","resolveModule","nativeModule","undefined","getAppGroupDirectory","OS","debug","directory","length","error","warn"],"sourceRoot":"../../../src","sources":["native/getAppGroupDirectory.ts"],"mappings":";;AAAA,SAASA,aAAa,EAAEC,QAAQ,QAAQ,cAAc;AACtD,SAASC,UAAU,QAAQ,gCAA6B;AAMxD,MAAMC,WAAW,GAAG,uBAAuB;AAE3C,MAAMC,aAAa,GAAGA,CAAA,KAA+C;EACnE,MAAMC,YAAY,GAAIL,aAAa,CAA6BG,WAAW,CAAC;EAC5E,IAAI,CAACE,YAAY,EAAE;IACjB,OAAOC,SAAS;EAClB;EACA,OAAOD,YAAY;AACrB,CAAC;AAED,OAAO,MAAME,oBAAoB,GAAGA,CAAA,KAA0B;EAC5D,IAAIN,QAAQ,CAACO,EAAE,KAAK,KAAK,EAAE;IACzB,OAAOF,SAAS;EAClB;EAEA,MAAMD,YAAY,GAAGD,aAAa,CAAC,CAAC;EACpC,IACE,CAACC,YAAY,IACb,OAAOA,YAAY,CAACE,oBAAoB,KAAK,UAAU,EACvD;IACAL,UAAU,CAACO,KAAK,CACd,sFACF,CAAC;IACD,OAAOH,SAAS;EAClB;EAEA,IAAI;IACF,MAAMI,SAAS,GAAGL,YAAY,CAACE,oBAAoB,CAAC,CAAC;IACrD,IAAI,OAAOG,SAAS,KAAK,QAAQ,IAAIA,SAAS,CAACC,MAAM,GAAG,CAAC,EAAE;MACzD,OAAOD,SAAS;IAClB;EACF,CAAC,CAAC,OAAOE,KAAK,EAAE;IACdV,UAAU,CAACW,IAAI,CAAC,uCAAuC,EAAED,KAAK,CAAC;EACjE;EAEA,OAAON,SAAS;AAClB,CAAC","ignoreList":[]}

package/lib/module/services/StorageService.js

@@ -1,6 +1,7 @@
 "use strict";
 
 import * as MMKVModule from 'react-native-mmkv';
+import { getAppGroupDirectory } from "../native/getAppGroupDirectory.js";
 import { ClixLogger } from "../utils/logging/ClixLogger.js";
 
 // Support both v2/v3 (MMKV class) and v4 (createMMKV function)
@@ -9,6 +10,27 @@ export class StorageService {
   constructor(projectId) {
     this.storage = this.initializeCompat(projectId);
   }
+  getStoragePath() {
+    try {
+      const directory = getAppGroupDirectory();
+      if (!directory) {
+        return undefined;
+      }
+
+      /**
+       * NOTE(nyanxyz):
+       * On iOS the mmkv directory is located at {App Group Directory}/mmkv.
+       * RN MMKV v2 used {App Group Directory}/mmkv, but v3 switched to {App Group Directory}.
+       * We need to keep the directory aligned so iOS and RN can share storage.
+       * Therefore we explicitly target the mmkv folder inside the App Group directory.
+       * @see https://akshayjadhav.hashnode.dev/how-to-access-react-native-mmkv-in-a-ios-widget-react-native-expo
+       */
+      return `${directory}/mmkv`;
+    } catch (error) {
+      ClixLogger.warn('Failed to resolve App Group directory', error);
+      return undefined;
+    }
+  }
   initializeCompat(projectId) {
     const storageId = `clix.${projectId}`;
 
@@ -16,7 +38,10 @@ export class StorageService {
     if (typeof MMKVModule.createMMKV === 'function') {
       return MMKVModule.createMMKV({
         id: storageId,
-        encryptionKey: undefined // Add encryption if needed
+        encryptionKey: undefined,
+        // Add encryption if needed
+        path: this.getStoragePath(),
+        mode: 'multi-process'
       });
     }
     // v2/v3 API (MMKV class)
@@ -26,7 +51,10 @@ export class StorageService {
       } = MMKVModule;
       return new MMKV({
         id: storageId,
-        encryptionKey: undefined // Add encryption if needed
+        encryptionKey: undefined,
+        // Add encryption if needed
+        path: this.getStoragePath(),
+        mode: 'multi-process'
       });
     } else {
       throw new Error('No compatible MMKV storage API found');

package/lib/module/services/StorageService.js.map

@@ -1 +1 @@
-{"version":3,"names":["MMKVModule","ClixLogger","StorageService","constructor","projectId","storage","initializeCompat","storageId","createMMKV","id","encryptionKey","undefined","MMKV","Error","removeCompat","key","remove","delete","set","value","error","encoded","JSON","stringify","get","data","getString","decoded","parse","jsonError","debug","clear","clearAll","getAllKeys","keys","Array","from"],"sourceRoot":"../../../src","sources":["services/StorageService.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["MMKVModule","getAppGroupDirectory","ClixLogger","StorageService","constructor","projectId","storage","initializeCompat","getStoragePath","directory","undefined","error","warn","storageId","createMMKV","id","encryptionKey","path","mode","MMKV","Error","removeCompat","key","remove","delete","set","value","encoded","JSON","stringify","get","data","getString","decoded","parse","jsonError","debug","clear","clearAll","getAllKeys","keys","Array","from"],"sourceRoot":"../../../src","sources":["services/StorageService.ts"],"mappings":"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","ignoreList":[]}

package/lib/typescript/src/native/getAppGroupDirectory.d.ts

@@ -0,0 +1,2 @@
+export declare const getAppGroupDirectory: () => string | undefined;
+//# sourceMappingURL=getAppGroupDirectory.d.ts.map

package/lib/typescript/src/native/getAppGroupDirectory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAppGroupDirectory.d.ts","sourceRoot":"","sources":["../../../../src/native/getAppGroupDirectory.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,oBAAoB,QAAO,MAAM,GAAG,SA0BhD,CAAC"}

package/lib/typescript/src/services/StorageService.d.ts

@@ -1,6 +1,7 @@
 export declare class StorageService {
     private storage;
     constructor(projectId: string);
+    private getStoragePath;
     private initializeCompat;
     /**
      * Delete a key from storage (works with both v2/v3 and v4 APIs)

package/lib/typescript/src/services/StorageService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StorageService.d.ts","sourceRoot":"","sources":["../../../../src/services/StorageService.ts"],"names":[],"mappings":"AAaA,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAe;gBAElB,SAAS,EAAE,MAAM;IAI7B,OAAO,CAAC,gBAAgB;IAsBxB;;OAEG;IACH,OAAO,CAAC,YAAY;IAWpB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAoBnC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAuBlC,MAAM,CAAC,GAAG,EAAE,MAAM;IAUlB,KAAK;IASL,UAAU;CASX"}
+{"version":3,"file":"StorageService.d.ts","sourceRoot":"","sources":["../../../../src/services/StorageService.ts"],"names":[],"mappings":"AAcA,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAe;gBAElB,SAAS,EAAE,MAAM;IAI7B,OAAO,CAAC,cAAc;IAsBtB,OAAO,CAAC,gBAAgB;IA0BxB;;OAEG;IACH,OAAO,CAAC,YAAY;IAWpB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAoBnC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAuBlC,MAAM,CAAC,GAAG,EAAE,MAAM;IAUlB,KAAK;IASL,UAAU;CASX"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clix-so/react-native-sdk",
-  "version": "0.0.2-beta.2",
+  "version": "0.0.2-beta.3",
   "description": "Clix - Mobile push for builders",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
@@ -15,6 +15,8 @@
   "files": [
     "src",
     "lib",
+    "ios",
+    "clix-react-native-sdk.podspec",
     "!**/__tests__",
     "!**/__fixtures__",
     "!**/__mocks__",

package/src/native/getAppGroupDirectory.ts

@@ -0,0 +1,44 @@
+import { NativeModules, Platform } from 'react-native';
+import { ClixLogger } from '../utils/logging/ClixLogger';
+
+type ClixAppGroupDirectoryModule = {
+  getAppGroupDirectory(): string | null;
+};
+
+const MODULE_NAME = 'ClixAppGroupDirectory';
+
+const resolveModule = (): ClixAppGroupDirectoryModule | undefined => {
+  const nativeModule = (NativeModules as Record<string, unknown>)[MODULE_NAME];
+  if (!nativeModule) {
+    return undefined;
+  }
+  return nativeModule as ClixAppGroupDirectoryModule;
+};
+
+export const getAppGroupDirectory = (): string | undefined => {
+  if (Platform.OS !== 'ios') {
+    return undefined;
+  }
+
+  const nativeModule = resolveModule();
+  if (
+    !nativeModule ||
+    typeof nativeModule.getAppGroupDirectory !== 'function'
+  ) {
+    ClixLogger.debug(
+      'App Group directory native module is unavailable. Falling back to default MMKV path.'
+    );
+    return undefined;
+  }
+
+  try {
+    const directory = nativeModule.getAppGroupDirectory();
+    if (typeof directory === 'string' && directory.length > 0) {
+      return directory;
+    }
+  } catch (error) {
+    ClixLogger.warn('Failed to resolve App Group directory', error);
+  }
+
+  return undefined;
+};

package/src/services/StorageService.ts

@@ -1,4 +1,5 @@
 import * as MMKVModule from 'react-native-mmkv';
+import { getAppGroupDirectory } from '../native/getAppGroupDirectory';
 import { ClixLogger } from '../utils/logging/ClixLogger';
 
 // Support both v2/v3 (MMKV class) and v4 (createMMKV function)
@@ -18,6 +19,28 @@ export class StorageService {
     this.storage = this.initializeCompat(projectId);
   }
 
+  private getStoragePath(): string | undefined {
+    try {
+      const directory = getAppGroupDirectory();
+      if (!directory) {
+        return undefined;
+      }
+
+      /**
+       * NOTE(nyanxyz):
+       * On iOS the mmkv directory is located at {App Group Directory}/mmkv.
+       * RN MMKV v2 used {App Group Directory}/mmkv, but v3 switched to {App Group Directory}.
+       * We need to keep the directory aligned so iOS and RN can share storage.
+       * Therefore we explicitly target the mmkv folder inside the App Group directory.
+       * @see https://akshayjadhav.hashnode.dev/how-to-access-react-native-mmkv-in-a-ios-widget-react-native-expo
+       */
+      return `${directory}/mmkv`;
+    } catch (error) {
+      ClixLogger.warn('Failed to resolve App Group directory', error);
+      return undefined;
+    }
+  }
+
   private initializeCompat(projectId: string) {
     const storageId = `clix.${projectId}`;
 
@@ -26,6 +49,8 @@ export class StorageService {
       return MMKVModule.createMMKV({
         id: storageId,
         encryptionKey: undefined, // Add encryption if needed
+        path: this.getStoragePath(),
+        mode: 'multi-process',
       });
     }
     // v2/v3 API (MMKV class)
@@ -34,6 +59,8 @@ export class StorageService {
       return new MMKV({
         id: storageId,
         encryptionKey: undefined, // Add encryption if needed
+        path: this.getStoragePath(),
+        mode: 'multi-process',
       });
     } else {
       throw new Error('No compatible MMKV storage API found');