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

package/lib/module/logger.js

@@ -0,0 +1,53 @@
+"use strict";
+
+export let AmplitudeLogLevel = /*#__PURE__*/function (AmplitudeLogLevel) {
+  AmplitudeLogLevel[AmplitudeLogLevel["verbose"] = 0] = "verbose";
+  AmplitudeLogLevel[AmplitudeLogLevel["debug"] = 1] = "debug";
+  AmplitudeLogLevel[AmplitudeLogLevel["warn"] = 2] = "warn";
+  AmplitudeLogLevel[AmplitudeLogLevel["error"] = 3] = "error";
+  AmplitudeLogLevel[AmplitudeLogLevel["none"] = 4] = "none";
+  return AmplitudeLogLevel;
+}({});
+export class Logger {
+  currentLogLevel = AmplitudeLogLevel.debug;
+  constructor(name = 'AmplitudeEngagementSwift') {
+    this.prefix = `[${name}]`;
+  }
+  disable() {
+    this.currentLogLevel = AmplitudeLogLevel.none;
+  }
+  enable(logLevel) {
+    this.currentLogLevel = logLevel;
+  }
+  log(...args) {
+    if (this.currentLogLevel <= AmplitudeLogLevel.verbose) {
+      console.info(this.format(args, 'INFO'));
+    }
+  }
+  warn(...args) {
+    if (this.currentLogLevel <= AmplitudeLogLevel.warn) {
+      console.warn(this.format(args, 'WARNING'));
+    }
+  }
+  error(...args) {
+    if (this.currentLogLevel <= AmplitudeLogLevel.error) {
+      console.error(this.format(args, 'ERROR'));
+    }
+  }
+  debug(...args) {
+    if (this.currentLogLevel <= AmplitudeLogLevel.debug) {
+      console.debug(this.format(args, 'DEBUG'));
+    }
+  }
+  format(args, level) {
+    const message = args.map(a => String(a)).join(' ');
+    const emoji = {
+      DEBUG: '🔍',
+      INFO: 'ℹ️',
+      WARNING: '⚠️',
+      ERROR: '🔴'
+    }[level];
+    return `${this.prefix} ${emoji} ${level}: ${message}`;
+  }
+}
+//# sourceMappingURL=logger.js.map

