Islamic Network SDK (JavaScript/TypeScript)

Typed SDK for the Islamic Network APIs (AlAdhan + AlQuran) designed to work in React, Next.js, and React Native.

Supported APIs:
- AlAdhan (prayer times, Islamic calendar, qibla, Asma Al Husna)
- AlQuran (surahs, ayahs, sections, editions, search, sajda, meta)
- Boycott Israeli (companies, categories, search)
- Sermons (sources, languages, year/month sermon feeds)

Installation

``bash
npm install @islamicnetwork/sdk


or

pnpm add @islamicnetwork/sdk

or

yarn add @islamicnetwork/sdk
`

Usage

$3

`ts
import { AlAdhanClient, AlAdhanRequests } from "@islamic-network/sdk";

const client = AlAdhanClient.create();

const request = new AlAdhanRequests.DailyPrayerTimesByCoordinatesRequest(
"01-01-2025",
51.5194682,
-0.1360365,
new AlAdhanRequests.PrayerTimesOptions()
);

const response = await client.prayerTimes().dailyByCoordinates(request);

console.log(response.data.timings.Fajr);
`

`ts
import { AlAdhanClient, AlAdhanRequests } from "@islamic-network/sdk";

const client = AlAdhanClient.create();

const qibla = await client.qibla().direction(
new AlAdhanRequests.QiblaDirectionRequest(19.071017570421, 72.838622286762)
);

console.log(qibla.data.direction);
`

`ts
import { AlAdhanClient, AlAdhanRequests } from "@islamic-network/sdk";

const client = AlAdhanClient.create();

const asma = await client
.asmaAlHusna()
.byNumber(new AlAdhanRequests.AsmaAlHusnaByNumberRequest([1, 2, 3]));

console.log(asma.data[0]?.en.meaning);
`

$3

`ts
import { AlAdhanClient, AlAdhanRequests } from "@islamic-network/sdk";

const client = AlAdhanClient.create();
const image = await client
.qibla()
.compass(new AlAdhanRequests.QiblaCompassRequest(19.071017570421, 72.838622286762));

// Browser/React: build a Blob URL
const blob = new Blob([image.body], { type: image.contentType });
const url = URL.createObjectURL(blob);
`

$3

`ts
import { AlQuranClient, AlQuranRequests } from "@islamic-network/sdk";

const client = AlQuranClient.create();

const ayah = await client.ayahByNumber(new AlQuranRequests.AyahByNumberRequest(5));
console.log(ayah.data.text);

const editions = await client.editions(new AlQuranRequests.EditionListRequest(null, "text", "en"));
console.log(editions.data[0]?.identifier);
`

$3

`ts
import { BoycottIsraeliClient, BoycottIsraeliRequests } from "@islamic-network/sdk";

const client = BoycottIsraeliClient.create();

const categories = await client.categories(
new BoycottIsraeliRequests.CategoriesRequest(
new BoycottIsraeliRequests.PaginationOptions({ limit: 5 })
)
);

const companies = await client.search(
new BoycottIsraeliRequests.SearchRequest(
"food",
new BoycottIsraeliRequests.PaginationOptions({ limit: 2 })
)
);

console.log(categories.data[0]?.name);
console.log(companies.data[0]?.name);
`

$3

`ts
import { SermonsClient, SermonsRequests } from "@islamic-network/sdk";

const client = SermonsClient.create();

const sources = await client.sources(new SermonsRequests.SourcesRequest());
const languages = await client.languages(new SermonsRequests.LanguagesRequest());

const months = await client.yearSermons(
new SermonsRequests.YearSermonsRequest("uae-awqaf", 2021, SermonsRequests.SermonType.Friday)
);

const month = await client.monthSermons(
new SermonsRequests.MonthSermonsRequest("uae-awqaf", 2021, 7, SermonsRequests.SermonType.Friday)
);

console.log(sources[0]?.handle);
console.log(languages[0]?.code);
console.log(months[0]?.sermons[0]?.title);
console.log(month.month.number);
`

Configuration

Both clients accept the same options:

`ts
import { AlAdhanClient } from "@islamic-network/sdk";

const client = AlAdhanClient.create({
baseUrl: "https://api.aladhan.com/v1",
defaultHeaders: { "X-App": "my-app" },
defaultQuery: { iso8601: true },
timeoutMs: 10_000,
userAgent: "my-sdk-client",
fetch: globalThis.fetch // optional, provide for custom environments
});
`

Notes

- The SDK uses the global fetch implementation by default. Provide a custom fetch for non-standard environments.
- Prayer timings preserve API field names (e.g., Fajr, Dhuhr, Firstthird).
- Qibla compass requests return binary image data with a content type.
- Integration tests call live API endpoints and retry once on 429 or network errors.

Testing

`bash
npm test
``

Integration tests call the live APIs. When a 429 or timeout occurs, the client retries once after 1 second.