feat: updated getRubAlHizbMeta and getRubAlHizbMetabyAyahId

Author: husayt

src/getRubAlHizbMeta.ts

@@ -1,21 +1,25 @@
-import { HizbId, Juz, JuzHizb, JuzPart, RubAlHizbId } from "./types"
+import { findSurahAyahByAyahId } from "./findSurahAyahByAyahId"
+import { getRubAlHizb } from "./getRubAlHizb"
+import { HizbQuarterList } from "./lists/hizbQuarterList"
+import { RubAlHizbMeta, RubAlHizbId, AyahId } from "./types"
 
 /**
  * Retrieves the metadata for a specific quarter (rub' al-hizb) of the Quran.
  *
  * @param quarterIndex - The index of the quarter (rub' al-hizb) to retrieve metadata for, where 1 is the first quarter.
  * @returns An object containing the metadata for the specified quarter, including the juz' (part), hizb (section), and the quarter (rub' al-hizb) index.
  */
-export function getRubAlHizbMeta(quarterIndex: RubAlHizbId): JuzHizb {
-  // return HizbQuarterList[maqra]
+export function getRubAlHizbMeta(quarterIndex: RubAlHizbId): RubAlHizbMeta {
+  const res = getRubAlHizb(quarterIndex)
 
-  // const quarterIndex = HizbQuarterList.findIndex(x => x > ayahId) - 1
+  const [firstAyahId, nextJuzAyahId]: [AyahId, AyahId] = [
+    HizbQuarterList[quarterIndex],
+    HizbQuarterList[quarterIndex + 1]
+  ]
+  const lastAyahId = nextJuzAyahId - 1
 
-  // const juz = findJuzByAyahId(ayahId)
-  const juz = Math.floor((quarterIndex - 1) / 8) + 1 as Juz
-  // isValidJuz(juz)
-
-  const hizbIndex = Math.floor((quarterIndex - 1) / 4) + 1 as HizbId
-  const juzPart = (quarterIndex % 8 || 8) as JuzPart
-  return { juz, hizbId: hizbIndex, juzPart, rubAlHizbId: quarterIndex }
+  return { firstAyahId,
+    lastAyahId,
+    first: findSurahAyahByAyahId(firstAyahId),
+    last: findSurahAyahByAyahId(lastAyahId), ...res }
 }

src/getRubAlHizbMetaByAyahId.ts

@@ -1,6 +1,6 @@
 import { findRubAlHizbByAyahId } from "./findRubAlHizbByAyahId"
 import { getRubAlHizbMeta } from "./getRubAlHizbMeta"
-import { AyahId, JuzHizb } from "./types"
+import { AyahId, RubAlHizbMeta } from "./types"
 import { checkValidAyahId } from "./validation"
 
 /**
@@ -9,7 +9,7 @@ import { checkValidAyahId } from "./validation"
  * @param ayahId - The Ayah ID to find the Juz, Hizb, and Hizb ID for.
  * @returns An object containing the Juz, Hizb, and Hizb ID for the given Ayah ID.
  */
-export function getRubAlHizbMetaByAyahId(ayahId: AyahId): JuzHizb {
+export function getRubAlHizbMetaByAyahId(ayahId: AyahId): RubAlHizbMeta {
   checkValidAyahId(ayahId)
 
   const quarterIndex = findRubAlHizbByAyahId(ayahId)