ffxiv_ptfinder 1.0.1

package/dist/extractListings.js

@@ -0,0 +1,146 @@
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractListingsFromHtml = extractListingsFromHtml;
+const cheerio = __importStar(require("cheerio"));
+/**
+ * HTML から取り出したテキストを、出力用に読みやすく正規化します。
+ */
+function normalizeText(text) {
+    return text
+        .replace(/\r\n/g, "\n")
+        .replace(/[ \t]+/g, " ")
+        .replace(/\n[ \t]+/g, "\n")
+        .trim();
+}
+/**
+ * class 属性（スペース区切り）を配列に分解します。
+ */
+function splitClassList(value) {
+    return (value ?? "").split(/\s+/).map((s) => s.trim()).filter(Boolean);
+}
+/**
+ * 募集一覧の要素（`.listing[data-id]`）を取得します。
+ * 可能なら `#listings` 配下から取り、なければドキュメント全体から探索します。
+ */
+function selectListingElements($) {
+    const listingsRoot = $("#listings");
+    return listingsRoot.length
+        ? listingsRoot.find("div.listing[data-id]")
+        : $("div.listing[data-id]");
+}
+/**
+ * `.listing` 要素から duty 情報（class と title）を抽出します。
+ */
+function parseDuty(listing) {
+    const dutyNode = listing.find(".duty").first();
+    if (!dutyNode.length)
+        return undefined;
+    const text = normalizeText(dutyNode.text());
+    const title = (dutyNode.attr("title") ?? text).trim();
+    if (!title)
+        return undefined;
+    return { classList: splitClassList(dutyNode.attr("class")), title };
+}
+/**
+ * `.listing` 要素から description テキストを抽出します。
+ */
+function parseDescription(listing) {
+    const descriptionText = listing.find(".description").first().text();
+    return normalizeText(descriptionText);
+}
+/**
+ * `.listing` 要素から募集者（creator）を抽出します。
+ */
+function parseCreator(listing) {
+    const creatorText = listing.find(".right.meta .item.creator .text").first().text();
+    const normalized = normalizeText(creatorText);
+    return normalized.length > 0 ? normalized : undefined;
+}
+/**
+ * `.listing` 要素から party 情報（各 slot の class と title）を抽出します。
+ */
+function parseParty($, listing) {
+    const party = [];
+    const partyRoot = listing.find(".party").first();
+    if (!partyRoot.length)
+        return party;
+    partyRoot.children("div").each((_, child) => {
+        const node = $(child);
+        const classList = splitClassList(node.attr("class"));
+        if (classList.length === 0)
+            return;
+        const title = node.attr("title") ?? undefined;
+        party.push(title ? { classList, title } : { classList });
+    });
+    return party;
+}
+/**
+ * `.listing` 要素を `Listing` に変換します。
+ */
+function parseListingElement($, el) {
+    const listing = $(el);
+    const id = listing.attr("data-id");
+    if (!id)
+        return undefined;
+    return {
+        id,
+        dataCentre: listing.attr("data-centre") ?? undefined,
+        dataPfCategory: listing.attr("data-pf-category") ?? undefined,
+        duty: parseDuty(listing),
+        creator: parseCreator(listing),
+        requirements: [],
+        description: parseDescription(listing),
+        party: parseParty($, listing)
+    };
+}
+/**
+ * listings HTML から募集一覧を抽出します。
+ */
+function extractListingsFromHtml(html) {
+    const $ = cheerio.load(html);
+    const results = [];
+    const seenIds = new Set();
+    selectListingElements($).each((_, el) => {
+        const parsed = parseListingElement($, el);
+        if (!parsed)
+            return;
+        if (seenIds.has(parsed.id))
+            return;
+        seenIds.add(parsed.id);
+        results.push(parsed);
+    });
+    return results;
+}

package/dist/fetchHtml.js

