easyoref 1.0.0

package/dist/config.js

@@ -0,0 +1,120 @@
+/**
+ * EasyOref — Centralized Configuration
+ *
+ * Primary: config.yaml (searched in cwd, /app, /etc/easyoref)
+ * Fallback: environment variables + Docker secrets (for backward compat)
+ *
+ * See config.yaml.example for all available options.
+ */
+import yaml from "js-yaml";
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+import { isValidLanguage } from "./i18n.js";
+const VALID_GIF_MODES = [
+    "funny_cats",
+    "assertive",
+    "pikud_haoref",
+    "none",
+];
+const ALL_ALERT_TYPES = ["early", "siren", "incident_over"];
+// ── YAML Loader ──────────────────────────────────────────
+/** Config dir in user home — ~/.easyoref/ */
+export const CONFIG_DIR = join(homedir(), ".easyoref");
+export const HOME_CONFIG_PATH = join(CONFIG_DIR, "config.yaml");
+const CONFIG_SEARCH_PATHS = [
+    HOME_CONFIG_PATH,
+    "config.yaml",
+    "config.yml",
+    "/app/config.yaml",
+    "/etc/easyoref/config.yaml",
+];
+function findConfigFile() {
+    const envPath = process.env.EASYOREF_CONFIG;
+    if (envPath && existsSync(envPath))
+        return envPath;
+    for (const p of CONFIG_SEARCH_PATHS) {
+        const abs = resolve(p);
+        if (existsSync(abs))
+            return abs;
+    }
+    return null;
+}
+function loadYaml() {
+    const path = findConfigFile();
+    if (path) {
+        try {
+            const raw = readFileSync(path, "utf-8");
+            const parsed = yaml.load(raw);
+            // eslint-disable-next-line no-console
+            console.log(`[config] Loaded from ${path}`);
+            return parsed ?? {};
+        }
+        catch (err) {
+            // eslint-disable-next-line no-console
+            console.error(`[config] Failed to parse ${path}:`, err);
+        }
+    }
+    return {};
+}
+// ── Helpers ──────────────────────────────────────────────
+function readSecret(envKey, secretPaths) {
+    for (const p of secretPaths) {
+        if (existsSync(p))
+            return readFileSync(p, "utf-8").trim();
+    }
+    return process.env[envKey] ?? "";
+}
+function parseGifMode(raw) {
+    const lower = raw.toLowerCase();
+    return VALID_GIF_MODES.includes(lower) ? lower : "none";
+}
+function parseAlertTypes(raw) {
+    if (!raw || !Array.isArray(raw))
+        return ALL_ALERT_TYPES;
+    return raw.filter((t) => ALL_ALERT_TYPES.includes(t));
+}
+// ── Build Config ─────────────────────────────────────────
+const yml = loadYaml();
+export const config = {
+    /** Telegram bot token */
+    botToken: yml.telegram?.bot_token ??
+        readSecret("BOT_TOKEN", ["/run/secrets/bot_token", "secrets/bot_token"]),
+    /** Telegram chat ID */
+    chatId: yml.telegram?.chat_id ?? process.env.CHAT_ID ?? "",
+    /** City IDs to monitor (resolved to Hebrew names at startup via cities.json) */
+    cityIds: yml.city_ids ?? [],
+    /**
+     * Hebrew area names — legacy fallback for AREAS env var.
+     * Populated at startup from cityIds OR from AREAS env if no cityIds.
+     */
+    areas: [],
+    /** Which alert types to send */
+    alertTypes: parseAlertTypes(yml.alert_types),
+    /** Message language */
+    language: (() => {
+        const raw = (yml.language ?? process.env.LANGUAGE ?? "ru").toLowerCase();
+        return isValidLanguage(raw) ? raw : "ru";
+    })(),
+    /** Title overrides per alert type */
+    titleOverride: yml.title_override ?? {},
+    /** Description overrides per alert type */
+    descriptionOverride: yml.description_override ?? {},
+    /** Oref API polling interval (ms) */
+    pollIntervalMs: yml.poll_interval_ms ?? Number(process.env.OREF_POLL_INTERVAL_MS ?? "2000"),
+    /** Health endpoint port */
+    healthPort: yml.health_port ?? Number(process.env.HEALTH_PORT ?? "3100"),
+    /** Oref API URL */
+    orefApiUrl: yml.oref_api_url ??
+        process.env.OREF_API_URL ??
+        "https://www.oref.org.il/WarningMessages/alert/alerts.json",
+    /** Better Stack Logtail token */
+    logtailToken: yml.observability?.betterstack_token ?? process.env.LOGTAIL_TOKEN ?? "",
+    /** GIF mode */
+    gifMode: parseGifMode(yml.gif_mode ?? process.env.GIF_MODE ?? "none"),
+    /** Path for persistent data */
+    dataDir: yml.data_dir ?? process.env.DATA_DIR ?? join(CONFIG_DIR, "data"),
+};
+/** Exported for testing */
+export { loadYaml as _loadYaml, parseAlertTypes as _parseAlertTypes, };
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/gif-state.d.ts

