@piyoraik/ffxiv-lodestone-character-lookup 1.0.6 → 1.0.8

package/README.md

@@ -4,7 +4,7 @@ FFXIV の Lodestone を使って、以下を行うための共通ライブラリ
 
 - `キャラクター名` と `サーバー名` から検索パラメータを作る
 - キャラクター検索の先頭ヒットから「キャラクターURL（/lodestone/character/.../）」を取得する
-- キャラクターの「アチーブメント（カテゴリ4）」ページから、高難度（絶/零式）の達成状況を判定する
+- Lodestone からアチーブメントの達成状況と達成要件を取得する
 
 ## 動作環境
 
@@ -21,10 +21,13 @@ yarn add @piyoraik/ffxiv-lodestone-character-lookup
 ```ts
 import {
   buildLodestoneSearchUrl,
-  fetchTopCharacterUrl,
-  buildAchievementCategoryUrl,
-  fetchAchievementCategoryHtml,
-  parseUltimateClearsFromAchievementHtml
+  fetchTopCharacterResult,
+  fetchAchievementDetailsByCategory,
+  fetchAllAchievementDetails,
+  getAllAchievementDefinitions,
+  getAchievementCategoryDefinitions,
+  getAchievementDefinitions,
+  getAchievementCategoryId
 } from "@piyoraik/ffxiv-lodestone-character-lookup";
 
 const creator = { name: "Hoge Fuga", world: "World" };
@@ -32,18 +35,44 @@ const creator = { name: "Hoge Fuga", world: "World" };
 // 1) Lodestoneの検索URLを作る
 const searchUrl = buildLodestoneSearchUrl(creator);
 
-// 2) 検索の先頭ヒットからキャラクターURLを取る
-const characterUrl = await fetchTopCharacterUrl(searchUrl);
-if (!characterUrl) throw new Error("キャラクターが見つかりませんでした");
-
-// 3) アチーブメントページ（カテゴリ4）のURLを作る
-const achievementUrl = buildAchievementCategoryUrl(characterUrl);
-if (!achievementUrl) throw new Error("アチーブURLの生成に失敗しました");
-
-// 4) HTMLを取得して達成状況を判定
-const html = await fetchAchievementCategoryHtml(achievementUrl);
-const result = parseUltimateClearsFromAchievementHtml(html);
-console.log(result);
+// 2) 検索結果の状態を取得する
+const searchResult = await fetchTopCharacterResult(searchUrl);
+if (searchResult.status !== "ok") {
+  throw new Error(`キャラクターが取得できません: ${searchResult.status}`);
+}
+const characterUrl = searchResult.characterUrl;
+
+// 3) カテゴリ指定で取得する
+const raids = await fetchAchievementDetailsByCategory(characterUrl, "raids");
+console.log(raids);
+const fieldOps = await fetchAchievementDetailsByCategory(characterUrl, "field_ops");
+console.log(fieldOps);
+const dungeons = await fetchAchievementDetailsByCategory(characterUrl, "dungeons");
+console.log(dungeons);
+
+// 4) 全カテゴリをまとめて取得する
+const all = await fetchAllAchievementDetails(characterUrl);
+console.log(all);
+
+// 定義をまとめて取得する場合
+const categories = getAchievementCategoryDefinitions();
+const allAchievements = getAllAchievementDefinitions();
+const raidsDefinitions = getAchievementDefinitions("raids");
+const raidsCategoryId = getAchievementCategoryId("raids");
+console.log(categories.length, allAchievements.length, raidsDefinitions.length, raidsCategoryId);
+
+/*
+{
+  status: "ok",
+  lodestone: "https://jp.finalfantasyxiv.com/lodestone/character/12345/",
+  achievements: {
+    raids: [
+      { name: "絶バハムートを狩りし者", date: "2014/06/10", requirement: "絶バハムート討滅戦で、バハムート・プライムを討伐する" },
+      { name: "万魔殿の辺獄を完全制覇せし者：ランク1", date: null, requirement: "万魔殿パンデモニウム零式：辺獄編を攻略する" }
+    ]
+  }
+}
+*/
 ```
 
 ## 関数一覧
@@ -51,35 +80,78 @@ console.log(result);
 | 関数 | 返り値 | 用途 |
 |---|---|---|
 | `buildLodestoneSearchUrl(info)` | `string` | キャラクター検索URLを生成 |
