@teamvortexsoftware/vortex-react-native 0.0.13 → 1.0.1

package/dist/utils/analytics.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_ANALYTICS_URL = void 0;
+exports.getDeviceInfo = getDeviceInfo;
+exports.extractForeignUserId = extractForeignUserId;
+const react_native_1 = require("react-native");
+// SDK version - should match package.json version
+const SDK_VERSION = '0.0.15';
+// Default production analytics URL
+exports.DEFAULT_ANALYTICS_URL = 'https://collector.vortexsoftware.com';
+/**
+ * Generates a device info / user agent string for analytics
+ * Format: VortexSDK-RN/{version} ({OS} {osVersion})
+ */
+function getDeviceInfo() {
+    const osName = react_native_1.Platform.OS === 'ios' ? 'iOS' : 'Android';
+    const osVersion = react_native_1.Platform.Version;
+    return `VortexSDK-RN/${SDK_VERSION} (${osName} ${osVersion})`;
+}
+/**
+ * Extracts the foreign user ID from a JWT token
+ * Checks claims in order: userId, sub, user_id
+ * Handles both standard JWTs and raw-data format (insecure development JWTs)
+ */
+function extractForeignUserId(jwt) {
+    if (!jwt)
+        return undefined;
+    // Handle raw-data format (insecure JWT for development)
+    if (jwt.startsWith('raw-data:')) {
+        try {
+            const base64Part = jwt.replace('raw-data:', '');
+            // Use a cross-platform base64 decode
+            const decoded = decodeBase64(base64Part);
+            const json = JSON.parse(decoded);
+            return json.userId || json.user_id;
+        }
+        catch (_a) {
+            return undefined;
+        }
+    }
+    // Standard JWT: header.payload.signature
+    const parts = jwt.split('.');
+    if (parts.length < 2)
+        return undefined;
+    try {
+        // Base64 URL decode
+        const base64 = parts[1].replace(/-/g, '+').replace(/_/g, '/');
+        const decoded = decodeBase64(base64);
+        const payload = JSON.parse(decoded);
+        // Try common user ID claims in order:
+        return payload.userId || payload.sub || payload.user_id;
+    }
+    catch (_b) {
+        return undefined;
+    }
+}
+/**
+ * Cross-platform base64 decode function
+ * Works in both React Native and web environments
+ */
+function decodeBase64(base64) {
+    // Add padding if needed
+    const padded = base64 + '==='.slice(0, (4 - (base64.length % 4)) % 4);
+    // Try using Buffer (Node.js / React Native with polyfill)
+    if (typeof Buffer !== 'undefined') {
+        return Buffer.from(padded, 'base64').toString('utf-8');
+    }
+    // Fallback to atob (web)
+    if (typeof atob !== 'undefined') {
+        return atob(padded);
+    }
+    // Manual decode as last resort
+    const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/=';
+    let output = '';
+    let i = 0;
+    while (i < padded.length) {
+        const enc1 = chars.indexOf(padded.charAt(i++));
+        const enc2 = chars.indexOf(padded.charAt(i++));
+        const enc3 = chars.indexOf(padded.charAt(i++));
+        const enc4 = chars.indexOf(padded.charAt(i++));
+        const chr1 = (enc1 << 2) | (enc2 >> 4);
+        const chr2 = ((enc2 & 15) << 4) | (enc3 >> 2);
+        const chr3 = ((enc3 & 3) << 6) | enc4;
+        output += String.fromCharCode(chr1);
+        if (enc3 !== 64)
+            output += String.fromCharCode(chr2);
+        if (enc4 !== 64)
+            output += String.fromCharCode(chr3);
+    }
+    return output;
+}
+//# sourceMappingURL=analytics.js.map