@@ -0,0 +1,44 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isHttpUrl = isHttpUrl;
+exports.loadHtml = loadHtml;
+const axios_1 = __importDefault(require("axios"));
+const promises_1 = require("node:fs/promises");
+const config_1 = require("./config");
+/**
+ * 入力が HTTP(S) URL っぽい場合に true を返します。
+ */
+function isHttpUrl(value) {
+    return /^https?:\/\//i.test(value);
+}
+/**
+ * HTML をローカルファイル、または URL から読み込みます。
+ *
+ * URL の場合は `Cookie: lang=ja` を付与します。
+ * ※ Lambda(Node.js) の CommonJS から ESM 専用ライブラリを require できない問題を避けるため、
+ *   CookieJar は使わずヘッダで渡します（xivpf は通常リダイレクトしない想定）。
+ */
+async function loadHtml(input) {
+    if (!isHttpUrl(input)) {
+        return await (0, promises_1.readFile)(input, "utf8");
+    }
+    const response = await axios_1.default.get(input, {
+        responseType: "text",
+        maxRedirects: 5,
+        beforeRedirect: (options) => {
+            options.headers = options.headers ?? {};
+            options.headers["Cookie"] = config_1.DEFAULT_COOKIE;
+            options.headers["Accept-Language"] = "ja,en;q=0.8";
+        },
+        headers: {
+            Accept: "text/html,application/xhtml+xml",
+            "Accept-Language": "ja,en;q=0.8",
+            Cookie: config_1.DEFAULT_COOKIE,
+            "User-Agent": "ffxiv_ptfinder/1.0 (+https://xivpf.com)"
+        }
+    });
+    return response.data;
+}

package/dist/jobMaps.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildJobMaps = buildJobMaps;
+/**
+ * party の整形に使うジョブ変換マップを作成します。
+ */
+function buildJobMaps(jobs) {
+    const entries = Object.entries(jobs);
+    return {
+        codeToShort: new Map(entries.map(([code, info]) => [code, info.short])),
+        codeToRole: new Map(entries.map(([code, info]) => [code, info.role]))
+    };
+}

package/dist/jobs.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadJobsJa = loadJobsJa;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+let cachedJobs;
+/**
+ * `data/jobs_ja.json` を読み込みます（初回のみ読み取り、以後はキャッシュ）。
+ */
+async function loadJobsJa() {
+    if (cachedJobs)
+        return cachedJobs;
+    const filePath = (0, node_path_1.resolve)(process.cwd(), "data/jobs_ja.json");
+    const raw = await (0, promises_1.readFile)(filePath, "utf8");
+    cachedJobs = JSON.parse(raw);
+    return cachedJobs;
+}

package/dist/lambdaHandler.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handler = handler;
+const envOptions_1 = require("./envOptions");
+const runApp_1 = require("./runApp");
+const logger_1 = require("./logger");
+/**
+ * AWS Lambda handler。
+ *
+ * EventBridge のスケジュール実行を想定し、設定は環境変数のみで行います。
+ */
+async function handler(_event, context) {
+    const logger = (0, logger_1.createLogger)("lambda");
+    const startedAt = Date.now();
+    logger.info("invoke", { awsRequestId: context?.awsRequestId });
+    try {
+        const env = (0, envOptions_1.readEnvOptions)();
+        const options = (0, envOptions_1.resolveOptions)({}, env);
+        const result = await (0, runApp_1.runApp)(options);
+        logger.info("success", { awsRequestId: context?.awsRequestId, sent: result.sent, ms: Date.now() - startedAt });
+        return {
+            statusCode: 200,
+            headers: { "content-type": "application/json; charset=utf-8" },
+            body: JSON.stringify({ ok: true, sent: result.sent })
+        };
+    }
+    catch (err) {
+        logger.error("error", { awsRequestId: context?.awsRequestId, err, ms: Date.now() - startedAt });
+        throw err;
+    }
+}

