admesh-ui-sdk 1.0.20 → 1.0.22

package/dist/components/AdMeshFollowup.d.ts

@@ -0,0 +1,34 @@
+import { default as React } from 'react';
+import { AdMeshRecommendation, AdMeshTheme } from '../types/index';
+import { AdMeshSDK } from '../sdk/AdMeshSDK';
+export interface AdMeshFollowupProps {
+    recommendation: AdMeshRecommendation;
+    theme?: AdMeshTheme;
+    sdk: AdMeshSDK;
+    sessionId: string;
+    onExecuteQuery?: (query: string) => void | Promise<void>;
+}
+/**
+ * AdMeshFollowup - Sponsored Follow-up Component
+ *
+ * Displays sponsored follow-up suggestions as optional fields on any recommendation.
+ * Follow-ups use the same recommendation_id as the primary ad and are rendered separately
+ * in a followups_container_id. This component handles all exposure and engagement tracking
+ * internally - platforms only need to provide an onExecuteQuery hook for query execution.
+ *
+ * @example
+ * ```tsx
+ * <AdMeshFollowup
+ *   recommendation={recommendation}
+ *   sdk={sdk}
+ *   sessionId={sessionId}
+ *   theme={theme}
+ *   onExecuteQuery={(query) => {
+ *     // Platform's query execution logic
+ *     executeQuery(query);
+ *   }}
+ * />
+ * ```
+ */
+export declare const AdMeshFollowup: React.FC<AdMeshFollowupProps>;
+//# sourceMappingURL=AdMeshFollowup.d.ts.map

package/dist/components/AdMeshFollowup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdMeshFollowup.d.ts","sourceRoot":"","sources":["../../src/components/AdMeshFollowup.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAG7C,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE,oBAAoB,CAAC;IACrC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,GAAG,EAAE,SAAS,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1D;AAoBD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAyFxD,CAAC"}

package/dist/components/AdMeshRecommendations.d.ts

