@teamvortexsoftware/vortex-react-native 1.0.0 → 1.0.1

package/dist/types/hooks/usePrefetchWidgetConfiguration.d.ts

@@ -0,0 +1,39 @@
+import { WidgetConfiguration, UnsignedData } from '@teamvortexsoftware/vortex-types';
+export interface UsePrefetchWidgetConfigurationOptions {
+    componentId: string;
+    vortexApiUrl: string;
+    jwt?: string;
+    user?: string | UnsignedData;
+    enabled?: boolean;
+}
+/**
+ * Hook to prefetch widget configuration for instant rendering.
+ * This hook fetches the configuration early (e.g., when JWT becomes available)
+ * so the VortexInvite component can render immediately without showing a loading spinner.
+ *
+ * The hook will still refetch in the background when VortexInvite mounts to ensure
+ * the configuration is up-to-date (stale-while-revalidate pattern).
+ *
+ * @example
+ * ```tsx
+ * const { widgetConfiguration } = usePrefetchWidgetConfiguration({
+ *   componentId: 'your-component-id',
+ *   vortexApiUrl: 'https://client-api.vortexsoftware.com',
+ *   jwt,
+ *   enabled: !!jwt, // Only prefetch when JWT is ready
+ * });
+ *
+ * <VortexInvite
+ *   componentId={componentId}
+ *   jwt={jwt}
+ *   widgetConfiguration={widgetConfiguration} // Pass prefetched config
+ *   // ... other props
+ * />
+ * ```
+ */
+export declare function usePrefetchWidgetConfiguration({ componentId, vortexApiUrl, jwt, user, enabled, }: UsePrefetchWidgetConfigurationOptions): {
+    widgetConfiguration: WidgetConfiguration | undefined;
+    error: Error | null;
+    isLoading: boolean;
+};
+//# sourceMappingURL=usePrefetchWidgetConfiguration.d.ts.map

package/dist/types/hooks/usePrefetchWidgetConfiguration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePrefetchWidgetConfiguration.d.ts","sourceRoot":"","sources":["../../../src/hooks/usePrefetchWidgetConfiguration.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAIrF,MAAM,WAAW,qCAAqC;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,8BAA8B,CAAC,EAC7C,WAAW,EACX,YAAY,EACZ,GAAG,EACH,IAAI,EACJ,OAAc,GACf,EAAE,qCAAqC;;;;EA8EvC"}

package/dist/types/hooks/useThemeStyles.d.ts

@@ -0,0 +1,35 @@
+import { ThemeColors } from "../utils/themeUtils";
+/**
+ * Hook to generate dynamic styles based on theme colors
+ * @param themeColors The theme colors object
+ * @returns Object containing styled components based on the theme
+ */
+export declare function useThemeStyles(themeColors: ThemeColors): {
+    primaryButton: {
+        backgroundColor: string;
+        borderColor: string;
+    };
+    primaryButtonText: {
+        color: string;
+    };
+    secondaryButton: {
+        backgroundColor: string;
+        borderColor: string;
+    };
+    secondaryButtonText: {
+        color: string;
+    };
+    containerStyles: {
+        backgroundColor: string;
+        borderColor: string;
+    };
+    textStyles: {
+        color: string;
+    };
+    inputStyles: {
+        borderColor: string;
+        color: string;
+        backgroundColor: string;
+    };
+};
+//# sourceMappingURL=useThemeStyles.d.ts.map

package/dist/types/hooks/useThemeStyles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useThemeStyles.d.ts","sourceRoot":"","sources":["../../../src/hooks/useThemeStyles.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkCtD"}

package/dist/types/hooks/useVortexInvite.d.ts

