appsonair-react-native-applink/lib/module/index.js

A self-hosted dynamic link service for app download tracking, deep linking, and engagement analytics.

"use strict";

import { NativeEventEmitter, NativeModules, Platform } from 'react-native';
export * from "./types.js";
const LINKING_ERROR = `The package 'appsonair-react-native-applink' doesn't seem to be linked. Make sure: \n\n` + Platform.select({
  ios: "- You have run 'pod install'\n",
  default: ''
}) + '- You rebuilt the app after installing the package\n' + '- You are not using Expo Go\n';
const AppsonairReactNativeApplink = NativeModules.AppsonairReactNativeApplink ? NativeModules.AppsonairReactNativeApplink : new Proxy({}, {
  get() {
    throw new Error(LINKING_ERROR);
  }
});
const emitter = NativeModules.AppsonairReactNativeApplink ? new NativeEventEmitter(NativeModules.AppsonairReactNativeApplink) : null;

/**
 * Initializes the Appsonair React Native AppLink module.
 * Should be called once during app startup to set up deep link handling.
 *
 * @returns {Promise<boolean>} A promise that resolves to `true` if initialization succeeds.
 */
export const initializeAppLink = async () => {
  return await AppsonairReactNativeApplink.initialize();
};

/**
 * Creates a new app link using the provided parameters.
 * The resulting app link can be used to navigate to specific content within the app.
 *
 * @param {AppLinkParams} params - Parameters used to generate the deep link.
 * @returns {Promise<CreateAppLinkResponse>} A promise that resolves to the generated deep link URL, or `null` if creation fails.
 */
export const createAppLink = async ({
  url,
  name,
  urlPrefix,
  shortId = '',
  metaTitle = '',
  metaDescription = '',
  metaImageUrl = '',
  isOpenInBrowserAndroid = false,
  isOpenInAndroidApp = true,
  androidFallbackUrl = '',
  isOpenInBrowserApple = false,
  isOpenInIosApp = true,
  iOSFallbackUrl = ''
}) => {
  const result = await AppsonairReactNativeApplink.createAppLink({
    url,
    name,
    urlPrefix,
    shortId,
    metaTitle: metaTitle || null,
    metaDescription: metaDescription || null,
    metaImageUrl: metaImageUrl || null,
    isOpenInBrowserAndroid,
    isOpenInAndroidApp,
    androidFallbackUrl,
    isOpenInBrowserApple,
    isOpenInIosApp,
    iOSFallbackUrl
  });
  if (typeof result === 'string') {
    return JSON.parse(result);
  }
  return result;
};

/**
 * Fetches referral details from the Appsonair deep link service.
 * This method retrieves any available referral metadata associated with the user's session.
 *
 * @returns A Promise that resolves to an object containing referral details, or `null` if no referral data is available.
 */
export const getReferralDetails = async () => {
  return await AppsonairReactNativeApplink.getReferralDetails();
};

/**
 * Registers a listener for when a deep link is successfully processed.
 * The callback receives the processed deep link URL and any associated result data.
 *
 * @param {(event: { url: string; result: string }) => void} callback - Function to be called when a deep link is processed.
 * @returns {EmitterSubscription | null} An event subscription, or `null` if the listener could not be registered.
 */
export const onDeepLinkProcessed = callback => {
  return emitter?.addListener('onDeepLinkProcessed', callback) ?? null;
};
//# sourceMappingURL=index.js.map