// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.

import { APIResource } from '../../../resource';
import * as Core from '../../../core';
import * as QuotaAPI from './quota';
import { Quota, QuotaGetParams, QuotaGetResponse } from './quota';
import { V4PagePaginationArray, type V4PagePaginationArrayParams } from '../../../pagination';

export class CertificatePacks extends APIResource {
  quota: QuotaAPI.Quota = new QuotaAPI.Quota(this._client);

  /**
   * For a given zone, order an advanced certificate pack.
   *
   * @example
   * ```ts
   * const certificatePack =
   *   await client.ssl.certificatePacks.create({
   *     zone_id: '023e105f4ecef8ad9ca31a8372d0c353',
   *     certificate_authority: 'lets_encrypt',
   *     hosts: [
   *       'example.com',
   *       '*.example.com',
   *       'www.example.com',
   *     ],
   *     type: 'advanced',
   *     validation_method: 'txt',
   *     validity_days: 14,
   *   });
   * ```
   */
  create(
    params: CertificatePackCreateParams,
    options?: Core.RequestOptions,
  ): Core.APIPromise<CertificatePackCreateResponse> {
    const { zone_id, ...body } = params;
    return (
      this._client.post(`/zones/${zone_id}/ssl/certificate_packs/order`, {
        body,
        ...options,
      }) as Core.APIPromise<{ result: CertificatePackCreateResponse }>
    )._thenUnwrap((obj) => obj.result);
  }

  /**
   * For a given zone, list all active certificate packs.
   *
   * @example
   * ```ts
   * // Automatically fetches more pages as needed.
   * for await (const certificatePackListResponse of client.ssl.certificatePacks.list(
   *   { zone_id: '023e105f4ecef8ad9ca31a8372d0c353' },
   * )) {
   *   // ...
   * }
   * ```
   */
  list(
    params: CertificatePackListParams,
    options?: Core.RequestOptions,
  ): Core.PagePromise<CertificatePackListResponsesV4PagePaginationArray, CertificatePackListResponse> {
    const { zone_id, ...query } = params;
    return this._client.getAPIList(
      `/zones/${zone_id}/ssl/certificate_packs`,
      CertificatePackListResponsesV4PagePaginationArray,
      { query, ...options },
    );
  }

  /**
   * For a given zone, delete an advanced certificate pack.
   *
   * @example
   * ```ts
   * const certificatePack =
   *   await client.ssl.certificatePacks.delete(
   *     '023e105f4ecef8ad9ca31a8372d0c353',
   *     { zone_id: '023e105f4ecef8ad9ca31a8372d0c353' },
   *   );
   * ```
   */
  delete(
    certificatePackId: string,
    params: CertificatePackDeleteParams,
    options?: Core.RequestOptions,
  ): Core.APIPromise<CertificatePackDeleteResponse> {
    const { zone_id } = params;
    return (
      this._client.delete(
        `/zones/${zone_id}/ssl/certificate_packs/${certificatePackId}`,
        options,
      ) as Core.APIPromise<{ result: CertificatePackDeleteResponse }>
    )._thenUnwrap((obj) => obj.result);
  }

  /**
   * For a given zone, restart validation or add cloudflare branding for an advanced
   * certificate pack. The former is only a validation operation for a Certificate
   * Pack in a validation_timed_out status.
   *
   * @example
   * ```ts
   * const response = await client.ssl.certificatePacks.edit(
   *   '023e105f4ecef8ad9ca31a8372d0c353',
   *   { zone_id: '023e105f4ecef8ad9ca31a8372d0c353' },
   * );
   * ```
   */
  edit(
    certificatePackId: string,
    params: CertificatePackEditParams,
    options?: Core.RequestOptions,
  ): Core.APIPromise<CertificatePackEditResponse> {
    const { zone_id, ...body } = params;
    return (
      this._client.patch(`/zones/${zone_id}/ssl/certificate_packs/${certificatePackId}`, {
        body,
        ...options,
      }) as Core.APIPromise<{ result: CertificatePackEditResponse }>
    )._thenUnwrap((obj) => obj.result);
  }

