/**
 * Type declarations for @checkr/web-sdk.
 *
 * The SDK is a thin loader: embed prop contracts are defined by the zoid
 * `embedProps` definitions in web-sdk-services (src/<embed>/embed.{js,ts}).
 * If you add or change a prop there, update these declarations in the same
 * change — the compiler cannot catch drift across the two repos.
 *
 * Each prop interface carries an index-signature escape hatch so that props
 * added server-side before these declarations catch up do not break
 * consumers' builds.
 */

export type CheckrEnv =
  | 'production'
  | 'staging'
  | 'sandbox'
  | 'local'
  | (string & {})

export interface ModalParams {
  /** CSS width of the modal content, e.g. '600px'. Default: '600px'. */
  width?: string
}

/** Work location shape used by the NewInvitation embed. */
export interface WorkLocation {
  country?: string
  state?: string
  city?: string
  [key: string]: unknown
}

/**
 * Payload shapes below are transcribed from Checkr API responses observed in
 * web-sdk-services (api/*.js, fakeData/*). Known fields are optional and an
 * index signature admits fields the API adds — narrow before relying on them.
 */

/** An account hierarchy node (GET /nodes). */
export interface CheckrNode {
  custom_id?: string
  name?: string
  /** Package slugs orderable on this node. */
  packages?: string[]
  parent_custom_id?: string | null
  tier?: string
  [key: string]: unknown
}

/** A screening within a package. */
export interface CheckrScreening {
  type?: string
  subtype?: string | null
  [key: string]: unknown
}

/** A background check package (GET /packages). */
export interface CheckrPackage {
  id?: string
  object?: string
  name?: string
  slug?: string
  /** Price in cents. */
  price?: number | null
  drug_screening_price?: number | null
  screenings?: CheckrScreening[]
  apply_url?: string
  uri?: string
  created_at?: string
  deleted_at?: string | null
  requires_observed_drug_test?: boolean
  enabled_exams?: unknown[]
  [key: string]: unknown
}

/** A selectable work-location country. */
export interface CheckrCountry {
  /** ISO 3166-1 alpha-2 code, e.g. 'US'. */
  code?: string
  name?: string
  [key: string]: unknown
}

/** The background check created by the NewInvitation embed (POST /background_checks). */
export interface CheckrBackgroundCheck {
  id?: string | number
  candidate_id?: string
  candidate_url?: string
  created_at?: string
  custom_external_status?: {
    code?: string
    message?: string
    [key: string]: unknown
  }
  external_background_check_id?: string | null
  external_candidate_id?: string | null
  external_job_application_id?: string | null
  external_requester_id?: string | null
  external_system?: string
  invitation?: {
    id?: string | number
    created_at?: string
    expires_at?: string | null
    deleted_at?: string | null
    [key: string]: unknown
  }
  package?: {
    id?: string | number
    name?: string
    slug?: string
    [key: string]: unknown
  }
  report?: {
    id?: string
    created_at?: string
    completed_at?: string | null
    estimated_completion_time?: number
    [key: string]: unknown
  }
  report_url?: string
  uri?: string
  metadata?: Record<string, unknown>
  [key: string]: unknown
}

/** Props shared by every embed. */
export interface BaseEmbedProps {
  /** Checkr environment to load embed definitions from. */
  env?: CheckrEnv
  /** Nonce applied to injected <style> elements for CSP compatibility. */
  cspNonce?: string
  /** Enable verbose logging inside the embed. */
  enableLogging?: boolean
  /** Render the embed with fake data (no real API calls). */
  fakeMode?: boolean
  /** Style overrides passed through to the embed. */
  styles?: Record<string, unknown>
  [key: string]: unknown
}

/** Props for embeds that authenticate with a session token. */
export interface SessionTokenProps {
  /** Backend path POSTed to for a Checkr session token. Required. */
  sessionTokenPath: string
  /** Extra headers merged into the session-token request. */
  sessionTokenRequestHeaders?: () => Record<string, string>
}

export interface DisclosureConsentProps
  extends BaseEmbedProps,
    SessionTokenProps {
  accountName?: string
  candidateFullName?: string
  candidateId?: string
  packageSlug?: string
  language?: string
  driverLicenseState?: string
  nodeId?: string
  workLocationCity?: string
  workLocationCountry?: string
  workLocationState?: string
  zipCode?: string
  /** i18n key or text overrides */
  embedTitle?: string
  nextButtonLabel?: string
  previousButtonLabel?: string
  submitButtonLabel?: string
  clientSideErrorMessage?: string
  serverSideErrorMessage?: string
  consentSubmitSuccessMessage?: string
  /** Called with the error message when the disclosure fails to load. */
  onLoadDisclosureError?: (message: string) => void
  /** Called with the error message when consent submission fails. */
  onConsentSubmitError?: (message: string) => void
  /**
   * Called on successful consent submission. Receives the confirmation
   * message 'Candidate consent is recorded.' (the API response body is not
   * forwarded).
   */
  onConsentSubmitSuccess?: (message: string) => void
}