package/dist/utils/analytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.js","sourceRoot":"","sources":["../../src/utils/analytics.ts"],"names":[],"mappings":"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","sourcesContent":["import { Platform } from 'react-native';\nimport type { EventName } from '@teamvortexsoftware/analytics-client';\n\n// SDK version - should match package.json version\nconst SDK_VERSION = '0.0.15';\n\n// Default production analytics URL\nexport const DEFAULT_ANALYTICS_URL = 'https://collector.vortexsoftware.com';\n\n/**\n * Analytics event interface for React Native SDK\n * Based on AnalyticsEvent from analytics-client with additional mobile-specific fields\n */\nexport interface VortexAnalyticsEvent {\n  // Core fields from AnalyticsEvent\n  name: EventName;\n  widgetConfigurationId: string;\n  deploymentId: string;\n  environmentId: string;\n  platform: string;\n  segmentation?: Record<string, any>;\n  payload?: Record<string, any>;\n  groups?: Array<{\n    type: string;\n    id: string;\n    name: string;\n  }>;\n  // Additional mobile-specific fields\n  timestamp: number; // Unix timestamp in seconds\n  sessionId?: string; // Generated UUID per session\n  useragent?: string; // Device info string\n  foreignUserId?: string; // Extracted from JWT\n}\n\n/**\n * Simplified analytics event for components that emit minimal events.\n * These components emit (name + segmentation) and the parent\n * is responsible for enriching with widgetConfigurationId, deploymentId, etc.\n */\nexport interface SimpleAnalyticsEvent {\n  name: EventName;\n  segmentation?: Record<string, any>;\n  payload?: Record<string, any>;\n}\n\n/**\n * Group DTO for analytics events\n */\nexport interface GroupDTO {\n  type: string;\n  id: string;\n  name: string;\n}\n\n/**\n * Generates a device info / user agent string for analytics\n * Format: VortexSDK-RN/{version} ({OS} {osVersion})\n */\nexport function getDeviceInfo(): string {\n  const osName = Platform.OS === 'ios' ? 'iOS' : 'Android';\n  const osVersion = Platform.Version;\n\n  return `VortexSDK-RN/${SDK_VERSION} (${osName} ${osVersion})`;\n}\n\n/**\n * Extracts the foreign user ID from a JWT token\n * Checks claims in order: userId, sub, user_id\n * Handles both standard JWTs and raw-data format (insecure development JWTs)\n */\nexport function extractForeignUserId(jwt?: string): string | undefined {\n  if (!jwt) return undefined;\n\n  // Handle raw-data format (insecure JWT for development)\n  if (jwt.startsWith('raw-data:')) {\n    try {\n      const base64Part = jwt.replace('raw-data:', '');\n      // Use a cross-platform base64 decode\n      const decoded = decodeBase64(base64Part);\n      const json = JSON.parse(decoded);\n      return json.userId || json.user_id;\n    } catch {\n      return undefined;\n    }\n  }\n\n  // Standard JWT: header.payload.signature\n  const parts = jwt.split('.');\n  if (parts.length < 2) return undefined;\n\n  try {\n    // Base64 URL decode\n    const base64 = parts[1].replace(/-/g, '+').replace(/_/g, '/');\n    const decoded = decodeBase64(base64);\n    const payload = JSON.parse(decoded);\n\n    // Try common user ID claims in order:\n    return payload.userId || payload.sub || payload.user_id;\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Cross-platform base64 decode function\n * Works in both React Native and web environments\n */\nfunction decodeBase64(base64: string): string {\n  // Add padding if needed\n  const padded = base64 + '==='.slice(0, (4 - (base64.length % 4)) % 4);\n\n  // Try using Buffer (Node.js / React Native with polyfill)\n  if (typeof Buffer !== 'undefined') {\n    return Buffer.from(padded, 'base64').toString('utf-8');\n  }\n\n  // Fallback to atob (web)\n  if (typeof atob !== 'undefined') {\n    return atob(padded);\n  }\n\n  // Manual decode as last resort\n  const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/=';\n  let output = '';\n  let i = 0;\n\n  while (i < padded.length) {\n    const enc1 = chars.indexOf(padded.charAt(i++));\n    const enc2 = chars.indexOf(padded.charAt(i++));\n    const enc3 = chars.indexOf(padded.charAt(i++));\n    const enc4 = chars.indexOf(padded.charAt(i++));\n\n    const chr1 = (enc1 << 2) | (enc2 >> 4);\n    const chr2 = ((enc2 & 15) << 4) | (enc3 >> 2);\n    const chr3 = ((enc3 & 3) << 6) | enc4;\n\n    output += String.fromCharCode(chr1);\n    if (enc3 !== 64) output += String.fromCharCode(chr2);\n    if (enc4 !== 64) output += String.fromCharCode(chr3);\n  }\n\n  return output;\n}\n\n\n"]}

package/dist/utils/configCache.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configCache = void 0;
+/**
+ * Module-level cache for widget configurations.
+ * This cache is shared across all hooks and components to ensure
+ * configuration updates persist between component mount/unmount cycles.
+ *
+ * Benefits:
+ * - Single source of truth for widget configurations
+ * - Persists between modal open/close cycles
+ * - Automatic synchronization between prefetch and main hooks
+ * - No React Context overhead
+ */
+const cache = new Map();
+exports.configCache = {
+    /**
+     * Get a cached widget configuration by component ID.
+     * @param componentId - The widget component ID
+     * @returns The cached configuration, or undefined if not found
+     */
+    get: (componentId) => {
+        return cache.get(componentId);
+    },
+    /**
+     * Store a widget configuration in the cache.
+     * @param componentId - The widget component ID
+     * @param config - The widget configuration to cache
+     */
+    set: (componentId, config) => {
+        cache.set(componentId, config);
+        console.log('[Vortex] Configuration cached', {
+            componentId,
+            configId: config.id,
+            cacheSize: cache.size,
+        });
+    },
+    /**
+     * Clear cached configuration(s).
+     * @param componentId - Optional component ID to clear specific config. If omitted, clears all.
+     */
+    clear: (componentId) => {
+        if (componentId) {
+            cache.delete(componentId);
+            console.log('[Vortex] Configuration cache cleared', { componentId });
+        }
+        else {
+            cache.clear();
+            console.log('[Vortex] All configuration cache cleared');
+        }
+    },
+    /**
+     * Check if a configuration exists in the cache.
+     * @param componentId - The widget component ID
+     * @returns True if configuration is cached, false otherwise
+     */
+    has: (componentId) => {
+        return cache.has(componentId);
+    },
+    /**
+     * Get cache statistics for debugging.
+     */
+    stats: () => ({
+        size: cache.size,
+        keys: Array.from(cache.keys()),
+    }),
+};
+//# sourceMappingURL=configCache.js.map