package/lib/module/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["AmplitudeLogLevel","Logger","currentLogLevel","debug","constructor","name","prefix","disable","none","enable","logLevel","log","args","verbose","console","info","format","warn","error","level","message","map","a","String","join","emoji","DEBUG","INFO","WARNING","ERROR"],"sourceRoot":"../../src","sources":["logger.ts"],"mappings":";;AAAA,WAAYA,iBAAiB,0BAAjBA,iBAAiB;EAAjBA,iBAAiB,CAAjBA,iBAAiB;EAAjBA,iBAAiB,CAAjBA,iBAAiB;EAAjBA,iBAAiB,CAAjBA,iBAAiB;EAAjBA,iBAAiB,CAAjBA,iBAAiB;EAAjBA,iBAAiB,CAAjBA,iBAAiB;EAAA,OAAjBA,iBAAiB;AAAA;AAiB7B,OAAO,MAAMC,MAAM,CAA4B;EAErCC,eAAe,GAAsBF,iBAAiB,CAACG,KAAK;EAEpEC,WAAWA,CAACC,IAAY,GAAG,0BAA0B,EAAE;IACrD,IAAI,CAACC,MAAM,GAAG,IAAID,IAAI,GAAG;EAC3B;EAEAE,OAAOA,CAAA,EAAS;IACd,IAAI,CAACL,eAAe,GAAGF,iBAAiB,CAACQ,IAAI;EAC/C;EAEAC,MAAMA,CAACC,QAA2B,EAAQ;IACxC,IAAI,CAACR,eAAe,GAAGQ,QAAQ;EACjC;EAEAC,GAAGA,CAAC,GAAGC,IAAW,EAAQ;IACxB,IAAI,IAAI,CAACV,eAAe,IAAIF,iBAAiB,CAACa,OAAO,EAAE;MACrDC,OAAO,CAACC,IAAI,CAAC,IAAI,CAACC,MAAM,CAACJ,IAAI,EAAE,MAAM,CAAC,CAAC;IACzC;EACF;EAEAK,IAAIA,CAAC,GAAGL,IAAW,EAAQ;IACzB,IAAI,IAAI,CAACV,eAAe,IAAIF,iBAAiB,CAACiB,IAAI,EAAE;MAClDH,OAAO,CAACG,IAAI,CAAC,IAAI,CAACD,MAAM,CAACJ,IAAI,EAAE,SAAS,CAAC,CAAC;IAC5C;EACF;EAEAM,KAAKA,CAAC,GAAGN,IAAW,EAAQ;IAC1B,IAAI,IAAI,CAACV,eAAe,IAAIF,iBAAiB,CAACkB,KAAK,EAAE;MACnDJ,OAAO,CAACI,KAAK,CAAC,IAAI,CAACF,MAAM,CAACJ,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3C;EACF;EAEAT,KAAKA,CAAC,GAAGS,IAAW,EAAQ;IAC1B,IAAI,IAAI,CAACV,eAAe,IAAIF,iBAAiB,CAACG,KAAK,EAAE;MACnDW,OAAO,CAACX,KAAK,CAAC,IAAI,CAACa,MAAM,CAACJ,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3C;EACF;EAEQI,MAAMA,CACZJ,IAAW,EACXO,KAA6C,EACrC;IACR,MAAMC,OAAO,GAAGR,IAAI,CAACS,GAAG,CAAEC,CAAC,IAAKC,MAAM,CAACD,CAAC,CAAC,CAAC,CAACE,IAAI,CAAC,GAAG,CAAC;IAEpD,MAAMC,KAAK,GAAG;MACZC,KAAK,EAAE,IAAI;MACXC,IAAI,EAAE,IAAI;MACVC,OAAO,EAAE,IAAI;MACbC,KAAK,EAAE;IACT,CAAC,CAACV,KAAK,CAAC;IACR,OAAO,GAAG,IAAI,CAACb,MAAM,IAAImB,KAAK,IAAIN,KAAK,KAAKC,OAAO,EAAE;EACvD;AACF","ignoreList":[]}

package/lib/module/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/module/types.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=types.js.map

package/lib/module/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../src","sources":["types.ts"],"mappings":"","ignoreList":[]}

package/lib/typescript/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/typescript/src/AmplitudeEngagement.d.ts

@@ -0,0 +1,17 @@
+import type { GuideOrSurvey, ThemeMode } from './types';
+import type { BaseEvent } from '@amplitude/analytics-types';
+export declare class AmplitudeEngagement {
+    id: number;
+    constructor(apiKey: string);
+    boot(user_id: string, device_id: string): void;
+    setThemeMode(themeMode: ThemeMode): void;
+    reset(key: string, stepIndex: number): void;
+    list(): GuideOrSurvey[];
+    show(key: string, stepIndex: number): void;
+    screen(screenName: string): void;
+    closeAll(): void;
+    forwardEvent(event: BaseEvent): void;
+    addCallback(key: string, func: () => void): void;
+    handleURL(url: string): boolean;
+}
+//# sourceMappingURL=AmplitudeEngagement.d.ts.map

package/lib/typescript/src/AmplitudeEngagement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AmplitudeEngagement.d.ts","sourceRoot":"","sources":["../../../src/AmplitudeEngagement.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAW5D,qBAAa,mBAAmB;IAC9B,EAAE,EAAE,MAAM,CAAC;gBAEC,MAAM,EAAE,MAAM;IAK1B,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAI9C,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAIxC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAI3C,IAAI,IAAI,aAAa,EAAE;IAIvB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAI1C,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIhC,QAAQ,IAAI,IAAI;IAIhB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAIpC,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,GAAG,IAAI;IAIhD,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;CAGhC"}

package/lib/typescript/src/AmplitudeEngagementPlugin.d.ts

