com-tapp-so-sdk 0.1.0

package/package.json

@@ -0,0 +1,169 @@
+{
+  "name": "com-tapp-so-sdk",
+  "version": "0.1.0",
+  "description": "react native tapp sdk",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "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 com-tapp-so-sdk-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": "release-it --only-version"
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tapp-so/Tapp-RN"
+  },
+  "author": "nick@tapp.so <nick@tapp.so> (https://www.tapp.so/)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/tapp-so/Tapp-RN/issues"
+  },
+  "homepage": "https://github.com/tapp-so/Tapp-RN#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@commitlint/config-conventional": "^19.8.1",
+    "@eslint/compat": "^1.3.2",
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.35.0",
+    "@evilmartians/lefthook": "^1.12.3",
+    "@react-native-community/cli": "20.0.1",
+    "@react-native/babel-preset": "0.81.1",
+    "@react-native/eslint-config": "^0.81.1",
+    "@release-it/conventional-changelog": "^10.0.1",
+    "@types/jest": "^29.5.14",
+    "@types/react": "^19.1.0",
+    "commitlint": "^19.8.1",
+    "del-cli": "^6.0.0",
+    "eslint": "^9.35.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "jest": "^29.7.0",
+    "prettier": "^3.6.2",
+    "react": "19.1.0",
+    "react-native": "0.81.1",
+    "react-native-builder-bob": "^0.40.14",
+    "release-it": "^19.0.4",
+    "turbo": "^2.5.6",
+    "typescript": "^5.9.2"
+  },
+  "peerDependencies": {
+    "react": ">=17",
+    "react-native": ">=0.70.0"
+  },
+  "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",
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ],
+      "codegen"
+    ]
+  },
+  "codegenConfig": {
+    "name": "ComTappSoSdkSpec",
+    "type": "modules",
+    "jsSrcsDir": "src",
+    "outputDir": {
+      "ios": "ios/generated",
+      "android": "android/build/generated/source/codegen"
+    },
+    "android": {
+      "javaPackageName": "com.comtappsosdk"
+    },
+    "includesGeneratedCode": true
+  },
+  "create-react-native-library": {
+    "languages": "kotlin-objc",
+    "type": "turbo-module",
+    "version": "0.54.8"
+  }
+}

package/src/NativeComTappSoSdk.ts

@@ -0,0 +1,46 @@
+import { TurboModuleRegistry, type TurboModule } from 'react-native';
+import { type UnsafeObject } from 'react-native/Libraries/Types/CodegenTypes';
+
+export interface Spec extends TurboModule {
+  start(authToken: string, env: string, tappToken: string): void;
+
+  url(
+    influencer: string,
+    adGroup?: string,
+    creative?: string,
+    data?: { [key: string]: string }
+  ): Promise<string>;
+
+  handleTappEvent(
+    eventAction: number,
+    customValue?: string,
+    metadata?: UnsafeObject
+  ): Promise<string>;
+
+  fetchLinkData(deepLink: string): Promise<{
+    error: boolean;
+    message?: string;
+    tappUrl?: string;
+    attrTappUrl?: string;
+    influencer?: string;
+    data?: { [key: string]: string };
+    isFirstSession?: boolean;
+    deepLink?: string;
+  }>;
+
+  shouldProcess(deepLink: string): Promise<boolean>;
+
+  fetchOriginLinkData(): Promise<{
+    error: boolean;
+    message?: string;
+    tappUrl?: string;
+    attrTappUrl?: string;
+    influencer?: string;
+    data?: { [key: string]: string };
+    isFirstSession?: boolean;
+  }>;
+
+  simulateTestEvent(): void;
+}
+
+export default TurboModuleRegistry.getEnforcing<Spec>('ComTappSoSdk');

package/src/Types.ts

