@opusdns/api 1.63.0 → 1.64.0

package/package.json

@@ -3,7 +3,7 @@
     "@opusdns/api-spec-ts-generator": "^1.2.0"
   },
   "name": "@opusdns/api",
-  "version": "1.63.0",
+  "version": "1.64.0",
   "description": "TypeScript types for the OpusDNS OpenAPI specification",
   "main": "./src/index.ts",
   "module": "./src/index.ts",

package/src/helpers/keys.ts

@@ -3491,10 +3491,14 @@ export const KEYS_JOB_BATCH_REQUEST = [
 ] as const satisfies (keyof JobBatchRequest)[];
 
 export const KEY_JOB_BATCH_RETRY_BATCH_ID = 'batch_id' satisfies keyof JobBatchRetry;
+export const KEY_JOB_BATCH_RETRY_BLOCKED_COUNT = 'blocked_count' satisfies keyof JobBatchRetry;
+export const KEY_JOB_BATCH_RETRY_QUEUED_COUNT = 'queued_count' satisfies keyof JobBatchRetry;
 export const KEY_JOB_BATCH_RETRY_RETRIED_COUNT = 'retried_count' satisfies keyof JobBatchRetry;
 
 export const KEYS_JOB_BATCH_RETRY = [
   KEY_JOB_BATCH_RETRY_BATCH_ID,
+  KEY_JOB_BATCH_RETRY_BLOCKED_COUNT,
+  KEY_JOB_BATCH_RETRY_QUEUED_COUNT,
   KEY_JOB_BATCH_RETRY_RETRIED_COUNT,
 ] as const satisfies (keyof JobBatchRetry)[];
 

package/src/openapi.yaml

@@ -8055,8 +8055,19 @@ components:
           title: Batch Id
           type: string
           x-typeid-prefix: batch
+        blocked_count:
+          default: 0
+          description: Number of retried jobs held behind the topic rate limit or
+            backlog (BLOCKED)
+          title: Blocked Count
+          type: integer
+        queued_count:
+          default: 0
+          description: Number of retried jobs dispatched immediately (QUEUED)
+          title: Queued Count
+          type: integer
         retried_count:
-          description: Number of FAILED/DEAD_LETTER jobs reset to QUEUED for retry
+          description: Number of FAILED/DEAD_LETTER jobs reset for retry
           title: Retried Count
           type: integer
       required:
@@ -8342,8 +8353,8 @@ components:
           title: Started At
         status:
           $ref: '#/components/schemas/JobStatus'
-          description: 'Current job status: queued, running, succeeded, failed, canceled,
-            or dead_letter'
+          description: 'Current job status: blocked, queued, paused, running, succeeded,
+            failed, canceled, or dead_letter'
       required:
       - job_id
       - status
@@ -13870,7 +13881,7 @@ info:
     \n\n"
   summary: OpusDNS - your gateway to a seamless domain management experience.
   title: OpusDNS API
-  version: 2026-07-17-094205
+  version: 2026-07-17-134537
   x-logo:
     altText: OpusDNS API Reference
     url: https://d24lr4zqs1tgqh.cloudfront.net/c9505a20-5ae1-406c-b060-d392569caebf.jpg
