@the_ro_show/agent-ads-sdk 0.11.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,
@@ -480,7 +534,16 @@ var AttentionMarketClient = class {
         }
       },
       context,
-      user_intent: params.userMessage
+      user_intent: params.userMessage,
+      // Developer controls (Phase 1: Quality & Brand Safety)
+      ...params.minQualityScore !== void 0 && { minQualityScore: params.minQualityScore },
+      ...params.allowedCategories && { allowedCategories: params.allowedCategories },
+      ...params.blockedCategories && { blockedCategories: params.blockedCategories },
+      ...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) {
@@ -1107,6 +1170,55 @@ var AttentionMarketClient = class {
       { body: params }
     );
   }
+  /**
+   * Get IAB Content Taxonomy categories.
+   *
+   * Returns the complete IAB Content Taxonomy 3.0 (704 categories across 38 top-level categories).
+   * Supports filtering by tier level, parent category, or search term.
+   *
+   * Use this to discover available categories for `allowedCategories` and `blockedCategories` parameters.
+   *
+   * @param params - Optional filters (tier, parent_id, search)
+   * @returns The IAB Content Taxonomy with categories
+   *
+   * @example Get all Tier 1 categories (38 top-level categories)
+   * ```typescript
+   * const tier1 = await client.getCategories({ tier: 1 });
+   * console.log(`${tier1.total} top-level categories`);
+   * tier1.categories.forEach(cat => console.log(`${cat.id}: ${cat.name}`));
+   * ```
+   *
+   * @example Get all subcategories of "Automotive" (ID: 1)
+   * ```typescript
+   * const automotiveCategories = await client.getCategories({ parent_id: 1 });
+   * console.log(`Found ${automotiveCategories.total} automotive subcategories`);
+   * ```
+   *
+   * @example Search for insurance-related categories
+   * ```typescript
+   * const insuranceCategories = await client.getCategories({ search: 'insurance' });
+   * insuranceCategories.categories.forEach(cat => {
+   *   console.log(`${cat.id}: ${cat.full_path}`);
+   * });
+   * ```
+   */
+  async getCategories(params) {
+    const queryParams = new URLSearchParams();
+    if (params?.tier) {
+      queryParams.append("tier", params.tier.toString());
+    }
+    if (params?.parent_id) {
+      queryParams.append("parent_id", params.parent_id.toString());
+    }
+    if (params?.search) {
+      queryParams.append("search", params.search);
+    }
+    const url = `/v1/categories${queryParams.toString() ? "?" + queryParams.toString() : ""}`;
+    return await this.http.request(
+      "GET",
+      url
+    );
+  }
 };
 
 // src/mock-client.ts