react-native-acoustic-connect 16.0.39 → 19.0.3

package/lib/typescript/src/specs/react-native-acoustic-connect.nitro.d.ts

@@ -0,0 +1,245 @@
+import { type HybridObject } from 'react-native-nitro-modules';
+export type KeyValueObject = {
+    placeholder: string;
+    [key: string]: unknown;
+};
+export type ConnectMonitoringLevelType = 'Ignore' | 'CellularAndWiFi' | 'WiFi';
+/**
+ * Structured error describing an APNs / permission failure.
+ *
+ * Mirrors the `firebase-messaging` / `notifee` ecosystem convention so callers
+ * can forward a native error object without string-encoding it. The native
+ * bridge reconstructs an `NSError` (iOS) from these fields.
+ */
+export interface PushErrorInfo {
+    /** Platform error code, when available (maps to `NSError.code`). */
+    code?: number;
+    /** Platform error domain, when available (maps to `NSError.domain`). */
+    domain?: string;
+    /** Human-readable failure description (maps to `NSLocalizedDescriptionKey`). */
+    message: string;
+}
+/**
+ * Result of a permission request.
+ *
+ * The Promise from {@link AcousticConnectRN.pushRequestPermission} always
+ * resolves with this shape and never rejects. `error` is `null` on success or
+ * a denial with no system error; a non-null string carries the system error's
+ * localized description, or `'permission-prompt-abandoned'` if the host was
+ * destroyed mid-prompt.
+ */
+export interface PushPermissionResult {
+    /** `true` if the user granted permission, `false` otherwise. */
+    granted: boolean;
+    /** `null` on success/clean denial; otherwise a description of the error. */
+    error?: string | null;
+}
+export interface AcousticConnectRN extends HybridObject<{
+    ios: 'swift';
+    android: 'kotlin';
+}> {
+    /**
+     * Re-enables the Connect SDK after a prior {@link disable} call.
+     *
+     * The SDK auto-initialises at module load time using the values from
+     * `ConnectConfig.json` at the consumer's project root — so for most apps
+     * there is no need to call `enable()` at all. The method exists as the
+     * pair of {@link disable}: if a consent flow, A/B-test gate, or opt-out
+     * toggle previously called `disable()`, calling `enable()` brings the
+     * SDK back up using the same bundled configuration.
+     *
+     * @returns `true` when the call was accepted and dispatched to the native
+     *   SDK. `false` only when the platform cannot satisfy a precondition
+     *   (e.g. Android without an `Application` context yet).
+     *
+     * @remarks
+     * **Single source of truth.** All configuration (AppKey, PostMessageUrl,
+     * push, platform extras) lives in `ConnectConfig.json` at the consumer's
+     * project root. The podspec (iOS) and `config.gradle` (Android) bake
+     * those values into the bundled config that the native bridge reads at
+     * init time. There is no runtime override path — by design, to eliminate
+     * the inconsistency surface that runtime arguments would create against
+     * the bundled config.
+     *
+     * **Idempotency.** Owned by the native SDK. iOS
+     * `ConnectSDK.shared.enable(with:)` short-circuits via
+     * `guard !isEnabled else { return }` in its internal `enableCore`; the
+     * Android `Connect.init` / `Connect.enable` pair behaves the same way
+     * once the SDK is running.
+     *
+     * **Threading.** Returns synchronously; the native SDK call is
+     * fire-and-forget on the main thread / actor.
+     *
+     * @example User opt-in after a prior opt-out
+     * ```ts
+     * import AcousticConnectRN from 'react-native-acoustic-connect-beta'
+     *
+     * function onUserOptIn() {
+     *   AcousticConnectRN.enable()
+     * }
+     * ```
+     */
+    enable(): boolean;
+    /**
+     * Disables the Connect SDK and stops all data capture.
+     *
+     * After this call the SDK flushes pending data to the backend, stops
+     * listening for events, and releases push state. Call {@link enable}
+     * to bring the SDK back up using the same bundled configuration.
+     *
+     * @returns `true` when the call was accepted and dispatched. Idempotent —
+     *   calling `disable()` on an already-disabled SDK is safe.
+     *
+     * @example User opt-out flow
+     * ```ts
+     * import AcousticConnectRN from 'react-native-acoustic-connect-beta'
+     *
+     * function onUserOptOut() {
+     *   AcousticConnectRN.disable()
+     * }
+     * ```
+     */
+    disable(): boolean;
+    setBooleanConfigItemForKey(key: string, value: boolean, moduleName: string): boolean;
+    setStringItemForKey(key: string, value: string, moduleName: string): boolean;
+    setNumberItemForKey(key: string, value: number, moduleName: string): boolean;
+    setConfigItemForKey(key: string, value: string | number | boolean, moduleName: string): boolean;
+    getBooleanConfigItemForKey(theDefault: boolean, key: string, moduleName: string): boolean;
+    getStringItemForKey(theDefault: string, key: string, moduleName: string): string | null | undefined;
+    getNumberItemForKey(theDefault: number, key: string, moduleName: string): number;
+    logCustomEvent(eventName: string, values: Record<string, string | number | boolean>, level: number): boolean;
+    logSignal(values: Record<string, string | number | boolean>, level: number): boolean;
+    logExceptionEvent(message: string, stackInfo: string, unhandled: boolean): boolean;
+    logLocation(): boolean;
+    logLocationWithLatitudeLongitude(latitude: number, longitude: number, level: number): boolean;
+    logClickEvent(target: number, controlId: string): boolean;
+    logTextChangeEvent(target: number, controlId: string, text: string | null | undefined): boolean;
+    setCurrentScreenName(logicalPageName: string): boolean;
+    logScreenViewContextLoad(logicalPageName: string | null | undefined, referrer: string | null | undefined): boolean;
+    logScreenViewContextUnload(logicalPageName: string | null | undefined, referrer: string | null | undefined): boolean;
+    logScreenLayout(name: string, delay: number): boolean;
+    logDialogShowEvent(dialogId: string, dialogTitle: string, dialogType: string): boolean;
+    logDialogDismissEvent(dialogId: string, dismissReason: string): boolean;
+    logDialogButtonClickEvent(dialogId: string, buttonText: string, buttonIndex: number): boolean;
+    logDialogCustomEvent(dialogId: string, eventName: string, values: Record<string, string | number | boolean>): boolean;
+    /**
+     * Logs a user identity so the current device/session can be associated with
+     * a known Connect contact — the foundation for audience building and
+     * cross-channel engagement. Wraps the native identity loggers
+     * (`ConnectSDK.shared.identity.log` on iOS, `Connect.logIdentificationEvent`
+     * on Android).
+     *
+     * Unlike the synchronous analytics loggers above, this returns a `Promise`:
+     * `ConnectSDK.shared` (iOS) is `@MainActor`-isolated, so the bridge hops to the
+     * main actor and resolves with the *real* success/failure value rather than
+     * firing and forgetting.
+     *
+     * The native APIs return `false` — and emit no signal — when either
+     * `identifierName` or `identifierValue` is empty/blank after trimming.
+     *
+     * @param identifierName  Identifier name, e.g. `'Email'`.
+     * @param identifierValue Identifier value, e.g. `'user@example.com'`.
+     * @param signalType      Optional signal type; the bridge supplies
+     *   `'loggedIn'` when omitted (identity logging typically marks a sign-in),
+     *   overriding the native SDKs' own `'pageView'` default.
+     * @param additionalParameters Optional extra key/value pairs merged into the
+     *   signal payload. Only when omitted (`undefined`) does the bridge supply
+     *   the default `{ registrationMethod: 'email' }`; an explicitly-provided
+     *   map is used as-is, so passing an empty `{}` sends no extra parameters
+     *   (the default is not merged in). A `'url'` entry is honoured uniformly on
+     *   both platforms: on Android it is routed to the SDK's explicit `url`
+     *   parameter, on iOS it rides inside the parameter map (where the native
+     *   API expects it).
+     * @returns A promise resolving to `true` if the identity signal was
+     *   dispatched, `false` otherwise (including the blank-identifier case).
+     *   Never rejects.
+     *
+     * @example
+     * ```ts
+     * import AcousticConnectRN from 'react-native-acoustic-connect-beta'
+     *
+     * await AcousticConnectRN.logIdentity('Email', 'user@example.com')
+     * ```
+     */
+    logIdentity(identifierName: string, identifierValue: string, signalType?: string, additionalParameters?: Record<string, string>): Promise<boolean>;
+    /**
+     * Forwards the raw APNs device token to the Connect SDK (manual mode).
+     *
+     * Nitro maps `ArrayBuffer` ↔ `Data` natively; the bridge forwards the bytes
+     * unchanged with no hex conversion and no validation.
+     *
+     * @param deviceToken Raw APNs device-token bytes from
+     *   `didRegisterForRemoteNotificationsWithDeviceToken`.
+     * @returns A promise resolving to `true` once the SDK accepted the token,
+     *   or `false` if the SDK rejected the call (e.g. push not enabled). Never
+     *   rejects.
+     */
+    pushDidRegisterWithToken(deviceToken: ArrayBuffer): Promise<boolean>;
+    /**
+     * Forwards an APNs registration failure to the Connect SDK (manual mode).
+     *
+     * @param error Structured error; the bridge builds an `NSError` from it.
+     * @returns A promise resolving to `true` once forwarded, `false` on failure.
+     *   Never rejects.
+     */
+    pushDidFailToRegister(error: PushErrorInfo): Promise<boolean>;
+    /**
+     * Forwards a received notification to the Connect SDK so it can log a
+     * `pushReceived` signal (manual mode).
+     *
+     * The bridge branches on the push mode resolved from `ConnectConfig.json`:
+     * manual mode forwards to the SDK and returns `true`; automatic/off mode
+     * returns `false` (bridge error `EAC-RN-007`) without forwarding, because
+     * the SDK's own delegate already handles delivery in automatic mode and
+     * forwarding would double-log.
+     *
+     * @param userInfo The notification `userInfo` payload.
+     * @returns A promise resolving to `true` if processed (manual mode), or
+     *   `false` in automatic/off mode (`EAC-RN-007`). Never rejects.
+     */
+    pushDidReceiveNotification(userInfo: Record<string, string | number | boolean>): Promise<boolean>;
+    /**
+     * Forwards a notification response (tap / action) to the Connect SDK so it
+     * can run the built-in action and log a `pushAction` signal (manual mode).
+     *
+     * Same `EAC-RN-007` (`false`) behaviour in automatic mode as
+     * {@link pushDidReceiveNotification}.
+     *
+     * @param actionIdentifier The response action identifier.
+     * @param userInfo The notification `userInfo` payload.
+     * @returns A promise resolving to `true` if processed (manual mode), or
+     *   `false` in automatic/off mode (`EAC-RN-007`). Never rejects.
+     */
+    pushDidReceiveResponse(actionIdentifier: string, userInfo: Record<string, string | number | boolean>): Promise<boolean>;
+    /**
+     * Forwards externally-obtained permission state to the SDK.
+     *
+     * Tri-state `granted`: `true` granted, `false` denied, `null` not yet
+     * determined. For `null` the bridge records the state but does not call the
+     * SDK (it has no notion of forwarding "unknown").
+     *
+     * @param granted Tri-state permission value.
+     * @param error Optional structured error accompanying a denial.
+     * @returns A promise resolving to `true` once handled — including the
+     *   `null`/not-determined case, which is intentionally accepted without
+     *   forwarding to the SDK. `false` only if the SDK rejected a forwarded
+     *   state. Never rejects.
+     */
+    pushDidReceiveAuthorization(granted: boolean | null, error?: PushErrorInfo): Promise<boolean>;
+    /**
+     * Requests notification permission via the SDK, presenting the system prompt
+     * when undetermined.
+     *
+     * Always resolves, never rejects — see {@link PushPermissionResult}.
+     *
+     * @returns The permission result.
+     */
+    pushRequestPermission(): Promise<PushPermissionResult>;
+    /**
+     * Reads the current notification permission state without prompting.
+     *
+     * @returns Tri-state: `true` granted, `false` denied, `null` not determined.
+     */
+    pushGetPermissionState(): Promise<boolean | null>;
+}
+//# sourceMappingURL=react-native-acoustic-connect.nitro.d.ts.map

