@linktr.ee/linkapp 0.0.48 → 0.0.49

package/dist/sdk/hooks/use-ip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-ip.d.ts","sourceRoot":"","sources":["../../../src/sdk/hooks/use-ip.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAqB,MAAM,gBAAgB,CAAA;AAI/D,MAAM,WAAW,WAAW;IAC1B,2DAA2D;IAC3D,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;IACjB,yCAAyC;IACzC,SAAS,EAAE,OAAO,CAAA;IAClB,kCAAkC;IAClC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B;AAID;;;;;;;GAOG;AACH,wBAAgB,KAAK,IAAI,WAAW,CAUnC"}

package/dist/sdk/hooks/use-ip.js

@@ -0,0 +1,46 @@
+/**
+ * useIP hook - Request and access IP/geolocation data from the parent profile page
+ *
+ * @example
+ * ```tsx
+ * import { useIP } from '@linktr.ee/linkapp/sdk'
+ *
+ * function MyComponent() {
+ *   const { ip, isLoading, error } = useIP()
+ *   const timezone = Intl.DateTimeFormat().resolvedOptions().timeZone
+ *
+ *   if (isLoading) return <div>Loading...</div>
+ *   if (error) return <div>Error: {error.message}</div>
+ *
+ *   return (
+ *     <div>
+ *       <p>Country: {ip?.countryCode}</p>
+ *       <p>City: {ip?.city}</p>
+ *       <p>Timezone: {timezone}</p>
+ *     </div>
+ *   )
+ * }
+ * ```
+ */
+import { MOCK_IP } from './mocks.js';
+import { useSDKRequest } from './use-sdk-request.js';
+const extractIP = (response) => response.payload.ip;
+/**
+ * Hook to request and access IP/geolocation data from the parent profile page
+ *
+ * Sends REQUEST_IP message on mount and stores the response.
+ * In dev mode (not in iframe), returns mock data.
+ *
+ * Note: For timezone, use `Intl.DateTimeFormat().resolvedOptions().timeZone` directly.
+ */
+export function useIP() {
+    const { data, isLoading, error, refetch } = useSDKRequest({
+        requestType: 'REQUEST_IP',
+        responseType: 'IP_RESPONSE',
+        extractData: extractIP,
+        mockData: MOCK_IP,
+        errorMessage: 'Failed to fetch IP data',
+    });
+    return { ip: data, isLoading, error, refetch };
+}
+//# sourceMappingURL=use-ip.js.map

package/dist/sdk/hooks/use-ip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-ip.js","sourceRoot":"","sources":["../../../src/sdk/hooks/use-ip.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAapD,MAAM,SAAS,GAAG,CAAC,QAA2B,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAA;AAEtE;;;;;;;GAOG;AACH,MAAM,UAAU,KAAK;IACnB,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,aAAa,CAA4B;QACnF,WAAW,EAAE,YAAY;QACzB,YAAY,EAAE,aAAa;QAC3B,WAAW,EAAE,SAAS;QACtB,QAAQ,EAAE,OAAO;QACjB,YAAY,EAAE,yBAAyB;KACxC,CAAC,CAAA;IAEF,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,CAAA;AAChD,CAAC"}

package/dist/sdk/hooks/use-sdk-request.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Generic hook for SDK request-response pattern
+ *
+ * Handles:
+ * - Loading/error state management
+ * - Dev mode detection with mock data fallback
+ * - Request-response correlation via messageBus
+ * - Refetch capability
+ */
+import type { LinkAppToParentMessage, ParentMessageType, ParentToLinkAppMessage } from '../messages.js';
+export interface UseSDKRequestResult<T> {
+    data: T | null;
+    isLoading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+}
+interface UseSDKRequestOptions<TData, TResponse extends ParentToLinkAppMessage> {
+    /** Request message type (e.g., "REQUEST_VISITOR") */
+    requestType: LinkAppToParentMessage['type'];
+    /** Expected response message type (e.g., "VISITOR_RESPONSE") */
+    responseType: ParentMessageType;
+    /** Extract data from response payload */
+    extractData: (response: TResponse) => TData;
+    /** Mock data for dev mode (when not in iframe) */
+    mockData: TData;
+    /** Request timeout in ms (default: 10000) */
+    timeout?: number;
+    /** Error message prefix */
+    errorMessage?: string;
+}
+/**
+ * Generic hook for making SDK requests to parent window
+ *
+ * @example
+ * ```ts
+ * const { data: visitor, isLoading, error } = useSDKRequest({
+ *   requestType: "REQUEST_VISITOR",
+ *   responseType: "VISITOR_RESPONSE",
+ *   extractData: (res) => res.payload.visitor,
+ *   mockData: { mobileDetected: false, ... },
+ * });
+ * ```
+ */
+export declare function useSDKRequest<TData, TResponse extends ParentToLinkAppMessage>(options: UseSDKRequestOptions<TData, TResponse>): UseSDKRequestResult<TData>;
+export {};
+//# sourceMappingURL=use-sdk-request.d.ts.map

