@amplytools/react-native-amply-sdk 0.1.0 → 0.1.3

package/ios/Sources/AmplyReactNative/AmplyReactNative/AmplyReactNative-generated.mm

@@ -68,6 +68,14 @@ namespace facebook::react {
       return static_cast<ObjCTurboModule&>(turboModule).invokeObjCMethod(rt, VoidKind, "registerDeepLinkListener", @selector(registerDeepLinkListener), args, count);
     }
 
+    static facebook::jsi::Value __hostFunction_NativeAmplyModuleSpecJSI_setLogLevel(facebook::jsi::Runtime& rt, TurboModule &turboModule, const facebook::jsi::Value* args, size_t count) {
+      return static_cast<ObjCTurboModule&>(turboModule).invokeObjCMethod(rt, VoidKind, "setLogLevel", @selector(setLogLevel:), args, count);
+    }
+
+    static facebook::jsi::Value __hostFunction_NativeAmplyModuleSpecJSI_getLogLevel(facebook::jsi::Runtime& rt, TurboModule &turboModule, const facebook::jsi::Value* args, size_t count) {
+      return static_cast<ObjCTurboModule&>(turboModule).invokeObjCMethod(rt, StringKind, "getLogLevel", @selector(getLogLevel), args, count);
+    }
+
     static facebook::jsi::Value __hostFunction_NativeAmplyModuleSpecJSI_addListener(facebook::jsi::Runtime& rt, TurboModule &turboModule, const facebook::jsi::Value* args, size_t count) {
       return static_cast<ObjCTurboModule&>(turboModule).invokeObjCMethod(rt, VoidKind, "addListener", @selector(addListener:), args, count);
     }