@@ -0,0 +1,17 @@
+/**
+ * EasyOref — Persistent GIF Rotation State
+ *
+ * Stores which GIFs have been shown to avoid repeats.
+ * State survives restarts + redeploys via JSON file.
+ */
+/**
+ * Initialize persistent GIF state.
+ * @param dataDir — directory for state file (created if missing)
+ */
+export declare function initGifState(dataDir: string): void;
+/**
+ * Pick a GIF from a pool without repeats.
+ * When all GIFs in the pool have been shown, reshuffles.
+ */
+export declare function pickGif(pool: string[], poolKey: string): string;
+//# sourceMappingURL=gif-state.d.ts.map

package/dist/gif-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gif-state.d.ts","sourceRoot":"","sources":["../src/gif-state.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CA4BlD;AAWD;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAS/D"}

package/dist/gif-state.js

@@ -0,0 +1,67 @@
+/**
+ * EasyOref — Persistent GIF Rotation State
+ *
+ * Stores which GIFs have been shown to avoid repeats.
+ * State survives restarts + redeploys via JSON file.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import * as logger from "./logger.js";
+let gifBags = {};
+let stateFilePath = "";
+/**
+ * Initialize persistent GIF state.
+ * @param dataDir — directory for state file (created if missing)
+ */
+export function initGifState(dataDir) {
+    stateFilePath = join(dataDir, "gif-state.json");
+    try {
+        mkdirSync(dataDir, { recursive: true });
+    }
+    catch {
+        // dir may already exist
+    }
+    if (existsSync(stateFilePath)) {
+        try {
+            const raw = readFileSync(stateFilePath, "utf-8");
+            const parsed = JSON.parse(raw);
+            if (parsed.version === 1 && parsed.bags) {
+                gifBags = parsed.bags;
+                logger.info("GIF state loaded", {
+                    pools: Object.keys(gifBags).length,
+                    path: stateFilePath,
+                });
+                return;
+            }
+        }
+        catch {
+            logger.warn("Corrupt gif-state.json — starting fresh");
+        }
+    }
+    gifBags = {};
+    persist();
+}
+function persist() {
+    try {
+        const state = { version: 1, bags: gifBags };
+        writeFileSync(stateFilePath, JSON.stringify(state, null, 2), "utf-8");
+    }
+    catch (err) {
+        logger.warn("Failed to persist GIF state", { error: String(err) });
+    }
+}
+/**
+ * Pick a GIF from a pool without repeats.
+ * When all GIFs in the pool have been shown, reshuffles.
+ */
+export function pickGif(pool, poolKey) {
+    let bag = gifBags[poolKey];
+    if (!bag || bag.length === 0) {
+        bag = [...pool].sort(() => Math.random() - 0.5);
+        gifBags[poolKey] = bag;
+    }
+    const gif = bag.pop();
+    persist();
+    return gif;
+}
+//# sourceMappingURL=gif-state.js.map

