Kumpulan data

export interface AvailableDatasets {
    /**
     * Daftar kumpulan data.
     */
    datasets: Dataset[];
}

export interface Dataset {
    /**
     * ID dari dataset tersebut.
     */
    id: string;

    /**
     * Nama dataset.
     */
    name: string;

    /**
     * Situs web untuk kumpulan data tersebut.
     */
    website: string;

    /**
     * URL tempat lisensi untuk dataset tersebut dapat ditemukan.
     */
    licenseUrl: string;

    /**
     * Nama bahasa Inggris untuk dataset tersebut.
     */
    englishName: string;

    /**
     * Tag bahasa ISO 639 3 huruf yang menjadi standar utama dataset ini.
     */
    language: string;

    /**
     * Arah penulisan bahasa tersebut.
     * "ltr" menunjukkan bahwa teks ditulis dari sisi kiri halaman ke kanan.
     * "rtl" menunjukkan bahwa teks ditulis dari sisi kanan halaman ke kiri.
     */
    textDirection: 'ltr' | 'rtl';

    /**
     * Tautan API untuk daftar buku yang tersedia untuk dataset ini.
     */
    listOfBooksApiLink: string;

    /**
     * Daftar format yang tersedia.
     */
    availableFormats: ('json' | 'usfm')[];

    /**
     * Jumlah buku yang terdapat dalam dataset ini.
     */
    numberOfBooks: number;

    /**
     * Jumlah total bab yang terdapat dalam dataset ini.
     */
    totalNumberOfChapters: number;

    /**
     * Jumlah total ayat yang terdapat dalam dataset ini.
     */
    totalNumberOfVerses: number;

    /**
     * Jumlah total referensi silang yang terdapat dalam dataset ini.
     */
    totalNumberOfReferences: number;

    /**
     * Mendapatkan nama bahasa yang digunakan dalam dataset tersebut.
     * Nilai null atau tidak terdefinisi jika nama bahasanya tidak diketahui.
     */
    languageName?: string;

    /**
     * Mendapatkan nama bahasa tersebut dalam bahasa Inggris.
     * Null atau undefined jika bahasa tersebut tidak memiliki nama dalam bahasa Inggris.
     */
    languageEnglishName?: string;

    /**
     * Tautan API untuk daftar entitas dalam dataset.
     * Dihilangkan jika dataset tidak berisi entitas yang sesuai.
     */
    listOfPeopleApiLink?: string;
    listOfPlacesApiLink?: string;
    listOfEventsApiLink?: string;
    listOfPeopleGroupsApiLink?: string;

    /**
     * Jumlah total entitas yang terdapat dalam dataset.
     * Dihilangkan jika dataset tidak berisi entitas yang sesuai.
     */
    totalNumberOfPeople?: number;
    totalNumberOfPlaces?: number;
    totalNumberOfEvents?: number;
    totalNumberOfPeopleGroups?: number;
}

export interface DatasetBooks {
    /**
     * Informasi dataset untuk buku-buku tersebut.
     */
    dataset: Dataset;

    /**
     * Daftar buku yang tersedia untuk dataset tersebut.
     */
    books: DatasetBook[];
}

interface DatasetBook {
    /**
     * ID buku tersebut.
     * Sesuai dengan ID buku yang bersangkutan dalam Alkitab (Kejadian, Keluaran, dll.).
     */
    id: string;

    /**
     * Urutan kitab dalam Alkitab.
     */
    order: number;

    /**
     * Nomor bab pertama dalam buku tersebut.
     */
    firstChapterNumber: number;

    /**
     * Tautan ke bab pertama buku tersebut.
     */
    firstChapterApiLink: string | null;

    /**
     * Nomor bab terakhir dalam buku tersebut.
     */
    lastChapterNumber: number | null;

    /**
     * Tautan ke bab terakhir buku tersebut.
     */
    lastChapterApiLink: string | null;

    /**
     * Jumlah bab yang terdapat dalam buku tersebut.
     */
    numberOfChapters: number;

    /**
     * Jumlah ayat yang terdapat dalam buku tersebut.
     */
    totalNumberOfVerses: number;

    /**
     * Jumlah total referensi silang yang terdapat dalam buku ini.
     */
    totalNumberOfReferences: number;
}

export interface DatasetBookChapter {
    /**
     * Informasi dataset untuk bab buku tersebut.
     */
    dataset: Dataset;

