@the_ro_show/agent-ads-sdk 0.14.2 → 0.16.0

package/dist/index.js

@@ -27,7 +27,6 @@ __export(index_exports, {
   NetworkError: () => NetworkError,
   TimeoutError: () => TimeoutError,
   buildTaxonomy: () => buildTaxonomy,
-  createClickEvent: () => createClickEvent,
   createImpressionEvent: () => createImpressionEvent,
   createOpportunity: () => createOpportunity,
   detectIntent: () => detectIntent,
@@ -247,31 +246,6 @@ function createImpressionEvent(params) {
   }
   return event;
 }
-function createClickEvent(params) {
-  const event = {
-    event_id: generateUUID(),
-    occurred_at: params.occurred_at ?? generateTimestamp(),
-    agent_id: params.agent_id,
-    request_id: params.request_id,
-    decision_id: params.decision_id,
-    unit_id: params.unit_id,
-    event_type: "click",
-    tracking_token: params.tracking_token
-  };
-  if (params.metadata !== void 0) {
-    event.metadata = {
-      ...params.metadata,
-      href: params.href,
-      click_context: params.click_context
-    };
-  } else {
-    event.metadata = {
-      href: params.href,
-      click_context: params.click_context
-    };
-  }
-  return event;
-}
 var HTML_ESCAPES = {
   "&": "&",
   "<": "&lt;",
@@ -353,6 +327,172 @@ function sanitizeURL(url, options) {
   }
 }
 
+// src/utils/intent-detector.ts
+var INTENT_PATTERNS = {
+  research: [
+    "what is",
+    "how does",
+    "explain",
+    "tell me about",
+    "learn about",
+    "understand",
+    "guide",
+    "tips",
+    "basics",
+    "introduction",
+    "overview",
+    "how to"
+  ],
+  comparison: [
+    "vs",
+    "versus",
+    "compare",
+    "better than",
+    "difference",
+    "which",
+    "choose between",
+    "alternative",
+    "review",
+    "pros and cons",
+    "best",
+    "top",
+    "recommend"
+  ],
+  ready_to_buy: [
+    "buy now",
+    "purchase",
+    "get quote",
+    "sign up",
+    "subscribe",
+    "order now",
+    "book now",
+    "reserve",
+    "apply now",
+    "start now",
+    "pricing",
+    "cost",
+    "how much",
+    "discount",
+    "deal",
+    "promo code",
+    "coupon",
+    "special offer",
+    "ready to buy",
+    "want to buy",
+    "where can i buy",
+    "how to purchase"
+  ]
+};
+var INTEREST_PATTERNS = {
+  travel: ["travel", "trip", "vacation", "flight", "hotel", "destination", "tour", "cruise"],
+  fitness: ["fitness", "workout", "gym", "exercise", "health", "diet", "nutrition", "yoga"],
+  technology: ["tech", "software", "app", "computer", "phone", "gadget", "device", "AI"],
+  finance: ["finance", "money", "invest", "savings", "loan", "credit", "mortgage", "budget"],
+  insurance: ["insurance", "coverage", "policy", "claim", "premium", "deductible"],
+  automotive: ["car", "auto", "vehicle", "drive", "truck", "SUV", "motorcycle"],
+  education: ["learn", "course", "class", "school", "university", "degree", "certification"],
+  shopping: ["shop", "store", "buy", "sale", "discount", "deal", "online shopping"],
+  food: ["food", "restaurant", "cooking", "recipe", "meal", "dining", "cuisine"],
+  entertainment: ["movie", "show", "music", "game", "concert", "event", "streaming"],
+  home: ["home", "house", "apartment", "furniture", "decor", "renovation", "real estate"],
+  business: ["business", "company", "startup", "entrepreneur", "marketing", "sales"],
+  legal: ["legal", "lawyer", "attorney", "law", "contract", "lawsuit", "court"],
+  healthcare: ["health", "medical", "doctor", "hospital", "treatment", "therapy", "medicine"],
+  parenting: ["baby", "child", "parent", "family", "kids", "pregnancy", "school"],
+  wedding: ["wedding", "marriage", "engagement", "bride", "groom", "ceremony"],
+  pets: ["pet", "dog", "cat", "animal", "vet", "puppy", "kitten"],
+  beauty: ["beauty", "makeup", "skincare", "hair", "cosmetics", "salon", "spa"],
+  sports: ["sports", "game", "team", "player", "football", "basketball", "soccer"],
+  fashion: ["fashion", "clothing", "style", "outfit", "designer", "shoes", "accessories"]
+};
+function detectIntentStage(message, conversationHistory) {
+  const lowerMessage = message.toLowerCase();
+  const fullContext = conversationHistory ? [...conversationHistory, message].join(" ").toLowerCase() : lowerMessage;
+  for (const pattern of INTENT_PATTERNS.ready_to_buy) {
+    if (fullContext.includes(pattern)) {
+      return "ready_to_buy";
+    }
+  }
+  for (const pattern of INTENT_PATTERNS.comparison) {
+    if (fullContext.includes(pattern)) {
+      return "comparison";
+    }
+  }
+  for (const pattern of INTENT_PATTERNS.research) {
+    if (lowerMessage.includes(pattern)) {
+      return "research";
+    }
+  }
+  return void 0;
+}
+function extractInterests(message, conversationHistory) {
+  const interests = /* @__PURE__ */ new Set();
+  const validHistory = (conversationHistory || []).filter((msg) => typeof msg === "string" && msg.trim().length > 0);
+  const fullContext = validHistory.length > 0 ? [...validHistory, message].join(" ").toLowerCase() : message.toLowerCase();
+  for (const [interest, keywords] of Object.entries(INTEREST_PATTERNS)) {
+    for (const keyword of keywords) {
+      if (fullContext.includes(keyword)) {
+        interests.add(interest);
+        break;
+      }
+    }
+  }
+  return Array.from(interests);
+}
+function extractTopics(conversationHistory) {
+  if (!conversationHistory || conversationHistory.length === 0) {
+    return [];
+  }
+  const topics = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const message of conversationHistory.slice(-5)) {
+    const lowerMessage = message.toLowerCase();
+    for (const [topic, keywords] of Object.entries(INTEREST_PATTERNS)) {
+      if (!seen.has(topic)) {
+        for (const keyword of keywords) {
+          if (lowerMessage.includes(keyword)) {
+            topics.push(topic);
+            seen.add(topic);
+            break;
+          }
+        }
+      }
+    }
+  }
+  return topics.slice(0, 3);
+}
+function generateSessionId() {
+  const timestamp = Date.now().toString(36);
+  const random = Math.random().toString(36).substring(2, 9);
+  return `sess_${timestamp}_${random}`;
+}
+function detectPurchaseIntent(message, intentStage) {
+  if (intentStage === "ready_to_buy") {
+    return true;
+  }
+  const lowerMessage = message.toLowerCase();
+  const purchaseKeywords = [
+    "buy",
+    "purchase",
+    "order",
+    "get",
+    "subscribe",
+    "sign up",
+    "apply",
+    "book",
+    "reserve",
+    "quote",
+    "pricing",
+    "cost",
+    "how much",
+    "where can i"
+  ];
+  return purchaseKeywords.some((keyword) => lowerMessage.includes(keyword));
+}
+function calculateMessageCount(conversationHistory) {
+  return (conversationHistory?.length || 0) + 1;
+}
+
 // src/client.ts
 var DEFAULT_BASE_URL = "https://peruwnbrqkvmrldhpoom.supabase.co/functions/v1";
 var DEFAULT_TIMEOUT_MS = 4e3;
