@amplytools/react-native-amply-sdk 0.11.0 → 0.12.1

package/AmplyReactNative.podspec

@@ -22,7 +22,7 @@ Pod::Spec.new do |s|
   s.dependency 'React-RCTFabric'
 
   # Amply KMP SDK from CocoaPods
-  s.dependency 'AmplySDK', '~> 0.11.0'
+  s.dependency 'AmplySDK', '~> 0.12.0'
 
   s.libraries = 'c++'
   s.pod_target_xcconfig = {

package/README.md

@@ -42,10 +42,12 @@ If you upgraded from v0.2.11 or earlier and have `"@amplytools/react-native-ampl
 ```typescript
 import Amply from '@amplytools/react-native-amply-sdk';
 
-// Initialize
+// Initialize — all three keys are required (your application's page in Amply).
+// Use the iOS application's keys on iOS and the Android application's on Android.
 await Amply.initialize({
   appId: 'YOUR_APP_ID',
   apiKeyPublic: 'YOUR_PUBLIC_API_KEY',
+  apiKeySecret: 'YOUR_SECRET_API_KEY',
   debug: true, // optional: enable debug logging
 });
 
@@ -67,6 +69,13 @@ const unsubscribe = await Amply.addDeepLinkListener((event) => {
 });
 ```
 
+### About the keys
+
+`apiKeySecret` ships inside your app: the SDK signs every request with it on the device. Keep it
+out of source control and inject it at build time, like the public key. If any of the three keys
+is missing or blank, `initialize` rejects with `AMP_INVALID_CONFIG`, logs which key is missing,
+and Amply stays off — every later call is a no-op. It never crashes your app.
+
 ## Documentation
 
 Full integration guides, API reference, and examples:

package/android/build.gradle

@@ -15,7 +15,7 @@ buildscript {
 apply plugin: 'com.android.library'
 apply plugin: 'org.jetbrains.kotlin.android'
 
-def amplySdkVersion = project.findProperty('amplySdkVersion') ?: System.getenv('AMPLY_SDK_VERSION') ?: '0.11.0'
+def amplySdkVersion = project.findProperty('amplySdkVersion') ?: System.getenv('AMPLY_SDK_VERSION') ?: '0.12.0'
 group = 'tools.amply'
 version = amplySdkVersion
 

package/android/src/main/java/tools/amply/sdk/reactnative/AmplyModule.kt

@@ -334,11 +334,20 @@ class AmplyModule(reactContext: ReactApplicationContext) :
 
   // ---- твои helper-методы без изменений ----
 
+  private fun ReadableMap.requiredString(key: String): String {
+    val value = if (hasKey(key)) getString(key) else null
+    if (value.isNullOrBlank()) throw IllegalArgumentException("'$key' is required")
+    return value
+  }
+
   private fun ReadableMap.toInitializationOptions(): AmplyInitializationOptions {
-    val appId = getString("appId") ?: throw IllegalArgumentException("'appId' is required")
-    val apiKeyPublic = getString("apiKeyPublic") ?: throw IllegalArgumentException("'apiKeyPublic' is required")
+    // All three keys are required, blank included: a blank secret used to pass straight through
+    // and sign every request with an empty key, which the backend refuses — a silent failure
+    // instead of this rejection.
+    val appId = requiredString("appId")
+    val apiKeyPublic = requiredString("apiKeyPublic")
+    val apiKeySecret = requiredString("apiKeySecret")
 
-    val apiKeySecret = if (hasKey("apiKeySecret")) getString("apiKeySecret") else null
     val configBaseUrl = if (hasKey("configBaseUrl")) getString("configBaseUrl") else null
     val backendBaseUrl = if (hasKey("backendBaseUrl")) getString("backendBaseUrl") else null
     val endpoint = if (hasKey("endpoint")) getString("endpoint") else null

package/android/src/main/java/tools/amply/sdk/reactnative/core/DefaultAmplyClient.kt

@@ -144,9 +144,16 @@ class DefaultAmplyClient(
         synchronized(propertyLock) {
           amplyInstance = instance
           if (pendingPropertyOps.isNotEmpty()) {
-            android.util.Log.i("AmplyReactNative", "Draining ${pendingPropertyOps.size} buffered property operations")
-            pendingPropertyOps.forEach { op -> op(instance) }
+            // Taken out of the list before running, and each op guarded: one throwing op used to
+            // abort the drain after amplyInstance was already set, so the rest were never
+            // replayed and initialize rejected while isInitialized() reported true.
+            val ops = pendingPropertyOps.toList()
             pendingPropertyOps.clear()
+            android.util.Log.i("AmplyReactNative", "Draining ${ops.size} buffered property operations")
+            ops.forEach { op ->
+              runCatching { op(instance) }
+                .onFailure { android.util.Log.w("AmplyReactNative", "Buffered property operation failed", it) }
+            }
           }
         }
 
@@ -362,9 +369,20 @@ class DefaultAmplyClient(
   }
 
   override fun setUserId(userId: String?) {
-    val instance = requireInstance()
-    instance.setUserId(userId)
-    android.util.Log.i("AmplyReactNative", "User ID set to: ${userId ?: "<null>"}")
+    // Buffered like the property calls below. It used to requireInstance(), and this runs from a
+    // void TurboModule method, so the IllegalStateException never reached JS: calling setUserId
+    // before a successful initialize (for example after initialize rejected over a missing key)
+    // crashed the host app.
+    synchronized(propertyLock) {
+      val instance = amplyInstance
+      if (instance != null) {
+        instance.setUserId(userId)
+        android.util.Log.i("AmplyReactNative", "User ID set to: ${userId ?: "<null>"}")
+      } else {
+        android.util.Log.i("AmplyReactNative", "Buffering setUserId until init")
+        pendingPropertyOps.add { it.setUserId(userId) }
+      }
+    }
   }
 
   override fun setCustomProperty(key: String, value: Any) {

package/dist/src/__tests__/gateRegistrationLifecycle.test.js

@@ -170,7 +170,7 @@ describe('gate registration lifecycle', () => {
             // Native refuses while uninitialised; JS must not record that as done.
             expect(mockNativeModule.registerGate).not.toHaveBeenCalled();
             mockNativeModule.isInitialized.mockReturnValue(true);
-            await Amply.initialize({ apiKey: 'k', apiKeySecret: 's' });
+            await Amply.initialize({ appId: 'a', apiKeyPublic: 'k', apiKeySecret: 's' });
             expect(mockNativeModule.registerGate).toHaveBeenCalledWith('stillframe://ad', 'cancel', 0);
             emitPresentation();
             await flushMicrotasks();
@@ -181,7 +181,7 @@ describe('gate registration lifecycle', () => {
             await Amply.addDeepLinkListener(jest.fn());
             expect(mockNativeModule.registerDeepLinkListener).not.toHaveBeenCalled();
             mockNativeModule.isInitialized.mockReturnValue(true);
-            await Amply.initialize({ apiKey: 'k', apiKeySecret: 's' });
+            await Amply.initialize({ appId: 'a', apiKeyPublic: 'k', apiKeySecret: 's' });
             expect(mockNativeModule.registerDeepLinkListener).toHaveBeenCalledTimes(1);
         });
         /**
@@ -197,7 +197,7 @@ describe('gate registration lifecycle', () => {
             await Amply.registerGate('stillframe://ad', first);
             await Amply.registerGate('stillframe://ad', second);
             mockNativeModule.isInitialized.mockReturnValue(true);
-            await Amply.initialize({ apiKey: 'k', apiKeySecret: 's' });
+            await Amply.initialize({ appId: 'a', apiKeyPublic: 'k', apiKeySecret: 's' });
             emitPresentation();
             await flushMicrotasks();
             expect(second).toHaveBeenCalledTimes(1);
@@ -208,7 +208,7 @@ describe('gate registration lifecycle', () => {
             const unsubscribe = await Amply.registerGate('stillframe://ad', jest.fn());
             unsubscribe();
             mockNativeModule.isInitialized.mockReturnValue(true);
-            await Amply.initialize({ apiKey: 'k', apiKeySecret: 's' });
+            await Amply.initialize({ appId: 'a', apiKeyPublic: 'k', apiKeySecret: 's' });
             expect(mockNativeModule.registerGate).not.toHaveBeenCalled();
         });
     });

package/dist/src/__tests__/index.test.js

@@ -25,13 +25,36 @@ describe('Amply JS API', () => {
         __setNativeModule(mockNativeModule);
     });
     it('initializes the native module', async () => {
-        await Amply.initialize({ appId: 'id', apiKeyPublic: 'public' });
+        await Amply.initialize({ appId: 'id', apiKeyPublic: 'public', apiKeySecret: 'secret' });
         expect(mockNativeModule.initialize).toHaveBeenCalledWith(expect.objectContaining({ appId: 'id', apiKeyPublic: 'public' }));
     });
+    // A missing key used to reach the native SDK, whose config builder threw an exception that
+    // crossed into Objective-C uncaught and aborted the host app — no JS try/catch could stop it.
+    // Bad keys must cost the app its Amply, never its process.
+    describe.each([
+        ['apiKeySecret', { appId: 'id', apiKeyPublic: 'public' }],
+        ['apiKeySecret', { appId: 'id', apiKeyPublic: 'public', apiKeySecret: '' }],
+        ['apiKeySecret', { appId: 'id', apiKeyPublic: 'public', apiKeySecret: '   ' }],
+        ['apiKeySecret', { appId: 'id', apiKeyPublic: 'public', apiKeySecret: null }],
+        ['apiKeyPublic', { appId: 'id', apiKeyPublic: '', apiKeySecret: 'secret' }],
+        ['appId', { appId: '', apiKeyPublic: 'public', apiKeySecret: 'secret' }],
+    ])('when %s is missing (%j)', (field, config) => {
+        it('rejects with AMP_INVALID_CONFIG, names the field and never calls the native module', async () => {
+            const error = jest.spyOn(console, 'error').mockImplementation(() => { });
+            await expect(Amply.initialize(config)).rejects.toMatchObject({
+                code: 'AMP_INVALID_CONFIG',
+                message: expect.stringContaining(field),
+            });
+            expect(mockNativeModule.initialize).not.toHaveBeenCalled();
+            expect(error).toHaveBeenCalledWith(expect.stringContaining(field));
+            error.mockRestore();
+        });
+    });
     it('passes the base-URL overrides through to the native layer', async () => {
         await Amply.initialize({
             appId: 'id',
             apiKeyPublic: 'public',
+            apiKeySecret: 'secret',
             configBaseUrl: 'https://config-staging.example.com',
             backendBaseUrl: 'https://api-staging.example.com',
         });
@@ -47,6 +70,7 @@ describe('Amply JS API', () => {
         await Amply.initialize({
             appId: 'id',
             apiKeyPublic: 'public',
+            apiKeySecret: 'secret',
             endpoint: 'https://api-staging.example.com',
         });
         expect(mockNativeModule.initialize).toHaveBeenCalledWith(expect.objectContaining({ endpoint: 'https://api-staging.example.com' }));

package/dist/src/index.d.ts

@@ -1,7 +1,21 @@
 export { useAmplySystemEvents } from './hooks/useAmplySystemEvents';
 export { formatSystemEventLabel } from './systemEventUtils';
 export type { FormatOptions } from './systemEventUtils';
-import type { CampaignResult, GateDecision, AmplyInitializationConfig, DataSetSnapshot, DataSetType, DeepLinkEvent, EventRecord, LogLevel, CampaignPresentEvent, TrackEventPayload } from './nativeSpecs/NativeAmplyModule';
+import type { CampaignResult, GateDecision, AmplyInitializationConfig as NativeInitializationConfig, DataSetSnapshot, DataSetType, DeepLinkEvent, EventRecord, LogLevel, CampaignPresentEvent, TrackEventPayload } from './nativeSpecs/NativeAmplyModule';
+/**
+ * The keys from your application's page in Amply. All three are required: the SDK signs every
+ * request with `apiKeySecret` on the device, so the secret ships inside the app next to the
+ * public key. The codegen spec keeps the field optional only so the generated native structs
+ * stay unchanged; this is the contract callers see.
+ */
+export type AmplyInitializationConfig = Omit<NativeInitializationConfig, 'apiKeySecret'> & {
+    apiKeySecret: string;
+};
+/** Rejection raised by {@link initialize} for a config the SDK cannot start with. */
+export declare class AmplyConfigError extends Error {
+    readonly code = "AMP_INVALID_CONFIG";
+    constructor(message: string);
+}
 export declare function initialize(config: AmplyInitializationConfig): Promise<void>;
 /**
  * Set the user ID for analytics. Pass null to clear.
@@ -151,7 +165,7 @@ export declare function removeCustomProperty(key: string): void;
  */
 export declare function clearCustomProperties(): void;
 export declare function removeAllListeners(): void;
-export type { AmplyInitializationConfig, DataSetSnapshot, DataSetType, DeepLinkEvent, EventRecord, LogLevel, CampaignPresentEvent, TrackEventPayload, };
+export type { DataSetSnapshot, DataSetType, DeepLinkEvent, EventRecord, LogLevel, CampaignPresentEvent, TrackEventPayload, };
 export declare function addSystemEventsListener(listener: (event: EventRecord) => void): Promise<() => void>;
 export declare const systemEvents: {
     addListener: typeof addSystemEventsListener;

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/src/index.js

@@ -2,6 +2,22 @@ import getNativeModule from './nativeModule';
 import { addSystemEventListenerRaw, addSystemEventListener as addSystemEventListenerInternal } from './systemEvents';
 export { useAmplySystemEvents } from './hooks/useAmplySystemEvents';
 export { formatSystemEventLabel } from './systemEventUtils';
+const REQUIRED_KEYS = ['appId', 'apiKeyPublic', 'apiKeySecret'];
+/** Rejection raised by {@link initialize} for a config the SDK cannot start with. */
+export class AmplyConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.code = 'AMP_INVALID_CONFIG';
+        this.name = 'AmplyConfigError';
+    }
+}
+/** The first required key that is missing or blank, if any. */
+function missingKey(config) {
+    return REQUIRED_KEYS.find((key) => {
+        const value = config === null || config === void 0 ? void 0 : config[key];
+        return typeof value !== 'string' || value.trim().length === 0;
+    });
+}
 let deepLinkRegistered = false;
 let debugLogListenerRegistered = false;
 const deepLinkSubscriptions = new Set();
@@ -157,6 +173,15 @@ function trackDeepLinkSubscription(subscription) {
     return unsubscribe;
 }
 export async function initialize(config) {
+    // Checked here, before the native module sees anything: a missing key used to reach the
+    // native config builder, which threw across the Objective-C boundary and aborted the host
+    // app. Bad keys cost the app its Amply — never its process. The SDK stays uninitialized.
+    const missing = missingKey(config);
+    if (missing) {
+        const message = `[Amply] '${missing}' is required — Amply is not initialized. Copy it from your application's page in Amply.`;
+        console.error(message);
+        throw new AmplyConfigError(message);
+    }
     // Set up debug log listener if debug mode is enabled
     if (config.debug || config.logLevel) {
         ensureDebugLogListener();