@getanyapi/sdk 0.9.7 → 0.9.9

package/dist/index.d.cts

@@ -8,8 +8,11 @@ interface RunResult<T> {
     provider: "AnyAPI";
     /** Amount charged in USD for this call. */
     costUsd: number;
-    /** Number of result rows returned (present on per-result SKUs). */
-    items?: number;
+    /**
+     * Number of result rows returned. Always present on the wire: the gateway's field
+     * carries no `omitempty`, and a metadata-only replay preserves the original count.
+     */
+    items: number;
     /**
      * True when the gateway served a stored response for a repeated Idempotency-Key instead
      * of running the SKU again. A replay is not billed twice. Always present on the wire.
@@ -55,8 +58,11 @@ interface BareRunResult<T> {
     provider: "AnyAPI";
     /** Amount charged in USD for this call. */
     costUsd: number;
-    /** Number of result rows returned (present on per-result SKUs). */
-    items?: number;
+    /**
+     * Number of result rows returned. Always present on the wire: the gateway's field
+     * carries no `omitempty`, and a metadata-only replay preserves the original count.
+     */
+    items: number;
     /**
      * True when the gateway served a stored response for a repeated Idempotency-Key instead
      * of running the SKU again. A replay is not billed twice. Always present on the wire.
@@ -108,6 +114,8 @@ interface RequestOptions {
     signal?: AbortSignal;
     /** Override the client maxRetries for this call. */
     maxRetries?: number;
+    /** Override the client maxInProgressWaitMs for this call. */
+    maxInProgressWaitMs?: number;
     /** Override the generated Idempotency-Key for this billed POST. */
     idempotencyKey?: string;
 }
@@ -127,6 +135,13 @@ interface ClientOptions {
     timeoutMs?: number;
     /** Send Idempotency-Key on billed POSTs. Default "auto"; use "off" as a kill switch. */
     idempotency?: "auto" | "off";
+    /**
+     * Total milliseconds one run() call may block waiting out a 409 `idempotency_in_progress`
+     * (the gateway is still executing the run this key claims). Default 60000. Set 0 to
+     * surface that 409 immediately. This is a whole-call budget across every in-progress
+     * wait, separate from the 8000ms ordinary-backoff ceiling.
+     */
+    maxInProgressWaitMs?: number;
 }
 /**
  * Account profile returned by /v1/me (internal-only fields dropped). See SPEC 2.7.
@@ -162,7 +177,7 @@ interface DiscoveryPricing {
     failoverMaxUsd: number;
 }
 interface LaneHealth {
-    window: "30d";
+    window: string;
     uptimePct: number;
     latencyP50Ms: number;
     requests: number;
@@ -183,6 +198,8 @@ interface CatalogEntry {
     lanes: DiscoveryLane[];
     heavy: boolean;
     tryEligible: boolean;
+    failover?: boolean;
+    excludesCallerDelay?: boolean;
     inputSchema?: Record<string, unknown>;
     outputSchema?: Record<string, unknown>;
 }
@@ -257,6 +274,7 @@ declare class AnyAPI$1 implements ClientCore {
     private readonly maxRetries;
     private readonly timeoutMs;
     private readonly idempotency;
+    private readonly maxInProgressWaitMs;
     /**
      * The network seam the generated per-platform namespaces target. The base client IS a
      * ClientCore (it implements `run`), so the generated subclass hands `this._core` to each
@@ -292,6 +310,7 @@ declare class AnyAPI$1 implements ClientCore {
         body?: string;
         timeoutMs: number;
         maxRetries: number;
+        maxInProgressWaitMs?: number;
         signal?: AbortSignal;
         idempotencyKey?: string;
     }): Promise<T>;
@@ -337,7 +356,10 @@ declare function paginate<Item, Page extends RunResult<unknown> | BareRunResult<
 declare class AnyAPIError extends Error {
     /** HTTP status code, or 0 for transport-level failures (connection/timeout). */
     readonly status: number;
-    /** The x-request-id response header when present, else undefined. */
+    /**
+     * The gateway's X-Anyapi-Request-Id response header when present (falling back to a
+     * proxy-set x-request-id), else undefined. Quote it to AnyAPI support.
+     */
     readonly requestId?: string;
     /** Stable gateway error code when the JSON body includes one, else undefined. */
     readonly code?: string;

package/dist/index.d.ts

