@objectstack/spec 2.0.6 → 2.0.7

package/dist/data/index.mjs

@@ -2732,7 +2732,64 @@ var ExternalLookupSchema = z21.object({
      * Burst size for handling spikes
      */
     burstSize: z21.number().optional().describe("Burst size")
-  }).optional().describe("Rate limiting")
+  }).optional().describe("Rate limiting"),
+  /**
+   * Retry configuration with exponential backoff
+   *
+   * @example
+   * ```json
+   * {
+   *   "maxRetries": 3,
+   *   "initialDelayMs": 1000,
+   *   "maxDelayMs": 30000,
+   *   "backoffMultiplier": 2,
+   *   "retryableStatusCodes": [429, 500, 502, 503, 504]
+   * }
+   * ```
+   */
+  retry: z21.object({
+    /** Maximum number of retry attempts */
+    maxRetries: z21.number().min(0).default(3).describe("Maximum retry attempts"),
+    /** Initial delay before first retry (ms) */
+    initialDelayMs: z21.number().default(1e3).describe("Initial retry delay in milliseconds"),
+    /** Maximum delay between retries (ms) */
+    maxDelayMs: z21.number().default(3e4).describe("Maximum retry delay in milliseconds"),
+    /** Backoff multiplier for exponential backoff */
+    backoffMultiplier: z21.number().default(2).describe("Exponential backoff multiplier"),
+    /** HTTP status codes that trigger a retry */
+    retryableStatusCodes: z21.array(z21.number()).default([429, 500, 502, 503, 504]).describe("HTTP status codes that are retryable")
+  }).optional().describe("Retry configuration with exponential backoff"),
+  /**
+   * Request/response transformation pipeline
+   *
+   * Allows transforming request parameters and response data
+   * before they are processed by the external lookup system.
+   */
+  transform: z21.object({
+    /** Transform request parameters before sending */
+    request: z21.object({
+      /** Header transformations (key-value additions) */
+      headers: z21.record(z21.string(), z21.string()).optional().describe("Additional request headers"),
+      /** Query parameter transformations */
+      queryParams: z21.record(z21.string(), z21.string()).optional().describe("Additional query parameters")
+    }).optional().describe("Request transformation"),
+    /** Transform response data after receiving */
+    response: z21.object({
+      /** JSONPath expression to extract data from response */
+      dataPath: z21.string().optional().describe('JSONPath to extract data (e.g., "$.data.results")'),
+      /** JSONPath expression to extract total count for pagination */
+      totalPath: z21.string().optional().describe('JSONPath to extract total count (e.g., "$.meta.total")')
+    }).optional().describe("Response transformation")
+  }).optional().describe("Request/response transformation pipeline"),
+  /** Pagination support for external data sources */
+  pagination: z21.object({
+    /** Pagination type */
+    type: z21.enum(["offset", "cursor", "page"]).default("offset").describe("Pagination type"),
+    /** Page size */
+    pageSize: z21.number().default(100).describe("Items per page"),
+    /** Maximum pages to fetch */
+    maxPages: z21.number().optional().describe("Maximum number of pages to fetch")
+  }).optional().describe("Pagination configuration for external data")
 });
 
 // src/data/datasource.zod.ts