quran-meta/src/getManzilMeta.ts

Library with meta data and functionality related to Holy Quran

import { findSurahAyahByAyahId } from "./findSurahAyahByAyahId"
import type { RiwayaData } from "./lists/types"
import type { AyahId, ManzilMeta } from "./types"
import { checkValidManzil } from "./validation"

/**
 * Retrieves metadata for a specific Manzil (section) of the Quran
 *
 * @param manzilNum - The number of the Manzil (1-7)
 * @param data - The Lists object for the riwaya.
 * @returns The metadata for the specified Manzil containing:
 *  - manzilNum: The Manzil number
 *  - firstAyahId: ID of the first ayah in the Manzil
 *  - lastAyahId: ID of the last ayah in the Manzil
 *  - first: Surah and ayah details of the first ayah
 *  - last: Surah and ayah details of the last ayah
 * @throws Will throw an error if manzilNum is invalid
 */
export function getManzilMeta(
  manzilNum: number,
  data: RiwayaData
): ManzilMeta {
  checkValidManzil(manzilNum, data.meta)
  const ManzilList = data.ManzilList
  const [firstAyahId, nextManzilAyahId]: [AyahId, AyahId] = [
    ManzilList[manzilNum],
    ManzilList[manzilNum + 1]
  ]
  const lastAyahId = nextManzilAyahId - 1
  return {
    manzilNum,
    firstAyahId,
    lastAyahId,
    first: findSurahAyahByAyahId(firstAyahId, data),
    last: findSurahAyahByAyahId(lastAyahId, data)
  }
}