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

import { APIResource } from '../../core/resource';
import { APIPromise } from '../../core/api-promise';
import { RequestOptions } from '../../internal/request-options';
import { path } from '../../internal/utils/path';

/**
 * Report data for company
 */
export class AvailableFilters extends APIResource {
  /**
   * Returns the list of fields that can be used to filter a report run, along with
   * the operators each field supports.
   */
  retrieve(reportID: string, options?: RequestOptions): APIPromise<AvailableFilterRetrieveResponse> {
    return this._client.get(path`/reports/${reportID}/available-filters/`, options);
  }
}

/**
 * Response for GET /reports/{report_id}/available-filters
 */
export interface AvailableFilterRetrieveResponse {
  /**
   * List of filterable fields with their supported operators
   */
  data: Array<AvailableFilterRetrieveResponse.Data>;
}

export namespace AvailableFilterRetrieveResponse {
  /**
   * Describes a field the client can filter on when running a report
   */
  export interface Data {
    /**
     * Stable field identifier used when applying filters
     */
    field_id: string;

    /**
     * Human-readable display name of the field
     */
    field_name: string;

    /**
     * Operators supported by this field
     */
    operators: Array<string>;

    /**
     * Data type of a filterable field
     */
    type: 'string' | 'number' | 'date' | 'datetime' | 'enum' | 'boolean';
  }
}

export declare namespace AvailableFilters {
  export { type AvailableFilterRetrieveResponse as AvailableFilterRetrieveResponse };
}