@lycoristech/azurdata 0.0.1

package/dist/cjs/translate/enums.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FLEET_TECH_STAT_MAP = exports.STAT_INDEX_TO_FIELD = exports.SKILL_COLOR_MAP = exports.NATIONALITY_MAP = exports.RARITY_MAP = void 0;
+exports.rarityName = rarityName;
+exports.nationalityName = nationalityName;
+exports.skillColor = skillColor;
+// ---------------------------------------------------------------------------
+// Rarity
+// ---------------------------------------------------------------------------
+/** Maps integer rarity → AzurAPI rarity string */
+exports.RARITY_MAP = {
+    1: "Normal",
+    2: "Normal",
+    3: "Rare",
+    4: "Elite",
+    5: "Super Rare",
+    6: "Ultra Rare",
+};
+/**
+ * Resolve a rarity integer to its display string.
+ *
+ * Rules:
+ *   - int === 6 && isResearch && blueprintVersion >= 6  → "Decisive"
+ *   - int === 6 && isResearch                            → "Priority"
+ *   - else                                               → RARITY_MAP[int] || "Normal"
+ */
+function rarityName(rarity, isResearch, blueprintVersion) {
+    if (rarity === 6 && isResearch) {
+        if (blueprintVersion !== undefined && blueprintVersion >= 6) {
+            return "Decisive";
+        }
+        return "Priority";
+    }
+    return exports.RARITY_MAP[rarity] ?? "Normal";
+}
+// ---------------------------------------------------------------------------
+// Nationality
+// ---------------------------------------------------------------------------
+/** Nationality int → display string. Matches Azur Lane wiki convention. */
+exports.NATIONALITY_MAP = {
+    0: "Universal",
+    1: "Eagle Union",
+    2: "Royal Navy",
+    3: "Sakura Empire",
+    4: "Iron Blood",
+    5: "Dragon Empery",
+    6: "Sardegna Empire",
+    7: "Northern Parliament",
+    8: "Iris Libre",
+    9: "Vichya Dominion",
+    10: "Iris Orthodoxy",
+    11: "Kingdom of Tulipa",
+    96: "Universal",
+    97: "Tempesta",
+    98: "Universal",
+    101: "META",
+    102: "Universal",
+    103: "Universal",
+    104: "Universal",
+    105: "Neptunia",
+    106: "KizunaAI",
+    107: "Hololive",
+    108: "Venus Vacation",
+    109: "The Idolmaster",
+    110: "SSSS",
+    111: "Atelier Ryza",
+    112: "Senran Kagura",
+};
+/** Look up a nationality code; falls back to "Universal". */
+function nationalityName(code) {
+    return exports.NATIONALITY_MAP[code] ?? "Universal";
+}
+// ---------------------------------------------------------------------------
+// Skill color
+// ---------------------------------------------------------------------------
+/**
+ * Skill type int → AzurAPI color.
+ * 1 = offensive (yellow), 2 = support (pink), 3 = defensive (blue), 0 = unset (pink).
+ */
+exports.SKILL_COLOR_MAP = {
+    0: "pink",
+    1: "yellow",
+    2: "pink",
+    3: "blue",
+};
+/** Look up a skill type color; falls back to "pink". */
+function skillColor(type) {
+    return exports.SKILL_COLOR_MAP[type] ?? "pink";
+}
+// ---------------------------------------------------------------------------
+// Stat index map
+// ---------------------------------------------------------------------------
+/**
+ * Stat index (0..11) → AzurAPI stat field name (on StatBlock).
+ * Only the 10 exposed stats. armor (6) and antisub (11) are intentionally missing.
+ */
+exports.STAT_INDEX_TO_FIELD = {
+    0: "health",
+    1: "firepower",
+    2: "torpedo",
+    3: "antiwar", // AA — keep AzurAPI typo
+    4: "aviation",
+    5: "reload",
+    6: undefined, // armor — not in StatBlock
+    7: "accuracy",
+    8: "evasion",
+    9: "speed",
+    10: "luck",
+    11: undefined, // antisub — not in StatBlock
+};
+// ---------------------------------------------------------------------------
+// Fleet-tech stat map
+// ---------------------------------------------------------------------------
+/**
+ * Fleet-tech attribute id → display name.
+ * From attribute_info_by_type.json, but hard-coded to avoid a data lookup per ship.
+ */
+exports.FLEET_TECH_STAT_MAP = {
+    1: "health",
+    2: "firepower",
+    3: "torpedo",
+    4: "antiaircraft",
+    5: "aviation",
+    6: "reload",
+    7: "armor",
+    8: "accuracy",
+    9: "evasion",
+    10: "speed",
+    11: "luck",
+    12: "antisub",
+};