@@ -1,21 +1,4 @@
 export interface AdMeshRecommendationsProps {
-    /**
-     * Recommendation format (optional override)
-     *
-     * - 'product': Display as product cards
-     * - 'tail': Display as tail format (default)
-     * - 'bridge': Display as bridge format for followup sponsored recommendations
-     *
-     * If not provided, format is auto-detected from brand agent's `preferred_format`.
-     * This prop can be used to override the auto-detection.
-     *
-     * Note: For Weave Ad Format (where AdMesh links are embedded in LLM response),
-     * use WeaveAdFormatContainer component instead.
-     *
-     * Note: allowed_formats are configured during platform onboarding and fetched automatically
-     * from the platform's configuration. No need to specify them in code.
-     */
-    format?: 'product' | 'tail' | 'bridge';
     /** Optional callback when recommendations are shown */
     onRecommendationsShown?: (messageId: string) => void;
     /** Optional callback on error */
@@ -37,19 +20,60 @@ export interface AdMeshRecommendationsProps {
      * The backend requires a valid query parameter.
      */
     query?: string;
-    /**
-     * Latency budget in milliseconds.
-     *
-     * How long the platform will wait for an ad response.
-     * If not provided, the backend will use a default value.
-     */
-    latencyBudgetMs?: number;
     /**
      * Callback to paste content to input field (for bridge format CTA button).
      * When provided, the bridge format will show a CTA button that pastes
      * the bridge_content into the input field when clicked.
      */
     onPasteToInput?: (content: string) => void;
+    /**
+     * Optional container ID for follow-up suggestions.
+     * When provided and the recommendation includes a followup_query,
+     * the SDK will automatically render the follow-up in this container.
+     */
+    followups_container_id?: string;
+    /**
+     * Callback to execute query when follow-up is selected (required for follow-up functionality).
+     * When a user clicks on a follow-up suggestion, this callback is invoked with the followup_query.
+     * This allows the platform to continue the conversation with the sponsored follow-up query.
+     */
+    onExecuteQuery?: (query: string) => void | Promise<void>;
+    /**
+     * Callback when a sponsored followup is detected.
+     * This allows third-party applications to integrate the sponsored followup query into their own
+     * followup suggestions UI (e.g., adding to a suggestions list, related questions section, etc.).
+     *
+     * When a user clicks the followup suggestion, the application should:
+     * 1. Fire engagement tracking by calling the followupEngagementUrl
+     * 2. Execute the followupQuery (e.g., submit it as a new user query)
+     *
+     * @param followupQuery - The sponsored followup query text to display to the user
+     * @param followupEngagementUrl - The engagement tracking URL to call when user clicks the followup
+     * @param recommendationId - The recommendation ID for tracking and correlation
+     *
+     * @example
+     * ```tsx
+     * <AdMeshRecommendations
+     *   onFollowupDetected={(query, engagementUrl, recId) => {
+     *     // Add to your suggestions list
+     *     setSuggestions(prev => [...prev, {
+     *       text: query,
+     *       sponsored: true,
+     *       engagementUrl,
+     *       recommendationId: recId
+     *     }]);
+     *   }}
+     * />
+     * ```
+     */
+    onFollowupDetected?: (followupQuery: string, followupEngagementUrl: string, recommendationId: string) => void;
+    /**
+     * Signal indicating if the followup container is ready in the DOM.
+     *
+     * Useful for scenarios where the container is rendered conditionally or after a delay (e.g. streaming).
+     * If provided, the component will wait until this is true before attempting to attach the portal.
+     */
+    isContainerReady?: boolean;
 }
 /**
  * AdMeshRecommendations - Citation/Product Format Recommendation Display
@@ -67,12 +91,12 @@ export interface AdMeshRecommendationsProps {
  * // Per-message recommendations with messageId
  * <AdMeshProvider apiKey={apiKey} sessionId={sessionId}>
  *   {messages.map((msg) => (
- *     <div key={msg.messageId}>
+ * <div key={msg.messageId}>
  *       {msg.content}
  *       {msg.role === 'assistant' && (
- *         <AdMeshRecommendations
- *           messageId={msg.messageId}
- *           format="tail"
+ * <AdMeshRecommendations
+ * messageId={msg.messageId}
+ *           query={msg.userQuery}
  *         />
  *       )}
  *     </div>
@@ -82,30 +106,16 @@ export interface AdMeshRecommendationsProps {
  *
  * @example
  * ```tsx
- * // Product card format recommendations
+ * // Format is auto-detected from brand agent's preferred_format
  * <AdMeshProvider apiKey={apiKey} sessionId={sessionId}>
  *   <Chat messages={messages} />
  *   <AdMeshRecommendations
  *     messageId={lastMessageId}
  *     query="best CRM for small business"
- *     format="product"
- *   />
- * </AdMeshProvider>
- * ```
- *
- * @example
- * ```tsx
- * // Bridge format for followup sponsored recommendations (Vibe Coding Platforms, AI IDEs, AI search)
- * <AdMeshProvider apiKey={apiKey} sessionId={sessionId}>
- *   <Chat messages={messages} />
- *   <AdMeshRecommendations
- *     messageId={lastMessageId}
- *     query="how to set up a CRM system"
- *     format="bridge"
  *   />
  * </AdMeshProvider>
  * ```
  */
-export declare const AdMeshRecommendations: ({ format, onRecommendationsShown, onError, messageId, query, latencyBudgetMs, onPasteToInput, }: AdMeshRecommendationsProps) => import("react/jsx-runtime").JSX.Element | null;
+export declare const AdMeshRecommendations: ({ onRecommendationsShown, onError, messageId, query, onPasteToInput, followups_container_id: _followups_container_id, onExecuteQuery: _onExecuteQuery, onFollowupDetected, isContainerReady, }: AdMeshRecommendationsProps) => import("react/jsx-runtime").JSX.Element | null;
 export default AdMeshRecommendations;
 //# sourceMappingURL=AdMeshRecommendations.d.ts.map

package/dist/components/AdMeshRecommendations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AdMeshRecommendations.d.ts","sourceRoot":"","sources":["../../src/components/AdMeshRecommendations.tsx"],"names":[],"mappings":"AAMA,MAAM,WAAW,0BAA0B;IACzC;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;IAEvC,uDAAuD;IACvD,sBAAsB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAErD,iCAAiC;IACjC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAEjC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;;;;;OASG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;;OAIG;IACH,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,eAAO,MAAM,qBAAqB,GAAI,iGAQnC,0BAA0B,mDA8I5B,CAAC;AAEF,eAAe,qBAAqB,CAAC"}
+{"version":3,"file":"AdMeshRecommendations.d.ts","sourceRoot":"","sources":["../../src/components/AdMeshRecommendations.tsx"],"names":[],"mappings":"AAYA,MAAM,WAAW,0BAA0B;IACzC,uDAAuD;IACvD,sBAAsB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAErD,iCAAiC;IACjC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAEjC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;;;;;OASG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAE3C;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAEhC;;;;OAIG;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IAEH,kBAAkB,CAAC,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,KAAK,IAAI,CAAC;IAE9G;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,eAAO,MAAM,qBAAqB,GAAI,gMAWnC,0BAA0B,mDA6X5B,CAAC;AAEF,eAAe,qBAAqB,CAAC"}

package/dist/components/WeaveAdFormatContainer.d.ts

@@ -22,6 +22,14 @@ export interface WeaveAdFormatContainerProps {
     onWeaveAttempt?: (messageId: string) => void;
     /** Optional callback when weave injection outcome is determined */
     onWeaveOutcome?: (messageId: string, success: boolean, reason?: string) => void;
+    /** Optional container ID for follow-up suggestions */
+    followups_container_id?: string;
+    /** Callback to execute query when follow-up is selected (required for follow-up functionality) */
+    onExecuteQuery?: (query: string) => void | Promise<void>;
+    /** Optional callback when a sponsored followup is detected */
+    onFollowupDetected?: (followupQuery: string, followupEngagementUrl: string, recommendationId: string) => void;
+    /** Signal indicating if the followup container is ready in the DOM */
+    isContainerReady?: boolean;
 }
 /**
  * WeaveAdFormatContainer - Automatic Weave Ad Format handling component

package/dist/components/WeaveAdFormatContainer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WeaveAdFormatContainer.d.ts","sourceRoot":"","sources":["../../src/components/WeaveAdFormatContainer.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAmD,MAAM,OAAO,CAAC;AA4MxE,MAAM,WAAW,2BAA2B;IAC1C,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAElB,0DAA0D;IAC1D,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAE1B,6DAA6D;IAC7D,cAAc,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAEpC,uDAAuD;IACvD,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAE1C,iFAAiF;IACjF,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAC;IAE/B,iCAAiC;IACjC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAEjC,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,mFAAmF;IACnF,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,CAAC,cAAc,EAAE,OAAO,KAAK,IAAI,CAAC;IAErD,0DAA0D;IAC1D,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAE7C,mEAAmE;IACnE,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CACjF;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,sBAAsB,EAAE,KAAK,CAAC,EAAE,CAAC,2BAA2B,CA6LxE,CAAC;AAEF,eAAe,sBAAsB,CAAC"}
+{"version":3,"file":"WeaveAdFormatContainer.d.ts","sourceRoot":"","sources":["../../src/components/WeaveAdFormatContainer.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAmD,MAAM,OAAO,CAAC;AAwOxE,MAAM,WAAW,2BAA2B;IAC1C,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAElB,0DAA0D;IAC1D,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAE1B,6DAA6D;IAC7D,cAAc,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAEpC,uDAAuD;IACvD,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAE1C,iFAAiF;IACjF,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAC;IAE/B,iCAAiC;IACjC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAEjC,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,mFAAmF;IACnF,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,CAAC,cAAc,EAAE,OAAO,KAAK,IAAI,CAAC;IAErD,0DAA0D;IAC1D,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAE7C,mEAAmE;IACnE,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAEhF,sDAAsD;IACtD,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAEhC,kGAAkG;IAClG,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzD,8DAA8D;IAC9D,kBAAkB,CAAC,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,KAAK,IAAI,CAAC;IAE9G,sEAAsE;IACtE,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,sBAAsB,EAAE,KAAK,CAAC,EAAE,CAAC,2BAA2B,CA+WxE,CAAC;AAEF,eAAe,sBAAsB,CAAC"}

package/dist/components/WeaveFallbackRecommendations.d.ts

@@ -31,6 +31,12 @@ export interface WeaveFallbackRecommendationsProps {
      * When false or undefined, component will not render
      */
     fallback?: boolean;
+    /**
+     * Previously fetched recommendations from WeaveAdFormatContainer.
+     * If provided and not empty, these will be rendered directly without making a new API call.
+     * Only makes a new API call if this is empty/null/undefined.
+     */
+    previousRecommendations?: any[];
 }
 /**
  * WeaveFallbackRecommendations - Weave Format Fallback Component
@@ -41,9 +47,12 @@ export interface WeaveFallbackRecommendationsProps {
  * This component will:
  * - Accept messageId, query, and fallback state as props
  * - Only render when fallback prop is true
- * - Call SDK's showRecommendations() to fetch fresh recommendations
+ * - If previousRecommendations are provided and not empty: renders them directly (no API call)
+ * - If previousRecommendations are empty/null: calls SDK's showRecommendations() to fetch recommendations
  * - Display recommendations in the specified format (tail or product)
  *
+ * IMPORTANT: Pass previousRecommendations from WeaveAdFormatContainer to avoid duplicate API calls.
+ *
  * @example
  * ```tsx
  * const [fallback, setFallback] = useState(false);
@@ -61,6 +70,7 @@ export interface WeaveFallbackRecommendationsProps {
  *     query={userQuery}
  *     format="tail"
  *     fallback={fallback}
+ *     previousRecommendations={recommendations} // Pass from WeaveAdFormatContainer
  *   />
  * </AdMeshProvider>
  * ```

package/dist/components/WeaveFallbackRecommendations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WeaveFallbackRecommendations.d.ts","sourceRoot":"","sources":["../../src/components/WeaveFallbackRecommendations.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAsC,MAAM,OAAO,CAAC;AAI3D,MAAM,WAAW,iCAAiC;IAChD;;;;OAIG;IACH,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAE5B,iCAAiC;IACjC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAEjC;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;;;;;;;OASG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,4BAA4B,EAAE,KAAK,CAAC,EAAE,CAAC,iCAAiC,CA6FpF,CAAC;AAEF,eAAe,4BAA4B,CAAC"}
+{"version":3,"file":"WeaveFallbackRecommendations.d.ts","sourceRoot":"","sources":["../../src/components/WeaveFallbackRecommendations.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAsC,MAAM,OAAO,CAAC;AAI3D,MAAM,WAAW,iCAAiC;IAChD;;;;OAIG;IACH,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAE5B,iCAAiC;IACjC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAEjC;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;;;;;;;OASG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;OAIG;IACH,uBAAuB,CAAC,EAAE,GAAG,EAAE,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,eAAO,MAAM,4BAA4B,EAAE,KAAK,CAAC,EAAE,CAAC,iCAAiC,CAuOpF,CAAC;AAEF,eAAe,4BAA4B,CAAC"}

package/dist/context/AdMeshContext.d.ts

@@ -9,6 +9,15 @@ export interface AdMeshContextValue {
     apiKey: string;
     sessionId: string;
     theme?: AdMeshTheme;
+    language?: string;
+    geo_country?: string;
+    userId?: string;
+    model?: string;
+    messages?: Array<{
+        role: string;
+        content: string;
+        id?: string;
+    }>;
     processedMessageIds: Set<string>;
     markMessageAsProcessed: (messageId: string) => void;
     isMessageProcessed: (messageId: string) => boolean;

package/dist/context/AdMeshContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AdMeshContext.d.ts","sourceRoot":"","sources":["../../src/context/AdMeshContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAEjC,GAAG,EAAE,SAAS,GAAG,IAAI,CAAC;IAGtB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,WAAW,CAAC;IAGpB,mBAAmB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAGjC,sBAAsB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACpD,kBAAkB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;CACpD;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,+CAEzB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,kBAAkB,CAWrD"}
+{"version":3,"file":"AdMeshContext.d.ts","sourceRoot":"","sources":["../../src/context/AdMeshContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAEjC,GAAG,EAAE,SAAS,GAAG,IAAI,CAAC;IAGtB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,WAAW,CAAC;IAGpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAGjE,mBAAmB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAGjC,sBAAsB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACpD,kBAAkB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;CACpD;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,+CAEzB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,kBAAkB,CAWrD"}

package/dist/context/AdMeshProvider.d.ts

@@ -9,6 +9,20 @@ export interface AdMeshProviderProps {
     theme?: AdMeshTheme;
     /** Optional API base URL (defaults to production) */
     apiBaseUrl?: string;