package/lib/typescript/src/specs/react-native-acoustic-connect.nitro.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-native-acoustic-connect.nitro.d.ts","sourceRoot":"","sources":["../../../../src/specs/react-native-acoustic-connect.nitro.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/utils/DialogDebugger.d.ts

@@ -0,0 +1,58 @@
+/********************************************************************************************
+* Copyright (C) 2025 Acoustic, L.P. All rights reserved.
+*
+* NOTICE: This file contains material that is confidential and proprietary to
+* Acoustic, L.P. and/or other developers. No license is granted under any intellectual or
+* industrial property rights of Acoustic, L.P. except as may be provided in an agreement with
+* Acoustic, L.P. Any unauthorized copying or distribution of content from this file is
+* prohibited.
+********************************************************************************************/
+/**
+ * Debug utility for dialog event tracking
+ * Helps identify issues with dialog event interception and logging
+ */
+export declare class DialogDebugger {
+    private static instance;
+    private isEnabled;
+    private originalAlert;
+    private constructor();
+    static getInstance(): DialogDebugger;
+    /**
+     * Enable debug mode
+     */
+    enable(): void;
+    /**
+     * Disable debug mode
+     */
+    disable(): void;
+    /**
+     * Test the complete dialog event flow
+     */
+    testDialogEventFlow(): void;
+    /**
+     * Test DialogListener functionality
+     */
+    private testDialogListener;
+    /**
+     * Test TLTRN methods
+     */
+    private testTLTRNMethods;
+    /**
+     * Test Alert.alert override
+     */
+    private testAlertOverride;
+    /**
+     * Test native method calls
+     */
+    private testNativeMethods;
+    /**
+     * Check if dialog tracking is properly enabled
+     */
+    checkDialogTrackingStatus(): void;
+    /**
+     * Force enable dialog tracking for testing
+     */
+    forceEnableDialogTracking(): void;
+}
+export default DialogDebugger;
+//# sourceMappingURL=DialogDebugger.d.ts.map

