/**
 * Typdefinition der Schnittstelle `etsGetAvailability` (Verfügbarkeiten aus dem System des Kunden).
 *
 * Die Funktion ist optional und muss global (window.etsGetAvailability) bereitgestellt werden.
 * Sie darf ein Promise oder direkt das Ergebnis zurückgeben. Antwortet sie nicht innerhalb von
 * 5 Sekunden oder tritt ein Fehler auf, werden die Verfügbarkeiten des Shops angezeigt.
 *
 * Voraussetzung: Die Artikelnummern der Hans Sauer GmbH (SKU) sind auf Kundenseite bekannt.
 */

/** Ein angefragter Artikel. */
export interface AvailabilityRequestItem {
  /** Ganzzahl, eindeutig innerhalb der Anfrage. Dient als Schlüssel in der Antwort. */
  id: number
  /** Artikelnummer (SKU) der Hans Sauer GmbH */
  articleNumber: string
}

/** Anfrage: Liste der Artikel, zu denen die Verfügbarkeit benötigt wird. */
export interface AvailabilityRequest {
  items: AvailabilityRequestItem[]
}

/**
 * Verfügbarkeitsstatus:
 * - 0: nicht mehr lieferbar
 * - 1: (sehr) gute Verfügbarkeit
 * - 2: befriedigende Verfügbarkeit
 * - 3: kritische Verfügbarkeit
 * - 4: auf Anfrage
 *
 * Bei 0 und 4 zeigt der Shop weder Preise noch Lieferzeit noch einen Warenkorb-Button an.
 */
export type AvailabilityStatus = 0 | 1 | 2 | 3 | 4

/** Verfügbarkeit eines Artikels. */
export interface ArticleAvailability {
  /** Pflicht: muss der SKU aus der Anfrage zu dieser ID entsprechen, sonst wird der Eintrag ignoriert. */
  articleNumber: string
  status: AvailabilityStatus
  /** Lieferzeit in Tagen (Ganzzahl, 0 bis 100000) */
  deliveryDays?: number
}

/**
 * Antwort: Schlüssel = `id` aus der Anfrage.
 * Fehlende oder ungültige Einträge werden ignoriert, der Shop zeigt dafür seine eigenen Werte.
 */
export type AvailabilityResponse = Record<number, ArticleAvailability>

export type AvailabilityProvider = (
  request: AvailabilityRequest
) => Promise<AvailabilityResponse> | AvailabilityResponse

declare global {
  interface Window {
    etsGetAvailability?: AvailabilityProvider
  }
}