@@ -0,0 +1,10 @@
+import type { Config, CoreClient, EnrichmentPlugin, Event } from '@amplitude/analytics-types';
+import { type AmplitudeLogger } from './logger';
+export declare class AmplitudeEngagementPlugin implements EnrichmentPlugin {
+    name: string;
+    type: "enrichment";
+    logger: AmplitudeLogger;
+    setup(config: Config, _client: CoreClient): Promise<void>;
+    execute(context: Event): Promise<Event | null>;
+}
+//# sourceMappingURL=AmplitudeEngagementPlugin.d.ts.map

package/lib/typescript/src/AmplitudeEngagementPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AmplitudeEngagementPlugin.d.ts","sourceRoot":"","sources":["../../../src/AmplitudeEngagementPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EACN,UAAU,EACV,gBAAgB,EAChB,KAAK,EACN,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAU,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AAExD,qBAAa,yBAA0B,YAAW,gBAAgB;IAChE,IAAI,SAA+B;IACnC,IAAI,EAAG,YAAY,CAAU;IAE7B,MAAM,EAAE,eAAe,CAA2C;IAE5D,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAczD,OAAO,CAAC,OAAO,EAAE,KAAK,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;CAiBrD"}

package/lib/typescript/src/NativePluginEngagementReactNative.d.ts

@@ -0,0 +1,18 @@
+import type { TurboModule } 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'): 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): void;
+    addCallback(id: number, key: string, func: () => void): void;
+    handleURL(id: number, url: string): boolean;
+}
+declare const _default: Spec;
+export default _default;
+//# sourceMappingURL=NativePluginEngagementReactNative.d.ts.map

package/lib/typescript/src/NativePluginEngagementReactNative.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativePluginEngagementReactNative.d.ts","sourceRoot":"","sources":["../../../src/NativePluginEngagementReactNative.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IAEpC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3D,YAAY,CACV,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,YAAY,GAC7C,IAAI,CAAC;IACR,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAExD,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,EAAE,CAAC;IAElC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACvD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAmB,IAAI,CAAC;IAC9D,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAE7D,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC7C;;AAED,wBAEE"}

package/lib/typescript/src/index.d.ts

@@ -0,0 +1,13 @@
+import type { GuideOrSurvey } from './types';
+import type { BaseEvent, Plugin } from '@amplitude/analytics-types';
+export declare function init(apiKey: string): void;
+export declare function boot(user_id: string, device_id: string): Promise<void>;
+export declare function list(): Promise<GuideOrSurvey[]>;
+export declare function show(key: string, stepIndex: number): Promise<void>;
+export declare function screen(screenName: string): Promise<void>;
+export declare function closeAll(): Promise<void>;
+export declare function forwardEvent(event: BaseEvent): Promise<void>;
+export declare function addCallback(key: string, func: () => void): Promise<void>;
+export declare function handleURL(url: string): Promise<boolean>;
+export declare function getPlugin(): Plugin;
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAiBpE,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAUzC;AAED,wBAAsB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG5E;AAED,wBAAsB,IAAI,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAGrD;AAED,wBAAsB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGxE;AAED,wBAAsB,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG9D;AAED,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAG9C;AAED,wBAAsB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAGlE;AAED,wBAAsB,WAAW,CAC/B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,IAAI,GACf,OAAO,CAAC,IAAI,CAAC,CAGf;AAED,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAG7D;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC"}

package/lib/typescript/src/logger.d.ts

@@ -0,0 +1,28 @@
+export declare 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 declare class Logger implements AmplitudeLogger {
+    private prefix;
+    private currentLogLevel;
+    constructor(name?: string);
+    disable(): void;
+    enable(logLevel: AmplitudeLogLevel): void;
+    log(...args: any[]): void;
+    warn(...args: any[]): void;
+    error(...args: any[]): void;
+    debug(...args: any[]): void;
+    private format;
+}
+//# sourceMappingURL=logger.d.ts.map

package/lib/typescript/src/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/logger.ts"],"names":[],"mappings":"AAAA,oBAAY,iBAAiB;IAC3B,OAAO,IAAI;IACX,KAAK,IAAI;IACT,IAAI,IAAI;IACR,KAAK,IAAI;IACT,IAAI,IAAI;CACT;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,IAAI,IAAI,CAAC;IAChB,MAAM,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC1C,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC1B,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC3B,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;CAC7B;AAED,qBAAa,MAAO,YAAW,eAAe;IAC5C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,eAAe,CAA8C;gBAEzD,IAAI,GAAE,MAAmC;IAIrD,OAAO,IAAI,IAAI;IAIf,MAAM,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAIzC,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAMzB,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAM1B,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAM3B,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAM3B,OAAO,CAAC,MAAM;CAcf"}