package/lib/typescript/src/utils/DialogDebugger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DialogDebugger.d.ts","sourceRoot":"","sources":["../../../../src/utils/DialogDebugger.ts"],"names":[],"mappings":"AAAA;;;;;;;;6FAQ6F;AAM7F;;;GAGG;AACH,qBAAa,cAAc;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAiB;IACxC,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,aAAa,CAAqB;IAE1C,OAAO;IAIP,MAAM,CAAC,WAAW,IAAI,cAAc;IAOpC;;OAEG;IACH,MAAM,IAAI,IAAI;IAKd;;OAEG;IACH,OAAO,IAAI,IAAI;IAKf;;OAEG;IACH,mBAAmB,IAAI,IAAI;IAgB3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAuB1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA0BxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAsBzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAsBzB;;OAEG;IACH,yBAAyB,IAAI,IAAI;IAwBjC;;OAEG;IACH,yBAAyB,IAAI,IAAI;CAiBpC;AAED,eAAe,cAAc,CAAC"}

package/lib/typescript/src/utils/DialogListener.d.ts

@@ -0,0 +1,85 @@
+/********************************************************************************************
+* Copyright (C) 2025 Acoustic, L.P. All rights reserved.
+*
+* NOTICE: This file contains material that is confidential and proprietary to
+* Acoustic, L.P. and/or other developers. No license is granted under any intellectual or
+* industrial property rights of Acoustic, L.P. except as may be provided in an agreement with
+* Acoustic, L.P. Any unauthorized copying or distribution of content from this file is
+* prohibited.
+********************************************************************************************/
+import type { AlertButton } from 'react-native';
+export interface DialogEvent {
+    dialogId: string;
+    dialogTitle: string;
+    dialogType: 'alert' | 'custom' | 'modal';
+    timestamp: number;
+    buttons?: AlertButton[];
+}
+export interface DialogButtonClickEvent {
+    dialogId: string;
+    buttonText: string;
+    buttonIndex: number;
+    timestamp: number;
+}
+export interface DialogDismissEvent {
+    dialogId: string;
+    dialogTitle: string;
+    dialogType: 'alert' | 'custom' | 'modal';
+    dismissReason: string;
+    timestamp: number;
+}
+declare class DialogListener {
+    private static instance;
+    private activeDialogs;
+    private originalAlert;
+    private isIntercepting;
+    private eventCallbacks;
+    private constructor();
+    static getInstance(): DialogListener;
+    /**
+     * Start intercepting dialog events
+     */
+    startIntercepting(): void;
+    /**
+     * Stop intercepting dialog events
+     */
+    stopIntercepting(): void;
+    /**
+     * Add event callback for dialog events
+     */
+    addEventListener(callback: (event: DialogEvent | DialogButtonClickEvent | DialogDismissEvent) => void): () => void;
+    /**
+     * Intercept React Native's Alert.alert API
+     */
+    private interceptAlertAPI;
+    /**
+     * Manually track custom dialog show event
+     */
+    trackCustomDialogShow(dialogId: string, title: string, buttons?: AlertButton[]): void;
+    /**
+     * Manually track custom dialog dismiss event
+     */
+    trackCustomDialogDismiss(dialogId: string, reason?: string): void;
+    /**
+     * Manually track custom dialog button click event
+     */
+    trackCustomDialogButtonClick(dialogId: string, buttonText: string, buttonIndex: number): void;
+    /**
+     * Get currently active dialogs
+     */
+    getActiveDialogs(): DialogEvent[];
+    /**
+     * Clear all active dialogs
+     */
+    clearActiveDialogs(): void;
+    /**
+     * Emit event to all registered callbacks
+     */
+    private emitEvent;
+    /**
+     * Restore original Alert.alert API
+     */
+    restoreOriginalAlert(): void;
+}
+export default DialogListener;
+//# sourceMappingURL=DialogListener.d.ts.map