@@ -0,0 +1,149 @@
+export type InitConfig = {
+  authToken: string;
+  env: EnvironmentType;
+  tappToken: string;
+  //affiliate: AffiliateType;
+};
+
+export type EnvironmentType = 'PRODUCTION' | 'SANDBOX';
+
+export type AffiliateType = 'ADJUST' | 'APPFLYER' | 'TAPP' | 'TAPP_NATIVE';
+
+export enum EventAction {
+  TAPP_ADD_PAYMENT_INFO = 1,
+  TAPP_ADD_TO_CART = 2,
+  TAPP_ADD_TO_WISHLIST = 3,
+  TAPP_COMPLETE_REGISTRATION = 4,
+  TAPP_CONTACT = 5,
+  TAPP_CUSTOMIZE_PRODUCT = 6,
+  TAPP_DONATE = 7,
+  TAPP_FIND_LOCATION = 8,
+  TAPP_INITIATE_CHECKOUT = 9,
+  TAPP_GENERATE_LEAD = 10,
+  TAPP_PURCHASE = 11,
+  TAPP_SCHEDULE = 12,
+  TAPP_SEARCH = 13,
+  TAPP_START_TRIAL = 14,
+  TAPP_SUBMIT_APPLICATION = 15,
+  TAPP_SUBSCRIBE = 16,
+  TAPP_VIEW_CONTENT = 17,
+  TAPP_CLICK_BUTTON = 18,
+  TAPP_DOWNLOAD_FILE = 19,
+  TAPP_JOIN_GROUP = 20,
+  TAPP_ACHIEVE_LEVEL = 21,
+  TAPP_CREATE_GROUP = 22,
+  TAPP_CREATE_ROLE = 23,
+  TAPP_LINK_CLICK = 24,
+  TAPP_LINK_IMPRESSION = 25,
+  TAPP_APPLY_FOR_LOAN = 26,
+  TAPP_LOAN_APPROVAL = 27,
+  TAPP_LOAN_DISBURSAL = 28,
+  TAPP_LOGIN = 29,
+  TAPP_RATE = 30,
+  TAPP_SPEND_CREDITS = 31,
+  TAPP_UNLOCK_ACHIEVEMENT = 32,
+  TAPP_ADD_SHIPPING_INFO = 33,
+  TAPP_EARN_VIRTUAL_CURRENCY = 34,
+  TAPP_START_LEVEL = 35,
+  TAPP_COMPLETE_LEVEL = 36,
+  TAPP_POST_SCORE = 37,
+  TAPP_SELECT_CONTENT = 38,
+  TAPP_BEGIN_TUTORIAL = 39,
+  TAPP_COMPLETE_TUTORIAL = 40,
+  CUSTOM = 0, // Special case for custom events
+}
+
+export type TappMetadataValue = string | boolean | number;
+export type TappMetadata = Record<string, TappMetadataValue>;
+
+export type TappEventType = {
+  eventAction: EventAction; // Enum for event actions
+  customValue?: string; // Optional custom value for custom events
+  metadata?: TappMetadata; // Optional event metadata (flat primitives only)
+};
+
+export type AdjustTrackAdRevenueType = {
+  source: string;
+  revenue: number;
+  currency: string;
+};
+
+export type AdjustPurchaseVerificationResult = {
+  success: boolean;
+  message: string;
+};
+export type TappLinkDataResponse = {
+  error: boolean;
+  message?: string;
+  tappUrl?: string;
+  attrTappUrl?: string;
+  influencer?: string;
+  data?: { [key: string]: string };
+  isFirstSession?: boolean;
+  deepLink?: string;
+};
+
+export type AdjustAttributionType = {
+  adid: string; // Not provided on Android, so will be an empty string.
+  trackerToken: string;
+  trackerName: string;
+  network: string;
+  campaign: string;
+  adgroup: string;
+  creative: string;
+  clickLabel: string;
+  costType: string;
+  costAmount: number;
+  costCurrency: string;
+  fbInstallReferrer: string; // Specific to Android.
+  costInUsd: number; // Not provided on Android, defaults to 0.0.
+  callbackParams: { [key: string]: string }; // Not available on Android, returned as an empty object.
+  partnerParams: { [key: string]: string }; // Not available on Android, returned as an empty object.
+};
+
+export interface VerifyResult {
+  verificationStatus: string;
+  code: number;
+  message: string;
+}
+
+export interface AppStoreSubscription {
+  price: number;
+  currency: string;
+  transactionId: string;
+  transactionDate?: number; // Timestamp
+  salesRegion?: string;
+  callbackParameters?: { [key: string]: string };
+  partnerParameters?: { [key: string]: string };
+}
+
+export interface PlayStoreSubscription {
+  price: number;
+  currency: string;
+  sku: string;
+  orderId: string;
+  signature: string;
+  purchaseToken: string;
+  purchaseTime?: number;
+}
+
+export type UpdateSkanConversionValueType = {
+  value: number;
+  coarseValue?: string;
+  lockWindow?: number;
+};
+
+export type VerifyPlayStorePurchaseType = {
+  transactionId: string;
+  productId: string;
+};
+
+export type VerifyPlayStorePurchaseCompletionType = (result: {
+  verificationStatus: string;
+  code: number;
+  message: string;
+}) => void;
+export interface DeferredLinkDelegate {
+  didReceiveDeferredLink(linkDataResponse: TappLinkDataResponse): void;
+  testListener(test: string): void;
+}