package/dist/listingsPipeline.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildListings = buildListings;
+const extractListings_1 = require("./extractListings");
+const descriptionRequirements_1 = require("./descriptionRequirements");
+const descriptionTags_1 = require("./descriptionTags");
+const fetchHtml_1 = require("./fetchHtml");
+const config_1 = require("./config");
+const searchFilter_1 = require("./searchFilter");
+/**
+ * 対象DC（Elemental/Mana/Meteor/Gaia）のみに絞り込みます。
+ */
+function filterAllowedDataCentres(listings) {
+    return listings.filter((l) => l.dataCentre && config_1.ALLOWED_DATA_CENTRES.has(l.dataCentre));
+}
+/**
+ * HTML取得→募集抽出→DC/クエリ絞り込み→要件抽出、までを行います。
+ *
+ * Webhook送信やテキスト整形はこの関数の責務に含めません。
+ */
+async function buildListings(options) {
+    const html = await (0, fetchHtml_1.loadHtml)(options.input);
+    const allListings = (0, extractListings_1.extractListingsFromHtml)(html);
+    const dcFiltered = filterAllowedDataCentres(allListings);
+    const queryFiltered = dcFiltered;
+    const tagsJa = await (0, descriptionTags_1.loadDescriptionTagsJa)();
+    const tagged = (0, descriptionRequirements_1.applyDescriptionTags)(queryFiltered, tagsJa.tags);
+    const preFiltered = tagged;
+    if (!options.searchFilter)
+        return preFiltered;
+    const f = options.searchFilter;
+    return preFiltered.filter((l) => {
+        if (!(0, searchFilter_1.matchTextFilter)(l.duty?.title ?? "", f.dutyTitle))
+            return false;
+        if (!(0, searchFilter_1.matchTextFilter)(l.creator ?? "", f.creator))
+            return false;
+        if (f.dataCentres && f.dataCentres.length > 0 && !f.dataCentres.includes(l.dataCentre ?? ""))
+            return false;
+        if (f.pfCategories && f.pfCategories.length > 0 && !f.pfCategories.includes(l.dataPfCategory ?? ""))
+            return false;
+        if (!(0, searchFilter_1.matchTextFilter)(l.description ?? "", f.description))
+            return false;
+        if (!(0, searchFilter_1.matchTextFilter)((l.requirements ?? []).join(" "), f.requirements))
+            return false;
+        return true;
+    });
+}

package/dist/lodestone.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseTopCharacterUrlFromSearchHtml = exports.parseCreator = exports.fetchTopCharacterUrl = exports.buildLodestoneSearchUrl = void 0;
+var ffxiv_lodestone_character_lookup_1 = require("@piyoraik/ffxiv-lodestone-character-lookup");
+Object.defineProperty(exports, "buildLodestoneSearchUrl", { enumerable: true, get: function () { return ffxiv_lodestone_character_lookup_1.buildLodestoneSearchUrl; } });
+Object.defineProperty(exports, "fetchTopCharacterUrl", { enumerable: true, get: function () { return ffxiv_lodestone_character_lookup_1.fetchTopCharacterUrl; } });
+Object.defineProperty(exports, "parseCreator", { enumerable: true, get: function () { return ffxiv_lodestone_character_lookup_1.parseCreator; } });
+Object.defineProperty(exports, "parseTopCharacterUrlFromSearchHtml", { enumerable: true, get: function () { return ffxiv_lodestone_character_lookup_1.parseTopCharacterUrlFromSearchHtml; } });

package/dist/lodestoneAchievements.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseUltimateClearsFromAchievementHtml = exports.parseHighEndClearsFromAchievementHtml = exports.parseCharacterIdFromUrl = exports.getUltimateAchievementShortMap = exports.getUltimateAchievements = exports.getUltimateAchievementGroupMap = exports.getHighEndAchievementShortMap = exports.getHighEndAchievements = exports.getHighEndAchievementGroupMap = exports.fetchAchievementCategoryHtml = exports.buildHighEndAchievementCategoryUrl = exports.buildAchievementCategoryUrl = void 0;
+var ffxiv_lodestone_character_lookup_1 = require("@piyoraik/ffxiv-lodestone-character-lookup");
+Object.defineProperty(exports, "buildAchievementCategoryUrl", { enumerable: true, get: function () { return ffxiv_lodestone_character_lookup_1.buildAchievementCategoryUrl; } });
+Object.defineProperty(exports, "buildHighEndAchievementCategoryUrl", { enumerable: true, get: function () { return ffxiv_lodestone_character_lookup_1.buildHighEndAchievementCategoryUrl; } });
+Object.defineProperty(exports, "fetchAchievementCategoryHtml", { enumerable: true, get: function () { return ffxiv_lodestone_character_lookup_1.fetchAchievementCategoryHtml; } });
+Object.defineProperty(exports, "getHighEndAchievementGroupMap", { enumerable: true, get: function () { return ffxiv_lodestone_character_lookup_1.getHighEndAchievementGroupMap; } });
+Object.defineProperty(exports, "getHighEndAchievements", { enumerable: true, get: function () { return ffxiv_lodestone_character_lookup_1.getHighEndAchievements; } });
+Object.defineProperty(exports, "getHighEndAchievementShortMap", { enumerable: true, get: function () { return ffxiv_lodestone_character_lookup_1.getHighEndAchievementShortMap; } });
+Object.defineProperty(exports, "getUltimateAchievementGroupMap", { enumerable: true, get: function () { return ffxiv_lodestone_character_lookup_1.getUltimateAchievementGroupMap; } });
+Object.defineProperty(exports, "getUltimateAchievements", { enumerable: true, get: function () { return ffxiv_lodestone_character_lookup_1.getUltimateAchievements; } });
+Object.defineProperty(exports, "getUltimateAchievementShortMap", { enumerable: true, get: function () { return ffxiv_lodestone_character_lookup_1.getUltimateAchievementShortMap; } });
+Object.defineProperty(exports, "parseCharacterIdFromUrl", { enumerable: true, get: function () { return ffxiv_lodestone_character_lookup_1.parseCharacterIdFromUrl; } });
+Object.defineProperty(exports, "parseHighEndClearsFromAchievementHtml", { enumerable: true, get: function () { return ffxiv_lodestone_character_lookup_1.parseHighEndClearsFromAchievementHtml; } });
+Object.defineProperty(exports, "parseUltimateClearsFromAchievementHtml", { enumerable: true, get: function () { return ffxiv_lodestone_character_lookup_1.parseUltimateClearsFromAchievementHtml; } });