@@ -0,0 +1,86 @@
+import { WidgetConfiguration, UnsignedData } from '@teamvortexsoftware/vortex-types';
+import { Animated } from 'react-native';
+import { Attributes, VortexActionResult, VortexActionType } from '../vortexInvite';
+import { VortexAnalyticsEvent, GroupDTO } from '../utils/analytics';
+export interface UseVortexInviteOptions {
+    componentId?: string;
+    vortexApiUrl: string;
+    isLoading?: boolean;
+    jwt?: string;
+    user?: string | UnsignedData | undefined;
+    onSuccess?: (result: VortexActionResult) => void;
+    onError?: (error: Error, type: VortexActionType) => void;
+    group?: {
+        name: string;
+        type: string;
+        id?: string;
+        groupId?: string;
+    };
+    groups?: GroupDTO[];
+    scope?: string;
+    scopeType?: string;
+    widgetConfiguration?: WidgetConfiguration;
+    analyticsBaseURL?: string;
+    onEvent?: (event: VortexAnalyticsEvent) => void;
+    analyticsSegmentation?: Record<string, any>;
+    locale?: string;
+}
+export declare function useVortexInvite({ componentId, vortexApiUrl, isLoading, jwt, user, onSuccess, onError, group, groups, scope, scopeType, widgetConfiguration: initialWidgetConfiguration, analyticsBaseURL, onEvent, analyticsSegmentation, locale, }: UseVortexInviteOptions): {
+    widgetConfiguration: WidgetConfiguration | undefined;
+    error: {
+        message: string;
+        code?: string;
+        userMessage?: string;
+        developerMessage?: string;
+    } | null;
+    fetching: boolean;
+    loading: boolean;
+    email: string;
+    setEmail: import("react").Dispatch<import("react").SetStateAction<string>>;
+    role: string | undefined;
+    setRole: import("react").Dispatch<import("react").SetStateAction<string | undefined>>;
+    roleOptions: {
+        id?: string;
+        label: string;
+        value: string;
+    }[];
+    opacity: Animated.Value;
+    themeColors: import("../utils/themeUtils").ThemeColors;
+    themeStyles: Record<string, Record<string, string | number>>;
+    has: import("../utils/themeUtils").FeatureFlags;
+    options: import("@teamvortexsoftware/vortex-types").WidgetConfigurationConfigurationProps;
+    inviteLoading: boolean;
+    showSuccessMessage: boolean;
+    handleInviteClick: (contentTokens?: Attributes) => Promise<void>;
+    handleShareLink: () => Promise<void>;
+    handleCopyLink: () => Promise<void>;
+    handleSmsShare: () => Promise<void>;
+    handleEmailShare: () => Promise<void>;
+    handleWhatsAppShare: () => Promise<void>;
+    getShareableLink: () => string;
+    getShareableInviteLink: (contentTokens?: Attributes) => Promise<string | undefined>;
+    createUserIdInvitation: (userId: string, name?: string, avatarUrl?: string, metadata?: Record<string, unknown>) => Promise<void>;
+    formLayout: {
+        emailPlaceholder: string;
+        submitButtonLabel: string;
+        isGridLayout: boolean;
+        hasSeparateColumns: boolean;
+        formConfig: import("../utils/formUtils").FormComponent[] | null;
+    };
+    fetchContactsWithEmailsIOS: () => Promise<Array<{
+        id: string;
+        name: string;
+        emails: string[];
+        imageUri?: string;
+    }>>;
+    trackWidgetRender: () => void;
+    trackWidgetError: (errorMessage: string) => void;
+    trackShareLinkClick: (clickName: string) => void;
+    trackEmailFieldFocus: () => void;
+    trackEmailFieldBlur: () => void;
+    trackEmailValidation: (emailValue: string, isValid: boolean) => void;
+    trackEmailInvitationsSubmitted: (formData: Record<string, any>) => void;
+    trackEmailValidationError: (formData: Record<string, any>) => void;
+    trackEmailSubmitError: (errorMessage: string) => void;
+};
+//# sourceMappingURL=useVortexInvite.d.ts.map

package/dist/types/hooks/useVortexInvite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useVortexInvite.d.ts","sourceRoot":"","sources":["../../../src/hooks/useVortexInvite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAErF,OAAO,EAAE,QAAQ,EAA4B,MAAM,cAAc,CAAC;AAGlE,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAcnF,OAAO,EACL,oBAAoB,EACpB,QAAQ,EAIT,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,sBAAsB;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC;IACzC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACjD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACzD,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAE1C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAChD,qBAAqB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE5C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,eAAe,CAAC,EAC9B,WAAW,EACX,YAAY,EACZ,SAAiB,EACjB,GAAG,EACH,IAAI,EACJ,SAAS,EACT,OAAO,EACP,KAAK,EACL,MAAM,EACN,KAAK,EACL,SAAS,EACT,mBAAmB,EAAE,0BAA0B,EAC/C,gBAAgB,EAChB,OAAO,EACP,qBAAqB,EACrB,MAAM,GACP,EAAE,sBAAsB;;;iBAuCuB,MAAM;eAAS,MAAM;sBAAgB,MAAM;2BAAqB,MAAM;;;;;;;;;;;;;;;;;;;;wCAmVnE,UAAU,KAAG,OAAO,CAAC,IAAI,CAAC;;;;;;;6CAoKzD,UAAU,KACzB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;qCAhGpB,MAAM,SACP,MAAM,cACD,MAAM,aACP,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KACjC,OAAO,CAAC,IAAI,CAAC;;;;;;;;sCA+O6B,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;;qCA9iB7G,MAAM;qCAQT,MAAM;;;uCAoBL,MAAM,WAAW,OAAO;+CAQ1B,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;0CAQnB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;0CAQf,MAAM;EAonBxB"}

package/dist/types/index-web.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Web-compatible preview entry point
+ *
+ * This entry point only exports components and utilities that are safe to use
+ * in web environments (Next.js, etc.) without importing any React Native native
+ * dependencies like expo-clipboard, expo-sharing, react-native-vector-icons, etc.
+ *
+ * Use this import in web applications:
+ * import { InviteFormWeb } from '@teamvortexsoftware/vortex-react-native/preview';
+ *
+ * NOTE: InviteFormCore is NOT exported here because it imports native components
+ * (VrtxSubmit, VrtxShareOptions, VrtxContactsImport) which pull in moduleLoaders.ts
+ * containing native require() statements. Web consumers should use InviteFormWeb
+ * which internally uses web-safe component versions.
+ */
+export { InviteFormWeb, InviteFormWeb as InvitationFormPreview, type InvitationFormPreviewProps, type ComponentInfo } from './components/InviteFormWeb';
+export type { InvitationFormCoreProps, IconRendererProps, IconName } from './components/InviteFormCore';
+export { InviteFormCore } from './components/InviteFormCore';
+export { useInvitationFormLogic, type ViewType, type Contact } from './hooks/useInvitationFormLogic';
+export { type PlatformOperations } from './types/platformOperations';
+export { MOCK_CONTACTS, MOCK_GOOGLE_CONTACTS } from './constants/mockData';
+export { filterContacts } from './utils/contactUtils';
+//# sourceMappingURL=index-web.d.ts.map