-| `fetchTopCharacterUrl(searchUrl)` | `Promise<string \| undefined>` | 検索結果の先頭ヒットのキャラURLを取得 |
-| `buildAchievementCategoryUrl(characterUrl)` | `string \| undefined` | カテゴリ4(レイド)のアチーブURLを生成 |
-| `fetchAchievementCategoryHtml(url)` | `Promise<string>` | アチーブHTMLを取得 |
-| `parseUltimateClearsFromAchievementHtml(html)` | `{ status, clears }` | 高難度（絶/零式）達成状況を抽出 |
-| `getHighEndAchievements()` | `HighEndAchievementDefinition[]` | 同梱定義（正式名/略称/種別）を取得 |
-| `getHighEndAchievementShortMap()` | `Map<string, string>` | `正式名 -> 略称` |
-| `getHighEndAchievementGroupMap()` | `Map<string, "ultimate" \| "savage">` | `正式名 -> 種別` |
+| `fetchTopCharacterResult(searchUrl)` | `Promise<{ status, characterUrl?, reason? }>` | 検索結果の状態を取得（非公開は `private`） |
+| `fetchAchievementDetailsByCategory(characterUrl, category)` | `Promise<{ status, lodestone, achievements, reason? }>` | カテゴリ指定で達成状況/達成要件を取得 |
+| `fetchAllAchievementDetails(characterUrl)` | `Promise<{ status, lodestone, achievements, reason? }>` | 全カテゴリの達成状況/達成要件を取得 |
+| `getAchievementDefinitions(category)` | `AchievementDefinition[]` | カテゴリ指定で定義を取得 |
+| `getAllAchievementDefinitions()` | `AchievementDefinition[]` | 全カテゴリの定義を取得 |
+| `getAchievementCategoryDefinitions()` | `AchievementCategoryDefinition[]` | カテゴリ一覧（ID/定義）を取得 |
+| `getAchievementCategoryId(category)` | `number \| undefined` | カテゴリ名からカテゴリIDを取得 |
 
-## 対応アチーブメント（高難度）
+## 対応カテゴリ一覧
+
+| category | 説明 | categoryId |
+|---|---|---|
+| `raids` | レイド（高難度） | `4` |
+| `field_ops` | 特殊フィールド探索 | `71` |
+| `dungeons` | ダンジョン | `2` |
+| `battle_general` | バトル（全般） | `1` |
+
+## 対応アチーブメント（カテゴリ別）
 
 このライブラリが達成判定に対応しているアチーブメントの一覧です。
 アップデートごとにベストエフォートで更新し、必要であればIssueやプルリクを頂ければ優先的に対応します。
