@ai-ad-network/frontend-sdk 1.1.1 → 1.1.3

package/dist/components/EnhancedContent.d.ts

@@ -1,4 +1,4 @@
-import type { EntityInfo, EnhancedContentProps } from '@/types';
+import type { EntityInfo, EnhancementOptions, EnhancedContentProps, KoahAd } from '@/types';
 /**
  * EnhancedContent Component
  *
@@ -51,3 +51,52 @@ export declare function useEntityStats(entities: EntityInfo[]): {
     byType: Record<string, number>;
     avgConfidence: number;
 };
+/**
+ * EnhancedContentV2 Props
+ */
+export interface EnhancedContentV2Props {
+    /** The ad data containing entity_link_content */
+    ad: KoahAd;
+    /** AI response context for styling */
+    aiContext?: string;
+    /** Custom class name */
+    className?: string;
+    /** Whether tracking is loading (unused but for API compatibility) */
+    isLoading?: boolean;
+    requestId: string;
+    slotId: string;
+    position: number;
+    totalAds: number;
+    enhancements?: EnhancementOptions;
+    onEntityClick?: (entity: EntityInfo) => void;
+    onImpression?: () => void;
+}
+/**
+ * EnhancedContentV2 - Entity Link Ad component with Analytics API tracking
+ *
+ * Renders content with entity-linked affiliate URLs and tracks clicks
+ * using the new Analytics API (POST /api/v1/ads/click).
+ *
+ * @example
+ * ```tsx
+ * <EnhancedContentV2
+ *   ad={ad}
+ *   requestId="req-123"
+ *   slotId="slot-entity-link"
+ *   position={0}
+ *   totalAds={3}
+ * />
+ * ```
+ */
+export declare function EnhancedContentV2({ ad, aiContext, className, isLoading: _isLoading, requestId, slotId, position, totalAds, enhancements, onEntityClick, onImpression, }: EnhancedContentV2Props): import("react/jsx-runtime").JSX.Element;
+/**
+ * Convenience components for V2
+ */
+/**
+ * Inline variant - for embedding within existing text
+ */
+export declare function EnhancedContentV2Inline(props: Omit<EnhancedContentV2Props, 'className'>): import("react/jsx-runtime").JSX.Element;
+/**
+ * Block variant - for standalone content blocks
+ */
+export declare function EnhancedContentV2Block(props: EnhancedContentV2Props): import("react/jsx-runtime").JSX.Element;

package/dist/components/EntityLinkAd.simple.d.ts

