@opusdns/api 0.222.0 → 0.223.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.222.0",
6
+ "version": "0.223.0",
7
7
  "description": "TypeScript types for the OpusDNS OpenAPI specification",
8
8
  "main": "./src/index.ts",
9
9
  "module": "./src/index.ts",
@@ -70,6 +70,7 @@ import { DnsZoneRrsetsPatchOps } from './schemas';
70
70
  import { DnsZoneSummary } from './schemas';
71
71
  import { DomainAvailability } from './schemas';
72
72
  import { DomainAvailabilityMeta } from './schemas';
73
+ import { DomainAvailabilityRequest } from './schemas';
73
74
  import { DomainCheck } from './schemas';
74
75
  import { DomainContact } from './schemas';
75
76
  import { DomainCreate } from './schemas';
@@ -6674,6 +6675,56 @@ export const KEYS_DOMAIN_AVAILABILITY_META = [
6674
6675
  KEY_DOMAIN_AVAILABILITY_META_TOTAL,
6675
6676
  ] as const satisfies (keyof DomainAvailabilityMeta)[];
6676
6677
 
6678
+ /**
6679
+ * Domains
6680
+ *
6681
+ *
6682
+ * @type {array}
6683
+ *
6684
+ *
6685
+ * @remarks
6686
+ * This key constant provides type-safe access to the `domains` property of DomainAvailabilityRequest objects.
6687
+ * Use this constant when you need to access properties dynamically or ensure type safety.
6688
+ *
6689
+ * @example
6690
+ * ```typescript
6691
+ * // Direct property access
6692
+ * const value = domainavailabilityrequest[KEY_DOMAIN_AVAILABILITY_REQUEST_DOMAINS];
6693
+ *
6694
+ * // Dynamic property access
6695
+ * const propertyName = KEY_DOMAIN_AVAILABILITY_REQUEST_DOMAINS;
6696
+ * const value = domainavailabilityrequest[propertyName];
6697
+ * ```
6698
+ *
6699
+ * @see {@link DomainAvailabilityRequest} - The TypeScript type definition
6700
+ * @see {@link KEYS_DOMAIN_AVAILABILITY_REQUEST} - Array of all keys for this type
6701
+ */
6702
+ export const KEY_DOMAIN_AVAILABILITY_REQUEST_DOMAINS: keyof DomainAvailabilityRequest = 'domains';
6703
+
6704
+ /**
6705
+ * Array of all DomainAvailabilityRequest property keys
6706
+ *
6707
+ * @remarks
6708
+ * This constant provides a readonly array containing all valid property keys for DomainAvailabilityRequest objects.
6709
+ * Useful for iteration, validation, and generating dynamic UI components.
6710
+ *
6711
+ * @example
6712
+ * ```typescript
6713
+ * // Iterating through all keys
6714
+ * for (const key of KEYS_DOMAIN_AVAILABILITY_REQUEST) {
6715
+ * console.log(`Property: ${key}, Value: ${domainavailabilityrequest[key]}`);
6716
+ * }
6717
+ *
6718
+ * // Validation
6719
+ * const isValidKey = KEYS_DOMAIN_AVAILABILITY_REQUEST.includes(someKey);
6720
+ * ```
6721
+ *
6722
+ * @see {@link DomainAvailabilityRequest} - The TypeScript type definition
6723
+ */
6724
+ export const KEYS_DOMAIN_AVAILABILITY_REQUEST = [
6725
+ KEY_DOMAIN_AVAILABILITY_REQUEST_DOMAINS,
6726
+ ] as const satisfies (keyof DomainAvailabilityRequest)[];
6727
+
6677
6728
  /**
6678
6729
  * Results
6679
6730
  *
@@ -34,7 +34,7 @@ import { operations } from '../schema';
34
34
 
35
35
  import { DomainDnssecDataCreateArray, OrganizationAttributeUpdateArray } from './schemas-arrays.d';
36
36
 
37
- import { ContactCreate, ContactAttributeSetCreate, ContactAttributeSetUpdate, DnsZoneCreate, DnsZoneRecordsPatchOps, DnsZoneRrsetsPatchOps, DnsZoneRrsetsCreate, DomainForwardPatchOps, DomainForwardCreateRequest, DomainForwardSetCreateRequest, DomainForwardSetRequest, DomainCreate, DomainUpdate, DomainRenewRequest, DomainRestoreRequest, DomainWithdrawRequest, DomainTransitRequest, DomainTransferIn, EmailForwardCreate, EmailForwardAliasCreate, EmailForwardAliasUpdate, OrganizationCreate, IpRestrictionCreate, IpRestrictionUpdate, OrganizationUpdate, ParkingSignupRequest, UserCreate, PasswordUpdate, UserUpdate, SpiceDbRelationshipUpdate } from './schemas.d';
37
+ import { DomainAvailabilityRequest, ContactCreate, ContactAttributeSetCreate, ContactAttributeSetUpdate, DnsZoneCreate, DnsZoneRecordsPatchOps, DnsZoneRrsetsPatchOps, DnsZoneRrsetsCreate, DomainForwardPatchOps, DomainForwardCreateRequest, DomainForwardSetCreateRequest, DomainForwardSetRequest, DomainCreate, DomainUpdate, DomainRenewRequest, DomainRestoreRequest, DomainWithdrawRequest, DomainTransitRequest, DomainTransferIn, EmailForwardCreate, EmailForwardAliasCreate, EmailForwardAliasUpdate, OrganizationCreate, IpRestrictionCreate, IpRestrictionUpdate, OrganizationUpdate, ParkingSignupRequest, UserCreate, PasswordUpdate, UserUpdate, SpiceDbRelationshipUpdate } from './schemas.d';
38
38
 
39
39
  /**
40
40
  * Request type for GET ArchiveEmailForwardLogsAliasesEmailForwardAliasId endpoint
@@ -385,6 +385,43 @@ Specify one or more domains to check for availability.
385
385
  */