package/dist/utils/configCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configCache.js","sourceRoot":"","sources":["../../src/utils/configCache.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;GAUG;AACH,MAAM,KAAK,GAAG,IAAI,GAAG,EAA+B,CAAC;AAExC,QAAA,WAAW,GAAG;IACzB;;;;OAIG;IACH,GAAG,EAAE,CAAC,WAAmB,EAAmC,EAAE;QAC5D,OAAO,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAChC,CAAC;IAED;;;;OAIG;IACH,GAAG,EAAE,CAAC,WAAmB,EAAE,MAA2B,EAAQ,EAAE;QAC9D,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,+BAA+B,EAAE;YAC3C,WAAW;YACX,QAAQ,EAAE,MAAM,CAAC,EAAE;YACnB,SAAS,EAAE,KAAK,CAAC,IAAI;SACtB,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK,EAAE,CAAC,WAAoB,EAAQ,EAAE;QACpC,IAAI,WAAW,EAAE,CAAC;YAChB,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;YAC1B,OAAO,CAAC,GAAG,CAAC,sCAAsC,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;QACvE,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,KAAK,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,GAAG,EAAE,CAAC,WAAmB,EAAW,EAAE;QACpC,OAAO,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QACZ,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;KAC/B,CAAC;CACH,CAAC","sourcesContent":["import { WidgetConfiguration } from '@teamvortexsoftware/vortex-types';\n\n/**\n * Module-level cache for widget configurations.\n * This cache is shared across all hooks and components to ensure\n * configuration updates persist between component mount/unmount cycles.\n * \n * Benefits:\n * - Single source of truth for widget configurations\n * - Persists between modal open/close cycles\n * - Automatic synchronization between prefetch and main hooks\n * - No React Context overhead\n */\nconst cache = new Map<string, WidgetConfiguration>();\n\nexport const configCache = {\n  /**\n   * Get a cached widget configuration by component ID.\n   * @param componentId - The widget component ID\n   * @returns The cached configuration, or undefined if not found\n   */\n  get: (componentId: string): WidgetConfiguration | undefined => {\n    return cache.get(componentId);\n  },\n\n  /**\n   * Store a widget configuration in the cache.\n   * @param componentId - The widget component ID\n   * @param config - The widget configuration to cache\n   */\n  set: (componentId: string, config: WidgetConfiguration): void => {\n    cache.set(componentId, config);\n    console.log('[Vortex] Configuration cached', {\n      componentId,\n      configId: config.id,\n      cacheSize: cache.size,\n    });\n  },\n\n  /**\n   * Clear cached configuration(s).\n   * @param componentId - Optional component ID to clear specific config. If omitted, clears all.\n   */\n  clear: (componentId?: string): void => {\n    if (componentId) {\n      cache.delete(componentId);\n      console.log('[Vortex] Configuration cache cleared', { componentId });\n    } else {\n      cache.clear();\n      console.log('[Vortex] All configuration cache cleared');\n    }\n  },\n\n  /**\n   * Check if a configuration exists in the cache.\n   * @param componentId - The widget component ID\n   * @returns True if configuration is cached, false otherwise\n   */\n  has: (componentId: string): boolean => {\n    return cache.has(componentId);\n  },\n\n  /**\n   * Get cache statistics for debugging.\n   */\n  stats: () => ({\n    size: cache.size,\n    keys: Array.from(cache.keys()),\n  }),\n};\n"]}

package/dist/utils/contactUtils.d.mts

@@ -0,0 +1,12 @@
+import { C as Contact } from '../useInvitationFormLogic-Ct73M19B.mjs';
+import 'react';
+
+/**
+ * Filters contacts based on a search query
+ * @param contacts Array of contacts to filter
+ * @param searchQuery Query string to filter by
+ * @returns Filtered array of contacts
+ */
+declare function filterContacts(contacts: Contact[], searchQuery: string): Contact[];
+
+export { filterContacts };

package/dist/utils/contactUtils.d.ts

@@ -0,0 +1,12 @@
+import { C as Contact } from '../useInvitationFormLogic-Ct73M19B.js';
+import 'react';
+
+/**
+ * Filters contacts based on a search query
+ * @param contacts Array of contacts to filter
+ * @param searchQuery Query string to filter by
+ * @returns Filtered array of contacts
+ */
+declare function filterContacts(contacts: Contact[], searchQuery: string): Contact[];
+
+export { filterContacts };