  /**
   * For a given zone, get a certificate pack.
   *
   * @example
   * ```ts
   * const certificatePack =
   *   await client.ssl.certificatePacks.get(
   *     '023e105f4ecef8ad9ca31a8372d0c353',
   *     { zone_id: '023e105f4ecef8ad9ca31a8372d0c353' },
   *   );
   * ```
   */
  get(
    certificatePackId: string,
    params: CertificatePackGetParams,
    options?: Core.RequestOptions,
  ): Core.APIPromise<CertificatePackGetResponse> {
    const { zone_id } = params;
    return (
      this._client.get(
        `/zones/${zone_id}/ssl/certificate_packs/${certificatePackId}`,
        options,
      ) as Core.APIPromise<{ result: CertificatePackGetResponse }>
    )._thenUnwrap((obj) => obj.result);
  }
}

export class CertificatePackListResponsesV4PagePaginationArray extends V4PagePaginationArray<CertificatePackListResponse> {}

export type Host = string;

export type HostParam = string;

/**
 * The number of days for which the certificate should be valid.
 */
export type RequestValidity = 7 | 30 | 90 | 365 | 730 | 1095 | 5475;

/**
 * The number of days for which the certificate should be valid.
 */
export type RequestValidityParam = 7 | 30 | 90 | 365 | 730 | 1095 | 5475;

/**
 * Status of certificate pack.
 */
export type Status =
  | 'initializing'
  | 'pending_validation'
  | 'deleted'
  | 'pending_issuance'
  | 'pending_deployment'
  | 'pending_deletion'
  | 'pending_expiration'
  | 'expired'
  | 'active'
  | 'initializing_timed_out'
  | 'validation_timed_out'
  | 'issuance_timed_out'
  | 'deployment_timed_out'
  | 'deletion_timed_out'
  | 'pending_cleanup'
  | 'staging_deployment'
  | 'staging_active'
  | 'deactivating'
  | 'inactive'
  | 'backup_issued'
  | 'holding_deployment';

/**
 * Validation method in use for a certificate pack order.
 */
export type ValidationMethod = 'http' | 'cname' | 'txt';

/**
 * A certificate pack with all its properties.
 */
export interface CertificatePackCreateResponse {
  /**
   * Identifier.
   */
  id: string;

  /**
   * Array of certificates in this pack.
   */
  certificates: Array<CertificatePackCreateResponse.Certificate>;

  /**
   * Comma separated list of valid host names for the certificate packs. Must contain
   * the zone apex, may not contain more than 50 hosts, and may not be empty.
   */
  hosts: Array<Host>;

  /**
   * Status of certificate pack.
   */
  status: Status;

  /**
   * Type of certificate pack.
   */
  type:
    | 'mh_custom'
    | 'managed_hostname'
    | 'sni_custom'
    | 'universal'
    | 'advanced'
    | 'total_tls'
    | 'keyless'
    | 'legacy_custom';

  /**
   * Certificate Authority selected for the order. For information on any certificate
   * authority specific details or restrictions
   * [see this page for more details.](https://developers.cloudflare.com/ssl/reference/certificate-authorities)
   */
  certificate_authority?: 'google' | 'lets_encrypt' | 'ssl_com';

  /**
   * Whether or not to add Cloudflare Branding for the order. This will add a
   * subdomain of sni.cloudflaressl.com as the Common Name if set to true.
   */
  cloudflare_branding?: boolean;

  /**
   * DCV Delegation records for domain validation.
   */
  dcv_delegation_records?: Array<CertificatePackCreateResponse.DCVDelegationRecord>;

  /**
   * Identifier of the primary certificate in a pack.
   */
  primary_certificate?: string;