package/dist/cjs/translate/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./enums.js"), exports);
+__exportStar(require("./lookups.js"), exports);
+__exportStar(require("./strings.js"), exports);

package/dist/cjs/translate/lookups.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLookups = createLookups;
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/** Build a Lookups helper from the raw upstream tables. */
+function createLookups(inputs) {
+    const { fleetTechShipTemplate, fleetTechShipClass, shipDataByType, equipDataByType, skillDataTemplate, skillDataDisplay, voiceActorCn, } = inputs;
+    // Pre-build a code→name map for voice actors (keyed by `code` field value, not the record key)
+    const voiceActorByCode = new Map();
+    for (const entry of Object.values(voiceActorCn)) {
+        if (entry.code !== undefined && entry.actor_name !== undefined) {
+            voiceActorByCode.set(entry.code, entry.actor_name);
+        }
+    }
+    return {
+        classNameFor(groupType, fallbackFromTagList) {
+            const techEntry = fleetTechShipTemplate[groupType];
+            if (techEntry !== undefined) {
+                const classId = String(techEntry.class);
+                const classEntry = fleetTechShipClass[classId];
+                if (classEntry !== undefined) {
+                    return classEntry.name;
+                }
+            }
+            return fallbackFromTagList ?? "Unknown";
+        },
+        hullTypeName(typeId) {
+            const entry = shipDataByType[String(typeId)];
+            return entry?.type_name ?? "Unknown";
+        },
+        equipTypeName(typeId) {
+            const entry = equipDataByType[String(typeId)];
+            if (entry === undefined)
+                return "Unknown";
+            return entry.type_name2 ?? entry.type_name ?? "Unknown";
+        },
+        skillName(id) {
+            const key = String(id);
+            const templateEntry = skillDataTemplate[key];
+            if (templateEntry?.name !== undefined) {
+                return templateEntry.name;
+            }
+            const displayEntry = skillDataDisplay[key];
+            if (displayEntry?.name !== undefined) {
+                return displayEntry.name;
+            }
+            return `Skill ${id}`;
+        },
+        voiceActorName(code) {
+            // Try the pre-built code→name map first (keyed by the `code` field in each record)
+            const byCode = voiceActorByCode.get(code);
+            if (byCode !== undefined)
+                return byCode;
+            // Also try looking up by record key directly (some files key by code number)
+            const entry = voiceActorCn[String(code)];
+            if (entry?.actor_name !== undefined)
+                return entry.actor_name;
+            return "Unknown";
+        },
+    };
+}

package/dist/cjs/translate/strings.js

