@opusdns/api 0.207.0 → 0.209.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.207.0",
6
+ "version": "0.209.0",
7
7
  "description": "TypeScript types for the OpusDNS OpenAPI specification",
8
8
  "main": "./src/index.ts",
9
9
  "module": "./src/index.ts",
@@ -211,7 +211,6 @@ import { UserWithRelationPermissions } from './schemas';
211
211
  import { ValidationError } from './schemas';
212
212
  import { VisitsByKeyBucket } from './schemas';
213
213
  import { WhoisBase } from './schemas';
214
- import { WildcardHttpRedirectRequest } from './schemas';
215
214
  import { RequestAuthcode } from './schemas';
216
215
  import { RequestAuthcode2 } from './schemas';
217
216
  import { DomainAvailabilityList } from './schemas';
@@ -27700,184 +27699,6 @@ export const KEYS_WHOIS_BASE = [
27700
27699
  KEY_WHOIS_BASE_WHOIS_SERVER,
27701
27700
  ] as const satisfies (keyof WhoisBase)[];
27702
27701
 
27703
- /**
27704
- * redirect_code property
27705
- *
27706
- *
27707
- *
27708
- *
27709
- * @remarks
27710
- * This key constant provides type-safe access to the `redirect_code` property of WildcardHttpRedirectRequest objects.
27711
- * Use this constant when you need to access properties dynamically or ensure type safety.
27712
- *
27713
- * @example
27714
- * ```typescript
27715
- * // Direct property access
27716
- * const value = wildcardhttpredirectrequest[KEY_WILDCARD_HTTP_REDIRECT_REQUEST_REDIRECT_CODE];
27717
- *
27718
- * // Dynamic property access
27719
- * const propertyName = KEY_WILDCARD_HTTP_REDIRECT_REQUEST_REDIRECT_CODE;
27720
- * const value = wildcardhttpredirectrequest[propertyName];
27721
- * ```
27722
- *
27723
- * @see {@link WildcardHttpRedirectRequest} - The TypeScript type definition
27724
- * @see {@link KEYS_WILDCARD_HTTP_REDIRECT_REQUEST} - Array of all keys for this type
27725
- */
27726
- export const KEY_WILDCARD_HTTP_REDIRECT_REQUEST_REDIRECT_CODE: keyof WildcardHttpRedirectRequest = 'redirect_code';
27727
- /**
27728
- * Request Path
27729
- *
27730
- *
27731
- * @type {string}
27732
- *
27733
- *
27734
- * @remarks
27735
- * This key constant provides type-safe access to the `request_path` property of WildcardHttpRedirectRequest objects.
27736
- * Use this constant when you need to access properties dynamically or ensure type safety.
27737
- *
27738
- * @example
27739
- * ```typescript
27740
- * // Direct property access
27741
- * const value = wildcardhttpredirectrequest[KEY_WILDCARD_HTTP_REDIRECT_REQUEST_REQUEST_PATH];
27742
- *
27743
- * // Dynamic property access
27744
- * const propertyName = KEY_WILDCARD_HTTP_REDIRECT_REQUEST_REQUEST_PATH;
27745
- * const value = wildcardhttpredirectrequest[propertyName];
27746
- * ```
27747
- *
27748
- * @see {@link WildcardHttpRedirectRequest} - The TypeScript type definition
27749
- * @see {@link KEYS_WILDCARD_HTTP_REDIRECT_REQUEST} - Array of all keys for this type
27750
- */
27751
- export const KEY_WILDCARD_HTTP_REDIRECT_REQUEST_REQUEST_PATH: keyof WildcardHttpRedirectRequest = 'request_path';
27752
- /**
27753
- * Request Subdomain
27754
- *
27755
- *
27756
- * @type {string}
27757
- *
27758
- *
27759
- * @remarks
27760
- * This key constant provides type-safe access to the `request_subdomain` property of WildcardHttpRedirectRequest objects.
27761
- * Use this constant when you need to access properties dynamically or ensure type safety.
27762
- *
27763
- * @example
27764
- * ```typescript
27765
- * // Direct property access
27766
- * const value = wildcardhttpredirectrequest[KEY_WILDCARD_HTTP_REDIRECT_REQUEST_REQUEST_SUBDOMAIN];
27767
- *
27768
- * // Dynamic property access
27769
- * const propertyName = KEY_WILDCARD_HTTP_REDIRECT_REQUEST_REQUEST_SUBDOMAIN;
27770
- * const value = wildcardhttpredirectrequest[propertyName];
27771
- * ```
27772
- *
27773
- * @see {@link WildcardHttpRedirectRequest} - The TypeScript type definition
27774
- * @see {@link KEYS_WILDCARD_HTTP_REDIRECT_REQUEST} - Array of all keys for this type
27775
- */
27776
- export const KEY_WILDCARD_HTTP_REDIRECT_REQUEST_REQUEST_SUBDOMAIN: keyof WildcardHttpRedirectRequest = 'request_subdomain';
27777
- /**
27778
- * Target Hostname
27779
- *
27780
- *
27781
- * @type {string}
27782
- *
27783
- *
27784
- * @remarks
27785
- * This key constant provides type-safe access to the `target_hostname` property of WildcardHttpRedirectRequest objects.
27786
- * Use this constant when you need to access properties dynamically or ensure type safety.
27787
- *
27788
- * @example
27789
- * ```typescript
27790
- * // Direct property access
27791
- * const value = wildcardhttpredirectrequest[KEY_WILDCARD_HTTP_REDIRECT_REQUEST_TARGET_HOSTNAME];
27792
- *
27793
- * // Dynamic property access
27794
- * const propertyName = KEY_WILDCARD_HTTP_REDIRECT_REQUEST_TARGET_HOSTNAME;
27795
- * const value = wildcardhttpredirectrequest[propertyName];
27796
- * ```
27797
- *
27798
- * @see {@link WildcardHttpRedirectRequest} - The TypeScript type definition
27799
- * @see {@link KEYS_WILDCARD_HTTP_REDIRECT_REQUEST} - Array of all keys for this type
27800
- */
27801
- export const KEY_WILDCARD_HTTP_REDIRECT_REQUEST_TARGET_HOSTNAME: keyof WildcardHttpRedirectRequest = 'target_hostname';
27802
- /**
27803
- * Target Path
27804
- *
27805
- *
27806
- * @type {string}
27807
- *
27808
- *
27809
- * @remarks
27810
- * This key constant provides type-safe access to the `target_path` property of WildcardHttpRedirectRequest objects.
27811
- * Use this constant when you need to access properties dynamically or ensure type safety.
27812
- *
27813
- * @example
27814
- * ```typescript
27815
- * // Direct property access
27816
- * const value = wildcardhttpredirectrequest[KEY_WILDCARD_HTTP_REDIRECT_REQUEST_TARGET_PATH];
27817
- *
27818
- * // Dynamic property access
27819
- * const propertyName = KEY_WILDCARD_HTTP_REDIRECT_REQUEST_TARGET_PATH;
27820
- * const value = wildcardhttpredirectrequest[propertyName];
27821
- * ```
27822
- *
27823
- * @see {@link WildcardHttpRedirectRequest} - The TypeScript type definition
27824
- * @see {@link KEYS_WILDCARD_HTTP_REDIRECT_REQUEST} - Array of all keys for this type
27825
- */
27826
- export const KEY_WILDCARD_HTTP_REDIRECT_REQUEST_TARGET_PATH: keyof WildcardHttpRedirectRequest = 'target_path';
27827
- /**
27828
- * target_protocol property
27829
- *
27830
- *
27831
- *
27832
- *
27833
- * @remarks
27834
- * This key constant provides type-safe access to the `target_protocol` property of WildcardHttpRedirectRequest objects.
27835
- * Use this constant when you need to access properties dynamically or ensure type safety.
27836
- *
27837
- * @example
27838
- * ```typescript
27839
- * // Direct property access
27840
- * const value = wildcardhttpredirectrequest[KEY_WILDCARD_HTTP_REDIRECT_REQUEST_TARGET_PROTOCOL];
27841
- *
27842
- * // Dynamic property access
27843
- * const propertyName = KEY_WILDCARD_HTTP_REDIRECT_REQUEST_TARGET_PROTOCOL;
27844
- * const value = wildcardhttpredirectrequest[propertyName];
27845
- * ```
27846
- *
27847
- * @see {@link WildcardHttpRedirectRequest} - The TypeScript type definition
27848
- * @see {@link KEYS_WILDCARD_HTTP_REDIRECT_REQUEST} - Array of all keys for this type
27849
- */
27850
- export const KEY_WILDCARD_HTTP_REDIRECT_REQUEST_TARGET_PROTOCOL: keyof WildcardHttpRedirectRequest = 'target_protocol';
27851
-
27852
- /**
27853
- * Array of all WildcardHttpRedirectRequest property keys
27854
- *
27855
- * @remarks
27856
- * This constant provides a readonly array containing all valid property keys for WildcardHttpRedirectRequest objects.
27857
- * Useful for iteration, validation, and generating dynamic UI components.
27858
- *
27859
- * @example
27860
- * ```typescript
27861
- * // Iterating through all keys
27862
- * for (const key of KEYS_WILDCARD_HTTP_REDIRECT_REQUEST) {
27863
- * console.log(`Property: ${key}, Value: ${wildcardhttpredirectrequest[key]}`);
27864
- * }
27865
- *
27866
- * // Validation
27867
- * const isValidKey = KEYS_WILDCARD_HTTP_REDIRECT_REQUEST.includes(someKey);
27868
- * ```
27869
- *
27870
- * @see {@link WildcardHttpRedirectRequest} - The TypeScript type definition
27871
- */
27872
- export const KEYS_WILDCARD_HTTP_REDIRECT_REQUEST = [
27873
- KEY_WILDCARD_HTTP_REDIRECT_REQUEST_REDIRECT_CODE,
27874
- KEY_WILDCARD_HTTP_REDIRECT_REQUEST_REQUEST_PATH,
27875
- KEY_WILDCARD_HTTP_REDIRECT_REQUEST_REQUEST_SUBDOMAIN,
27876
- KEY_WILDCARD_HTTP_REDIRECT_REQUEST_TARGET_HOSTNAME,
27877
- KEY_WILDCARD_HTTP_REDIRECT_REQUEST_TARGET_PATH,
27878
- KEY_WILDCARD_HTTP_REDIRECT_REQUEST_TARGET_PROTOCOL,
27879
- ] as const satisfies (keyof WildcardHttpRedirectRequest)[];
27880
-
27881
27702
  /**
27882
27703
  * Detail
27883
27704
  *
@@ -2066,61 +2066,6 @@ export type GET_DomainForwardsHostnameProtocol_Request = {
2066
2066
  */