package/lib/typescript/src/types.d.ts

@@ -0,0 +1,7 @@
+export type GuideOrSurvey = {
+    id: number;
+    step: number;
+    title: string;
+};
+export type ThemeMode = 'auto' | 'dark_mode' | 'light_mode';
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,WAAW,GAAG,YAAY,CAAC"}

package/package.json

@@ -0,0 +1,169 @@
+{
+  "name": "@amplitude/plugin-engagement-react-native",
+  "version": "0.1.1-alpha.3",
+  "description": "Amplitude Engagement plugin for React Native",
+  "main": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.tsx",
+      "types": "./lib/typescript/src/index.d.ts",
+      "default": "./lib/module/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "cpp",
+    "*.podspec",
+    "react-native.config.js",
+    "!ios/build",
+    "!android/build",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*"
+  ],
+  "scripts": {
+    "example": "yarn workspace @amplitude/plugin-engagement-react-native-example",
+    "test": "jest",
+    "typecheck": "tsc",
+    "lint": "eslint \"**/*.{js,ts,tsx}\"",
+    "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
+    "prepare": "bob build",
+    "release": "npm version prerelease --preid alpha && npm publish",
+    "_release": "release-it --only-version"
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://amplitude.com.git"
+  },
+  "author": "Amplitude, Inc. <dev@amplitude.com> (https://github.com/amplitude)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://amplitude.com/issues"
+  },
+  "homepage": "https://amplitude.com#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@commitlint/config-conventional": "^19.6.0",
+    "@eslint/compat": "^1.2.7",
+    "@eslint/eslintrc": "^3.3.0",
+    "@eslint/js": "^9.22.0",
+    "@evilmartians/lefthook": "^1.5.0",
+    "@react-native-community/cli": "15.0.0-alpha.2",
+    "@react-native/babel-preset": "0.79.2",
+    "@react-native/eslint-config": "^0.78.0",
+    "@release-it/conventional-changelog": "^9.0.2",
+    "@types/jest": "^29.5.5",
+    "@types/react": "^19.0.0",
+    "commitlint": "^19.6.1",
+    "del-cli": "^5.1.0",
+    "eslint": "^9.22.0",
+    "eslint-config-prettier": "^10.1.1",
+    "eslint-plugin-prettier": "^5.2.3",
+    "jest": "^29.7.0",
+    "prettier": "^3.0.3",
+    "react": "19.0.0",
+    "react-native": "0.79.2",
+    "react-native-builder-bob": "^0.40.11",
+    "release-it": "^17.10.0",
+    "turbo": "^1.10.7",
+    "typescript": "^5.8.3"
+  },
+  "peerDependencies": {
+    "@react-native-async-storage/async-storage": "^2.1.2",
+    "react": "*",
+    "react-native": "*"
+  },
+  "workspaces": [
+    "example"
+  ],
+  "packageManager": "yarn@3.6.1",
+  "jest": {
+    "preset": "react-native",
+    "modulePathIgnorePatterns": [
+      "<rootDir>/example/node_modules",
+      "<rootDir>/lib/"
+    ]
+  },
+  "commitlint": {
+    "extends": [
+      "@commitlint/config-conventional"
+    ]
+  },
+  "release-it": {
+    "git": {
+      "commitMessage": "chore: release ${version}",
+      "tagName": "v${version}"
+    },
+    "npm": {
+      "publish": true
+    },
+    "github": {
+      "release": true
+    },
+    "plugins": {
+      "@release-it/conventional-changelog": {
+        "preset": {
+          "name": "angular"
+        }
+      }
+    }
+  },
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "codegenConfig": {
+    "name": "PluginEngagementReactNativeSpec",
+    "type": "modules",
+    "jsSrcsDir": "src",
+    "android": {
+      "javaPackageName": "com.amplitude.pluginengagementreactnative"
+    }
+  },
+  "create-react-native-library": {
+    "languages": "kotlin-objc",
+    "type": "turbo-module",
+    "version": "0.50.3"
+  },
+  "dependencies": {
+    "@amplitude/analytics-types": "^1.3.5"
+  }
+}