    /**
     * Informasi buku untuk bab buku tersebut.
     */
    book: DatasetBook;

    /**
     * Tautan ke bab ini.
     */
    thisChapterLink: string;

    /**
     * Tautan ke bab selanjutnya.
     * Bernilai null jika ini adalah bab terakhir dalam dataset.
     */
    nextChapterApiLink: string | null;

    /**
     * Tautan ke bab sebelumnya.
     * Bernilai null jika ini adalah bab pertama dalam dataset.
     */
    previousChapterApiLink: string | null;

    /**
     * Jumlah ayat yang terdapat dalam bab tersebut.
     */
    numberOfVerses: number;

    /**
     * Informasi untuk bab ini.
     */
    chapter: DatasetChapterData;
}

interface DatasetChapterData {
    /**
     * Nomor bab.
     */
    number: number;

    /**
     * Isi bab tersebut.
     */
    content: DatasetVerse[];
}

interface DatasetVerse {
    /**
     * Nomor ayat tersebut.
     */
    verse: number;

    /**
     * Referensi silang untuk ayat tersebut.
     *
     * Diurutkan berdasarkan skor, menurun.
     */
    references: DatasetReference[];
}

interface DatasetReference {
    /**
     * ID buku yang dirujuk.
     */
    book: string;

    /**
     * Nomor bab.
     */
    chapter: number;

    /**
     * Nomor ayat.
     * Jika `endVerse` ada, maka ini adalah ayat tempat referensi dimulai.
     */
    verse: number;

    /**
     * Ayat yang menjadi akhir dari referensi tersebut.
     */
    endVerse?: number;

    /**
     * Skor relevansi untuk referensi tersebut.
     */
    score?: number;
}

export interface DatasetEntityRef {
    /**
     * ID dari entitas yang sedang dirujuk.
     */
    id: string;

    /**
     * Tipe entitas yang sedang dirujuk.
     * Sesuai dengan segmen koleksi tautan API entitas, sehingga tautan dapat dibuat sebagai `/api/d/{dataset}/{type}/{id}.json` .
     */
    type: 'people' | 'places' | 'events' | 'groups';

    /**
     * Nama entitas yang dirujuk.
     */
    name?: string;

    /**
     * Tautan API untuk entitas yang sedang dirujuk.
     */
    apiLink?: string;
}

export interface VerseRef {
    /**
     * ID buku tersebut (GEN, EXO, dll.).
     */
    book: string;

    /**
     * Nomor bab tempat referensi dimulai.
     */
    chapter: number;

    /**
     * Nomor ayat tempat referensi dimulai.
     */
    verse: number;

    /**
     * Ayat yang menjadi akhir dari referensi tersebut.
     * Ayat-ayat berurutan dalam bab yang sama digabungkan menjadi satu referensi.
     */
    endVerse?: number;
}

export interface DatasetEntityBookChapter {
    /**
     * Informasi dataset untuk bab buku tersebut.
     */
    dataset: Dataset;

    /**
     * Informasi buku untuk bab buku tersebut.
     */
    book: DatasetBook;

    /**
     * Data entitas untuk bab tersebut.
     */
    chapter: DatasetEntityChapterData;

    /**
     * Tautan ke bab ini.
     */
    thisChapterLink: string;

    /**
     * Tautan ke bab selanjutnya.
     * Bernilai null jika ini adalah bab terakhir dalam dataset.
     */
    nextChapterApiLink: string | null;

    /**
     * Tautan ke bab sebelumnya.
     * Bernilai null jika ini adalah bab pertama dalam dataset.
     */
    previousChapterApiLink: string | null;

    /**
     * Jumlah orang, tempat, dan peristiwa yang muncul dalam bab tersebut.
     */
    numberOfPeople: number;
    numberOfPlaces: number;
    numberOfEvents: number;
}

interface DatasetEntityChapterData {
    /**
     * Nomor bab.
     */
    number: number;

    /**
     * Orang-orang yang muncul dalam bab tersebut.
     * Diurutkan berdasarkan ayat pertama tempat mereka muncul.
     */
    people: ChapterPerson[];

    /**
     * Tempat-tempat yang muncul dalam bab tersebut.
     * Diurutkan berdasarkan ayat pertama tempat mereka muncul.
     */
    places: ChapterPlace[];