  /**
   * Domain validation errors that have been received by the certificate authority
   * (CA).
   */
  validation_errors?: Array<CertificatePackCreateResponse.ValidationError>;

  /**
   * Validation Method selected for the order.
   */
  validation_method?: 'txt' | 'http' | 'email';

  /**
   * Certificates' validation records.
   */
  validation_records?: Array<CertificatePackCreateResponse.ValidationRecord>;

  /**
   * Validity Days selected for the order.
   */
  validity_days?: 14 | 30 | 90 | 365;
}

export namespace CertificatePackCreateResponse {
  /**
   * An individual certificate within a certificate pack.
   */
  export interface Certificate {
    /**
     * Certificate identifier.
     */
    id: string;

    /**
     * Hostnames covered by this certificate.
     */
    hosts: Array<string>;

    /**
     * Certificate status.
     */
    status: string;

    /**
     * Certificate bundle method.
     */
    bundle_method?: string;

    /**
     * When the certificate from the authority expires.
     */
    expires_on?: string;

    /**
     * Specify the region where your private key can be held locally.
     */
    geo_restrictions?: Certificate.GeoRestrictions;

    /**
     * The certificate authority that issued the certificate.
     */
    issuer?: string;

    /**
     * When the certificate was last modified.
     */
    modified_on?: string;

    /**
     * The order/priority in which the certificate will be used.
     */
    priority?: number;

    /**
     * The type of hash used for the certificate.
     */
    signature?: string;

    /**
     * When the certificate was uploaded to Cloudflare.
     */
    uploaded_on?: string;

    /**
     * Identifier.
     */
    zone_id?: string;
  }

  export namespace Certificate {
    /**
     * Specify the region where your private key can be held locally.
     */
    export interface GeoRestrictions {
      label?: 'us' | 'eu' | 'highest_security';
    }
  }

  /**
   * Certificate's required validation record.
   */
  export interface DCVDelegationRecord {
    /**
     * The CNAME record hostname for DCV delegation.
     */
    cname?: string;

    /**
     * The CNAME record target value for DCV delegation.
     */
    cname_target?: string;

    /**
     * The set of email addresses that the certificate authority (CA) will use to
     * complete domain validation.
     */
    emails?: Array<string>;

    /**
     * The content that the certificate authority (CA) will expect to find at the
     * http_url during the domain validation.
     */
    http_body?: string;

    /**
     * The url that will be checked during domain validation.
     */
    http_url?: string;

    /**
     * Status of the validation record.
     */
    status?: string;

    /**
     * The hostname that the certificate authority (CA) will check for a TXT record
     * during domain validation .
     */
    txt_name?: string;

    /**
     * The TXT record that the certificate authority (CA) will check during domain
     * validation.
     */
    txt_value?: string;
  }

  export interface ValidationError {
    /**
     * A domain validation error.
     */
    message?: string;
  }

  /**
   * Certificate's required validation record.
   */
  export interface ValidationRecord {
    /**
     * The CNAME record hostname for DCV delegation.
     */
    cname?: string;

    /**
     * The CNAME record target value for DCV delegation.
     */
    cname_target?: string;

    /**
     * The set of email addresses that the certificate authority (CA) will use to
     * complete domain validation.
     */
    emails?: Array<string>;

    /**
     * The content that the certificate authority (CA) will expect to find at the
     * http_url during the domain validation.
     */
    http_body?: string;

    /**
     * The url that will be checked during domain validation.
     */
    http_url?: string;

    /**
     * Status of the validation record.
     */
    status?: string;

    /**
     * The hostname that the certificate authority (CA) will check for a TXT record
     * during domain validation .
     */
    txt_name?: string;

    /**
     * The TXT record that the certificate authority (CA) will check during domain
     * validation.
     */
    txt_value?: string;
  }
}

/**
 * A certificate pack with all its properties.
 */
