@opusdns/api 0.273.0 → 0.275.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -3,7 +3,7 @@
3
3
  "@opusdns/api-spec-ts-generator": "^0.19.0"
4
4
  },
5
5
  "name": "@opusdns/api",
6
- "version": "0.273.0",
6
+ "version": "0.275.0",
7
7
  "description": "TypeScript types for the OpusDNS OpenAPI specification",
8
8
  "main": "./src/index.ts",
9
9
  "module": "./src/index.ts",
@@ -1395,6 +1395,31 @@ export const KEYS_BULK_OBJECT_TAG_CHANGES = [
1395
1395
  KEY_BULK_OBJECT_TAG_CHANGES_TYPE,
1396
1396
  ] as const satisfies (keyof BulkObjectTagChanges)[];
1397
1397
 
1398
+ /**
1399
+ * Code
1400
+ *
1401
+ * Stable semantic error code for known failure modes (e.g. 'ERROR_BATCH_EMPTY'); null for ad-hoc failures. Matches the 'code' field in top-level error responses.
1402
+ *
1403
+ *
1404
+ *
1405
+ * @remarks
1406
+ * This key constant provides type-safe access to the `code` property of CommandError objects.
1407
+ * Use this constant when you need to access properties dynamically or ensure type safety.
1408
+ *
1409
+ * @example
1410
+ * ```typescript
1411
+ * // Direct property access
1412
+ * const value = commanderror[KEY_COMMAND_ERROR_CODE];
1413
+ *
1414
+ * // Dynamic property access
1415
+ * const propertyName = KEY_COMMAND_ERROR_CODE;
1416
+ * const value = commanderror[propertyName];
1417
+ * ```
1418
+ *
1419
+ * @see {@link CommandError} - The TypeScript type definition
1420
+ * @see {@link KEYS_COMMAND_ERROR} - Array of all keys for this type
1421
+ */
1422
+ export const KEY_COMMAND_ERROR_CODE: keyof CommandError = 'code';
1398
1423
  /**
1399
1424
  * Error
1400
1425
  *
@@ -1447,6 +1472,81 @@ export const KEY_COMMAND_ERROR_ERROR: keyof CommandError = 'error';
1447
1472
  * @see {@link KEYS_COMMAND_ERROR} - Array of all keys for this type
1448
1473
  */
1449
1474
  export const KEY_COMMAND_ERROR_INDEX: keyof CommandError = 'index';
