@opusdns/api 0.306.0 → 0.307.0

package/package.json

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

package/src/helpers/keys.ts

@@ -27938,6 +27938,56 @@ export const KEY_JOB_DOMAIN_NAME: keyof Job = 'domain_name';
  * @see {@link KEYS_JOB} - Array of all keys for this type
  */
 export const KEY_JOB_ERROR_CLASS: keyof Job = 'error_class';
+/**
+ * Error Code
+ *
+ * Stable semantic error code propagated verbatim from the failing upstream service (e.g. 'ERROR_DOMAIN_TRANSFER_INVALID_AUTH_CODE'). Suitable for i18n / per-error UI branching. Null when the job did not fail or the upstream error did not carry a code.
+ *
+ *
+ *
+ * @remarks
+ * This key constant provides type-safe access to the `error_code` property of Job objects.
+ * Use this constant when you need to access properties dynamically or ensure type safety.
+ *
+ * @example
+ * ```typescript
+ * // Direct property access
+ * const value = job[KEY_JOB_ERROR_CODE];
+ * 
+ * // Dynamic property access
+ * const propertyName = KEY_JOB_ERROR_CODE;
+ * const value = job[propertyName];
+ * ```
+ *
+ * @see {@link Job} - The TypeScript type definition
+ * @see {@link KEYS_JOB} - Array of all keys for this type
+ */
+export const KEY_JOB_ERROR_CODE: keyof Job = 'error_code';
+/**
+ * Error Details
+ *
+ * Full upstream problem-details payload (RFC 9457) preserved verbatim — e.g. type/title/status/code/detail plus service-specific extras like domain_name, reason. Null when the failure didn't originate from a typed upstream response.
+ *
+ *
+ *
+ * @remarks
+ * This key constant provides type-safe access to the `error_details` property of Job objects.
+ * Use this constant when you need to access properties dynamically or ensure type safety.
+ *
+ * @example
+ * ```typescript
+ * // Direct property access
+ * const value = job[KEY_JOB_ERROR_DETAILS];
+ * 
+ * // Dynamic property access
+ * const propertyName = KEY_JOB_ERROR_DETAILS;
+ * const value = job[propertyName];
+ * ```
+ *
+ * @see {@link Job} - The TypeScript type definition
+ * @see {@link KEYS_JOB} - Array of all keys for this type
+ */
+export const KEY_JOB_ERROR_DETAILS: keyof Job = 'error_details';
 /**
  * Error Message
  *
@@ -28217,6 +28267,8 @@ export const KEYS_JOB = [
   KEY_JOB_DISPLAY,
   KEY_JOB_DOMAIN_NAME,
   KEY_JOB_ERROR_CLASS,
+  KEY_JOB_ERROR_CODE,
+  KEY_JOB_ERROR_DETAILS,
   KEY_JOB_ERROR_MESSAGE,
   KEY_JOB_FINISHED_AT,
   KEY_JOB_JOB_ID,

package/src/openapi.yaml

@@ -6720,6 +6720,25 @@ components:
           - type: 'null'
           description: Error type if the job failed (e.g., ValidationError, TimeoutError)
           title: Error Class
+        error_code:
+          anyOf:
+          - type: string
+          - type: 'null'
+          description: Stable semantic error code propagated verbatim from the failing
+            upstream service (e.g. 'ERROR_DOMAIN_TRANSFER_INVALID_AUTH_CODE'). Suitable
+            for i18n / per-error UI branching. Null when the job did not fail or the
+            upstream error did not carry a code.
+          title: Error Code
+        error_details:
+          anyOf:
+          - additionalProperties: true
+            type: object
+          - type: 'null'
+          description: "Full upstream problem-details payload (RFC 9457) preserved\
+            \ verbatim \u2014 e.g. type/title/status/code/detail plus service-specific\
+            \ extras like domain_name, reason. Null when the failure didn't originate\
+            \ from a typed upstream response."
+          title: Error Details
         error_message:
           anyOf:
           - type: string
@@ -11486,7 +11505,7 @@ info:
     \n\n"
   summary: OpusDNS - your gateway to a seamless domain management experience.
   title: OpusDNS API
-  version: 2026-05-18-161414
+  version: 2026-05-18-215758
   x-logo:
     altText: OpusDNS API Reference
     url: https://d24lr4zqs1tgqh.cloudfront.net/c9505a20-5ae1-406c-b060-d392569caebf.jpg
@@ -22219,8 +22238,18 @@ paths:
                       created_on: '2025-01-15T10:00:00Z'
                       display: Update Domain 'flaky-domain.com'
                       domain_name: flaky-domain.com
-                      error_class: RegistryError
-                      error_message: Registry unavailable after 5 retry attempts
+                      error_class: DomainsClientError
+                      error_code: ERROR_DOMAIN_TRANSFER_INVALID_AUTH_CODE
+                      error_details:
+                        code: ERROR_DOMAIN_TRANSFER_INVALID_AUTH_CODE
+                        detail: There was an error transferring the domain
+                        domain_name: flaky-domain.com
+                        reason: Domain transfer failed, invalid auth code provided
+                        status: 403
+                        title: Domain Transfer Error
+                        type: domain-transfer-invalid-auth
+                      error_message: 'Domains service error: There was an error transferring
+                        the domain'
                       finished_at: '2025-01-15T10:15:30Z'
                       job_id: job_01h45ytscbebyvny4gc8cr8ma7
                       operation: update

package/src/schema.d.ts

@@ -6954,6 +6954,18 @@ export interface components {
              * @description Error type if the job failed (e.g., ValidationError, TimeoutError)
              */
             error_class?: string | null;
+            /**
+             * Error Code
+             * @description Stable semantic error code propagated verbatim from the failing upstream service (e.g. 'ERROR_DOMAIN_TRANSFER_INVALID_AUTH_CODE'). Suitable for i18n / per-error UI branching. Null when the job did not fail or the upstream error did not carry a code.
+             */
+            error_code?: string | null;
+            /**
+             * Error Details
+             * @description Full upstream problem-details payload (RFC 9457) preserved verbatim — e.g. type/title/status/code/detail plus service-specific extras like domain_name, reason. Null when the failure didn't originate from a typed upstream response.
+             */
+            error_details?: {
+                [key: string]: unknown;
+            } | null;
             /**
              * Error Message
              * @description Detailed error message if the job failed