// File generated from our OpenAPI spec by Castiron. 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';

export class Alerts extends APIResource {
  /**
   * Get a safety alert belonging to the authenticated API project.
   */
  retrieve(id: string, options?: RequestOptions): APIPromise<SafetyAlert> {
    return this._client.get(path`/safety/alerts/${id}`, { ...options, __security: { bearerAuth: true } });
  }
}

export interface SafetyAlert {
  id: string;

  created_at: number;

  error_type:
    | 'potentially_unintended_data_transfer'
    | 'potentially_unintended_data_access'
    | 'potentially_unintended_destructive_activity'
    | 'other';

  model: string;

  object: 'safety.alert';

  /**
   * A customer-safe description derived from error_type, or null for zero data
   * retention requests.
   */
  reason: string | null;

  request_id: string;

  /**
   * Whether block registration succeeded for this request. This does not confirm
   * that response execution stopped.
   */
  request_paused: boolean;

  response_id: string;
}

export declare namespace Alerts {
  export { type SafetyAlert as SafetyAlert };
}