2067
2067
  export type GET_DomainForwardsHostnameProtocol_Request_Path = GET_DomainForwardsHostnameProtocol_Request['parameters']['path'];
2068
2068
 
2069
- /**
2070
- * Request type for POST DomainForwardsHostnameProtocol endpoint
2071
- *
2072
- * Create domain forward set (deprecated)
2073
- * Deprecated: Use POST /{hostname} with protocol in body instead. Creates a new domain forward set for a specific protocol (HTTP or HTTPS).
2074
- *
2075
- * @remarks
2076
- * This type defines the complete request structure for the POST DomainForwardsHostnameProtocol endpoint.
2077
- * It includes all parameters (query, path) and request body types as defined in the OpenAPI specification.
2078
- * Use this type to ensure type safety when making API requests to this endpoint.
2079
- *
2080
- * @example
2081
- * Use this type to ensure type safety when making API requests to this endpoint.
2082
- *
2083
- * @path /v1/domain-forwards/{hostname}/{protocol}
2084
- * @param hostname (path) - Hostname
2085
- *
2086
- * @see {@link POST_DomainForwardsHostnameProtocol_Request_Query} - Query parameters type
2087
- * @see {@link POST_DomainForwardsHostnameProtocol_Request_Path} - Path parameters type
2088
- * @see {@link POST_DomainForwardsHostnameProtocol_Request_Body} - Request body type
2089
- */
2090
- export type POST_DomainForwardsHostnameProtocol_Request = {
2091
- parameters: {
2092
- path: operations['create_domain_forward_set_deprecated_v1_domain_forwards__hostname___protocol__post']['parameters']['path'];
2093
- };
2094
- requestBody: DomainForwardSetRequest;
2095
- }
2096
- /**
2097
- * Path parameters for POST /v1/domain-forwards/{hostname}/{protocol}
2098
- *
2099
- * @remarks
2100
- * This type defines the path parameters for the POST /v1/domain-forwards/{hostname}/{protocol} endpoint.
2101
- * It provides type safety for all path parameters as defined in the OpenAPI specification.
2102
- *
2103
- * @example
2104
- * Use this type to ensure type safety for path parameters.
2105
- *
2106
- * @path /v1/domain-forwards/{hostname}/{protocol}
2107
- * @param hostname (path) - Hostname
2108
- */
2109
- export type POST_DomainForwardsHostnameProtocol_Request_Path = POST_DomainForwardsHostnameProtocol_Request['parameters']['path'];
2110
- /**
2111
- * Request body for POST /v1/domain-forwards/{hostname}/{protocol}
2112
- *
2113
- * @remarks
2114
- * This type defines the request body structure for the POST /v1/domain-forwards/{hostname}/{protocol} endpoint.
2115
- * It provides type safety for the request body as defined in the OpenAPI specification.
2116
- *
2117
- * @example
2118
- * Use this type to ensure type safety for request body structure.
2119
- *
2120
- * @path /v1/domain-forwards/{hostname}/{protocol}
2121
- */
2122
- export type POST_DomainForwardsHostnameProtocol_Request_Body = POST_DomainForwardsHostnameProtocol_Request['requestBody'];
2123
-
2124
2069
  /**
2125
2070
  * Request type for PUT DomainForwardsHostnameProtocol endpoint
2126
2071
  *
@@ -2179,7 +2124,8 @@ export type PUT_DomainForwardsHostnameProtocol_Request_Body = PUT_DomainForwards
2179
2124
  /**
2180
2125
  * Request type for GET DomainForwardsMetrics endpoint
2181
2126
  *
2182
- * Metrics
2127
+ * Get domain forward metrics
2128
+ * Retrieves overall metrics for domain forwards including total and unique visit counts.
2183
2129
  *
2184
2130
  * @remarks
2185
2131
  * This type defines the complete request structure for the GET DomainForwardsMetrics endpoint.
@@ -2223,7 +2169,8 @@ export type GET_DomainForwardsMetrics_Request_Query = GET_DomainForwardsMetrics_
2223
2169
  /**
2224
2170
  * Request type for GET DomainForwardsMetricsBrowser endpoint
2225
2171
  *
2226
- * Browser Stats
2172
+ * Get browser statistics
2173
+ * Retrieves visitor traffic broken down by browser type (Chrome, Safari, Firefox, etc.) with total and unique visit counts.
2227
2174
  *
2228
2175
  * @remarks
2229
2176
  * This type defines the complete request structure for the GET DomainForwardsMetricsBrowser endpoint.
@@ -2267,7 +2214,8 @@ export type GET_DomainForwardsMetricsBrowser_Request_Query = GET_DomainForwardsM
2267
2214
  /**
2268
2215
  * Request type for GET DomainForwardsMetricsGeo endpoint
2269
2216
  *
2270
- * Geo Stats
2217
+ * Get geographic statistics
2218
+ * Retrieves visitor traffic broken down by geographic location (country code) with visit counts.
2271
2219
  *
2272
2220
  * @remarks
2273
2221
  * This type defines the complete request structure for the GET DomainForwardsMetricsGeo endpoint.
@@ -2311,7 +2259,8 @@ export type GET_DomainForwardsMetricsGeo_Request_Query = GET_DomainForwardsMetri
2311
2259
  /**
2312
2260
  * Request type for GET DomainForwardsMetricsPlatform endpoint
2313
2261
  *
2314
- * Platform Stats
2262
+ * Get platform statistics
2263
+ * Retrieves visitor traffic broken down by platform (Windows, Macintosh, iOS, Android, Linux) with total and unique visit counts.
2315
2264
  *
2316
2265
  * @remarks
2317
2266
  * This type defines the complete request structure for the GET DomainForwardsMetricsPlatform endpoint.
@@ -2355,7 +2304,8 @@ export type GET_DomainForwardsMetricsPlatform_Request_Query = GET_DomainForwards
2355
2304
  /**
2356
2305
  * Request type for GET DomainForwardsMetricsReferrer endpoint
2357
2306
  *
2358
- * Referrer Stats
2307
+ * Get referrer statistics
2308
+ * Retrieves visitor referral sources (where traffic came from) with total and unique visit counts.
2359
2309
  *
2360
2310
  * @remarks
2361
2311
  * This type defines the complete request structure for the GET DomainForwardsMetricsReferrer endpoint.
@@ -2399,7 +2349,8 @@ export type GET_DomainForwardsMetricsReferrer_Request_Query = GET_DomainForwards
2399
2349
  /**
2400
2350
  * Request type for GET DomainForwardsMetricsStatusCode endpoint
2401
2351
  *
2402
- * Status Code Stats
2352
+ * Get HTTP status code statistics
2353
+ * Retrieves distribution of HTTP redirect status codes (301, 302, 307, 308) used across forwards.
2403
2354
  *
2404
2355
  * @remarks
2405
2356
  * This type defines the complete request structure for the GET DomainForwardsMetricsStatusCode endpoint.
@@ -2443,7 +2394,8 @@ export type GET_DomainForwardsMetricsStatusCode_Request_Query = GET_DomainForwar
2443
2394
  /**
2444
2395
  * Request type for GET DomainForwardsMetricsTimeSeries endpoint
2445
2396
  *
2446
- * Time Series
2397
+ * Get domain forward time series metrics
2398
+ * Retrieves visit counts bucketed by time intervals (hourly, daily) for the specified time range.
2447
2399
  *
2448
2400
  * @remarks
2449
2401
  * This type defines the complete request structure for the GET DomainForwardsMetricsTimeSeries endpoint.
@@ -2487,7 +2439,8 @@ export type GET_DomainForwardsMetricsTimeSeries_Request_Query = GET_DomainForwar
2487
2439
  /**
2488
2440
  * Request type for GET DomainForwardsMetricsUserAgent endpoint
2489
2441
  *
2490
- * User Agent Stats
2442
+ * Get user agent statistics
2443
+ * Retrieves visitor traffic broken down by user agent string with total and unique visit counts.
2491
2444
  *
2492
2445
  * @remarks
2493
2446
  * This type defines the complete request structure for the GET DomainForwardsMetricsUserAgent endpoint.
@@ -2531,7 +2484,8 @@ export type GET_DomainForwardsMetricsUserAgent_Request_Query = GET_DomainForward
2531
2484
  /**
2532
2485
  * Request type for GET DomainForwardsMetricsVisitsByKey endpoint
2533
2486
  *
2534
- * Visits By Key
2487
+ * Get visits grouped by key
2488
+ * Retrieves visit metrics grouped by a specified key (url, fqdn, domain, or forward) with total and unique visit counts.
2535
2489
  *
2536
2490
  * @remarks
2537
2491
  * This type defines the complete request structure for the GET DomainForwardsMetricsVisitsByKey endpoint.