package/dist/sdk/hooks/use-sdk-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-sdk-request.d.ts","sourceRoot":"","sources":["../../../src/sdk/hooks/use-sdk-request.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAA;AAEvG,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAA;IACd,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B;AAED,UAAU,oBAAoB,CAAC,KAAK,EAAE,SAAS,SAAS,sBAAsB;IAC5E,qDAAqD;IACrD,WAAW,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAA;IAC3C,gEAAgE;IAChE,YAAY,EAAE,iBAAiB,CAAA;IAC/B,yCAAyC;IACzC,WAAW,EAAE,CAAC,QAAQ,EAAE,SAAS,KAAK,KAAK,CAAA;IAC3C,kDAAkD;IAClD,QAAQ,EAAE,KAAK,CAAA;IACf,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,2BAA2B;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,SAAS,sBAAsB,EAC3E,OAAO,EAAE,oBAAoB,CAAC,KAAK,EAAE,SAAS,CAAC,GAC9C,mBAAmB,CAAC,KAAK,CAAC,CAgD5B"}

package/dist/sdk/hooks/use-sdk-request.js

@@ -0,0 +1,65 @@
+/**
+ * Generic hook for SDK request-response pattern
+ *
+ * Handles:
+ * - Loading/error state management
+ * - Dev mode detection with mock data fallback
+ * - Request-response correlation via messageBus
+ * - Refetch capability
+ */
+import { useCallback, useEffect, useState } from 'react';
+import { messageBus } from '../message-bus.js';
+/**
+ * Generic hook for making SDK requests to parent window
+ *
+ * @example
+ * ```ts
+ * const { data: visitor, isLoading, error } = useSDKRequest({
+ *   requestType: "REQUEST_VISITOR",
+ *   responseType: "VISITOR_RESPONSE",
+ *   extractData: (res) => res.payload.visitor,
+ *   mockData: { mobileDetected: false, ... },
+ * });
+ * ```
+ */
+export function useSDKRequest(options) {
+    const { requestType, responseType, extractData, mockData, timeout = 10000, errorMessage = 'Request failed' } = options;
+    const [data, setData] = useState(null);
+    const [isLoading, setIsLoading] = useState(true);
+    const [error, setError] = useState(null);
+    const fetch = useCallback(async () => {
+        // Dev mode: not in iframe, return mock data
+        if (!messageBus.isInIframe()) {
+            setData(mockData);
+            setIsLoading(false);
+            return;
+        }
+        try {
+            setIsLoading(true);
+            setError(null);
+            const requestId = messageBus.generateRequestId();
+            const response = await messageBus.request({
+                source: 'linkapp',
+                type: requestType,
+                payload: { requestId },
+            }, responseType, timeout);
+            setData(extractData(response));
+        }
+        catch (err) {
+            setError(err instanceof Error ? err : new Error(errorMessage));
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [requestType, responseType, extractData, mockData, timeout, errorMessage]);
+    useEffect(() => {
+        void fetch();
+    }, [fetch]);
+    return {
+        data,
+        isLoading,
+        error,
+        refetch: fetch,
+    };
+}
+//# sourceMappingURL=use-sdk-request.js.map

package/dist/sdk/hooks/use-sdk-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-sdk-request.js","sourceRoot":"","sources":["../../../src/sdk/hooks/use-sdk-request.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAyB9C;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,aAAa,CAC3B,OAA+C;IAE/C,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,GAAG,KAAK,EAAE,YAAY,GAAG,gBAAgB,EAAE,GAAG,OAAO,CAAA;IAEtH,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAA;IACpD,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;IAChD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAA;IAEtD,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QACnC,4CAA4C;QAC5C,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,EAAE,CAAC;YAC7B,OAAO,CAAC,QAAQ,CAAC,CAAA;YACjB,YAAY,CAAC,KAAK,CAAC,CAAA;YACnB,OAAM;QACR,CAAC;QAED,IAAI,CAAC;YACH,YAAY,CAAC,IAAI,CAAC,CAAA;YAClB,QAAQ,CAAC,IAAI,CAAC,CAAA;YAEd,MAAM,SAAS,GAAG,UAAU,CAAC,iBAAiB,EAAE,CAAA;YAChD,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,OAAO,CACvC;gBACE,MAAM,EAAE,SAAS;gBACjB,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,EAAE,SAAS,EAAE;aACG,EAC3B,YAAY,EACZ,OAAO,CACR,CAAA;YAED,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAA;QAChC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC,CAAA;QAChE,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,KAAK,CAAC,CAAA;QACrB,CAAC;IACH,CAAC,EAAE,CAAC,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAA;IAE7E,SAAS,CAAC,GAAG,EAAE;QACb,KAAK,KAAK,EAAE,CAAA;IACd,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;IAEX,OAAO;QACL,IAAI;QACJ,SAAS;QACT,KAAK;QACL,OAAO,EAAE,KAAK;KACf,CAAA;AACH,CAAC"}

package/dist/sdk/hooks/use-theme.d.ts

@@ -0,0 +1,45 @@
+/**
+ * useTheme hook - Request and access theme data from the parent profile page
+ *
+ * Also subscribes to THEME_UPDATE messages for real-time theme changes.
+ *
+ * @example
+ * ```tsx
+ * import { useTheme } from '@linktr.ee/linkapp/sdk'
+ *
+ * function MyComponent() {
+ *   const { theme, isLoading, applyToDocument } = useTheme()
+ *
+ *   if (isLoading) return <div>Loading...</div>
+ *
+ *   return (
+ *     <div style={{ color: theme?.textColor }}>
+ *       <p>Theme loaded</p>
+ *       <button onClick={applyToDocument}>Apply to document</button>
+ *     </div>
+ *   )
+ * }
+ * ```
+ */
+import type { ThemeData } from "../messages.js";
+export interface UseThemeResult {
+    /** Theme data, null if not yet loaded or error */
+    theme: ThemeData | null;
+    /** Whether the initial request is in progress */
+    isLoading: boolean;
+    /** Error if the request failed */
+    error: Error | null;
+    /** Apply theme CSS variables to the document root */
+    applyToDocument: () => void;
+    /** Manually refetch theme data */
+    refetch: () => Promise<void>;
+}
+/**
+ * Hook to request and access theme data from the parent profile page
+ *
+ * Sends REQUEST_THEME message on mount and stores the response.
+ * Also subscribes to THEME_UPDATE for real-time theme changes.
+ * In dev mode (not in iframe), returns default theme data.
+ */
+export declare function useTheme(): UseThemeResult;
+//# sourceMappingURL=use-theme.d.ts.map

package/dist/sdk/hooks/use-theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-theme.d.ts","sourceRoot":"","sources":["../../../src/sdk/hooks/use-theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,KAAK,EAAE,SAAS,EAA4C,MAAM,gBAAgB,CAAC;AAI1F,MAAM,WAAW,cAAc;IAC7B,kDAAkD;IAClD,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IACxB,iDAAiD;IACjD,SAAS,EAAE,OAAO,CAAC;IACnB,kCAAkC;IAClC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,qDAAqD;IACrD,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,kCAAkC;IAClC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAyBD;;;;;;GAMG;AACH,wBAAgB,QAAQ,IAAI,cAAc,CAqDzC"}

package/dist/sdk/hooks/use-theme.js

@@ -0,0 +1,97 @@
+/**
+ * useTheme hook - Request and access theme data from the parent profile page
+ *
+ * Also subscribes to THEME_UPDATE messages for real-time theme changes.
+ *
+ * @example
+ * ```tsx
+ * import { useTheme } from '@linktr.ee/linkapp/sdk'
+ *
+ * function MyComponent() {
+ *   const { theme, isLoading, applyToDocument } = useTheme()
+ *
+ *   if (isLoading) return <div>Loading...</div>
+ *
+ *   return (
+ *     <div style={{ color: theme?.textColor }}>
+ *       <p>Theme loaded</p>
+ *       <button onClick={applyToDocument}>Apply to document</button>
+ *     </div>
+ *   )
+ * }
+ * ```
+ */
+import { useCallback, useEffect, useState } from "react";
+import { messageBus } from "../message-bus.js";
+import { MOCK_THEME } from "./mocks.js";
+import { useSDKRequest } from "./use-sdk-request.js";
+/** Apply CSS variables to document root */
+function applyCSSVariables(variables) {
+    if (typeof document === "undefined")
+        return;
+    const root = document.documentElement;
+    for (const [key, value] of Object.entries(variables)) {
+        root.style.setProperty(key, value);
+    }
+}
+/** Extract legacy theme properties from CSS variables */
+function extractLegacyProps(variables, fallback) {
+    return {
+        textColor: variables["--button-style-text"] || fallback.textColor,
+        backgroundColor: variables["--button-style-background"] || fallback.backgroundColor,
+        borderRadius: variables["--button-style-inner-radius"] || fallback.borderRadius,
+        borderColor: variables["--button-style-border-color"] || fallback.borderColor,
+        backgroundHover: variables["--button-style-background-hover"] || fallback.backgroundHover,
+        contrastColor: variables["--button-style-contrast-color"] || fallback.contrastColor,
+    };
+}
+const extractTheme = (response) => response.payload.theme;
+/**
+ * Hook to request and access theme data from the parent profile page
+ *
+ * Sends REQUEST_THEME message on mount and stores the response.
+ * Also subscribes to THEME_UPDATE for real-time theme changes.
+ * In dev mode (not in iframe), returns default theme data.
+ */
+export function useTheme() {
+    const [liveTheme, setLiveTheme] = useState(null);
+    const { data: initialTheme, isLoading, error, refetch, } = useSDKRequest({
+        requestType: "REQUEST_THEME",
+        responseType: "THEME_RESPONSE",
+        extractData: extractTheme,
+        mockData: MOCK_THEME,
+        errorMessage: "Failed to fetch theme data",
+    });
+    // Use live theme if available, otherwise initial theme
+    const theme = liveTheme ?? initialTheme;
+    const applyToDocument = useCallback(() => {
+        if (theme?.cssVariables) {
+            applyCSSVariables(theme.cssVariables);
+        }
+    }, [theme]);
+    // Subscribe to theme updates from parent
+    useEffect(() => {
+        const unsubscribe = messageBus.on("THEME_UPDATE", (message) => {
+            const variables = message.payload.variables;
+            setLiveTheme((prev) => {
+                const base = prev ?? initialTheme ?? MOCK_THEME;
+                return {
+                    ...base,
+                    cssVariables: variables,
+                    ...extractLegacyProps(variables, base),
+                };
+            });
+            // Auto-apply to document
+            applyCSSVariables(variables);
+        });
+        return unsubscribe;
+    }, [initialTheme]);
+    return {
+        theme,
+        isLoading,
+        error,
+        applyToDocument,
+        refetch,
+    };
+}
+//# sourceMappingURL=use-theme.js.map

package/dist/sdk/hooks/use-theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-theme.js","sourceRoot":"","sources":["../../../src/sdk/hooks/use-theme.ts"],"names":[],"mappings":"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"}

package/dist/sdk/hooks/use-visitor.d.ts

@@ -0,0 +1,41 @@
+/**
+ * useVisitor hook - Request and access visitor data from the parent profile page
+ *
+ * @example
+ * ```tsx
+ * import { useVisitor } from '@linktr.ee/linkapp/sdk'
+ *
+ * function MyComponent() {
+ *   const { visitor, isLoading, error } = useVisitor()
+ *
+ *   if (isLoading) return <div>Loading...</div>
+ *   if (error) return <div>Error: {error.message}</div>
+ *
+ *   return (
+ *     <div>
+ *       {visitor?.mobileDetected && <p>You're on mobile</p>}
+ *       {visitor?.isFollowing && <p>Thanks for following!</p>}
+ *     </div>
+ *   )
+ * }
+ * ```
+ */
+import type { VisitorData } from '../messages.js';
+export interface UseVisitorResult {
+    /** Visitor data, null if not yet loaded or error */
+    visitor: VisitorData | null;
+    /** Whether the request is in progress */
+    isLoading: boolean;
+    /** Error if the request failed */
+    error: Error | null;
+    /** Manually refetch visitor data */
+    refetch: () => Promise<void>;
+}
+/**
+ * Hook to request and access visitor data from the parent profile page
+ *
+ * Sends REQUEST_VISITOR message on mount and stores the response.
+ * In dev mode (not in iframe), returns mock data.
+ */
+export declare function useVisitor(): UseVisitorResult;
+//# sourceMappingURL=use-visitor.d.ts.map

package/dist/sdk/hooks/use-visitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-visitor.d.ts","sourceRoot":"","sources":["../../../src/sdk/hooks/use-visitor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAA0B,MAAM,gBAAgB,CAAA;AAIzE,MAAM,WAAW,gBAAgB;IAC/B,oDAAoD;IACpD,OAAO,EAAE,WAAW,GAAG,IAAI,CAAA;IAC3B,yCAAyC;IACzC,SAAS,EAAE,OAAO,CAAA;IAClB,kCAAkC;IAClC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,oCAAoC;IACpC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B;AAID;;;;;GAKG;AACH,wBAAgB,UAAU,IAAI,gBAAgB,CAU7C"}

package/dist/sdk/hooks/use-visitor.js

@@ -0,0 +1,42 @@
+/**
+ * useVisitor hook - Request and access visitor data from the parent profile page
+ *
+ * @example
+ * ```tsx
+ * import { useVisitor } from '@linktr.ee/linkapp/sdk'
+ *
+ * function MyComponent() {
+ *   const { visitor, isLoading, error } = useVisitor()
+ *
+ *   if (isLoading) return <div>Loading...</div>
+ *   if (error) return <div>Error: {error.message}</div>
+ *
+ *   return (
+ *     <div>
+ *       {visitor?.mobileDetected && <p>You're on mobile</p>}
+ *       {visitor?.isFollowing && <p>Thanks for following!</p>}
+ *     </div>
+ *   )
+ * }
+ * ```
+ */
+import { MOCK_VISITOR } from './mocks.js';
+import { useSDKRequest } from './use-sdk-request.js';
+const extractVisitor = (response) => response.payload.visitor;
+/**
+ * Hook to request and access visitor data from the parent profile page
+ *
+ * Sends REQUEST_VISITOR message on mount and stores the response.
+ * In dev mode (not in iframe), returns mock data.
+ */
+export function useVisitor() {
+    const { data, isLoading, error, refetch } = useSDKRequest({
+        requestType: 'REQUEST_VISITOR',
+        responseType: 'VISITOR_RESPONSE',
+        extractData: extractVisitor,
+        mockData: MOCK_VISITOR,
+        errorMessage: 'Failed to fetch visitor data',
+    });
+    return { visitor: data, isLoading, error, refetch };
+}
+//# sourceMappingURL=use-visitor.js.map

package/dist/sdk/hooks/use-visitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-visitor.js","sourceRoot":"","sources":["../../../src/sdk/hooks/use-visitor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAapD,MAAM,cAAc,GAAG,CAAC,QAAgC,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAA;AAErF;;;;;GAKG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,aAAa,CAAsC;QAC7F,WAAW,EAAE,iBAAiB;QAC9B,YAAY,EAAE,kBAAkB;QAChC,WAAW,EAAE,cAAc;QAC3B,QAAQ,EAAE,YAAY;QACtB,YAAY,EAAE,8BAA8B;KAC7C,CAAC,CAAA;IAEF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,CAAA;AACrD,CAAC"}

package/dist/sdk/hooks/validation.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Validation utilities for SDK hooks
+ */
+/** Validate email format */
+export declare function isValidEmail(email: string): boolean;
+/** Simulated delay for dev mode */
+export declare function devDelay(ms?: number): Promise<void>;
+//# sourceMappingURL=validation.d.ts.map

package/dist/sdk/hooks/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/sdk/hooks/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,4BAA4B;AAC5B,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,mCAAmC;AACnC,wBAAgB,QAAQ,CAAC,EAAE,SAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhD"}

package/dist/sdk/hooks/validation.js

@@ -0,0 +1,13 @@
+/**
+ * Validation utilities for SDK hooks
+ */
+const EMAIL_REGEX = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+/** Validate email format */
+export function isValidEmail(email) {
+    return EMAIL_REGEX.test(email);
+}
+/** Simulated delay for dev mode */
+export function devDelay(ms = 500) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=validation.js.map

package/dist/sdk/hooks/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/sdk/hooks/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,GAAG,4BAA4B,CAAA;AAEhD,4BAA4B;AAC5B,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;AAChC,CAAC;AAED,mCAAmC;AACnC,MAAM,UAAU,QAAQ,CAAC,EAAE,GAAG,GAAG;IAC/B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAA;AAC1D,CAAC"}

package/dist/sdk/index.d.ts

@@ -3,19 +3,31 @@
  *
  * @example
  * ```tsx
- * import { useExpandLinkApp } from '@linktr.ee/linkapp/sdk'
+ * import { useExpandLinkApp, useVisitor, useAudienceManager } from '@linktr.ee/linkapp/sdk'
  *
  * function FeaturedLayout() {
  *   const expandLinkApp = useExpandLinkApp()
+ *   const { visitor } = useVisitor()
+ *   const { subscribe, isSubscribing } = useAudienceManager()
  *
  *   return (
- *     <button onClick={() => expandLinkApp({ itemId: '123' })}>
- *       View More
- *     </button>
+ *     <div>
+ *       {visitor?.isFollowing && <p>Thanks for following!</p>}
+ *       <button onClick={() => expandLinkApp({ itemId: '123' })}>
+ *         View More
+ *       </button>
+ *     </div>
  *   )
  * }
  * ```
  */
 export { useExpandLinkApp } from './use-expand-link-app.js';
-export { sendMessage } from './send-message.js';
+export { messageBus } from './message-bus.js';
+export { useVisitor } from './hooks/use-visitor.js';
+export { useIP } from './hooks/use-ip.js';
+export { useAudienceManager } from './hooks/use-audience-manager.js';
+export type { UseVisitorResult } from './hooks/use-visitor.js';
+export type { UseIPResult } from './hooks/use-ip.js';
+export type { UseAudienceManagerResult } from './hooks/use-audience-manager.js';
+export type { VisitorData, IPData, SubscribeResult, RequestId, LinkAppToParentMessage, ParentToLinkAppMessage, } from './messages.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sdk/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sdk/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAG3D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAG7C,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAA;AAGpE,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACpD,YAAY,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAA;AAE/E,YAAY,EACV,WAAW,EACX,MAAM,EACN,eAAe,EACf,SAAS,EACT,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,eAAe,CAAA"}

package/dist/sdk/index.js

@@ -3,19 +3,30 @@
  *
  * @example
  * ```tsx
- * import { useExpandLinkApp } from '@linktr.ee/linkapp/sdk'
+ * import { useExpandLinkApp, useVisitor, useAudienceManager } from '@linktr.ee/linkapp/sdk'
  *
  * function FeaturedLayout() {
  *   const expandLinkApp = useExpandLinkApp()
+ *   const { visitor } = useVisitor()
+ *   const { subscribe, isSubscribing } = useAudienceManager()
  *
  *   return (
- *     <button onClick={() => expandLinkApp({ itemId: '123' })}>
- *       View More
- *     </button>
+ *     <div>
+ *       {visitor?.isFollowing && <p>Thanks for following!</p>}
+ *       <button onClick={() => expandLinkApp({ itemId: '123' })}>
+ *         View More
+ *       </button>
+ *     </div>
  *   )
  * }
  * ```
  */
+// Core hooks
 export { useExpandLinkApp } from './use-expand-link-app.js';
-export { sendMessage } from './send-message.js';
+// Message bus for advanced usage
+export { messageBus } from './message-bus.js';
+// New hooks for visitor, IP, and audience manager
+export { useVisitor } from './hooks/use-visitor.js';
+export { useIP } from './hooks/use-ip.js';
+export { useAudienceManager } from './hooks/use-audience-manager.js';
 //# sourceMappingURL=index.js.map

package/dist/sdk/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sdk/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sdk/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,aAAa;AACb,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAE3D,iCAAiC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,kDAAkD;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAA"}

package/dist/sdk/message-bus.d.ts

@@ -0,0 +1,59 @@
+/**
+ * MessageBus for bidirectional communication between LinkApp iframe and parent window
+ *
+ * Provides:
+ * - send(message): Fire-and-forget message to parent
+ * - request<T>(message, timeout): Send request and await response with correlation
+ * - on(type, handler): Subscribe to incoming message types
+ */
+import type { LinkAppToParentMessage, ParentMessageType, ParentToLinkAppMessage, RequestId } from './messages.js';
+type MessageHandler<T extends ParentToLinkAppMessage> = (message: T) => void;
+/**
+ * Singleton message bus for LinkApp SDK communication
+ */
+declare class LinkAppMessageBus {
+    private handlers;
+    private pendingRequests;
+    private listenerAttached;
+    constructor();
+    private setupMessageListener;
+    private handleMessage;
+    /**
+     * Check if running inside an iframe
+     */
+    isInIframe(): boolean;
+    /**
+     * Generate a unique request ID for correlation
+     */
+    generateRequestId(): RequestId;
+    /**
+     * Send a message to the parent window (fire-and-forget)
+     */
+    send(message: LinkAppToParentMessage): void;
+    /**
+     * Send a request and await the response
+     *
+     * @param message - The request message to send
+     * @param responseType - The expected response message type
+     * @param timeoutMs - Timeout in milliseconds (default: 10000)
+     * @returns Promise that resolves with the response message
+     */
+    request<T extends ParentToLinkAppMessage>(message: LinkAppToParentMessage, responseType: ParentMessageType, timeoutMs?: number): Promise<T>;
+    /**
+     * Subscribe to a specific message type from parent
+     *
+     * @param type - The message type to listen for
+     * @param handler - Callback function when message is received
+     * @returns Unsubscribe function
+     */
+    on<T extends ParentMessageType>(type: T, handler: MessageHandler<Extract<ParentToLinkAppMessage, {
+        type: T;
+    }>>): () => void;
+    /**
+     * Clear all pending requests (for testing)
+     */
+    clearPendingRequests(): void;
+}
+export declare const messageBus: LinkAppMessageBus;
+export {};
+//# sourceMappingURL=message-bus.d.ts.map

package/dist/sdk/message-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-bus.d.ts","sourceRoot":"","sources":["../../src/sdk/message-bus.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAEjH,KAAK,cAAc,CAAC,CAAC,SAAS,sBAAsB,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,CAAA;AAS5E;;GAEG;AACH,cAAM,iBAAiB;IACrB,OAAO,CAAC,QAAQ,CAAyD;IACzE,OAAO,CAAC,eAAe,CAA4C;IACnE,OAAO,CAAC,gBAAgB,CAAQ;;IAQhC,OAAO,CAAC,oBAAoB;IAO5B,OAAO,CAAC,aAAa;IA0CrB;;OAEG;IACH,UAAU,IAAI,OAAO;IAKrB;;OAEG;IACH,iBAAiB,IAAI,SAAS;IAI9B;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI;IAc3C;;;;;;;OAOG;IACG,OAAO,CAAC,CAAC,SAAS,sBAAsB,EAC5C,OAAO,EAAE,sBAAsB,EAC/B,YAAY,EAAE,iBAAiB,EAC/B,SAAS,SAAQ,GAChB,OAAO,CAAC,CAAC,CAAC;IA+Bb;;;;;;OAMG;IACH,EAAE,CAAC,CAAC,SAAS,iBAAiB,EAC5B,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,sBAAsB,EAAE;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,CAAC,GACpE,MAAM,IAAI;IAYb;;OAEG;IACH,oBAAoB,IAAI,IAAI;CAM7B;AAGD,eAAO,MAAM,UAAU,mBAA0B,CAAA"}