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

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@amplytools/react-native-amply-sdk",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "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",
   "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,7 @@
     "react-native": ">=0.79.0"
   },
   "devDependencies": {
+    "@babel/core": "^7.28.6",
     "@react-native/codegen": "0.81.4",
     "@react-native/eslint-config": "^0.74.81",
     "@react-native/typescript-config": "0.81.0",
@@ -57,6 +55,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

@@ -8,12 +8,62 @@ import type {
   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 +88,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 +163,7 @@ export type {
   DataSetType,
   DeepLinkEvent,
   EventRecord,
+  LogLevel,
   TrackEventPayload,
 };
 
@@ -111,5 +187,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;