package/lib/typescript/src/utils/DialogListener.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DialogListener.d.ts","sourceRoot":"","sources":["../../../../src/utils/DialogListener.ts"],"names":[],"mappings":"AAAA;;;;;;;;6FAQ6F;AAG7F,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,cAAc,CAAC;AAE9D,MAAM,WAAW,WAAW;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IACzC,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACrB;AAOD,cAAM,cAAc;IAChB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAiB;IACxC,OAAO,CAAC,aAAa,CAAuC;IAC5D,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,cAAc,CAAyF;IAE/G,OAAO;IAKP,MAAM,CAAC,WAAW,IAAI,cAAc;IAOpC;;OAEG;IACH,iBAAiB,IAAI,IAAI;IAMzB;;OAEG;IACH,gBAAgB,IAAI,IAAI;IAMxB;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,GAAG,sBAAsB,GAAG,kBAAkB,KAAK,IAAI,GAAG,MAAM,IAAI;IAUlH;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAkDzB;;OAEG;IACH,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,EAAE,GAAG,IAAI;IAerF;;OAEG;IACH,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,MAAiB,GAAG,IAAI;IAqB3E;;OAEG;IACH,4BAA4B,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAa7F;;OAEG;IACH,gBAAgB,IAAI,WAAW,EAAE;IAIjC;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAI1B;;OAEG;IACH,OAAO,CAAC,SAAS;IAUjB;;OAEG;IACH,oBAAoB,IAAI,IAAI;CAG/B;AAED,eAAe,cAAc,CAAC"}

