Partner API

type PartnerClub = {
  id: string;
  name: string;
  description: string | null;
  logo: string | null;
  bannerImage: string | null;
  address: Json | null;
  contactInfo: Json | null;
  businessHours: BusinessHoursEntry[];
  currency: string; // ISO 4217, e.g. "HUF"
  membershipRequired: boolean;
  requireBookingApproval: boolean;
  bookingDecidedByLottery: boolean;
  courts: PartnerCourt[];
};

type BusinessHoursEntry = {
  dayOfWeek: number; // 0–6 (Sunday–Saturday)
  openTime: string;  // "HH:mm"
  closeTime: string;
  isClosed: boolean;
};

type PartnerCourt = {
  id: string;
  name: string;
  courtNumber: number | null;
  type: string | null;
  surface: string | null;
  amenities: Json | null;
  hourlyRate: Json | null; // raw DB; see Court pricing for NormalizedCourtPricing
  maintenanceStatus: string;
  isActive: boolean;
};

type CourtPricesResponse = {
  courts: {
    id: string;
    name: string;
    pricing: NormalizedCourtPricing;
  }[];
};

/** @tennis-booking/court-pricing */
type NormalizedCourtPricing = {
  default: HourlyRateSlot[];
  intervals: SeasonalInterval[];
};

type HourlyRateSlot = {
  price: number;
  currency: string;
  from: string; // "HH:mm"
  to: string;
  isDefault?: boolean;
};

type SeasonalInterval = {
  from: string; // YYYY-MM-DD
  to: string;
  hourlyRate: HourlyRateSlot[];
};

type TimeSlotsResponse = {
  availableTimes: string[]; // ISO local timestamps for slot starts
  date: string;             // YYYY-MM-DD
  courtId: string;
  totalSlots: number;
  businessHours?: {
    openTime: string;
    closeTime: string;
    dayOfWeek: number;
  };
  message?: string; // when availableTimes is empty (closed, maintenance, …)
};

type PartnerEquipment = {
  id: string;
  clubId: string;
  name: string;
  description: string | null;
  price: string | number; // Decimal from DB
  currency: string;
  stock: number;
  image: string | null;
  isActive: boolean;
  createdAt: string;
  updatedAt: string;
  availableUnits?: number; // with startTime + endTime query params
};

type PartnerBooking = {
  id: string;
  clubId: string;
  courtId: string;
  startTime: string;
  endTime: string;
  duration: number; // minutes
  totalPrice: number;
  currency: string;
  status: string;
  isLotteryEntry: boolean;
  partnerDeveloperId: string | null;
  externalReference: string | null;
};

type PartnerPaymentRegistration = {
  paymentId: string;
  status: "completed";
};

type PartnerCancelResult = { cancelled: true };

type PartnerApiError = {
  error: {
    /** Stable machine-readable code. Branch on this. */
    code: PartnerErrorCode;
    /** Human-readable; for logs and support, not for branching. */
    message: string;
    /** Extra context; may be empty. */
    details: Record<string, unknown>;
    /** Correlates with the x-request-id response header. */
    requestId: string;
  };
};

type PartnerErrorCode =
  | "PARTNER_UNAUTHORIZED"                    // 401 missing/invalid API key
  | "PARTNER_RATE_LIMITED"                    // 429 fair-use limit (see Rate limits)
  | "PARTNER_CLUB_NOT_APPROVED"               // 403 club has not approved you
  | "PARTNER_CLUB_NOT_INTEGRABLE"             // 403 club not open to partners
  | "PARTNER_CLUB_NOT_FOUND"                  // 404
  | "PARTNER_COURT_NOT_FOUND"                 // 404
  | "PARTNER_COURT_UNAVAILABLE"               // 409 maintenance / inactive
  | "PARTNER_BOOKING_NOT_FOUND"               // 404
  | "PARTNER_BOOKING_NOT_OWNED"               // 403 booking belongs to another partner
  | "PARTNER_BOOKING_NOT_CANCELLABLE"         // 409
  | "PARTNER_BOOKING_HAS_PAYMENTS"            // 409 refund required first
  | "PARTNER_BOOKING_STATE_INVALID"           // 409
  | "PARTNER_SLOT_UNAVAILABLE"                // 409 slot taken meanwhile
  | "PARTNER_VALIDATION"                      // 400 bad request payload/params
  | "PARTNER_PAYMENT_VALIDATION"              // 400 bad payment payload
  | "PARTNER_NO_COVER_IMAGE"                  // 404 club has no banner/logo
  | "PARTNER_BUSINESS_HOURS_NOT_CONFIGURED"   // 400 no hours for that weekday
  | "PARTNER_INTERNAL_ERROR";                 // 500

// Codes are additive-only: new ones may appear, existing ones are never renamed.
// Treat an unrecognised code as a generic failure for that HTTP status.

const res = await fetch(url, { headers });
if (!res.ok) {
  const body = (await res.json()) as PartnerApiError;
  switch (body.error.code) {
    case "PARTNER_RATE_LIMITED":
      await sleep(Number(res.headers.get("Retry-After") ?? 60) * 1000);
      return retry();
    case "PARTNER_SLOT_UNAVAILABLE":
      return showSlotTaken();
    default:
      logFailure(body.error.code, body.error.requestId);
  }
}

type CheckoutTokenResponse = {
  token: string;       // opaque; single-use after successful return
  checkoutUrl: string; // redirect payer here
  expiresAt: string;   // ISO 8601, 15 min from mint
};