+    /** Optional user language in BCP 47 format (e.g., "en-US") */
+    language?: string;
+    /** Optional user country code in ISO 3166-1 alpha-2 format (e.g., "US") */
+    geo_country?: string;
+    /** Optional anonymous hashed user ID */
+    userId?: string;
+    /** Optional AI model identifier (e.g., "gpt-4o") - used for producer.software_version in UCP PlatformRequest */
+    model?: string;
+    /** Optional conversation history - used for extensions.aip.messages in UCP PlatformRequest */
+    messages?: Array<{
+        role: string;
+        content: string;
+        id?: string;
+    }>;
     /** Child components */
     children: React.ReactNode;
 }

package/dist/context/AdMeshProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AdMeshProvider.d.ts","sourceRoot":"","sources":["../../src/context/AdMeshProvider.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAsC,MAAM,OAAO,CAAC;AAI3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,WAAW,mBAAmB;IAClC,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IAEf,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAElB,mCAAmC;IACnC,KAAK,CAAC,EAAE,WAAW,CAAC;IAEpB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,uBAAuB;IACvB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAiExD,CAAC;AAEF,eAAe,cAAc,CAAC"}
+{"version":3,"file":"AdMeshProvider.d.ts","sourceRoot":"","sources":["../../src/context/AdMeshProvider.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAsC,MAAM,OAAO,CAAC;AAI3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,WAAW,mBAAmB;IAClC,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IAEf,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAElB,mCAAmC;IACnC,KAAK,CAAC,EAAE,WAAW,CAAC;IAEpB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,gHAAgH;IAChH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAEjE,uBAAuB;IACvB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAyFxD,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/hooks/useAdMesh.d.ts

@@ -30,6 +30,20 @@ export declare function useAdMesh(): {
     sessionId: string;
     /** Theme configuration */
     theme: import('..').AdMeshTheme | undefined;
+    /** User language in BCP 47 format (e.g., "en-US") - from AdMeshProvider */
+    language: string | undefined;
+    /** User country code in ISO 3166-1 alpha-2 format (e.g., "US") - from AdMeshProvider */
+    geo_country: string | undefined;
+    /** Anonymous hashed user ID - from AdMeshProvider */
+    userId: string | undefined;
+    /** AI model identifier (e.g., "gpt-4o") - from AdMeshProvider */
+    model: string | undefined;
+    /** Conversation history - from AdMeshProvider */
+    messages: {
+        role: string;
+        content: string;
+        id?: string;
+    }[] | undefined;
     /** Set of processed message IDs (for deduplication) */
     processedMessageIds: Set<string>;
     /** Mark a message as processed to prevent duplicate recommendations */

package/dist/hooks/useAdMesh.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAdMesh.d.ts","sourceRoot":"","sources":["../../src/hooks/useAdMesh.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,SAAS;IAIrB,0BAA0B;;IAG1B,cAAc;;IAGd,iBAAiB;;IAGjB,0BAA0B;;IAG1B,uDAAuD;;IAGvD,uEAAuE;;IAGvE,oDAAoD;;EAGvD;AAED,eAAe,SAAS,CAAC"}
+{"version":3,"file":"useAdMesh.d.ts","sourceRoot":"","sources":["../../src/hooks/useAdMesh.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,SAAS;IAIrB,0BAA0B;;IAG1B,cAAc;;IAGd,iBAAiB;;IAGjB,0BAA0B;;IAG1B,2EAA2E;;IAG3E,wFAAwF;;IAGxF,qDAAqD;;IAGrD,iEAAiE;;IAGjE,iDAAiD;;;;;;IAGjD,uDAAuD;;IAGvD,uEAAuE;;IAGvE,oDAAoD;;EAGvD;AAED,eAAe,SAAS,CAAC"}

package/dist/index.d.ts

@@ -30,6 +30,8 @@ export { AdMeshTailAd } from './components/AdMeshTailAd';
 export type { AdMeshTailAdProps } from './components/AdMeshTailAd';
 export { AdMeshBridgeFormat } from './components/AdMeshBridgeFormat';
 export type { AdMeshBridgeFormatProps } from './components/AdMeshBridgeFormat';
+export { AdMeshFollowup } from './components/AdMeshFollowup';
+export type { AdMeshFollowupProps } from './components/AdMeshFollowup';
 export { AdMeshTailAd as AdMeshSummaryUnit } from './components/AdMeshTailAd';
 export type { AdMeshTailAdProps as AdMeshSummaryUnitProps } from './components/AdMeshTailAd';
 export { AdMeshViewabilityTracker } from './components/AdMeshViewabilityTracker';

package/dist/index.d.ts.map

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