@the_ro_show/agent-ads-sdk 0.13.0 → 0.13.1

package/dist/index.mjs

@@ -454,6 +454,60 @@ var AttentionMarketClient = class {
     const platform = params.platform || "web";
     const placementType = params.placement || "sponsored_suggestion";
     const taxonomy = params.suggestedCategory || this.inferTaxonomy(params.userMessage);
+    if (params.minQualityScore !== void 0) {
+      if (typeof params.minQualityScore !== "number" || params.minQualityScore < 0 || params.minQualityScore > 1) {
+        throw new Error("minQualityScore must be a number between 0.0 and 1.0");
+      }
+    }
+    if (params.allowedCategories !== void 0) {
+      if (!Array.isArray(params.allowedCategories)) {
+        throw new Error("allowedCategories must be an array");
+      }
+      if (params.allowedCategories.length === 0) {
+        throw new Error("allowedCategories cannot be empty (would block all ads). Use blockedCategories to exclude specific categories, or omit to allow all.");
+      }
+      for (const cat of params.allowedCategories) {
+        if (typeof cat !== "string" && typeof cat !== "number") {
+          throw new Error(`allowedCategories must contain strings or numbers, found: ${typeof cat}`);
+        }
+      }
+    }
+    if (params.blockedCategories !== void 0) {
+      if (!Array.isArray(params.blockedCategories)) {
+        throw new Error("blockedCategories must be an array");
+      }
+      for (const cat of params.blockedCategories) {
+        if (typeof cat !== "string" && typeof cat !== "number") {
+          throw new Error(`blockedCategories must contain strings or numbers, found: ${typeof cat}`);
+        }
+      }
+      if (params.allowedCategories && params.allowedCategories.length > 0) {
+        console.warn("[AttentionMarket] Both allowedCategories and blockedCategories specified. blockedCategories will be ignored.");
+      }
+    }
+    if (params.blockedAdvertisers !== void 0) {
+      if (!Array.isArray(params.blockedAdvertisers)) {
+        throw new Error("blockedAdvertisers must be an array");
+      }
+      for (const id of params.blockedAdvertisers) {
+        if (typeof id !== "string" || id.trim().length === 0) {
+          throw new Error("blockedAdvertisers must contain non-empty strings (advertiser IDs)");
+        }
+      }
+    }
+    if (params.minCPC !== void 0) {
+      if (typeof params.minCPC !== "number" || params.minCPC < 0) {
+        throw new Error("minCPC must be a non-negative number (cost-per-click in cents)");
+      }
+    }
+    if (params.minRelevanceScore !== void 0) {
+      if (typeof params.minRelevanceScore !== "number" || params.minRelevanceScore < 0 || params.minRelevanceScore > 1) {
+        throw new Error("minRelevanceScore must be a number between 0.0 and 1.0");
+      }
+    }
+    if (params.optimizeFor && params.optimizeFor !== "revenue" && params.optimizeFor !== "relevance") {
+      throw new Error('optimizeFor must be either "revenue" or "relevance"');
+    }
     const request = {
       request_id: generateUUID(),
       agent_id: this.agentId,
@@ -485,7 +539,11 @@ var AttentionMarketClient = class {
       ...params.minQualityScore !== void 0 && { minQualityScore: params.minQualityScore },
       ...params.allowedCategories && { allowedCategories: params.allowedCategories },
       ...params.blockedCategories && { blockedCategories: params.blockedCategories },
-      ...params.blockedAdvertisers && { blockedAdvertisers: params.blockedAdvertisers }
+      ...params.blockedAdvertisers && { blockedAdvertisers: params.blockedAdvertisers },
+      // Developer controls (Phase 2: Revenue Optimization)
+      ...params.minCPC !== void 0 && { minCPC: params.minCPC },
+      ...params.minRelevanceScore !== void 0 && { minRelevanceScore: params.minRelevanceScore },
+      ...params.optimizeFor && { optimizeFor: params.optimizeFor }
     };
     const response = await this.decideRaw(request, options);
     if (response.status === "no_fill" || response.units.length === 0) {