package/src/AmplitudeEngagement.ts

@@ -0,0 +1,62 @@
+import type { Spec } from './NativePluginEngagementReactNative';
+import { NativeModules } from 'react-native';
+import type { GuideOrSurvey, ThemeMode } from './types';
+import type { BaseEvent } from '@amplitude/analytics-types';
+
+type PluginEngagementReactNativeType = Exclude<Spec, 'getConstants'>;
+
+const isTurboModuleEnabled = (global as any).__turboModuleProxy != null;
+
+const PluginEngagementReactNative: PluginEngagementReactNativeType =
+  isTurboModuleEnabled
+    ? require('./NativePluginEngagementReactNative').default
+    : NativeModules.PluginEngagementReactNative;
+
+export class AmplitudeEngagement {
+  id: number;
+
+  constructor(apiKey: string) {
+    // Initialize the plugin with the API key
+    this.id = PluginEngagementReactNative.newInstance(apiKey);
+  }
+
+  boot(user_id: string, device_id: string): void {
+    PluginEngagementReactNative.boot(this.id, user_id, device_id);
+  }
+
+  setThemeMode(themeMode: ThemeMode): void {
+    return PluginEngagementReactNative.setThemeMode(this.id, themeMode);
+  }
+
+  reset(key: string, stepIndex: number): void {
+    return PluginEngagementReactNative.reset(this.id, key, stepIndex);
+  }
+
+  list(): GuideOrSurvey[] {
+    return PluginEngagementReactNative.list(this.id);
+  }
+
+  show(key: string, stepIndex: number): void {
+    return PluginEngagementReactNative.show(this.id, key, stepIndex);
+  }
+
+  screen(screenName: string): void {
+    return PluginEngagementReactNative.screen(this.id, screenName);
+  }
+
+  closeAll(): void {
+    return PluginEngagementReactNative.closeAll(this.id);
+  }
+
+  forwardEvent(event: BaseEvent): void {
+    return PluginEngagementReactNative.forwardEvent(this.id, event);
+  }
+
+  addCallback(key: string, func: () => void): void {
+    return PluginEngagementReactNative.addCallback(this.id, key, func);
+  }
+
+  handleURL(url: string): boolean {
+    return PluginEngagementReactNative.handleURL(this.id, url);
+  }
+}

package/src/AmplitudeEngagementPlugin.ts

@@ -0,0 +1,47 @@
+import type {
+  Config,
+  CoreClient,
+  EnrichmentPlugin,
+  Event,
+} from '@amplitude/analytics-types';
+import { forwardEvent, init, screen } from '.';
+import { Logger, type AmplitudeLogger } from './logger';
+
+export class AmplitudeEngagementPlugin implements EnrichmentPlugin {
+  name = 'AmplitudeEngagementPlugin';
+  type = 'enrichment' as const;
+
+  logger: AmplitudeLogger = new Logger('AmplitudeEngagementPlugin');
+
+  async setup(config: Config, _client: CoreClient): Promise<void> {
+    try {
+      console.log('initializing with apiKey', config.apiKey);
+      init(config.apiKey);
+    } catch (error) {
+      this.logger.error(
+        'AmplitudeEngagementPlugin#setup failed to initialize',
+        error
+      );
+    }
+
+    // TODO: call "boot" here -- but we don't have the user_id and device_id yet so we cannot
+  }
+
+  async execute(context: Event): Promise<Event | null> {
+    console.log(`AmplitudeEngagement#execute event=${JSON.stringify(context)}`);
+
+    if (
+      context.event_type === '[Amplitude] Screen Viewed' &&
+      typeof context.event_properties?.['[Amplitude] Screen Name'] === 'string'
+    ) {
+      const screenName = context.event_properties[
+        '[Amplitude] Screen Name'
+      ] as string;
+      screen(screenName);
+    }
+
+    forwardEvent(context);
+
+    return context;
+  }
+}

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';