@robylon/react-native-sdk 2.0.30 → 2.0.31-staging.1

package/src/utils/fileDownload.ts

@@ -0,0 +1,192 @@
+/**
+ * File: src/utils/fileDownload.ts
+ * Utility functions for handling file downloads
+ */
+
+import { Linking, Platform, Share } from "react-native";
+import { logger } from "./logger";
+
+export interface DownloadRequest {
+  url: string;
+  filename?: string;
+  inPlace?: boolean;
+}
+
+const normalizeUrl = (url: string): string => {
+  return url?.trim();
+};
+
+const sanitizeFileName = (filename?: string): string => {
+  const fallbackName = `chat-transcript-${Date.now()}.pdf`;
+  const trimmedName = filename?.trim();
+  if (!trimmedName) return fallbackName;
+  return trimmedName.replace(/[<>:"/\\|?*\x00-\x1F]/g, "_");
+};
+
+const getBlobUtilModule = (): any => {
+  try {
+    // Lazy load so consumers without native linking don't crash at startup.
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    return require("react-native-blob-util")?.default;
+  } catch (error) {
+    logger.warn("react-native-blob-util is unavailable", {
+      error: error instanceof Error ? error?.message : String(error),
+    });
+    return null;
+  }
+};
+
+const isValidHttpUrl = (url: string): boolean => {
+  return /^https?:\/\//i.test(url);
+};
+
+const openUrlWithFallback = async (url: string): Promise<void> => {
+  try {
+    await Linking.openURL(url);
+    return;
+  } catch (primaryError) {
+    logger.warn("Primary URL open failed, trying browser fallback", {
+      url,
+      primaryError:
+        primaryError instanceof Error
+          ? primaryError?.message
+          : String(primaryError),
+    });
+  }
+
+  await Linking.openURL(`https://docs.google.com/viewer?url=${encodeURIComponent(url)}`);
+};
+
+const downloadOnAndroid = async (url: string, filename: string): Promise<void> => {
+  const blobUtil = getBlobUtilModule();
+  if (!blobUtil) {
+    throw new Error("react-native-blob-util module not available on Android");
+  }
+  const { fs, config } = blobUtil;
+  const downloadPath = `${fs.dirs.DownloadDir}/${filename}`;
+  await config({
+    fileCache: true,
+    path: downloadPath,
+    addAndroidDownloads: {
+      useDownloadManager: true,
+      notification: true,
+      title: filename,
+      description: "Downloading transcript",
+      mime: "application/pdf",
+      mediaScannable: true,
+      path: downloadPath,
+    },
+  }).fetch("GET", url);
+};
+
+const downloadOniOS = async (url: string, filename: string): Promise<void> => {
+  const blobUtil = getBlobUtilModule();
+  if (!blobUtil) {
+    throw new Error("react-native-blob-util module not available on iOS");
+  }
+  const { fs, config } = blobUtil;
+  const iosPath = `${fs.dirs.DocumentDir}/${filename}`;
+  await config({
+    fileCache: true,
+    path: iosPath,
+  }).fetch("GET", url);
+  await Share.share({
+    url: `file://${iosPath}`,
+    message: filename,
+    title: filename,
+  });
+};
+
+const downloadWithNativeStorage = async (
+  url: string,
+  filename?: string
+): Promise<void> => {
+  const safeName = sanitizeFileName(filename);
+  if (Platform.OS === "android") {
+    await downloadOnAndroid(url, safeName);
+    return;
+  }
+  await downloadOniOS(url, safeName);
+};
+
+const shouldUseInPlaceDownload = (downloadRequest?: DownloadRequest): boolean => {
+  return downloadRequest?.inPlace === true;
+};
+
+/**
+ * Downloads a file using native storage when possible
+ * @param url - The URL of the file to download
+ * @param filename - Optional filename for the download
+ */
+export const downloadFile = async (
+  url: string,
+  filename?: string,
+  inPlace?: boolean
+): Promise<void> => {
+  try {
+    const normalizedUrl = normalizeUrl(url);
+    logger.debug("Initiating file download", { url: normalizedUrl, filename });
+
+    // Validate URL
+    if (!normalizedUrl || typeof normalizedUrl !== "string") {
+      throw new Error("Invalid URL provided for download");
+    }
+
+    if (!isValidHttpUrl(normalizedUrl)) {
+      throw new Error("Download URL must be an http/https URL");
+    }
+
+    if (inPlace) {
+      try {
+        await downloadWithNativeStorage(normalizedUrl, filename);
+        logger.debug("File downloaded with native storage flow");
+      } catch (nativeDownloadError) {
+        logger.warn("Native download failed, falling back to URL open", {
+          url: normalizedUrl,
+          nativeDownloadError:
+            nativeDownloadError instanceof Error
+              ? nativeDownloadError?.message
+              : String(nativeDownloadError),
+        });
+        await openUrlWithFallback(normalizedUrl);
+        logger.debug("File download opened with fallback browser flow");
+      }
+      return;
+    }
+
+    await openUrlWithFallback(normalizedUrl);
+    logger.debug("File download opened with legacy URL flow");
+  } catch (error) {
+    logger.error("File download failed", {
+      url,
+      filename,
+      error: error instanceof Error ? error?.message : String(error),
+    });
+    throw error;
+  }
+};
+
+/**
+ * Handles download request from WebView post message
+ * @param downloadRequest - The download request object
+ */
+export const handleDownloadRequest = async (
+  downloadRequest: DownloadRequest
+): Promise<void> => {
+  const { url, filename } = downloadRequest;
+
+  if (!url) {
+    logger.error("Download request missing URL");
+    return;
+  }
+
+  try {
+    await downloadFile(url, filename, shouldUseInPlaceDownload(downloadRequest));
+  } catch (error) {
+    logger.error("Failed to handle download request", {
+      downloadRequest,
+      error,
+    });
+    // Don't re-throw to avoid breaking the WebView message handling
+  }
+};

package/src/utils/logger.ts

@@ -0,0 +1,14 @@
+export const logger = {
+  error: (message: string, error?: any) => {
+    console.error(message, error);
+  },
+  info: (message: string, data?: any) => {
+    console.info(message, data);
+  },
+  warn: (message: string, data?: any) => {
+    console.warn(message, data);
+  },
+  debug: (message: string, data?: any) => {
+    console.log(message, data);
+  },
+};

package/src/utils/systemInfo.ts

@@ -0,0 +1,110 @@
+import { Platform, Dimensions, PixelRatio } from "react-native";
+import { SDK_VERSION } from "../version";
+
+interface ScreenSize {
+  width: number;
+  height: number;
+}
+
+interface SystemInfo {
+  platform: string;
+  os: string;
+  browser: string;
+  browser_version: string | null;
+  browser_language: string | null;
+  sdk_version: string;
+  device: string;
+  screen_size: ScreenSize;
+}
+
+// Get device type based on platform and screen dimensions
+const getDeviceType = (): string => {
+  const { width, height } = Dimensions.get("window");
+  const aspectRatio = height / width;
+
+  if (Platform.OS === "ios") {
+    return Platform.isPad ? "iPad" : "iPhone";
+  } else if (Platform.OS === "android") {
+    return aspectRatio < 1.6 ? "Android Tablet" : "Android Phone";
+  }
+  return "Desktop";
+};
+
+// Get screen dimensions with pixel ratio
+const getScreenSize = (): ScreenSize => {
+  return {
+    width: Math.round(Dimensions.get("window").width * PixelRatio.get()),
+    height: Math.round(Dimensions.get("window").height * PixelRatio.get()),
+  };
+};
+
+// Get browser detection script
+export const getBrowserAndOSInfoScript = (): string => {
+  return `
+    function getOSAndBrowser() {
+      const userAgent = navigator.userAgent;
+      
+      // OS Detection
+      let os = "unknown";
+      if (userAgent.indexOf("Win") !== -1) os = "Windows";
+      else if (userAgent.indexOf("Mac") !== -1) os = "MacOS";
+      else if (userAgent.indexOf("Linux") !== -1) os = "Linux";
+      else if (userAgent.indexOf("Android") !== -1) os = "Android";
+      else if (userAgent.indexOf("like Mac") !== -1) os = "iOS";
+
+      // Browser Detection
+      let browser = "unknown";
+      let browserVersion = null;
+      if (userAgent.indexOf("Chrome") !== -1) {
+        browser = "Chrome";
+        const chromeMatch = userAgent.match(/Chrome\\/([0-9.]+)/);
+        browserVersion = chromeMatch ? chromeMatch[1] : null;
+      } else if (userAgent.indexOf("Safari") !== -1) {
+        browser = "Safari";
+        const safariMatch = userAgent.match(/Version\\/([0-9.]+)/);
+        browserVersion = safariMatch ? safariMatch[1] : null;
+      } else if (userAgent.indexOf("Firefox") !== -1) {
+        browser = "Firefox";
+        const firefoxMatch = userAgent.match(/Firefox\\/([0-9.]+)/);
+        browserVersion = firefoxMatch ? firefoxMatch[1] : null;
+      } else if (userAgent.indexOf("Edge") !== -1) {
+        browser = "Edge";
+        const edgeMatch = userAgent.match(/Edge\\/([0-9.]+)/);
+        browserVersion = edgeMatch ? edgeMatch[1] : null;
+      } else if (userAgent.indexOf("MSIE") !== -1 || userAgent.indexOf("Trident/") !== -1) {
+        browser = "IE";
+        const ieMatch = userAgent.match(/(?:MSIE |rv:)([0-9.]+)/);
+        browserVersion = ieMatch ? ieMatch[1] : null;
+      }
+
+      // Browser Language
+      const browserLanguage = navigator.language || navigator.languages?.[0] || null;
+
+      window.ReactNativeWebView.postMessage(JSON.stringify({
+        type: 'SYSTEM_INFO',
+        data: { os, browser, browser_version: browserVersion, browser_language: browserLanguage }
+      }));
+    }
+    getOSAndBrowser();
+    true;
+  `;
+};
+
+// Get complete system information
+export const getSystemInfo = (webViewSystemInfo: {
+  os: string;
+  browser: string;
+  browser_version?: string | null;
+  browser_language?: string | null;
+}): SystemInfo => {
+  return {
+    platform: Platform.OS,
+    os: webViewSystemInfo.os || Platform.OS,
+    browser: webViewSystemInfo.browser || "WebView",
+    browser_version: webViewSystemInfo.browser_version || null,
+    browser_language: webViewSystemInfo.browser_language || null,
+    sdk_version: SDK_VERSION,
+    device: getDeviceType(),
+    screen_size: getScreenSize(),
+  };
+};

package/src/utils/webViewStorage.ts

@@ -0,0 +1,62 @@
+import { logger } from "./logger";
+
+export enum StorageMessageType {
+  GET_STORAGE = "GET_STORAGE",
+  SET_STORAGE = "SET_STORAGE",
+  STORAGE_READY = "STORAGE_READY",
+  STORAGE_ERROR = "STORAGE_ERROR",
+  STORAGE_RESPONSE = "STORAGE_RESPONSE",
+}
+
+export interface StorageMessage {
+  type: StorageMessageType;
+  key?: string;
+  value?: string;
+  error?: string;
+}
+
+export const getStorageScript = () => `
+  window.handleStorageOperation = function(message) {
+    try {
+      switch(message.type) {
+        case '${StorageMessageType.GET_STORAGE}':
+          const value = localStorage.getItem(message.key);
+          window.ReactNativeWebView.postMessage(JSON.stringify({
+            type: '${StorageMessageType.STORAGE_RESPONSE}',
+            key: message.key,
+            value: value
+          }));
+          break;
+        case '${StorageMessageType.SET_STORAGE}':
+          localStorage.setItem(message.key, message.value);
+          window.ReactNativeWebView.postMessage(JSON.stringify({
+            type: '${StorageMessageType.STORAGE_RESPONSE}',
+            key: message.key,
+            value: message.value
+          }));
+          break;
+      }
+    } catch (error) {
+      window.ReactNativeWebView.postMessage(JSON.stringify({
+        type: '${StorageMessageType.STORAGE_ERROR}',
+        error: error.message
+      }));
+    }
+  };
+
+  window.ReactNativeWebView.postMessage(JSON.stringify({
+    type: '${StorageMessageType.STORAGE_READY}'
+  }));
+`;
+
+export const createStorageMessage = (
+  type: StorageMessageType,
+  key?: string,
+  value?: string
+): string => {
+  return `window.handleStorageOperation(${JSON.stringify({
+    type,
+    key,
+    value,
+  })});`;
+};

package/src/version.ts

@@ -0,0 +1,2 @@
+// This file is auto-generated. Do not modify it manually.
+export { SDK_VERSION } from './versions/version.staging';

package/src/versions/version.dev.ts

@@ -0,0 +1,2 @@
+// This file is auto-generated. Do not modify it manually.
+export const SDK_VERSION = '2.0.22-dev.0';

package/src/versions/version.production.ts

@@ -0,0 +1,2 @@
+// This file is auto-generated. Do not modify it manually.
+export const SDK_VERSION = "0.0.0";

package/src/versions/version.staging.ts

@@ -0,0 +1,2 @@
+// This file is auto-generated. Do not modify it manually.
+export const SDK_VERSION = '2.0.31-staging.1';