@teamvortexsoftware/vortex-react-native 1.0.0 → 1.0.1

package/dist/types/types/unfurlConfig.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Configuration for Open Graph unfurl metadata.
+ * Used to customize link previews when sharing invitation links.
+ *
+ * @example
+ * ```tsx
+ * <VortexInvite
+ *   componentId="abc123"
+ *   unfurlConfig={{
+ *     title: "Join our team!",
+ *     description: "You've been invited to collaborate",
+ *     image: "https://example.com/preview.png",
+ *     siteName: "My App",
+ *   }}
+ * />
+ * ```
+ */
+export interface UnfurlConfig {
+    /** The title for the link preview (og:title) */
+    title?: string;
+    /** The description for the link preview (og:description) */
+    description?: string;
+    /** URL to an image for the link preview (og:image) */
+    image?: string;
+    /** The site name for the link preview (og:site_name) */
+    siteName?: string;
+    /** The type of content (og:type), defaults to "website" */
+    type?: string;
+}
+/**
+ * Converts UnfurlConfig to the metadata format expected by the API.
+ */
+export declare function unfurlConfigToMetadata(config: UnfurlConfig): Record<string, string>;
+//# sourceMappingURL=unfurlConfig.d.ts.map

package/dist/types/types/unfurlConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unfurlConfig.d.ts","sourceRoot":"","sources":["../../../src/types/unfurlConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQnF"}

package/dist/types/unfurlConfig.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unfurlConfigToMetadata = unfurlConfigToMetadata;
+/**
+ * Converts UnfurlConfig to the metadata format expected by the API.
+ */
+function unfurlConfigToMetadata(config) {
+    const metadata = {};
+    if (config.title)
+        metadata['og:title'] = config.title;
+    if (config.description)
+        metadata['og:description'] = config.description;
+    if (config.image)
+        metadata['og:image'] = config.image;
+    if (config.siteName)
+        metadata['og:site_name'] = config.siteName;
+    if (config.type)
+        metadata['og:type'] = config.type;
+    return metadata;
+}
+//# sourceMappingURL=unfurlConfig.js.map

package/dist/types/unfurlConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unfurlConfig.js","sourceRoot":"","sources":["../../src/types/unfurlConfig.ts"],"names":[],"mappings":";;AAiCA,wDAQC;AAXD;;GAEG;AACH,SAAgB,sBAAsB,CAAC,MAAoB;IACzD,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAC5C,IAAI,MAAM,CAAC,KAAK;QAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC;IACtD,IAAI,MAAM,CAAC,WAAW;QAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC;IACxE,IAAI,MAAM,CAAC,KAAK;QAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC;IACtD,IAAI,MAAM,CAAC,QAAQ;QAAE,QAAQ,CAAC,cAAc,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC;IAChE,IAAI,MAAM,CAAC,IAAI;QAAE,QAAQ,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC;IACnD,OAAO,QAAQ,CAAC;AAClB,CAAC","sourcesContent":["/**\n * Configuration for Open Graph unfurl metadata.\n * Used to customize link previews when sharing invitation links.\n *\n * @example\n * ```tsx\n * <VortexInvite\n *   componentId=\"abc123\"\n *   unfurlConfig={{\n *     title: \"Join our team!\",\n *     description: \"You've been invited to collaborate\",\n *     image: \"https://example.com/preview.png\",\n *     siteName: \"My App\",\n *   }}\n * />\n * ```\n */\nexport interface UnfurlConfig {\n  /** The title for the link preview (og:title) */\n  title?: string;\n  /** The description for the link preview (og:description) */\n  description?: string;\n  /** URL to an image for the link preview (og:image) */\n  image?: string;\n  /** The site name for the link preview (og:site_name) */\n  siteName?: string;\n  /** The type of content (og:type), defaults to \"website\" */\n  type?: string;\n}\n\n/**\n * Converts UnfurlConfig to the metadata format expected by the API.\n */\nexport function unfurlConfigToMetadata(config: UnfurlConfig): Record<string, string> {\n  const metadata: Record<string, string> = {};\n  if (config.title) metadata['og:title'] = config.title;\n  if (config.description) metadata['og:description'] = config.description;\n  if (config.image) metadata['og:image'] = config.image;\n  if (config.siteName) metadata['og:site_name'] = config.siteName;\n  if (config.type) metadata['og:type'] = config.type;\n  return metadata;\n}\n"]}