package/dist/gif-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gif-state.js","sourceRoot":"","sources":["../src/gif-state.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAWtC,IAAI,OAAO,GAAY,EAAE,CAAC;AAC1B,IAAI,aAAa,GAAG,EAAE,CAAC;AAEvB;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,aAAa,GAAG,IAAI,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;IAEhD,IAAI,CAAC;QACH,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,wBAAwB;IAC1B,CAAC;IAED,IAAI,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;YACjD,MAAM,MAAM,GAAiB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAiB,CAAC;YAC7D,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;gBACxC,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC;gBACtB,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE;oBAC9B,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM;oBAClC,IAAI,EAAE,aAAa;iBACpB,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAED,OAAO,GAAG,EAAE,CAAC;IACb,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,OAAO;IACd,IAAI,CAAC;QACH,MAAM,KAAK,GAAiB,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QAC1D,aAAa,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACxE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CAAC,6BAA6B,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACrE,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,IAAc,EAAE,OAAe;IACrD,IAAI,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC;QAChD,OAAO,CAAC,OAAO,CAAC,GAAG,GAAG,CAAC;IACzB,CAAC;IACD,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,EAAG,CAAC;IACvB,OAAO,EAAE,CAAC;IACV,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/i18n.d.ts

@@ -0,0 +1,37 @@
+/**
+ * EasyOref — Internationalization (i18n)
+ *
+ * Supported languages: Russian (ru), English (en), Hebrew (he), Arabic (ar)
+ * Default: ru (built for diaspora families)
+ *
+ * Message format:
+ *   <b>🚀 Title</b>
+ *   Description
+ *   <blockquote>
+ *   <b>Key:</b> Value
+ *   ...
+ *   </blockquote>
+ */
+export type Language = "ru" | "en" | "he" | "ar";
+export interface MessageTemplates {
+    earlyWarning: (areas: string, time: string) => string;
+    siren: (areas: string, time: string) => string;
+    resolved: (areas: string) => string;
+}
+/**
+ * Load and cache translations from pikud-haoref-api.
+ * Must be called once at startup (before first alert).
+ * Falls back silently to Hebrew names on fetch failure.
+ */
+export declare function initTranslations(): Promise<void>;
+/** Translate comma-separated Hebrew area names to target language */
+export declare function translateAreas(areas: string, lang: Language): string;
+/**
+ * Resolve numeric city IDs to Hebrew area names.
+ * Call AFTER initTranslations().
+ * Unknown IDs are logged as warnings and skipped.
+ */
+export declare function resolveCityIds(ids: number[]): string[];
+export declare function getTemplates(lang: Language): MessageTemplates;
+export declare function isValidLanguage(s: string): s is Language;
+//# sourceMappingURL=i18n.d.ts.map

package/dist/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEjD,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACtD,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC/C,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CACrC;AA+LD;;;;GAIG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAoCtD;AAED,qEAAqE;AACrE,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,CAapE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAYtD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,gBAAgB,CAE7D;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,IAAI,QAAQ,CAExD"}

package/dist/i18n.js

