Data Structures

interface Mate {
  id: number;              // Auto-increment primary key
  public_id?: string;      // Human-readable public ID (optional)
  name: string;            // Submitter's name
  country: string;         // Country name (localized)
  country_code?: string;   // ISO 3166-1 alpha-3 code (e.g., "ARG")
  brand: string;           // Yerba mate brand name
  preparation: string;     // "amargo" | "dulce" | "tereré" | "Mate Cocido"
  mate_type?: string;      // Vessel type (e.g., "Calabaza", "Madera")
  photo_path: string;      // Filename in Supabase storage bucket
  lat?: number;            // Latitude (GPS or capital fallback)
  lng?: number;            // Longitude (GPS or capital fallback)
  approved: boolean | null;// true = approved, false = rejected, null = pending
  created_at: string;      // ISO 8601 timestamp
}

{
  "id": 42,
  "public_id": "200M-ARG-042",
  "name": "Juan Pérez",
  "country": "Argentina",
  "country_code": "ARG",
  "brand": "La Merced",
  "preparation": "amargo",
  "mate_type": "Calabaza",
  "photo_path": "1709801234567_abc123.jpg",
  "lat": -34.6037,
  "lng": -58.3816,
  "approved": true,
  "created_at": "2026-03-07T14:32:15.000Z"
}

interface Country {
  name: string;      // English name
  nameEs: string;    // Spanish name
  namePt: string;    // Portuguese name
  iso3: string;      // ISO 3166-1 alpha-3 code
  flag: string;      // Unicode flag emoji
}

interface CountryFeature {
  type: "Feature";
  id: string;           // Numeric country ID
  properties: object;   // Metadata (unused in 200 Mates)
  geometry: {
    type: "Polygon" | "MultiPolygon";
    coordinates: number[][][] | number[][][][];
  };
  iso3?: string;        // Added by app for lookup
}

{
  "type": "Feature",
  "id": "32",
  "properties": { "name": "Argentina" },
  "geometry": {
    "type": "MultiPolygon",
    "coordinates": [
      [[[-65.5, -55.2], [-66.4, -55.2], ...]],
      [[[-68.6, -52.6], ...]]
    ]
  },
  "iso3": "ARG"
}

interface Translation {
  [language: string]: {
    [key: string]: string;
  };
}

const i18n: Translation = {
  es: { ... },  // Spanish
  en: { ... },  // English
  pt: { ... }   // Portuguese
};

interface SupabaseQueryResponse {
  data: Mate[] | null;
  error: {
    message: string;
    details: string;
    hint: string;
    code: string;
  } | null;
}

interface SupabaseStorageResponse {
  data: {
    path: string;
  } | null;
  error: {
    message: string;
    statusCode: string;
  } | null;
}

interface FormSubmission {
  name: string;          // User's name
  country: string;       // Country (with flag emoji prefix)
  countryCode: string;   // ISO3 code
  brand: string;         // Yerba brand
  preparation: string;   // Preparation type
  mate_type: string;     // Vessel type (optional)
  photo: File;           // Photo file
  lat: number | null;    // GPS latitude
  lng: number | null;    // GPS longitude
}