export interface NewInvitationProps extends BaseEmbedProps, SessionTokenProps {
  defaultEmail?: string
  defaultPhone?: string
  defaultWorkLocation?: WorkLocation
  presetEmail?: string
  presetPhone?: string
  presetNodeCustomId?: string
  presetPackageSlug?: string
  presetWorkLocation?: WorkLocation
  externalBackgroundCheckId?: string
  externalCandidateId?: string
  externalSystem?: string
  fakeScenario?: string
  hideBackButton?: boolean
  /** Filter the selectable account nodes. May be async. */
  nodeFilter?: (
    nodes: CheckrNode[],
  ) => CheckrNode[] | Promise<CheckrNode[]>
  /** Filter the selectable packages. May be async. */
  packageFilter?: (
    packages: CheckrPackage[],
  ) => CheckrPackage[] | Promise<CheckrPackage[]>
  /** Filter the selectable work-location countries. May be async. */
  workLocationCountryFilter?: (
    countries: CheckrCountry[],
  ) => CheckrCountry[] | Promise<CheckrCountry[]>
  /** Called with the created background check on success. */
  onInvitationSuccess?: (backgroundCheck: CheckrBackgroundCheck) => void
  /** Called with the error when invitation creation fails. */
  onInvitationError?: (error: unknown) => void
}

export interface ReportsOverviewProps
  extends BaseEmbedProps,
    SessionTokenProps {
  candidateId?: string
  externalCandidateId?: string
  expandScreenings?: boolean
  showIndividualScreenings?: boolean
}

export interface OrderExperienceFeatures {
  layout?: 'auto' | 'compact'
  packageDisplayMode?: 'package-dropdown' | 'package-card-selector'
  hidePrices?: boolean
  showOrderSummary?: boolean
  [key: string]: unknown
}

export interface OrderExperienceStyles {
  theme?: 'light' | 'dark'
  primaryColor?: string
  secondaryColor?: string
  backgroundColor?: string
  textColor?: string
  fieldColor?: string
  fontFamily?: string
  fontSize?: number
  fontWeight?: number
  cornerRadius?: number
  edgeStyle?: 'outline' | 'shadow'
  outlineWidth?: number
  outlineColor?: string
  shadowDepth?: number
  shadowColor?: string
  [key: string]: unknown
}

export interface OrderExperienceProps extends BaseEmbedProps {
  /** Checkr account id passed to the ox-orders embed context. Required. */
  accountId: string
  hierarchyNodeId?: string
  sessionTokenPath?: string
  sessionTokenRequestHeaders?: () => Record<string, string>
  getSessionToken?: () => Promise<string>
  authToken?: string
  features?: OrderExperienceFeatures
  styles?: OrderExperienceStyles
  presetNodeCustomId?: string
  presetEmail?: string
  presetFirstName?: string
  presetPhone?: string
  presetWorkLocation?: WorkLocation
  onReady?: () => void
  onOrderSubmitted?: (orderId: string) => void
  onCartChanged?: (cartId: string) => void
  onCompleted?: () => void
  onCancelled?: () => void
  onConfigResolved?: (config: Record<string, unknown>) => void
  onAuthError?: (error: unknown) => void
}

export interface SignUpFlowProps extends BaseEmbedProps {
  /** Partner descriptor (name, logo_url, ...). Required. */
  partner: {
    name?: string
    partner_name?: string
    logo_url?: string
    [key: string]: unknown
  }
  signIn?: boolean
  oauthTokenPath?: string
  oauthRedirectUrl?: string
  oauthRedirectState?: string
  presetEmail?: string
  presetName?: string
  presetLastName?: string
  presetBusinessName?: string
  presetBusinessAddress?: string
  presetCity?: string
  presetZipCode?: string
  presetState?: string
  presetTaxId?: string
}

/**
 * Structural stand-in for React.ReactElement. Declared locally so this
 * package does not require `@types/react`; because it matches
 * `ReactElement<any, any>` structurally, components returning it are valid
 * JSX element types and assignable to `React.FC<P>` in projects that do
 * have `@types/react`.
 */
export interface CheckrReactElement {
  // eslint-disable-next-line @typescript-eslint/no-explicit-any
  type: any
  // eslint-disable-next-line @typescript-eslint/no-explicit-any
  props: any
  key: string | null
}

/** A React component factory, as returned by `Embed.useReact`. */
export type EmbedReactComponent<P> = (props: P) => CheckrReactElement | null

declare class Embed<P> {
  constructor(props: P)
  render(containerSelector: string): void
  modal(params?: ModalParams): void
  static useReact(React: unknown, ReactDOM: unknown): EmbedReactComponent<any>
}

declare class DisclosureConsentEmbed extends Embed<DisclosureConsentProps> {
  static useReact(
    React: unknown,
    ReactDOM: unknown,
  ): EmbedReactComponent<DisclosureConsentProps>
}

declare class NewInvitationEmbed extends Embed<NewInvitationProps> {
  static useReact(
    React: unknown,
    ReactDOM: unknown,
  ): EmbedReactComponent<NewInvitationProps>
}

declare class OrderExperienceEmbed extends Embed<OrderExperienceProps> {
  destroy(): void
}

declare class ReportsOverviewEmbed extends Embed<ReportsOverviewProps> {
  static useReact(
    React: unknown,
    ReactDOM: unknown,
  ): EmbedReactComponent<ReportsOverviewProps>
}

declare class SignUpFlowEmbed extends Embed<SignUpFlowProps> {
  static useReact(
    React: unknown,
    ReactDOM: unknown,
  ): EmbedReactComponent<SignUpFlowProps>
}

export declare const Embeds: {
  DisclosureConsent: typeof DisclosureConsentEmbed
  NewInvitation: typeof NewInvitationEmbed
  OrderExperience: typeof OrderExperienceEmbed
  ReportsOverview: typeof ReportsOverviewEmbed
  SignUpFlow: typeof SignUpFlowEmbed
}