@@ -95,8 +103,14 @@ namespace facebook::react {
         
         
         methodMap_["registerDeepLinkListener"] = MethodMetadata {0, __hostFunction_NativeAmplyModuleSpecJSI_registerDeepLinkListener};
-        
-        
+
+
+        methodMap_["setLogLevel"] = MethodMetadata {1, __hostFunction_NativeAmplyModuleSpecJSI_setLogLevel};
+
+
+        methodMap_["getLogLevel"] = MethodMetadata {0, __hostFunction_NativeAmplyModuleSpecJSI_getLogLevel};
+
+
         methodMap_["addListener"] = MethodMetadata {1, __hostFunction_NativeAmplyModuleSpecJSI_addListener};
         
         

package/ios/Sources/AmplyReactNative/AmplyReactNative/AmplyReactNative.h

@@ -41,6 +41,8 @@ namespace JS {
       NSString *endpoint() const;
       id<NSObject> _Nullable datasetPrefetch() const;
       NSString *defaultConfig() const;
+      std::optional<bool> debug() const;
+      NSString *logLevel() const;
 
       AmplyInitializationConfig(NSDictionary *const v) : _v(v) {}
     private:
@@ -84,6 +86,8 @@ namespace JS {
                    resolve:(RCTPromiseResolveBlock)resolve
                     reject:(RCTPromiseRejectBlock)reject;
 - (void)registerDeepLinkListener;
+- (void)setLogLevel:(NSString *)level;
+- (NSString *)getLogLevel;
 - (void)addListener:(NSString *)eventName;
 - (void)removeListeners:(double)count;
 
@@ -138,6 +142,16 @@ inline NSString *JS::NativeAmplyModule::AmplyInitializationConfig::defaultConfig
   id const p = _v[@"defaultConfig"];
   return RCTBridgingToOptionalString(p);
 }
+inline std::optional<bool> JS::NativeAmplyModule::AmplyInitializationConfig::debug() const
+{
+  id const p = _v[@"debug"];
+  return RCTBridgingToOptionalBool(p);
+}
+inline NSString *JS::NativeAmplyModule::AmplyInitializationConfig::logLevel() const
+{
+  id const p = _v[@"logLevel"];
+  return RCTBridgingToOptionalString(p);
+}
 inline NSString *JS::NativeAmplyModule::TrackEventPayload::name() const
 {
   id const p = _v[@"name"];

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@amplytools/react-native-amply-sdk",
-  "version": "0.1.0",
+  "version": "0.1.3",
   "description": "React Native SDK for Amply: Mobile SDK to orchestrate in-app experiences and campaigns remotely, without app releases",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/amply/amply-react-native.git"
+    "url": "https://github.com/amply-tools/amply-react-native.git"
   },
-  "homepage": "https://github.com/amply/amply-react-native",
+  "homepage": "https://github.com/amply-tools/amply-react-native#readme",
   "bugs": {
-    "url": "https://github.com/amply/amply-react-native/issues"
+    "url": "https://github.com/amply-tools/amply-react-native/issues"
   },
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -18,9 +18,6 @@
   "source": "src/index.ts",
   "files": [
     "android/",
-    "!android/.cxx/",
-    "!android/build/",
-    "!android/.gradle/",
     "ios/",
     "dist/",
     "src/",
@@ -46,6 +43,8 @@
     "react-native": ">=0.79.0"
   },
   "devDependencies": {
+    "@babel/core": "^7.28.6",
+    "@babel/preset-flow": "^7.27.1",
     "@react-native/codegen": "0.81.4",
     "@react-native/eslint-config": "^0.74.81",
     "@react-native/typescript-config": "0.81.0",
@@ -57,6 +56,7 @@
     "expo": "^54.0.0",
     "expo-module-scripts": "^3.5.0",
     "jest": "^29.7.0",
+    "metro-react-native-babel-preset": "^0.77.0",
     "typescript": "^5.4.0"
   },
   "engines": {

package/src/index.ts

@@ -2,18 +2,69 @@ import getNativeModule from './nativeModule';
 import {addSystemEventListener as addSystemEventListenerInternal} from './systemEvents';
 export {useAmplySystemEvents} from './hooks/useAmplySystemEvents';
 export {formatSystemEventLabel} from './systemEventUtils';
+export type {FormatOptions} from './systemEventUtils';
 import type {
   AmplyInitializationConfig,
   DataSetSnapshot,
   DataSetType,
   DeepLinkEvent,
   EventRecord,
+  LogLevel,
   TrackEventPayload,
 } from './nativeSpecs/NativeAmplyModule';
 
 let deepLinkRegistered = false;
+let debugLogListenerRegistered = false;
 const deepLinkSubscriptions = new Set<() => void>();
 
+/**
+ * Format a debug log entry for console output.
+ */
+function formatDebugLog(event: EventRecord): string {
+  const props = event.properties as {
+    level?: string;
+    category?: string;
+    message?: string;
+  };
+  const level = props.level?.toUpperCase() || 'DEBUG';
+  const category = props.category || '';
+  return `[Amply ${level}] [${category}] ${props.message || ''}`;
+}
+
+/**
+ * Set up debug log listener that outputs to console.
+ * This is called automatically when debug mode is enabled.
+ */
+function ensureDebugLogListener(): void {
+  if (debugLogListenerRegistered) {
+    return;
+  }
+  debugLogListenerRegistered = true;
+
+  addSystemEventListenerInternal((event: EventRecord) => {
+    if (event.name === 'DebugLog') {
+      const formattedLog = formatDebugLog(event);
+      const props = event.properties as {level?: string};
+      const level = props.level?.toLowerCase();
+
+      // Use appropriate console method based on log level
+      switch (level) {
+        case 'error':
+          console.error(formattedLog);
+          break;
+        case 'warn':
+          console.warn(formattedLog);
+          break;
+        case 'debug':
+          console.debug(formattedLog);
+          break;
+        default:
+          console.log(formattedLog);
+      }
+    }
+  });
+}
+
 async function ensureDeepLinkRegistration(): Promise<void> {
   if (!deepLinkRegistered) {
     console.log('[Amply] Calling registerDeepLinkListener on native module');
@@ -38,9 +89,34 @@ function trackDeepLinkSubscription(subscription?: {remove?: () => void}): () =>
 }
 
 export async function initialize(config: AmplyInitializationConfig): Promise<void> {
+  // Set up debug log listener if debug mode is enabled
+  if (config.debug || config.logLevel) {
+    ensureDebugLogListener();
+  }
+
   await getNativeModule().initialize(config);
 }
 
+/**
+ * Set the log level at runtime.
+ * @param level The log level: 'none' | 'error' | 'warn' | 'info' | 'debug'
+ */
+export function setLogLevel(level: LogLevel): void {
+  // Ensure debug log listener is set up when changing log level
+  if (level !== 'none') {
+    ensureDebugLogListener();
+  }
+  getNativeModule().setLogLevel(level);
+}
+
+/**
+ * Get the current log level.
+ * @returns The current log level
+ */
+export function getLogLevel(): LogLevel {
+  return getNativeModule().getLogLevel() as LogLevel;
+}
+
 export function isInitialized(): boolean {
   return getNativeModule().isInitialized();
 }
@@ -88,6 +164,7 @@ export type {
   DataSetType,
   DeepLinkEvent,
   EventRecord,
+  LogLevel,
   TrackEventPayload,
 };
 
@@ -111,5 +188,7 @@ export default {
   addSystemEventListener,
   addSystemEventsListener,
   removeAllListeners,
+  setLogLevel,
+  getLogLevel,
   systemEvents,
 };

package/src/nativeSpecs/NativeAmplyModule.ts

@@ -4,6 +4,16 @@ import type {EventEmitter} from 'react-native/Libraries/Types/CodegenTypes';
 
 type JsonMap = {[key: string]: unknown};
 
+/**
+ * Log level for SDK debug output.
+ * - 'none': No logging
+ * - 'error': Only errors
+ * - 'warn': Errors and warnings
+ * - 'info': SDK lifecycle events (init, session start/end)
+ * - 'debug': Everything including campaign evaluation details
+ */
+export type LogLevel = 'none' | 'error' | 'warn' | 'info' | 'debug';
+
 export type AmplyInitializationConfig = {
   appId: string;
   apiKeyPublic: string;
@@ -11,6 +21,16 @@ export type AmplyInitializationConfig = {
   endpoint?: string | null;
   datasetPrefetch?: DataSetType[] | null;
   defaultConfig?: string | null;
+  /**
+   * Enable debug logging. Shorthand for logLevel: 'debug'.
+   * When true, logs will appear in the Metro console.
+   */
+  debug?: boolean | null;
+  /**
+   * Set the log level for SDK output.
+   * Takes precedence over `debug` if both are specified.
+   */
+  logLevel?: LogLevel | null;
 };
 
 export type EventType = 'custom' | 'system';
@@ -71,6 +91,16 @@ export interface Spec extends TurboModule {
   getRecentEvents(limit: number): Promise<EventRecord[]>;
   getDataSetSnapshot(type: DataSetType): Promise<DataSetSnapshot>;
   registerDeepLinkListener(): void;
+  /**
+   * Set the log level at runtime.
+   * @param level The log level to set
+   */
+  setLogLevel(level: string): void;
+  /**
+   * Get the current log level.
+   * @returns The current log level as a string
+   */
+  getLogLevel(): string;
   readonly onSystemEvent: EventEmitter<SystemEventPayload>;
   readonly onDeepLink: EventEmitter<DeepLinkEvent>;
   addListener(eventName: string): void;

package/src/systemEventUtils.ts

@@ -12,7 +12,17 @@ const DEFAULT_LABELS: Record<string, string> = {
   CampaignFinished: 'Campaign finished',
 };
 
-export function formatSystemEventLabel(event: EventRecord): string {
+export interface FormatOptions {
+  /** When true, includes detailed campaign information. Default: false */
+  verbose?: boolean;
+}
+
+export function formatSystemEventLabel(
+  event: EventRecord,
+  options: FormatOptions = {},
+): string {
+  const {verbose = false} = options;
+
   if (event.name === 'CampaignShown') {
     const campaignId = event.properties.campaignId as string | undefined;
     const source = event.properties.source as string | undefined;
@@ -27,9 +37,20 @@ export function formatSystemEventLabel(event: EventRecord): string {
   if (event.name === 'ConfigFetchFinished') {
     const success = event.properties.success as boolean | undefined;
     const campaignCount = event.properties.campaignCount as number | undefined;
-    const countLabel =
-      typeof campaignCount === 'number' ? ` (${campaignCount} campaigns)` : '';
-    return success === false ? 'Config fetch failed' : `Config fetch finished${countLabel}`;
+    const campaigns = event.properties.campaigns as Array<{id: string; name: string}> | undefined;
+
+    if (success === false) {
+      return 'Config fetch failed';
+    }
+
+    const countLabel = typeof campaignCount === 'number' ? `${campaignCount}` : '0';
+
+    if (verbose && campaigns && campaigns.length > 0) {
+      const campaignLines = campaigns.map(c => `- [${c.id}] ${c.name}`).join('\n');
+      return `Config fetch finished\nCampaigns: ${countLabel}\n${campaignLines}`;
+    }
+
+    return `Config fetch finished (${countLabel} campaigns)`;
   }
   return DEFAULT_LABELS[event.name] ?? `System event ${event.name}`;
 }