@@ -498,6 +638,16 @@ var AttentionMarketClient = class {
     const limitedHistory = history.slice(-historyLimit);
     const contextParts = [...limitedHistory, params.userMessage];
     const context = contextParts.join("\n");
+    const intentStage = params.session_context?.intent_stage || detectIntentStage(params.userMessage, limitedHistory);
+    let interests = params.user_context?.interests || extractInterests(params.userMessage, limitedHistory);
+    interests = interests.filter((interest) => typeof interest === "string" && interest.trim().length > 0).map((interest) => interest.trim().toLowerCase()).slice(0, 10);
+    let recentTopics = params.user_context?.recent_topics || extractTopics(limitedHistory);
+    recentTopics = recentTopics.filter((topic) => typeof topic === "string" && topic.trim().length > 0).map((topic) => topic.trim().toLowerCase()).slice(0, 5);
+    const purchaseIntent = params.user_context?.purchase_intent !== void 0 ? Boolean(params.user_context.purchase_intent) : detectPurchaseIntent(params.userMessage, intentStage);
+    const rawSessionId = params.session_context?.session_id;
+    const sessionId = typeof rawSessionId === "string" && rawSessionId.trim().length > 0 ? rawSessionId.trim().slice(0, 100) : generateSessionId();
+    const rawMessageCount = params.session_context?.message_count;
+    const messageCount = typeof rawMessageCount === "number" && rawMessageCount >= 0 ? Math.min(rawMessageCount, 1e3) : calculateMessageCount(limitedHistory);
     const country = params.country || "US";
     const language = params.language || "en";
     const platform = params.platform || "web";
@@ -586,6 +736,23 @@ var AttentionMarketClient = class {
       user_intent: params.userMessage,
       // Use minimal response format by default for better performance
       response_format: "minimal",
+      // === Smart Context Fields (v0.15.0) ===
+      // Include user context if we have any data
+      ...(interests.length > 0 || recentTopics.length > 0 || purchaseIntent) && {
+        user_context: {
+          ...interests.length > 0 && { interests },
+          ...recentTopics.length > 0 && { recent_topics: recentTopics },
+          ...purchaseIntent && { purchase_intent: purchaseIntent }
+        }
+      },
+      // Include session context
+      ...sessionId && {
+        session_context: {
+          session_id: sessionId,
+          message_count: messageCount,
+          ...intentStage && { intent_stage: intentStage }
+        }
+      },
       // Developer controls (Phase 1: Quality & Brand Safety)
       ...params.minQualityScore !== void 0 && { minQualityScore: params.minQualityScore },
       ...params.allowedCategories && { allowedCategories: params.allowedCategories },
@@ -704,52 +871,6 @@ var AttentionMarketClient = class {
     const event = createImpressionEvent(params);
     return await this.track(event);
   }
-  /**
-   * Convenience method to track a click event.
-   * Creates a click event using createClickEvent() and calls track().
-   */
-  async trackClick(params) {
-    const event = createClickEvent(params);
-    return await this.track(event);
-  }
-  /**
-   * Ultra-simple method to track a click from an ad returned by decideFromContext().
-   * Automatically extracts all required fields from the ad object.
-   *
-   * @param ad - The ad object returned by decideFromContext()
-   * @param options - Just click_context (what you showed the user)
-   *
-   * @example
-   * ```typescript
-   * const ad = await client.decideFromContext({ userMessage: "I need car insurance" });
-   * if (ad) {
-   *   await client.trackClickFromAd(ad, {
-   *     click_context: "Progressive: Get 20% off - Compare quotes"
-   *   });
-   * }
-   * ```
-   */
-  async trackClickFromAd(ad, options) {
-    if (!this.agentId) {
-      throw new Error("agentId is required for trackClickFromAd(). Set it in the constructor.");
-    }
-    const trackParams = {
-      agent_id: this.agentId,
-      request_id: ad.request_id,
-      decision_id: ad.decision_id,
-      unit_id: ad._ad.unit_id,
-      tracking_token: ad.tracking_token,
-      href: ad.click_url,
-      click_context: options.click_context
-    };
-    if (options.metadata) {
-      trackParams.metadata = options.metadata;
-    }
-    if (options.occurred_at) {
-      trackParams.occurred_at = options.occurred_at;
-    }
-    return await this.trackClick(trackParams);
-  }
   /**
    * Send feedback on an ad's performance to earn conversion-validated bonuses.
    *
@@ -1864,7 +1985,6 @@ function suggestTaxonomies(query) {
   NetworkError,
   TimeoutError,
   buildTaxonomy,
-  createClickEvent,
   createImpressionEvent,
   createOpportunity,
   detectIntent,