1475
+ /**
1476
+ * Instance Index
1477
+ *
1478
+ * Index within the bulk command's instances[] for per-instance failures
1479
+ *
1480
+ *
1481
+ *
1482
+ * @remarks
1483
+ * This key constant provides type-safe access to the `instance_index` property of CommandError objects.
1484
+ * Use this constant when you need to access properties dynamically or ensure type safety.
1485
+ *
1486
+ * @example
1487
+ * ```typescript
1488
+ * // Direct property access
1489
+ * const value = commanderror[KEY_COMMAND_ERROR_INSTANCE_INDEX];
1490
+ *
1491
+ * // Dynamic property access
1492
+ * const propertyName = KEY_COMMAND_ERROR_INSTANCE_INDEX;
1493
+ * const value = commanderror[propertyName];
1494
+ * ```
1495
+ *
1496
+ * @see {@link CommandError} - The TypeScript type definition
1497
+ * @see {@link KEYS_COMMAND_ERROR} - Array of all keys for this type
1498
+ */
1499
+ export const KEY_COMMAND_ERROR_INSTANCE_INDEX: keyof CommandError = 'instance_index';
1500
+ /**
1501
+ * Resource Key
1502
+ *
1503
+ * Resource identifier (zone name, domain name, contact email) for per-instance failures
1504
+ *
1505
+ *
1506
+ *
1507
+ * @remarks
1508
+ * This key constant provides type-safe access to the `resource_key` property of CommandError objects.
1509
+ * Use this constant when you need to access properties dynamically or ensure type safety.
1510
+ *
1511
+ * @example
1512
+ * ```typescript
1513
+ * // Direct property access
1514
+ * const value = commanderror[KEY_COMMAND_ERROR_RESOURCE_KEY];
1515
+ *
1516
+ * // Dynamic property access
1517
+ * const propertyName = KEY_COMMAND_ERROR_RESOURCE_KEY;
1518
+ * const value = commanderror[propertyName];
1519
+ * ```
1520
+ *
1521
+ * @see {@link CommandError} - The TypeScript type definition
1522
+ * @see {@link KEYS_COMMAND_ERROR} - Array of all keys for this type
1523
+ */
1524
+ export const KEY_COMMAND_ERROR_RESOURCE_KEY: keyof CommandError = 'resource_key';
1525
+ /**
1526
+ * Type
1527
+ *
1528
+ * RFC 9457 problem type identifier derived from the exception class (e.g. 'value', 'batch-empty'). Matches the 'type' field in top-level error responses.
1529
+ *
1530
+ *
1531
+ *
1532
+ * @remarks
1533
+ * This key constant provides type-safe access to the `type` property of CommandError objects.
1534
+ * Use this constant when you need to access properties dynamically or ensure type safety.
1535
+ *
1536
+ * @example
1537
+ * ```typescript
1538
+ * // Direct property access
1539
+ * const value = commanderror[KEY_COMMAND_ERROR_TYPE];
1540
+ *
1541
+ * // Dynamic property access
1542
+ * const propertyName = KEY_COMMAND_ERROR_TYPE;
1543
+ * const value = commanderror[propertyName];
1544
+ * ```
1545
+ *
1546
+ * @see {@link CommandError} - The TypeScript type definition
1547
+ * @see {@link KEYS_COMMAND_ERROR} - Array of all keys for this type
1548
+ */
1549
+ export const KEY_COMMAND_ERROR_TYPE: keyof CommandError = 'type';
1450
1550
 
1451
1551
  /**
1452
1552
  * Array of all CommandError property keys
@@ -1469,8 +1569,12 @@ export const KEY_COMMAND_ERROR_INDEX: keyof CommandError = 'index';
1469
1569
  * @see {@link CommandError} - The TypeScript type definition
1470
1570
  */
1471
1571
  export const KEYS_COMMAND_ERROR = [
1572
+ KEY_COMMAND_ERROR_CODE,
1472
1573
  KEY_COMMAND_ERROR_ERROR,
1473
1574
  KEY_COMMAND_ERROR_INDEX,
1575
+ KEY_COMMAND_ERROR_INSTANCE_INDEX,
1576
+ KEY_COMMAND_ERROR_RESOURCE_KEY,
1577
+ KEY_COMMAND_ERROR_TYPE,
1474
1578
  ] as const satisfies (keyof CommandError)[];
1475
1579
 
1476
1580
  /**
@@ -4618,7 +4618,7 @@ export type POST_Organizations_Request_Body = POST_Organizations_Request['reques
4618
4618
  */
4619
4619
  export type GET_OrganizationsAttributes_Request = {
4620
4620
  parameters: {
4621
- query: operations['get_attributes_v1_organizations_attributes_get']['parameters']['query'];
4621
+ query: operations['get_current_organization_attributes_v1_organizations_attributes_get']['parameters']['query'];
4622
4622
  };
4623
4623
  }
4624
4624
  /**
@@ -4657,24 +4657,8 @@ export type GET_OrganizationsAttributes_Request_Query = GET_OrganizationsAttribu
4657
4657
  * @see {@link PATCH_OrganizationsAttributes_Request_Body} - Request body type
4658
4658
  */
4659
4659
  export type PATCH_OrganizationsAttributes_Request = {
4660
- parameters: {
4661
- query: operations['update_attributes_v1_organizations_attributes_patch']['parameters']['query'];
4662
- };
4663
4660
  requestBody: OrganizationAttributeUpdateArray;
4664
4661
  }