-
-| 種別 | 略称 | 正式名 |
-|---|---|---|
-| 絶 | 絶バハ | 絶バハムートを狩りし者 |
-| 絶 | 絶テマ | 絶アルテマウェポンを破壊せし者 |
-| 絶 | 絶アレキ | 絶アレキサンダーを破壊せし者 |
-| 絶 | 絶竜詩 | 絶竜詩戦争を平定せし者 |
-| 絶 | 絶オメガ | 絶オメガ検証戦を完遂せし者 |
-| 絶 | 絶エデン | 絶もうひとつの未来を見届けし者 |
-| 零式 | 【パンデモ】辺獄 | 万魔殿の辺獄を完全制覇せし者：ランク1 |
-| 零式 | 【パンデモ】煉獄 | 万魔殿の煉獄を完全制覇せし者：ランク1 |
-| 零式 | 【パンデモ】天獄 | 万魔殿の天獄を完全制覇せし者：ランク1 |
-| 零式 | 【アルカディア】ライトヘビー | アルカディアのライトヘビー級を制覇せし者：ランク1 |
-| 零式 | 【アルカディア】クルーザー | アルカディアのクルーザー級を完全制覇せし者：ランク1 |
-| 零式 | 【アルカディア】ヘビー | アルカディアのヘビー級を完全制覇せし者：ランク1 |
+達成要件の更新には `npm run update-readme-requirements` を使用してください。
+
+### レイド（高難度）
+| 正式名 | 達成要件 |
+|---|---|
+| 絶バハムートを狩りし者 | 絶バハムート討滅戦で、バハムート・プライムを討伐する |
+| 絶アルテマウェポンを破壊せし者 | 絶アルテマウェポン破壊作戦で、アルテマウェポンを討伐する |
+| 絶アレキサンダーを破壊せし者 | 絶アレキサンダー討滅戦で、パーフェクト・アレキサンダーを討伐する |
+| 絶竜詩戦争を平定せし者 | 絶竜詩戦争を平定する |
+| 絶オメガ検証戦を完遂せし者 | オメガの求める検証を完遂する |
+| 絶もうひとつの未来を見届けし者 | 光と闇の巫女の運命を集約させる |
+| 万魔殿の辺獄を完全制覇せし者：ランク1 | 万魔殿パンデモニウム零式：辺獄編を攻略する |
+| 万魔殿の煉獄を完全制覇せし者：ランク1 | 万魔殿パンデモニウム零式：煉獄編を攻略する |
+| 万魔殿の天獄を完全制覇せし者：ランク1 | 万魔殿パンデモニウム零式：天獄編を攻略する |
+| アルカディアのライトヘビー級を完全制覇せし者：ランク1 | 至天の座アルカディア零式：ライトヘビー級を攻略する |
+| アルカディアのクルーザー級を完全制覇せし者：ランク1 | 至天の座アルカディア零式：クルーザー級を攻略する |
+| アルカディアのヘビー級を完全制覇せし者：ランク1 | 至天の座アルカディア零式：ヘビー級を攻略する |
+
+### 特殊フィールド探索
+| 正式名 | 達成要件 |
+|---|---|
+| バルデシオンアーセナルの覇者：ランク1 | バルデシオンアーセナルを初めて攻略する |
+| ボズヤの彗星 | 堅守彗星章、勇猛彗星章、救命彗星章を、各10個入手する |
+| グンヒルド・ディルーブラムを完全制覇せし者：ランク1 | グンヒルド・ディルーブラム零式を攻略する |
+| 力の塔を制覇せし者：ランク1 | 蜃気楼の島 クレセントアイルにて、フォークタワー：力の塔を初めて攻略する |
+
+### ダンジョン
+| 正式名 | 達成要件 |
+|---|---|
+| 語り継がれし冒険譚：ランク3 | ダンジョン、討伐・討滅戦を計10,000回攻略する |
+| 孤独なる挑戦者：ランク3 | 死者の宮殿にソロでB1から突入しB200まで攻略する |
+| 埋もれた財宝：ランク7 | 埋もれた財宝を30,000個発見した |
+| ここ掘れワンワン：ランク2 | 埋もれた財宝を、魔土器：財宝感知もしくは魔科学器：財宝感知を使わずに100個発見した |
+| 孤高なる挑戦者：ランク2 | アメノミハシラにソロで1層から突入し100層まで攻略する |
+| 崇高なる挑戦者：ランク2 | オルト・エウレカにソロでB1から突入しB100まで攻略する |
+| 至高なる挑戦者：ランク2 | ピルグリム・トラバースにソロで第1巡礼路から突入し第100巡礼路まで攻略する |
+| 死せる巡礼路の果てへ | 詩想エミネントグリーフ討滅戦を供物を最大限捧げた状態で攻略する |
+| 異聞シラディハ水道を完全制覇せし者 | 異聞シラディハ水道 零式（アナザーダンジョン）を攻略する |
+| 異聞六根山を完全制覇せし者 | 異聞六根山 零式（アナザーダンジョン）を攻略する |
+| 異聞アロアロ島を完全制覇せし者 | 異聞アロアロ島 零式（アナザーダンジョン）を攻略する |
+| 異聞奇譚の勇傑 | アチーブメント「異聞シラディハ水道を完全制覇せし者」「異聞六根山を完全制覇せし者」「異聞アロアロ島を完全制覇せし者」をすべて達成する |
+
+### バトル（全般）
+| 正式名 | 達成要件 |
+|---|---|
+| 豪傑の青魔道士 | アチーブメント「大迷宮を極めし青魔道士」と「機工城を極めし青魔道士」を達成する |
+| 機工城を極めし青魔道士 | アチーブメント「起動せし機工城を制覇せし青魔道士」「律動せし機工城を制覇せし青魔道士」「天動せし機工城を制覇せし青魔道士」をすべて達成する |
+| 大迷宮を極めし青魔道士 | アチーブメント「始まりの大迷宮を制覇せし青魔道士」「第二の大迷宮を制覇せし青魔道士」「終わりの大迷宮を制覇せし青魔道士」をすべて達成する |
 
 ## 注意
 
 - Lodestone検索は「先頭ヒット」を採用します（同名が複数いる場合、意図と違うキャラに当たる可能性があります）
 - HTML構造（class名など）が変わるとパースが壊れます（その場合はバージョン更新で追随します）
+- アチーブメントの達成要件は Lodestone から引用しています

package/dist/data/achievements/battle_general.json

@@ -0,0 +1,10 @@
+{
+  "version": 1,
+  "category": "battle_general",
+  "categoryId": 1,
+  "achievements": [
+    { "name": "豪傑の青魔道士" },
+    { "name": "機工城を極めし青魔道士" },
+    { "name": "大迷宮を極めし青魔道士" }
+  ]
+}

package/dist/data/achievements/dungeons.json

@@ -0,0 +1,19 @@
+{
+  "version": 1,
+  "category": "dungeons",
+  "categoryId": 2,
+  "achievements": [
+    { "name": "語り継がれし冒険譚：ランク3" },
+    { "name": "孤独なる挑戦者：ランク3" },
+    { "name": "埋もれた財宝：ランク7" },
+    { "name": "ここ掘れワンワン：ランク2" },
+    { "name": "孤高なる挑戦者：ランク2" },
+    { "name": "崇高なる挑戦者：ランク2" },
+    { "name": "至高なる挑戦者：ランク2" },
+    { "name": "死せる巡礼路の果てへ" },
+    { "name": "異聞シラディハ水道を完全制覇せし者" },
+    { "name": "異聞六根山を完全制覇せし者" },
+    { "name": "異聞アロアロ島を完全制覇せし者" },
+    { "name": "異聞奇譚の勇傑" }
+  ]
+}