package/dist/types/index-web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-web.d.ts","sourceRoot":"","sources":["../../src/index-web.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,aAAa,EAAE,aAAa,IAAI,qBAAqB,EAAE,KAAK,0BAA0B,EAAE,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAExJ,YAAY,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACxG,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,KAAK,QAAQ,EAAE,KAAK,OAAO,EAAE,MAAM,gCAAgC,CAAC;AACrG,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,23 @@
+export { VortexInvite, type VortexInviteProps, type Attributes, type VortexActionResult, type VortexActionType } from './vortexInvite';
+export type { VortexModules, } from './context/VortexModulesContext';
+export { InviteFormMobile, InviteFormMobile as InvitationForm } from './components/InviteFormMobile';
+export { InviteFormCore, InviteFormCore as InvitationFormCore, type InvitationFormCoreProps, type IconRendererProps, type IconName } from './components/InviteFormCore';
+export { useInvitationFormLogic, type ViewType, type Contact } from './hooks/useInvitationFormLogic';
+export { usePrefetchWidgetConfiguration, type UsePrefetchWidgetConfigurationOptions } from './hooks/usePrefetchWidgetConfiguration';
+export { configCache } from './utils/configCache';
+export { type PlatformOperations } from './types/platformOperations';
+export { type FindFriendsConfig, type FindFriendsContact, } from './types/findFriends';
+export { type InvitationItem, type IncomingInvitationItem, type OutgoingInvitationItem, type IncomingInvitationsConfig, type OutgoingInvitationsConfig, type InvitationSuggestionsConfig, } from './types/invitations';
+export { type InviteContactsConfig, type InviteContactsContact, } from './types/inviteContacts';
+export { type UnfurlConfig, unfurlConfigToMetadata, } from './types/unfurlConfig';
+export { VortexDeferredLinks, type DeviceFingerprint, type MatchFingerprintResponse, type RetrieveDeferredDeepLinkOptions, } from './VortexDeferredLinks';
+export { VortexClient, type VortexClientOptions, type InvitationResponse, } from './VortexClient';
+export { type SearchBoxConfig, } from './types/searchBox';
+export { VrtxInviteContacts, type VrtxInviteContactsProps } from './components/VrtxInviteContacts';
+export { VrtxSearchBox, type VrtxSearchBoxProps } from './components/VrtxSearchBox';
+export { MOCK_CONTACTS, MOCK_GOOGLE_CONTACTS } from './constants/mockData';
+export { filterContacts } from './utils/contactUtils';
+export type { EmailGroupMembershipCheckFunction, EmailGroupMembershipCheckResult, UnsignedData } from '@teamvortexsoftware/vortex-types';
+export { type VortexAnalyticsEvent, type SimpleAnalyticsEvent, type GroupDTO, DEFAULT_ANALYTICS_URL, } from './utils/analytics';
+export { EventNames, type EventName } from '@teamvortexsoftware/analytics-client';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAMA,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,KAAK,UAAU,EAAE,KAAK,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGvI,YAAY,EACV,aAAa,GACd,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,IAAI,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACrG,OAAO,EAAE,cAAc,EAAE,cAAc,IAAI,kBAAkB,EAAE,KAAK,uBAAuB,EAAE,KAAK,iBAAiB,EAAE,KAAK,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACxK,OAAO,EAAE,sBAAsB,EAAE,KAAK,QAAQ,EAAE,KAAK,OAAO,EAAE,MAAM,gCAAgC,CAAC;AACrG,OAAO,EAAE,8BAA8B,EAAE,KAAK,qCAAqC,EAAE,MAAM,wCAAwC,CAAC;AACpI,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC9B,KAAK,2BAA2B,GACjC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,GAC3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,KAAK,YAAY,EACjB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,mBAAmB,EACnB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,+BAA+B,GACrC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,KAAK,eAAe,GACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,KAAK,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AACnG,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,iCAAiC,EAAE,+BAA+B,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAGzI,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,QAAQ,EACb,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,sCAAsC,CAAC"}

package/dist/types/invitations.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * Types for the Incoming, Outgoing, and Invitation Suggestions features.
+ *
+ * These components display lists of invitations:
+ * - VrtxIncomingInvitations: Invitations the user has received (with Accept/Delete actions)
+ * - VrtxOutgoingInvitations: Invitations the user has sent (with Cancel action)
+ * - VrtxInvitationSuggestions: "People you may know" suggestions (with Invite/Dismiss actions)
+ *
+ * The invitation data is provided directly via props by the host application.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=invitations.js.map