package/dist/lodestoneEnrichment.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLodestoneEnrichmentCache = createLodestoneEnrichmentCache;
+exports.enrichListingWithLodestone = enrichListingWithLodestone;
+const ffxiv_lodestone_character_lookup_1 = require("@piyoraik/ffxiv-lodestone-character-lookup");
+const ffxiv_lodestone_character_lookup_2 = require("@piyoraik/ffxiv-lodestone-character-lookup");
+/**
+ * Lodestone補完（検索URL/キャラクターURL/アチーブ取得）用のキャッシュを作成します。
+ *
+ * 同一募集者が複数回出てくるケースがあるため、1実行内で使い回します。
+ */
+function createLodestoneEnrichmentCache() {
+    return new Map();
+}
+/**
+ * 募集者情報（`Name @ World`）から Lodestone の検索URL/キャラクターURL/アチーブ達成状況を補完します。
+ *
+ * 検索の結果、先頭にヒットしたURLが取得できない場合でも、検索URLはセットします。
+ */
+async function enrichListingWithLodestone(listing, cache) {
+    const creator = listing.creator?.trim();
+    if (!creator)
+        return listing;
+    const cached = cache.get(creator);
+    if (cached) {
+        return {
+            ...listing,
+            creatorLodestoneSearchUrl: cached.searchUrl,
+            creatorLodestoneUrl: cached.characterUrl,
+            creatorAchievementUrl: cached.achievementUrl,
+            creatorUltimateClears: cached.ultimateClears,
+            creatorUltimateClearsStatus: cached.ultimateStatus
+        };
+    }
+    const info = (0, ffxiv_lodestone_character_lookup_2.parseCreator)(creator);
+    if (!info)
+        return listing;
+    const searchUrl = (0, ffxiv_lodestone_character_lookup_2.buildLodestoneSearchUrl)(info);
+    let characterUrl;
+    let achievementUrl;
+    let ultimateStatus;
+    let ultimateClears;
+    try {
+        characterUrl = await (0, ffxiv_lodestone_character_lookup_2.fetchTopCharacterUrl)(searchUrl);
+    }
+    catch {
+        // 失敗しても後続処理は継続する
+        characterUrl = undefined;
+    }
+    if (characterUrl) {
+        achievementUrl = (0, ffxiv_lodestone_character_lookup_1.buildAchievementCategoryUrl)(characterUrl);
+        if (achievementUrl) {
+            try {
+                const html = await (0, ffxiv_lodestone_character_lookup_1.fetchAchievementCategoryHtml)(achievementUrl);
+                const parsed = (0, ffxiv_lodestone_character_lookup_1.parseUltimateClearsFromAchievementHtml)(html);
+                ultimateStatus = parsed.status;
+                ultimateClears = parsed.clears;
+            }
+            catch {
+                ultimateStatus = "error";
+                ultimateClears = undefined;
+            }
+        }
+    }
+    cache.set(creator, { searchUrl, characterUrl, achievementUrl, ultimateStatus, ultimateClears });
+    return {
+        ...listing,
+        creatorLodestoneSearchUrl: searchUrl,
+        creatorLodestoneUrl: characterUrl,
+        creatorAchievementUrl: achievementUrl,
+        creatorUltimateClears: ultimateClears,
+        creatorUltimateClearsStatus: ultimateStatus
+    };
+}