package/dist/types/utils/analytics.d.ts

@@ -0,0 +1,54 @@
+import type { EventName } from '@teamvortexsoftware/analytics-client';
+export declare const DEFAULT_ANALYTICS_URL = "https://collector.vortexsoftware.com";
+/**
+ * Analytics event interface for React Native SDK
+ * Based on AnalyticsEvent from analytics-client with additional mobile-specific fields
+ */
+export interface VortexAnalyticsEvent {
+    name: EventName;
+    widgetConfigurationId: string;
+    deploymentId: string;
+    environmentId: string;
+    platform: string;
+    segmentation?: Record<string, any>;
+    payload?: Record<string, any>;
+    groups?: Array<{
+        type: string;
+        id: string;
+        name: string;
+    }>;
+    timestamp: number;
+    sessionId?: string;
+    useragent?: string;
+    foreignUserId?: string;
+}
+/**
+ * Simplified analytics event for components that emit minimal events.
+ * These components emit (name + segmentation) and the parent
+ * is responsible for enriching with widgetConfigurationId, deploymentId, etc.
+ */
+export interface SimpleAnalyticsEvent {
+    name: EventName;
+    segmentation?: Record<string, any>;
+    payload?: Record<string, any>;
+}
+/**
+ * Group DTO for analytics events
+ */
+export interface GroupDTO {
+    type: string;
+    id: string;
+    name: string;
+}
+/**
+ * Generates a device info / user agent string for analytics
+ * Format: VortexSDK-RN/{version} ({OS} {osVersion})
+ */
+export declare function getDeviceInfo(): string;
+/**
+ * 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)
+ */
+export declare function extractForeignUserId(jwt?: string): string | undefined;
+//# sourceMappingURL=analytics.d.ts.map

package/dist/types/utils/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../../src/utils/analytics.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AAMtE,eAAO,MAAM,qBAAqB,yCAAyC,CAAC;AAE5E;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IAEnC,IAAI,EAAE,SAAS,CAAC;IAChB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,MAAM,CAAC,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IAEH,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,SAAS,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAKtC;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA+BrE"}

package/dist/types/utils/configCache.d.ts

@@ -0,0 +1,34 @@
+import { WidgetConfiguration } from '@teamvortexsoftware/vortex-types';
+export declare const 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: string) => WidgetConfiguration | undefined;
+    /**
+     * Store a widget configuration in the cache.
+     * @param componentId - The widget component ID
+     * @param config - The widget configuration to cache
+     */
+    set: (componentId: string, config: WidgetConfiguration) => void;
+    /**
+     * Clear cached configuration(s).
+     * @param componentId - Optional component ID to clear specific config. If omitted, clears all.
+     */
+    clear: (componentId?: string) => void;
+    /**
+     * Check if a configuration exists in the cache.
+     * @param componentId - The widget component ID
+     * @returns True if configuration is cached, false otherwise
+     */
+    has: (componentId: string) => boolean;
+    /**
+     * Get cache statistics for debugging.
+     */
+    stats: () => {
+        size: number;
+        keys: string[];
+    };
+};
+//# sourceMappingURL=configCache.d.ts.map