386
386
  export type GET_AvailabilityStream_Request_Query = GET_AvailabilityStream_Request['parameters']['query'];
387
387
 
388
+ /**
389
+ * Request type for POST AvailabilityStream endpoint
390
+ *
391
+ * Stream domain availability results
392
+ * Stream domain availability results using Server-Sent Events (SSE) until the `done` event is received.
393
+ *
394
+ * @remarks
395
+ * This type defines the complete request structure for the POST AvailabilityStream endpoint.
396
+ * It includes all parameters (query, path) and request body types as defined in the OpenAPI specification.
397
+ * Use this type to ensure type safety when making API requests to this endpoint.
398
+ *
399
+ * @example
400
+ * Use this type to ensure type safety when making API requests to this endpoint.
401
+ *
402
+ * @path /v1/availability/stream
403
+ *
404
+ * @see {@link POST_AvailabilityStream_Request_Query} - Query parameters type
405
+ * @see {@link POST_AvailabilityStream_Request_Path} - Path parameters type
406
+ * @see {@link POST_AvailabilityStream_Request_Body} - Request body type
407
+ */
408
+ export type POST_AvailabilityStream_Request = {
409
+ requestBody: DomainAvailabilityRequest;
410
+ }
411
+ /**
412
+ * Request body for POST /v1/availability/stream
413
+ *
414
+ * @remarks
415
+ * This type defines the request body structure for the POST /v1/availability/stream endpoint.
416
+ * It provides type safety for the request body as defined in the OpenAPI specification.
417
+ *
418
+ * @example
419
+ * Use this type to ensure type safety for request body structure.
420
+ *
421
+ * @path /v1/availability/stream
422
+ */
423
+ export type POST_AvailabilityStream_Request_Body = POST_AvailabilityStream_Request['requestBody'];
424
+
388
425
  /**
389
426
  * Request type for GET Contacts endpoint
390
427
  *
@@ -564,6 +564,80 @@ Specify one or more domains to check for availability.
564
564
  */
565
565
  export type GET_AvailabilityStream_Response_500 = Problem
566
566
 