package/dist/logger.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLogger = createLogger;
+function serializeError(err) {
+    if (err instanceof Error) {
+        return {
+            name: err.name,
+            message: err.message,
+            stack: err.stack
+        };
+    }
+    return { message: String(err) };
+}
+function toLogObject(params) {
+    const base = {
+        ts: new Date().toISOString(),
+        level: params.level,
+        component: params.component,
+        message: params.message
+    };
+    const fields = params.fields ?? {};
+    for (const [key, value] of Object.entries(fields)) {
+        if (value instanceof Error)
+            base[key] = serializeError(value);
+        else if (value !== undefined)
+            base[key] = value;
+    }
+    return base;
+}
+/**
+ * CloudWatch Logs で追いやすい JSON 1行ログを出すための logger を作ります。
+ */
+function createLogger(component) {
+    const write = (level, message, fields) => {
+        // 1行JSONに揃える（CloudWatch上でフィルタしやすくする）
+        const obj = toLogObject({ level, component, message, fields });
+        process.stdout.write(JSON.stringify(obj) + "\n");
+    };
+    return {
+        debug: (message, fields) => write("debug", message, fields),
+        info: (message, fields) => write("info", message, fields),
+        warn: (message, fields) => write("warn", message, fields),
+        error: (message, fields) => write("error", message, fields)
+    };
+}

package/dist/notifyCli.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const cliOptions_1 = require("./cliOptions");
+const envOptions_1 = require("./envOptions");
+const runApp_1 = require("./runApp");
+/**
+ * パイプ出力時（例: `| head`）の EPIPE を無視するハンドラを登録します。
+ */
+function installStdoutEpipeHandler() {
+    process.stdout.on("error", (err) => {
+        if (err.code === "EPIPE")
+            process.exit(0);
+        throw err;
+    });
+}
+/**
+ * 通知（Webhook送信）用 CLI。
+ * EventBridge/Lambda と同じ `runApp` を呼び出して実行します。
+ */
+async function main() {
+    installStdoutEpipeHandler();
+    const cliOptions = (0, cliOptions_1.parseCliArgs)(process.argv.slice(2));
+    const envOptions = (0, envOptions_1.readEnvOptions)();
+    const options = (0, envOptions_1.resolveOptions)(cliOptions, envOptions);
+    await (0, runApp_1.runApp)(options);
+}
+main().catch((err) => {
+    const message = err instanceof Error ? err.stack ?? err.message : String(err);
+    process.stderr.write(message + "\n");
+    process.exitCode = 1;
+});

package/dist/partyText.js