package/lib/typescript/src/utils/KeyboardListener.d.ts

@@ -0,0 +1,20 @@
+/********************************************************************************************
+* Copyright (C) 2025 Acoustic, L.P. All rights reserved.
+*
+* NOTICE: This file contains material that is confidential and proprietary to
+* Acoustic, L.P. and/or other developers. No license is granted under any intellectual or
+* industrial property rights of Acoustic, L.P. except as may be provided in an agreement with
+* Acoustic, L.P. Any unauthorized copying or distribution of content from this file is
+* prohibited.
+********************************************************************************************/
+import TLTRN from '../TLTRN';
+declare class KeyboardListener {
+    static TLTRN: TLTRN | null;
+    static listener: KeyboardListener | null;
+    static _instance(_TLTRN: TLTRN): KeyboardListener;
+    enabled: boolean;
+    constructor(_TLTRN: TLTRN);
+    interceptKeyboardEvents(enable: boolean): void;
+}
+export default KeyboardListener;
+//# sourceMappingURL=KeyboardListener.d.ts.map

package/lib/typescript/src/utils/KeyboardListener.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KeyboardListener.d.ts","sourceRoot":"","sources":["../../../../src/utils/KeyboardListener.ts"],"names":[],"mappings":"AAAA;;;;;;;;6FAQ6F;AAG7F,OAAO,KAAK,MAAM,UAAU,CAAC;AAE7B,cAAM,gBAAgB;IAClB,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAQ;IAClC,MAAM,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAQ;IAEhD,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,KAAK,GAAG,gBAAgB;IAOjD,OAAO,EAAE,OAAO,CAAC;gBAEL,MAAM,EAAE,KAAK;IAiFzB,uBAAuB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;CAGjD;AAED,eAAe,gBAAgB,CAAC"}