567
+ /**
568
+ * Response types for POST AvailabilityStream endpoint
569
+ *
570
+ * Stream domain availability results
571
+ * Stream domain availability results using Server-Sent Events (SSE) until the `done` event is received.
572
+ *
573
+ * @remarks
574
+ * This type defines all possible response structures for the POST AvailabilityStream endpoint.
575
+ * Each response code maps to a specific response type as defined in the OpenAPI specification.
576
+ * Use this type to ensure type safety when handling API responses from this endpoint.
577
+ *
578
+
579
+ *
580
+ * @path /v1/availability/stream
581
+ *
582
+ * @see {@link POST_AvailabilityStream_Response_401} - 401 response type
583
+ * @see {@link POST_AvailabilityStream_Response_422} - 422 response type
584
+ * @see {@link POST_AvailabilityStream_Response_500} - 500 response type
585
+ *
586
+
587
+ */
588
+ export type POST_AvailabilityStream_Response = POST_AvailabilityStream_Response_401 | POST_AvailabilityStream_Response_422 | POST_AvailabilityStream_Response_500;
589
+
590
+ /**
591
+ * 401 response for POST AvailabilityStream endpoint
592
+ *
593
+ * @remarks
594
+ * This type defines the response structure for the 401 status code
595
+ * of the POST AvailabilityStream endpoint.
596
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
597
+ *
598
+
599
+ *
600
+ * @path /v1/availability/stream
601
+ *
602
+ * @see {@link POST_AvailabilityStream_Response} - The main response type definition
603
+ * @see {@link Problem} - The actual schema type definition
604
+ */
605
+ export type POST_AvailabilityStream_Response_401 = Problem
606
+
607
+ /**
608
+ * 422 response for POST AvailabilityStream endpoint
609
+ *
610
+ * @remarks
611
+ * This type defines the response structure for the 422 status code
612
+ * of the POST AvailabilityStream endpoint.
613
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
614
+ *
615
+
616
+ *
617
+ * @path /v1/availability/stream
618
+ *
619
+ * @see {@link POST_AvailabilityStream_Response} - The main response type definition
620
+ * @see {@link HTTPValidationError} - The actual schema type definition
621
+ */
622
+ export type POST_AvailabilityStream_Response_422 = HTTPValidationError
623
+
624
+ /**
625
+ * 500 response for POST AvailabilityStream endpoint
626
+ *
627
+ * @remarks
628
+ * This type defines the response structure for the 500 status code
629
+ * of the POST AvailabilityStream endpoint.
630
+ * It provides type safety for handling this specific response as defined in the OpenAPI specification.
631
+ *
632
+
633
+ *
634
+ * @path /v1/availability/stream
635
+ *
636
+ * @see {@link POST_AvailabilityStream_Response} - The main response type definition
637
+ * @see {@link Problem} - The actual schema type definition
638
+ */
639
+ export type POST_AvailabilityStream_Response_500 = Problem
640
+
567
641
  /**
568
642
  * Response types for GET Contacts endpoint
569
643
  *
@@ -1034,6 +1034,22 @@ export type DomainAvailability = components['schemas']['DomainAvailability'];
1034
1034
  * @see {@link components} - The OpenAPI components schema definition
1035
1035
  */
1036
1036
  export type DomainAvailabilityMeta = components['schemas']['DomainAvailabilityMeta'];
1037
+ /**
1038
+ * DomainAvailabilityRequest
1039
+ *
1040
+ * @remarks
1041
+ * Type alias for the `DomainAvailabilityRequest` OpenAPI schema.
1042
+ * This type represents domainavailabilityrequest data structures used in API requests and responses.
1043
+ *
1044
+ * @example
1045
+ * ```typescript
1046
+ * const response = await api.getDomainAvailabilityRequest();
1047
+ * const item: DomainAvailabilityRequest = response.results;
1048
+ * ```
1049
+ *
1050
+ * @see {@link components} - The OpenAPI components schema definition
1051
+ */
1052
+ export type DomainAvailabilityRequest = components['schemas']['DomainAvailabilityRequest'];
1037
1053
  /**
1038
1054
  * DomainAvailabilityStatus
1039
1055
  *
package/src/openapi.yaml CHANGED
@@ -1634,6 +1634,19 @@ components:
1634
1634
  - processing_time_ms
1635
1635
  title: DomainAvailabilityMeta
1636
1636
  type: object
1637
+ DomainAvailabilityRequest:
1638
+ properties:
1639
+ domains:
1640
+ items:
1641
+ type: string
1642
+ maxItems: 1000
1643
+ minItems: 1
1644
+ title: Domains
1645
+ type: array
1646
+ required:
1647
+ - domains
1648
+ title: DomainAvailabilityRequest
1649
+ type: object
1637
1650
  DomainAvailabilityStatus:
1638
1651
  enum:
1639
1652
  - available
@@ -7325,7 +7338,7 @@ info:
7325
7338
  '
7326
7339
  summary: OpusDNS - your gateway to a seamless domain management experience.
7327
7340
  title: OpusDNS API
7328
- version: 2026-03-16-092857
7341
+ version: 2026-03-16-153546
7329
7342
  x-logo:
7330
7343
  altText: OpusDNS API Reference
7331
7344
  url: https://d24lr4zqs1tgqh.cloudfront.net/c9505a20-5ae1-406c-b060-d392569caebf.jpg
@@ -8136,6 +8149,68 @@ paths:
8136
8149
  summary: Stream domain availability results
8137
8150
  tags:
8138
8151
  - availability
8152
+ post:
8153
+ description: Stream domain availability results using Server-Sent Events (SSE)
8154
+ until the `done` event is received.
8155
+ operationId: stream_availability_post_v1_availability_stream_post
8156
+ requestBody:
8157
+ content:
8158
+ application/json:
8159
+ schema:
8160
+ $ref: '#/components/schemas/DomainAvailabilityRequest'
8161
+ required: true
8162
+ responses:
8163
+ '200':
8164
+ content:
8165
+ text/event-stream:
8166
+ examples:
8167
+ Data:
8168
+ description: Returns individual domains' availability
8169
+ summary: Availability data
8170
+ value: 'data: {"domain":"example.com","status":"unavailable"}'
8171
+ Event:
8172
+ description: Returned when an event occurs
8173
+ summary: Event
8174
+ value: 'event: done'
8175
+ schema:
8176
+ type: string
8177
+ description: Successful Response
8178
+ '401':
8179
+ content:
8180
+ application/problem+json:
8181
+ example:
8182
+ code: ERROR_AUTHENTICATION
8183
+ detail: Additional error context.
8184
+ status: 401
8185
+ title: Authentication Error
8186
+ type: authentication
8187
+ schema:
8188
+ $ref: '#/components/schemas/Problem'
8189
+ description: Unauthorized
8190
+ '422':
8191
+ content:
8192
+ application/problem+json:
8193
+ schema:
8194
+ $ref: '#/components/schemas/HTTPValidationError'
8195
+ description: Validation Error
8196
+ '500':
8197
+ content:
8198
+ application/problem+json:
8199
+ example:
8200
+ code: ERROR_AVAILABILITY_PROVIDER
8201
+ detail: Additional error context.
8202
+ status: 500
8203
+ title: Availability Error
8204
+ type: availability-internal
8205
+ schema:
8206
+ $ref: '#/components/schemas/Problem'
8207
+ description: Internal Server Error
8208
+ security:
8209
+ - OAuth2PasswordBearer: []
8210
+ - APIKeyHeader: []
8211
+ summary: Stream domain availability results
8212
+ tags:
8213
+ - availability
8139
8214
  /v1/contacts:
8140
8215
  get:
8141
8216
  description: Retrieves a paginated list of all contacts
package/src/schema.d.ts CHANGED
@@ -150,7 +150,11 @@ export interface paths {
150
150
  */
