@teamvortexsoftware/vortex-react-native 0.0.13 → 1.0.1

package/dist/hooks/useVortexInvite.js

@@ -16,22 +16,166 @@ exports.useVortexInvite = useVortexInvite;
 const react_1 = require("react");
 const react_native_1 = require("react-native");
 const themeUtils_1 = require("../utils/themeUtils");
-const Clipboard_1 = require("../components/Clipboard");
 const useThemeStyles_1 = require("./useThemeStyles");
 const react_native_uuid_1 = __importDefault(require("react-native-uuid"));
 const formUtils_1 = require("../utils/formUtils");
 const vortex_shared_ui_1 = require("@teamvortexsoftware/vortex-shared-ui");
-function useVortexInvite({ widgetId, environmentId, vortexApiUrl, contentTokens, isLoading = false, jwt, onSuccess, onError, }) {
-    const vortexClient = (0, react_1.useMemo)(() => new vortex_shared_ui_1.VortexClient(vortexApiUrl, react_native_uuid_1.default.v4()), [vortexApiUrl]);
-    const [widgetConfiguration, setWidgetConfiguration] = (0, react_1.useState)();
+const configCache_1 = require("../utils/configCache");
+const analytics_client_1 = require("@teamvortexsoftware/analytics-client");
+const analytics_1 = require("../utils/analytics");
+function useVortexInvite({ componentId, vortexApiUrl, isLoading = false, jwt, user, onSuccess, onError, group, groups, scope, scopeType, widgetConfiguration: initialWidgetConfiguration, analyticsBaseURL, onEvent, analyticsSegmentation, locale, }) {
+    // Check FIRST, before any hooks are called
+    if (!componentId) {
+        throw Error('[Vortex Invite] componentId is required to fetch configuration');
+    }
+    // Create effective groups with fallback logic: group > scope+scopeType
+    const effectiveGroup = (0, react_1.useMemo)(() => {
+        if (group)
+            return group;
+        if (scope && scopeType) {
+            return { type: scopeType, groupId: scope, name: scope };
+        }
+        return undefined;
+    }, [group, scope, scopeType]);
+    // If user is provided, construct the insecure JWT token
+    const effectiveJwt = (0, react_1.useMemo)(() => {
+        if (jwt)
+            return jwt;
+        if (user) {
+            if (typeof user === 'string') {
+                return user;
+            }
+            const payload = Object.assign(Object.assign({}, user), { componentId });
+            const jsonString = JSON.stringify(payload);
+            const base64Encoded = Buffer.from(jsonString).toString('base64');
+            return `raw-data:${base64Encoded}`;
+        }
+        return undefined;
+    }, [jwt, user, componentId]);
+    const vortexClient = (0, react_1.useMemo)(() => {
+        const clientInfo = (0, vortex_shared_ui_1.getClientInfo)();
+        const sessionId = react_native_uuid_1.default.v4();
+        return new vortex_shared_ui_1.VortexClient(vortexApiUrl, clientInfo.name, clientInfo.version, sessionId);
+    }, [vortexApiUrl]);
+    // Initialize from cache first, then fall back to initialWidgetConfiguration prop
+    const cachedConfig = configCache_1.configCache.get(componentId);
+    const [widgetConfiguration, setWidgetConfiguration] = (0, react_1.useState)(cachedConfig || initialWidgetConfiguration);
     const [error, setError] = (0, react_1.useState)(null);
     const [fetching, setFetching] = (0, react_1.useState)(isLoading);
-    const [loading, setLoading] = (0, react_1.useState)(true);
+    const [loading, setLoading] = (0, react_1.useState)(!cachedConfig && !initialWidgetConfiguration); // Start as false if we have cached or prefetched config
     const [email, setEmail] = (0, react_1.useState)('');
     const [shareableLink, setShareableLink] = (0, react_1.useState)();
+    const [role, setRole] = (0, react_1.useState)(undefined);
     const [inviteLoading, setInviteLoading] = (0, react_1.useState)(false);
     const [showSuccessMessage, setShowSuccessMessage] = (0, react_1.useState)(false);
     const opacity = new react_native_1.Animated.Value(0.3);
+    // Analytics state
+    const [deploymentId, setDeploymentId] = (0, react_1.useState)(null);
+    const [sessionId] = (0, react_1.useState)(() => react_native_uuid_1.default.v4());
+    const [widgetRenderTracked, setWidgetRenderTracked] = (0, react_1.useState)(false);
+    const [formRenderTime, setFormRenderTime] = (0, react_1.useState)(null);
+    // Track when config has been fetched through VortexClient (which sets sessionAttestation)
+    const [configFetchedViaClient, setConfigFetchedViaClient] = (0, react_1.useState)(false);
+    // Create analytics client (memoized to avoid recreation)
+    const analyticsClient = (0, react_1.useMemo)(() => {
+        if (!effectiveJwt)
+            return null;
+        const analyticsUrl = analyticsBaseURL || analytics_1.DEFAULT_ANALYTICS_URL;
+        const clientInfo = (0, vortex_shared_ui_1.getClientInfo)();
+        return new analytics_client_1.AnalyticsClient(analyticsUrl, effectiveJwt, sessionId, clientInfo.name, clientInfo.version);
+    }, [effectiveJwt, analyticsBaseURL, sessionId]);
+    // Compute effective groups for analytics
+    const effectiveGroups = (0, react_1.useMemo)(() => {
+        if (groups && groups.length > 0)
+            return groups;
+        if (effectiveGroup) {
+            return [{
+                    type: effectiveGroup.type,
+                    id: effectiveGroup.groupId || effectiveGroup.id || '',
+                    name: effectiveGroup.name,
+                }];
+        }
+        return undefined;
+    }, [groups, effectiveGroup]);
+    // Core event tracking function
+    const trackEvent = (0, react_1.useCallback)((name, payload) => __awaiter(this, void 0, void 0, function* () {
+        const event = {
+            name,
+            widgetConfigurationId: (widgetConfiguration === null || widgetConfiguration === void 0 ? void 0 : widgetConfiguration.id) || '',
+            deploymentId: deploymentId || '',
+            environmentId: '', // Not currently used (matches web SDK)
+            platform: react_native_1.Platform.OS, // 'ios' or 'android'
+            timestamp: Math.floor(Date.now() / 1000), // Unix seconds
+            sessionId,
+            useragent: (0, analytics_1.getDeviceInfo)(),
+            foreignUserId: (0, analytics_1.extractForeignUserId)(effectiveJwt),
+            segmentation: analyticsSegmentation,
+            payload,
+            groups: effectiveGroups,
+        };
+        // Call user's onEvent callback
+        if (onEvent) {
+            onEvent(event);
+        }
+        // Send to analytics backend (fire-and-forget, non-blocking)
+        if (analyticsClient && deploymentId && widgetConfiguration) {
+            analyticsClient.track(event).catch(() => {
+                // Silently ignore errors - analytics should never impact user experience
+            });
+        }
+    }), [
+        widgetConfiguration,
+        deploymentId,
+        sessionId,
+        effectiveJwt,
+        analyticsSegmentation,
+        effectiveGroups,
+        onEvent,
+        analyticsClient,
+    ]);
+    // Track widget render once per hook instance (on initial render only)
+    // The flag resets when component unmounts, so remounting fires a new event (expected behavior)
+    const trackWidgetRender = (0, react_1.useCallback)(() => {
+        if (widgetRenderTracked)
+            return;
+        setWidgetRenderTracked(true);
+        setFormRenderTime(Date.now());
+        trackEvent(analytics_client_1.EventNames.INVITE_FORM_RENDER_SUCCEEDED);
+    }, [widgetRenderTracked, trackEvent]);
+    // Track widget error
+    const trackWidgetError = (0, react_1.useCallback)((errorMessage) => {
+        trackEvent(analytics_client_1.EventNames.INVITE_FORM_RENDER_FAILED, { error: errorMessage });
+    }, [trackEvent]);
+    // Track share link clicks
+    const trackShareLinkClick = (0, react_1.useCallback)((clickName) => {
+        trackEvent(analytics_client_1.EventNames.SHARING_DESTINATION_BUTTON_CLICKED, { clickName });
+    }, [trackEvent]);
+    // Track email field focus
+    const trackEmailFieldFocus = (0, react_1.useCallback)(() => {
+        const timestamp = formRenderTime ? Date.now() - formRenderTime : 0;
+        trackEvent(analytics_client_1.EventNames.EMAIL_FIELD_FOCUSSED, { timestamp });
+    }, [formRenderTime, trackEvent]);
+    // Track email field blur
+    const trackEmailFieldBlur = (0, react_1.useCallback)(() => {
+        const timestamp = formRenderTime ? Date.now() - formRenderTime : 0;
+        trackEvent(analytics_client_1.EventNames.EMAIL_FIELD_BLURRED, { timestamp });
+    }, [formRenderTime, trackEvent]);
+    // Track email validation
+    const trackEmailValidation = (0, react_1.useCallback)((emailValue, isValid) => {
+        trackEvent(analytics_client_1.EventNames.EMAIL_SUBMISSION_VALIDATED, { email: emailValue, isValid });
+    }, [trackEvent]);
+    // Track form submission
+    const trackEmailInvitationsSubmitted = (0, react_1.useCallback)((formData) => {
+        trackEvent(analytics_client_1.EventNames.EMAIL_FIELD_SUBMISSION_SUCCEEDED, { formData });
+    }, [trackEvent]);
+    // Track email validation error (now uses WIDGET_EMAIL_VALIDATION with error payload)
+    const trackEmailValidationError = (0, react_1.useCallback)((formData) => {
+        trackEvent(analytics_client_1.EventNames.EMAIL_SUBMISSION_VALIDATED, { formData, hasError: true });
+    }, [trackEvent]);
+    // Track email submit error
+    const trackEmailSubmitError = (0, react_1.useCallback)((errorMessage) => {
+        trackEvent(analytics_client_1.EventNames.EMAIL_FIELD_SUBMISSION_FAILED, { error: errorMessage });
+    }, [trackEvent]);
     // Extract theme colors and feature flags using utility functions
     const themeColors = (0, react_1.useMemo)(() => (0, themeUtils_1.extractThemeColors)(widgetConfiguration), [widgetConfiguration]);
     // Extract form configuration
@@ -52,6 +196,14 @@ function useVortexInvite({ widgetId, environmentId, vortexApiUrl, contentTokens,
         hasSeparateColumns: (0, formUtils_1.hasEmailAndShareInSeparateColumns)(formConfig),
         formConfig,
     }), [formConfig]);
+    // Extract role options and initialize default role
+    const roleOptions = (0, react_1.useMemo)(() => (0, formUtils_1.getRoleOptions)(formConfig), [formConfig]);
+    (0, react_1.useEffect)(() => {
+        var _a;
+        if (!role && roleOptions.length > 0) {
+            setRole((_a = roleOptions[0]) === null || _a === void 0 ? void 0 : _a.value);
+        }
+    }, [role, roleOptions]);
     const has = (0, react_1.useMemo)(() => {
         const flags = (0, themeUtils_1.extractFeatureFlags)(widgetConfiguration);
         console.log('[Vortex] Invite has', flags);
@@ -63,8 +215,12 @@ function useVortexInvite({ widgetId, environmentId, vortexApiUrl, contentTokens,
             console.warn('[Vortex] Invite Using localhost as host');
         }
     }, [vortexApiUrl]);
-    // Loading animation effect
+    // Loading animation effect (skip if we have prefetched configuration)
     (0, react_1.useEffect)(() => {
+        // If we already have configuration, no need for loading animation
+        if (initialWidgetConfiguration) {
+            return;
+        }
         const animation = react_native_1.Animated.loop(react_native_1.Animated.sequence([
             react_native_1.Animated.timing(opacity, {
                 toValue: 1,
@@ -82,38 +238,65 @@ function useVortexInvite({ widgetId, environmentId, vortexApiUrl, contentTokens,
             setLoading(false);
             animation.stop();
         }, 2000);
-    }, [opacity]);
-    // Fetch widget configuration if needed
+    }, [opacity, initialWidgetConfiguration]);
+    // Fetch widget configuration (always fetch to get latest, but don't show loading if we have prefetched data)
     (0, react_1.useEffect)(() => {
-        // Case: If `widgetConfiguration` is already set, do nothing
-        if (widgetConfiguration) {
-            console.log('[Vortex] Invite Already has widgetConfiguration, skipping fetch');
-            return;
-        }
-        if (!jwt) {
+        if (!effectiveJwt) {
             console.log('[Vortex] Invite JWT is required');
             return;
         }
         const fetchData = () => __awaiter(this, void 0, void 0, function* () {
             var _a;
-            console.log('[Vortex] Invite Fetching Data...');
-            setFetching(true);
-            setLoading(true);
+            // Only show loading state if we don't have ANY configuration yet
+            const shouldShowLoading = !widgetConfiguration;
+            if (shouldShowLoading) {
+                console.log('[Vortex] Invite Fetching Data (first load)...');
+                setFetching(true);
+                setLoading(true);
+            }
+            else {
+                console.log('[Vortex] Invite Refreshing configuration in background...');
+            }
             setError(null);
             try {
-                const result = yield vortexClient.getWidgetConfiguration(widgetId, jwt, environmentId);
+                const result = yield vortexClient.getWidgetConfiguration(componentId, effectiveJwt, undefined, locale);
                 if ((_a = result === null || result === void 0 ? void 0 : result.data) === null || _a === void 0 ? void 0 : _a.widgetConfiguration) {
-                    setWidgetConfiguration(result.data.widgetConfiguration);
-                    console.log('[Vortex] Invite Successfully fetched widgetConfiguration', JSON.stringify(result.data.widgetConfiguration));
+                    const freshConfig = result.data.widgetConfiguration;
+                    setWidgetConfiguration(freshConfig);
+                    configCache_1.configCache.set(componentId, freshConfig); // Update shared cache
+                    // Mark that config was fetched via VortexClient (sessionAttestation is now set)
+                    setConfigFetchedViaClient(true);
+                    // Extract deploymentId from API response (CRITICAL for analytics)
+                    if (result.data.deploymentId) {
+                        setDeploymentId(result.data.deploymentId);
+                        console.log('[Vortex] Invite deploymentId:', result.data.deploymentId);
+                    }
+                    console.log('[Vortex] Invite Successfully fetched widgetConfiguration', JSON.stringify(freshConfig));
                 }
                 else {
-                    const error = (result === null || result === void 0 ? void 0 : result.error) || 'No configuration data found.';
+                    const error = 'No configuration data found.';
                     console.error(`[Vortex] Invite ${error}`);
                     throw new Error(error);
                 }
             }
             catch (err) {
-                if (err instanceof Error) {
+                // Check if this is a VortexWidgetError with structured error information
+                if (vortex_shared_ui_1.VortexWidgetError.isVortexWidgetError(err)) {
+                    console.error('[Vortex] Invite Widget Error:', {
+                        code: err.code,
+                        userMessage: err.userMessage,
+                        developerMessage: err.developerMessage,
+                        context: err.context,
+                        statusCode: err.statusCode,
+                    });
+                    setError({
+                        message: err.userMessage || err.message,
+                        code: err.code,
+                        userMessage: err.userMessage,
+                        developerMessage: err.developerMessage,
+                    });
+                }
+                else if (err instanceof Error) {
                     const fetchError = err;
                     console.error('[Vortex] Invite Error Details:', {
                         message: fetchError.message,
@@ -122,19 +305,37 @@ function useVortexInvite({ widgetId, environmentId, vortexApiUrl, contentTokens,
                         body: fetchError.body,
                         stack: fetchError.stack,
                     });
+                    setError({
+                        message: err.message || 'Something went wrong!',
+                    });
+                }
+                else {
+                    console.error('[Vortex] Invite Error', err);
+                    setError({
+                        message: 'Something went wrong!',
+                    });
                 }
-                console.error('[Vortex] Invite Error', err);
-                setError({
-                    message: err.message || 'Something went wrong!',
-                });
             }
             finally {
-                setFetching(false);
-                setLoading(false);
+                if (shouldShowLoading) {
+                    setFetching(false);
+                    setLoading(false);
+                }
             }
         });
         fetchData();
-    }, [widgetId, jwt, environmentId, vortexClient, widgetConfiguration]);
+    }, [componentId, effectiveJwt, vortexClient, locale]); // Removed widgetConfiguration from deps to allow refetch
+    // Prefetch the shareable invitation link to avoid UI delays when user taps Copy Link or QR Code
+    // IMPORTANT: Only prefetch after config has been fetched via VortexClient, which sets sessionAttestation
+    (0, react_1.useEffect)(() => {
+        if ((widgetConfiguration === null || widgetConfiguration === void 0 ? void 0 : widgetConfiguration.id) && effectiveJwt && vortexClient && !shareableLink && configFetchedViaClient) {
+            console.log('[Vortex] Prefetching shareable invitation link...');
+            getShareableInviteLink().catch((error) => {
+                console.warn('[Vortex] Failed to prefetch shareable link:', error);
+                // Silent fail - user can still trigger it manually later
+            });
+        }
+    }, [widgetConfiguration === null || widgetConfiguration === void 0 ? void 0 : widgetConfiguration.id, effectiveJwt, vortexClient, shareableLink, configFetchedViaClient]);
     const handleInviteClick = (contentTokens) => __awaiter(this, void 0, void 0, function* () {
         try {
             setInviteLoading(true);
@@ -146,17 +347,24 @@ function useVortexInvite({ widgetId, environmentId, vortexApiUrl, contentTokens,
             // const url = `${host}/api/v1/no-auth/components/widget-configuration/${widgetConfigurationId}/invite`; // TODO should we use options.widgetHost?.value ?
             console.log('[Vortex] Invite Sending invitation', {
                 email,
-                widgetId,
-                environmentId,
+                componentId,
             });
-            if (!jwt) {
+            if (!effectiveJwt) {
                 throw new Error('[Vortex Invite] JWT is required');
             }
             const payload = Object.assign(Object.assign({}, contentTokens), { email: {
                     value: email,
                     type: 'email',
                 } });
-            const body = yield vortexClient.createInvite(jwt, widgetConfiguration === null || widgetConfiguration === void 0 ? void 0 : widgetConfiguration.id, environmentId, payload);
+            if (role) {
+                payload.role = {
+                    value: role,
+                    type: 'string',
+                };
+            }
+            // Use groups parameter instead of adding group to payload
+            const groups = effectiveGroup ? [{ type: effectiveGroup.type, id: effectiveGroup.groupId || effectiveGroup.id, name: effectiveGroup.name }] : undefined;
+            const body = yield vortexClient.createInvite(effectiveJwt, widgetConfiguration === null || widgetConfiguration === void 0 ? void 0 : widgetConfiguration.id, payload, 'email', groups);
             console.log('[Vortex] Invite Response', body);
             if (onSuccess) {
                 onSuccess({
@@ -185,6 +393,41 @@ function useVortexInvite({ widgetId, environmentId, vortexApiUrl, contentTokens,
     const getShareableLink = () => {
         return vortexClient.getShareableLinkFormatted();
     };
+    /**
+     * Create an invitation with internal ID target type.
+     * Used by Find Friends component when user taps Connect.
+     * Matches iOS SDK payload structure: { type: 'internal', value: { value, name, avatarUrl? } }
+     */
+    const createUserIdInvitation = (userId, name, avatarUrl, metadata) => __awaiter(this, void 0, void 0, function* () {
+        if (!effectiveJwt) {
+            throw new Error('[Vortex Invite] JWT is required');
+        }
+        if (!(widgetConfiguration === null || widgetConfiguration === void 0 ? void 0 : widgetConfiguration.id)) {
+            throw new Error('[Vortex Invite] Widget configuration is required');
+        }
+        console.log('[Vortex] Creating user ID invitation', { userId, name, avatarUrl });
+        // Build the target value object matching iOS SDK structure
+        const targetValue = {
+            value: userId,
+        };
+        if (name) {
+            targetValue.name = name;
+        }
+        if (avatarUrl) {
+            targetValue.avatarUrl = avatarUrl;
+        }
+        const payload = {
+            internalId: {
+                type: 'internal',
+                value: targetValue,
+            },
+        };
+        const groups = effectiveGroup
+            ? [{ type: effectiveGroup.type, id: effectiveGroup.groupId || effectiveGroup.id, name: effectiveGroup.name }]
+            : undefined;
+        yield vortexClient.createInvite(effectiveJwt, widgetConfiguration.id, payload, 'other', groups, undefined, metadata || undefined);
+        console.log('[Vortex] Internal ID invitation created successfully');
+    });
     const handleSmsShare = () => __awaiter(this, void 0, void 0, function* () {
         var _a, _b, _c;
         try {
@@ -194,7 +437,7 @@ function useVortexInvite({ widgetId, environmentId, vortexApiUrl, contentTokens,
             const shareableLink = yield getShareableInviteLink();
             if (!shareableLink)
                 throw new Error('No shareable link available');
-            const body = encodeURIComponent(template.replace(/{{vortex-share-link}}/g, shareableLink));
+            const body = encodeURIComponent(template.replace(/{{vortex_share_link}}/g, shareableLink));
             const smsUrl = `sms:?body=${body}`;
             yield react_native_1.Linking.openURL(smsUrl);
         }
@@ -214,7 +457,7 @@ function useVortexInvite({ widgetId, environmentId, vortexApiUrl, contentTokens,
             const shareableLink = yield getShareableInviteLink();
             if (!shareableLink)
                 throw new Error('No shareable link available');
-            const body = encodeURIComponent(template.replace(/{{vortex-share-link}}/g, shareableLink));
+            const body = encodeURIComponent(template.replace(/{{vortex_share_link}}/g, shareableLink));
             const mailtoUrl = `mailto:?subject=${encodeURIComponent(subject)}&body=${body}`;
             yield react_native_1.Linking.openURL(mailtoUrl);
         }
@@ -224,18 +467,44 @@ function useVortexInvite({ widgetId, environmentId, vortexApiUrl, contentTokens,
                 onError(error instanceof Error ? error : new Error(String(error)), 'share');
         }
     });
+    const handleWhatsAppShare = () => __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c;
+        try {
+            const template = (_c = (_b = (_a = widgetConfiguration === null || widgetConfiguration === void 0 ? void 0 : widgetConfiguration.configuration) === null || _a === void 0 ? void 0 : _a.props) === null || _b === void 0 ? void 0 : _b['vortex.components.share.template.body']) === null || _c === void 0 ? void 0 : _c.value;
+            if (!template)
+                throw new Error('No template available');
+            const shareableLink = yield getShareableInviteLink();
+            if (!shareableLink)
+                throw new Error('No shareable link available');
+            const message = encodeURIComponent(template.replace(/{{vortex_share_link}}/g, shareableLink));
+            const whatsappUrl = `whatsapp://send?text=${message}`;
+            yield react_native_1.Linking.openURL(whatsappUrl).catch(() => {
+                console.warn('WhatsApp not installed');
+            });
+        }
+        catch (error) {
+            console.error('[Vortex] Failed to open WhatsApp:', error);
+            if (onError)
+                onError(error instanceof Error ? error : new Error(String(error)), 'share');
+        }
+    });
     const getShareableInviteLink = (contentTokens) => __awaiter(this, void 0, void 0, function* () {
         // if (this.isLoading || !this.vortex) {
         //   return;
         // }
-        if (!jwt || !(widgetConfiguration === null || widgetConfiguration === void 0 ? void 0 : widgetConfiguration.id) || !vortexClient) {
+        if (!effectiveJwt || !(widgetConfiguration === null || widgetConfiguration === void 0 ? void 0 : widgetConfiguration.id) || !vortexClient) {
             return;
         }
         if (shareableLink) {
             return shareableLink;
         }
-        const invite = yield vortexClient.createShareableInvite(jwt, widgetConfiguration.id, environmentId);
-        if (!invite || !invite.data || !invite.data.invitation.id) {
+        // Use groups parameter for shareable invite as well
+        const groups = effectiveGroup ? [{ type: effectiveGroup.type, id: effectiveGroup.groupId || effectiveGroup.id, name: effectiveGroup.name }] : undefined;
+        const invite = yield vortexClient.createShareableInvite(effectiveJwt, widgetConfiguration.id, groups);
+        if (!invite ||
+            !invite.data ||
+            !invite.data.invitation.id ||
+            !invite.data.invitation.shortLink) {
             console.error('No shareable link found');
             onError === null || onError === void 0 ? void 0 : onError(new Error('No shareable link found'), 'share');
             // this.error = {
@@ -244,43 +513,86 @@ function useVortexInvite({ widgetId, environmentId, vortexApiUrl, contentTokens,
             // this.host.requestUpdate();
             return;
         }
-        const link = `${vortexApiUrl}/noauth/invite/${invite.data.invitation.id}`;
-        console.log(`getShareableInviteLink: ${link}`);
-        setShareableLink(link); // TODO - need to differentiate invite host vs api host even though they are the same for now)
+        const link = invite.data.invitation.shortLink;
+        setShareableLink(link);
         return link;
     });
     const handleShareLink = () => __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d, _e, _f, _g;
         try {
-            const shareableLink = yield getShareableInviteLink(contentTokens);
-            if (!shareableLink) {
+            const link = yield getShareableInviteLink();
+            if (!link) {
                 throw new Error('No shareable link available');
             }
-            yield react_native_1.Share.share({
-                message: shareableLink,
-                title: 'Share Invite Link',
+            const template = (_c = (_b = (_a = widgetConfiguration === null || widgetConfiguration === void 0 ? void 0 : widgetConfiguration.configuration) === null || _a === void 0 ? void 0 : _a.props) === null || _b === void 0 ? void 0 : _b['vortex.components.share.template.body']) === null || _c === void 0 ? void 0 : _c.value;
+            const subject = (_g = (_f = (_e = (_d = widgetConfiguration === null || widgetConfiguration === void 0 ? void 0 : widgetConfiguration.configuration) === null || _d === void 0 ? void 0 : _d.props) === null || _e === void 0 ? void 0 : _e['vortex.components.share.template.subject']) === null || _f === void 0 ? void 0 : _f.value) === null || _g === void 0 ? void 0 : _g.trim();
+            // Compose message
+            let message = '';
+            if (typeof template === 'string' && template.length > 0) {
+                if (template.includes('{{vortex_share_link}}')) {
+                    message = template.replace(/{{vortex_share_link}}/g, link);
+                }
+                else {
+                    message = `${template}${template.endsWith(' ') ? '' : ' '}${link}`;
+                }
+            }
+            else {
+                message = link;
+            }
+            // Informative log about iOS share sheet branding
+            if (react_native_1.Platform.OS === 'ios') {
+                console.log('[Vortex] iOS share sheet branding note: The icon/name come from the host app bundle; link preview (if any) is pulled from the shared URL\'s Open Graph/Twitter meta tags. Customizing the header/logo via RN Share is not supported.');
+            }
+            const content = Object.assign({ message, url: link, title: subject || 'Share Invite Link' }, (subject ? { subject } : {}));
+            const options = react_native_1.Platform.select({
+                android: {
+                    dialogTitle: subject || 'Share Invite Link',
+                },
+                ios: Object.assign({}, (subject ? { subject } : {})),
+                default: {},
             });
+            yield react_native_1.Share.share(content, options);
             console.log('[Vortex] handleShareLink', 'The invite link has been shared.');
-            if (onSuccess) {
-                onSuccess({
-                    type: 'share',
-                    data: 'Sharable link used',
-                });
-            }
+            onSuccess === null || onSuccess === void 0 ? void 0 : onSuccess({ type: 'share', data: 'Sharable link used' });
         }
         catch (error) {
             console.error('[Vortex] Failed to share link:', error);
-            if (onError) {
-                onError(error instanceof Error ? error : new Error(String(error)), 'share');
-            }
+            onError === null || onError === void 0 ? void 0 : onError(error instanceof Error ? error : new Error(String(error)), 'share');
         }
     });
     const handleCopyLink = () => __awaiter(this, void 0, void 0, function* () {
+        var _a;
         try {
             const shareableLink = yield getShareableInviteLink();
             if (!shareableLink) {
                 throw new Error('No shareable link available');
             }
-            yield Clipboard_1.Clipboard.setString(shareableLink);
+            // Try expo-clipboard first, then @react-native-clipboard/clipboard, then web clipboard
+            let copied = false;
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-var-requires
+                const expoClipboard = require('expo-clipboard');
+                yield expoClipboard.setStringAsync(shareableLink);
+                copied = true;
+            }
+            catch (e) {
+                try {
+                    // eslint-disable-next-line @typescript-eslint/no-var-requires
+                    const rnClipboard = require('@react-native-clipboard/clipboard');
+                    rnClipboard.default.setString(shareableLink);
+                    copied = true;
+                }
+                catch (e2) {
+                    // Fall back to web clipboard API
+                    if (typeof navigator !== 'undefined' && ((_a = navigator.clipboard) === null || _a === void 0 ? void 0 : _a.writeText)) {
+                        yield navigator.clipboard.writeText(shareableLink);
+                        copied = true;
+                    }
+                }
+            }
+            if (!copied) {
+                throw new Error('No clipboard implementation available');
+            }
             console.log('[Vortex] handleCopyLink', 'The invite link has been copied.');
             if (onSuccess) {
                 onSuccess({
@@ -296,6 +608,87 @@ function useVortexInvite({ widgetId, environmentId, vortexApiUrl, contentTokens,
             }
         }
     });
+    // Contacts import: dynamically use expo-contacts when available (iOS & Android)
+    const fetchContactsWithEmailsIOS = () => __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d, _e, _f, _g;
+        try {
+            let Contacts = null;
+            try {
+                // Dynamic require so the library does not hard depend on expo-contacts
+                // eslint-disable-next-line @typescript-eslint/no-var-requires
+                Contacts = require('expo-contacts');
+            }
+            catch (e) {
+                throw new Error('Contacts feature is not available. Please ensure expo-contacts is installed.');
+            }
+            // First check current permission status
+            let currentStatus;
+            try {
+                const currentPerm = yield (Contacts.getPermissionsAsync
+                    ? Contacts.getPermissionsAsync()
+                    : (_a = Contacts.getPermissionAsync) === null || _a === void 0 ? void 0 : _a.call(Contacts));
+                currentStatus = currentPerm === null || currentPerm === void 0 ? void 0 : currentPerm.status;
+            }
+            catch (permErr) {
+                console.warn('[Vortex] Failed to check contacts permission:', permErr);
+            }
+            // If already denied, inform user they need to go to Settings
+            if (currentStatus === 'denied') {
+                throw new Error('Contacts access was denied. Please enable Contacts access in your device Settings to import contacts.');
+            }
+            // Request permission (either undetermined or checking again)
+            let status;
+            try {
+                const perm = yield (Contacts.requestPermissionsAsync
+                    ? Contacts.requestPermissionsAsync()
+                    : (_b = Contacts.requestPermissionAsync) === null || _b === void 0 ? void 0 : _b.call(Contacts));
+                status = perm === null || perm === void 0 ? void 0 : perm.status;
+            }
+            catch (permErr) {
+                console.warn('[Vortex] Contacts permission request failed:', permErr);
+                throw new Error('Failed to request contacts permission. Please try again.');
+            }
+            if (status === 'denied') {
+                throw new Error('Contacts access was denied. Please enable Contacts access in your device Settings to import contacts.');
+            }
+            if (status !== 'granted') {
+                throw new Error('Contacts access is required to import contacts.');
+            }
+            // Fetch contacts with emails and images
+            const fields = Contacts.Fields
+                ? [Contacts.Fields.Emails, Contacts.Fields.Image]
+                : ['emails', 'image'];
+            const args = { fields, pageSize: 500 };
+            if ((_c = Contacts.SortTypes) === null || _c === void 0 ? void 0 : _c.FirstName) {
+                args.sort = Contacts.SortTypes.FirstName;
+            }
+            const result = yield Contacts.getContactsAsync(args);
+            const data = (result === null || result === void 0 ? void 0 : result.data) || [];
+            if (!Array.isArray(data) || data.length === 0) {
+                return [];
+            }
+            const normalizeEmail = (e) => (e === null || e === void 0 ? void 0 : e.email) || (e === null || e === void 0 ? void 0 : e.address) || (typeof e === 'string' ? e : undefined);
+            const items = [];
+            for (const c of data) {
+                const emailsSrc = ((c === null || c === void 0 ? void 0 : c.emails) || (c === null || c === void 0 ? void 0 : c.emailAddresses) || []);
+                const emails = emailsSrc.map(normalizeEmail).filter(Boolean);
+                if (emails.length > 0) {
+                    const name = ((_d = ((c === null || c === void 0 ? void 0 : c.name) || `${(c === null || c === void 0 ? void 0 : c.firstName) || ''} ${(c === null || c === void 0 ? void 0 : c.lastName) || ''}`)) === null || _d === void 0 ? void 0 : _d.trim()) || 'Unknown';
+                    const imageUri = ((_e = c === null || c === void 0 ? void 0 : c.image) === null || _e === void 0 ? void 0 : _e.uri) || (c === null || c === void 0 ? void 0 : c.imageAvailable) ? (_f = c === null || c === void 0 ? void 0 : c.image) === null || _f === void 0 ? void 0 : _f.uri : undefined;
+                    items.push({ id: String((_g = c === null || c === void 0 ? void 0 : c.id) !== null && _g !== void 0 ? _g : Math.random()), name, emails, imageUri });
+                }
+            }
+            return items;
+        }
+        catch (err) {
+            // Re-throw errors with messages so UI can display them properly
+            if (err instanceof Error) {
+                throw err;
+            }
+            console.error('[Vortex] Failed to fetch contacts:', err);
+            throw new Error('An unexpected error occurred while accessing contacts.');
+        }
+    });
     return {
         widgetConfiguration,
         error,
@@ -303,6 +696,9 @@ function useVortexInvite({ widgetId, environmentId, vortexApiUrl, contentTokens,
         loading,
         email,
         setEmail,
+        role,
+        setRole,
+        roleOptions,
         opacity,
         themeColors,
         themeStyles,
@@ -315,7 +711,22 @@ function useVortexInvite({ widgetId, environmentId, vortexApiUrl, contentTokens,
         handleCopyLink,
         handleSmsShare,
         handleEmailShare,
+        handleWhatsAppShare,
         getShareableLink,
+        getShareableInviteLink,
+        createUserIdInvitation,
         formLayout,
+        fetchContactsWithEmailsIOS,
+        // Analytics tracking functions
+        trackWidgetRender,
+        trackWidgetError,
+        trackShareLinkClick,
+        trackEmailFieldFocus,
+        trackEmailFieldBlur,
+        trackEmailValidation,
+        trackEmailInvitationsSubmitted,
+        trackEmailValidationError,
+        trackEmailSubmitError,
     };
 }
+//# sourceMappingURL=useVortexInvite.js.map