mirror of
https://github.com/zadam/trilium.git
synced 2026-09-14 11:06:04 +05:00
768bc3946e
`getLanguageStats()` returned the first response page, so anything past it was invisible to both callers. The coverage gate would pass by never seeing the languages it was meant to catch, and the README language bar would quietly drop them. Weblate serves 50 translations per page and each component is at 40, so the current lists are complete and nothing was missed. That is ten languages of headroom, and a language appears whenever someone starts translating one. Follow `next` until it runs out, and report the count actually read. A non-OK response now names the URL rather than surfacing as a JSON parse error on the error body. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
75 lines
2.5 KiB
TypeScript
75 lines
2.5 KiB
TypeScript
import { readFile, stat,writeFile } from "fs/promises";
|
|
import { join } from "path";
|
|
|
|
const scriptDir = __dirname;
|
|
|
|
/** The Weblate components under https://hosted.weblate.org/projects/trilium/ that are gated. */
|
|
export type WeblateProject = "readme" | "client" | "website";
|
|
|
|
/** How long a `.language-stats-*.json` cache file is reused before Weblate is queried again. */
|
|
export const CACHE_MAX_AGE_MS = 24 * 60 * 60 * 1000;
|
|
|
|
export async function getLanguageStats(project: WeblateProject) {
|
|
const cacheFile = join(scriptDir, `.language-stats-${project}.json`);
|
|
|
|
// Try to read from the cache.
|
|
try {
|
|
const cacheStats = await stat(cacheFile);
|
|
if (isCacheFresh(cacheStats.mtimeMs, Date.now())) {
|
|
console.log("Reading language stats from cache.");
|
|
return JSON.parse(await readFile(cacheFile, "utf-8"));
|
|
}
|
|
} catch (e) {
|
|
if (!(e && typeof e === "object" && "code" in e && e.code === "ENOENT")) {
|
|
throw e;
|
|
}
|
|
}
|
|
|
|
// Make the request
|
|
console.log("Reading language stats from Weblate API.");
|
|
const stats = await fetchAllPages(
|
|
`https://hosted.weblate.org/api/components/trilium/${project}/translations/`);
|
|
|
|
// Update the cache
|
|
await writeFile(cacheFile, JSON.stringify(stats, null, 4));
|
|
|
|
return stats;
|
|
}
|
|
|
|
/**
|
|
* Reads every page of a paginated Weblate endpoint into a single `results` array.
|
|
*
|
|
* The API serves 50 entries per page. Each component is already at 40 languages, so a
|
|
* caller reading only the first response would start losing languages once translators
|
|
* pick up ten more, and the coverage gate would pass by never seeing them.
|
|
*/
|
|
export async function fetchAllPages(firstPageUrl: string) {
|
|
const results: unknown[] = [];
|
|
let url: string | null = firstPageUrl;
|
|
|
|
while (url) {
|
|
const response = await fetch(url);
|
|
if (!response.ok) {
|
|
throw new Error(
|
|
`Weblate answered ${response.status} ${response.statusText} for ${url}.`);
|
|
}
|
|
|
|
const page = await response.json();
|
|
results.push(...page.results);
|
|
url = page.next;
|
|
}
|
|
|
|
return { count: results.length, results };
|
|
}
|
|
|
|
/**
|
|
* Determines whether a cache file written at `mtimeMs` can still be used at `nowMs`.
|
|
*
|
|
* A file stamped in the future is treated as stale, so a bad clock or a copied timestamp
|
|
* cannot pin the cache to a snapshot that never expires.
|
|
*/
|
|
export function isCacheFresh(mtimeMs: number, nowMs: number) {
|
|
const age = nowMs - mtimeMs;
|
|
return age >= 0 && age < CACHE_MAX_AGE_MS;
|
|
}
|