@mobana/react-native-sdk 0.2.10

package/lib/module/storage.js

@@ -0,0 +1,257 @@
+"use strict";
+
+import AsyncStorage from '@react-native-async-storage/async-storage';
+const KEYS = {
+  INSTALL_ID: '@mobana:install_id',
+  ATTRIBUTION: '@mobana:attribution',
+  CONVERSION_QUEUE: '@mobana:conversion_queue',
+  LOCAL_DATA: '@mobana:local_data'
+};
+const FLOW_CACHE_PREFIX = '@mobana:flow:';
+
+/**
+ * Get or create a stable install ID (UUID)
+ * Generated once on first launch and persisted locally
+ */
+export async function getInstallId() {
+  try {
+    let installId = await AsyncStorage.getItem(KEYS.INSTALL_ID);
+    if (!installId) {
+      // Generate UUID v4
+      installId = generateUUID();
+      await AsyncStorage.setItem(KEYS.INSTALL_ID, installId);
+    }
+    return installId;
+  } catch {
+    // If storage fails, generate a new UUID each time
+    // This is suboptimal but ensures the SDK doesn't crash
+    return generateUUID();
+  }
+}
+
+/**
+ * Get cached attribution result (includes matched: false responses)
+ */
+export async function getCachedResult() {
+  try {
+    const data = await AsyncStorage.getItem(KEYS.ATTRIBUTION);
+    if (data) {
+      return JSON.parse(data);
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Store attribution result in cache (stores both matched and unmatched responses)
+ */
+export async function setCachedResult(matched, attribution) {
+  try {
+    const result = {
+      matched,
+      attribution,
+      checkedAt: Date.now()
+    };
+    await AsyncStorage.setItem(KEYS.ATTRIBUTION, JSON.stringify(result));
+  } catch {
+    // Silently fail - caching is not critical
+  }
+}
+
+/**
+ * Clear all stored attribution data (for testing/reset)
+ */
+export async function clearAttribution() {
+  try {
+    await AsyncStorage.multiRemove([KEYS.ATTRIBUTION, KEYS.INSTALL_ID]);
+  } catch {
+    // Silently fail
+  }
+}
+
+/**
+ * Queue a conversion event for later sending (offline support)
+ */
+export async function queueConversion(event) {
+  try {
+    const queue = await getConversionQueue();
+    queue.push(event);
+    await AsyncStorage.setItem(KEYS.CONVERSION_QUEUE, JSON.stringify(queue));
+  } catch {
+    // Silently fail - we tried our best
+  }
+}
+
+/**
+ * Get all queued conversion events
+ */
+export async function getConversionQueue() {
+  try {
+    const data = await AsyncStorage.getItem(KEYS.CONVERSION_QUEUE);
+    if (data) {
+      return JSON.parse(data);
+    }
+    return [];
+  } catch {
+    return [];
+  }
+}
+
+/**
+ * Clear the conversion queue after successful send
+ */
+export async function clearConversionQueue() {
+  try {
+    await AsyncStorage.removeItem(KEYS.CONVERSION_QUEUE);
+  } catch {
+    // Silently fail
+  }
+}
+
+/**
+ * Generate a UUID v4
+ * Uses crypto.getRandomValues when available (Hermes 0.73+), falls back to Math.random
+ */
+export function generateUUID() {
+  // Check if crypto.getRandomValues is available (Hermes 0.73+, modern RN)
+  const cryptoObj = typeof globalThis !== 'undefined' && globalThis.crypto;
+  if (cryptoObj && typeof cryptoObj.getRandomValues === 'function') {
+    try {
+      const bytes = new Uint8Array(16);
+      cryptoObj.getRandomValues(bytes);
+      bytes[6] = bytes[6] & 0x0f | 0x40; // version 4
+      bytes[8] = bytes[8] & 0x3f | 0x80; // variant 1
+      const hex = Array.from(bytes, b => b.toString(16).padStart(2, '0')).join('');
+      return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+    } catch {
+      // Fall through to Math.random fallback
+    }
+  }
+  // Fallback for environments without crypto.getRandomValues
+  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, c => {
+    const r = Math.random() * 16 | 0;
+    const v = c === 'x' ? r : r & 0x3 | 0x8;
+    return v.toString(16);
+  });
+}
+
+// ============================================
+// Flow Caching
+// ============================================
+
+/**
+ * Get cached flow content by slug
+ */
+export async function getCachedFlow(slug) {
+  try {
+    const key = `${FLOW_CACHE_PREFIX}${slug}`;
+    const data = await AsyncStorage.getItem(key);
+    if (data) {
+      return JSON.parse(data);
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Cache flow content
+ */
+export async function setCachedFlow(slug, flow) {
+  try {
+    const key = `${FLOW_CACHE_PREFIX}${slug}`;
+    const cached = {
+      ...flow,
+      cachedAt: Date.now()
+    };
+    await AsyncStorage.setItem(key, JSON.stringify(cached));
+  } catch {
+    // Silently fail - caching is not critical
+  }
+}
+
+/**
+ * Clear cached flow by slug
+ */
+export async function clearCachedFlow(slug) {
+  try {
+    const key = `${FLOW_CACHE_PREFIX}${slug}`;
+    await AsyncStorage.removeItem(key);
+  } catch {
+    // Silently fail
+  }
+}
+
+/**
+ * Clear all cached flows
+ */
+export async function clearAllCachedFlows() {
+  try {
+    const allKeys = await AsyncStorage.getAllKeys();
+    const flowKeys = allKeys.filter(key => key.startsWith(FLOW_CACHE_PREFIX));
+    if (flowKeys.length > 0) {
+      await AsyncStorage.multiRemove(flowKeys);
+    }
+  } catch {
+    // Silently fail
+  }
+}
+
+// ============================================
+// Local Data (for flow bridge)
+// ============================================
+
+/**
+ * Get all local data
+ */
+export async function getAllLocalData() {
+  try {
+    const data = await AsyncStorage.getItem(KEYS.LOCAL_DATA);
+    if (data) {
+      return JSON.parse(data);
+    }
+    return {};
+  } catch {
+    return {};
+  }
+}
+
+/**
+ * Store data locally on device (persists across app sessions)
+ */
+export async function setLocalData(key, value) {
+  try {
+    const data = await getAllLocalData();
+    data[key] = value;
+    await AsyncStorage.setItem(KEYS.LOCAL_DATA, JSON.stringify(data));
+  } catch {
+    // Silently fail
+  }
+}
+
+/**
+ * Retrieve locally stored data
+ */
+export async function getLocalData(key) {
+  try {
+    const data = await getAllLocalData();
+    return data[key];
+  } catch {
+    return undefined;
+  }
+}
+
+/**
+ * Clear all local data
+ */
+export async function clearLocalData() {
+  try {
+    await AsyncStorage.removeItem(KEYS.LOCAL_DATA);
+  } catch {
+    // Silently fail
+  }
+}
+//# sourceMappingURL=storage.js.map

package/lib/module/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["AsyncStorage","KEYS","INSTALL_ID","ATTRIBUTION","CONVERSION_QUEUE","LOCAL_DATA","FLOW_CACHE_PREFIX","getInstallId","installId","getItem","generateUUID","setItem","getCachedResult","data","JSON","parse","setCachedResult","matched","attribution","result","checkedAt","Date","now","stringify","clearAttribution","multiRemove","queueConversion","event","queue","getConversionQueue","push","clearConversionQueue","removeItem","cryptoObj","globalThis","crypto","getRandomValues","bytes","Uint8Array","hex","Array","from","b","toString","padStart","join","slice","replace","c","r","Math","random","v","getCachedFlow","slug","key","setCachedFlow","flow","cached","cachedAt","clearCachedFlow","clearAllCachedFlows","allKeys","getAllKeys","flowKeys","filter","startsWith","length","getAllLocalData","setLocalData","value","getLocalData","undefined","clearLocalData"],"sourceRoot":"../../src","sources":["storage.ts"],"mappings":"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","ignoreList":[]}

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/Mobana.d.ts

@@ -0,0 +1,209 @@
+import type { MobanaConfig, GetAttributionOptions, Attribution, FlowResult, FlowOptions } from './types';
+/**
+ * Mobana SDK for React Native
+ *
+ * Simple, privacy-focused mobile app attribution, conversions, and remote flows.
+ *
+ * @example
+ * ```typescript
+ * import { Mobana, MobanaProvider } from '@mobana/react-native-sdk';
+ *
+ * // Wrap your app with the provider (in App.tsx)
+ * function App() {
+ *   return (
+ *     <MobanaProvider>
+ *       <YourApp />
+ *     </MobanaProvider>
+ *   );
+ * }
+ *
+ * // Initialize once on app start
+ * await Mobana.init({ appId: 'a1b2c3d4' });
+ *
+ * // Get attribution (handles caching, retries, Android Install Referrer)
+ * const attribution = await Mobana.getAttribution();
+ *
+ * // Track conversions
+ * Mobana.trackConversion('signup');
+ * Mobana.trackConversion('purchase', 49.99);
+ *
+ * // Show a flow
+ * const result = await Mobana.startFlow('onboarding');
+ * if (result.completed) {
+ *   console.log('User completed onboarding!', result.data);
+ * }
+ * ```
+ */
+declare class MobanaSDK {
+    private config;
+    private isConfigured;
+    private attributionPromise;
+    private cachedAttribution;
+    private attributionChecked;
+    /**
+     * Initialize the SDK with your app settings
+     * Must be called before any other SDK methods
+     *
+     * @param config - Configuration options (appId is required)
+     *
+     * @example
+     * ```typescript
+     * // Basic initialization
+     * await Mobana.init({ appId: 'a1b2c3d4' });
+     *
+     * // With custom endpoint (for domain proxying)
+     * await Mobana.init({
+     *   appId: 'a1b2c3d4',
+     *   endpoint: 'https://myapp.com/d',
+     * });
+     *
+     * // With all options
+     * await Mobana.init({
+     *   appId: 'a1b2c3d4',
+     *   endpoint: 'https://myapp.com/d',   // Optional
+     *   enabled: userHasConsented,         // Optional, default: true
+     *   debug: __DEV__,                    // Optional, default: false
+     * });
+     * ```
+     */
+    init(config: MobanaConfig): Promise<void>;
+    /**
+     * Enable or disable the SDK dynamically
+     * Useful for GDPR consent flows
+     *
+     * @param enabled - Whether the SDK should be enabled
+     */
+    setEnabled(enabled: boolean): void;
+    /**
+     * Get attribution data for this install
+     *
+     * Returns cached result if available, otherwise fetches from server.
+     * Never throws - returns null on error or no match.
+     *
+     * @param options - Optional settings for the attribution request
+     * @returns Attribution data or null if not available
+     *
+     * @example
+     * ```typescript
+     * const attribution = await Mobana.getAttribution();
+     *
+     * if (attribution) {
+     *   YourAnalyticsProvider.track('App Installed', {
+     *     source: attribution.utm_source,
+     *     campaign: attribution.utm_campaign,
+     *   });
+     *
+     *   if (attribution.data?.promo) {
+     *     applyPromoCode(attribution.data.promo);
+     *   }
+     * }
+     * ```
+     *
+     * @example
+     * // With TypeScript generics for typed data
+     * interface MyDeeplinkData {
+     *   promo?: string;
+     *   referrer?: string;
+     * }
+     *
+     * const attribution = await Mobana.getAttribution<MyDeeplinkData>();
+     * // attribution.data is now typed as MyDeeplinkData
+     */
+    getAttribution<T = Record<string, unknown>>(options?: GetAttributionOptions): Promise<Attribution<T> | null>;
+    /**
+     * Track a conversion event
+     *
+     * Conversions are linked to the original attribution via installId.
+     * If offline, conversions are queued and sent when back online.
+     * Never throws - silently handles errors.
+     *
+     * @param name - Conversion name (must be configured in app settings)
+     * @param value - Optional monetary value
+     * @param flowSessionId - Optional flow session ID to link conversion to a specific flow presentation
+     *
+     * @example
+     * ```typescript
+     * // Simple conversion
+     * Mobana.trackConversion('signup');
+     *
+     * // Conversion with value
+     * Mobana.trackConversion('purchase', 49.99);
+     *
+     * // Conversion linked to a flow session
+     * const result = await Mobana.startFlow('pre-purchase');
+     * // ... user makes purchase via paywall ...
+     * await Mobana.trackConversion('purchase', 49.99, result.sessionId);
+     * ```
+     */
+    trackConversion(name: string, value?: number, flowSessionId?: string): Promise<void>;
+    /**
+     * Reset all stored attribution data
+     * Useful for testing or when user logs out
+     *
+     * Note: This generates a new installId, so subsequent attributions
+     * will be treated as a new install.
+     */
+    reset(): Promise<void>;
+    /**
+     * Start and display a flow
+     *
+     * Fetches the flow content (or uses cache) and presents it in a full-screen modal.
+     * The promise resolves when the user completes or dismisses the flow.
+     *
+     * Requires MobanaProvider to be mounted in your app.
+     *
+     * @param slug - Flow identifier (from dashboard)
+     * @param options - Optional flow configuration
+     * @returns Flow result with completion status and optional data
+     *
+     * @example
+     * ```typescript
+     * // Basic usage
+     * const result = await Mobana.startFlow('onboarding');
+     *
+     * if (result.completed) {
+     *   console.log('Onboarding completed!', result.data);
+     * } else if (result.error) {
+     *   console.log('Flow error:', result.error);
+     * }
+     *
+     * // With custom parameters
+     * const result = await Mobana.startFlow('welcome', {
+     *   params: { userName: 'John', isPremium: true },
+     *   onEvent: (name) => {
+     *     analytics.track(name);
+     *   },
+     * });
+     * ```
+     */
+    startFlow(slug: string, options?: FlowOptions): Promise<FlowResult>;
+    /**
+     * Prefetch a flow for faster display later
+     *
+     * Downloads and caches the flow content without displaying it.
+     * Call this ahead of time if you know a flow will be shown soon.
+     *
+     * @param slug - Flow identifier (from dashboard)
+     *
+     * @example
+     * ```typescript
+     * // Prefetch during app startup
+     * Mobana.prefetchFlow('onboarding');
+     *
+     * // Later, when ready to show (will be instant if prefetched)
+     * const result = await Mobana.startFlow('onboarding');
+     * ```
+     */
+    prefetchFlow(slug: string): Promise<void>;
+    /**
+     * Present a flow to the user via the provider
+     */
+    private presentFlowToUser;
+    private getEndpoint;
+    private fetchAttribution;
+    private sendConversion;
+    private flushConversionQueue;
+}
+export { MobanaSDK };
+export declare const Mobana: MobanaSDK;
+//# sourceMappingURL=Mobana.d.ts.map

package/lib/typescript/Mobana.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Mobana.d.ts","sourceRoot":"","sources":["../../src/Mobana.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,qBAAqB,EACrB,WAAW,EAEX,UAAU,EACV,WAAW,EAEZ,MAAM,SAAS,CAAC;AAsBjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,cAAM,SAAS;IACb,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,YAAY,CAAS;IAE7B,OAAO,CAAC,kBAAkB,CAAiD;IAG3E,OAAO,CAAC,iBAAiB,CAAiC;IAC1D,OAAO,CAAC,kBAAkB,CAAS;IAEnC;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACG,IAAI,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAkC/C;;;;;OAKG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAiBlC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACG,cAAc,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9C,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IA8CjC;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2C1F;;;;;;OAMG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAiIzE;;;;;;;;;;;;;;;;OAgBG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmD/C;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA8BzB,OAAO,CAAC,WAAW;YAaL,gBAAgB;YAuFhB,cAAc;YASd,oBAAoB;CA2BnC;AAGD,OAAO,EAAE,SAAS,EAAE,CAAC;AAGrB,eAAO,MAAM,MAAM,WAAkB,CAAC"}

package/lib/typescript/NativeMobana.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Get Android Install Referrer
+ * Extracts the dacid (Mobana Click ID) from the referrer string
+ */
+export declare function getInstallReferrer(): Promise<string | null>;
+/**
+ * Check if native module is available
+ * Used to determine if we can use Install Referrer
+ */
+export declare function isNativeModuleAvailable(): boolean;
+//# sourceMappingURL=NativeMobana.d.ts.map

package/lib/typescript/NativeMobana.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeMobana.d.ts","sourceRoot":"","sources":["../../src/NativeMobana.ts"],"names":[],"mappings":"AA4BA;;;GAGG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAoBjE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,OAAO,CAEjD"}

package/lib/typescript/api.d.ts

@@ -0,0 +1,34 @@
+import type { FindResponse, DeviceInfo, ConversionEvent, FlowFetchResponse } from './types';
+/**
+ * Call /find endpoint to get attribution
+ */
+export declare function findAttribution<T = Record<string, unknown>>(endpoint: string, appKey: string, installId: string, deviceInfo: DeviceInfo, dacid: string | null, timeout: number, debug: boolean): Promise<FindResponse<T> | null>;
+/**
+ * Call /conversion endpoint to track a conversion
+ */
+export declare function trackConversionApi(endpoint: string, appKey: string, event: ConversionEvent, debug: boolean): Promise<boolean>;
+/**
+ * Fetch flow content from the server
+ *
+ * @param endpoint - API endpoint
+ * @param slug - Flow slug identifier
+ * @param installId - Install ID for tracking
+ * @param cachedVersionId - If provided, server will return { cached: true } if version matches
+ * @param debug - Enable debug logging
+ */
+export declare function fetchFlow(endpoint: string, appKey: string, slug: string, installId: string, cachedVersionId?: string, timeout?: number, debug?: boolean): Promise<FlowFetchResponse | null>;
+/**
+ * Track a flow event
+ *
+ * @param endpoint - API endpoint
+ * @param slug - Flow slug identifier
+ * @param installId - Install ID for tracking
+ * @param versionId - Flow version that was shown
+ * @param sessionId - Session ID for grouping events from a single flow presentation
+ * @param event - Event name ('step-1', 'notifications-enabled', 'welcome-viewed', or other event)
+ * @param step - Optional step number for multi-step flows
+ * @param data - Optional custom event data
+ * @param debug - Enable debug logging
+ */
+export declare function trackFlowEvent(endpoint: string, appKey: string, slug: string, installId: string, versionId: string, sessionId: string, event: string, step?: number, data?: unknown, debug?: boolean): Promise<boolean>;
+//# sourceMappingURL=api.d.ts.map

package/lib/typescript/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAwE5F;;GAEG;AACH,wBAAsB,eAAe,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/D,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAiBjC;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,eAAe,EACtB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,OAAO,CAAC,CAiBlB;AAMD;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,eAAe,CAAC,EAAE,MAAM,EACxB,OAAO,GAAE,MAAwB,EACjC,KAAK,GAAE,OAAe,GACrB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAkDnC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,OAAO,EACd,KAAK,GAAE,OAAe,GACrB,OAAO,CAAC,OAAO,CAAC,CAgClB"}

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

@@ -0,0 +1,3 @@
+export { generateBridgeScript, buildFlowHtml } from './injectBridge';
+export type { BridgeContext } from './injectBridge';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/bridge/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACrE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/lib/typescript/bridge/injectBridge.d.ts

@@ -0,0 +1,23 @@
+import type { Attribution, SafeArea, ColorScheme } from '../types';
+/**
+ * Bridge context passed from native to WebView
+ */
+export interface BridgeContext {
+    attribution: Attribution | null;
+    params: Record<string, unknown>;
+    installId: string;
+    platform: 'ios' | 'android';
+    colorScheme: ColorScheme;
+    localData: Record<string, unknown>;
+    safeArea: SafeArea;
+}
+/**
+ * Generate JavaScript code to inject into WebView
+ * Creates the window.Mobana bridge object
+ */
+export declare function generateBridgeScript(context: BridgeContext): string;
+/**
+ * Build complete HTML with injected bridge, styles, and safe area CSS variables
+ */
+export declare function buildFlowHtml(html: string, css: string | undefined, js: string | undefined, bridgeScript: string, safeArea?: SafeArea, colorScheme?: ColorScheme): string;
+//# sourceMappingURL=injectBridge.d.ts.map

package/lib/typescript/bridge/injectBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"injectBridge.d.ts","sourceRoot":"","sources":["../../../src/bridge/injectBridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,KAAK,GAAG,SAAS,CAAC;IAC5B,WAAW,EAAE,WAAW,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CA6YnE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,YAAY,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,QAAQ,EACnB,WAAW,CAAC,EAAE,WAAW,GACxB,MAAM,CAiHR"}

package/lib/typescript/components/FlowWebView.d.ts

@@ -0,0 +1,38 @@
+import React from 'react';
+import type { FlowConfig, Attribution } from '../types';
+export interface FlowWebViewProps {
+    /** Flow configuration (HTML, CSS, JS) */
+    config: FlowConfig;
+    /** Flow slug identifier */
+    slug: string;
+    /** Install ID for tracking */
+    installId: string;
+    /** API endpoint */
+    endpoint: string;
+    /** App key for X-App-Key header */
+    appKey: string;
+    /** Attribution data to pass to flow */
+    attribution: Attribution | null;
+    /** Custom parameters to pass to flow */
+    params?: Record<string, unknown>;
+    /** Session ID for grouping all events from this flow presentation */
+    sessionId: string;
+    /** Called when flow is completed */
+    onComplete: (data?: Record<string, unknown>) => void;
+    /** Called when flow is dismissed */
+    onDismiss: () => void;
+    /** Called when flow emits a custom event */
+    onEvent?: (name: string) => void;
+    /** Async callback for flow-initiated app actions (e.g., purchases) */
+    onCallback?: (data: Record<string, unknown>) => Promise<Record<string, unknown>>;
+    /** Custom props forwarded to the underlying WebView */
+    webViewProps?: Record<string, unknown>;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+/**
+ * Internal WebView component for rendering flows
+ * Handles bridge communication between flow JS and native capabilities
+ */
+export declare function FlowWebView({ config, slug, installId, endpoint, appKey, attribution, params, sessionId, onComplete, onDismiss, onEvent, onCallback, webViewProps, debug, }: FlowWebViewProps): React.JSX.Element;
+//# sourceMappingURL=FlowWebView.d.ts.map

package/lib/typescript/components/FlowWebView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlowWebView.d.ts","sourceRoot":"","sources":["../../../src/components/FlowWebView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmD,MAAM,OAAO,CAAC;AAYxE,OAAO,KAAK,EACV,UAAU,EAEV,WAAW,EAIZ,MAAM,UAAU,CAAC;AAmLlB,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,MAAM,EAAE,UAAU,CAAC;IACnB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,UAAU,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACrD,oCAAoC;IACpC,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,sEAAsE;IACtE,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACjF,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAC1B,MAAM,EACN,IAAI,EACJ,SAAS,EACT,QAAQ,EACR,MAAM,EACN,WAAW,EACX,MAAW,EACX,SAAS,EACT,UAAU,EACV,SAAS,EACT,OAAO,EACP,UAAU,EACV,YAAY,EACZ,KAAa,GACd,EAAE,gBAAgB,qBAmjBlB"}