package/dist/types/invitations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invitations.js","sourceRoot":"","sources":["../../src/types/invitations.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG","sourcesContent":["/**\n * Types for the Incoming, Outgoing, and Invitation Suggestions features.\n *\n * These components display lists of invitations:\n * - VrtxIncomingInvitations: Invitations the user has received (with Accept/Delete actions)\n * - VrtxOutgoingInvitations: Invitations the user has sent (with Cancel action)\n * - VrtxInvitationSuggestions: \"People you may know\" suggestions (with Invite/Dismiss actions)\n *\n * The invitation data is provided directly via props by the host application.\n */\n\n/**\n * Represents a generic invitation/suggestion item.\n * Used by VrtxInvitationSuggestions component.\n */\nexport interface InvitationItem {\n  /** Unique identifier for the invitation */\n  id: string;\n  /** Display name of the person */\n  name: string;\n  /** The user ID in the customer's platform */\n  userId?: string;\n  /** Optional subtitle (e.g., username, mutual friends count) */\n  subtitle?: string;\n  /** Avatar/profile image URL (optional) */\n  avatarUrl?: string;\n  /** Whether this invitation came from the Vortex backend */\n  isVortexInvitation?: boolean;\n  /** Optional metadata for app-specific data */\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Represents an incoming invitation item.\n * Used by VrtxIncomingInvitations component.\n */\nexport interface IncomingInvitationItem {\n  /** Unique identifier for the invitation */\n  id: string;\n  /** Display name of the sender */\n  name: string;\n  /**\n   * The user ID, used for deduplication (maps to creatorId from the Vortex API).\n   * When both API and internal invitations share the same `userId`, the API one is kept.\n   */\n  userId?: string;\n  /** Avatar/profile image URL (optional) */\n  avatarUrl?: string;\n  /**\n   * Whether this invitation came from the Vortex backend.\n   * When true, the SDK will call the Vortex API for accept/delete operations.\n   * When false, the SDK relies entirely on the app's callbacks.\n   * @default false for invitations provided via config\n   */\n  isVortexInvitation?: boolean;\n  /** Optional metadata for app-specific data */\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Represents an outgoing invitation item.\n * Used by VrtxOutgoingInvitations component.\n */\nexport interface OutgoingInvitationItem {\n  /** Unique identifier for the invitation */\n  id: string;\n  /** Display name of the invitee */\n  name: string;\n  /**\n   * The user ID, used for deduplication (maps to targetValue from the Vortex API).\n   * When both API and internal invitations share the same `userId`, the API one is kept.\n   */\n  userId?: string;\n  /** Avatar/profile image URL (optional) */\n  avatarUrl?: string;\n  /**\n   * Whether this invitation came from the Vortex backend.\n   * When true, the SDK will call the Vortex API for cancel operations.\n   * When false, the SDK relies entirely on the app's callbacks.\n   * @default false for invitations provided via config\n   */\n  isVortexInvitation?: boolean;\n  /** Optional metadata for app-specific data */\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Configuration for VrtxIncomingInvitations component.\n * Displays invitations the user has received with Accept and Delete actions.\n */\nexport interface IncomingInvitationsConfig {\n  /**\n   * List of incoming invitations to display.\n   * Provided by the host application.\n   */\n  invitations: IncomingInvitationItem[];\n\n  /**\n   * Called when user confirms \"Accept\" on an invitation.\n   * A confirmation dialog is shown before this callback is invoked.\n   *\n   * For non-Vortex invitations (isVortexInvitation=false), return true to remove\n   * the invitation from the list, or false to keep it displayed.\n   *\n   * For Vortex invitations, the return value is also respected - return false\n   * to prevent the API call and keep the invitation in the list.\n   *\n   * @param invitation - The invitation that was accepted\n   * @returns Boolean indicating whether to proceed (remove from list), or void/Promise<void>\n   *\n   * @example\n   * ```typescript\n   * onAccept: async (invitation) => {\n   *   const success = await api.acceptInvitation(invitation.id);\n   *   return success; // Return true to remove from list\n   * }\n   * ```\n   */\n  onAccept: (invitation: IncomingInvitationItem) => boolean | void | Promise<boolean | void>;\n\n  /**\n   * Called when user confirms \"Delete\" on an invitation.\n   * A confirmation dialog is shown before this callback is invoked.\n   *\n   * For non-Vortex invitations (isVortexInvitation=false), return true to remove\n   * the invitation from the list, or false to keep it displayed.\n   *\n   * For Vortex invitations, the return value is also respected - return false\n   * to prevent the API call and keep the invitation in the list.\n   *\n   * @param invitation - The invitation that was deleted/declined\n   * @returns Boolean indicating whether to proceed (remove from list), or void/Promise<void>\n   *\n   * @example\n   * ```typescript\n   * onDelete: async (invitation) => {\n   *   const success = await api.declineInvitation(invitation.id);\n   *   return success; // Return true to remove from list\n   * }\n   * ```\n   */\n  onDelete: (invitation: IncomingInvitationItem) => boolean | void | Promise<boolean | void>;\n\n  /**\n   * Optional callback to compute a custom subtitle for each invitation.\n   *\n   * When provided, the SDK calls this function for each invitation to determine the\n   * displayed subtitle. Useful when the subtitle should be derived from the invitation's\n   * metadata (e.g., `invitation.metadata?.inviter_handle`).\n   *\n   * If not provided, no subtitle is rendered.\n   */\n  getSubtitle?: (invitation: IncomingInvitationItem) => string | undefined;\n\n  /**\n   * Optional: Custom text for the Accept button.\n   * @default \"Accept\"\n   */\n  acceptButtonText?: string;\n\n  /**\n   * Optional: Custom text for the Delete button.\n   * @default \"Delete\"\n   */\n  deleteButtonText?: string;\n\n  /**\n   * Optional: Custom empty state message when no invitations are present.\n   * @default \"No incoming invitations\"\n   */\n  emptyStateMessage?: string;\n\n  /**\n   * Optional: Custom title for the Accept confirmation dialog.\n   * @default \"Accept Invitation\"\n   */\n  acceptConfirmTitle?: string;\n\n  /**\n   * Optional: Custom message for the Accept confirmation dialog.\n   * Use {name} as a placeholder for the person's name.\n   * @default \"Accept invitation from {name}?\"\n   */\n  acceptConfirmMessage?: string;\n\n  /**\n   * Optional: Custom title for the Delete confirmation dialog.\n   * @default \"Delete Invitation\"\n   */\n  deleteConfirmTitle?: string;\n\n  /**\n   * Optional: Custom message for the Delete confirmation dialog.\n   * Use {name} as a placeholder for the person's name.\n   * @default \"Delete invitation from {name}?\"\n   */\n  deleteConfirmMessage?: string;\n\n  /**\n   * Optional: Custom text for the confirmation dialog's confirm button.\n   * @default \"Confirm\"\n   */\n  confirmButtonText?: string;\n\n  /**\n   * Optional: Custom text for the confirmation dialog's cancel button.\n   * @default \"Cancel\"\n   */\n  cancelButtonText?: string;\n}\n\n/**\n * Configuration for VrtxOutgoingInvitations component.\n * Displays invitations the user has sent with a Cancel action.\n * \n * Note: The component fetches invitations from the API and handles revocation automatically.\n * Text customizations (button text, empty state, etc.) come from the widget configuration.\n */\nexport interface OutgoingInvitationsConfig {\n  /**\n   * Optional: Internal invitations provided by the app (merged with API-fetched ones).\n   * These invitations will NOT have `isVortexInvitation` set, so your app must handle\n   * the cancel logic in the `onCancel` callback.\n   *\n   * If an internal invitation has the same `userId` as an API invitation,\n   * the API invitation is kept (deduplicated).\n   */\n  invitations?: OutgoingInvitationItem[];\n\n  /**\n   * Optional callback when user taps \"Cancel\" on an invitation.\n   * Called before the API revocation as a gate.\n   *\n   * Return `true` (or void/undefined) to proceed with the API revocation,\n   * or `false` to cancel the action.\n   *\n   * @param invitation - The invitation being cancelled\n   * @returns Whether to proceed with the cancellation\n   *\n   * @example\n   * ```typescript\n   * onCancel: async (invitation) => {\n   *   // Return true to proceed, false to cancel\n   *   return true;\n   * }\n   * ```\n   */\n  onCancel?: (invitation: OutgoingInvitationItem) => boolean | void | Promise<boolean | void>;\n\n  /**\n   * Optional callback to compute a custom subtitle for each invitation.\n   *\n   * When provided, the SDK calls this function for each invitation to determine the\n   * displayed subtitle. Useful when the subtitle should be derived from the invitation's\n   * metadata (e.g., `invitation.metadata?.invitee_handle`).\n   *\n   * If not provided, no subtitle is rendered.\n   */\n  getSubtitle?: (invitation: OutgoingInvitationItem) => string | undefined;\n\n  /**\n   * @internal Mock invitations for preview mode only.\n   * When provided, skips API calls and uses these invitations instead.\n   * This is NOT for customer use - only for internal preview/web mode.\n   */\n  _mockInvitations?: OutgoingInvitationItem[];\n}\n\n/**\n * Configuration for VrtxInvitationSuggestions component.\n * Displays \"People you may know\" suggestions with Invite and Dismiss (X) actions.\n */\nexport interface InvitationSuggestionsConfig {\n  /**\n   * List of suggested people to display.\n   * Provided by the host application.\n   */\n  suggestions: InvitationItem[];\n\n  /**\n   * Called when user taps \"Invite\" on a suggestion.\n   * No confirmation dialog - invites immediately.\n   *\n   * @param suggestion - The suggestion that was invited\n   * @returns Optional promise for async operations\n   *\n   * @example\n   * ```typescript\n   * onInvite: async (suggestion) => {\n   *   await api.sendInvitation(suggestion.id);\n   *   // Update your local state to remove the suggestion\n   * }\n   * ```\n   */\n  onInvite: (suggestion: InvitationItem) => void | Promise<void>;\n\n  /**\n   * Called when user taps the dismiss (X) button on a suggestion.\n   * No confirmation dialog - dismisses immediately.\n   *\n   * @param suggestion - The suggestion that was dismissed\n   * @returns Optional promise for async operations\n   *\n   * @example\n   * ```typescript\n   * onDismiss: async (suggestion) => {\n   *   await api.dismissSuggestion(suggestion.id);\n   *   // Update your local state to remove the suggestion\n   * }\n   * ```\n   */\n  onDismiss: (suggestion: InvitationItem) => void | Promise<void>;\n\n  /**\n   * Optional: Custom text for the Invite button.\n   * @default \"Invite\"\n   */\n  inviteButtonText?: string;\n\n  /**\n   * Optional: Custom empty state message when no suggestions are present.\n   * @default \"No suggestions\"\n   */\n  emptyStateMessage?: string;\n}\n"]}

package/dist/types/inviteContacts.js

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * Types for the Invite Contacts feature.
+ *
+ * The Invite Contacts component displays a list of contacts that can be invited via SMS.
+ * Unlike Find Friends, this component:
+ * - Receives pre-classified contacts directly (no fetching/classification)
+ * - Only shows contacts that can be invited (no member/non-member distinction)
+ * - Creates SMS invitations and opens the SMS app for the user to send
+ *
+ * The component renders nothing (no height) if the contacts list is empty.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=inviteContacts.js.map

package/dist/types/inviteContacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inviteContacts.js","sourceRoot":"","sources":["../../src/types/inviteContacts.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG","sourcesContent":["/**\n * Types for the Invite Contacts feature.\n *\n * The Invite Contacts component displays a list of contacts that can be invited via SMS.\n * Unlike Find Friends, this component:\n * - Receives pre-classified contacts directly (no fetching/classification)\n * - Only shows contacts that can be invited (no member/non-member distinction)\n * - Creates SMS invitations and opens the SMS app for the user to send\n *\n * The component renders nothing (no height) if the contacts list is empty.\n */\n\n/**\n * Contact to be displayed in the Invite Contacts component.\n * Each contact has a name and phone number for SMS invitation.\n */\nexport interface InviteContactsContact {\n  /** Unique identifier for the contact */\n  id: string;\n  /** Display name of the contact */\n  name: string;\n  /** Phone number for SMS invitation */\n  phoneNumber: string;\n  /** Avatar/profile image URL (optional) */\n  avatarUrl?: string;\n  /** Optional metadata for the contact */\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Configuration for the Invite Contacts feature.\n * Passed to VortexInvite via the inviteContactsConfig prop.\n */\nexport interface InviteContactsConfig {\n  /**\n   * List of contacts to display for SMS invitation.\n   * If empty or undefined, the component renders nothing (no height).\n   */\n  contacts: InviteContactsContact[];\n\n  /**\n   * Called when user taps \"Invite\" on a contact.\n   * The SDK will:\n   * 1. Create an SMS invitation via the API\n   * 2. Get the short link for the invitation\n   * 3. Open the SMS app with the configured message and link\n   *\n   * This callback is optional and can be used for analytics or custom handling.\n   *\n   * @param contact - The contact that was invited\n   * @param shortLink - The invitation short link that was created\n   */\n  onInvite?: (contact: InviteContactsContact, shortLink: string) => void | Promise<void>;\n\n  /**\n   * Optional: Custom text for the \"Invite your contacts\" link.\n   * @default \"Invite your contacts\"\n   */\n  inviteYourContactsText?: string;\n\n  /**\n   * Optional: Custom text for the \"Invite\" button.\n   * @default \"Invite\"\n   */\n  inviteButtonText?: string;\n\n  /**\n   * Optional: Custom empty state message (shown when contacts list becomes empty after inviting).\n   * @default \"No contacts to invite\"\n   */\n  emptyStateMessage?: string;\n\n  /**\n   * Optional: Called when user navigates to the contacts list.\n   * Can be used for analytics.\n   */\n  onNavigateToContacts?: () => void;\n\n  /**\n   * Optional: Called when user navigates back from the contacts list.\n   * Can be used for analytics.\n   */\n  onNavigateBack?: () => void;\n\n  /**\n   * Optional: Called when an invitation is successfully created.\n   * This can be used to notify other components (like Outgoing Invitations)\n   * that they should refresh their data.\n   *\n   * @param contact - The contact that was invited\n   * @param shortLink - The invitation short link that was created\n   */\n  onInvitationCreated?: (contact: InviteContactsContact, shortLink: string) => void;\n}\n"]}

package/dist/types/platformOperations.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=platformOperations.js.map

package/dist/types/platformOperations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platformOperations.js","sourceRoot":"","sources":["../../src/types/platformOperations.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Platform-specific operations that need different implementations\n * for native (React Native) and web environments.\n *\n * This interface enables dependency injection, allowing components\n * to work in both environments without importing platform-specific code.\n */\nexport interface PlatformOperations {\n  /**\n   * Copy invitation link to clipboard\n   * - Native: Fetches shareable invitation link via Vortex API and uses expo-clipboard or @react-native-clipboard/clipboard\n   * - Web: Fetches shareable invitation link and uses navigator.clipboard.writeText\n   *\n   * The method handles fetching the invitation link internally via the Vortex API.\n   */\n  copyToClipboard: () => Promise<void>;\n\n  /**\n   * Share invitation link using native share sheet or web share API\n   * - Native: Fetches shareable invitation link via Vortex API and uses React Native Share API\n   * - Web: Fetches shareable invitation link and uses navigator.share (if available) or logs a message\n   *\n   * The method handles fetching the invitation link and composing the share message internally.\n   */\n  share: () => Promise<void>;\n\n  /**\n   * Close/dismiss the invitation form\n   * - Native: Dismisses bottom sheet or calls onClose callback\n   * - Web: No-op or logs a message (preview mode)\n   */\n  close: () => void;\n\n  /**\n   * Fetch contacts with email addresses\n   * - Native: Uses expo-contacts to fetch from device contacts (called on-demand)\n   * - Web/Preview: Returns mock data for consistent preview behavior\n   *\n   * Called on-demand when user navigates to \"Add from Contacts\" view.\n   * Contacts with multiple emails are flattened into separate entries.\n   */\n  fetchContacts: () => Promise<Array<{ id: string; name: string; email: string }>>;\n\n  /**\n   * Send an invitation to a user\n   * - Native: Calls the Vortex API via handleInviteClick with proper authentication\n   * - Web/Preview: Simulates invite for consistent preview behavior\n   *\n   * Called when user clicks \"Invite\" button for email or contact invitations.\n   *\n   * @param email - Email address of the person to invite\n   * @param contactName - Optional name of the contact being invited\n   * @returns Promise that resolves when invitation is sent successfully\n   */\n  invite: (email: string, contactName?: string) => Promise<void>;\n\n  /**\n   * Fetch Google contacts via Google People API\n   * - Native: Authenticates via Google OAuth and fetches from People API\n   * - Web/Preview: Returns mock data for consistent preview behavior\n   *\n   * Called on-demand when user navigates to \"Add from Google Contacts\" view.\n   * Requires authentication and proper OAuth scopes.\n   *\n   * @returns Promise that resolves with array of Google contacts\n   */\n  fetchGoogleContacts: () => Promise<Array<{ id: string; name: string; email: string }>>;\n\n  /**\n   * Provide haptic feedback\n   * - Native: Uses expo-haptics for tactile feedback (dynamically imported)\n   * - Web/Preview: No-op (silent fail)\n   *\n   * Optional method that provides haptic feedback when user interacts with buttons.\n   * If expo-haptics is not installed, the implementation should fail silently.\n   *\n   * @param style - Intensity of haptic feedback ('light', 'medium', or 'heavy')\n   * @returns Promise that resolves when haptic feedback is complete (or immediately for no-op)\n   */\n  triggerHaptic?: (style: 'light' | 'medium' | 'heavy') => Promise<void>;\n\n  /**\n   * Share invitation via email (mailto)\n   * - Native: Opens email composer with pre-filled subject and body containing invitation link\n   * - Web/Preview: Opens mailto link or logs message\n   *\n   * Optional method for sharing via email client.\n   */\n  shareViaEmail?: () => Promise<void>;\n\n  /**\n   * Share invitation via SMS\n   * - Native: Opens SMS composer with pre-filled message containing invitation link\n   * - Web/Preview: Opens sms link or logs message\n   *\n   * Optional method for sharing via SMS.\n   */\n  shareViaSms?: () => Promise<void>;\n\n  /**\n   * Share invitation via X/Twitter DMs\n   * - Native: Opens Twitter app for direct messaging with invitation link\n   * - Web/Preview: Opens Twitter web URL or logs message\n   *\n   * Optional method for sharing via X/Twitter direct messages.\n   */\n  shareViaTwitter?: () => Promise<void>;\n\n  /**\n   * Share invitation via Instagram DMs\n   * - Native: Opens Instagram direct inbox\n   * - Web/Preview: Logs message (Instagram web doesn't support direct linking to DMs)\n   *\n   * Optional method for sharing via Instagram direct messages.\n   */\n  shareViaInstagram?: () => Promise<void>;\n\n  /**\n   * Share invitation via WhatsApp\n   * - Native: Opens WhatsApp with pre-filled message containing invitation link\n   * - Web/Preview: Opens WhatsApp web URL or logs message\n   *\n   * Optional method for sharing via WhatsApp.\n   */\n  shareViaWhatsApp?: () => Promise<void>;\n\n  /**\n   * Share invitation via Line\n   * - Native: Opens Line app with pre-filled message containing invitation link\n   * - Web/Preview: Opens Line web URL or logs message\n   *\n   * Optional method for sharing via Line messenger.\n   */\n  shareViaLine?: () => Promise<void>;\n\n  /**\n   * Share invitation via Line LIFF (LINE Frontend Framework)\n   * - Native: Opens Line LIFF app URL\n   * - Web/Preview: Opens Line LIFF URL or logs message\n   *\n   * Optional method for sharing via Line LIFF app.\n   */\n  shareViaLineLiff?: () => Promise<void>;\n\n  /**\n   * Show QR code for invitation\n   * - Native: Displays QR code modal with invitation link encoded\n   * - Web/Preview: Logs message or shows QR code modal\n   *\n   * Optional method for displaying QR code for invitation link.\n   */\n  showQrCode?: () => Promise<void>;\n\n  /**\n   * Share invitation via Facebook Messenger\n   * - Native: Opens Messenger app with pre-filled message containing invitation link\n   * - Web/Preview: Opens Messenger web URL or logs message\n   *\n   * Optional method for sharing via Facebook Messenger.\n   */\n  shareViaFacebookMessenger?: () => Promise<void>;\n\n  /**\n   * Share invitation via Telegram\n   * - Native: Opens Telegram app with pre-filled message containing invitation link\n   * - Web/Preview: Opens Telegram web URL or logs message\n   *\n   * Optional method for sharing via Telegram.\n   */\n  shareViaTelegram?: () => Promise<void>;\n\n  /**\n   * Share invitation via Discord\n   * - Native: Opens Discord app\n   * - Web/Preview: Opens Discord web URL or logs message\n   *\n   * Optional method for sharing via Discord.\n   */\n  shareViaDiscord?: () => Promise<void>;\n\n  /**\n   * Create an SMS invitation and return the short link\n   * - Native: Calls the Vortex API to create an SMS invitation\n   * - Web/Preview: Returns mock link for consistent preview behavior\n   *\n   * Used by the Invite Contacts component to create SMS invitations.\n   * The returned short link is included in the SMS message sent by the user.\n   *\n   * @param phoneNumber - Phone number of the person to invite\n   * @param contactName - Optional name of the contact being invited\n   * @returns Promise that resolves with the invitation short link, or null if failed\n   */\n  createSmsInvitation?: (phoneNumber: string, contactName?: string) => Promise<string | null>;\n}\n"]}

package/dist/types/searchBox.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Types for the Search Box feature.
+ *
+ * The Search Box component displays a search input with a search button.
+ * When the user taps the search button, a customer-provided callback is invoked
+ * with the search query. The callback returns a list of matching contacts
+ * (identical to FindFriendsContact) which are rendered below the search box.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=searchBox.js.map

package/dist/types/searchBox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchBox.js","sourceRoot":"","sources":["../../src/types/searchBox.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG","sourcesContent":["/**\n * Types for the Search Box feature.\n *\n * The Search Box component displays a search input with a search button.\n * When the user taps the search button, a customer-provided callback is invoked\n * with the search query. The callback returns a list of matching contacts\n * (identical to FindFriendsContact) which are rendered below the search box.\n */\n\nimport { FindFriendsContact } from './findFriends';\n\n/**\n * Configuration for the Search Box feature.\n * Passed to VortexInvite to enable and configure the Search Box component.\n */\nexport interface SearchBoxConfig {\n  /**\n   * Called when the user taps the search button.\n   * The customer implements this callback to perform the search and return matching contacts.\n   *\n   * @param query - The search query entered by the user\n   * @returns Promise resolving to an array of matching contacts\n   *\n   * @example\n   * ```typescript\n   * onSearch: async (query) => {\n   *   const results = await myApi.searchUsers(query);\n   *   return results.map(user => ({\n   *     userId: user.id,\n   *     name: user.displayName,\n   *     subtitle: user.email,\n   *     avatarUrl: user.avatar,\n   *   }));\n   * }\n   * ```\n   */\n  onSearch: (query: string) => Promise<FindFriendsContact[]> | FindFriendsContact[];\n\n  /**\n   * Called when user taps \"Connect\" on a search result contact.\n   * If the callback returns true, the SDK will create an invitation via the\n   * Vortex backend.\n   *\n   * @param contact - The contact that was tapped\n   * @returns Promise resolving to true if the invitation should be created\n   */\n  onConnect: (contact: FindFriendsContact) => Promise<boolean> | boolean;\n\n  /**\n   * Optional: Called after an invitation is successfully created.\n   *\n   * @param contact - The contact for whom the invitation was created\n   */\n  onInvitationCreated?: (contact: FindFriendsContact) => void;\n\n  /**\n   * Optional: Called if creating the invitation fails.\n   *\n   * @param contact - The contact for whom the invitation failed\n   * @param error - The error that occurred\n   */\n  onInvitationError?: (contact: FindFriendsContact, error: Error) => void;\n\n  /**\n   * Optional: Custom text for the \"Connect\" button.\n   * @default \"Connect\"\n   */\n  connectButtonText?: string;\n\n  /**\n   * Optional: Custom message shown when search returns no results.\n   * @default \"No results found\"\n   */\n  noResultsMessage?: string;\n}\n"]}

package/dist/types/types/findFriends.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Types for the Find Friends feature.
+ *
+ * The Find Friends component displays a list of contacts provided by the customer.
+ * Each contact has a user ID that identifies them in the customer's platform.
+ * When the user taps "Connect", an invitation is created via the Vortex backend.
+ */
+/**
+ * A contact in the Find Friends list.
+ * Provided by the customer via findFriendsConfig.contacts.
+ */
+export interface FindFriendsContact {
+    /** The user ID that identifies this contact in the customer's platform */
+    userId: string;
+    /** Display name of the contact */
+    name: string;
+    /** Optional subtitle (e.g., username, email, or app-specific info) */
+    subtitle?: string;
+    /** Avatar/profile image URL (optional) */
+    avatarUrl?: string;
+    /** Optional metadata for app-specific data */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Configuration for the Find Friends feature.
+ * Passed to VortexInvite to enable and configure the Find Friends component.
+ */
+export interface FindFriendsConfig {
+    /**
+     * List of contacts to display.
+     * Each contact must have a userId that identifies them in the customer's platform.
+     *
+     * @example
+     * ```typescript
+     * <VortexInvite
+     *   findFriendsConfig={{
+     *     contacts: [
+     *       { userId: 'user-123', name: 'John Doe', subtitle: '@johndoe' },
+     *       { userId: 'user-456', name: 'Jane Smith', avatarUrl: 'https://...' },
+     *     ],
+     *     onConnect: async (contact) => {
+     *       // Return true to create the invitation via Vortex backend
+     *       return true;
+     *     },
+     *   }}
+     * />
+     * ```
+     */
+    contacts: FindFriendsContact[];
+    /**
+     * Called when user taps "Connect" on a contact.
+     * The customer implements this callback to perform any pre-connection logic.
+     *
+     * If the callback returns true, the SDK will create an invitation via the
+     * Vortex backend.
+     *
+     * If the callback returns false, no invitation is created.
+     *
+     * @param contact - The contact that was tapped
+     * @returns Promise resolving to true if the invitation should be created, false otherwise
+     *
+     * @example
+     * ```typescript
+     * onConnect: async (contact) => {
+     *   // Perform any pre-connection validation
+     *   const canConnect = await myApi.checkCanConnect(contact.userId);
+     *   if (!canConnect) {
+     *     showError('Cannot connect to this user');
+     *     return false;
+     *   }
+     *   return true; // SDK will create the invitation
+     * }
+     * ```
+     */
+    onConnect: (contact: FindFriendsContact) => Promise<boolean> | boolean;
+    /**
+     * Optional: Called after an invitation is successfully created.
+     * Use this to update your UI or local state.
+     *
+     * @param contact - The contact for whom the invitation was created
+     */
+    onInvitationCreated?: (contact: FindFriendsContact) => void;
+    /**
+     * Optional: Called if creating the invitation fails.
+     *
+     * @param contact - The contact for whom the invitation failed
+     * @param error - The error that occurred
+     */
+    onInvitationError?: (contact: FindFriendsContact, error: Error) => void;
+    /**
+     * Optional: Custom text for the "Connect" button.
+     * @default "Connect"
+     */
+    connectButtonText?: string;
+    /**
+     * Optional: Custom empty state message when no contacts are provided.
+     * @default "No contacts found"
+     */
+    emptyStateMessage?: string;
+}
+//# sourceMappingURL=findFriends.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"findFriends.d.ts","sourceRoot":"","sources":["../../../src/types/findFriends.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAE/B;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,SAAS,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAEvE;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAE5D;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAExE;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B"}