@piyoraik/ffxiv-lodestone-character-lookup 1.0.0

package/README.md

@@ -0,0 +1,36 @@
+# @piyoraik/ffxiv-lodestone-character-lookup
+
+FFXIV の Lodestone（キャラクター検索→キャラクターURL取得・高難度アチーブメント判定）を扱う共通ライブラリです。
+
+## インストール
+
+```sh
+yarn add @piyoraik/ffxiv-lodestone-character-lookup
+```
+
+## 使い方（例）
+
+```ts
+import {
+  parseCreator,
+  buildLodestoneSearchUrl,
+  fetchTopCharacterUrl,
+  buildAchievementCategoryUrl,
+  fetchAchievementCategoryHtml,
+  parseUltimateClearsFromAchievementHtml
+} from "@piyoraik/ffxiv-lodestone-character-lookup";
+
+const creator = parseCreator("Hoge Fuga @ Unicorn");
+if (!creator) throw new Error("invalid creator");
+
+const searchUrl = buildLodestoneSearchUrl(creator);
+const characterUrl = await fetchTopCharacterUrl(searchUrl);
+if (!characterUrl) throw new Error("character not found");
+
+const achievementUrl = buildAchievementCategoryUrl(characterUrl);
+if (!achievementUrl) throw new Error("achievement url not built");
+
+const html = await fetchAchievementCategoryHtml(achievementUrl);
+const result = parseUltimateClearsFromAchievementHtml(html);
+console.log(result);
+```

package/dist/data/high_end_achievements_ja.json

@@ -0,0 +1,18 @@
+{
+  "version": 1,
+  "achievements": [
+    { "name": "絶バハムートを狩りし者", "short": "絶バハ", "group": "ultimate" },
+    { "name": "絶アルテマウェポンを破壊せし者", "short": "絶テマ", "group": "ultimate" },
+    { "name": "絶アレキサンダーを破壊せし者", "short": "絶アレキ", "group": "ultimate" },
+    { "name": "絶竜詩戦争を平定せし者", "short": "絶竜詩", "group": "ultimate" },
+    { "name": "絶オメガ検証戦を完遂せし者", "short": "絶オメガ", "group": "ultimate" },
+    { "name": "絶もうひとつの未来を見届けし者", "short": "絶エデン", "group": "ultimate" },
+
+    { "name": "万魔殿の辺獄を完全制覇せし者：ランク1", "short": "【パンデモ】辺獄", "group": "savage" },
+    { "name": "万魔殿の煉獄を完全制覇せし者：ランク1", "short": "【パンデモ】煉獄", "group": "savage" },
+    { "name": "万魔殿の天獄を完全制覇せし者：ランク1", "short": "【パンデモ】天獄", "group": "savage" },
+    { "name": "アルカディアのライトヘビー級を制覇せし者：ランク1", "short": "【アルカディア】ライトヘビー", "group": "savage" },
+    { "name": "アルカディアのクルーザー級を完全制覇せし者：ランク1", "short": "【アルカディア】クルーザー", "group": "savage" },
+    { "name": "アルカディアのヘビー級を完全制覇せし者：ランク1", "short": "【アルカディア】ヘビー", "group": "savage" }
+  ]
+}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./lodestone";
+export * from "./lodestoneAchievements";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC"}