package/lib/typescript/src/utils/useDialogTracking.d.ts

@@ -0,0 +1,25 @@
+/********************************************************************************************
+* Copyright (C) 2025 Acoustic, L.P. All rights reserved.
+*
+* NOTICE: This file contains material that is confidential and proprietary to
+* Acoustic, L.P. and/or other developers. No license is granted under any intellectual or
+* industrial property rights of Acoustic, L.P. except as may be provided in an agreement with
+* Acoustic, L.P. Any unauthorized copying or distribution of content from this file is
+* prohibited.
+********************************************************************************************/
+import type { AlertButton } from 'react-native';
+/**
+ * React hook for tracking custom dialog events
+ * Provides utilities to track dialog show, dismiss, and button click events
+ */
+export declare const useDialogTracking: () => {
+    generateDialogId: () => string;
+    trackDialogShow: (dialogId: string, title: string, buttons?: AlertButton[]) => void;
+    trackDialogDismiss: (dialogId: string, reason?: string) => void;
+    trackDialogButtonClick: (dialogId: string, buttonText: string, buttonIndex: number) => void;
+    trackDialogCustomEvent: (dialogId: string, eventName: string, values: Record<string, string | number | boolean>) => void;
+    createTrackedButton: (dialogId: string, button: AlertButton, buttonIndex: number) => AlertButton;
+    cleanup: () => void;
+};
+export default useDialogTracking;
+//# sourceMappingURL=useDialogTracking.d.ts.map