4665
- /**
4666
- * Query parameters for PATCH /v1/organizations/attributes
4667
- *
4668
- * @remarks
4669
- * This type defines the query parameters for the PATCH /v1/organizations/attributes endpoint.
4670
- * It provides type safety for all query parameters as defined in the OpenAPI specification.
4671
- *
4672
- * @example
4673
- * Use this type to ensure type safety for query parameters.
4674
- *
4675
- * @path /v1/organizations/attributes
4676
- */
4677
- export type PATCH_OrganizationsAttributes_Request_Query = PATCH_OrganizationsAttributes_Request['parameters']['query'];
4678
4662
  /**
4679
4663
  * Request body for PATCH /v1/organizations/attributes
4680
4664
  *
@@ -5048,8 +5032,8 @@ export type PATCH_OrganizationsOrganizationId_Request_Body = PATCH_Organizations
5048
5032
  */
5049
5033
  export type GET_OrganizationsOrganizationIdAttributes_Request = {
5050
5034
  parameters: {
5051
- query: operations['get_attributes_v1_organizations__organization_id__attributes_get']['parameters']['query'];
5052
- path: operations['get_attributes_v1_organizations__organization_id__attributes_get']['parameters']['path'];
5035
+ query: operations['get_organization_attributes_v1_organizations__organization_id__attributes_get']['parameters']['query'];
5036
+ path: operations['get_organization_attributes_v1_organizations__organization_id__attributes_get']['parameters']['path'];
5053
5037
  };
5054
5038
  }
5055
5039
  /**
@@ -5102,7 +5086,7 @@ export type GET_OrganizationsOrganizationIdAttributes_Request_Path = GET_Organiz
5102
5086
  */
5103
5087
  export type PATCH_OrganizationsOrganizationIdAttributes_Request = {
5104
5088
  parameters: {
5105
- path: operations['update_attributes_v1_organizations__organization_id__attributes_patch']['parameters']['path'];
5089
+ path: operations['update_organization_attributes_v1_organizations__organization_id__attributes_patch']['parameters']['path'];
5106
5090
  };
5107
5091
  requestBody: OrganizationAttributeUpdateArray;
5108
5092
  }
package/src/openapi.yaml CHANGED
@@ -325,6 +325,14 @@ components:
325
325
  type: object
326
326
  CommandError:
327
327
  properties:
328
+ code:
329
+ anyOf:
330
+ - type: string
331
+ - type: 'null'
332
+ description: Stable semantic error code for known failure modes (e.g. 'ERROR_BATCH_EMPTY');
333
+ null for ad-hoc failures. Matches the 'code' field in top-level error
334
+ responses.
335
+ title: Code
328
336
  error:
329
337
  description: Error message
330
338
  title: Error
@@ -333,6 +341,28 @@ components:
333
341
  description: Index of the failed command in the request
334
342
  title: Index
335
343
  type: integer
344
+ instance_index:
345
+ anyOf:
346
+ - type: integer
347
+ - type: 'null'
348
+ description: Index within the bulk command's instances[] for per-instance
349
+ failures
350
+ title: Instance Index
351
+ resource_key:
352
+ anyOf:
353
+ - type: string
354
+ - type: 'null'
355
+ description: Resource identifier (zone name, domain name, contact email)
356
+ for per-instance failures
357
+ title: Resource Key
358
+ type:
359
+ anyOf:
360
+ - type: string
361
+ - type: 'null'
362
+ description: RFC 9457 problem type identifier derived from the exception
363
+ class (e.g. 'value', 'batch-empty'). Matches the 'type' field in top-level
364
+ error responses.
365
+ title: Type
336
366
  required:
337
367
  - index
338
368
  - error
@@ -10169,7 +10199,7 @@ info:
10169
10199
  \n\n"
10170
10200
  summary: OpusDNS - your gateway to a seamless domain management experience.
10171
10201
  title: OpusDNS API
10172
- version: 2026-04-27-175347
10202
+ version: 2026-04-27-193424
10173
10203
  x-logo:
10174
10204
  altText: OpusDNS API Reference
10175
10205
  url: https://d24lr4zqs1tgqh.cloudfront.net/c9505a20-5ae1-406c-b060-d392569caebf.jpg
@@ -19682,21 +19712,8 @@ paths:
19682
19712
  /v1/organizations/attributes:
19683
19713
  get:
19684
19714
  description: Retrieves a list of organization attributes for the current organization
19685
- operationId: get_attributes_v1_organizations_attributes_get
19715
+ operationId: get_current_organization_attributes_v1_organizations_attributes_get
19686
19716
  parameters:
19687
- - in: query
19688
- name: organization_id
19689
- required: false
19690
- schema:
19691
- anyOf:
19692
- - examples:
19693
- - organization_01h45ytscbebyvny4gc8cr8ma2
19694
- format: typeid
19695
- pattern: ^organization_[0-7][0-9a-hjkmnpq-tv-z]{25}$
19696
- type: string
19697
- x-typeid-prefix: organization
19698
- - type: 'null'
19699
- title: Organization Id
19700
19717
  - description: Optional list of attribute keys to filter
19701
19718
  in: query
19702
19719
  name: keys
@@ -19716,7 +19733,8 @@ paths:
19716
19733
  schema:
19717
19734
  items:
19718
19735
  $ref: '#/components/schemas/OrganizationAttributeResponse'
19719
- title: Response Get Attributes V1 Organizations Attributes Get
19736
+ title: Response Get Current Organization Attributes V1 Organizations
19737
+ Attributes Get
19720
19738
  type: array
19721
19739
  description: Successful Response
19722
19740
  '401':
@@ -19757,21 +19775,7 @@ paths:
19757
19775
  - organization
19758
19776
  patch:
19759
19777
  description: Updates one or more organization attributes for the current organization
19760
- operationId: update_attributes_v1_organizations_attributes_patch
19761
- parameters:
19762
- - in: query
19763
- name: organization_id
19764
- required: false
19765
- schema:
19766
- anyOf:
19767
- - examples:
19768
- - organization_01h45ytscbebyvny4gc8cr8ma2
19769
- format: typeid
19770
- pattern: ^organization_[0-7][0-9a-hjkmnpq-tv-z]{25}$
19771
- type: string
19772
- x-typeid-prefix: organization
19773
- - type: 'null'
19774
- title: Organization Id
19778
+ operationId: update_current_organization_attributes_v1_organizations_attributes_patch
19775
19779
  requestBody:
19776
19780
  content:
19777
19781
  application/json:
@@ -19788,7 +19792,8 @@ paths:
19788
19792
  schema:
19789
19793
  items:
19790
19794
  $ref: '#/components/schemas/OrganizationAttributeResponse'
19791
- title: Response Update Attributes V1 Organizations Attributes Patch
19795
+ title: Response Update Current Organization Attributes V1 Organizations
19796
+ Attributes Patch
19792
19797
  type: array
19793
19798
  description: Successful Response
19794
19799
  '401':
@@ -20432,21 +20437,19 @@ paths:
20432
20437
  /v1/organizations/{organization_id}/attributes:
20433
20438
  get:
20434
20439
  description: Retrieves a list of organization attributes for the specified organization
20435
- operationId: get_attributes_v1_organizations__organization_id__attributes_get
20440
+ operationId: get_organization_attributes_v1_organizations__organization_id__attributes_get
20436
20441
  parameters:
20437
20442
  - in: path
20438
20443
  name: organization_id
20439
20444
  required: true
20440
20445
  schema:
20441
- anyOf:
20442
- - examples:
20443
- - organization_01h45ytscbebyvny4gc8cr8ma2
20444
- format: typeid
20445
- pattern: ^organization_[0-7][0-9a-hjkmnpq-tv-z]{25}$
20446
- type: string
20447
- x-typeid-prefix: organization
20448
- - type: 'null'
20446
+ examples:
20447
+ - organization_01h45ytscbebyvny4gc8cr8ma2
20448
+ format: typeid
20449
+ pattern: ^organization_[0-7][0-9a-hjkmnpq-tv-z]{25}$
20449
20450
  title: Organization Id
20451
+ type: string
20452
+ x-typeid-prefix: organization
20450
20453
  - description: Optional list of attribute keys to filter
20451
20454
  in: query
20452
20455
  name: keys