package/dist/types/utils/configCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configCache.d.ts","sourceRoot":"","sources":["../../../src/utils/configCache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAevE,eAAO,MAAM,WAAW;IACtB;;;;OAIG;uBACgB,MAAM,KAAG,mBAAmB,GAAG,SAAS;IAI3D;;;;OAIG;uBACgB,MAAM,UAAU,mBAAmB,KAAG,IAAI;IAS7D;;;OAGG;0BACmB,MAAM,KAAG,IAAI;IAUnC;;;;OAIG;uBACgB,MAAM,KAAG,OAAO;IAInC;;OAEG;;;;;CAKJ,CAAC"}

package/dist/types/utils/contactUtils.d.ts

@@ -0,0 +1,9 @@
+import type { Contact } from '../hooks/useInvitationFormLogic';
+/**
+ * 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
+ */
+export declare function filterContacts(contacts: Contact[], searchQuery: string): Contact[];
+//# sourceMappingURL=contactUtils.d.ts.map

package/dist/types/utils/contactUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contactUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/contactUtils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAE/D;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,EAAE,CAQlF"}

package/dist/types/utils/featureWarnings.d.ts

@@ -0,0 +1,56 @@
+/**
+ * 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.
+ */
+import type { VortexModulesConfig } from '../context/VortexModulesContext';
+/**
+ * Features that may be required based on widget configuration
+ */
+export interface FeatureRequirements {
+    needsGradient: boolean;
+    needsQRCode: boolean;
+    needsHaptics: boolean;
+    needsClipboard: boolean;
+}
+/**
+ * Detects which features are required based on widget configuration.
+ *
+ * @param widgetConfiguration - The widget configuration from the API
+ * @returns Object indicating which features are needed
+ */
+export declare function detectRequiredFeatures(widgetConfiguration: any): FeatureRequirements;
+/**
+ * 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
+ */
+export declare function printFeatureWarnings(requirements: FeatureRequirements, moduleConfig: VortexModulesConfig): void;
+/**
+ * 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
+ */
+export declare function printWarningOnce(key: string, message: string): void;
+/**
+ * Prints an info message only once per session.
+ *
+ * @param key - Unique key for this message
+ * @param message - The info message to print
+ */
+export declare function printInfoOnce(key: string, message: string): void;
+/**
+ * Clears the printed warnings cache.
+ * Useful for testing or when you want warnings to be printed again.
+ */
+export declare function clearWarningsCache(): void;
+//# sourceMappingURL=featureWarnings.d.ts.map