package/dist/data/achievements/field_ops.json

@@ -0,0 +1,11 @@
+{
+  "version": 1,
+  "category": "field_ops",
+  "categoryId": 71,
+  "achievements": [
+    { "name": "バルデシオンアーセナルの覇者：ランク1" },
+    { "name": "ボズヤの彗星" },
+    { "name": "グンヒルド・ディルーブラムを完全制覇せし者：ランク1" },
+    { "name": "力の塔を制覇せし者：ランク1" }
+  ]
+}

package/dist/data/achievements/raids.json

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

package/dist/lodestone.d.ts

@@ -2,6 +2,18 @@ export type CreatorInfo = {
     name: string;
     world: string;
 };
+export type CharacterSearchStatus = "ok" | "private" | "ng";
+export type CharacterSearchReason = "search_hidden" | "empty_html" | "structure_mismatch" | "http_error";
+export type CharacterSearchResult = {
+    status: "ok";
+    characterUrl: string;
+} | {
+    status: "private";
+    reason: CharacterSearchReason;
+} | {
+    status: "ng";
+    reason: CharacterSearchReason;
+};
 /**
  * Lodestone のキャラクター検索URLを生成します。
  * 例:
@@ -9,11 +21,7 @@ export type CreatorInfo = {
  */
 export declare function buildLodestoneSearchUrl(info: CreatorInfo): string;
 /**
- * キャラクター検索結果HTMLから、先頭に表示されるキャラクターURLを取得します。
- */
-export declare function parseTopCharacterUrlFromSearchHtml(html: string): string | undefined;
-/**
- * Lodestone のキャラクター検索を行い、先頭にヒットしたキャラクターURLを返します。
+ * Lodestone のキャラクター検索を行い、検索結果の状態を返します。
  */
-export declare function fetchTopCharacterUrl(searchUrl: string): Promise<string | undefined>;
+export declare function fetchTopCharacterResult(searchUrl: string): Promise<CharacterSearchResult>;
 //# sourceMappingURL=lodestone.d.ts.map

package/dist/lodestone.d.ts.map

@@ -1 +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;;;;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"}
+{"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,MAAM,MAAM,qBAAqB,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAAC;AAE5D,MAAM,MAAM,qBAAqB,GAAG,eAAe,GAAG,YAAY,GAAG,oBAAoB,GAAG,YAAY,CAAC;AAEzG,MAAM,MAAM,qBAAqB,GAC7B;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,qBAAqB,CAAA;CAAE,GACpD;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,qBAAqB,CAAA;CAAE,CAAC;AAEpD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAsBjE;AAoBD;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAgB/F"}

package/dist/lodestone.js

@@ -37,8 +37,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildLodestoneSearchUrl = buildLodestoneSearchUrl;
-exports.parseTopCharacterUrlFromSearchHtml = parseTopCharacterUrlFromSearchHtml;
-exports.fetchTopCharacterUrl = fetchTopCharacterUrl;
+exports.fetchTopCharacterResult = fetchTopCharacterResult;
 const axios_1 = __importDefault(require("axios"));
 const cheerio = __importStar(require("cheerio"));
 const LODESTONE_BASE_URL = "https://jp.finalfantasyxiv.com";