package/lib/typescript/src/utils/useDialogTracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDialogTracking.d.ts","sourceRoot":"","sources":["../../../../src/utils/useDialogTracking.ts"],"names":[],"mappings":"AAAA;;;;;;;;6FAQ6F;AAG7F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAIhD;;;GAGG;AACH,eAAO,MAAM,iBAAiB;4BAMe,MAAM;gCASA,MAAM,SAAS,MAAM,YAAY,WAAW,EAAE;mCAS3C,MAAM,WAAU,MAAM;uCASlB,MAAM,cAAc,MAAM,eAAe,MAAM;uCAS/C,MAAM,aAAa,MAAM,UAAU,OAAO,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;oCAO/E,MAAM,UAAU,WAAW,eAAe,MAAM,KAAG,WAAW;;CA+BpH,CAAC;AAEF,eAAe,iBAAiB,CAAC"}

package/lib/typescript/src/utils/withAcousticAutoDialog.d.ts

@@ -0,0 +1,37 @@
+/********************************************************************************************
+* Copyright (C) 2025 Acoustic, L.P. All rights reserved.
+*
+* NOTICE: This file contains material that is confidential and proprietary to
+* Acoustic, L.P. and/or other developers. No license is granted under any intellectual or
+* industrial property rights of Acoustic, L.P. except as may be provided in an agreement with
+* Acoustic, L.P. Any unauthorized copying or distribution of content from this file is
+* prohibited.
+*
+* Created on 5/9/25.
+*
+********************************************************************************************/
+import React from 'react';
+/**
+ * HOC Wrapper that automatically tracks dialog show/dismiss events and button clicks
+ * Works with any dialog component that has 'visible' and 'onDismiss' props
+ *
+ * Supported Dialog Patterns:
+ * - react-native-paper Dialog components
+ * - Custom modal components with visible/onDismiss props
+ * - Components with different prop names (show/hide, open/close, etc.)
+ * - Components with custom button implementations
+ * - Components with nested dialog structures
+ */
+export declare function withAcousticAutoDialog(DialogComponent: React.ComponentType<any>): React.ComponentType<any>;
+/**
+ * Convenience function to create tracked versions of common dialog components
+ */
+export declare function createTrackedDialogComponents(): {};
+/**
+ * Hook to get tracked dialog components
+ */
+export declare function useTrackedDialogs(): {
+    withAcousticAutoDialog: typeof withAcousticAutoDialog;
+    createTrackedDialogComponents: typeof createTrackedDialogComponents;
+};
+//# sourceMappingURL=withAcousticAutoDialog.d.ts.map

package/lib/typescript/src/utils/withAcousticAutoDialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withAcousticAutoDialog.d.ts","sourceRoot":"","sources":["../../../../src/utils/withAcousticAutoDialog.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;6FAW6F;AAE7F,OAAO,KAA0E,MAAM,OAAO,CAAC;AAK/F;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CACpC,eAAe,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,GACxC,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAgQ1B;AAED;;GAEG;AACH,wBAAgB,6BAA6B,OAS5C;AAED;;GAEG;AACH,wBAAgB,iBAAiB;;;EAKhC"}

package/nitrogen/generated/.gitattributes

@@ -0,0 +1 @@
+** linguist-generated=true

package/nitrogen/generated/android/AcousticConnectRN+autolinking.cmake