export interface CertificatePackListResponse {
  /**
   * Identifier.
   */
  id: string;

  /**
   * Array of certificates in this pack.
   */
  certificates: Array<CertificatePackListResponse.Certificate>;

  /**
   * Comma separated list of valid host names for the certificate packs. Must contain
   * the zone apex, may not contain more than 50 hosts, and may not be empty.
   */
  hosts: Array<Host>;

  /**
   * Status of certificate pack.
   */
  status: Status;

  /**
   * Type of certificate pack.
   */
  type:
    | 'mh_custom'
    | 'managed_hostname'
    | 'sni_custom'
    | 'universal'
    | 'advanced'
    | 'total_tls'
    | 'keyless'
    | 'legacy_custom';

  /**
   * Certificate Authority selected for the order. For information on any certificate
   * authority specific details or restrictions
   * [see this page for more details.](https://developers.cloudflare.com/ssl/reference/certificate-authorities)
   */
  certificate_authority?: 'google' | 'lets_encrypt' | 'ssl_com';

  /**
   * Whether or not to add Cloudflare Branding for the order. This will add a
   * subdomain of sni.cloudflaressl.com as the Common Name if set to true.
   */
  cloudflare_branding?: boolean;

  /**
   * DCV Delegation records for domain validation.
   */
  dcv_delegation_records?: Array<CertificatePackListResponse.DCVDelegationRecord>;

  /**
   * Identifier of the primary certificate in a pack.
   */
  primary_certificate?: string;

  /**
   * Domain validation errors that have been received by the certificate authority
   * (CA).
   */
  validation_errors?: Array<CertificatePackListResponse.ValidationError>;

  /**
   * Validation Method selected for the order.
   */
  validation_method?: 'txt' | 'http' | 'email';

  /**
   * Certificates' validation records.
   */
  validation_records?: Array<CertificatePackListResponse.ValidationRecord>;

  /**
   * Validity Days selected for the order.
   */
  validity_days?: 14 | 30 | 90 | 365;
}

export namespace CertificatePackListResponse {
  /**
   * An individual certificate within a certificate pack.
   */
  export interface Certificate {
    /**
     * Certificate identifier.
     */
    id: string;

    /**
     * Hostnames covered by this certificate.
     */
    hosts: Array<string>;

    /**
     * Certificate status.
     */
    status: string;

    /**
     * Certificate bundle method.
     */
    bundle_method?: string;

    /**
     * When the certificate from the authority expires.
     */
    expires_on?: string;

    /**
     * Specify the region where your private key can be held locally.
     */
    geo_restrictions?: Certificate.GeoRestrictions;

    /**
     * The certificate authority that issued the certificate.
     */
    issuer?: string;

    /**
     * When the certificate was last modified.
     */
    modified_on?: string;

    /**
     * The order/priority in which the certificate will be used.
     */
    priority?: number;

    /**
     * The type of hash used for the certificate.
     */
    signature?: string;

    /**
     * When the certificate was uploaded to Cloudflare.
     */
    uploaded_on?: string;

    /**
     * Identifier.
     */
    zone_id?: string;
  }

  export namespace Certificate {
    /**
     * Specify the region where your private key can be held locally.
     */
    export interface GeoRestrictions {
      label?: 'us' | 'eu' | 'highest_security';
    }
  }

  /**
   * Certificate's required validation record.
   */
  export interface DCVDelegationRecord {
    /**
     * The CNAME record hostname for DCV delegation.
     */
    cname?: string;

    /**
     * The CNAME record target value for DCV delegation.
     */
    cname_target?: string;

    /**
     * The set of email addresses that the certificate authority (CA) will use to
     * complete domain validation.
     */
    emails?: Array<string>;

    /**
     * The content that the certificate authority (CA) will expect to find at the
     * http_url during the domain validation.
     */
    http_body?: string;

    /**
     * The url that will be checked during domain validation.
     */
    http_url?: string;