package/dist/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("./lodestone"), exports);
+__exportStar(require("./lodestoneAchievements"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,0DAAwC"}

package/dist/lodestone.d.ts

@@ -0,0 +1,23 @@
+export type CreatorInfo = {
+    name: string;
+    world: string;
+};
+/**
+ * `募集者: キャラクター名 @ サーバー名` 形式の文字列から、名前/ワールドを取り出します。
+ */
+export declare function parseCreator(creator: string): CreatorInfo | undefined;
+/**
+ * Lodestone のキャラクター検索URLを生成します。
+ * 例:
+ * `https://jp.finalfantasyxiv.com/lodestone/character/?q=Noah+Stella&worldname=Asura&...`
+ */
+export declare function buildLodestoneSearchUrl(info: CreatorInfo): string;
+/**
+ * キャラクター検索結果HTMLから、先頭に表示されるキャラクターURLを取得します。
+ */
+export declare function parseTopCharacterUrlFromSearchHtml(html: string): string | undefined;
+/**
+ * Lodestone のキャラクター検索を行い、先頭にヒットしたキャラクターURLを返します。
+ */
+export declare function fetchTopCharacterUrl(searchUrl: string): Promise<string | undefined>;
+//# sourceMappingURL=lodestone.d.ts.map

package/dist/lodestone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lodestone.d.ts","sourceRoot":"","sources":["../src/lodestone.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAYrE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAsBjE;AAED;;GAEG;AACH,wBAAgB,kCAAkC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKnF;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAYzF"}

package/dist/lodestone.js

@@ -0,0 +1,111 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseCreator = parseCreator;
+exports.buildLodestoneSearchUrl = buildLodestoneSearchUrl;
+exports.parseTopCharacterUrlFromSearchHtml = parseTopCharacterUrlFromSearchHtml;
+exports.fetchTopCharacterUrl = fetchTopCharacterUrl;
+const axios_1 = __importDefault(require("axios"));
+const cheerio = __importStar(require("cheerio"));
+const LODESTONE_BASE_URL = "https://jp.finalfantasyxiv.com";
+/**
+ * `募集者: キャラクター名 @ サーバー名` 形式の文字列から、名前/ワールドを取り出します。
+ */
+function parseCreator(creator) {
+    const raw = creator.trim();
+    if (!raw)
+        return undefined;
+    const at = raw.lastIndexOf("@");
+    if (at === -1)
+        return undefined;
+    const name = raw.slice(0, at).trim();
+    const world = raw.slice(at + 1).trim();
+    if (!name || !world)
+        return undefined;
+    return { name, world };
+}
+/**
+ * Lodestone のキャラクター検索URLを生成します。
+ * 例:
+ * `https://jp.finalfantasyxiv.com/lodestone/character/?q=Noah+Stella&worldname=Asura&...`
+ */
+function buildLodestoneSearchUrl(info) {
+    const url = new URL("/lodestone/character/", LODESTONE_BASE_URL);
+    const params = url.searchParams;
+    params.set("q", info.name);
+    params.set("worldname", info.world);
+    params.set("classjob", "");
+    params.set("race_tribe", "");
+    // Lodestone の検索フォームが投げるパラメータに寄せています。
+    params.append("gcid", "1");
+    params.append("gcid", "2");
+    params.append("gcid", "3");
+    params.append("gcid", "0");
+    params.append("blog_lang", "ja");
+    params.append("blog_lang", "en");
+    params.append("blog_lang", "de");
+    params.append("blog_lang", "fr");
+    params.set("order", "");
+    return url.toString();
+}
+/**
+ * キャラクター検索結果HTMLから、先頭に表示されるキャラクターURLを取得します。
+ */
+function parseTopCharacterUrlFromSearchHtml(html) {
+    const $ = cheerio.load(html);
+    const href = $("a.entry__link").first().attr("href");
+    if (!href)
+        return undefined;
+    return new URL(href, LODESTONE_BASE_URL).toString();
+}
+/**
+ * Lodestone のキャラクター検索を行い、先頭にヒットしたキャラクターURLを返します。
+ */
+async function fetchTopCharacterUrl(searchUrl) {
+    const response = await axios_1.default.get(searchUrl, {
+        responseType: "text",
+        headers: {
+            Accept: "text/html,application/xhtml+xml",
+            "Accept-Language": "ja,en;q=0.8",
+            "User-Agent": "ffxiv-lodestone-character-lookup/0.1 (+https://jp.finalfantasyxiv.com)"
+        },
+        timeout: 30_000
+    });
+    return parseTopCharacterUrlFromSearchHtml(response.data);
+}
+//# sourceMappingURL=lodestone.js.map

package/dist/lodestone.js.map

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

package/dist/lodestoneAchievements.d.ts

@@ -0,0 +1,76 @@
+/**
+ * 高難度（絶/零式）アチーブの正式名と表示用略称の定義（SSOT）。
+ *
+ * 定義は `high_end_achievements_ja.json` を同梱して読み取ります。
+ */
+export type HighEndAchievementGroup = "ultimate" | "savage";
+export type HighEndAchievementDefinition = {
+    name: string;
+    short: string;
+    group: HighEndAchievementGroup;
+};
+/**
+ * 高難度アチーブ定義を取得します。
+ */
+export declare function getHighEndAchievements(): HighEndAchievementDefinition[];
+export type HighEndAchievementName = string;
+/**
+ * 互換用: 旧型名（`UltimateAchievementName`）。
+ */
+export type UltimateAchievementName = HighEndAchievementName;
+/**
+ * 互換用: 旧API名（`getUltimateAchievements`）。
+ */
+export declare function getUltimateAchievements(): HighEndAchievementDefinition[];
+/**
+ * 正式名 → 略称のルックアップを返します。
+ */
+export declare function getHighEndAchievementShortMap(): Map<HighEndAchievementName, string>;
+/**
+ * 互換用: 旧API名（`getUltimateAchievementShortMap`）。
+ */
+export declare function getUltimateAchievementShortMap(): Map<HighEndAchievementName, string>;
+/**
+ * 正式名 → 種別（絶/零式）のルックアップを返します。
+ */
+export declare function getHighEndAchievementGroupMap(): Map<HighEndAchievementName, HighEndAchievementGroup>;
+/**
+ * 互換用: 旧API名（`getUltimateAchievementGroupMap`）。
+ */
+export declare function getUltimateAchievementGroupMap(): Map<HighEndAchievementName, HighEndAchievementGroup>;
+/**
+ * キャラクターURL（例: `https://.../lodestone/character/12345/`）から characterId を抽出します。
+ */
+export declare function parseCharacterIdFromUrl(characterUrl: string): string | undefined;
+/**
+ * Lodestone のアチーブメント一覧URL（カテゴリ指定）を生成します。
+ */
+export declare function buildHighEndAchievementCategoryUrl(characterUrl: string): string | undefined;
+/**
+ * 互換用: 旧API名（`buildAchievementCategoryUrl`）。
+ */
+export declare function buildAchievementCategoryUrl(characterUrl: string): string | undefined;
+export type HighEndAchievementParseResult = {
+    status: "ok" | "private_or_unavailable";
+    clears: string[];
+};
+/**
+ * 互換用: 旧型名（`UltimateAchievementParseResult`）。
+ */
+export type UltimateAchievementParseResult = HighEndAchievementParseResult;
+/**
+ * アチーブメント一覧HTMLから、指定した高難度（絶/零式）アチーブの達成状況を判定します。
+ *
+ * 判定方法:
+ * - 対象の `<li class="entry">` 内に `time.entry__activity__time` が存在するか（=日付が入る）
+ */
+export declare function parseHighEndClearsFromAchievementHtml(html: string): HighEndAchievementParseResult;
+/**
+ * 互換用: 旧API名（`parseUltimateClearsFromAchievementHtml`）。
+ */
+export declare function parseUltimateClearsFromAchievementHtml(html: string): HighEndAchievementParseResult;
+/**
+ * Lodestone のアチーブメント一覧ページを取得します。
+ */
+export declare function fetchAchievementCategoryHtml(url: string): Promise<string>;
+//# sourceMappingURL=lodestoneAchievements.d.ts.map

package/dist/lodestoneAchievements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lodestoneAchievements.d.ts","sourceRoot":"","sources":["../src/lodestoneAchievements.ts"],"names":[],"mappings":"AASA;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE5D,MAAM,MAAM,4BAA4B,GAAG;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,uBAAuB,CAAC;CAChC,CAAC;AAoBF;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,4BAA4B,EAAE,CAEvE;AAED,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAE5C;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,sBAAsB,CAAC;AAE7D;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,4BAA4B,EAAE,CAExE;AAED;;GAEG;AACH,wBAAgB,6BAA6B,IAAI,GAAG,CAAC,sBAAsB,EAAE,MAAM,CAAC,CAMnF;AAED;;GAEG;AACH,wBAAgB,8BAA8B,IAAI,GAAG,CAAC,sBAAsB,EAAE,MAAM,CAAC,CAEpF;AAED;;GAEG;AACH,wBAAgB,6BAA6B,IAAI,GAAG,CAAC,sBAAsB,EAAE,uBAAuB,CAAC,CAMpG;AAED;;GAEG;AACH,wBAAgB,8BAA8B,IAAI,GAAG,CAAC,sBAAsB,EAAE,uBAAuB,CAAC,CAErG;AAQD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGhF;AAED;;GAEG;AACH,wBAAgB,kCAAkC,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAO3F;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEpF;AAED,MAAM,MAAM,6BAA6B,GAAG;IAC1C,MAAM,EAAE,IAAI,GAAG,wBAAwB,CAAC;IACxC,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG,6BAA6B,CAAC;AAE3E;;;;;GAKG;AACH,wBAAgB,qCAAqC,CAAC,IAAI,EAAE,MAAM,GAAG,6BAA6B,CAqBjG;AAED;;GAEG;AACH,wBAAgB,sCAAsC,CAAC,IAAI,EAAE,MAAM,GAAG,6BAA6B,CAElG;AAED;;GAEG;AACH,wBAAsB,4BAA4B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAW/E"}

package/dist/lodestoneAchievements.js

@@ -0,0 +1,193 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getHighEndAchievements = getHighEndAchievements;
+exports.getUltimateAchievements = getUltimateAchievements;
+exports.getHighEndAchievementShortMap = getHighEndAchievementShortMap;
+exports.getUltimateAchievementShortMap = getUltimateAchievementShortMap;
+exports.getHighEndAchievementGroupMap = getHighEndAchievementGroupMap;
+exports.getUltimateAchievementGroupMap = getUltimateAchievementGroupMap;
+exports.parseCharacterIdFromUrl = parseCharacterIdFromUrl;
+exports.buildHighEndAchievementCategoryUrl = buildHighEndAchievementCategoryUrl;
+exports.buildAchievementCategoryUrl = buildAchievementCategoryUrl;
+exports.parseHighEndClearsFromAchievementHtml = parseHighEndClearsFromAchievementHtml;
+exports.parseUltimateClearsFromAchievementHtml = parseUltimateClearsFromAchievementHtml;
+exports.fetchAchievementCategoryHtml = fetchAchievementCategoryHtml;
+const axios_1 = __importDefault(require("axios"));
+const cheerio = __importStar(require("cheerio"));
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const LODESTONE_BASE_URL = "https://jp.finalfantasyxiv.com";
+const HIGH_END_CATEGORY_ID = 4;
+const DEFINITIONS_FILE = (0, node_path_1.resolve)(__dirname, "data", "high_end_achievements_ja.json");
+let cachedDefinitions;
+let cachedShortMap;
+let cachedGroupMap;
+let cachedNameSet;
+function loadDefinitions() {
+    if (cachedDefinitions)
+        return cachedDefinitions;
+    const rawText = (0, node_fs_1.readFileSync)(DEFINITIONS_FILE, "utf8");
+    const raw = JSON.parse(rawText);
+    cachedDefinitions = raw.achievements ?? [];
+    return cachedDefinitions;
+}
+/**
+ * 高難度アチーブ定義を取得します。
+ */
+function getHighEndAchievements() {
+    return loadDefinitions();
+}
+/**
+ * 互換用: 旧API名（`getUltimateAchievements`）。
+ */
+function getUltimateAchievements() {
+    return getHighEndAchievements();
+}
+/**
+ * 正式名 → 略称のルックアップを返します。
+ */
+function getHighEndAchievementShortMap() {
+    if (cachedShortMap)
+        return cachedShortMap;
+    const map = new Map();
+    for (const a of loadDefinitions())
+        map.set(a.name, a.short);
+    cachedShortMap = map;
+    return map;
+}
+/**
+ * 互換用: 旧API名（`getUltimateAchievementShortMap`）。
+ */
+function getUltimateAchievementShortMap() {
+    return getHighEndAchievementShortMap();
+}
+/**
+ * 正式名 → 種別（絶/零式）のルックアップを返します。
+ */
+function getHighEndAchievementGroupMap() {
+    if (cachedGroupMap)
+        return cachedGroupMap;
+    const map = new Map();
+    for (const a of loadDefinitions())
+        map.set(a.name, a.group);
+    cachedGroupMap = map;
+    return map;
+}
+/**
+ * 互換用: 旧API名（`getUltimateAchievementGroupMap`）。
+ */
+function getUltimateAchievementGroupMap() {
+    return getHighEndAchievementGroupMap();
+}
+function getHighEndAchievementNameSet() {
+    if (cachedNameSet)
+        return cachedNameSet;
+    cachedNameSet = new Set(loadDefinitions().map((a) => a.name));
+    return cachedNameSet;
+}
+/**
+ * キャラクターURL（例: `https://.../lodestone/character/12345/`）から characterId を抽出します。
+ */
+function parseCharacterIdFromUrl(characterUrl) {
+    const match = characterUrl.match(/\/lodestone\/character\/(\d+)\//);
+    return match?.[1];
+}
+/**
+ * Lodestone のアチーブメント一覧URL（カテゴリ指定）を生成します。
+ */
+function buildHighEndAchievementCategoryUrl(characterUrl) {
+    const characterId = parseCharacterIdFromUrl(characterUrl);
+    if (!characterId)
+        return undefined;
+    return new URL(`/lodestone/character/${characterId}/achievement/category/${HIGH_END_CATEGORY_ID}/#anchor_achievement`, LODESTONE_BASE_URL).toString();
+}
+/**
+ * 互換用: 旧API名（`buildAchievementCategoryUrl`）。
+ */
+function buildAchievementCategoryUrl(characterUrl) {
+    return buildHighEndAchievementCategoryUrl(characterUrl);
+}
+/**
+ * アチーブメント一覧HTMLから、指定した高難度（絶/零式）アチーブの達成状況を判定します。
+ *
+ * 判定方法:
+ * - 対象の `<li class="entry">` 内に `time.entry__activity__time` が存在するか（=日付が入る）
+ */
+function parseHighEndClearsFromAchievementHtml(html) {
+    const $ = cheerio.load(html);
+    const targetSet = getHighEndAchievementNameSet();
+    const clears = new Set();
+    let foundAny = false;
+    $("li.entry").each((_, el) => {
+        const entry = $(el);
+        const name = entry.find("p.entry__activity__txt").first().text().trim();
+        if (!targetSet.has(name))
+            return;
+        foundAny = true;
+        const hasDate = entry.find("time.entry__activity__time").length > 0;
+        if (hasDate)
+            clears.add(name);
+    });
+    return {
+        status: foundAny ? "ok" : "private_or_unavailable",
+        clears: Array.from(clears)
+    };
+}
+/**
+ * 互換用: 旧API名（`parseUltimateClearsFromAchievementHtml`）。
+ */
+function parseUltimateClearsFromAchievementHtml(html) {
+    return parseHighEndClearsFromAchievementHtml(html);
+}
+/**
+ * Lodestone のアチーブメント一覧ページを取得します。
+ */
+async function fetchAchievementCategoryHtml(url) {
+    const response = await axios_1.default.get(url, {
+        responseType: "text",
+        headers: {
+            Accept: "text/html,application/xhtml+xml",
+            "Accept-Language": "ja,en;q=0.8",
+            "User-Agent": "ffxiv-lodestone-character-lookup/0.1 (+https://jp.finalfantasyxiv.com)"
+        },
+        timeout: 30_000
+    });
+    return response.data;
+}
+//# sourceMappingURL=lodestoneAchievements.js.map

package/dist/lodestoneAchievements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lodestoneAchievements.js","sourceRoot":"","sources":["../src/lodestoneAchievements.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2CA,wDAEC;AAYD,0DAEC;AAKD,sEAMC;AAKD,wEAEC;AAKD,sEAMC;AAKD,wEAEC;AAWD,0DAGC;AAKD,gFAOC;AAKD,kEAEC;AAkBD,sFAqBC;AAKD,wFAEC;AAKD,oEAWC;AA9LD,kDAA0B;AAC1B,iDAAmC;AACnC,qCAAuC;AACvC,yCAAoC;AAEpC,MAAM,kBAAkB,GAAG,gCAAgC,CAAC;AAC5D,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAC/B,MAAM,gBAAgB,GAAG,IAAA,mBAAO,EAAC,SAAS,EAAE,MAAM,EAAE,+BAA+B,CAAC,CAAC;AAoBrF,IAAI,iBAA6D,CAAC;AAClE,IAAI,cAA+C,CAAC;AACpD,IAAI,cAAgE,CAAC;AACrE,IAAI,aAAsC,CAAC;AAE3C,SAAS,eAAe;IACtB,IAAI,iBAAiB;QAAE,OAAO,iBAAiB,CAAC;IAChD,MAAM,OAAO,GAAG,IAAA,sBAAY,EAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;IACvD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAA0B,CAAC;IACzD,iBAAiB,GAAG,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC;IAC3C,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,SAAgB,sBAAsB;IACpC,OAAO,eAAe,EAAE,CAAC;AAC3B,CAAC;AASD;;GAEG;AACH,SAAgB,uBAAuB;IACrC,OAAO,sBAAsB,EAAE,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,SAAgB,6BAA6B;IAC3C,IAAI,cAAc;QAAE,OAAO,cAAc,CAAC;IAC1C,MAAM,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAC;IACtC,KAAK,MAAM,CAAC,IAAI,eAAe,EAAE;QAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;IAC5D,cAAc,GAAG,GAAG,CAAC;IACrB,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;GAEG;AACH,SAAgB,8BAA8B;IAC5C,OAAO,6BAA6B,EAAE,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,SAAgB,6BAA6B;IAC3C,IAAI,cAAc;QAAE,OAAO,cAAc,CAAC;IAC1C,MAAM,GAAG,GAAG,IAAI,GAAG,EAAmC,CAAC;IACvD,KAAK,MAAM,CAAC,IAAI,eAAe,EAAE;QAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;IAC5D,cAAc,GAAG,GAAG,CAAC;IACrB,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;GAEG;AACH,SAAgB,8BAA8B;IAC5C,OAAO,6BAA6B,EAAE,CAAC;AACzC,CAAC;AAED,SAAS,4BAA4B;IACnC,IAAI,aAAa;QAAE,OAAO,aAAa,CAAC;IACxC,aAAa,GAAG,IAAI,GAAG,CAAC,eAAe,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9D,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,SAAgB,uBAAuB,CAAC,YAAoB;IAC1D,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACpE,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,SAAgB,kCAAkC,CAAC,YAAoB;IACrE,MAAM,WAAW,GAAG,uBAAuB,CAAC,YAAY,CAAC,CAAC;IAC1D,IAAI,CAAC,WAAW;QAAE,OAAO,SAAS,CAAC;IACnC,OAAO,IAAI,GAAG,CACZ,wBAAwB,WAAW,yBAAyB,oBAAoB,sBAAsB,EACtG,kBAAkB,CACnB,CAAC,QAAQ,EAAE,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAgB,2BAA2B,CAAC,YAAoB;IAC9D,OAAO,kCAAkC,CAAC,YAAY,CAAC,CAAC;AAC1D,CAAC;AAYD;;;;;GAKG;AACH,SAAgB,qCAAqC,CAAC,IAAY;IAChE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE7B,MAAM,SAAS,GAAG,4BAA4B,EAAE,CAAC;IACjD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IACjC,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE;QAC3B,MAAM,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;QACpB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;QACxE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO;QAEjC,QAAQ,GAAG,IAAI,CAAC;QAChB,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QACpE,IAAI,OAAO;YAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,wBAAwB;QAClD,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;KAC3B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,sCAAsC,CAAC,IAAY;IACjE,OAAO,qCAAqC,CAAC,IAAI,CAAC,CAAC;AACrD,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,4BAA4B,CAAC,GAAW;IAC5D,MAAM,QAAQ,GAAG,MAAM,eAAK,CAAC,GAAG,CAAS,GAAG,EAAE;QAC5C,YAAY,EAAE,MAAM;QACpB,OAAO,EAAE;YACP,MAAM,EAAE,iCAAiC;YACzC,iBAAiB,EAAE,aAAa;YAChC,YAAY,EAAE,wEAAwE;SACvF;QACD,OAAO,EAAE,MAAM;KAChB,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC,IAAI,CAAC;AACvB,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@piyoraik/ffxiv-lodestone-character-lookup",
+  "version": "1.0.0",
+  "description": "FFXIV Lodestone character lookup (search → character URL) and high-end achievement checks",
+  "license": "MIT",
+  "author": "",
+  "homepage": "",
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "type": "commonjs",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist/**",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && node scripts/copy-data.cjs",
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "axios": "^1.7.9",
+    "cheerio": "^1.1.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "typescript": "^5.7.2"
+  }
+}