package/dist/types/utils/featureWarnings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"featureWarnings.d.ts","sourceRoot":"","sources":["../../../src/utils/featureWarnings.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;IACtB,cAAc,EAAE,OAAO,CAAC;CACzB;AAsED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,mBAAmB,EAAE,GAAG,GAAG,mBAAmB,CAkBpF;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,mBAAmB,EACjC,YAAY,EAAE,mBAAmB,GAChC,IAAI,CAkFN;AAOD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAKnE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAKhE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}

package/dist/types/utils/formUtils.d.ts

@@ -0,0 +1,93 @@
+import { WidgetConfiguration } from '@teamvortexsoftware/vortex-types';
+import { ThemeColors } from './themeUtils';
+export interface FormComponentStyle {
+    [key: string]: {
+        label?: string;
+        value?: string | number;
+        computedValue?: string;
+        unit?: string;
+    };
+}
+export interface FormComponentSettings {
+    action?: {
+        type: string;
+        value: string;
+        target?: string;
+    };
+    size?: number;
+}
+export interface FormComponent {
+    id: string;
+    type: string;
+    subtype?: string;
+    label?: string;
+    hint?: string;
+    name?: string;
+    required?: boolean;
+    placeholder?: string;
+    style?: FormComponentStyle;
+    settings?: FormComponentSettings;
+    vortex?: {
+        role?: string;
+        canRemove?: boolean;
+    };
+    children?: FormComponent[];
+    multiValue?: boolean;
+    validation?: Array<{
+        type: string;
+        value: string;
+        operator: string;
+        canRemove: boolean;
+        errorMessage: string;
+    }>;
+    tagName?: string;
+    textContent?: string;
+    attributes?: {
+        [key: string]: string;
+    };
+}
+export interface FormConfiguration {
+    value: FormComponent[];
+    valueType: string;
+}
+/**
+ * Extracts the form configuration from the widget configuration
+ */
+export declare function extractFormConfiguration(widgetConfiguration?: WidgetConfiguration): FormComponent[] | null;
+/**
+ * Converts form component style object to React Native styles
+ */
+export declare function convertFormStyleToRNStyle(style?: FormComponentStyle | Record<string, any>): Record<string, string | number>;
+/**
+ * Find a specific component by role in the form configuration
+ */
+export declare function findComponentByRole(formConfig: FormComponent[] | null, role: string): FormComponent | null;
+/**
+ * Merges theme styles with component-specific styles from form configuration
+ */
+export declare function mergeThemeAndComponentStyles(themeStyles: Record<string, Record<string, string | number>>, themeColors: ThemeColors, formConfig: FormComponent[] | null): Record<string, Record<string, string | number>>;
+/**
+ * Get email input placeholder from form configuration
+ */
+export declare function getEmailPlaceholder(formConfig: FormComponent[] | null): string;
+/**
+ * Get submit button label from form configuration
+ */
+export declare function getSubmitButtonLabel(formConfig: FormComponent[] | null): string;
+/**
+ * Determines if the form layout uses a grid structure
+ */
+export declare function hasGridLayout(formConfig: FormComponent[] | null): boolean;
+/**
+ * Determines if email and share components are in separate grid items
+ */
+export declare function hasEmailAndShareInSeparateColumns(formConfig: FormComponent[] | null): boolean;
+/**
+ * Extract role options from form configuration (e.g., vrtx-select with attributes.name === 'role')
+ */
+export declare function getRoleOptions(formConfig: FormComponent[] | null): Array<{
+    id?: string;
+    label: string;
+    value: string;
+}>;
+//# sourceMappingURL=formUtils.d.ts.map

package/dist/types/utils/formUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/formUtils.ts"],"names":[],"mappings":"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"}

package/dist/types/utils/gradientUtils.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Gradient Parsing Utilities
+ *
+ * Pure JavaScript utilities for parsing CSS gradients.
+ * These are shared between native (moduleLoaders.ts) and web (moduleLoaders.web.ts)
+ * implementations to avoid code duplication.
+ *
+ * These utilities have NO native dependencies and are safe to import from anywhere.
+ */
+/**
+ * Parsed gradient data structure
+ */
+export interface ParsedGradient {
+    type: 'linear';
+    angle: number;
+    colors: string[];
+    locations: number[];
+}
+/**
+ * Gradient points for LinearGradient component
+ */
+export interface GradientPoints {
+    start: {
+        x: number;
+        y: number;
+    };
+    end: {
+        x: number;
+        y: number;
+    };
+}
+/**
+ * Parses a CSS linear-gradient string into a structured format.
+ *
+ * Supports formats like:
+ * - "linear-gradient(90deg, #ff0000 0%, #0000ff 100%)"
+ * - "linear-gradient(to right, #ff0000 0%, #0000ff 100%)"
+ * - "linear-gradient(135deg, rgba(255,0,0,1) 0%, rgba(0,0,255,1) 100%)"
+ *
+ * @param css - CSS linear-gradient string
+ * @returns Parsed gradient data or null if parsing fails
+ */
+export declare function parseCSSLinearGradient(css: string): ParsedGradient | null;
+/**
+ * Converts a CSS gradient angle to start/end points for LinearGradient component.
+ *
+ * CSS gradient angles:
+ * - 0deg = bottom to top
+ * - 90deg = left to right
+ * - 180deg = top to bottom
+ * - 270deg = right to left
+ *
+ * LinearGradient uses normalized coordinates (0-1) for start/end points.
+ *
+ * @param angle - CSS gradient angle in degrees
+ * @returns Start and end points for LinearGradient
+ */
+export declare function angleToGradientPoints(angle: number): GradientPoints;
+/**
+ * Extracts the first color from a CSS gradient string.
+ * Used as a fallback when gradient libraries are not available.
+ *
+ * @param gradientString - CSS linear-gradient string
+ * @returns First color from the gradient or null
+ */
+export declare function parseGradientFirstColor(gradientString: string): string | null;
+//# sourceMappingURL=gradientUtils.d.ts.map

package/dist/types/utils/gradientUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gradientUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/gradientUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,GAAG,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAuDzE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAWnE;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgB7E"}

package/dist/types/utils/invitationEvents.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Simple event emitter for invitation-related events.
+ * Used to notify components (like VrtxOutgoingInvitations) when invitations are created
+ * so they can refresh their data.
+ */
+type InvitationEventType = 'invitationCreated' | 'invitationRevoked' | 'invitationAccepted' | 'invitationDeleted';
+type InvitationEventListener = () => void;
+/**
+ * Subscribe to an invitation event.
+ * @param event The event type to listen for
+ * @param listener The callback to invoke when the event is emitted
+ * @returns A function to unsubscribe
+ */
+export declare function subscribeToInvitationEvent(event: InvitationEventType, listener: InvitationEventListener): () => void;
+/**
+ * Emit an invitation event to notify all subscribers.
+ * @param event The event type to emit
+ */
+export declare function emitInvitationEvent(event: InvitationEventType): void;
+export {};
+//# sourceMappingURL=invitationEvents.d.ts.map

package/dist/types/utils/invitationEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invitationEvents.d.ts","sourceRoot":"","sources":["../../../src/utils/invitationEvents.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,KAAK,mBAAmB,GAAG,mBAAmB,GAAG,mBAAmB,GAAG,oBAAoB,GAAG,mBAAmB,CAAC;AAElH,KAAK,uBAAuB,GAAG,MAAM,IAAI,CAAC;AAI1C;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,mBAAmB,EAC1B,QAAQ,EAAE,uBAAuB,GAChC,MAAM,IAAI,CAUZ;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAWpE"}

package/dist/types/utils/moduleLoaders.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Module Loaders
+ *
+ * This module provides explicit module loading for optional dependencies.
+ * Instead of auto-detecting which libraries are installed (which causes Metro bundler issues),
+ * users explicitly specify which module they want to use via props.
+ *
+ * This approach:
+ * - Avoids Metro static analysis issues with optional dependencies
+ * - Gives users explicit control over which libraries to use
+ * - Provides clear error messages when a module is specified but not installed
+ * - Only requires the module that the user explicitly specifies
+ */
+import type { ComponentType } from 'react';
+import type { GradientModuleName, HapticsModuleName, QRCodeModuleName, ClipboardModuleName } from '../context/VortexModulesContext';
+/**
+ * Props for gradient components (compatible with both expo and react-native-linear-gradient)
+ */
+export interface GradientProps {
+    colors: string[];
+    locations?: number[];
+    start?: {
+        x: number;
+        y: number;
+    };
+    end?: {
+        x: number;
+        y: number;
+    };
+    style?: any;
+    children?: React.ReactNode;
+}
+/**
+ * Props for QR code components
+ */
+export interface QRCodeProps {
+    value: string;
+    size?: number;
+    color?: string;
+    backgroundColor?: string;
+    style?: any;
+}
+/**
+ * Haptic feedback style
+ */
+export type HapticStyle = 'light' | 'medium' | 'heavy';
+/**
+ * Loads the gradient component based on the specified module name.
+ *
+ * @param moduleName - The gradient module to load ('expo-linear-gradient' or 'react-native-linear-gradient')
+ * @returns The gradient component or null if not available
+ *
+ * @example
+ * ```tsx
+ * const GradientComponent = loadGradientComponent('expo-linear-gradient');
+ * if (GradientComponent) {
+ *   return <GradientComponent colors={['#ff0000', '#0000ff']} style={styles.button} />;
+ * }
+ * ```
+ */
+export declare function loadGradientComponent(moduleName: GradientModuleName | undefined): ComponentType<GradientProps> | null;
+/**
+ * Creates a haptic feedback trigger function based on the specified module.
+ *
+ * @param moduleName - The haptics module to use ('expo-haptics')
+ * @returns A function to trigger haptic feedback, or null if not available
+ *
+ * @example
+ * ```tsx
+ * const triggerHaptic = loadHapticsTrigger('expo-haptics');
+ * if (triggerHaptic) {
+ *   await triggerHaptic('light');
+ * }
+ * ```
+ */
+export declare function loadHapticsTrigger(moduleName: HapticsModuleName | undefined): ((style: HapticStyle) => Promise<void>) | null;
+/**
+ * Loads the QR code component based on the specified module name.
+ *
+ * @param moduleName - The QR code module to load ('react-native-qrcode-svg' or 'react-qr-code')
+ * @returns The QR code component or null if not available
+ *
+ * @example
+ * ```tsx
+ * const QRCodeComponent = loadQRCodeComponent('react-native-qrcode-svg');
+ * if (QRCodeComponent) {
+ *   return <QRCodeComponent value="https://example.com" size={200} />;
+ * }
+ * ```
+ */
+export declare function loadQRCodeComponent(moduleName: QRCodeModuleName | undefined): ComponentType<QRCodeProps> | null;
+/**
+ * Clipboard operations interface
+ */
+export interface ClipboardOperations {
+    setString: (text: string) => Promise<void>;
+    getString: () => Promise<string>;
+}
+/**
+ * Loads clipboard operations based on the specified module.
+ *
+ * @param moduleName - The clipboard module to use ('expo-clipboard' or '@react-native-clipboard/clipboard')
+ * @returns Clipboard operations object or null if not available
+ *
+ * @example
+ * ```tsx
+ * const clipboard = loadClipboardOperations('expo-clipboard');
+ * if (clipboard) {
+ *   await clipboard.setString('Hello, world!');
+ * }
+ * ```
+ */
+export declare function loadClipboardOperations(moduleName: ClipboardModuleName | undefined): ClipboardOperations | null;
+export { parseCSSLinearGradient, angleToGradientPoints, parseGradientFirstColor, type ParsedGradient, type GradientPoints, } from './gradientUtils';
+//# sourceMappingURL=moduleLoaders.d.ts.map

package/dist/types/utils/moduleLoaders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moduleLoaders.d.ts","sourceRoot":"","sources":["../../../src/utils/moduleLoaders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,iCAAiC,CAAC;AAMzC;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,GAAG,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,GAAG,CAAC;CACb;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAgGvD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,kBAAkB,GAAG,SAAS,GACzC,aAAa,CAAC,aAAa,CAAC,GAAG,IAAI,CAwBrC;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,iBAAiB,GAAG,SAAS,GACxC,CAAC,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CA6BhD;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,gBAAgB,GAAG,SAAS,GACvC,aAAa,CAAC,WAAW,CAAC,GAAG,IAAI,CAanC;AAMD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,SAAS,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CAClC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,mBAAmB,GAAG,SAAS,GAC1C,mBAAmB,GAAG,IAAI,CAgC5B;AAQD,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,KAAK,cAAc,EACnB,KAAK,cAAc,GACpB,MAAM,iBAAiB,CAAC"}

package/dist/types/utils/moduleLoaders.web.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Web-Safe Module Loaders
+ *
+ * This module provides stub implementations for web environments.
+ * On web, we use CSS gradients directly, browser clipboard APIs, etc.
+ * All loader functions return null, and components use CSS/browser fallbacks.
+ *
+ * This file is used by InviteFormWeb (web entry point) to avoid
+ * importing native modules that would cause Next.js/webpack build errors.
+ */
+import type { ComponentType } from 'react';
+import type { GradientModuleName, HapticsModuleName, QRCodeModuleName, ClipboardModuleName } from '../context/VortexModulesContext';
+/**
+ * Props for gradient components
+ */
+export interface GradientProps {
+    colors: string[];
+    locations?: number[];
+    start?: {
+        x: number;
+        y: number;
+    };
+    end?: {
+        x: number;
+        y: number;
+    };
+    style?: any;
+    children?: React.ReactNode;
+}
+/**
+ * Props for QR code components
+ */
+export interface QRCodeProps {
+    value: string;
+    size?: number;
+    color?: string;
+    backgroundColor?: string;
+    style?: any;
+}
+/**
+ * Haptic feedback style
+ */
+export type HapticStyle = 'light' | 'medium' | 'heavy';
+/**
+ * Clipboard operations interface
+ */
+export interface ClipboardOperations {
+    setString: (text: string) => Promise<void>;
+    getString: () => Promise<string>;
+}
+export type { ParsedGradient, GradientPoints } from './gradientUtils';
+/**
+ * Web-safe gradient loader - always returns null.
+ * On web, CSS gradients are used directly via the `background` style property.
+ */
+export declare function loadGradientComponent(_moduleName: GradientModuleName | undefined): ComponentType<GradientProps> | null;
+/**
+ * Web-safe haptics loader - always returns null.
+ * Haptic feedback doesn't make sense on web.
+ */
+export declare function loadHapticsTrigger(_moduleName: HapticsModuleName | undefined): ((style: HapticStyle) => Promise<void>) | null;
+/**
+ * Web-safe QR code loader - returns null for native modules.
+ * For web, react-qr-code can be loaded if needed.
+ */
+export declare function loadQRCodeComponent(moduleName: QRCodeModuleName | undefined): ComponentType<QRCodeProps> | null;
+/**
+ * Web-safe clipboard loader - always returns null.
+ * Web uses navigator.clipboard API directly.
+ */
+export declare function loadClipboardOperations(_moduleName: ClipboardModuleName | undefined): ClipboardOperations | null;
+export { parseCSSLinearGradient, angleToGradientPoints, parseGradientFirstColor, } from './gradientUtils';
+//# sourceMappingURL=moduleLoaders.web.d.ts.map

package/dist/types/utils/moduleLoaders.web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moduleLoaders.web.d.ts","sourceRoot":"","sources":["../../../src/utils/moduleLoaders.web.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,iCAAiC,CAAC;AAMzC;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,GAAG,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,GAAG,CAAC;CACb;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,SAAS,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CAClC;AAGD,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAMtE;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,kBAAkB,GAAG,SAAS,GAC1C,aAAa,CAAC,aAAa,CAAC,GAAG,IAAI,CAGrC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,iBAAiB,GAAG,SAAS,GACzC,CAAC,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAGhD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,gBAAgB,GAAG,SAAS,GACvC,aAAa,CAAC,WAAW,CAAC,GAAG,IAAI,CAYnC;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,mBAAmB,GAAG,SAAS,GAC3C,mBAAmB,GAAG,IAAI,CAG5B;AAQD,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC"}

package/dist/types/utils/nameUtils.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Infers a human-readable name from an email address
+ * Handles common separators like dots, dashes, underscores
+ *
+ * @param email - The email address to extract a name from
+ * @returns A capitalized name or the email if extraction fails
+ *
+ * @example
+ * inferNameFromEmail('john@foo.com') // 'John'
+ * inferNameFromEmail('john.doe@example.com') // 'John Doe'
+ * inferNameFromEmail('mary-jane@test.com') // 'Mary Jane'
+ * inferNameFromEmail('bob_smith123@mail.com') // 'Bob Smith'
+ */
+export declare function inferNameFromEmail(email: string): string;
+//# sourceMappingURL=nameUtils.d.ts.map

package/dist/types/utils/nameUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nameUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/nameUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA0BxD"}