    /**
     * Peristiwa-peristiwa yang muncul dalam bab tersebut.
     * Diurutkan berdasarkan ayat pertama tempat mereka muncul.
     */
    events: ChapterEvent[];
}

interface ChapterPerson {
    /**
     * Identitas orang tersebut.
     */
    id: string;

    /**
     * Nama orang tersebut.
     */
    name: string;

    /**
     * Apakah nama orang tersebut merupakan nama diri.
     */
    isProperName?: boolean;

    /**
     * Jenis kelamin orang tersebut.
     */
    gender?: string;

    /**
     * Tahun kelahiran dan tahun kematian orang tersebut.
     * Angka negatif menunjukkan tahun SM. Angka positif menunjukkan tahun Masehi.
     */
    birthYear?: number;
    deathYear?: number;

    /**
     * Tautan API untuk orang tersebut.
     */
    apiLink: string;

    /**
     * Nomor-nomor ayat dalam surah tersebut yang menyebutkan nama orang tersebut.
     * Diurutkan dalam urutan menaik.
     */
    verses: number[];
}

interface ChapterPlace {
    /**
     * ID tempat tersebut.
     */
    id: string;

    /**
     * Nama tempat tersebut.
     */
    name: string;

    /**
     * Jenis bentang geografis yang dimiliki tempat tersebut.
     */
    featureType?: string;

    /**
     * Garis lintang dan garis bujur tempat tersebut.
     */
    latitude?: number;
    longitude?: number;

    /**
     * Tautan API untuk tempat tersebut.
     */
    apiLink: string;

    /**
     * Nomor-nomor ayat dalam bab tersebut yang menyebutkan tempat itu.
     * Diurutkan dalam urutan menaik.
     */
    verses: number[];
}

interface ChapterEvent {
    /**
     * ID acara tersebut.
     */
    id: string;

    /**
     * Nama acara tersebut.
     */
    name: string;

    /**
     * Tanggal dimulainya acara tersebut.
     */
    startDate?: string;

    /**
     * Tautan API untuk acara tersebut.
     */
    apiLink: string;

    /**
     * Nomor-nomor ayat dalam pasal yang menggambarkan peristiwa tersebut.
     * Diurutkan dalam urutan menaik.
     */
    verses: number[];
}

export interface DatasetPeople {
    /**
     * Informasi dataset untuk orang-orang tersebut.
     */
    dataset: Dataset;

    /**
     * Daftar orang-orang yang tersedia untuk dataset tersebut.
     */
    people: DatasetPersonSummary[];
}

interface DatasetPersonSummary {
    /**
     * Identitas orang tersebut.
     */
    id: string;

    /**
     * Nama orang tersebut.
     */
    name: string;

    /**
     * Apakah nama orang tersebut merupakan nama diri.
     */
    isProperName?: boolean;

    /**
     * Jenis kelamin orang tersebut.
     */
    gender?: string;

    /**
     * Jumlah referensi Alkitab yang menyebutkan orang tersebut.
     */
    numberOfReferences: number;

    /**
     * Tautan API untuk orang tersebut.
     */
    thisPersonApiLink: string;
}

export interface DatasetPersonResponse {
    /**
     * Informasi dataset untuk orang tersebut.
     */
    dataset: Dataset;

    /**
     * Informasi tentang orang tersebut.
     */
    person: DatasetPerson;

    /**
     * Tautan API untuk orang ini.
     */
    thisPersonApiLink: string;
}

interface DatasetPerson {
    /**
     * Identitas orang tersebut.
     */
    id: string;

    /**
     * Nama orang tersebut.
     */
    name: string;

    /**
     * Nama lain yang digunakan untuk memanggil orang tersebut.
     */
    alsoCalled?: string[];

    /**
     * Apakah nama orang tersebut merupakan nama diri.
     */
    isProperName?: boolean;

    /**
     * Jenis kelamin orang tersebut.
     */
    gender?: string;

    /**
     * Deskripsi orang tersebut. Setiap string merupakan sebuah paragraf.
     */
    description?: string[];

    /**
     * Tahun kelahiran dan tahun kematian orang tersebut.
     * Angka negatif menunjukkan tahun SM. Angka positif menunjukkan tahun Masehi.
     */
    birthYear?: number;
    deathYear?: number;

    /**
     * Tahun paling awal dan paling akhir di mana orang tersebut disebutkan.
     */
    minYear?: number;
    maxYear?: number;