    /**
     * Status of the validation record.
     */
    status?: string;

    /**
     * The hostname that the certificate authority (CA) will check for a TXT record
     * during domain validation .
     */
    txt_name?: string;

    /**
     * The TXT record that the certificate authority (CA) will check during domain
     * validation.
     */
    txt_value?: string;
  }

  export interface ValidationError {
    /**
     * A domain validation error.
     */
    message?: string;
  }

  /**
   * Certificate's required validation record.
   */
  export interface ValidationRecord {
    /**
     * The CNAME record hostname for DCV delegation.
     */
    cname?: string;

    /**
     * The CNAME record target value for DCV delegation.
     */
    cname_target?: string;

    /**
     * The set of email addresses that the certificate authority (CA) will use to
     * complete domain validation.
     */
    emails?: Array<string>;

    /**
     * The content that the certificate authority (CA) will expect to find at the
     * http_url during the domain validation.
     */
    http_body?: string;

    /**
     * The url that will be checked during domain validation.
     */
    http_url?: string;

    /**
     * Status of the validation record.
     */
    status?: string;

    /**
     * The hostname that the certificate authority (CA) will check for a TXT record
     * during domain validation .
     */
    txt_name?: string;

    /**
     * The TXT record that the certificate authority (CA) will check during domain
     * validation.
     */
    txt_value?: string;
  }
}

export interface CertificatePackDeleteResponse {
  /**
   * Identifier.
   */
  id?: string;
}

/**
 * A certificate pack with all its properties.
 */
export interface CertificatePackEditResponse {
  /**
   * Identifier.
   */
  id: string;

  /**
   * Array of certificates in this pack.
   */
  certificates: Array<CertificatePackEditResponse.Certificate>;

  /**
   * Comma separated list of valid host names for the certificate packs. Must contain
   * the zone apex, may not contain more than 50 hosts, and may not be empty.
   */
  hosts: Array<Host>;

  /**
   * Status of certificate pack.
   */
  status: Status;

  /**
   * Type of certificate pack.
   */
  type:
    | 'mh_custom'
    | 'managed_hostname'
    | 'sni_custom'
    | 'universal'
    | 'advanced'
    | 'total_tls'
    | 'keyless'
    | 'legacy_custom';

  /**
   * Certificate Authority selected for the order. For information on any certificate
   * authority specific details or restrictions
   * [see this page for more details.](https://developers.cloudflare.com/ssl/reference/certificate-authorities)
   */
  certificate_authority?: 'google' | 'lets_encrypt' | 'ssl_com';

  /**
   * Whether or not to add Cloudflare Branding for the order. This will add a
   * subdomain of sni.cloudflaressl.com as the Common Name if set to true.
   */
  cloudflare_branding?: boolean;

  /**
   * DCV Delegation records for domain validation.
   */
  dcv_delegation_records?: Array<CertificatePackEditResponse.DCVDelegationRecord>;

  /**
   * Identifier of the primary certificate in a pack.
   */
  primary_certificate?: string;

  /**
   * Domain validation errors that have been received by the certificate authority
   * (CA).
   */
  validation_errors?: Array<CertificatePackEditResponse.ValidationError>;

  /**
   * Validation Method selected for the order.
   */
  validation_method?: 'txt' | 'http' | 'email';

  /**
   * Certificates' validation records.
   */
  validation_records?: Array<CertificatePackEditResponse.ValidationRecord>;

  /**
   * Validity Days selected for the order.
   */
  validity_days?: 14 | 30 | 90 | 365;
}

export namespace CertificatePackEditResponse {
  /**
   * An individual certificate within a certificate pack.
   */
  export interface Certificate {
    /**
     * Certificate identifier.
     */
    id: string;

    /**
     * Hostnames covered by this certificate.
     */
    hosts: Array<string>;

    /**
     * Certificate status.
     */
    status: string;