@@ -0,0 +1,133 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.splitJobList = splitJobList;
+exports.getRolesFromClassList = getRolesFromClassList;
+exports.getRoleFromJobCode = getRoleFromJobCode;
+exports.buildPartyGroups = buildPartyGroups;
+exports.formatListingText = formatListingText;
+exports.formatListingsText = formatListingsText;
+const ffxiv_lodestone_character_lookup_1 = require("@piyoraik/ffxiv-lodestone-character-lookup");
+/**
+ * `title` 内のスペース区切りジョブコードを分割します。
+ */
+function splitJobList(value) {
+    return value
+        .split(/\s+/)
+        .map((s) => s.trim())
+        .filter(Boolean);
+}
+/**
+ * party の classList からロールヒント（`tank`/`healer`/`dps`）を取得します。
+ */
+function getRolesFromClassList(classList) {
+    const roles = [];
+    if (classList.includes("tank"))
+        roles.push("tank");
+    if (classList.includes("healer"))
+        roles.push("healer");
+    if (classList.includes("dps"))
+        roles.push("dps");
+    return roles;
+}
+/**
+ * ジョブコードからロールを解決します（ルックアップマップを使用）。
+ */
+function getRoleFromJobCode(jobCode, jobCodeToRole) {
+    return jobCodeToRole.get(jobCode);
+}
+function formatLine(label, values) {
+    const text = Array.from(values).join(" ");
+    return `${label}：${text}`;
+}
+function createEmptyPartyGroups() {
+    return {
+        joined: { tank: [], healer: [], dps: [] },
+        recruiting: { tank: new Set(), healer: new Set(), dps: new Set() }
+    };
+}
+/**
+ * listing の `party` 配列から、ロール別の参加/募集情報を組み立てます。
+ */
+function buildPartyGroups(listing, codeToShort, codeToRole) {
+    const groups = createEmptyPartyGroups();
+    for (const item of listing.party) {
+        if (item.classList.includes("total"))
+            continue;
+        const title = item.title?.trim();
+        if (!title)
+            continue;
+        if (item.classList.includes("filled")) {
+            const role = getRoleFromJobCode(title, codeToRole);
+            if (!role)
+                continue;
+            groups.joined[role].push(codeToShort.get(title) ?? title);
+            continue;
+        }
+        const rolesFromClass = getRolesFromClassList(item.classList);
+        for (const job of splitJobList(title)) {
+            const short = codeToShort.get(job) ?? job;
+            const roleFromCode = getRoleFromJobCode(job, codeToRole);
+            if (rolesFromClass.length > 0) {
+                for (const role of rolesFromClass)
+                    groups.recruiting[role].add(short);
+                continue;
+            }
+            if (roleFromCode)
+                groups.recruiting[roleFromCode].add(short);
+        }
+    }
+    return groups;
+}
+/**
+ * 1件の募集をテキストブロックとして整形します。
+ */
+function formatListingText(listing, codeToShort, codeToRole) {
+    const { joined, recruiting } = buildPartyGroups(listing, codeToShort, codeToRole);
+    return [
+        `コンテンツ: ${listing.duty?.title ?? ""}`,
+        `募集者: ${listing.creator ?? ""}`,
+        `ロードストーン: ${listing.creatorLodestoneUrl ?? listing.creatorLodestoneSearchUrl ?? ""}`,
+        `絶クリア: ${formatHighEndClears(listing, "ultimate")}`,
+        `零式クリア: ${formatHighEndClears(listing, "savage")}`,
+        `DC: ${listing.dataCentre ?? ""}`,
+        `カテゴリ: ${listing.dataPfCategory ?? ""}`,
+        `要件: ${listing.requirements.join(" ")}`,
+        `募集文: ${listing.description}`,
+        "パーティ:",
+        "【参加ジョブ】",
+        formatLine("タンク", joined.tank),
+        formatLine("ヒーラー", joined.healer),
+        formatLine("DPS", joined.dps),
+        "【募集ジョブ】",
+        formatLine("タンク", recruiting.tank),
+        formatLine("ヒーラー", recruiting.healer),
+        formatLine("DPS", recruiting.dps)
+    ].join("\n");
+}
+/**
+ * 高難度（絶/零式）アチーブ達成状況を表示用に整形します。
+ */
+function formatHighEndClears(listing, group) {
+    if (!listing.creatorAchievementUrl && !listing.creatorLodestoneUrl)
+        return "";
+    const status = listing.creatorUltimateClearsStatus;
+    if (status === "private_or_unavailable")
+        return "非公開/取得不可";
+    if (status === "error")
+        return "取得エラー";
+    const clears = listing.creatorUltimateClears ?? [];
+    if (clears.length === 0)
+        return "なし";
+    const shortMap = (0, ffxiv_lodestone_character_lookup_1.getUltimateAchievementShortMap)();
+    const groupMap = (0, ffxiv_lodestone_character_lookup_1.getUltimateAchievementGroupMap)();
+    const short = clears
+        .filter((name) => groupMap.get(name) === group)
+        .map((name) => shortMap.get(name) ?? name);
+    return short.length > 0 ? short.join(" / ") : "なし";
+}
+/**
+ * 複数募集を空行区切りで整形します。
+ */
+function formatListingsText(listings, codeToShort, codeToRole) {
+    return listings.map((l) => formatListingText(l, codeToShort, codeToRole)).join("\n\n");
+}