    /**
     * Tempat kelahiran dan kematian seseorang.
     */
    birthPlace?: DatasetEntityRef;
    deathPlace?: DatasetEntityRef;

    /**
     * Hubungan keluarga orang tersebut.
     */
    father?: DatasetEntityRef[];
    mother?: DatasetEntityRef[];
    partners?: DatasetEntityRef[];
    children?: DatasetEntityRef[];
    siblings?: DatasetEntityRef[];
    halfSiblingsSameMother?: DatasetEntityRef[];
    halfSiblingsSameFather?: DatasetEntityRef[];

    /**
     * Kelompok-kelompok masyarakat tempat orang tersebut menjadi anggotanya.
     */
    memberOf?: DatasetEntityRef[];

    /**
     * Peristiwa-peristiwa yang diikuti oleh orang tersebut.
     */
    events?: DatasetEntityRef[];

    /**
     * Daftar referensi Alkitab yang menyebutkan orang tersebut.
     * Diurutkan berdasarkan urutan buku, bab, dan ayat.
     */
    references: VerseRef[];
}

export interface DatasetPlaces {
    /**
     * Informasi dataset untuk tempat-tempat tersebut.
     */
    dataset: Dataset;

    /**
     * Daftar tempat yang tersedia untuk dataset tersebut.
     */
    places: DatasetPlaceSummary[];
}

interface DatasetPlaceSummary {
    /**
     * ID tempat tersebut.
     */
    id: string;

    /**
     * Nama tempat tersebut.
     */
    name: string;

    /**
     * Jenis bentang geografis yang dimiliki tempat tersebut.
     * Sebagai contoh, "Kota", "Wilayah", "Gunung", "Air", dan lain sebagainya.
     */
    featureType?: string;

    /**
     * Garis lintang dan garis bujur tempat tersebut.
     */
    latitude?: number;
    longitude?: number;

    /**
     * Jumlah referensi Alkitab yang menyebutkan tempat tersebut.
     */
    numberOfReferences: number;

    /**
     * Tautan API untuk tempat tersebut.
     */
    thisPlaceApiLink: string;
}

export interface DatasetPlaceResponse {
    /**
     * Informasi dataset untuk tempat tersebut.
     */
    dataset: Dataset;

    /**
     * Informasi tentang tempat tersebut.
     */
    place: DatasetPlace;

    /**
     * Tautan API untuk tempat ini.
     */
    thisPlaceApiLink: string;
}

interface DatasetPlace {
    /**
     * ID tempat tersebut.
     */
    id: string;

    /**
     * Nama tempat tersebut.
     */
    name: string;

    /**
     * Nama tempat tersebut sebagaimana tercantum dalam King James Version dan English Standard Version.
     */
    kjvName?: string;
    esvName?: string;

    /**
     * Nama lain yang digunakan untuk menyebut tempat itu.
     */
    aliases?: string[];

    /**
     * Jenis bentang geografis yang dimiliki tempat tersebut.
     */
    featureType?: string;
    featureSubType?: string;

    /**
     * Garis lintang dan garis bujur tempat tersebut, dan seberapa tepatnya angka-angka tersebut.
     */
    latitude?: number;
    longitude?: number;
    precision?: string;

    /**
     * Deskripsi tempat tersebut. Setiap string merupakan sebuah paragraf.
     */
    description?: string[];

    /**
     * Komentar tentang tempat tersebut dari para penulis dataset.
     */
    comment?: string;

    /**
     * Tempat asal mula tempat ini.
     * Nama-nama berbeda untuk lokasi geografis yang sama memiliki akar kata yang sama.
     */
    rootPlace?: DatasetEntityRef;

    /**
     * Tempat yang menjadi duplikat dari tempat ini.
     */
    duplicateOf?: DatasetEntityRef;

    /**
     * Orang-orang yang pernah berada di, lahir di, atau meninggal di tempat tersebut.
     */
    people?: DatasetEntityRef[];
    peopleBorn?: DatasetEntityRef[];
    peopleDied?: DatasetEntityRef[];

    /**
     * Peristiwa-peristiwa yang terjadi di tempat tersebut.
     */
    events?: DatasetEntityRef[];

    /**
     * Daftar referensi Alkitab yang menyebutkan tempat tersebut.
     * Diurutkan berdasarkan urutan buku, bab, dan ayat.
     */
    references: VerseRef[];
}

export interface DatasetEvents {
    /**
     * Informasi dataset untuk peristiwa-peristiwa tersebut.
     */
    dataset: Dataset;