package/src/events.ts

@@ -0,0 +1,21 @@
+import { NativeEventEmitter, NativeModules } from 'react-native';
+import type { TappLinkDataResponse } from './Types';
+
+const { EventEmitter } = NativeModules;
+const eventEmitter = new NativeEventEmitter(EventEmitter);
+
+export function addDeferredLinkListener(
+  listener: (response: TappLinkDataResponse) => void
+) {
+  return eventEmitter.addListener('onDeferredLinkReceived', listener);
+}
+
+export function addDidFailResolvingURLListener(
+  listener: (response: { url: string; error: string }) => void
+) {
+  return eventEmitter.addListener('onDidFailResolvingURL', listener);
+}
+
+export function addTestListener(listener: (data: { test: string }) => void) {
+  return eventEmitter.addListener('onTestListener', listener);
+}

package/src/index.tsx

@@ -0,0 +1,81 @@
+import ComTappSoSdk from './NativeComTappSoSdk';
+import { Platform } from 'react-native';
+import {
+  EventAction,
+  type InitConfig,
+  type TappEventType,
+  type TappLinkDataResponse,
+} from './Types';
+
+// Helper to handle unsupported platforms
+const unsupportedPlatformMessage = (methodName: string) => {
+  console.log(`[${Platform.OS}] Method "${methodName}" is not supported.`);
+};
+
+export function start(config: InitConfig): void {
+  if (Platform.OS === 'web') {
+    unsupportedPlatformMessage('start');
+  }
+  ComTappSoSdk.start(config.authToken, config.env, config.tappToken);
+}
+
+export function url(
+  influencer: string,
+  adGroup?: string,
+  creative?: string,
+  data?: { [key: string]: string }
+): Promise<string> {
+  if (Platform.OS === 'web') {
+    unsupportedPlatformMessage('url');
+  }
+  return ComTappSoSdk.url(influencer, adGroup, creative, data);
+}
+
+export function handleTappEvent(event: TappEventType): Promise<string> {
+  if (Platform.OS === 'web') {
+    unsupportedPlatformMessage('handleTappEvent');
+  }
+
+  const value = event.customValue ?? 'custom_event_autogenerated';
+  const customValue =
+    event.eventAction === EventAction.CUSTOM ? value : undefined;
+
+  const metadata = event.metadata;
+
+  return ComTappSoSdk.handleTappEvent(
+    event.eventAction as number,
+    customValue,
+    metadata
+  );
+}
+
+export function fetchLinkData(deepLink: string): Promise<TappLinkDataResponse> {
+  if (Platform.OS === 'web') {
+    unsupportedPlatformMessage('fetchLinkData');
+  }
+  return ComTappSoSdk.fetchLinkData(deepLink);
+}
+
+export function shouldProcess(deepLink: string): Promise<boolean> {
+  if (Platform.OS === 'web') {
+    unsupportedPlatformMessage('shouldProcess');
+  }
+  return ComTappSoSdk.shouldProcess(deepLink);
+}
+
+export function fetchOriginLinkData(): Promise<TappLinkDataResponse> {
+  if (Platform.OS === 'web') {
+    unsupportedPlatformMessage('fetchOriginLinkData');
+  }
+  return ComTappSoSdk.fetchOriginLinkData();
+}
+
+export function simulateTestEvent(): void {
+  if (Platform.OS === 'web' || Platform.OS === 'ios') {
+    unsupportedPlatformMessage('simulateTestEvent');
+  }
+  return ComTappSoSdk.simulateTestEvent();
+}
+
+export * from './Types';
+export * from './events';