    /**
     * Certificate bundle method.
     */
    bundle_method?: string;

    /**
     * When the certificate from the authority expires.
     */
    expires_on?: string;

    /**
     * Specify the region where your private key can be held locally.
     */
    geo_restrictions?: Certificate.GeoRestrictions;

    /**
     * The certificate authority that issued the certificate.
     */
    issuer?: string;

    /**
     * When the certificate was last modified.
     */
    modified_on?: string;

    /**
     * The order/priority in which the certificate will be used.
     */
    priority?: number;

    /**
     * The type of hash used for the certificate.
     */
    signature?: string;

    /**
     * When the certificate was uploaded to Cloudflare.
     */
    uploaded_on?: string;

    /**
     * Identifier.
     */
    zone_id?: string;
  }

  export namespace Certificate {
    /**
     * Specify the region where your private key can be held locally.
     */
    export interface GeoRestrictions {
      label?: 'us' | 'eu' | 'highest_security';
    }
  }

  /**
   * Certificate's required validation record.
   */
  export interface DCVDelegationRecord {
    /**
     * The CNAME record hostname for DCV delegation.
     */
    cname?: string;

    /**
     * The CNAME record target value for DCV delegation.
     */
    cname_target?: string;

    /**
     * The set of email addresses that the certificate authority (CA) will use to
     * complete domain validation.
     */
    emails?: Array<string>;

    /**
     * The content that the certificate authority (CA) will expect to find at the
     * http_url during the domain validation.
     */
    http_body?: string;

    /**
     * The url that will be checked during domain validation.
     */
    http_url?: string;

    /**
     * Status of the validation record.
     */
    status?: string;

    /**
     * The hostname that the certificate authority (CA) will check for a TXT record
     * during domain validation .
     */
    txt_name?: string;

    /**
     * The TXT record that the certificate authority (CA) will check during domain
     * validation.
     */
    txt_value?: string;
  }

  export interface ValidationError {
    /**
     * A domain validation error.
     */
    message?: string;
  }

  /**
   * Certificate's required validation record.
   */
  export interface ValidationRecord {
    /**
     * The CNAME record hostname for DCV delegation.
     */
    cname?: string;

    /**
     * The CNAME record target value for DCV delegation.
     */
    cname_target?: string;

    /**
     * The set of email addresses that the certificate authority (CA) will use to
     * complete domain validation.
     */
    emails?: Array<string>;

    /**
     * The content that the certificate authority (CA) will expect to find at the
     * http_url during the domain validation.
     */
    http_body?: string;

    /**
     * The url that will be checked during domain validation.
     */
    http_url?: string;

    /**
     * Status of the validation record.
     */
    status?: string;

    /**
     * The hostname that the certificate authority (CA) will check for a TXT record
     * during domain validation .
     */
    txt_name?: string;

    /**
     * The TXT record that the certificate authority (CA) will check during domain
     * validation.
     */
    txt_value?: string;
  }
}

/**
 * A certificate pack with all its properties.
 */
export interface CertificatePackGetResponse {
  /**
   * Identifier.
   */
  id: string;

  /**
   * Array of certificates in this pack.
   */
  certificates: Array<CertificatePackGetResponse.Certificate>;

  /**
   * Comma separated list of valid host names for the certificate packs. Must contain
   * the zone apex, may not contain more than 50 hosts, and may not be empty.
   */
  hosts: Array<Host>;

  /**
   * Status of certificate pack.
   */
  status: Status;

  /**
   * Type of certificate pack.
   */
  type:
    | 'mh_custom'
    | 'managed_hostname'
    | 'sni_custom'
    | 'universal'
    | 'advanced'
    | 'total_tls'
    | 'keyless'
    | 'legacy_custom';

  /**
   * Certificate Authority selected for the order. For information on any certificate
   * authority specific details or restrictions
   * [see this page for more details.](https://developers.cloudflare.com/ssl/reference/certificate-authorities)
   */
  certificate_authority?: 'google' | 'lets_encrypt' | 'ssl_com';