    /**
     * Daftar peristiwa yang tersedia untuk dataset tersebut.
     */
    events: DatasetEventSummary[];
}

interface DatasetEventSummary {
    /**
     * ID acara tersebut.
     */
    id: string;

    /**
     * Nama acara tersebut.
     */
    name: string;

    /**
     * Tanggal dimulainya acara tersebut.
     * Angka negatif menunjukkan tahun SM. Angka positif menunjukkan tahun Masehi.
     * Tanggal yang lebih spesifik menggunakan format `YYYY-MM-DD` .
     */
    startDate?: string;

    /**
     * Jumlah referensi Alkitab yang menggambarkan peristiwa tersebut.
     */
    numberOfReferences: number;

    /**
     * Tautan API untuk acara tersebut.
     */
    thisEventApiLink: string;
}

export interface DatasetEventResponse {
    /**
     * Informasi dataset untuk acara tersebut.
     */
    dataset: Dataset;

    /**
     * Informasi mengenai acara tersebut.
     */
    event: DatasetEvent;

    /**
     * Tautan API untuk acara ini.
     */
    thisEventApiLink: string;
}

interface DatasetEvent {
    /**
     * ID acara tersebut.
     */
    id: string;

    /**
     * Nama acara tersebut.
     */
    name: string;

    /**
     * Tanggal dimulainya acara tersebut.
     */
    startDate?: string;

    /**
     * Durasi acara tersebut.
     * Sebagai contoh, "1D" berarti satu hari dan "40Y" berarti empat puluh tahun.
     */
    duration?: string;

    /**
     * Orang-orang yang berpartisipasi dalam acara tersebut.
     */
    participants?: DatasetEntityRef[];

    /**
     * Tempat-tempat di mana peristiwa itu terjadi.
     */
    locations?: DatasetEntityRef[];

    /**
     * Kelompok-kelompok masyarakat yang berpartisipasi dalam acara tersebut.
     */
    groups?: DatasetEntityRef[];

    /**
     * Acara yang menjadi bagian dari acara ini.
     */
    partOf?: DatasetEntityRef;

    /**
     * Peristiwa yang terjadi sebelum peristiwa ini.
     */
    predecessor?: DatasetEntityRef;

    /**
     * Daftar referensi Alkitab yang menjelaskan peristiwa tersebut.
     * Diurutkan berdasarkan urutan buku, bab, dan ayat.
     */
    references: VerseRef[];
}

export interface DatasetPeopleGroups {
    /**
     * Informasi dataset untuk kelompok-kelompok masyarakat.
     */
    dataset: Dataset;

    /**
     * Daftar kelompok masyarakat yang tersedia untuk dataset ini.
     */
    groups: DatasetPeopleGroupSummary[];
}

interface DatasetPeopleGroupSummary {
    /**
     * Identitas kelompok masyarakat tersebut.
     */
    id: string;

    /**
     * Nama kelompok etnis tersebut.
     */
    name: string;

    /**
     * Jumlah orang yang menjadi anggota kelompok masyarakat tersebut.
     */
    numberOfMembers: number;

    /**
     * Tautan API untuk kelompok masyarakat tersebut.
     */
    thisPeopleGroupApiLink: string;
}

export interface DatasetPeopleGroupResponse {
    /**
     * Informasi dataset untuk kelompok masyarakat tersebut.
     */
    dataset: Dataset;

    /**
     * Informasi tentang kelompok masyarakat tersebut.
     */
    group: DatasetPeopleGroup;

    /**
     * Tautan API untuk kelompok masyarakat ini.
     */
    thisPeopleGroupApiLink: string;
}

interface DatasetPeopleGroup {
    /**
     * Identitas kelompok masyarakat tersebut.
     */
    id: string;

    /**
     * Nama kelompok etnis tersebut.
     */
    name: string;

    /**
     * Orang-orang yang merupakan anggota dari kelompok masyarakat tersebut.
     */
    members?: DatasetEntityRef[];

    /**
     * Peristiwa-peristiwa yang diikuti oleh kelompok masyarakat tersebut.
     */
    events?: DatasetEntityRef[];

    /**
     * Daftar referensi Alkitab yang menyebutkan kelompok masyarakat tersebut.
     * Diurutkan berdasarkan urutan buku, bab, dan ayat.
     */
    references: VerseRef[];
}