@@ -0,0 +1,240 @@
+/**
+ * EasyOref — Internationalization (i18n)
+ *
+ * Supported languages: Russian (ru), English (en), Hebrew (he), Arabic (ar)
+ * Default: ru (built for diaspora families)
+ *
+ * Message format:
+ *   <b>🚀 Title</b>
+ *   Description
+ *   <blockquote>
+ *   <b>Key:</b> Value
+ *   ...
+ *   </blockquote>
+ */
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+// Message Templates — HTML with blockquote
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+const ru = {
+    earlyWarning: (areas, time) => [
+        "<b>🚀 Раннее предупреждение</b>",
+        "Зафиксированы запуски ракет. Находитесь рядом с защищённым помещением.",
+        "",
+        "<blockquote>",
+        `<b>Район:</b> ${areas}`,
+        `<b>Подлётное время:</b> ~5–12 мин`,
+        `<b>Время:</b> ${time}`,
+        "</blockquote>",
+    ].join("\n"),
+    siren: (areas, time) => [
+        "<b>🚨 Сирена</b>",
+        "Войдите в защищённое помещение.",
+        "",
+        "<blockquote>",
+        `<b>Район:</b> ${areas}`,
+        `<b>Подлётное время:</b> ~1.5 мин`,
+        `<b>Время:</b> ${time}`,
+        "</blockquote>",
+    ].join("\n"),
+    resolved: (areas) => [
+        "<b>😮‍💨 Инцидент завершён</b>",
+        "Можно покинуть защищённое помещение.",
+        "",
+        "<blockquote>",
+        `<b>Район:</b> ${areas}`,
+        "</blockquote>",
+    ].join("\n"),
+};
+const en = {
+    earlyWarning: (areas, time) => [
+        "<b>🚀 Early Warning</b>",
+        "Rocket launches detected. Stay near a protected space.",
+        "",
+        "<blockquote>",
+        `<b>Area:</b> ${areas}`,
+        `<b>Time to impact:</b> ~5–12 min`,
+        `<b>Time:</b> ${time}`,
+        "</blockquote>",
+    ].join("\n"),
+    siren: (areas, time) => [
+        "<b>🚨 Siren Alert</b>",
+        "Enter a protected space immediately.",
+        "",
+        "<blockquote>",
+        `<b>Area:</b> ${areas}`,
+        `<b>Time to impact:</b> ~1.5 min`,
+        `<b>Time:</b> ${time}`,
+        "</blockquote>",
+    ].join("\n"),
+    resolved: (areas) => [
+        "<b>😮‍💨 Incident Over</b>",
+        "You may leave the protected space.",
+        "",
+        "<blockquote>",
+        `<b>Area:</b> ${areas}`,
+        "</blockquote>",
+    ].join("\n"),
+};
+const he = {
+    earlyWarning: (areas, time) => [
+        "<b>🚀 התרעה מוקדמת</b>",
+        "זוהו שיגורים. הישארו בקרבת מרחב מוגן.",
+        "",
+        "<blockquote>",
+        `<b>אזור:</b> ${areas}`,
+        `<b>זמן מעוף:</b> ~5–12 דקות`,
+        `<b>שעה:</b> ${time}`,
+        "</blockquote>",
+    ].join("\n"),
+    siren: (areas, time) => [
+        "<b>🚨 צבע אדום</b>",
+        "היכנסו למרחב מוגן.",
+        "",
+        "<blockquote>",
+        `<b>אזור:</b> ${areas}`,
+        `<b>זמן מעוף:</b> ~1.5 דקות`,
+        `<b>שעה:</b> ${time}`,
+        "</blockquote>",
+    ].join("\n"),
+    resolved: (areas) => [
+        "<b>😮‍💨 האירוע הסתיים</b>",
+        "ניתן לצאת מהמרחב המוגן.",
+        "",
+        "<blockquote>",
+        `<b>אזור:</b> ${areas}`,
+        "</blockquote>",
+    ].join("\n"),
+};
+const ar = {
+    earlyWarning: (areas, time) => [
+        "<b>🚀 إنذار مبكر</b>",
+        "تم رصد إطلاق صواريخ. ابقوا بالقرب من الملجأ.",
+        "",
+        "<blockquote>",
+        `<b>المنطقة:</b> ${areas}`,
+        `<b>وقت الوصول:</b> ~5–12 دقيقة`,
+        `<b>الوقت:</b> ${time}`,
+        "</blockquote>",
+    ].join("\n"),
+    siren: (areas, time) => [
+        "<b>🚨 صفارة إنذار</b>",
+        "ادخلوا إلى الملجأ فوراً.",
+        "",
+        "<blockquote>",
+        `<b>المنطقة:</b> ${areas}`,
+        `<b>وقت الوصول:</b> ~1.5 دقيقة`,
+        `<b>الوقت:</b> ${time}`,
+        "</blockquote>",
+    ].join("\n"),
+    resolved: (areas) => [
+        "<b>😮‍💨 انتهى الحادث</b>",
+        "يمكنكم مغادرة الملجأ.",
+        "",
+        "<blockquote>",
+        `<b>المنطقة:</b> ${areas}`,
+        "</blockquote>",
+    ].join("\n"),
+};
+const templates = { ru, en, he, ar };
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+// Area Name Translation — loaded from pikud-haoref-api/cities.json
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+const CITIES_JSON_URL = "https://raw.githubusercontent.com/eladnava/pikud-haoref-api/master/cities.json";
+/** Hebrew city name → { en, ru, ar } */
+const cityMap = new Map();
+/** Hebrew zone name → { en, ru, ar } */
+const zoneMap = new Map();
+/** City ID → Hebrew name (for YAML city_ids resolution) */
+const idToNameMap = new Map();
+/**
+ * Known bad translations in upstream cities.json.
+ * Applied as post-processing corrections after loading.
+ * Key: Hebrew name, Value: { lang: corrected_name }
+ */
+const TRANSLATION_FIXES = {
+    "תל אביב - דרום העיר ויפו": {
+        ru: "Тель-Авив — Южный район и Яффо",
+    },
+};
+/**
+ * Load and cache translations from pikud-haoref-api.
+ * Must be called once at startup (before first alert).
+ * Falls back silently to Hebrew names on fetch failure.
+ */
+export async function initTranslations() {
+    try {
+        const res = await fetch(CITIES_JSON_URL);
+        if (!res.ok)
+            throw new Error(`HTTP ${res.status}`);
+        const data = (await res.json());
+        for (const c of data) {
+            if (!c.name || c.name === "בחר הכל")
+                continue;
+            cityMap.set(c.name, { en: c.name_en, ru: c.name_ru, ar: c.name_ar });
+            if (c.id)
+                idToNameMap.set(c.id, c.name);
+            if (c.zone && !zoneMap.has(c.zone)) {
+                zoneMap.set(c.zone, { en: c.zone_en, ru: c.zone_ru, ar: c.zone_ar });
+            }
+        }
+        // Apply known corrections over upstream data
+        for (const [heName, fixes] of Object.entries(TRANSLATION_FIXES)) {
+            const existing = cityMap.get(heName);
+            if (existing) {
+                for (const [lang, corrected] of Object.entries(fixes)) {
+                    existing[lang] = corrected;
+                }
+            }
+        }
+        // eslint-disable-next-line no-console
+        console.log(`[i18n] Loaded ${cityMap.size} city + ${zoneMap.size} zone translations`);
+    }
+    catch (err) {
+        // eslint-disable-next-line no-console
+        console.warn("[i18n] Failed to load cities.json — area names will stay in Hebrew", err);
+    }
+}
+/** Translate comma-separated Hebrew area names to target language */
+export function translateAreas(areas, lang) {
+    if (lang === "he")
+        return areas;
+    const key = lang;
+    return areas
+        .split(", ")
+        .map((a) => {
+        const city = cityMap.get(a);
+        if (city?.[key])
+            return city[key];
+        const zone = zoneMap.get(a);
+        if (zone?.[key])
+            return zone[key];
+        return a; // fallback: Hebrew as-is
+    })
+        .join(", ");
+}
+/**
+ * Resolve numeric city IDs to Hebrew area names.
+ * Call AFTER initTranslations().
+ * Unknown IDs are logged as warnings and skipped.
+ */
+export function resolveCityIds(ids) {
+    const names = [];
+    for (const id of ids) {
+        const name = idToNameMap.get(id);
+        if (name) {
+            names.push(name);
+        }
+        else {
+            // eslint-disable-next-line no-console
+            console.warn(`[i18n] Unknown city ID: ${id} — skipping`);
+        }
+    }
+    return names;
+}
+export function getTemplates(lang) {
+    return templates[lang] ?? templates.ru;
+}
+export function isValidLanguage(s) {
+    return s === "ru" || s === "en" || s === "he" || s === "ar";
+}
+//# sourceMappingURL=i18n.js.map

package/dist/i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"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"}

package/dist/init.d.ts

@@ -0,0 +1,7 @@
+/**
+ * `npx easyoref init` — Interactive setup wizard.
+ *
+ * Asks 4 questions, writes ~/.easyoref/config.yaml.
+ */
+export declare function init(): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAsF1C"}