@max-xoo/mawaqit 1.0.0

package/dist/cache.js

@@ -0,0 +1,44 @@
+const cache = new Map();
+
+function getMsUntilMidnight() {
+    const midnight = new Date();
+    midnight.setHours(24, 0, 0, 0);
+    return midnight.getTime() - Date.now();
+}
+
+function getFromCache(key) {
+    const entry = cache.get(key);
+    if (!entry) return null;
+    if (Date.now() > entry.expiresAt) {
+        cache.delete(key);
+        return null;
+    }
+    return entry.data;
+}
+
+function setToCache(key, data) {
+    cache.set(key, {
+        data,
+        expiresAt: Date.now() + getMsUntilMidnight(),
+    });
+}
+
+function clearCache() {
+    cache.clear();
+}
+
+function deleteCacheEntry(key) {
+    cache.delete(key);
+}
+
+function getCacheSize() {
+    return cache.size;
+}
+
+module.exports = {
+    getFromCache,
+    setToCache,
+    clearCache,
+    deleteCacheEntry,
+    getCacheSize,
+};

package/dist/errors.js

@@ -0,0 +1,43 @@
+class MawaqitError extends Error {
+    constructor(message, statusCode) {
+        super(message);
+        this.name = "MawaqitError";
+        this.statusCode = statusCode;
+    }
+}
+
+class MawaqitNotFoundError extends MawaqitError {
+    constructor(masjidId) {
+        super(`Mosque "${masjidId}" not found`, 404);
+        this.name = "MawaqitNotFoundError";
+    }
+}
+
+class MawaqitParseError extends MawaqitError {
+    constructor(masjidId) {
+        super(`Failed to parse prayer data for "${masjidId}"`, 500);
+        this.name = "MawaqitParseError";
+    }
+}
+
+class MawaqitFetchError extends MawaqitError {
+    constructor(url) {
+        super(`Something went wrong fetching "${url}"`, 502);
+        this.name = "MawaqitFetchError";
+    }
+}
+
+class MawaqitValidationError extends MawaqitError {
+    constructor(message) {
+        super(message, 400);
+        this.name = "MawaqitValidationError";
+    }
+}
+
+module.exports = {
+    MawaqitError,
+    MawaqitNotFoundError,
+    MawaqitParseError,
+    MawaqitFetchError,
+    MawaqitValidationError,
+};

package/dist/fetch.js

@@ -0,0 +1,64 @@
+const axios = require("axios");
+
+const {
+    load
+} = require("cheerio");
+const {
+    getFromCache,
+    setToCache
+} = require("./cache");
+
+const {
+    MawaqitNotFoundError,
+    MawaqitParseError,
+    MawaqitFetchError,
+} = require("./errors");
+
+const CONF_DATA_REGEX = /(?:var|let)\s+confData\s*=\s*(.*?);/s;
+
+async function fetchMawaqit(masjidId) {
+    const cached = getFromCache(masjidId);
+    if (cached) {
+        return cached;
+    }
+
+    const url = `https://mawaqit.net/fr/${masjidId}`;
+    let response;
+
+    try {
+        response = await axios.get(url);
+    } catch (err) {
+        const status = err.response?.status;
+        if (status === 404) throw new MawaqitNotFoundError(masjidId);
+        throw new MawaqitFetchError(url);
+    }
+
+    const $ = load(response.data);
+    let confData = null;
+
+    $("script").each((_, el) => {
+        if (confData) return; // already found
+        const content = $(el).html();
+        if (content && CONF_DATA_REGEX.test(content)) {
+            const match = content.match(CONF_DATA_REGEX);
+            if (match) {
+                try {
+                    confData = JSON.parse(match[1]);
+                } catch {
+                    throw new MawaqitParseError(masjidId);
+                }
+            }
+        }
+    });
+
+    if (!confData) {
+        throw new MawaqitParseError(masjidId);
+    }
+
+    setToCache(masjidId, confData);
+    return confData;
+}
+
+module.exports = {
+    fetchMawaqit
+};

package/dist/index.js