@@ -0,0 +1,98 @@
+"use strict";
+// ---------------------------------------------------------------------------
+// Placeholder substitution
+// ---------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.substitutePlaceholders = substitutePlaceholders;
+exports.extractMaxLevelSubstitutions = extractMaxLevelSubstitutions;
+exports.starsString = starsString;
+exports.wikiUrlFor = wikiUrlFor;
+exports.splitLimitBreakBonuses = splitLimitBreakBonuses;
+/**
+ * Format a raw skill description by substituting $1, $2, ... placeholders.
+ *
+ * @example
+ *   substitutePlaceholders("Increases DMG by $1 and AoE by $2.", ["25.0%", "3.0%"])
+ *   // → "Increases DMG by 25.0% and AoE by 3.0%."
+ */
+function substitutePlaceholders(raw, substitutions) {
+    return raw.replace(/\$(\d+)/g, (_match, indexStr) => {
+        const idx = parseInt(indexStr, 10) - 1; // convert 1-based to 0-based
+        return substitutions[idx] ?? _match;
+    });
+}
+/**
+ * Extract the max-rank substitution value from a skill's desc_add array.
+ *
+ * The true shape of desc_add is `Array<Array<Array<string | number>>>`:
+ *   - Outer: one entry per placeholder ($N → outer[N-1])
+ *   - Middle: one entry per skill level (length = max_level, usually 10)
+ *   - Inner: a tuple of [current_value, delta] or [value] — we take index 0
+ *
+ * For the max-rank value we take desc_add[n-1][maxLevel-1][0].
+ * If anything looks wrong, we use the last available entry, or "" as a last resort.
+ */
+function extractMaxLevelSubstitutions(descAdd, maxLevel) {
+    if (!Array.isArray(descAdd))
+        return [];
+    const result = [];
+    for (const outerEntry of descAdd) {
+        // outerEntry should be an array of per-level arrays
+        if (!Array.isArray(outerEntry) || outerEntry.length === 0) {
+            result.push("");
+            continue;
+        }
+        // Pick the last-level entry, clamped to available entries
+        const levelIndex = Math.min(maxLevel - 1, outerEntry.length - 1);
+        const innerEntry = outerEntry[Math.max(0, levelIndex)];
+        if (!Array.isArray(innerEntry) || innerEntry.length === 0) {
+            result.push("");
+            continue;
+        }
+        const value = innerEntry[0];
+        if (value === null || value === undefined) {
+            result.push("");
+        }
+        else {
+            result.push(String(value));
+        }
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Stars
+// ---------------------------------------------------------------------------
+/**
+ * Convert star count 1..6 to a unicode-star string like "★★★★".
+ */
+function starsString(count) {
+    return "★".repeat(Math.max(0, count));
+}
+// ---------------------------------------------------------------------------
+// Wiki URL
+// ---------------------------------------------------------------------------
+/**
+ * Convert an EN ship name to a wiki URL.
+ * e.g. "Belfast" → "https://azurlane.koumakan.jp/wiki/Belfast"
+ */
+function wikiUrlFor(name) {
+    return `https://azurlane.koumakan.jp/wiki/${encodeURIComponent(name)}`;
+}
+// ---------------------------------------------------------------------------
+// Limit break bonus string splitting
+// ---------------------------------------------------------------------------
+/**
+ * Split a limit-break bonus string on "/" or "|" into bullet items. Trim whitespace.
+ *
+ * @example
+ *   splitLimitBreakBonuses("Unlock X/Main gun +5%/+10 FP")
+ *   // → ["Unlock X", "Main gun +5%", "+10 FP"]
+ *
+ * Returns [] for the empty string or for "None".
+ */
+function splitLimitBreakBonuses(raw) {
+    const trimmed = raw.trim();
+    if (trimmed === "" || trimmed === "None")
+        return [];
+    return trimmed.split(/[/|]/).map((s) => s.trim()).filter((s) => s.length > 0);
+}

package/dist/client/AzurData.d.ts

@@ -0,0 +1,25 @@
+import { Ships } from "./ships.js";
+import { type FetchOptions } from "./fetcher.js";
+export interface AzurDataOptions {
+    dataPath?: string;
+}
+export interface AzurDataInitOptions extends FetchOptions {
+    /** Fetch latest data from GitHub on startup. Default: true */
+    fetchLatest?: boolean;
+}
+export declare class AzurData {
+    readonly ships: Ships;
+    /** Sync constructor — loads baked data from disk. No network. */
+    constructor(options?: AzurDataOptions);
+    /**
+     * Async factory — fetches latest data from GitHub, caches locally,
+     * falls back to baked data if offline.
+     *
+     * ```ts
+     * const azur = await AzurData.init({ fetchLatest: true });
+     * ```
+     */
+    static init(options?: AzurDataInitOptions): Promise<AzurData>;
+    private static resolveDefaultDataPath;
+}
+//# sourceMappingURL=AzurData.d.ts.map

package/dist/client/AzurData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AzurData.d.ts","sourceRoot":"","sources":["../../src/client/AzurData.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAGlE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACvD,8DAA8D;IAC9D,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAcD,qBAAa,QAAQ;IACnB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAEtB,iEAAiE;gBACrD,OAAO,GAAE,eAAoB;IAWzC;;;;;;;OAOG;WACU,IAAI,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAmBvE,OAAO,CAAC,MAAM,CAAC,sBAAsB;CAUtC"}

package/dist/client/AzurData.js

@@ -0,0 +1,63 @@
+import fs from "node:fs";
+import path from "node:path";
+import { Ships } from "./ships.js";
+import { fetchLatestData } from "./fetcher.js";
+function resolveThisDir() {
+    // CJS: __dirname is injected by Node
+    // ESM under tsx/ts-node: __dirname is polyfilled
+    // Pure ESM: falls back to cwd
+    try {
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore __dirname exists in CJS but not in ESM type defs
+        if (typeof __dirname === "string")
+            return __dirname; // eslint-disable-line no-undef
+    }
+    catch { /* not CJS */ }
+    return process.cwd();
+}
+export class AzurData {
+    ships;
+    /** Sync constructor — loads baked data from disk. No network. */
+    constructor(options = {}) {
+        const dataDir = options.dataPath ?? AzurData.resolveDefaultDataPath();
+        const shipsJson = JSON.parse(fs.readFileSync(path.join(dataDir, "ships.json"), "utf8"));
+        const idMapJson = JSON.parse(fs.readFileSync(path.join(dataDir, "id-map.json"), "utf8"));
+        this.ships = new Ships({ data: shipsJson, idMap: idMapJson });
+    }
+    /**
+     * Async factory — fetches latest data from GitHub, caches locally,
+     * falls back to baked data if offline.
+     *
+     * ```ts
+     * const azur = await AzurData.init({ fetchLatest: true });
+     * ```
+     */
+    static async init(options = {}) {
+        const { fetchLatest = true, ...fetchOpts } = options;
+        if (fetchLatest) {
+            const fetched = await fetchLatestData(fetchOpts);
+            if (fetched) {
+                const instance = Object.create(AzurData.prototype);
+                instance.ships = new Ships({
+                    data: fetched.ships,
+                    idMap: fetched.idMap,
+                });
+                return instance;
+            }
+        }
+        // Fallback to baked data
+        return new AzurData();
+    }
+    static resolveDefaultDataPath() {
+        const thisDir = resolveThisDir();
+        let candidate = thisDir;
+        for (let i = 0; i < 5; i++) {
+            const dataPath = path.resolve(candidate, "data");
+            if (fs.existsSync(path.join(dataPath, "ships.json")))
+                return dataPath;
+            candidate = path.resolve(candidate, "..");
+        }
+        return path.resolve(process.cwd(), "data");
+    }
+}
+//# sourceMappingURL=AzurData.js.map

package/dist/client/AzurData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AzurData.js","sourceRoot":"","sources":["../../src/client/AzurData.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,eAAe,EAAqB,MAAM,cAAc,CAAC;AAYlE,SAAS,cAAc;IACrB,qCAAqC;IACrC,iDAAiD;IACjD,8BAA8B;IAC9B,IAAI,CAAC;QACH,6DAA6D;QAC7D,8DAA8D;QAC9D,IAAI,OAAO,SAAS,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC,CAAC,+BAA+B;IACtF,CAAC;IAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC;IACzB,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC;AACvB,CAAC;AAED,MAAM,OAAO,QAAQ;IACV,KAAK,CAAQ;IAEtB,iEAAiE;IACjE,YAAY,UAA2B,EAAE;QACvC,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,IAAI,QAAQ,CAAC,sBAAsB,EAAE,CAAC;QACtE,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAC1B,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,CAClC,CAAC;QAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAC1B,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,EAAE,MAAM,CAAC,CACjC,CAAC;QAC5B,IAAI,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAChE,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,UAA+B,EAAE;QACjD,MAAM,EAAE,WAAW,GAAG,IAAI,EAAE,GAAG,SAAS,EAAE,GAAG,OAAO,CAAC;QAErD,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,SAAS,CAAC,CAAC;YACjD,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAa,CAAC;gBAC9D,QAA6B,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC;oBAC/C,IAAI,EAAE,OAAO,CAAC,KAAK;oBACnB,KAAK,EAAE,OAAO,CAAC,KAAK;iBACrB,CAAC,CAAC;gBACH,OAAO,QAAQ,CAAC;YAClB,CAAC;QACH,CAAC;QAED,yBAAyB;QACzB,OAAO,IAAI,QAAQ,EAAE,CAAC;IACxB,CAAC;IAEO,MAAM,CAAC,sBAAsB;QACnC,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;QACjC,IAAI,SAAS,GAAG,OAAO,CAAC;QACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YACjD,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;gBAAE,OAAO,QAAQ,CAAC;YACtE,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;IAC7C,CAAC;CACF"}

package/dist/client/fetcher.d.ts

@@ -0,0 +1,25 @@
+import type { Ship } from "../schema/output/ship.js";
+export interface FetchOptions {
+    /** Directory to cache downloaded data. Default: ~/.azurdata */
+    cacheDir?: string;
+    /** Re-fetch if cache is older than this (ms). Default: 6 hours */
+    maxAge?: number;
+    /** Base URL for raw data files. Default: GitHub raw URL */
+    dataUrl?: string;
+}
+interface FetchedData {
+    ships: Record<string, Ship>;
+    idMap: Record<string, string>;
+}
+/**
+ * Fetch latest data from GitHub, with local cache and baked-data fallback.
+ *
+ * Flow:
+ * 1. If cache exists and is fresh (< maxAge) → load from cache
+ * 2. Else fetch version.json from remote → compare with cache
+ * 3. If remote is newer → fetch ships.json + id-map.json, write to cache
+ * 4. If any fetch fails → fall back to cache, then to null (caller uses baked data)
+ */
+export declare function fetchLatestData(options?: FetchOptions): Promise<FetchedData | null>;
+export {};
+//# sourceMappingURL=fetcher.d.ts.map

package/dist/client/fetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetcher.d.ts","sourceRoot":"","sources":["../../src/client/fetcher.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAKrD,MAAM,WAAW,YAAY;IAC3B,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAOD,UAAU,WAAW;IACnB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAoD7B"}

package/dist/client/fetcher.js

@@ -0,0 +1,116 @@
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+import { DATA_BASE_URL } from "../config.js";
+const DEFAULT_CACHE_DIR = path.join(os.homedir(), ".azurdata");
+const DEFAULT_MAX_AGE = 6 * 60 * 60 * 1000; // 6 hours
+/**
+ * Fetch latest data from GitHub, with local cache and baked-data fallback.
+ *
+ * Flow:
+ * 1. If cache exists and is fresh (< maxAge) → load from cache
+ * 2. Else fetch version.json from remote → compare with cache
+ * 3. If remote is newer → fetch ships.json + id-map.json, write to cache
+ * 4. If any fetch fails → fall back to cache, then to null (caller uses baked data)
+ */
+export async function fetchLatestData(options = {}) {
+    const cacheDir = options.cacheDir ?? DEFAULT_CACHE_DIR;
+    const maxAge = options.maxAge ?? DEFAULT_MAX_AGE;
+    const baseUrl = options.dataUrl ?? DATA_BASE_URL;
+    // Check cache freshness
+    const cachedShipsPath = path.join(cacheDir, "ships.json");
+    const cachedIdMapPath = path.join(cacheDir, "id-map.json");
+    const cachedVersionPath = path.join(cacheDir, "version.json");
+    if (isCacheFresh(cachedVersionPath, maxAge)) {
+        return loadFromCache(cachedShipsPath, cachedIdMapPath);
+    }
+    // Fetch remote version
+    let remoteVersion = null;
+    try {
+        remoteVersion = await fetchJson(`${baseUrl}/version.json`);
+    }
+    catch {
+        // Network error — try cache regardless of age
+        return loadFromCache(cachedShipsPath, cachedIdMapPath);
+    }
+    // Compare with cached version
+    if (remoteVersion && isCacheUpToDate(cachedVersionPath, remoteVersion)) {
+        // Touch the cache file to reset maxAge timer
+        touchFile(cachedVersionPath);
+        return loadFromCache(cachedShipsPath, cachedIdMapPath);
+    }
+    // Fetch fresh data
+    try {
+        const [ships, idMap] = await Promise.all([
+            fetchJson(`${baseUrl}/ships.json`),
+            fetchJson(`${baseUrl}/id-map.json`),
+        ]);
+        if (!ships || !idMap) {
+            return loadFromCache(cachedShipsPath, cachedIdMapPath);
+        }
+        // Write to cache atomically
+        writeCache(cacheDir, {
+            "ships.json": ships,
+            "id-map.json": idMap,
+            "version.json": remoteVersion,
+        });
+        return { ships, idMap };
+    }
+    catch {
+        return loadFromCache(cachedShipsPath, cachedIdMapPath);
+    }
+}
+// ── Helpers ──────────────────────────────────────────────────────────────────
+async function fetchJson(url) {
+    const res = await fetch(url);
+    if (!res.ok)
+        return null;
+    return (await res.json());
+}
+function isCacheFresh(versionPath, maxAge) {
+    try {
+        const stat = fs.statSync(versionPath);
+        return Date.now() - stat.mtimeMs < maxAge;
+    }
+    catch {
+        return false;
+    }
+}
+function isCacheUpToDate(versionPath, remote) {
+    try {
+        const cached = JSON.parse(fs.readFileSync(versionPath, "utf8"));
+        return cached.generatedAt === remote.generatedAt;
+    }
+    catch {
+        return false;
+    }
+}
+function touchFile(filePath) {
+    try {
+        const now = new Date();
+        fs.utimesSync(filePath, now, now);
+    }
+    catch { /* ignore */ }
+}
+function loadFromCache(shipsPath, idMapPath) {
+    try {
+        if (!fs.existsSync(shipsPath) || !fs.existsSync(idMapPath))
+            return null;
+        const ships = JSON.parse(fs.readFileSync(shipsPath, "utf8"));
+        const idMap = JSON.parse(fs.readFileSync(idMapPath, "utf8"));
+        return { ships, idMap };
+    }
+    catch {
+        return null;
+    }
+}
+function writeCache(cacheDir, files) {
+    fs.mkdirSync(cacheDir, { recursive: true });
+    for (const [name, data] of Object.entries(files)) {
+        const target = path.join(cacheDir, name);
+        const tmp = target + ".tmp";
+        fs.writeFileSync(tmp, JSON.stringify(data), "utf8");
+        fs.renameSync(tmp, target); // atomic on most filesystems
+    }
+}
+//# sourceMappingURL=fetcher.js.map

package/dist/client/fetcher.js.map

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

package/dist/client/index.d.ts

@@ -0,0 +1,4 @@
+export { AzurData, type AzurDataOptions, type AzurDataInitOptions } from "./AzurData.js";
+export { Ships, type ShipsOptions } from "./ships.js";
+export { type FetchOptions } from "./fetcher.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACzF,OAAO,EAAE,KAAK,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/client/index.js

@@ -0,0 +1,3 @@
+export { AzurData } from "./AzurData.js";
+export { Ships } from "./ships.js";
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAkD,MAAM,eAAe,CAAC;AACzF,OAAO,EAAE,KAAK,EAAqB,MAAM,YAAY,CAAC"}

package/dist/client/ships.d.ts

@@ -0,0 +1,20 @@
+import type { Ship } from "../schema/output/ship.js";
+export interface ShipsOptions {
+    data: Record<string, Ship>;
+    idMap: Record<string, string>;
+    fuseThreshold?: number;
+}
+export declare class Ships {
+    private readonly data;
+    private readonly idMap;
+    private readonly fuse;
+    constructor(options: ShipsOptions);
+    get(nameOrId: string): Ship | undefined;
+    private _ciIdMap?;
+    private getCiIdMap;
+    getAll(): Ship[];
+    getById(id: string): Ship | undefined;
+    count(): number;
+    search(query: string, limit?: number): Ship[];
+}
+//# sourceMappingURL=ships.d.ts.map

package/dist/client/ships.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ships.d.ts","sourceRoot":"","sources":["../../src/client/ships.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAErD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,KAAK;IAChB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAuB;IAC5C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;IAC/C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;gBAEtB,OAAO,EAAE,YAAY;IAoBjC,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAyBvC,OAAO,CAAC,QAAQ,CAAC,CAAyB;IAC1C,OAAO,CAAC,UAAU;IAUlB,MAAM,IAAI,IAAI,EAAE;IAIhB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIrC,KAAK,IAAI,MAAM;IAKf,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,IAAI,EAAE;CAI1C"}