@opusdns/api 1.177.0 → 1.178.0

package/package.json

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

package/src/helpers/constants.ts

@@ -40,6 +40,7 @@ import type {
   DomainIncludeField,
   DomainListIncludeField,
   DomainSortField,
+  DomainStatisticsBreakdown,
   DomainStatus,
   EmailForwardLogSortField,
   EmailForwardLogStatus,
@@ -819,6 +820,18 @@ export const DOMAIN_SORT_FIELD_VALUES = [
   'transferred_on',
 ] as const satisfies ReadonlyArray<DomainSortField>;
 
+export const DOMAIN_STATISTICS_BREAKDOWN = {
+  NONE: "none",
+  ORGANIZATION: "organization",
+  TLD: "tld",
+} as const satisfies Record<string, DomainStatisticsBreakdown>;
+
+export const DOMAIN_STATISTICS_BREAKDOWN_VALUES = [
+  'none',
+  'organization',
+  'tld',
+] as const satisfies ReadonlyArray<DomainStatisticsBreakdown>;
+
 export const DOMAIN_STATUS = {
   OK: "ok",
   SERVER_TRANSFER_PROHIBITED: "serverTransferProhibited",

package/src/helpers/endpoints.ts

@@ -56,6 +56,7 @@ export const DOMAIN_SEARCH_SUGGEST_ENDPOINT = '/v1/domain-search/suggest';
 export const DOMAINS_ENDPOINT = '/v1/domains';
 export const DOMAINS_CHECK_ENDPOINT = '/v1/domains/check';
 export const DOMAINS_CLAIMS_NOTICES_ENDPOINT = '/v1/domains/claims-notices';
+export const DOMAINS_STATISTICS_ENDPOINT = '/v1/domains/statistics';
 export const DOMAINS_SUMMARY_ENDPOINT = '/v1/domains/summary';
 export const DOMAINS_TLD_SPECIFIC_AT_BY_DOMAIN_REFERENCE_WITHDRAW_ENDPOINT = '/v1/domains/tld-specific/at/{domain_reference}/withdraw';
 export const DOMAINS_TLD_SPECIFIC_BE_BY_DOMAIN_REFERENCE_AUTH_CODE_REQUEST_ENDPOINT = '/v1/domains/tld-specific/be/{domain_reference}/auth_code/request';
@@ -215,6 +216,7 @@ export type Endpoint =
   | typeof DOMAINS_ENDPOINT
   | typeof DOMAINS_CHECK_ENDPOINT
   | typeof DOMAINS_CLAIMS_NOTICES_ENDPOINT
+  | typeof DOMAINS_STATISTICS_ENDPOINT
   | typeof DOMAINS_SUMMARY_ENDPOINT
   | typeof DOMAINS_TLD_SPECIFIC_AT_BY_DOMAIN_REFERENCE_WITHDRAW_ENDPOINT
   | typeof DOMAINS_TLD_SPECIFIC_BE_BY_DOMAIN_REFERENCE_AUTH_CODE_REQUEST_ENDPOINT

package/src/helpers/keys.ts

@@ -193,6 +193,10 @@ import type {
   DomainSearch,
   DomainSearchSuggestionPriceData,
   DomainSearchSuggestionWithPrice,
+  DomainStatisticsBreakdown2,
+  DomainStatisticsBucket,
+  DomainStatistics,
+  DomainStatisticsTotals,
   DomainStatus2,
   DomainStatusesBase,
   DomainSummaryData,
@@ -2779,6 +2783,60 @@ export const KEYS_DOMAIN_SEARCH_SUGGESTION_WITH_PRICE = [
   KEY_DOMAIN_SEARCH_SUGGESTION_WITH_PRICE_RENEWAL_PRICE,
 ] as const satisfies (keyof DomainSearchSuggestionWithPrice)[];
 
+export const KEY_DOMAIN_STATISTICS_BREAKDOWN2_CREATE = 'create' satisfies keyof DomainStatisticsBreakdown2;
+export const KEY_DOMAIN_STATISTICS_BREAKDOWN2_KEY = 'key' satisfies keyof DomainStatisticsBreakdown2;
+export const KEY_DOMAIN_STATISTICS_BREAKDOWN2_LABEL = 'label' satisfies keyof DomainStatisticsBreakdown2;
+export const KEY_DOMAIN_STATISTICS_BREAKDOWN2_TOTAL = 'total' satisfies keyof DomainStatisticsBreakdown2;
+export const KEY_DOMAIN_STATISTICS_BREAKDOWN2_TRANSFER = 'transfer' satisfies keyof DomainStatisticsBreakdown2;
+
+export const KEYS_DOMAIN_STATISTICS_BREAKDOWN2 = [
+  KEY_DOMAIN_STATISTICS_BREAKDOWN2_CREATE,
+  KEY_DOMAIN_STATISTICS_BREAKDOWN2_KEY,
+  KEY_DOMAIN_STATISTICS_BREAKDOWN2_LABEL,
+  KEY_DOMAIN_STATISTICS_BREAKDOWN2_TOTAL,
+  KEY_DOMAIN_STATISTICS_BREAKDOWN2_TRANSFER,
+] as const satisfies (keyof DomainStatisticsBreakdown2)[];
+
+export const KEY_DOMAIN_STATISTICS_BUCKET_CREATE = 'create' satisfies keyof DomainStatisticsBucket;
+export const KEY_DOMAIN_STATISTICS_BUCKET_PARTIAL = 'partial' satisfies keyof DomainStatisticsBucket;
+export const KEY_DOMAIN_STATISTICS_BUCKET_PERIOD_START = 'period_start' satisfies keyof DomainStatisticsBucket;
+export const KEY_DOMAIN_STATISTICS_BUCKET_TRANSFER = 'transfer' satisfies keyof DomainStatisticsBucket;
+
+export const KEYS_DOMAIN_STATISTICS_BUCKET = [
+  KEY_DOMAIN_STATISTICS_BUCKET_CREATE,
+  KEY_DOMAIN_STATISTICS_BUCKET_PARTIAL,
+  KEY_DOMAIN_STATISTICS_BUCKET_PERIOD_START,
+  KEY_DOMAIN_STATISTICS_BUCKET_TRANSFER,
+] as const satisfies (keyof DomainStatisticsBucket)[];
+
+export const KEY_DOMAIN_STATISTICS_BREAKDOWN = 'breakdown' satisfies keyof DomainStatistics;
+export const KEY_DOMAIN_STATISTICS_BUCKETS = 'buckets' satisfies keyof DomainStatistics;
+export const KEY_DOMAIN_STATISTICS_END_DATE = 'end_date' satisfies keyof DomainStatistics;
+export const KEY_DOMAIN_STATISTICS_GRANULARITY = 'granularity' satisfies keyof DomainStatistics;
+export const KEY_DOMAIN_STATISTICS_ORGANIZATION_ID = 'organization_id' satisfies keyof DomainStatistics;
+export const KEY_DOMAIN_STATISTICS_START_DATE = 'start_date' satisfies keyof DomainStatistics;
+export const KEY_DOMAIN_STATISTICS_TOTALS = 'totals' satisfies keyof DomainStatistics;
+
+export const KEYS_DOMAIN_STATISTICS = [
+  KEY_DOMAIN_STATISTICS_BREAKDOWN,
+  KEY_DOMAIN_STATISTICS_BUCKETS,
+  KEY_DOMAIN_STATISTICS_END_DATE,
+  KEY_DOMAIN_STATISTICS_GRANULARITY,
+  KEY_DOMAIN_STATISTICS_ORGANIZATION_ID,
+  KEY_DOMAIN_STATISTICS_START_DATE,
+  KEY_DOMAIN_STATISTICS_TOTALS,
+] as const satisfies (keyof DomainStatistics)[];
+
+export const KEY_DOMAIN_STATISTICS_TOTALS_CREATE = 'create' satisfies keyof DomainStatisticsTotals;
+export const KEY_DOMAIN_STATISTICS_TOTALS_TOTAL = 'total' satisfies keyof DomainStatisticsTotals;
+export const KEY_DOMAIN_STATISTICS_TOTALS_TRANSFER = 'transfer' satisfies keyof DomainStatisticsTotals;
+
+export const KEYS_DOMAIN_STATISTICS_TOTALS = [
+  KEY_DOMAIN_STATISTICS_TOTALS_CREATE,
+  KEY_DOMAIN_STATISTICS_TOTALS_TOTAL,
+  KEY_DOMAIN_STATISTICS_TOTALS_TRANSFER,
+] as const satisfies (keyof DomainStatisticsTotals)[];
+
 export const KEY_DOMAIN_STATUS2_STATUS = 'status' satisfies keyof DomainStatus2;
 
 export const KEYS_DOMAIN_STATUS2 = [

package/src/helpers/permissions.ts

@@ -68,6 +68,7 @@ import {
   DOMAINS_CHECK_ENDPOINT,
   DOMAINS_CLAIMS_NOTICES_ENDPOINT,
   DOMAINS_ENDPOINT,
+  DOMAINS_STATISTICS_ENDPOINT,
   DOMAINS_SUMMARY_ENDPOINT,
   DOMAINS_TLD_SPECIFIC_AT_BY_DOMAIN_REFERENCE_WITHDRAW_ENDPOINT,
   DOMAINS_TLD_SPECIFIC_BE_BY_DOMAIN_REFERENCE_AUTH_CODE_REQUEST_ENDPOINT,
@@ -689,6 +690,13 @@ export const REQUIRED_PERMISSIONS = {
     patch: [],
     delete: [],
   },
+  [DOMAINS_STATISTICS_ENDPOINT]: {
+    get: [PUBLIC_PERMISSION.DOMAINS_READ],
+    post: [],
+    put: [],
+    patch: [],
+    delete: [],
+  },
   [DOMAINS_SUMMARY_ENDPOINT]: {
     get: [PUBLIC_PERMISSION.DOMAINS_READ],
     post: [],

package/src/helpers/requests.d.ts

@@ -586,6 +586,11 @@ export type GET_DomainSearchSuggest_Request = {
 };
 export type GET_DomainSearchSuggest_Request_Query = GET_DomainSearchSuggest_Request['parameters']['query'];
 
+export type GET_DomainsStatistics_Request = {
+  parameters: operations['get_domain_statistics_v1_domains_statistics_get']['parameters'];
+};
+export type GET_DomainsStatistics_Request_Query = GET_DomainsStatistics_Request['parameters']['query'];
+
 export type GET_DomainsSummary_Request = {
 };
 

package/src/helpers/responses.d.ts

@@ -38,6 +38,7 @@ import type {
   DomainRenew,
   DomainRestore,
   DomainSearch,
+  DomainStatistics,
   DomainSummary,
   DomainTransit,
   DomainWithdraw,
@@ -575,6 +576,11 @@ export type GET_DomainsCheck_Response = GET_DomainsCheck_Response_200 | GET_Doma
 export type GET_DomainsCheck_Response_200 = DomainCheck;
 export type GET_DomainsCheck_Response_422 = HTTPValidationError;
 
+export type GET_DomainsStatistics_Response = GET_DomainsStatistics_Response_200 | GET_DomainsStatistics_Response_422;
+
+export type GET_DomainsStatistics_Response_200 = DomainStatistics;
+export type GET_DomainsStatistics_Response_422 = HTTPValidationError;
+
 export type GET_DomainsSummary_Response = GET_DomainsSummary_Response_200 | GET_DomainsSummary_Response_422;
 
 export type GET_DomainsSummary_Response_200 = DomainSummary;

package/src/helpers/schemas.d.ts

@@ -238,6 +238,11 @@ export type DomainSearch = components['schemas']['DomainSearchResponse'];
 export type DomainSearchSuggestionPriceData = components['schemas']['DomainSearchSuggestionPriceData'];
 export type DomainSearchSuggestionWithPrice = components['schemas']['DomainSearchSuggestionWithPrice'];
 export type DomainSortField = components['schemas']['DomainSortField'];
+export type DomainStatisticsBreakdown = components['schemas']['DomainStatisticsBreakdown'];
+export type DomainStatisticsBreakdown2 = components['schemas']['DomainStatisticsBreakdownResponse'];
+export type DomainStatisticsBucket = components['schemas']['DomainStatisticsBucketResponse'];
+export type DomainStatistics = components['schemas']['DomainStatisticsResponse'];
+export type DomainStatisticsTotals = components['schemas']['DomainStatisticsTotalsResponse'];
 export type DomainStatus = components['schemas']['DomainStatus'];
 export type DomainStatus2 = components['schemas']['DomainStatusResponse'];
 export type DomainStatusesBase = components['schemas']['DomainStatusesBase'];

package/src/openapi.yaml

@@ -6163,6 +6163,140 @@ components:
       - transferred_on
       title: DomainSortField
       type: string
+    DomainStatisticsBreakdown:
+      enum:
+      - none
+      - organization
+      - tld
+      title: DomainStatisticsBreakdown
+      type: string
+    DomainStatisticsBreakdownResponse:
+      properties:
+        create:
+          title: Create
+          type: integer
+        key:
+          description: Organization id, or the TLD without the leading dot
+          title: Key
+          type: string
+        label:
+          anyOf:
+          - type: string
+          - type: 'null'
+          description: Organization name; absent for TLD rows
+          title: Label
+        total:
+          title: Total
+          type: integer
+        transfer:
+          title: Transfer
+          type: integer
+      required:
+      - key
+      - label
+      - create
+      - transfer
+      - total
+      title: DomainStatisticsBreakdownResponse
+      type: object
+    DomainStatisticsBucketResponse:
+      properties:
+        create:
+          description: Domains created in this bucket
+          title: Create
+          type: integer
+        partial:
+          description: The bucket reaches outside the requested window, so its counts
+            cover only part of its span and must not be read as a rise or fall against
+            its neighbours
+          title: Partial
+          type: boolean
+        period_start:
+          description: First day of the bucket (UTC)
+          format: date
+          title: Period Start
+          type: string
+        transfer:
+          description: Domains transferred in during this bucket
+          title: Transfer
+          type: integer
+      required:
+      - period_start
+      - create
+      - transfer
+      - partial
+      title: DomainStatisticsBucketResponse
+      type: object
+    DomainStatisticsResponse:
+      properties:
+        breakdown:
+          description: Top organizations or TLDs by acquisitions in the window; empty
+            unless requested
+          items:
+            $ref: '#/components/schemas/DomainStatisticsBreakdownResponse'
+          title: Breakdown
+          type: array
+        buckets:
+          description: One entry per bucket the window touches, oldest first, including
+            empty buckets
+          items:
+            $ref: '#/components/schemas/DomainStatisticsBucketResponse'
+          title: Buckets
+          type: array
+        end_date:
+          description: Last day of the window, inclusive
+          format: date
+          title: End Date
+          type: string
+        granularity:
+          $ref: '#/components/schemas/UsageGranularity'
+          description: Time-bucket size of the series
+        organization_id:
+          description: The organization the counts are scoped to
+          examples:
+          - organization_01h45ytscbebyvny4gc8cr8ma2
+          format: typeid
+          pattern: ^organization_[0-7][0-9a-hjkmnpq-tv-z]{25}$
+          title: Organization Id
+          type: string
+          x-typeid-prefix: organization
+        start_date:
+          description: First day of the window, inclusive
+          format: date
+          title: Start Date
+          type: string
+        totals:
+          $ref: '#/components/schemas/DomainStatisticsTotalsResponse'
+      required:
+      - organization_id
+      - granularity
+      - start_date
+      - end_date
+      - totals
+      - buckets
+      - breakdown
+      title: DomainStatisticsResponse
+      type: object
+    DomainStatisticsTotalsResponse:
+      properties:
+        create:
+          description: Domains created (newly registered) in the window
+          title: Create
+          type: integer
+        total:
+          description: Created plus transferred
+          title: Total
+          type: integer
+        transfer:
+          description: Domains transferred to OpusDNS in the window
+          title: Transfer
+          type: integer
+      required:
+      - create
+      - transfer
+      - total
+      title: DomainStatisticsTotalsResponse
+      type: object
     DomainStatus:
       enum:
       - ok
@@ -16815,7 +16949,7 @@ info:
     \n\n"
   summary: OpusDNS - your gateway to a seamless domain management experience.
   title: OpusDNS API
-  version: 2026-09-14-110602
+  version: 2026-09-14-120239
   x-logo:
     altText: OpusDNS API Reference
     url: https://d24lr4zqs1tgqh.cloudfront.net/c9505a20-5ae1-406c-b060-d392569caebf.jpg
@@ -25405,6 +25539,91 @@ paths:
       - domain
       x-required-permissions:
       - domains:manage
+  /v1/domains/statistics:
+    get:
+      description: 'Counts the domains your organization acquired in a window of whole
+        days, split into creates (new registrations) and inbound transfers and bucketed
+        by the requested granularity.
+
+
+        Counts cover your organization and its sub-organizations, like the domain
+        summary; `breakdown=organization` shows how they divide between them. A create
+        is counted on the day OpusDNS took the order and a transfer on the day it
+        completed, so domains that have since been deleted still appear in the window
+        they were acquired in. Imported domains count as creates on the day they were
+        imported. Domains held at a connected external registrar are not included.
+
+
+        Every bucket the window touches is present, so the series can be charted as
+        is. A bucket marked `partial` reaches outside the window and covers only part
+        of its span.'
+      operationId: get_domain_statistics_v1_domains_statistics_get
+      parameters:
+      - in: query
+        name: start_date
+        required: true
+        schema:
+          format: date
+          title: Start Date
+          type: string
+      - in: query
+        name: end_date
+        required: true
+        schema:
+          format: date
+          title: End Date
+          type: string
+      - in: query
+        name: granularity
+        required: false
+        schema:
+          $ref: '#/components/schemas/UsageGranularity'
+          default: day
+      - in: query
+        name: tld
+        required: false
+        schema:
+          anyOf:
+          - type: string
+          - type: 'null'
+          title: Tld
+      - in: query
+        name: breakdown
+        required: false
+        schema:
+          $ref: '#/components/schemas/DomainStatisticsBreakdown'
+          default: none
+      - in: query
+        name: breakdown_limit
+        required: false
+        schema:
+          default: 10
+          maximum: 50
+          minimum: 1
+          title: Breakdown Limit
+          type: integer
+      - $ref: '#/components/parameters/DatetimeFormatHeader'
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/DomainStatisticsResponse'
+          description: Successful Response
+        '422':
+          content:
+            application/problem+json:
+              schema:
+                $ref: '#/components/schemas/HTTPValidationError'
+          description: Validation Error
+      security:
+      - OAuth2PasswordBearer: []
+      - APIKeyHeader: []
+      summary: Get domain statistics
+      tags:
+      - domain
+      x-required-permissions:
+      - domains:read
   /v1/domains/summary:
     get:
       description: Retrieves a summary of domains including counts by status, TLD,

package/src/schema.d.ts

@@ -1176,6 +1176,30 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/domains/statistics": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get domain statistics
+         * @description Counts the domains your organization acquired in a window of whole days, split into creates (new registrations) and inbound transfers and bucketed by the requested granularity.
+         *
+         *     Counts cover your organization and its sub-organizations, like the domain summary; `breakdown=organization` shows how they divide between them. A create is counted on the day OpusDNS took the order and a transfer on the day it completed, so domains that have since been deleted still appear in the window they were acquired in. Imported domains count as creates on the day they were imported. Domains held at a connected external registrar are not included.
+         *
+         *     Every bucket the window touches is present, so the series can be charted as is. A bucket marked `partial` reaches outside the window and covers only part of its span.
+         */
+        get: operations["get_domain_statistics_v1_domains_statistics_get"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/domains/summary": {
         parameters: {
             query?: never;
@@ -7171,6 +7195,107 @@ export interface components {
          * @enum {string}
          */
         DomainSortField: "name" | "created_on" | "updated_on" | "expires_on" | "registered_on" | "transferred_on";
+        /**
+         * DomainStatisticsBreakdown
+         * @enum {string}
+         */
+        DomainStatisticsBreakdown: "none" | "organization" | "tld";
+        /** DomainStatisticsBreakdownResponse */
+        DomainStatisticsBreakdownResponse: {
+            /** Create */
+            create: number;
+            /**
+             * Key
+             * @description Organization id, or the TLD without the leading dot
+             */
+            key: string;
+            /**
+             * Label
+             * @description Organization name; absent for TLD rows
+             */
+            label: string | null;
+            /** Total */
+            total: number;
+            /** Transfer */
+            transfer: number;
+        };
+        /** DomainStatisticsBucketResponse */
+        DomainStatisticsBucketResponse: {
+            /**
+             * Create
+             * @description Domains created in this bucket
+             */
+            create: number;
+            /**
+             * Partial
+             * @description The bucket reaches outside the requested window, so its counts cover only part of its span and must not be read as a rise or fall against its neighbours
+             */
+            partial: boolean;
+            /**
+             * Period Start
+             * Format: date
+             * @description First day of the bucket (UTC)
+             */
+            period_start: string;
+            /**
+             * Transfer
+             * @description Domains transferred in during this bucket
+             */
+            transfer: number;
+        };
+        /** DomainStatisticsResponse */
+        DomainStatisticsResponse: {
+            /**
+             * Breakdown
+             * @description Top organizations or TLDs by acquisitions in the window; empty unless requested
+             */
+            breakdown: components["schemas"]["DomainStatisticsBreakdownResponse"][];
+            /**
+             * Buckets
+             * @description One entry per bucket the window touches, oldest first, including empty buckets
+             */
+            buckets: components["schemas"]["DomainStatisticsBucketResponse"][];
+            /**
+             * End Date
+             * Format: date
+             * @description Last day of the window, inclusive
+             */
+            end_date: string;
+            /** @description Time-bucket size of the series */
+            granularity: components["schemas"]["UsageGranularity"];
+            /**
+             * Organization Id
+             * Format: typeid
+             * @description The organization the counts are scoped to
+             * @example organization_01h45ytscbebyvny4gc8cr8ma2
+             */
+            organization_id: TypeId<"organization">;
+            /**
+             * Start Date
+             * Format: date
+             * @description First day of the window, inclusive
+             */
+            start_date: string;
+            totals: components["schemas"]["DomainStatisticsTotalsResponse"];
+        };
+        /** DomainStatisticsTotalsResponse */
+        DomainStatisticsTotalsResponse: {
+            /**
+             * Create
+             * @description Domains created (newly registered) in the window
+             */
+            create: number;
+            /**
+             * Total
+             * @description Created plus transferred
+             */
+            total: number;
+            /**
+             * Transfer
+             * @description Domains transferred to OpusDNS in the window
+             */
+            transfer: number;
+        };
         /**
          * DomainStatus
          * @enum {string}
@@ -20657,6 +20782,48 @@ export interface operations {
             };
         };
     };
+    get_domain_statistics_v1_domains_statistics_get: {
+        parameters: {
+            query: {
+                start_date: string;
+                end_date: string;
+                granularity?: components["schemas"]["UsageGranularity"];
+                tld?: string | null;
+                breakdown?: components["schemas"]["DomainStatisticsBreakdown"];
+                breakdown_limit?: number;
+            };
+            header?: {
+                /**
+                 * @description Opt in to RFC 3339 datetime serialization. When set to `rfc3339`, response datetimes are normalized to UTC and serialized with a `Z` suffix. This is opt-in until the announced default cutover date, after which RFC 3339 becomes the default and this header is accepted as a no-op. Any other value or omission uses the current default serialization.
+                 * @example rfc3339
+                 */
+                "X-Datetime-Format"?: components["parameters"]["DatetimeFormatHeader"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DomainStatisticsResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
     get_domain_summary_v1_domains_summary_get: {
         parameters: {
             query?: never;