@chat-ads/chatads-sdk 0.1.10 → 0.1.12

package/README.md

@@ -29,8 +29,8 @@ const response = await client.analyze({
   ip: "8.8.8.8",
 });
 
-if (response.success && response.data?.Offers.length) {
-  console.log(response.data.Offers[0]);
+if (response.data?.offers?.length) {
+  console.log(response.data.offers[0]);
 } else {
   console.error(response.error);
 }
@@ -45,7 +45,7 @@ const result = await client.analyzeMessage("Need scheduling ideas", {
 ```
 
 - Reserved payload keys (like `message`, `country`, etc.) cannot be overwritten inside `extraFields`; the client throws if it detects a collision.
-- Pass `raiseOnFailure: true` to throw `ChatAdsAPIError` when the API returns `success: false` with HTTP 200 responses.
+- Pass `raiseOnFailure: true` to throw `ChatAdsAPIError` when the API returns an error with HTTP 200 responses.
 - Retries honor `Retry-After` headers and exponential backoff (`maxRetries` + `retryBackoffFactorMs`).
 
 ## Error handling
@@ -66,7 +66,7 @@ try {
 }
 ```
 
-`ChatAdsAPIError` wraps non-2xx API responses (and optionally `success:false`). `ChatAdsSDKError` covers local issues like invalid payloads, timeouts, or missing `fetch`.
+`ChatAdsAPIError` wraps non-2xx API responses (and optionally error responses). `ChatAdsSDKError` covers local issues like invalid payloads, timeouts, or missing `fetch`.
 
 ## Configuration options
 
@@ -77,9 +77,9 @@ try {
 | `endpoint` | Defaults to `/v1/chatads/messages`. Override if you host multiple versions. |
 | `timeoutMs` | Request timeout (default 10s). |
 | `maxRetries` | How many automatic retries to attempt for retryable HTTP statuses. |
-| `retryStatuses` | Array of status codes treated as retryable (defaults to `408, 429, 5xx`). |
+| `retryStatuses` | Array of status codes treated as retryable (defaults to `408, 429, 500, 502, 503, 504`). |
 | `retryBackoffFactorMs` | Base backoff delay in milliseconds (default 500). |
-| `raiseOnFailure` | Throw when the API returns `success:false` even if HTTP 200. |
+| `raiseOnFailure` | Throw when the API returns an error even if HTTP 200. |
 | `fetchImplementation` | Provide a custom `fetch` for Node < 18 or custom runtimes. |
 | `logger` | Optional logger (any object with `debug`). Useful for redacted request logs. |
 
@@ -87,19 +87,16 @@ try {
 
 ```json
 {
-  "success": true,
   "data": {
-    "Status": "filled",
-    "Offers": [
+    "status": "filled",
+    "offers": [
       {
-        "LinkText": "CRM tools",
-        "IntentLevel": "high",
-        "URL": "https://amazon.com/dp/example?tag=chatads-20",
-        "Category": "Software"
+        "link_text": "CRM tools",
+        "url": "https://amazon.com/dp/example?tag=chatads-20"
       }
     ],
-    "Requested": 1,
-    "Returned": 1
+    "requested": 1,
+    "returned": 1
   },
   "error": null,
   "meta": {

package/dist/client.js

@@ -3,7 +3,7 @@ import { RESERVED_PAYLOAD_KEYS } from "./models.js";
 const DEFAULT_ENDPOINT = "/v1/chatads/messages";
 const DEFAULT_TIMEOUT_MS = 10000;
 const DEFAULT_BACKOFF_FACTOR = 500; // ms
-const DEFAULT_RETRYABLE_STATUSES = new Set([408, 409, 425, 429, 500, 502, 503, 504]);
+const DEFAULT_RETRYABLE_STATUSES = new Set([408, 429, 500, 502, 503, 504]);
 /**
  * Field aliases for normalizing optional field names.
  * Only includes the 3 optional fields from the OpenAPI spec.
@@ -48,9 +48,9 @@ export class ChatAdsClient {
     async post(body, options) {
         const url = `${this.baseUrl}${this.endpoint}`;
         const headers = {
+            ...lowercaseHeaders(options?.headers),
             "content-type": "application/json",
             "x-api-key": this.apiKey,
-            ...lowercaseHeaders(options?.headers),
         };
         let attempt = 0;
         // eslint-disable-next-line no-constant-condition
@@ -127,6 +127,8 @@ function normalizeBaseUrl(raw) {
         return url.toString().replace(/\/$/, "");
     }
     catch (error) {
+        if (error instanceof ChatAdsSDKError)
+            throw error;
         throw new ChatAdsSDKError(`Invalid baseUrl: ${raw}`, error);
     }
 }
@@ -184,6 +186,7 @@ async function parseResponse(response) {
                 returned: data.returned ?? 0,
                 extraction_source: data.extraction_source,
                 extraction_debug: data.extraction_debug,
+                resolution_debug: data.resolution_debug,
             },
             error: raw.error,
             meta: raw.meta ?? { request_id: "unknown" },

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 export { ChatAdsClient } from "./client.js";
 export { ChatAdsAPIError, ChatAdsSDKError } from "./errors.js";
 export type { ChatAdsClientOptions, AnalyzeOptions, AnalyzeMessageOptions, } from "./client.js";
-export type { ChatAdsResponseEnvelope, Offer, Product, AnalyzeData, ChatAdsError, ChatAdsMeta, UsageInfo, FunctionItemPayload, FunctionItemOptionalFields, Quality, ConfidenceLevel, ResponseStatus, ResolutionSource, } from "./models.js";
+export type { ChatAdsResponseEnvelope, Offer, Product, AnalyzeData, ChatAdsError, ChatAdsMeta, UsageInfo, FunctionItemPayload, FunctionItemOptionalFields, Quality, ResponseStatus, } from "./models.js";

package/dist/models.d.ts

@@ -1,6 +1,4 @@
 export type Quality = "fast" | "standard" | "best";
-export type ConfidenceLevel = "high" | "medium" | "low" | "very_low";
-export type ResolutionSource = "demo" | "serper" | "amazon_paapi" | "cache" | "vector";
 /** Top-level response status indicating the outcome of the request */
 export type ResponseStatus = "filled" | "partial_fill" | "no_offers_found" | "internal_error";
 /**
@@ -43,14 +41,12 @@ export interface Offer {
     search_term?: string;
     /** Confidence score (0.0-1.0) (verbose mode only) */
     confidence_score?: number | null;
-    /** Confidence level classification */
-    confidence_level: string;
+    /** Confidence level classification (verbose mode only) */
+    confidence_level?: string;
     /** Affiliate URL (always populated) */
     url: string;
     /** Source of the URL resolution (e.g., amazon, serper, vector) (verbose mode only) */
     resolution_source?: string;
-    /** Detected product category */
-    category?: string;
     /** Product metadata from resolution */
     product?: Product;
 }
@@ -70,6 +66,8 @@ export interface AnalyzeData {
     extraction_source?: string;
     /** Extraction debug information (verbose mode only) */
     extraction_debug?: unknown[];
+    /** Resolution debug information (verbose mode only) */
+    resolution_debug?: unknown[];
 }
 export interface ChatAdsError {
     code: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chat-ads/chatads-sdk",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "TypeScript/JavaScript client for the ChatAds prospect scoring API",
   "license": "MIT",
   "type": "module",