@teamvortexsoftware/vortex-react-native 0.0.13 → 1.0.1

package/dist/types/types/invitations.d.ts

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

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

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

package/dist/types/types/inviteContacts.d.ts

@@ -0,0 +1,86 @@
+/**
+ * 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.
+ */
+/**
+ * Contact to be displayed in the Invite Contacts component.
+ * Each contact has a name and phone number for SMS invitation.
+ */
+export interface InviteContactsContact {
+    /** Unique identifier for the contact */
+    id: string;
+    /** Display name of the contact */
+    name: string;
+    /** Phone number for SMS invitation */
+    phoneNumber: string;
+    /** Avatar/profile image URL (optional) */
+    avatarUrl?: string;
+    /** Optional metadata for the contact */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Configuration for the Invite Contacts feature.
+ * Passed to VortexInvite via the inviteContactsConfig prop.
+ */
+export interface InviteContactsConfig {
+    /**
+     * List of contacts to display for SMS invitation.
+     * If empty or undefined, the component renders nothing (no height).
+     */
+    contacts: InviteContactsContact[];
+    /**
+     * Called when user taps "Invite" on a contact.
+     * The SDK will:
+     * 1. Create an SMS invitation via the API
+     * 2. Get the short link for the invitation
+     * 3. Open the SMS app with the configured message and link
+     *
+     * This callback is optional and can be used for analytics or custom handling.
+     *
+     * @param contact - The contact that was invited
+     * @param shortLink - The invitation short link that was created
+     */
+    onInvite?: (contact: InviteContactsContact, shortLink: string) => void | Promise<void>;
+    /**
+     * Optional: Custom text for the "Invite your contacts" link.
+     * @default "Invite your contacts"
+     */
+    inviteYourContactsText?: string;
+    /**
+     * Optional: Custom text for the "Invite" button.
+     * @default "Invite"
+     */
+    inviteButtonText?: string;
+    /**
+     * Optional: Custom empty state message (shown when contacts list becomes empty after inviting).
+     * @default "No contacts to invite"
+     */
+    emptyStateMessage?: string;
+    /**
+     * Optional: Called when user navigates to the contacts list.
+     * Can be used for analytics.
+     */
+    onNavigateToContacts?: () => void;
+    /**
+     * Optional: Called when user navigates back from the contacts list.
+     * Can be used for analytics.
+     */
+    onNavigateBack?: () => void;
+    /**
+     * Optional: Called when an invitation is successfully created.
+     * This can be used to notify other components (like Outgoing Invitations)
+     * that they should refresh their data.
+     *
+     * @param contact - The contact that was invited
+     * @param shortLink - The invitation short link that was created
+     */
+    onInvitationCreated?: (contact: InviteContactsContact, shortLink: string) => void;
+}
+//# sourceMappingURL=inviteContacts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inviteContacts.d.ts","sourceRoot":"","sources":["../../../src/types/inviteContacts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,wCAAwC;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,QAAQ,EAAE,qBAAqB,EAAE,CAAC;IAElC;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvF;;;OAGG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAEhC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,IAAI,CAAC;IAElC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAE5B;;;;;;;OAOG;IACH,mBAAmB,CAAC,EAAE,CAAC,OAAO,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CACnF"}

package/dist/types/types/platformOperations.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"platformOperations.d.ts","sourceRoot":"","sources":["../../../src/types/platformOperations.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;OAMG;IACH,eAAe,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAErC;;;;;;OAMG;IACH,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3B;;;;OAIG;IACH,KAAK,EAAE,MAAM,IAAI,CAAC;IAElB;;;;;;;OAOG;IACH,aAAa,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAEjF;;;;;;;;;;OAUG;IACH,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/D;;;;;;;;;OASG;IACH,mBAAmB,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAEvF;;;;;;;;;;OAUG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvE;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpC;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAElC;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtC;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvC;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvC;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjC;;;;;;OAMG;IACH,yBAAyB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvC;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtC;;;;;;;;;;;OAWG;IACH,mBAAmB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC7F"}

package/dist/types/types/searchBox.d.ts

@@ -0,0 +1,69 @@
+/**
+ * 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.
+ */
+import { FindFriendsContact } from './findFriends';
+/**
+ * Configuration for the Search Box feature.
+ * Passed to VortexInvite to enable and configure the Search Box component.
+ */
+export interface SearchBoxConfig {
+    /**
+     * Called when the user taps the search button.
+     * The customer implements this callback to perform the search and return matching contacts.
+     *
+     * @param query - The search query entered by the user
+     * @returns Promise resolving to an array of matching contacts
+     *
+     * @example
+     * ```typescript
+     * onSearch: async (query) => {
+     *   const results = await myApi.searchUsers(query);
+     *   return results.map(user => ({
+     *     userId: user.id,
+     *     name: user.displayName,
+     *     subtitle: user.email,
+     *     avatarUrl: user.avatar,
+     *   }));
+     * }
+     * ```
+     */
+    onSearch: (query: string) => Promise<FindFriendsContact[]> | FindFriendsContact[];
+    /**
+     * Called when user taps "Connect" on a search result contact.
+     * If the callback returns true, the SDK will create an invitation via the
+     * Vortex backend.
+     *
+     * @param contact - The contact that was tapped
+     * @returns Promise resolving to true if the invitation should be created
+     */
+    onConnect: (contact: FindFriendsContact) => Promise<boolean> | boolean;
+    /**
+     * Optional: Called after an invitation is successfully created.
+     *
+     * @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 message shown when search returns no results.
+     * @default "No results found"
+     */
+    noResultsMessage?: string;
+}
+//# sourceMappingURL=searchBox.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"searchBox.d.ts","sourceRoot":"","sources":["../../../src/types/searchBox.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEnD;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,EAAE,CAAC,GAAG,kBAAkB,EAAE,CAAC;IAElF;;;;;;;OAOG;IACH,SAAS,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAEvE;;;;OAIG;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,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B"}