@amplitude/plugin-engagement-react-native 0.1.1-alpha.10

package/src/NativePluginEngagementReactNative.ts

@@ -0,0 +1,28 @@
+import type { TurboModule } from 'react-native';
+import { TurboModuleRegistry } from 'react-native';
+import type { GuideOrSurvey } from './types';
+
+export interface Spec extends TurboModule {
+  newInstance(apiKey: string): number;
+
+  boot(id: number, user_id: string, device_id: string): void;
+  setThemeMode(
+    id: number,
+    themeMode: 'auto' | 'dark_mode' | 'light_mode' /* ThemeMode */
+  ): void;
+  reset(id: number, key: string, stepIndex: number): void;
+
+  list(id: number): GuideOrSurvey[];
+
+  show(id: number, key: string, stepIndex: number): void;
+  screen(id: number, screenName: string): void;
+  closeAll(id: number): void;
+  forwardEvent(id: number, event: Object /* BaseEvent */): void;
+  addCallback(id: number, key: string, func: () => void): void;
+
+  handleURL(id: number, url: string): boolean;
+}
+
+export default TurboModuleRegistry.getEnforcing<Spec>(
+  'PluginEngagementReactNative'
+);

package/src/index.tsx

@@ -0,0 +1,78 @@
+import { AmplitudeEngagement } from './AmplitudeEngagement';
+import { AmplitudeEngagementPlugin } from './AmplitudeEngagementPlugin';
+import type { GuideOrSurvey } from './types';
+import type { BaseEvent, Plugin } from '@amplitude/analytics-types';
+
+let globalEngagement: AmplitudeEngagement = null as any;
+let toNotify: ((engagement: AmplitudeEngagement) => void)[] = [];
+
+async function getGlobalEngagement(): Promise<AmplitudeEngagement> {
+  if (globalEngagement) {
+    return globalEngagement;
+  } else {
+    return await new Promise((resolve, _reject) => {
+      toNotify.push((engagement) => {
+        resolve(engagement);
+      });
+    });
+  }
+}
+
+export function init(apiKey: string): void {
+  // Initialize the plugin with the API key
+  if (globalEngagement) {
+    throw new Error('AmplitudeEngagement already initialized');
+  }
+  globalEngagement = new AmplitudeEngagement(apiKey);
+  toNotify.forEach((callback) => {
+    callback(globalEngagement);
+  });
+  toNotify = [];
+}
+
+export async function boot(user_id: string, device_id: string): Promise<void> {
+  const e = await getGlobalEngagement();
+  return e.boot(user_id, device_id);
+}
+
+export async function list(): Promise<GuideOrSurvey[]> {
+  const e = await getGlobalEngagement();
+  return e.list();
+}
+
+export async function show(key: string, stepIndex: number): Promise<void> {
+  const e = await getGlobalEngagement();
+  return e.show(key, stepIndex);
+}
+
+export async function screen(screenName: string): Promise<void> {
+  const e = await getGlobalEngagement();
+  return e.screen(screenName);
+}
+
+export async function closeAll(): Promise<void> {
+  const e = await getGlobalEngagement();
+  return e.closeAll();
+}
+
+export async function forwardEvent(event: BaseEvent): Promise<void> {
+  const e = await getGlobalEngagement();
+  return e.forwardEvent(event);
+}
+
+export async function addCallback(
+  key: string,
+  func: () => void
+): Promise<void> {
+  const e = await getGlobalEngagement();
+  return e.addCallback(key, func);
+}
+
+export async function handleURL(url: string): Promise<boolean> {
+  const e = await getGlobalEngagement();
+  return e.handleURL(url);
+}
+
+export function getPlugin(): Plugin {
+  return new AmplitudeEngagementPlugin();
+}

package/src/logger.ts

@@ -0,0 +1,72 @@
+export enum AmplitudeLogLevel {
+  verbose = 0,
+  debug = 1,
+  warn = 2,
+  error = 3,
+  none = 4,
+}
+
+export interface AmplitudeLogger {
+  disable(): void;
+  enable(logLevel: AmplitudeLogLevel): void;
+  log(...args: any[]): void;
+  warn(...args: any[]): void;
+  error(...args: any[]): void;
+  debug(...args: any[]): void;
+}
+
+export class Logger implements AmplitudeLogger {
+  private prefix: string;
+  private currentLogLevel: AmplitudeLogLevel = AmplitudeLogLevel.debug;
+
+  constructor(name: string = 'AmplitudeEngagementSwift') {
+    this.prefix = `[${name}]`;
+  }
+
+  disable(): void {
+    this.currentLogLevel = AmplitudeLogLevel.none;
+  }
+
+  enable(logLevel: AmplitudeLogLevel): void {
+    this.currentLogLevel = logLevel;
+  }
+
+  log(...args: any[]): void {
+    if (this.currentLogLevel <= AmplitudeLogLevel.verbose) {
+      console.info(this.format(args, 'INFO'));
+    }
+  }
+
+  warn(...args: any[]): void {
+    if (this.currentLogLevel <= AmplitudeLogLevel.warn) {
+      console.warn(this.format(args, 'WARNING'));
+    }
+  }
+
+  error(...args: any[]): void {
+    if (this.currentLogLevel <= AmplitudeLogLevel.error) {
+      console.error(this.format(args, 'ERROR'));
+    }
+  }
+
+  debug(...args: any[]): void {
+    if (this.currentLogLevel <= AmplitudeLogLevel.debug) {
+      console.debug(this.format(args, 'DEBUG'));
+    }
+  }
+
+  private format(
+    args: any[],
+    level: 'DEBUG' | 'INFO' | 'WARNING' | 'ERROR'
+  ): string {
+    const message = args.map((a) => String(a)).join(' ');
+
+    const emoji = {
+      DEBUG: '🔍',
+      INFO: 'ℹ️',
+      WARNING: '⚠️',
+      ERROR: '🔴',
+    }[level];
+    return `${this.prefix} ${emoji} ${level}: ${message}`;
+  }
+}

package/src/types.ts

@@ -0,0 +1,7 @@
+export type GuideOrSurvey = {
+  id: number;
+  step: number;
+  title: string;
+};
+
+export type ThemeMode = 'auto' | 'dark_mode' | 'light_mode';