@@ -0,0 +1,76 @@
+import type { KoahAd, BadgeStyle, OverlapStrategy } from '@/types';
+import type { EntityInfo } from '@/types';
+/**
+ * 🆕 Simplified EntityLinkAd Props
+ *
+ * This component automatically handles all analytics tracking parameters.
+ * You only need to provide the ad data and slot ID.
+ */
+export interface EntityLinkAdProps {
+    /** The ad data to display (must contain entity_link_content) */
+    ad: KoahAd;
+    /** Slot identifier (business concept, e.g., "inline-entity", "content-enhancement") */
+    slotId: string;
+    /** AI response context for template selection */
+    aiContext?: string;
+    /** Custom class name */
+    className?: string;
+    /** Loading state */
+    isLoading?: boolean;
+    /** Badge style for entity links */
+    badgeStyle?: BadgeStyle;
+    /** Strategy for handling overlapping entities */
+    overlapStrategy?: OverlapStrategy;
+    /** Maximum number of entity links to show */
+    maxLinks?: number;
+    /** Minimum confidence threshold for entities */
+    minConfidence?: number;
+    /** Custom click callback (in addition to automatic tracking) */
+    onEntityClick?: (entity: EntityInfo) => void;
+    /** Custom impression callback (in addition to automatic tracking) */
+    onImpression?: () => void;
+}
+/**
+ * EntityLinkAd - Simplified component with automatic analytics tracking
+ *
+ * This component automatically injects all analytics tracking parameters
+ * (requestId, position, totalAds) from the SDK context and renders
+ * entity-linked content with click tracking.
+ *
+ * @example
+ * ```tsx
+ * // ✅ Simple usage - automatic tracking
+ * import { EntityLinkAd } from '@ai-ad-network/frontend-sdk';
+ *
+ * <EntityLinkAd
+ *   ad={ad}
+ *   slotId="inline-entity"
+ *   aiContext={aiResponse}
+ *   badgeStyle="subtle"
+ * />
+ *
+ * // With multiple ads
+ * {ads.map(ad => (
+ *   <EntityLinkAd
+ *     key={ad.id}
+ *     ad={ad}
+ *     slotId="inline-entity"
+ *   />
+ * ))}
+ * ```
+ *
+ * @remarks
+ * For advanced use cases where you need explicit control over analytics parameters,
+ * use `EnhancedContentV2` directly.
+ */
+export declare function EntityLinkAd({ ad, slotId, aiContext, className, isLoading, badgeStyle, overlapStrategy, maxLinks, minConfidence, onEntityClick, onImpression, }: EntityLinkAdProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * EntityLinkAdInline - Inline variant for embedding within existing text
+ */
+export declare function EntityLinkAdInline(props: Omit<EntityLinkAdProps, 'className'>): import("react/jsx-runtime").JSX.Element;
+/**
+ * EntityLinkAdBlock - Block variant for standalone content blocks
+ */
+export declare function EntityLinkAdBlock(props: EntityLinkAdProps): import("react/jsx-runtime").JSX.Element;
+export { EnhancedContentV2 } from './EnhancedContent';
+export type { EnhancedContentV2Props } from './EnhancedContent';

package/dist/hooks/useAiAds.d.ts

@@ -1,4 +1,4 @@
-import type { KoahAd, IntentResult, RoutingInfo, UseAiAdsOptions, UseAiAdsResult } from '@/types';
+import type { KoahAd, IntentResult, RoutingInfo, UseAiAdsOptions, UseAiAdsResult, AdFormat } from '@/types';
 /**
  * useAiAds - Core hook for fetching AI-powered native ads
  *
@@ -9,6 +9,8 @@ import type { KoahAd, IntentResult, RoutingInfo, UseAiAdsOptions, UseAiAdsResult
  *
  * Uses the unified /api/v1/ads/request endpoint with auto-injected ClientInfo.
  *
+ * 🆕 Automatically stabilizes options to prevent infinite render loops.
+ *
  * @example
  * ```tsx
  * const { ads, intent, isLoading, error } = useAiAds(
@@ -43,6 +45,8 @@ export declare function useAiadsWithAnalytics(userQuery: string, aiResponse: str
  *
  * Uses the unified /api/v1/ads/request endpoint with auto-injected ClientInfo.
  *
+ * 🆕 Automatically stabilizes options to prevent infinite render loops.
+ *
  * @example
  * ```tsx
  * const { fetchAds, ads, isLoading } = useAiAdsLazy();
@@ -57,7 +61,7 @@ export declare function useAiAdsLazy(options?: UseAiAdsOptions): {
     routing: RoutingInfo | null;
     isLoading: boolean;
     error: Error | null;
-    fetchAds: (query: string, response: string, customFormats?: import("@/types").AdFormat[]) => Promise<void>;
+    fetchAds: (query: string, response: string, customFormats?: AdFormat[]) => Promise<void>;
     reset: () => void;
 };
 /**

package/dist/index.d.ts

@@ -35,7 +35,11 @@ export { ActionCardAd } from './components/ActionCardAd.simple';
 export { ActionCardAdV2 } from './components/ActionCardAd';
 export type { ActionCardAdV2Props } from './components/ActionCardAd';
 export type { ActionCardAdProps } from './components/ActionCardAd.simple';
+export { EntityLinkAd, EntityLinkAdInline, EntityLinkAdBlock } from './components/EntityLinkAd.simple';
+export { EnhancedContentV2, EnhancedContentV2Inline, EnhancedContentV2Block, } from './components/EnhancedContent';
 export { EnhancedContent, EnhancedContentInline, EnhancedContentBlock, useEntityStats, } from './components/EnhancedContent';
+export type { EnhancedContentV2Props } from './components/EnhancedContent';
+export type { EntityLinkAdProps } from './components/EntityLinkAd.simple';
 export { SuffixAd } from './components/SuffixAd.simple';
 export { SuffixAdV2 } from './components/SuffixAd';
 export { SuffixAdInline, SuffixAdMinimal, } from './components/SuffixAd';