@chat-ads/chatads-sdk 0.1.12 → 0.1.13

package/README.md

@@ -44,6 +44,15 @@ const result = await client.analyzeMessage("Need scheduling ideas", {
 });
 ```
 
+### Image search
+
+```ts
+const result = await client.analyze({
+  message: "https://example.com/product-image.jpg",
+  input_type: "image_url",
+});
+```
+
 - 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 an error with HTTP 200 responses.
 - Retries honor `Retry-After` headers and exponential backoff (`maxRetries` + `retryBackoffFactorMs`).

package/dist/client.js

@@ -6,7 +6,7 @@ const DEFAULT_BACKOFF_FACTOR = 500; // ms
 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.
+ * Field aliases for normalizing optional field names.
  */
 const FIELD_ALIASES = {
     fillpriority: "quality",
@@ -187,6 +187,7 @@ async function parseResponse(response) {
                 extraction_source: data.extraction_source,
                 extraction_debug: data.extraction_debug,
                 resolution_debug: data.resolution_debug,
+                input_type: data.input_type,
             },
             error: raw.error,
             meta: raw.meta ?? { request_id: "unknown" },

package/dist/models.d.ts

@@ -3,7 +3,6 @@ export type Quality = "fast" | "standard" | "best";
 export type ResponseStatus = "filled" | "partial_fill" | "no_offers_found" | "internal_error";
 /**
  * Optional fields for ChatAds API requests.
- * Only these 3 optional fields are supported (plus required `message`).
  */
 export type FunctionItemOptionalFields = {
     /** Client IP address for geo-detection (max 45 characters) */
@@ -12,6 +11,8 @@ export type FunctionItemOptionalFields = {
     country?: string;
     /** Resolution quality level. Default: "standard" */
     quality?: Quality;
+    /** Content type of the input message. Default: "text" */
+    input_type?: "text" | "image_url" | "image_file";
 };
 export type FunctionItemPayload = {
     message: string;
@@ -68,6 +69,8 @@ export interface AnalyzeData {
     extraction_debug?: unknown[];
     /** Resolution debug information (verbose mode only) */
     resolution_debug?: unknown[];
+    /** Request input type (verbose mode only) */
+    input_type?: string;
 }
 export interface ChatAdsError {
     code: string;
@@ -99,6 +102,6 @@ export interface ChatAdsResponseEnvelope {
 }
 /**
  * Reserved payload keys that cannot be used in extraFields.
- * These are the 4 allowed request fields per the OpenAPI spec.
+ * These are the allowed request fields per the OpenAPI spec.
  */
 export declare const RESERVED_PAYLOAD_KEYS: ReadonlySet<string>;

package/dist/models.js

@@ -1,10 +1,11 @@
 /**
  * Reserved payload keys that cannot be used in extraFields.
- * These are the 4 allowed request fields per the OpenAPI spec.
+ * These are the allowed request fields per the OpenAPI spec.
  */
 export const RESERVED_PAYLOAD_KEYS = new Set([
     "message",
     "ip",
     "country",
     "quality",
+    "input_type",
 ]);

package/package.json

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