suwayomi-material-you-webui/tools/scripts/weblate/Weblate.utils.ts

/*
 * Copyright (C) Contributors to the Suwayomi project
 *
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at https://mozilla.org/MPL/2.0/.
 */

import type {
    WeblateChangePayload,
    WeblateChangeResult,
    WeblateLanguagePayload,
    WeblateLanguageStatistic,
    WeblateUserPayload,
} from '@/../tools/scripts/weblate/Weblate.types.ts';
import 'dotenv/config';
import { TRANSLATED_PERCENT_THRESHOLD } from '@/../tools/scripts/weblate/Weblate.constants.ts';

export const fetchData = async <T = any>(url: string): Promise<T> => {
    const response = await fetch(url, {
        method: 'GET',
        headers: {
            ...(process.env.WEBLATE_TOKEN ? { Authorization: `Token ${process.env.WEBLATE_TOKEN}` } : {}),
            Accept: 'application/json',
        },
    });

    if (!response.ok) {
        throw new Error(`Weblate request failed with status ${response.status} - ${response.statusText}`);
    }

    return response.json();
};

export const fetchWeblateChanges = async (
    url: string,
    weblateChangeResults: WeblateChangeResult[] = [],
): Promise<WeblateChangeResult[]> => {
    const weblateChangePage = await fetchData<WeblateChangePayload>(url);

    if (!weblateChangePage.next) {
        return [...weblateChangePage.results, ...weblateChangeResults];
    }

    return fetchWeblateChanges(weblateChangePage.next, [...weblateChangePage.results, ...weblateChangeResults]);
};

export const getUsername = async (url: string): Promise<string> => {
    const userPayload = await fetchData<WeblateUserPayload>(url);
    return userPayload.full_name;
};

export const getLanguageName = async (url: string): Promise<string> => {
    const languagePayload = await fetchData<WeblateLanguagePayload>(url);
    return languagePayload.language.name.replaceAll(/\(([a-zA-Z]+) Han script\)/g, '($1)');
};

export const fetchWeblateLanguageStats = async () =>
    fetchData('https://hosted.weblate.org/api/components/suwayomi/suwayomi-webui/statistics/?format=json-flat');

const dateRegex = /[0-9]{4}-[0-9]{2}-[0-9]{2}/g;
const isValidIS08601Date = (date: string): boolean => !!date.match(dateRegex);
export const validateWeblateDates = (afterDate: string, beforeDate: string) => {
    if (!isValidIS08601Date(afterDate) || !isValidIS08601Date(beforeDate)) {
        throw new Error(
            `The passed timestamps are not properly formatted. They have to match "${dateRegex}" (e.g. 2024-05-11)`,
        );
    }
};

export const normalizeCode = (code: string): string => code.replaceAll(/[-_]/g, '');

export const getWeblateLanguageStatsFor = (
    code: string,
    stats: WeblateLanguageStatistic[],
): WeblateLanguageStatistic => {
    const langaugeStats = stats.find((stat) => normalizeCode(stat.code) === normalizeCode(code));

    if (!langaugeStats) {
        throw new Error(`Weblate language stats for "${code}" do not exist`);
    }

    return langaugeStats;
};

export const meetsTranslatedPercentThreshold = (
    translatedPercent: number,
    threshold: number = TRANSLATED_PERCENT_THRESHOLD,
): boolean => translatedPercent >= threshold;