@@ -20466,8 +20469,8 @@ paths:
20466
20469
  schema:
20467
20470
  items:
20468
20471
  $ref: '#/components/schemas/OrganizationAttributeResponse'
20469
- title: Response Get Attributes V1 Organizations Organization Id Attributes
20470
- Get
20472
+ title: Response Get Organization Attributes V1 Organizations Organization
20473
+ Id Attributes Get
20471
20474
  type: array
20472
20475
  description: Successful Response
20473
20476
  '401':
@@ -20508,21 +20511,19 @@ paths:
20508
20511
  - organization
20509
20512
  patch:
20510
20513
  description: Updates one or more organization attributes for the specified organization
20511
- operationId: update_attributes_v1_organizations__organization_id__attributes_patch
20514
+ operationId: update_organization_attributes_v1_organizations__organization_id__attributes_patch
20512
20515
  parameters:
20513
20516
  - in: path
20514
20517
  name: organization_id
20515
20518
  required: true
20516
20519
  schema:
20517
- anyOf:
20518
- - examples:
20519
- - organization_01h45ytscbebyvny4gc8cr8ma2
20520
- format: typeid
20521
- pattern: ^organization_[0-7][0-9a-hjkmnpq-tv-z]{25}$
20522
- type: string
20523
- x-typeid-prefix: organization
20524
- - type: 'null'
20520
+ examples:
20521
+ - organization_01h45ytscbebyvny4gc8cr8ma2
20522
+ format: typeid
20523
+ pattern: ^organization_[0-7][0-9a-hjkmnpq-tv-z]{25}$
20525
20524
  title: Organization Id
20525
+ type: string
20526
+ x-typeid-prefix: organization
20526
20527
  requestBody:
20527
20528
  content:
20528
20529
  application/json:
@@ -20539,8 +20540,8 @@ paths:
20539
20540
  schema:
20540
20541
  items:
20541
20542
  $ref: '#/components/schemas/OrganizationAttributeResponse'
20542
- title: Response Update Attributes V1 Organizations Organization Id Attributes
20543
- Patch
20543
+ title: Response Update Organization Attributes V1 Organizations Organization
20544
+ Id Attributes Patch
20544
20545
  type: array
20545
20546
  description: Successful Response
20546
20547
  '401':