@@ -0,0 +1,84 @@
+#
+# AcousticConnectRN+autolinking.cmake
+# This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+# https://github.com/mrousavy/nitro
+# Copyright © Marc Rousavy @ Margelo
+#
+
+# This is a CMake file that adds all files generated by Nitrogen
+# to the current CMake project.
+#
+# To use it, add this to your CMakeLists.txt:
+# ```cmake
+# include(${CMAKE_SOURCE_DIR}/../nitrogen/generated/android/AcousticConnectRN+autolinking.cmake)
+# ```
+
+# Define a flag to check if we are building properly
+add_definitions(-DBUILDING_ACOUSTICCONNECTRN_WITH_GENERATED_CMAKE_PROJECT)
+
+# Enable Raw Props parsing in react-native (for Nitro Views)
+add_definitions(-DRN_SERIALIZABLE_STATE)
+
+# Add all headers that were generated by Nitrogen
+include_directories(
+  "../nitrogen/generated/shared/c++"
+  "../nitrogen/generated/android/c++"
+  "../nitrogen/generated/android/"
+)
+
+# Add all .cpp sources that were generated by Nitrogen
+target_sources(
+  # CMake project name (Android C++ library name)
+  AcousticConnectRN PRIVATE
+  # Autolinking Setup
+  ../nitrogen/generated/android/AcousticConnectRNOnLoad.cpp
+  # Shared Nitrogen C++ sources
+  ../nitrogen/generated/shared/c++/HybridAcousticConnectRNSpec.cpp
+  # Android-specific Nitrogen C++ sources
+  ../nitrogen/generated/android/c++/JHybridAcousticConnectRNSpec.cpp
+  ../nitrogen/generated/android/c++/JVariant_NullType_String.cpp
+  ../nitrogen/generated/android/c++/JVariant_NullType_Boolean.cpp
+  ../nitrogen/generated/android/c++/JVariant_Boolean_String_Double.cpp
+)
+
+# From node_modules/react-native/ReactAndroid/cmake-utils/folly-flags.cmake
+# Used in node_modules/react-native/ReactAndroid/cmake-utils/ReactNative-application.cmake
+target_compile_definitions(
+  AcousticConnectRN PRIVATE
+  -DFOLLY_NO_CONFIG=1
+  -DFOLLY_HAVE_CLOCK_GETTIME=1
+  -DFOLLY_USE_LIBCPP=1
+  -DFOLLY_CFG_NO_COROUTINES=1
+  -DFOLLY_MOBILE=1
+  -DFOLLY_HAVE_RECVMMSG=1
+  -DFOLLY_HAVE_PTHREAD=1
+  # Once we target android-23 above, we can comment
+  # the following line. NDK uses GNU style stderror_r() after API 23.
+  -DFOLLY_HAVE_XSI_STRERROR_R=1
+)
+
+# Add all libraries required by the generated specs
+find_package(fbjni REQUIRED) # <-- Used for communication between Java <-> C++
+find_package(ReactAndroid REQUIRED) # <-- Used to set up React Native bindings (e.g. CallInvoker/TurboModule)
+find_package(react-native-nitro-modules REQUIRED) # <-- Used to create all HybridObjects and use the Nitro core library
+
+# Link all libraries together
+target_link_libraries(
+        AcousticConnectRN
+        fbjni::fbjni                              # <-- Facebook C++ JNI helpers
+        ReactAndroid::jsi                         # <-- RN: JSI
+        react-native-nitro-modules::NitroModules  # <-- NitroModules Core :)
+)
+
+# Link react-native (different prefab between RN 0.75 and RN 0.76)
+if(ReactAndroid_VERSION_MINOR GREATER_EQUAL 76)
+    target_link_libraries(
+        AcousticConnectRN
+        ReactAndroid::reactnative                 # <-- RN: Native Modules umbrella prefab
+    )
+else()
+    target_link_libraries(
+        AcousticConnectRN
+        ReactAndroid::react_nativemodule_core     # <-- RN: TurboModules Core
+    )
+endif()

package/nitrogen/generated/android/AcousticConnectRN+autolinking.gradle

@@ -0,0 +1,27 @@
+///
+/// AcousticConnectRN+autolinking.gradle
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+/// This is a Gradle file that adds all files generated by Nitrogen
+/// to the current Gradle project.
+///
+/// To use it, add this to your build.gradle:
+/// ```gradle
+/// apply from: '../nitrogen/generated/android/AcousticConnectRN+autolinking.gradle'
+/// ```
+
+logger.warn("[NitroModules] 🔥 AcousticConnectRN is boosted by nitro!")
+
+android {
+  sourceSets {
+    main {
+      java.srcDirs += [
+        // Nitrogen files
+        "${project.projectDir}/../nitrogen/generated/android/kotlin"
+      ]
+    }
+  }
+}