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

import { APIResource } from '../../../resource';
import { isRequestOptions } from '../../../core';
import * as Core from '../../../core';
import * as BlockDocumentsAPI from './block-documents';
import * as Shared from '../../shared';

export class BlockDocuments extends APIResource {
  /**
   * Read Block Documents For Block Type
   */
  list(
    slug: string,
    params?: BlockDocumentListParams,
    options?: Core.RequestOptions,
  ): Core.APIPromise<BlockDocumentListResponse>;
  list(slug: string, options?: Core.RequestOptions): Core.APIPromise<BlockDocumentListResponse>;
  list(
    slug: string,
    params: BlockDocumentListParams | Core.RequestOptions = {},
    options?: Core.RequestOptions,
  ): Core.APIPromise<BlockDocumentListResponse> {
    if (isRequestOptions(params)) {
      return this.list(slug, {}, params);
    }
    const { 'x-prefect-api-version': xPrefectAPIVersion, ...query } = params;
    return this._client.get(`/api/block_types/slug/${slug}/block_documents`, {
      query,
      ...options,
      headers: {
        ...(xPrefectAPIVersion != null ? { 'x-prefect-api-version': xPrefectAPIVersion } : undefined),
        ...options?.headers,
      },
    });
  }
}

export type BlockDocumentListResponse = Array<Shared.BlockDocument>;

export interface BlockDocumentListParams {
  /**
   * Query param: Whether to include sensitive values in the block document.
   */
  include_secrets?: boolean;

  /**
   * Header param:
   */
  'x-prefect-api-version'?: string;
}

export namespace BlockDocuments {
  export import BlockDocumentListResponse = BlockDocumentsAPI.BlockDocumentListResponse;
  export import BlockDocumentListParams = BlockDocumentsAPI.BlockDocumentListParams;
}