151
151
  get: operations["stream_availability_v1_availability_stream_get"];
152
152
  put?: never;
153
- post?: never;
153
+ /**
154
+ * Stream domain availability results
155
+ * @description Stream domain availability results using Server-Sent Events (SSE) until the `done` event is received.
156
+ */
157
+ post: operations["stream_availability_post_v1_availability_stream_post"];
154
158
  delete?: never;
155
159
  options?: never;
156
160
  head?: never;
@@ -3050,6 +3054,11 @@ export interface components {
3050
3054
  /** Total */
3051
3055
  total: number;
3052
3056
  };
3057
+ /** DomainAvailabilityRequest */
3058
+ DomainAvailabilityRequest: {
3059
+ /** Domains */
3060
+ domains: string[];
3061
+ };
3053
3062
  /**
3054
3063
  * DomainAvailabilityStatus
3055
3064
  * @enum {string}
@@ -7169,6 +7178,71 @@ export interface operations {
7169
7178
  };
7170
7179
  };
7171
7180
  };
7181
+ stream_availability_post_v1_availability_stream_post: {
7182
+ parameters: {
7183
+ query?: never;
7184
+ header?: never;
7185
+ path?: never;
7186
+ cookie?: never;
7187
+ };
7188
+ requestBody: {
7189
+ content: {
7190
+ "application/json": components["schemas"]["DomainAvailabilityRequest"];
7191
+ };
7192
+ };
7193
+ responses: {
7194
+ /** @description Successful Response */
7195
+ 200: {
7196
+ headers: {
7197
+ [name: string]: unknown;
7198
+ };
7199
+ content: {
7200
+ "text/event-stream": string;
7201
+ };
7202
+ };
7203
+ /** @description Unauthorized */
7204
+ 401: {
7205
+ headers: {
7206
+ [name: string]: unknown;
7207
+ };
7208
+ content: {
7209
+ /** @example {
7210
+ * "code": "ERROR_AUTHENTICATION",
7211
+ * "detail": "Additional error context.",
7212
+ * "status": 401,
7213
+ * "title": "Authentication Error",
7214
+ * "type": "authentication"
7215
+ * } */
7216
+ "application/problem+json": components["schemas"]["Problem"];
7217
+ };
7218
+ };
7219
+ /** @description Validation Error */
7220
+ 422: {
7221
+ headers: {
7222
+ [name: string]: unknown;
7223
+ };
7224
+ content: {
7225
+ "application/problem+json": components["schemas"]["HTTPValidationError"];
7226
+ };
7227
+ };
7228
+ /** @description Internal Server Error */
7229
+ 500: {
7230
+ headers: {
7231
+ [name: string]: unknown;
7232
+ };
7233
+ content: {
7234
+ /** @example {
7235
+ * "code": "ERROR_AVAILABILITY_PROVIDER",
7236
+ * "detail": "Additional error context.",
7237
+ * "status": 500,
7238
+ * "title": "Availability Error",
7239
+ * "type": "availability-internal"
7240
+ * } */
7241
+ "application/problem+json": components["schemas"]["Problem"];
7242
+ };
7243
+ };
7244
+ };
7245
+ };
7172
7246
  get_contacts_v1_contacts_get: {
7173
7247
  parameters: {
7174
7248
  query?: {