@@ -29773,21 +29784,26 @@ tags:
     \ (single) or is silently skipped (batch)\n- `queued`, `blocked`, `paused`, `running`\
     \ \u2014 still in progress; not touched\n\nCalling batch retry on a mixed-state\
     \ batch returns `retried_count` (the number of `failed` / `dead_letter` jobs that\
-    \ were re-queued); everything else is left alone. If the batch has no retryable\
-    \ jobs, `retried_count` is `0`.\n\n#### What happens to a retried job\n\nEach\
-    \ retried job is reset to a fresh attempt:\n\n- `status` \u2192 `queued`\n- `attempts`\
-    \ \u2192 `0`\n- `not_before` \u2192 now\n- `error_class` and `error_message` \u2192\
-    \ cleared\n- The job is republished for worker pickup\n\nThe original `payload`,\
-    \ `idempotency_key`, `correlation_id` (batch id), `max_attempts`, and backoff\
-    \ configuration are preserved. Each retry is processed under the same worker idempotency\
-    \ guarantees as the original \u2014 for billing operations specifically, a retried\
-    \ job will not double-charge an account that was already debited.\n\n#### Filtering\
-    \ by error type\n\nA batch may contain a mix of failures that you do and don't\
-    \ want to retry. For example, after adding funds to your account, you may want\
-    \ to retry only the jobs that failed with `BillingInsufficientFundsError`, while\
-    \ leaving alone jobs that failed for other reasons (e.g. an invalid domain name\
-    \ that should not be re-attempted).\n\nPass one or more `error_class` query parameters\
-    \ to filter:\n\n```\nPOST /v1/jobs/{batch_id}/retry?error_class=BillingInsufficientFundsError\n\
+    \ were reset for retry); everything else is left alone. If the batch has no retryable\
+    \ jobs, `retried_count` is `0`. The response also splits that total into `queued_count`\
+    \ (jobs dispatched immediately) and `blocked_count` (jobs held behind the topic's\
+    \ rate limit or backlog \u2014 these are released automatically as capacity frees\
+    \ up).\n\n#### What happens to a retried job\n\nEach retried job is reset to a\
+    \ fresh attempt:\n\n- `status` \u2192 `queued`, or `blocked` if the job's topic\
+    \ is rate-limited and has no capacity (or a higher-priority backlog is waiting)\
+    \ \u2014 a blocked job is released to `queued` automatically as capacity frees\
+    \ up\n- `attempts` \u2192 `0`\n- `not_before` \u2192 now\n- `error_class` and\
+    \ `error_message` \u2192 cleared\n- The job is republished for worker pickup once\
+    \ it is `queued`\n\nThe original `payload`, `idempotency_key`, `correlation_id`\
+    \ (batch id), `max_attempts`, and backoff configuration are preserved. Each retry\
+    \ is processed under the same worker idempotency guarantees as the original \u2014\
+    \ for billing operations specifically, a retried job will not double-charge an\
+    \ account that was already debited.\n\n#### Filtering by error type\n\nA batch\
+    \ may contain a mix of failures that you do and don't want to retry. For example,\
+    \ after adding funds to your account, you may want to retry only the jobs that\
+    \ failed with `BillingInsufficientFundsError`, while leaving alone jobs that failed\
+    \ for other reasons (e.g. an invalid domain name that should not be re-attempted).\n\
+    \nPass one or more `error_class` query parameters to filter:\n\n```\nPOST /v1/jobs/{batch_id}/retry?error_class=BillingInsufficientFundsError\n\
     POST /v1/jobs/{batch_id}/retry?error_class=BillingInsufficientFundsError&error_class=DomainRegistryTemporaryError\n\
     ```\n\nMultiple values are OR'd \u2014 a job is retried if its `error_class` matches\
     \ **any** of the supplied values. Omitting the filter retries all `failed` and\

package/src/schema.d.ts

@@ -8053,9 +8053,21 @@ export interface components {
              * @example batch_01h45ytscbebyvny4gc8cr8ma2
              */
             batch_id: TypeId<"batch">;
+            /**
+             * Blocked Count
+             * @description Number of retried jobs held behind the topic rate limit or backlog (BLOCKED)
+             * @default 0
+             */
+            blocked_count: number;
+            /**
+             * Queued Count
+             * @description Number of retried jobs dispatched immediately (QUEUED)
+             * @default 0
+             */
+            queued_count: number;
             /**
              * Retried Count
-             * @description Number of FAILED/DEAD_LETTER jobs reset to QUEUED for retry
+             * @description Number of FAILED/DEAD_LETTER jobs reset for retry
              */
             retried_count: number;
         };
@@ -8265,7 +8277,7 @@ export interface components {
              * @description Timestamp when job execution began (UTC)
              */
             started_at?: Date | null;
-            /** @description Current job status: queued, running, succeeded, failed, canceled, or dead_letter */
+            /** @description Current job status: blocked, queued, paused, running, succeeded, failed, canceled, or dead_letter */
             status: components["schemas"]["JobStatus"];
         };
         /**