package/src/schema.d.ts CHANGED
@@ -1514,7 +1514,7 @@ export interface paths {
1514
1514
  * List organization attributes
1515
1515
  * @description Retrieves a list of organization attributes for the current organization
1516
1516
  */
1517
- get: operations["get_attributes_v1_organizations_attributes_get"];
1517
+ get: operations["get_current_organization_attributes_v1_organizations_attributes_get"];
1518
1518
  put?: never;
1519
1519
  post?: never;
1520
1520
  delete?: never;
@@ -1524,7 +1524,7 @@ export interface paths {
1524
1524
  * Update organization attributes
1525
1525
  * @description Updates one or more organization attributes for the current organization
1526
1526
  */
1527
- patch: operations["update_attributes_v1_organizations_attributes_patch"];
1527
+ patch: operations["update_current_organization_attributes_v1_organizations_attributes_patch"];
1528
1528
  trace?: never;
1529
1529
  };
1530
1530
  "/v1/organizations/ip-restrictions": {
@@ -1672,7 +1672,7 @@ export interface paths {
1672
1672
  * List organization attributes
1673
1673
  * @description Retrieves a list of organization attributes for the specified organization
1674
1674
  */
1675
- get: operations["get_attributes_v1_organizations__organization_id__attributes_get"];
1675
+ get: operations["get_organization_attributes_v1_organizations__organization_id__attributes_get"];
1676
1676
  put?: never;
1677
1677
  post?: never;
1678
1678
  delete?: never;
@@ -1682,7 +1682,7 @@ export interface paths {
1682
1682
  * Update organization attributes
1683
1683
  * @description Updates one or more organization attributes for the specified organization
1684
1684
  */
1685
- patch: operations["update_attributes_v1_organizations__organization_id__attributes_patch"];
1685
+ patch: operations["update_organization_attributes_v1_organizations__organization_id__attributes_patch"];
1686
1686
  trace?: never;
1687
1687
  };
1688
1688
  "/v1/organizations/{organization_id}/billing/invoices": {
@@ -2413,6 +2413,11 @@ export interface components {
2413
2413
  };
2414
2414
  /** CommandError */
2415
2415
  CommandError: {
2416
+ /**
2417
+ * Code
2418
+ * @description Stable semantic error code for known failure modes (e.g. 'ERROR_BATCH_EMPTY'); null for ad-hoc failures. Matches the 'code' field in top-level error responses.
2419
+ */
2420
+ code?: string | null;
2416
2421
  /**
2417
2422
  * Error
2418
2423
  * @description Error message
@@ -2423,6 +2428,21 @@ export interface components {
2423
2428
  * @description Index of the failed command in the request
2424
2429
  */
2425
2430
  index: number;
2431
+ /**
2432
+ * Instance Index
2433
+ * @description Index within the bulk command's instances[] for per-instance failures
2434
+ */
2435
+ instance_index?: number | null;
2436
+ /**
2437
+ * Resource Key
2438
+ * @description Resource identifier (zone name, domain name, contact email) for per-instance failures
2439
+ */
2440
+ resource_key?: string | null;
2441
+ /**
2442
+ * Type
2443
+ * @description RFC 9457 problem type identifier derived from the exception class (e.g. 'value', 'batch-empty'). Matches the 'type' field in top-level error responses.
2444
+ */
2445
+ type?: string | null;
2426
2446
  };
2427
2447
  /**
2428
2448
  * ComplianceStatus
@@ -15535,10 +15555,9 @@ export interface operations {
15535
15555
  };
15536
15556
  };
15537
15557
  };
15538
- get_attributes_v1_organizations_attributes_get: {
15558
+ get_current_organization_attributes_v1_organizations_attributes_get: {
15539
15559
  parameters: {
15540
15560
  query?: {
15541
- organization_id?: TypeId<"organization"> | null;
15542
15561
  /** @description Optional list of attribute keys to filter */
15543
15562
  keys?: string[] | null;
15544
15563
  };
@@ -15600,11 +15619,9 @@ export interface operations {
15600
15619
  };
15601
15620
  };
15602
15621
  };
15603
- update_attributes_v1_organizations_attributes_patch: {
15622
+ update_current_organization_attributes_v1_organizations_attributes_patch: {
15604
15623
  parameters: {
15605
- query?: {
15606
- organization_id?: TypeId<"organization"> | null;
15607
- };
15624
+ query?: never;
15608
15625
  header?: never;
15609
15626
  path?: never;
15610
15627
  cookie?: never;
@@ -16303,7 +16320,7 @@ export interface operations {
16303
16320
  };
16304
16321
  };
16305
16322
  };
16306
- get_attributes_v1_organizations__organization_id__attributes_get: {
16323
+ get_organization_attributes_v1_organizations__organization_id__attributes_get: {
16307
16324
  parameters: {
16308
16325
  query?: {
16309
16326
  /** @description Optional list of attribute keys to filter */
@@ -16311,7 +16328,7 @@ export interface operations {
16311
16328
  };
16312
16329
  header?: never;
16313
16330
  path: {
16314
- organization_id: TypeId<"organization"> | null;
16331
+ organization_id: TypeId<"organization">;
16315
16332
  };
16316
16333
  cookie?: never;
16317
16334
  };
@@ -16369,12 +16386,12 @@ export interface operations {
16369
16386
  };
16370
16387
  };
16371
16388
  };
16372
- update_attributes_v1_organizations__organization_id__attributes_patch: {
16389
+ update_organization_attributes_v1_organizations__organization_id__attributes_patch: {
16373
16390
  parameters: {
16374
16391
  query?: never;
16375
16392
  header?: never;
16376
16393
  path: {
16377
- organization_id: TypeId<"organization"> | null;
16394
+ organization_id: TypeId<"organization">;
16378
16395
  };
16379
16396
  cookie?: never;
16380
16397
  };