package/dist/utils/contactUtils.js

@@ -0,0 +1,37 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/utils/contactUtils.ts
+var contactUtils_exports = {};
+__export(contactUtils_exports, {
+  filterContacts: () => filterContacts
+});
+module.exports = __toCommonJS(contactUtils_exports);
+function filterContacts(contacts, searchQuery) {
+  const query = searchQuery.toLowerCase().trim();
+  if (!query) return contacts;
+  return contacts.filter(
+    (contact) => contact.name.toLowerCase().includes(query) || contact.email.toLowerCase().includes(query)
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  filterContacts
+});
+//# sourceMappingURL=contactUtils.js.map

package/dist/utils/contactUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/contactUtils.ts"],"sourcesContent":["import type { Contact } from '../hooks/useInvitationFormLogic';\n\n/**\n * Filters contacts based on a search query\n * @param contacts Array of contacts to filter\n * @param searchQuery Query string to filter by\n * @returns Filtered array of contacts\n */\nexport function filterContacts(contacts: Contact[], searchQuery: string): Contact[] {\n  const query = searchQuery.toLowerCase().trim();\n  if (!query) return contacts;\n  \n  return contacts.filter(contact =>\n    contact.name.toLowerCase().includes(query) ||\n    contact.email.toLowerCase().includes(query)\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAQO,SAAS,eAAe,UAAqB,aAAgC;AAClF,QAAM,QAAQ,YAAY,YAAY,EAAE,KAAK;AAC7C,MAAI,CAAC,MAAO,QAAO;AAEnB,SAAO,SAAS;AAAA,IAAO,aACrB,QAAQ,KAAK,YAAY,EAAE,SAAS,KAAK,KACzC,QAAQ,MAAM,YAAY,EAAE,SAAS,KAAK;AAAA,EAC5C;AACF;","names":[]}

package/dist/utils/contactUtils.mjs

@@ -0,0 +1,12 @@
+// src/utils/contactUtils.ts
+function filterContacts(contacts, searchQuery) {
+  const query = searchQuery.toLowerCase().trim();
+  if (!query) return contacts;
+  return contacts.filter(
+    (contact) => contact.name.toLowerCase().includes(query) || contact.email.toLowerCase().includes(query)
+  );
+}
+export {
+  filterContacts
+};
+//# sourceMappingURL=contactUtils.mjs.map

package/dist/utils/contactUtils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/contactUtils.ts"],"sourcesContent":["import type { Contact } from '../hooks/useInvitationFormLogic';\n\n/**\n * Filters contacts based on a search query\n * @param contacts Array of contacts to filter\n * @param searchQuery Query string to filter by\n * @returns Filtered array of contacts\n */\nexport function filterContacts(contacts: Contact[], searchQuery: string): Contact[] {\n  const query = searchQuery.toLowerCase().trim();\n  if (!query) return contacts;\n  \n  return contacts.filter(contact =>\n    contact.name.toLowerCase().includes(query) ||\n    contact.email.toLowerCase().includes(query)\n  );\n}\n"],"mappings":";AAQO,SAAS,eAAe,UAAqB,aAAgC;AAClF,QAAM,QAAQ,YAAY,YAAY,EAAE,KAAK;AAC7C,MAAI,CAAC,MAAO,QAAO;AAEnB,SAAO,SAAS;AAAA,IAAO,aACrB,QAAQ,KAAK,YAAY,EAAE,SAAS,KAAK,KACzC,QAAQ,MAAM,YAAY,EAAE,SAAS,KAAK;AAAA,EAC5C;AACF;","names":[]}

package/dist/utils/featureWarnings.js

@@ -0,0 +1,214 @@
+"use strict";
+/**
+ * Feature Warnings
+ *
+ * This module provides feature detection and helpful warnings for missing module configurations.
+ * It scans widget configuration to detect which features are required and prints actionable
+ * warnings when the corresponding module props are not specified.
+ *
+ * Warnings are only printed in development mode (__DEV__) and on native platforms.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectRequiredFeatures = detectRequiredFeatures;
+exports.printFeatureWarnings = printFeatureWarnings;
+exports.printWarningOnce = printWarningOnce;
+exports.printInfoOnce = printInfoOnce;
+exports.clearWarningsCache = clearWarningsCache;
+const react_native_1 = require("react-native");
+/**
+ * Recursively scans a node tree for gradient backgrounds.
+ */
+function scanForGradients(node) {
+    var _a, _b, _c, _d, _e, _f;
+    if (!node)
+        return false;
+    // Check style.background for linear-gradient
+    if ((_c = (_b = (_a = node.style) === null || _a === void 0 ? void 0 : _a.background) === null || _b === void 0 ? void 0 : _b.includes) === null || _c === void 0 ? void 0 : _c.call(_b, 'linear-gradient')) {
+        return true;
+    }
+    // Check theme options for gradients
+    if (((_d = node.theme) === null || _d === void 0 ? void 0 : _d.options) && Array.isArray(node.theme.options)) {
+        for (const option of node.theme.options) {
+            if ((_f = (_e = option.value) === null || _e === void 0 ? void 0 : _e.includes) === null || _f === void 0 ? void 0 : _f.call(_e, 'linear-gradient')) {
+                return true;
+            }
+        }
+    }
+    // Recursively check children
+    if (node.children && Array.isArray(node.children)) {
+        for (const child of node.children) {
+            if (scanForGradients(child))
+                return true;
+        }
+    }
+    return false;
+}
+/**
+ * Recursively scans a node tree for QR code elements.
+ */
+function scanForQRCode(node) {
+    if (!node)
+        return false;
+    if (node.type === 'vrtx-qr-code' || node.tagName === 'vrtx-qr-code') {
+        return true;
+    }
+    if (node.children && Array.isArray(node.children)) {
+        for (const child of node.children) {
+            if (scanForQRCode(child))
+                return true;
+        }
+    }
+    return false;
+}
+/**
+ * Recursively scans a node tree for share options (which need clipboard).
+ */
+function scanForShareOptions(node) {
+    if (!node)
+        return false;
+    if (node.type === 'vrtx-share-options' || node.tagName === 'vrtx-share-options') {
+        return true;
+    }
+    if (node.children && Array.isArray(node.children)) {
+        for (const child of node.children) {
+            if (scanForShareOptions(child))
+                return true;
+        }
+    }
+    return false;
+}
+/**
+ * Detects which features are required based on widget configuration.
+ *
+ * @param widgetConfiguration - The widget configuration from the API
+ * @returns Object indicating which features are needed
+ */
+function detectRequiredFeatures(widgetConfiguration) {
+    var _a;
+    const requirements = {
+        needsGradient: false,
+        needsQRCode: false,
+        needsHaptics: true, // Always nice to have for buttons
+        needsClipboard: false,
+    };
+    if (!widgetConfiguration)
+        return requirements;
+    const rootElement = ((_a = widgetConfiguration.data) === null || _a === void 0 ? void 0 : _a.rootElement) || widgetConfiguration.rootElement;
+    requirements.needsGradient = scanForGradients(rootElement);
+    requirements.needsQRCode = scanForQRCode(rootElement);
+    requirements.needsClipboard = scanForShareOptions(rootElement);
+    return requirements;
+}
+/**
+ * Prints helpful warnings for missing module configurations.
+ * Only prints in development mode and on native platforms.
+ * Uses deduplication helpers to prevent warnings from printing on every render.
+ *
+ * @param requirements - The detected feature requirements
+ * @param moduleConfig - The current module configuration from props
+ */
+function printFeatureWarnings(requirements, moduleConfig) {
+    var _a, _b, _c, _d;
+    // Only warn in development and on native platforms
+    if (!__DEV__ || react_native_1.Platform.OS === 'web')
+        return;
+    // Check for module configuration
+    const hasGradientModule = (_a = moduleConfig.modules) === null || _a === void 0 ? void 0 : _a.gradient;
+    const hasQRCodeModule = (_b = moduleConfig.modules) === null || _b === void 0 ? void 0 : _b.qrCode;
+    const hasHapticsModule = (_c = moduleConfig.modules) === null || _c === void 0 ? void 0 : _c.haptics;
+    const hasClipboardModule = (_d = moduleConfig.modules) === null || _d === void 0 ? void 0 : _d.clipboard;
+    // Gradient warning
+    if (requirements.needsGradient && !hasGradientModule) {
+        printWarningOnce('vortex-gradient-module', `[Vortex] ⚠️ Gradient backgrounds detected in widget configuration, but no gradient module specified.
+
+To enable gradients on native platforms, add the modules prop to <VortexInvite>:
+
+  For Expo projects:
+    <VortexInvite modules={{ gradient: 'expo-linear-gradient' }} ... />
+    Then run: npx expo install expo-linear-gradient
+
+  For bare React Native:
+    <VortexInvite modules={{ gradient: 'react-native-linear-gradient' }} ... />
+    Then run: npm install react-native-linear-gradient
+
+Without a gradient module, gradient backgrounds will fall back to solid colors.
+`);
+    }
+    // QR Code warning
+    if (requirements.needsQRCode && !hasQRCodeModule) {
+        printWarningOnce('vortex-qrcode-module', `[Vortex] ⚠️ QR Code feature detected in widget configuration, but no QR code module specified.
+
+To enable QR codes, add the modules prop to <VortexInvite>:
+
+  For native apps:
+    <VortexInvite modules={{ qrCode: 'react-native-qrcode-svg' }} ... />
+    Then run: npm install react-native-qrcode-svg react-native-svg
+
+  For web preview:
+    <VortexInvite modules={{ qrCode: 'react-qr-code' }} ... />
+    Then run: npm install react-qr-code
+
+Without a QR code module, QR codes will show a placeholder message.
+`);
+    }
+    // Haptics info (less critical)
+    if (requirements.needsHaptics && !hasHapticsModule) {
+        printInfoOnce('vortex-haptics-module', `[Vortex] 💡 Tip: Add haptic feedback for better UX:
+
+    <VortexInvite modules={{ haptics: 'expo-haptics' }} ... />
+    Then run: npx expo install expo-haptics
+`);
+    }
+    // Clipboard info (only if share options are present)
+    if (requirements.needsClipboard && !hasClipboardModule) {
+        printInfoOnce('vortex-clipboard-module', `[Vortex] 💡 Tip: For clipboard support (Copy Link), add:
+
+  For Expo projects:
+    <VortexInvite modules={{ clipboard: 'expo-clipboard' }} ... />
+    Then run: npx expo install expo-clipboard
+
+  For bare React Native:
+    <VortexInvite modules={{ clipboard: '@react-native-clipboard/clipboard' }} ... />
+    Then run: npm install @react-native-clipboard/clipboard
+
+Without a clipboard module, the SDK will use React Native's built-in Clipboard API.
+`);
+    }
+}
+/**
+ * Tracks which warnings have been printed to avoid duplicate warnings.
+ */
+const printedWarnings = new Set();
+/**
+ * Prints a warning only once per session.
+ * Useful for warnings that shouldn't spam the console on every render.
+ *
+ * @param key - Unique key for this warning
+ * @param message - The warning message to print
+ */
+function printWarningOnce(key, message) {
+    if (!__DEV__ || printedWarnings.has(key))
+        return;
+    printedWarnings.add(key);
+    console.warn(message);
+}
+/**
+ * Prints an info message only once per session.
+ *
+ * @param key - Unique key for this message
+ * @param message - The info message to print
+ */
+function printInfoOnce(key, message) {
+    if (!__DEV__ || printedWarnings.has(key))
+        return;
+    printedWarnings.add(key);
+    console.info(message);
+}
+/**
+ * Clears the printed warnings cache.
+ * Useful for testing or when you want warnings to be printed again.
+ */
+function clearWarningsCache() {
+    printedWarnings.clear();
+}
+//# sourceMappingURL=featureWarnings.js.map

package/dist/utils/featureWarnings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"featureWarnings.js","sourceRoot":"","sources":["../../src/utils/featureWarnings.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;AAyFH,wDAkBC;AAUD,oDAqFC;AAcD,4CAKC;AAQD,sCAKC;AAMD,gDAEC;AAhPD,+CAAwC;AAaxC;;GAEG;AACH,SAAS,gBAAgB,CAAC,IAAS;;IACjC,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IAExB,6CAA6C;IAC7C,IAAI,MAAA,MAAA,MAAA,IAAI,CAAC,KAAK,0CAAE,UAAU,0CAAE,QAAQ,mDAAG,iBAAiB,CAAC,EAAE,CAAC;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oCAAoC;IACpC,IAAI,CAAA,MAAA,IAAI,CAAC,KAAK,0CAAE,OAAO,KAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7D,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACxC,IAAI,MAAA,MAAA,MAAM,CAAC,KAAK,0CAAE,QAAQ,mDAAG,iBAAiB,CAAC,EAAE,CAAC;gBAChD,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IAED,6BAA6B;IAC7B,IAAI,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClC,IAAI,gBAAgB,CAAC,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,IAAS;IAC9B,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IAExB,IAAI,IAAI,CAAC,IAAI,KAAK,cAAc,IAAI,IAAI,CAAC,OAAO,KAAK,cAAc,EAAE,CAAC;QACpE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClC,IAAI,aAAa,CAAC,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;QACxC,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,IAAS;IACpC,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IAExB,IAAI,IAAI,CAAC,IAAI,KAAK,oBAAoB,IAAI,IAAI,CAAC,OAAO,KAAK,oBAAoB,EAAE,CAAC;QAChF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClC,IAAI,mBAAmB,CAAC,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,SAAgB,sBAAsB,CAAC,mBAAwB;;IAC7D,MAAM,YAAY,GAAwB;QACxC,aAAa,EAAE,KAAK;QACpB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,IAAI,EAAE,kCAAkC;QACtD,cAAc,EAAE,KAAK;KACtB,CAAC;IAEF,IAAI,CAAC,mBAAmB;QAAE,OAAO,YAAY,CAAC;IAE9C,MAAM,WAAW,GACf,CAAA,MAAA,mBAAmB,CAAC,IAAI,0CAAE,WAAW,KAAI,mBAAmB,CAAC,WAAW,CAAC;IAE3E,YAAY,CAAC,aAAa,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAC3D,YAAY,CAAC,WAAW,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IACtD,YAAY,CAAC,cAAc,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAE/D,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,oBAAoB,CAClC,YAAiC,EACjC,YAAiC;;IAEjC,mDAAmD;IACnD,IAAI,CAAC,OAAO,IAAI,uBAAQ,CAAC,EAAE,KAAK,KAAK;QAAE,OAAO;IAE9C,iCAAiC;IACjC,MAAM,iBAAiB,GAAG,MAAA,YAAY,CAAC,OAAO,0CAAE,QAAQ,CAAC;IACzD,MAAM,eAAe,GAAG,MAAA,YAAY,CAAC,OAAO,0CAAE,MAAM,CAAC;IACrD,MAAM,gBAAgB,GAAG,MAAA,YAAY,CAAC,OAAO,0CAAE,OAAO,CAAC;IACvD,MAAM,kBAAkB,GAAG,MAAA,YAAY,CAAC,OAAO,0CAAE,SAAS,CAAC;IAE3D,mBAAmB;IACnB,IAAI,YAAY,CAAC,aAAa,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACrD,gBAAgB,CACd,wBAAwB,EACxB;;;;;;;;;;;;;CAaL,CACI,CAAC;IACJ,CAAC;IAED,kBAAkB;IAClB,IAAI,YAAY,CAAC,WAAW,IAAI,CAAC,eAAe,EAAE,CAAC;QACjD,gBAAgB,CACd,sBAAsB,EACtB;;;;;;;;;;;;;CAaL,CACI,CAAC;IACJ,CAAC;IAED,+BAA+B;IAC/B,IAAI,YAAY,CAAC,YAAY,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACnD,aAAa,CACX,uBAAuB,EACvB;;;;CAIL,CACI,CAAC;IACJ,CAAC;IAED,qDAAqD;IACrD,IAAI,YAAY,CAAC,cAAc,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACvD,aAAa,CACX,yBAAyB,EACzB;;;;;;;;;;;CAWL,CACI,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;AAE1C;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAAC,GAAW,EAAE,OAAe;IAC3D,IAAI,CAAC,OAAO,IAAI,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO;IAEjD,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACzB,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACxB,CAAC;AAED;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,GAAW,EAAE,OAAe;IACxD,IAAI,CAAC,OAAO,IAAI,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO;IAEjD,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACzB,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACxB,CAAC;AAED;;;GAGG;AACH,SAAgB,kBAAkB;IAChC,eAAe,CAAC,KAAK,EAAE,CAAC;AAC1B,CAAC","sourcesContent":["/**\n * Feature Warnings\n *\n * This module provides feature detection and helpful warnings for missing module configurations.\n * It scans widget configuration to detect which features are required and prints actionable\n * warnings when the corresponding module props are not specified.\n *\n * Warnings are only printed in development mode (__DEV__) and on native platforms.\n */\n\nimport { Platform } from 'react-native';\nimport type { VortexModulesConfig } from '../context/VortexModulesContext';\n\n/**\n * Features that may be required based on widget configuration\n */\nexport interface FeatureRequirements {\n  needsGradient: boolean;\n  needsQRCode: boolean;\n  needsHaptics: boolean;\n  needsClipboard: boolean;\n}\n\n/**\n * Recursively scans a node tree for gradient backgrounds.\n */\nfunction scanForGradients(node: any): boolean {\n  if (!node) return false;\n\n  // Check style.background for linear-gradient\n  if (node.style?.background?.includes?.('linear-gradient')) {\n    return true;\n  }\n\n  // Check theme options for gradients\n  if (node.theme?.options && Array.isArray(node.theme.options)) {\n    for (const option of node.theme.options) {\n      if (option.value?.includes?.('linear-gradient')) {\n        return true;\n      }\n    }\n  }\n\n  // Recursively check children\n  if (node.children && Array.isArray(node.children)) {\n    for (const child of node.children) {\n      if (scanForGradients(child)) return true;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Recursively scans a node tree for QR code elements.\n */\nfunction scanForQRCode(node: any): boolean {\n  if (!node) return false;\n\n  if (node.type === 'vrtx-qr-code' || node.tagName === 'vrtx-qr-code') {\n    return true;\n  }\n\n  if (node.children && Array.isArray(node.children)) {\n    for (const child of node.children) {\n      if (scanForQRCode(child)) return true;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Recursively scans a node tree for share options (which need clipboard).\n */\nfunction scanForShareOptions(node: any): boolean {\n  if (!node) return false;\n\n  if (node.type === 'vrtx-share-options' || node.tagName === 'vrtx-share-options') {\n    return true;\n  }\n\n  if (node.children && Array.isArray(node.children)) {\n    for (const child of node.children) {\n      if (scanForShareOptions(child)) return true;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Detects which features are required based on widget configuration.\n *\n * @param widgetConfiguration - The widget configuration from the API\n * @returns Object indicating which features are needed\n */\nexport function detectRequiredFeatures(widgetConfiguration: any): FeatureRequirements {\n  const requirements: FeatureRequirements = {\n    needsGradient: false,\n    needsQRCode: false,\n    needsHaptics: true, // Always nice to have for buttons\n    needsClipboard: false,\n  };\n\n  if (!widgetConfiguration) return requirements;\n\n  const rootElement =\n    widgetConfiguration.data?.rootElement || widgetConfiguration.rootElement;\n\n  requirements.needsGradient = scanForGradients(rootElement);\n  requirements.needsQRCode = scanForQRCode(rootElement);\n  requirements.needsClipboard = scanForShareOptions(rootElement);\n\n  return requirements;\n}\n\n/**\n * Prints helpful warnings for missing module configurations.\n * Only prints in development mode and on native platforms.\n * Uses deduplication helpers to prevent warnings from printing on every render.\n *\n * @param requirements - The detected feature requirements\n * @param moduleConfig - The current module configuration from props\n */\nexport function printFeatureWarnings(\n  requirements: FeatureRequirements,\n  moduleConfig: VortexModulesConfig\n): void {\n  // Only warn in development and on native platforms\n  if (!__DEV__ || Platform.OS === 'web') return;\n\n  // Check for module configuration\n  const hasGradientModule = moduleConfig.modules?.gradient;\n  const hasQRCodeModule = moduleConfig.modules?.qrCode;\n  const hasHapticsModule = moduleConfig.modules?.haptics;\n  const hasClipboardModule = moduleConfig.modules?.clipboard;\n\n  // Gradient warning\n  if (requirements.needsGradient && !hasGradientModule) {\n    printWarningOnce(\n      'vortex-gradient-module',\n      `[Vortex] ⚠️ Gradient backgrounds detected in widget configuration, but no gradient module specified.\n\nTo enable gradients on native platforms, add the modules prop to <VortexInvite>:\n\n  For Expo projects:\n    <VortexInvite modules={{ gradient: 'expo-linear-gradient' }} ... />\n    Then run: npx expo install expo-linear-gradient\n\n  For bare React Native:\n    <VortexInvite modules={{ gradient: 'react-native-linear-gradient' }} ... />\n    Then run: npm install react-native-linear-gradient\n\nWithout a gradient module, gradient backgrounds will fall back to solid colors.\n`\n    );\n  }\n\n  // QR Code warning\n  if (requirements.needsQRCode && !hasQRCodeModule) {\n    printWarningOnce(\n      'vortex-qrcode-module',\n      `[Vortex] ⚠️ QR Code feature detected in widget configuration, but no QR code module specified.\n\nTo enable QR codes, add the modules prop to <VortexInvite>:\n\n  For native apps:\n    <VortexInvite modules={{ qrCode: 'react-native-qrcode-svg' }} ... />\n    Then run: npm install react-native-qrcode-svg react-native-svg\n\n  For web preview:\n    <VortexInvite modules={{ qrCode: 'react-qr-code' }} ... />\n    Then run: npm install react-qr-code\n\nWithout a QR code module, QR codes will show a placeholder message.\n`\n    );\n  }\n\n  // Haptics info (less critical)\n  if (requirements.needsHaptics && !hasHapticsModule) {\n    printInfoOnce(\n      'vortex-haptics-module',\n      `[Vortex] 💡 Tip: Add haptic feedback for better UX:\n\n    <VortexInvite modules={{ haptics: 'expo-haptics' }} ... />\n    Then run: npx expo install expo-haptics\n`\n    );\n  }\n\n  // Clipboard info (only if share options are present)\n  if (requirements.needsClipboard && !hasClipboardModule) {\n    printInfoOnce(\n      'vortex-clipboard-module',\n      `[Vortex] 💡 Tip: For clipboard support (Copy Link), add:\n\n  For Expo projects:\n    <VortexInvite modules={{ clipboard: 'expo-clipboard' }} ... />\n    Then run: npx expo install expo-clipboard\n\n  For bare React Native:\n    <VortexInvite modules={{ clipboard: '@react-native-clipboard/clipboard' }} ... />\n    Then run: npm install @react-native-clipboard/clipboard\n\nWithout a clipboard module, the SDK will use React Native's built-in Clipboard API.\n`\n    );\n  }\n}\n\n/**\n * Tracks which warnings have been printed to avoid duplicate warnings.\n */\nconst printedWarnings = new Set<string>();\n\n/**\n * Prints a warning only once per session.\n * Useful for warnings that shouldn't spam the console on every render.\n *\n * @param key - Unique key for this warning\n * @param message - The warning message to print\n */\nexport function printWarningOnce(key: string, message: string): void {\n  if (!__DEV__ || printedWarnings.has(key)) return;\n\n  printedWarnings.add(key);\n  console.warn(message);\n}\n\n/**\n * Prints an info message only once per session.\n *\n * @param key - Unique key for this message\n * @param message - The info message to print\n */\nexport function printInfoOnce(key: string, message: string): void {\n  if (!__DEV__ || printedWarnings.has(key)) return;\n\n  printedWarnings.add(key);\n  console.info(message);\n}\n\n/**\n * Clears the printed warnings cache.\n * Useful for testing or when you want warnings to be printed again.\n */\nexport function clearWarningsCache(): void {\n  printedWarnings.clear();\n}\n"]}