@@ -8,8 +8,11 @@ interface RunResult<T> {
     provider: "AnyAPI";
     /** Amount charged in USD for this call. */
     costUsd: number;
-    /** Number of result rows returned (present on per-result SKUs). */
-    items?: number;
+    /**
+     * Number of result rows returned. Always present on the wire: the gateway's field
+     * carries no `omitempty`, and a metadata-only replay preserves the original count.
+     */
+    items: number;
     /**
      * True when the gateway served a stored response for a repeated Idempotency-Key instead
      * of running the SKU again. A replay is not billed twice. Always present on the wire.
@@ -55,8 +58,11 @@ interface BareRunResult<T> {
     provider: "AnyAPI";
     /** Amount charged in USD for this call. */
     costUsd: number;
-    /** Number of result rows returned (present on per-result SKUs). */
-    items?: number;
+    /**
+     * Number of result rows returned. Always present on the wire: the gateway's field
+     * carries no `omitempty`, and a metadata-only replay preserves the original count.
+     */
+    items: number;
     /**
      * True when the gateway served a stored response for a repeated Idempotency-Key instead
      * of running the SKU again. A replay is not billed twice. Always present on the wire.
@@ -108,6 +114,8 @@ interface RequestOptions {
     signal?: AbortSignal;
     /** Override the client maxRetries for this call. */
     maxRetries?: number;
+    /** Override the client maxInProgressWaitMs for this call. */
+    maxInProgressWaitMs?: number;
     /** Override the generated Idempotency-Key for this billed POST. */
     idempotencyKey?: string;
 }
@@ -127,6 +135,13 @@ interface ClientOptions {
     timeoutMs?: number;
     /** Send Idempotency-Key on billed POSTs. Default "auto"; use "off" as a kill switch. */
     idempotency?: "auto" | "off";
+    /**
+     * Total milliseconds one run() call may block waiting out a 409 `idempotency_in_progress`
+     * (the gateway is still executing the run this key claims). Default 60000. Set 0 to
+     * surface that 409 immediately. This is a whole-call budget across every in-progress
+     * wait, separate from the 8000ms ordinary-backoff ceiling.
+     */
+    maxInProgressWaitMs?: number;
 }
 /**
  * Account profile returned by /v1/me (internal-only fields dropped). See SPEC 2.7.
@@ -162,7 +177,7 @@ interface DiscoveryPricing {
     failoverMaxUsd: number;
 }
 interface LaneHealth {
-    window: "30d";
+    window: string;
     uptimePct: number;
     latencyP50Ms: number;
     requests: number;
@@ -183,6 +198,8 @@ interface CatalogEntry {
     lanes: DiscoveryLane[];
     heavy: boolean;
     tryEligible: boolean;
+    failover?: boolean;
+    excludesCallerDelay?: boolean;
     inputSchema?: Record<string, unknown>;
     outputSchema?: Record<string, unknown>;
 }
@@ -257,6 +274,7 @@ declare class AnyAPI$1 implements ClientCore {
     private readonly maxRetries;
     private readonly timeoutMs;
     private readonly idempotency;
+    private readonly maxInProgressWaitMs;
     /**
      * The network seam the generated per-platform namespaces target. The base client IS a
      * ClientCore (it implements `run`), so the generated subclass hands `this._core` to each
@@ -292,6 +310,7 @@ declare class AnyAPI$1 implements ClientCore {
         body?: string;
         timeoutMs: number;
         maxRetries: number;
+        maxInProgressWaitMs?: number;
         signal?: AbortSignal;
         idempotencyKey?: string;
     }): Promise<T>;
@@ -337,7 +356,10 @@ declare function paginate<Item, Page extends RunResult<unknown> | BareRunResult<
 declare class AnyAPIError extends Error {
     /** HTTP status code, or 0 for transport-level failures (connection/timeout). */
     readonly status: number;
-    /** The x-request-id response header when present, else undefined. */
+    /**
+     * The gateway's X-Anyapi-Request-Id response header when present (falling back to a
+     * proxy-set x-request-id), else undefined. Quote it to AnyAPI support.
+     */
     readonly requestId?: string;
     /** Stable gateway error code when the JSON body includes one, else undefined. */
     readonly code?: string;

package/dist/index.js