  /**
   * Whether or not to add Cloudflare Branding for the order. This will add a
   * subdomain of sni.cloudflaressl.com as the Common Name if set to true.
   */
  cloudflare_branding?: boolean;

  /**
   * DCV Delegation records for domain validation.
   */
  dcv_delegation_records?: Array<CertificatePackGetResponse.DCVDelegationRecord>;

  /**
   * Identifier of the primary certificate in a pack.
   */
  primary_certificate?: string;

  /**
   * Domain validation errors that have been received by the certificate authority
   * (CA).
   */
  validation_errors?: Array<CertificatePackGetResponse.ValidationError>;

  /**
   * Validation Method selected for the order.
   */
  validation_method?: 'txt' | 'http' | 'email';

  /**
   * Certificates' validation records.
   */
  validation_records?: Array<CertificatePackGetResponse.ValidationRecord>;

  /**
   * Validity Days selected for the order.
   */
  validity_days?: 14 | 30 | 90 | 365;
}

export namespace CertificatePackGetResponse {
  /**
   * An individual certificate within a certificate pack.
   */
  export interface Certificate {
    /**
     * Certificate identifier.
     */
    id: string;

    /**
     * Hostnames covered by this certificate.
     */
    hosts: Array<string>;

    /**
     * Certificate status.
     */
    status: string;

    /**
     * Certificate bundle method.
     */
    bundle_method?: string;

    /**
     * When the certificate from the authority expires.
     */
    expires_on?: string;

    /**
     * Specify the region where your private key can be held locally.
     */
    geo_restrictions?: Certificate.GeoRestrictions;

    /**
     * The certificate authority that issued the certificate.
     */
    issuer?: string;

    /**
     * When the certificate was last modified.
     */
    modified_on?: string;

    /**
     * The order/priority in which the certificate will be used.
     */
    priority?: number;

    /**
     * The type of hash used for the certificate.
     */
    signature?: string;

    /**
     * When the certificate was uploaded to Cloudflare.
     */
    uploaded_on?: string;

    /**
     * Identifier.
     */
    zone_id?: string;
  }

  export namespace Certificate {
    /**
     * Specify the region where your private key can be held locally.
     */
    export interface GeoRestrictions {
      label?: 'us' | 'eu' | 'highest_security';
    }
  }

  /**
   * Certificate's required validation record.
   */
  export interface DCVDelegationRecord {
    /**
     * The CNAME record hostname for DCV delegation.
     */
    cname?: string;

    /**
     * The CNAME record target value for DCV delegation.
     */
    cname_target?: string;

    /**
     * The set of email addresses that the certificate authority (CA) will use to
     * complete domain validation.
     */
    emails?: Array<string>;

    /**
     * The content that the certificate authority (CA) will expect to find at the
     * http_url during the domain validation.
     */
    http_body?: string;

    /**
     * The url that will be checked during domain validation.
     */
    http_url?: string;

    /**
     * Status of the validation record.
     */
    status?: string;

    /**
     * The hostname that the certificate authority (CA) will check for a TXT record
     * during domain validation .
     */
    txt_name?: string;

    /**
     * The TXT record that the certificate authority (CA) will check during domain
     * validation.
     */
    txt_value?: string;
  }

  export interface ValidationError {
    /**
     * A domain validation error.
     */
    message?: string;
  }

  /**
   * Certificate's required validation record.
   */
  export interface ValidationRecord {
    /**
     * The CNAME record hostname for DCV delegation.
     */
    cname?: string;

    /**
     * The CNAME record target value for DCV delegation.
     */
    cname_target?: string;

    /**
     * The set of email addresses that the certificate authority (CA) will use to
     * complete domain validation.
     */
    emails?: Array<string>;