@@ -0,0 +1,48 @@
+const {
+    fetchMawaqit
+} = require("./fetch");
+
+const {
+    getPrayerTimesOfTheDay,
+    getCalendar,
+    getMonth,
+    getMonthIqama,
+    getAnnouncements,
+    getServices,
+} = require("./mawaqit");
+
+const {
+    clearCache,
+    deleteCacheEntry,
+    getCacheSize,
+} = require("./cache");
+
+const {
+    MawaqitError,
+    MawaqitNotFoundError,
+    MawaqitParseError,
+    MawaqitFetchError,
+    MawaqitValidationError,
+} = require("./errors");
+
+module.exports = {
+    fetchMawaqit,
+
+    getPrayerTimesOfTheDay,
+    getCalendar,
+    getMonth,
+    getMonthIqama,
+
+    getAnnouncements,
+    getServices,
+
+    clearCache,
+    deleteCacheEntry,
+    getCacheSize,
+
+    MawaqitError,
+    MawaqitNotFoundError,
+    MawaqitParseError,
+    MawaqitFetchError,
+    MawaqitValidationError,
+};

package/dist/mawaqit.js

@@ -0,0 +1,93 @@
+const {
+    fetchMawaqit
+} = require("./fetch");
+const {
+    MawaqitValidationError
+} = require("./errors");
+
+async function getPrayerTimesOfTheDay(masjidId) {
+    const {
+        times,
+        shuruq
+    } = await fetchMawaqit(masjidId);
+    return {
+        fajr: times[0],
+        sunrise: shuruq,
+        dohr: times[1],
+        asr: times[2],
+        maghreb: times[3],
+        icha: times[4],
+    };
+}
+
+async function getCalendar(masjidId) {
+    const {
+        calendar
+    } = await fetchMawaqit(masjidId);
+    return calendar;
+}
+
+async function getMonth(masjidId, monthNumber) {
+    if (monthNumber < 1 || monthNumber > 12) {
+        throw new MawaqitValidationError("Month number should be between 1 and 12");
+    }
+    const {
+        calendar
+    } = await fetchMawaqit(masjidId);
+    const month = calendar[monthNumber - 1];
+    return Object.values(month).map((prayer) => ({
+        fajr: prayer[0],
+        sunrise: prayer[1],
+        dohr: prayer[2],
+        asr: prayer[3],
+        maghreb: prayer[4],
+        icha: prayer[5],
+    }));
+}
+
+async function getMonthIqama(masjidId, monthNumber) {
+    if (monthNumber < 1 || monthNumber > 12) {
+        throw new MawaqitValidationError("Month number should be between 1 and 12");
+    }
+    const {
+        iqamaCalendar
+    } = await fetchMawaqit(masjidId);
+    const month = iqamaCalendar[monthNumber - 1];
+    return Object.values(month).map((iqama) => ({
+        fajr: iqama[0],
+        dohr: iqama[1],
+        asr: iqama[2],
+        maghreb: iqama[3],
+        icha: iqama[4],
+    }));
+}
+
+async function getAnnouncements(masjidId) {
+    const {
+        announcements
+    } = await fetchMawaqit(masjidId);
+    return announcements ?? [];
+}
+
+async function getServices(masjidId) {
+    const confData = await fetchMawaqit(masjidId);
+    return {
+        name: confData.name,
+        label: confData.label,
+        localisation: confData.localisation,
+        phone: confData.phone,
+        email: confData.email,
+        site: confData.site,
+        mosqueeType: confData.mosqueeType,
+        association: confData.association,
+    };
+}
+
+module.exports = {
+    getPrayerTimesOfTheDay,
+    getCalendar,
+    getMonth,
+    getMonthIqama,
+    getAnnouncements,
+    getServices,
+};

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@max-xoo/mawaqit",
+  "version": "1.0.0",
+  "description": "A JavaScript wrapper around the unofficial Mawaqit API",
+  "keywords": [
+    "mawaqit",
+    "prayer",
+    "islam",
+    "mosque",
+    "salat",
+    "quran"
+  ],
+  "homepage": "https://github.com/roimee6/mawaqit#readme",
+  "bugs": {
+    "url": "https://github.com/roimee6/mawaqit/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/roimee6/mawaqit.git"
+  },
+  "license": "MIT",
+  "author": "Maxence",
+  "main": "dist/index.js",
+  "files": [
+    "dist/**/*"
+  ],
+  "scripts": {
+    "test": "node test.cjs"
+  },
+  "dependencies": {
+    "axios": "^1.13.5",
+    "cheerio": "^1.2.0"
+  },
+  "devDependencies": {}
+}