@@ -69,26 +68,37 @@ function buildLodestoneSearchUrl(info) {
 /**
  * キャラクター検索結果HTMLから、先頭に表示されるキャラクターURLを取得します。
  */
-function parseTopCharacterUrlFromSearchHtml(html) {
-    const $ = cheerio.load(html);
+function parseTopCharacterResultFromSearchHtml(html) {
+    const raw = html.trim();
+    if (!raw)
+        return { status: "ng", reason: "empty_html" };
+    const $ = cheerio.load(raw);
     const href = $("a.entry__link").first().attr("href");
-    if (!href)
-        return undefined;
-    return new URL(href, LODESTONE_BASE_URL).toString();
+    if (href)
+        return { status: "ok", characterUrl: new URL(href, LODESTONE_BASE_URL).toString() };
+    if ($("li.entry").length === 0) {
+        return { status: "private", reason: "search_hidden" };
+    }
+    return { status: "ng", reason: "structure_mismatch" };
 }
 /**
- * Lodestone のキャラクター検索を行い、先頭にヒットしたキャラクターURLを返します。
+ * Lodestone のキャラクター検索を行い、検索結果の状態を返します。
  */
-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);
+async function fetchTopCharacterResult(searchUrl) {
+    try {
+        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 parseTopCharacterResultFromSearchHtml(response.data);
+    }
+    catch {
+        return { status: "ng", reason: "http_error" };
+    }
 }
 //# sourceMappingURL=lodestone.js.map

package/dist/lodestone.js.map

@@ -1 +1 @@
-{"version":3,"file":"lodestone.js","sourceRoot":"","sources":["../src/lodestone.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAeA,0DAsBC;AAKD,gFAKC;AAKD,oDAYC;AAhED,kDAA0B;AAC1B,iDAAmC;AAEnC,MAAM,kBAAkB,GAAG,gCAAgC,CAAC;AAO5D;;;;GAIG;AACH,SAAgB,uBAAuB,CAAC,IAAiB;IACvD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,uBAAuB,EAAE,kBAAkB,CAAC,CAAC;IACjE,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC;IAEhC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3B,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC3B,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IAE7B,qCAAqC;IACrC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE3B,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IACjC,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IACjC,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IACjC,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAEjC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACxB,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,SAAgB,kCAAkC,CAAC,IAAY;IAC7D,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,IAAI,GAAG,CAAC,CAAC,eAAe,CAAC,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrD,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,OAAO,IAAI,GAAG,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC,QAAQ,EAAE,CAAC;AACtD,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,oBAAoB,CAAC,SAAiB;IAC1D,MAAM,QAAQ,GAAG,MAAM,eAAK,CAAC,GAAG,CAAS,SAAS,EAAE;QAClD,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;IAEH,OAAO,kCAAkC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC3D,CAAC"}
+{"version":3,"file":"lodestone.js","sourceRoot":"","sources":["../src/lodestone.ts"],"names":[],"mappings":"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"}

package/dist/lodestoneAchievements.d.ts

@@ -1,76 +1,58 @@
 /**
- * 高難度（絶/零式）アチーブの正式名と表示用略称の定義（SSOT）。
+ * アチーブメントの正式名定義（SSOT）。
  *
- * 定義は `high_end_achievements_ja.json` を同梱して読み取ります。
+ * 定義は `data/achievements/*.json` を同梱して読み取ります。
  */
-export type HighEndAchievementGroup = "ultimate" | "savage";
-export type HighEndAchievementDefinition = {
+export type AchievementDefinition = {
     name: string;
-    short: string;
-    group: HighEndAchievementGroup;
+};
+export type AchievementCategoryDefinition = {
+    version: number;
+    category: string;
+    categoryId: number;
+    achievements: AchievementDefinition[];
 };
 /**
- * 高難度アチーブ定義を取得します。
- */
-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>;
+export declare function getAchievementDefinitions(category: string): AchievementDefinition[];
 /**
- * キャラクターURL（例: `https://.../lodestone/character/12345/`）から characterId を抽出します。
+ * 全カテゴリのアチーブ定義を取得します。
  */
-export declare function parseCharacterIdFromUrl(characterUrl: string): string | undefined;
+export declare function getAllAchievementDefinitions(): AchievementDefinition[];
 /**
- * Lodestone のアチーブメント一覧URL（カテゴリ指定）を生成します。
+ * カテゴリ定義一覧を取得します。
  */
-export declare function buildHighEndAchievementCategoryUrl(characterUrl: string): string | undefined;
+export declare function getAchievementCategoryDefinitions(): AchievementCategoryDefinition[];
 /**
- * 互換用: 旧API名（`buildAchievementCategoryUrl`）。
+ * カテゴリ名から、LodestoneのカテゴリIDを取得します。
  */
-export declare function buildAchievementCategoryUrl(characterUrl: string): string | undefined;
-export type HighEndAchievementParseResult = {
-    status: "ok" | "private_or_unavailable";
-    clears: string[];
+export declare function getAchievementCategoryId(category: string): number | undefined;
+export type HighEndAchievementStatus = "ok" | "private" | "ng";
+export type HighEndAchievementStatusReason = "achievements_private" | "unknown_category" | "http_403" | "http_error" | "empty_html" | "structure_mismatch" | "invalid_character_url";
+export type AchievementEntry = {
+    name: string;
+    date: string | null;
+    requirement?: string | null;
+};
+export type HighEndAchievementDetailResult = {
+    status: HighEndAchievementStatus;
+    reason?: HighEndAchievementStatusReason;
+    lodestone: string;
+    achievements: Record<string, AchievementEntry[]>;
+};
+export type AllAchievementDetailResult = {
+    status: HighEndAchievementStatus;
+    reason?: HighEndAchievementStatusReason;
+    lodestone: string;
+    achievements: Record<string, AchievementEntry[]>;
 };
 /**
- * 互換用: 旧型名（`UltimateAchievementParseResult`）。
- */
-export type UltimateAchievementParseResult = HighEndAchievementParseResult;
-/**
- * アチーブメント一覧HTMLから、指定した高難度（絶/零式）アチーブの達成状況を判定します。
- *
- * 判定方法:
- * - 対象の `<li class="entry">` 内に `time.entry__activity__time` が存在するか（=日付が入る）
- */
-export declare function parseHighEndClearsFromAchievementHtml(html: string): HighEndAchievementParseResult;
-/**
- * 互換用: 旧API名（`parseUltimateClearsFromAchievementHtml`）。
+ * キャラクターURLとカテゴリを指定して、アチーブを取得して返します。
  */
-export declare function parseUltimateClearsFromAchievementHtml(html: string): HighEndAchievementParseResult;
+export declare function fetchAchievementDetailsByCategory(characterUrl: string, category: string): Promise<HighEndAchievementDetailResult>;
 /**
- * Lodestone のアチーブメント一覧ページを取得します。
+ * 全カテゴリのアチーブを取得して返します。
  */
-export declare function fetchAchievementCategoryHtml(url: string): Promise<string>;
+export declare function fetchAllAchievementDetails(characterUrl: string): Promise<AllAchievementDetailResult>;
 //# sourceMappingURL=lodestoneAchievements.d.ts.map

package/dist/lodestoneAchievements.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"lodestoneAchievements.d.ts","sourceRoot":"","sources":["../src/lodestoneAchievements.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,qBAAqB,EAAE,CAAC;CACvC,CAAC;AAyBF;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,qBAAqB,EAAE,CAEnF;AAED;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,qBAAqB,EAAE,CAMtE;AAED;;GAEG;AACH,wBAAgB,iCAAiC,IAAI,6BAA6B,EAAE,CAEnF;AAkBD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE7E;AAgBD,MAAM,MAAM,wBAAwB,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAAC;AAE/D,MAAM,MAAM,8BAA8B,GACtC,sBAAsB,GACtB,kBAAkB,GAClB,UAAU,GACV,YAAY,GACZ,YAAY,GACZ,oBAAoB,GACpB,uBAAuB,CAAC;AAE5B,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,MAAM,EAAE,wBAAwB,CAAC;IACjC,MAAM,CAAC,EAAE,8BAA8B,CAAC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,MAAM,EAAE,wBAAwB,CAAC;IACjC,MAAM,CAAC,EAAE,8BAA8B,CAAC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;CAClD,CAAC;AAmHF;;GAEG;AACH,wBAAsB,iCAAiC,CACrD,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,8BAA8B,CAAC,CAkEzC;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,0BAA0B,CAAC,CAkBrC"}

package/dist/lodestoneAchievements.js

@@ -36,90 +36,69 @@ 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;
+exports.getAchievementDefinitions = getAchievementDefinitions;
+exports.getAllAchievementDefinitions = getAllAchievementDefinitions;
+exports.getAchievementCategoryDefinitions = getAchievementCategoryDefinitions;
+exports.getAchievementCategoryId = getAchievementCategoryId;
+exports.fetchAchievementDetailsByCategory = fetchAchievementDetailsByCategory;
+exports.fetchAllAchievementDetails = fetchAllAchievementDetails;
 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 DEFINITIONS_DIR = (0, node_path_1.resolve)(__dirname, "data", "achievements");
+let cachedCategoryDefinitions;
+const cachedNameSets = new Map();
+function loadCategoryDefinitions() {
+    if (cachedCategoryDefinitions)
+        return cachedCategoryDefinitions;
+    const files = (0, node_fs_1.readdirSync)(DEFINITIONS_DIR).filter((file) => file.endsWith(".json"));
     const map = new Map();
-    for (const a of loadDefinitions())
-        map.set(a.name, a.short);
-    cachedShortMap = map;
+    for (const file of files) {
+        const rawText = (0, node_fs_1.readFileSync)((0, node_path_1.resolve)(DEFINITIONS_DIR, file), "utf8");
+        const raw = JSON.parse(rawText);
+        if (!raw.category || !Array.isArray(raw.achievements))
+            continue;
+        map.set(raw.category, raw);
+    }
+    cachedCategoryDefinitions = map;
     return map;
 }
+function loadDefinitions(category) {
+    const raw = loadCategoryDefinitions().get(category);
+    const definitions = raw?.achievements ?? [];
+    return definitions;
+}
 /**
- * 互換用: 旧API名（`getUltimateAchievementShortMap`）。
+ * カテゴリ指定でアチーブ定義を取得します。
  */
-function getUltimateAchievementShortMap() {
-    return getHighEndAchievementShortMap();
+function getAchievementDefinitions(category) {
+    return loadDefinitions(category);
 }
 /**
- * 正式名 → 種別（絶/零式）のルックアップを返します。
+ * 全カテゴリのアチーブ定義を取得します。
  */
-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;
+function getAllAchievementDefinitions() {
+    const all = [];
+    for (const category of loadCategoryDefinitions().keys()) {
+        all.push(...loadDefinitions(category));
+    }
+    return all;
 }
 /**
- * 互換用: 旧API名（`getUltimateAchievementGroupMap`）。
+ * カテゴリ定義一覧を取得します。
  */
-function getUltimateAchievementGroupMap() {
-    return getHighEndAchievementGroupMap();
+function getAchievementCategoryDefinitions() {
+    return Array.from(loadCategoryDefinitions().values());
 }
-function getHighEndAchievementNameSet() {
-    if (cachedNameSet)
-        return cachedNameSet;
-    cachedNameSet = new Set(loadDefinitions().map((a) => a.name));
-    return cachedNameSet;
+function getAchievementNameSet(category) {
+    const cached = cachedNameSets.get(category);
+    if (cached)
+        return cached;
+    const nameSet = new Set(loadDefinitions(category).map((a) => a.name));
+    cachedNameSets.set(category, nameSet);
+    return nameSet;
 }
 /**
  * キャラクターURL（例: `https://.../lodestone/character/12345/`）から characterId を抽出します。
@@ -129,51 +108,213 @@ function parseCharacterIdFromUrl(characterUrl) {
     return match?.[1];
 }
 /**
- * Lodestone のアチーブメント一覧URL（カテゴリ指定）を生成します。
+ * カテゴリ名から、LodestoneのカテゴリIDを取得します。
  */
-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();
+function getAchievementCategoryId(category) {
+    return loadCategoryDefinitions().get(category)?.categoryId;
 }
 /**
- * 互換用: 旧API名（`buildAchievementCategoryUrl`）。
+ * カテゴリ名を指定して、Lodestone のアチーブメント一覧URLを生成します。
  */
-function buildAchievementCategoryUrl(characterUrl) {
-    return buildHighEndAchievementCategoryUrl(characterUrl);
+function buildAchievementCategoryUrlByCategory(characterUrl, category) {
+    const categoryId = getAchievementCategoryId(category);
+    if (!categoryId)
+        return undefined;
+    const characterId = parseCharacterIdFromUrl(characterUrl);
+    if (!characterId)
+        return undefined;
+    return new URL(`/lodestone/character/${characterId}/achievement/category/${categoryId}/#anchor_achievement`, LODESTONE_BASE_URL).toString();
 }
 /**
- * アチーブメント一覧HTMLから、指定した高難度（絶/零式）アチーブの達成状況を判定します。
+ * アチーブメント一覧HTMLから、指定カテゴリのアチーブ達成状況を抽出します。
  *
- * 判定方法:
- * - 対象の `<li class="entry">` 内に `time.entry__activity__time` が存在するか（=日付が入る）
+ * - `date` が取得できない場合は `null`
+ * - 対象アチーブが1件も見つからない場合は `private`
  */
-function parseHighEndClearsFromAchievementHtml(html) {
+function parseAchievementDetailsFromHtml(html, characterUrl, category) {
     const $ = cheerio.load(html);
-    const targetSet = getHighEndAchievementNameSet();
-    const clears = new Set();
+    const targetSet = getAchievementNameSet(category);
+    const entries = [];
     let foundAny = false;
+    const totalEntries = $("li.entry").length;
+    const bodyText = $("body").text();
+    const isPrivate = bodyText.includes("非公開") || bodyText.includes("プライバシー") || bodyText.includes("公開されていません");
+    if (!html.trim()) {
+        return {
+            status: "ng",
+            reason: "empty_html",
+            lodestone: characterUrl,
+            achievements: { [category]: [] }
+        };
+    }
+    const parseDate = (raw) => {
+        const text = raw.trim();
+        if (!text)
+            return null;
+        const match = text.match(/ldst_strftime\((\d+),\s*'YMD'\)/);
+        if (!match)
+            return text;
+        const seconds = Number(match[1]);
+        if (!Number.isFinite(seconds))
+            return null;
+        const date = new Date(seconds * 1000);
+        const y = date.getFullYear();
+        const m = String(date.getMonth() + 1).padStart(2, "0");
+        const d = String(date.getDate()).padStart(2, "0");
+        return `${y}/${m}/${d}`;
+    };
     $("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);
+        const rawDateText = entry.find("time.entry__activity__time").first().text();
+        const dateText = parseDate(rawDateText);
+        entries.push({ name, date: dateText });
     });
+    if (totalEntries === 0) {
+        return {
+            status: isPrivate ? "private" : "ng",
+            reason: isPrivate ? "achievements_private" : "structure_mismatch",
+            lodestone: characterUrl,
+            achievements: { [category]: [] }
+        };
+    }
+    if (!foundAny) {
+        return {
+            status: "ng",
+            reason: "structure_mismatch",
+            lodestone: characterUrl,
+            achievements: { [category]: [] }
+        };
+    }
     return {
-        status: foundAny ? "ok" : "private_or_unavailable",
-        clears: Array.from(clears)
+        status: "ok",
+        lodestone: characterUrl,
+        achievements: {
+            [category]: entries
+        }
     };
 }
+function extractAchievementDetailLinks(html) {
+    const $ = cheerio.load(html);
+    const map = new Map();
+    $("li.entry").each((_, el) => {
+        const entry = $(el);
+        const name = entry.find("p.entry__activity__txt").first().text().trim();
+        if (!name || map.has(name))
+            return;
+        const href = entry
+            .find("a")
+            .map((_, a) => $(a).attr("href"))
+            .get()
+            .find((h) => h && h.includes("/achievement/detail/"));
+        if (!href)
+            return;
+        const link = href.startsWith("http") ? href : `${LODESTONE_BASE_URL}${href}`;
+        map.set(name, link.split("#")[0]);
+    });
+    return map;
+}
+function parseAchievementRequirementFromDetailHtml(html) {
+    const $ = cheerio.load(html);
+    const text = $("p.achievement__base--text").first().text().trim();
+    return text || null;
+}
+async function fetchAchievementRequirement(detailUrl) {
+    const html = await fetchAchievementCategoryHtml(detailUrl);
+    return parseAchievementRequirementFromDetailHtml(html);
+}
 /**
- * 互換用: 旧API名（`parseUltimateClearsFromAchievementHtml`）。
+ * キャラクターURLとカテゴリを指定して、アチーブを取得して返します。
  */
-function parseUltimateClearsFromAchievementHtml(html) {
-    return parseHighEndClearsFromAchievementHtml(html);
+async function fetchAchievementDetailsByCategory(characterUrl, category) {
+    const categoryId = getAchievementCategoryId(category);
+    if (!categoryId) {
+        return {
+            status: "ng",
+            reason: "unknown_category",
+            lodestone: characterUrl,
+            achievements: { [category]: [] }
+        };
+    }
+    const achievementUrl = buildAchievementCategoryUrlByCategory(characterUrl, category);
+    if (!achievementUrl) {
+        return {
+            status: "ng",
+            reason: "invalid_character_url",
+            lodestone: characterUrl,
+            achievements: { [category]: [] }
+        };
+    }
+    try {
+        const html = await fetchAchievementCategoryHtml(achievementUrl);
+        const parsed = parseAchievementDetailsFromHtml(html, characterUrl, category);
+        if (parsed.status !== "ok")
+            return parsed;
+        const detailLinks = extractAchievementDetailLinks(html);
+        const entries = parsed.achievements[category] ?? [];
+        let cursor = 0;
+        const concurrency = 5;
+        async function worker() {
+            while (cursor < entries.length) {
+                const index = cursor++;
+                const entry = entries[index];
+                if (!entry || entry.requirement !== undefined)
+                    continue;
+                const link = detailLinks.get(entry.name);
+                if (!link) {
+                    entry.requirement = null;
+                    continue;
+                }
+                try {
+                    entry.requirement = await fetchAchievementRequirement(link);
+                }
+                catch {
+                    entry.requirement = null;
+                }
+            }
+        }
+        await Promise.all(Array.from({ length: concurrency }, () => worker()));
+        return parsed;
+    }
+    catch (error) {
+        if (axios_1.default.isAxiosError(error) && error.response?.status === 403) {
+            return {
+                status: "private",
+                reason: "http_403",
+                lodestone: characterUrl,
+                achievements: { [category]: [] }
+            };
+        }
+        return {
+            status: "ng",
+            reason: "http_error",
+            lodestone: characterUrl,
+            achievements: { [category]: [] }
+        };
+    }
+}
+/**
+ * 全カテゴリのアチーブを取得して返します。
+ */
+async function fetchAllAchievementDetails(characterUrl) {
+    const categories = getAchievementCategoryDefinitions().map((c) => c.category);
+    const result = {
+        status: "ok",
+        lodestone: characterUrl,
+        achievements: {}
+    };
+    for (const category of categories) {
+        const data = await fetchAchievementDetailsByCategory(characterUrl, category);
+        result.achievements[category] = data.achievements[category] ?? [];
+        if (data.status !== "ok" && result.status === "ok") {
+            result.status = data.status;
+            result.reason = data.reason;
+        }
+    }
+    return result;
 }
 /**
  * Lodestone のアチーブメント一覧ページを取得します。

package/dist/lodestoneAchievements.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@piyoraik/ffxiv-lodestone-character-lookup",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "description": "FFXIV Lodestone character lookup (search → character URL) and high-end achievement checks",
   "license": "MIT",
   "author": "",
@@ -28,7 +28,9 @@
   "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"
+    "prepublishOnly": "npm run build",
+    "test": "npm run build && node --test test/achievements.test.js && node test/integration-runner.js",
+    "update-readme-requirements": "node scripts/update-readme-requirements.cjs"
   },
   "dependencies": {
     "axios": "^1.7.9",