@@ -2,7 +2,10 @@
 var AnyAPIError = class extends Error {
   /** HTTP status code, or 0 for transport-level failures (connection/timeout). */
   status;
-  /** The x-request-id response header when present, else undefined. */
+  /**
+   * The gateway's X-Anyapi-Request-Id response header when present (falling back to a
+   * proxy-set x-request-id), else undefined. Quote it to AnyAPI support.
+   */
   requestId;
   /** Stable gateway error code when the JSON body includes one, else undefined. */
   code;
@@ -37,6 +40,14 @@ var ConnectionError = class extends AnyAPIError {
 };
 var TimeoutError = class extends AnyAPIError {
 };
+var REQUEST_ID_HEADERS = ["x-anyapi-request-id", "x-request-id"];
+function requestIdOf(headers) {
+  for (const name of REQUEST_ID_HEADERS) {
+    const value = headers.get(name);
+    if (value) return value;
+  }
+  return void 0;
+}
 function errorFromStatus(status, message, requestId, code) {
   switch (status) {
     case 400:
@@ -108,17 +119,20 @@ var DEFAULT_BASE_URL = "https://api.getanyapi.com";
 function malformed(path) {
   throw new AnyAPIError(`malformed discovery response: ${path}`, 0);
 }
-function rejectInternalKeys(value, path) {
+function rejectUnsafeDiscoveryFields(value, path) {
   if (Array.isArray(value)) {
     value.forEach(
-      (item, index) => rejectInternalKeys(item, `${path}[${index}]`)
+      (item, index) => rejectUnsafeDiscoveryFields(item, `${path}[${index}]`)
     );
     return;
   }
   if (typeof value !== "object" || value === null) return;
   for (const [key, item] of Object.entries(value)) {
     if (key.toLowerCase().includes("credit")) malformed(`${path}.${key}`);
-    rejectInternalKeys(item, `${path}.${key}`);
+    if (key === "provider" && item !== "AnyAPI") {
+      malformed(`${path}.${key}`);
+    }
+    rejectUnsafeDiscoveryFields(item, `${path}.${key}`);
   }
 }
 function record(value, path) {
@@ -127,12 +141,6 @@ function record(value, path) {
   }
   return value;
 }
-function exactKeys(raw, allowed, path) {
-  const keys = new Set(allowed);
-  for (const key of Object.keys(raw)) {
-    if (!keys.has(key)) malformed(`${path}.${key}`);
-  }
-}
 function stringField(raw, key, path) {
   const value = raw[key];
   if (typeof value !== "string") return malformed(`${path}.${key}`);
@@ -163,14 +171,12 @@ function parseOffer(value, path) {
   const unit = stringField(raw, "unit", path);
   const maxUsd = numberField(raw, "maxUsd", path);
   if (model === "flat") {
-    exactKeys(raw, ["model", "unit", "maxUsd"], path);
-    if (unit !== "request" || "baseUsd" in raw || "perUnitUsd" in raw) {
+    if (unit !== "request") {
       return malformed(path);
     }
     return { model, unit, maxUsd };
   }
   if (model === "linear") {
-    exactKeys(raw, ["model", "unit", "baseUsd", "perUnitUsd", "maxUsd"], path);
     if (unit.length === 0) return malformed(`${path}.unit`);
     return {
       model,
@@ -184,7 +190,6 @@ function parseOffer(value, path) {
 }
 function parsePricing(value, path) {
   const raw = record(value, path);
-  exactKeys(raw, ["from", "failoverMaxUsd"], path);
   return {
     from: parseOffer(raw["from"], `${path}.from`),
     failoverMaxUsd: numberField(raw, "failoverMaxUsd", path)
@@ -192,10 +197,8 @@ function parsePricing(value, path) {
 }
 function parseHealth(value, path) {
   const raw = record(value, path);
-  exactKeys(raw, ["window", "uptimePct", "latencyP50Ms", "requests"], path);
-  if (raw["window"] !== "30d") return malformed(`${path}.window`);
   return {
-    window: "30d",
+    window: stringField(raw, "window", path),
     uptimePct: boundedNumberField(raw, "uptimePct", path, void 0, 100),
     latencyP50Ms: integerField(raw, "latencyP50Ms", path),
     requests: integerField(raw, "requests", path)
@@ -203,7 +206,6 @@ function parseHealth(value, path) {
 }
 function parseLane(value, path) {
   const raw = record(value, path);
-  exactKeys(raw, ["pricing", "health"], path);
   const lane = {
     pricing: parseOffer(raw["pricing"], `${path}.pricing`)
   };
@@ -221,7 +223,6 @@ function parseSchema(value, path) {
 }
 function parseHighlight(value, path) {
   const raw = record(value, path);
-  exactKeys(raw, ["path", "type", "why"], path);
   const field = {
     path: stringField(raw, "path", path),
     type: stringField(raw, "type", path)
@@ -242,28 +243,10 @@ function mapProfile(raw) {
   return profile;
 }
 function mapCatalogEntry(raw) {
-  rejectInternalKeys(raw, "api");
+  rejectUnsafeDiscoveryFields(raw, "api");
   const value = record(raw, "api");
-  exactKeys(
-    value,
-    [
-      "id",
-      "slug",
-      "category",
-      "name",
-      "description",
-      "provider",
-      "pricing",
-      "lanes",
-      "heavy",
-      "tryEligible",
-      "inputSchema",
-      "outputSchema"
-    ],
-    "api"
-  );
   const lanesRaw = value["lanes"];
-  if (!Array.isArray(lanesRaw) || lanesRaw.length === 0) {
+  if (!Array.isArray(lanesRaw)) {
     return malformed("api.lanes");
   }
   const entry = {
@@ -285,32 +268,24 @@ function mapCatalogEntry(raw) {
   }
   if (typeof value["tryEligible"] !== "boolean")
     return malformed("api.tryEligible");
+  if (value["failover"] !== void 0) {
+    if (typeof value["failover"] !== "boolean")
+      return malformed("api.failover");
+    entry.failover = value["failover"];
+  }
+  if (value["excludesCallerDelay"] !== void 0) {
+    if (typeof value["excludesCallerDelay"] !== "boolean")
+      return malformed("api.excludesCallerDelay");
+    entry.excludesCallerDelay = value["excludesCallerDelay"];
+  }
   if (value["inputSchema"] !== void 0) {
     entry.inputSchema = parseSchema(value["inputSchema"], "api.inputSchema");
   }
   if (value["outputSchema"] !== void 0) {
     entry.outputSchema = parseSchema(value["outputSchema"], "api.outputSchema");
   }
-  if (!offersEqual(entry.pricing.from, entry.lanes[0].pricing)) {
-    return malformed("api.pricing.from");
-  }
-  const failoverMaxUsd = Math.max(
-    ...entry.lanes.map((lane) => lane.pricing.maxUsd)
-  );
-  if (entry.pricing.failoverMaxUsd !== failoverMaxUsd) {
-    return malformed("api.pricing.failoverMaxUsd");
-  }
   return entry;
 }
-function offersEqual(left, right) {
-  if (left.model !== right.model || left.unit !== right.unit || left.maxUsd !== right.maxUsd) {
-    return false;
-  }
-  if (left.model === "flat" || right.model === "flat") {
-    return left.model === right.model;
-  }
-  return left.baseUsd === right.baseUsd && left.perUnitUsd === right.perUnitUsd;
-}
 function mapCatalogDetail(raw) {
   const entry = mapCatalogEntry(raw);
   if (entry.inputSchema === void 0) return malformed("api.inputSchema");
@@ -318,28 +293,13 @@ function mapCatalogDetail(raw) {
   return entry;
 }
 function mapCatalogList(raw) {
+  rejectUnsafeDiscoveryFields(raw, "catalog");
   const envelope = record(raw, "catalog");
-  exactKeys(envelope, ["apis"], "catalog");
   if (!Array.isArray(envelope["apis"])) return malformed("catalog.apis");
   return envelope["apis"].map(mapCatalogEntry);
 }
 function mapSearchResult(value, path) {
   const raw = record(value, path);
-  exactKeys(
-    raw,
-    [
-      "slug",
-      "platformId",
-      "name",
-      "description",
-      "category",
-      "provider",
-      "pricing",
-      "relevance",
-      "highlightFields"
-    ],
-    path
-  );
   const result = {
     slug: stringField(raw, "slug", path),
     platformId: stringField(raw, "platformId", path),
@@ -360,9 +320,8 @@ function mapSearchResult(value, path) {
   return result;
 }
 function mapCatalogSearch(raw) {
-  rejectInternalKeys(raw, "search");
+  rejectUnsafeDiscoveryFields(raw, "search");
   const envelope = record(raw, "search");
-  exactKeys(envelope, ["results", "total", "ranking"], "search");
   if (!Array.isArray(envelope["results"])) return malformed("search.results");
   const ranking = envelope["ranking"];
   if (ranking !== "semantic" && ranking !== "keyword")
@@ -407,7 +366,7 @@ async function agentSignup(options = {}) {
       0
     );
   }
-  const requestId = response.headers.get("x-request-id") ?? void 0;
+  const requestId = requestIdOf(response.headers);
   const text = await response.text().catch(() => "");
   if (response.status !== 200) {
     let message = `request failed with status ${response.status}`;
@@ -439,6 +398,8 @@ var DEFAULT_TIMEOUT_MS = 6e4;
 var DEFAULT_MAX_RETRIES = 2;
 var RETRY_BASE_DELAY_MS = 500;
 var RETRY_MAX_DELAY_MS = 8e3;
+var DEFAULT_MAX_IN_PROGRESS_WAIT_MS = 6e4;
+var IDEMPOTENCY_IN_PROGRESS_CODE = "idempotency_in_progress";
 var PRE_SEND_NETWORK_ERROR_CODES = /* @__PURE__ */ new Set([
   "EADDRNOTAVAIL",
   "EAI_AGAIN",
@@ -482,7 +443,7 @@ function backoffDelay(attempt) {
   const factor = 0.5 + Math.random();
   return base * factor;
 }
-function parseRetryAfter(header) {
+function parseRetryAfterMs(header) {
   if (header === null) {
     return void 0;
   }
@@ -492,13 +453,11 @@ function parseRetryAfter(header) {
   }
   const seconds = Number(trimmed);
   if (Number.isFinite(seconds)) {
-    const ms = seconds * 1e3;
-    return Math.min(Math.max(ms, 0), RETRY_MAX_DELAY_MS);
+    return Math.max(seconds * 1e3, 0);
   }
   const dateMs = Date.parse(trimmed);
   if (Number.isFinite(dateMs)) {
-    const delta = dateMs - Date.now();
-    return Math.min(Math.max(delta, 0), RETRY_MAX_DELAY_MS);
+    return Math.max(dateMs - Date.now(), 0);
   }
   return void 0;
 }
@@ -603,6 +562,7 @@ var AnyAPI = class {
   maxRetries;
   timeoutMs;
   idempotency;
+  maxInProgressWaitMs;
   /**
    * The network seam the generated per-platform namespaces target. The base client IS a
    * ClientCore (it implements `run`), so the generated subclass hands `this._core` to each
@@ -625,6 +585,7 @@ var AnyAPI = class {
     this.fetchImpl = resolvedFetch;
     this.maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
     this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    this.maxInProgressWaitMs = options.maxInProgressWaitMs ?? DEFAULT_MAX_IN_PROGRESS_WAIT_MS;
     const idempotency = options.idempotency ?? "auto";
     if (idempotency !== "auto" && idempotency !== "off") {
       throw new TypeError('idempotency must be "auto" or "off"');
@@ -645,6 +606,7 @@ var AnyAPI = class {
         body,
         timeoutMs: options?.timeoutMs ?? this.timeoutMs,
         maxRetries: options?.maxRetries ?? this.maxRetries,
+        maxInProgressWaitMs: options?.maxInProgressWaitMs ?? this.maxInProgressWaitMs,
         ...options?.idempotencyKey !== void 0 ? { idempotencyKey: options.idempotencyKey } : {},
         ...options?.signal ? { signal: options.signal } : {}
       }
@@ -717,6 +679,11 @@ var AnyAPI = class {
       headers["Idempotency-Key"] = key;
     }
     let attempt = 0;
+    let inProgressWaitedMs = 0;
+    const inProgressBudgetMs = Math.max(
+      opts.maxInProgressWaitMs ?? DEFAULT_MAX_IN_PROGRESS_WAIT_MS,
+      0
+    );
     for (; ; ) {
       const { signal, timeoutSignal } = composeSignal(
         opts.timeoutMs,
@@ -750,7 +717,7 @@ var AnyAPI = class {
         }
         throw connErr;
       }
-      const requestId = response.headers.get("x-request-id") ?? void 0;
+      const requestId = requestIdOf(response.headers);
       if (response.status === 200) {
         const text = await response.text();
         try {
@@ -765,13 +732,22 @@ var AnyAPI = class {
       }
       const body = await response.text().catch(() => "");
       const { message, code } = messageFromBody(body, response.status);
+      const retryAfterMs = parseRetryAfterMs(response.headers.get("retry-after"));
       if (response.status === 429 && attempt < opts.maxRetries) {
-        const retryAfter = parseRetryAfter(response.headers.get("retry-after"));
-        const delay = retryAfter ?? backoffDelay(attempt);
+        const delay = retryAfterMs !== void 0 ? Math.min(retryAfterMs, RETRY_MAX_DELAY_MS) : backoffDelay(attempt);
         await sleep(delay, opts.signal);
         attempt += 1;
         continue;
       }
+      if (billedPost && response.status === 409 && code === IDEMPOTENCY_IN_PROGRESS_CODE && attempt < opts.maxRetries) {
+        const delay = retryAfterMs ?? backoffDelay(attempt);
+        if (inProgressWaitedMs + delay <= inProgressBudgetMs) {
+          await sleep(delay, opts.signal);
+          inProgressWaitedMs += delay;
+          attempt += 1;
+          continue;
+        }
+      }
       throw errorFromStatus(response.status, message, requestId, code);
     }
   }