import{EQuran}from'equran';constquran=newEQuran();// Get all surahsconstsurahs=awaitquran.getAllSurat();// Get a specific surah with all versesconstalFatihah=awaitquran.getSurat(1);// Get tafsirconsttafsir=awaitquran.getTafsir(1);

constsurahs=awaitquran.getAllSurat();// Returns: Surat[]

constsurah=awaitquran.getSurat(36);// Returns: SuratDetail

consttafsir=awaitquran.getTafsir(1);// Returns: TafsirDetail

constayatKursi=awaitquran.getAyat(2,255);console.log(ayatKursi.teksArab);console.log(ayatKursi.teksIndonesia);

constrange=awaitquran.getAyatRange(2,1,5);// Returns: AyatRange// {// suratNomor: 2,// suratNama: "البقرة",// suratNamaLatin: "Al-Baqarah",// fromAyat: 1,// toAyat: 5,// ayat: Ayat[]// }

constsurah=awaitquran.getSuratByName('Yasin');console.log(surah?.nomor);// 36

constresults=awaitquran.searchSurat('sapi');// Returns Al-Baqarah (meaning: The Cow/Sapi)

constmakkiyah=awaitquran.getMakkiyahSurat();// Returns 86 surahs

constmadaniyah=awaitquran.getMadaniyahSurat();// Returns 28 surahs

constaudioUrl=awaitquran.getAudioFull(36,'05');// "https://cdn.equran.id/audio-full/Misyari-Rasyid-Al-Afasi/036.mp3"

constaudioUrl=awaitquran.getAudioAyat(2,255,'03');// Returns Ayat Kursi audio by Sudais

constqariList=quran.getQariList();

consttafsir=awaitquran.getTafsirAyat(1,1);console.log(tafsir.teks);

constrandom=awaitquran.getRandomAyat();// Returns: RandomAyat// {// suratNomor: 36,// suratNama: "يس",// suratNamaLatin: "Ya-Sin",// ayat: Ayat// }

constinfo=awaitquran.getSuratInfo(36);console.log(info.jumlahAyat);// 83

constnext=awaitquran.getNextSurat(1);console.log(next?.namaLatin);// "Al-Baqarah"

constprev=awaitquran.getPrevSurat(2);console.log(prev?.namaLatin);// "Al-Fatihah"

const{ surat, tafsir }=awaitquran.getSuratWithTafsir(1);

constsurahs=awaitquran.bulkGetSurat([1,36,67,78]);// Returns: SuratDetail[]

quran.clearCache();

conststats=quran.getCacheStats();// {// hits: 10,// misses: 5,// size: 5,// hitRate: 0.667// }

constremoved=quran.pruneCache();console.log(`Removed ${removed} expired entries`);

constquran=newEQuran({// Base API URL (default: https://equran.id/api/v2)baseUrl: 'https://equran.id/api/v2',// Request timeout in milliseconds (default: 30000)timeout: 30000,// Cache configurationcache: {enabled: true,// Enable caching (default: true)ttl: 60*60*1000,// TTL in ms (default: 1 hour)maxSize: 200,// Max cache entries (default: 200)}});

importtype{Surat,SuratDetail,Ayat,TafsirDetail,TafsirAyat,QariInfo,RandomAyat,AyatRange,SuratWithTafsir,EQuranConfig,CacheStats,AudioMap,}from'equran';

import{EQuran,EQuranApiError}from'equran';try{constsurah=awaitquran.getSurat(999);}catch(error){if(errorinstanceofEQuranApiError){console.error(`API Error: ${error.message}`);console.error(`Status Code: ${error.statusCode}`);console.error(`Endpoint: ${error.endpoint}`);}}

asyncfunctiongetDailyVerse(){constquran=newEQuran();constrandom=awaitquran.getRandomAyat();return{surah: random.suratNamaLatin,verse: random.ayat.nomorAyat,arabic: random.ayat.teksArab,translation: random.ayat.teksIndonesia,audio: random.ayat.audio['05'],};}

asyncfunctionreadSurah(nomor: number){constquran=newEQuran();constsurah=awaitquran.getSurat(nomor);console.log(`${surah.namaLatin} (${surah.nama})`);console.log(`${surah.tempatTurun} | ${surah.jumlahAyat} verses`);console.log(`Meaning: ${surah.arti}\n`);for(constayatofsurah.ayat){console.log(`[${ayat.nomorAyat}] ${ayat.teksArab}`);console.log(` ${ayat.teksIndonesia}\n`);}}

asyncfunctionstudySurah(nomor: number){constquran=newEQuran();const{ surat, tafsir }=awaitquran.getSuratWithTafsir(nomor);for(leti=0;i<surat.ayat.length;i++){constayat=surat.ayat[i];consttafsirAyat=tafsir.tafsir[i];console.log(`--- Verse ${ayat.nomorAyat} ---`);console.log(`Arabic: ${ayat.teksArab}`);console.log(`Translation: ${ayat.teksIndonesia}`);console.log(`Tafsir: ${tafsirAyat.teks}\n`);}}