    /**
     * The content that the certificate authority (CA) will expect to find at the
     * http_url during the domain validation.
     */
    http_body?: string;

    /**
     * The url that will be checked during domain validation.
     */
    http_url?: string;

    /**
     * Status of the validation record.
     */
    status?: string;

    /**
     * The hostname that the certificate authority (CA) will check for a TXT record
     * during domain validation .
     */
    txt_name?: string;

    /**
     * The TXT record that the certificate authority (CA) will check during domain
     * validation.
     */
    txt_value?: string;
  }
}

export interface CertificatePackCreateParams {
  /**
   * Path param: Identifier.
   */
  zone_id: string;

  /**
   * Body param: Certificate Authority selected for the order. For information on any
   * certificate authority specific details or restrictions
   * [see this page for more details.](https://developers.cloudflare.com/ssl/reference/certificate-authorities)
   */
  certificate_authority: 'google' | 'lets_encrypt' | 'ssl_com';

  /**
   * Body param: Comma separated list of valid host names for the certificate packs.
   * Must contain the zone apex, may not contain more than 50 hosts, and may not be
   * empty.
   */
  hosts: Array<HostParam>;

  /**
   * Body param: Type of certificate pack.
   */
  type: 'advanced';

  /**
   * Body param: Validation Method selected for the order.
   */
  validation_method: 'txt' | 'http' | 'email';

  /**
   * Body param: Validity Days selected for the order.
   */
  validity_days: 14 | 30 | 90 | 365;

  /**
   * Body param: Whether or not to add Cloudflare Branding for the order. This will
   * add a subdomain of sni.cloudflaressl.com as the Common Name if set to true.
   */
  cloudflare_branding?: boolean;
}

export interface CertificatePackListParams extends V4PagePaginationArrayParams {
  /**
   * Path param: Identifier.
   */
  zone_id: string;

  /**
   * Query param: Specify the deployment environment for the certificate packs.
   */
  deploy?: 'staging' | 'production';

  /**
   * Query param: Include Certificate Packs of all statuses, not just active ones.
   */
  status?: 'all';
}

export interface CertificatePackDeleteParams {
  /**
   * Identifier.
   */
  zone_id: string;
}

export interface CertificatePackEditParams {
  /**
   * Path param: Identifier.
   */
  zone_id: string;

  /**
   * Body param: Whether or not to add Cloudflare Branding for the order. This will
   * add a subdomain of sni.cloudflaressl.com as the Common Name if set to true.
   */
  cloudflare_branding?: boolean;
}

export interface CertificatePackGetParams {
  /**
   * Identifier.
   */
  zone_id: string;
}

CertificatePacks.CertificatePackListResponsesV4PagePaginationArray =
  CertificatePackListResponsesV4PagePaginationArray;
CertificatePacks.Quota = Quota;

export declare namespace CertificatePacks {
  export {
    type Host as Host,
    type RequestValidity as RequestValidity,
    type Status as Status,
    type ValidationMethod as ValidationMethod,
    type CertificatePackCreateResponse as CertificatePackCreateResponse,
    type CertificatePackListResponse as CertificatePackListResponse,
    type CertificatePackDeleteResponse as CertificatePackDeleteResponse,
    type CertificatePackEditResponse as CertificatePackEditResponse,
    type CertificatePackGetResponse as CertificatePackGetResponse,
    CertificatePackListResponsesV4PagePaginationArray as CertificatePackListResponsesV4PagePaginationArray,
    type CertificatePackCreateParams as CertificatePackCreateParams,
    type CertificatePackListParams as CertificatePackListParams,
    type CertificatePackDeleteParams as CertificatePackDeleteParams,
    type CertificatePackEditParams as CertificatePackEditParams,
    type CertificatePackGetParams as CertificatePackGetParams,
  };

  export { Quota as Quota, type QuotaGetResponse as QuotaGetResponse, type QuotaGetParams as QuotaGetParams };
}