Files
suwayomi-material-you-webui/tools/scripts/weblate/Weblate.utils.ts
2025-08-02 23:14:21 +02:00

90 lines
3.1 KiB
TypeScript

/*
* 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 {
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.replace(/\(([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.replace(/[-_]/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;