backlog-exporter 0.7.2 → 1.0.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "backlog-exporter",
   "description": "A new CLI generated with oclif",
-  "version": "0.7.2",
+  "version": "1.0.0",
   "author": "ShuntaToda",
   "bin": {
     "backlog-exporter": "bin/run.js"
@@ -10,31 +10,25 @@
   "dependencies": {
     "@oclif/core": "^4",
     "@oclif/plugin-help": "^6",
-    "@oclif/plugin-plugins": "^5",
-    "dotenv": "^16.4.7",
-    "ky": "^1.7.5"
+    "@oclif/plugin-not-found": "^3.2.88",
+    "@oclif/plugin-plugins": "^5"
   },
   "devDependencies": {
     "@eslint/compat": "^1",
     "@oclif/prettier-config": "^0.2.1",
     "@oclif/test": "^4",
-    "@types/chai": "^4",
-    "@types/mocha": "^10",
-    "@types/node": "^18",
-    "chai": "^4",
+    "@types/node": "^22.20.0",
     "eslint": "^9",
     "eslint-config-oclif": "^6",
     "eslint-config-prettier": "^10",
-    "mocha": "^10",
-    "nock": "^14.0.1",
     "oclif": "^4",
     "prettier": "^3.6.2",
-    "shx": "^0.3.3",
-    "ts-node": "^10",
-    "typescript": "^5"
+    "tsx": "^4.23.0",
+    "typescript": "^5",
+    "vitest": "^4.1.10"
   },
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=22.0.0"
   },
   "files": [
     "./bin",
@@ -54,7 +48,8 @@
     "commands": "./dist/commands",
     "plugins": [
       "@oclif/plugin-help",
-      "@oclif/plugin-plugins"
+      "@oclif/plugin-plugins",
+      "@oclif/plugin-not-found"
     ],
     "topicSeparator": " ",
     "topics": {
@@ -68,15 +63,16 @@
     "url": "git+https://github.com/ShuntaToda/backlog-exporter.git"
   },
   "scripts": {
-    "build": "shx rm -rf dist && tsc -b",
+    "build": "node -e \"fs.rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.build.json",
     "format": "prettier --write .",
     "format:check": "prettier --check .",
     "lint": "eslint",
-    "postpack": "shx rm -f oclif.manifest.json",
+    "postpack": "node -e \"fs.rmSync('oclif.manifest.json',{force:true})\"",
     "posttest": "npm run lint",
     "prepack": "oclif manifest && oclif readme",
-    "test": "mocha --forbid-only \"test/**/*.test.ts\"",
-    "version": "oclif readme && git add README.md"
+    "test": "vitest run",
+    "version": "oclif readme && git add README.md",
+    "test:e2e": "npm run build && vitest run --config vitest.e2e.config.ts"
   },
   "types": "dist/index.d.ts"
 }

package/dist/utils/backlog-api.d.ts

@@ -1,74 +0,0 @@
-import { Command } from '@oclif/core';
-/**
- * カスタム属性セクションを作成する
- * @param customFields カスタム属性の配列
- * @returns Markdownテーブル形式のカスタム属性セクション
- */
-export declare function createCustomFieldsSection(customFields?: Array<{
-    id: number;
-    name: string;
-    value: unknown;
-}>): string;
-/**
- * Backlogから課題をダウンロードする
- * @param command コマンドインスタンス
- * @param options 課題ダウンロードのオプション
- * @param options.apiKey Backlog API key
- * @param options.count 取得する課題の最大数
- * @param options.domain Backlogのドメイン
- * @param options.lastUpdated 最終更新日時
- * @param options.outputDir 出力ディレクトリ
- * @param options.projectId プロジェクトID
- * @param options.statusId ステータスID
- * @param options.issueKeyFileName ファイル名を課題キーにするかどうか
- * @param options.issueKeyFolder 課題キーでフォルダを作成するかどうか
- */
-export declare function downloadIssues(command: Command, options: {
-    apiKey: string;
-    count?: number;
-    domain: string;
-    issueKeyFileName?: boolean;
-    issueKeyFolder?: boolean;
-    lastUpdated?: string;
-    outputDir: string;
-    projectId: number;
-    statusId?: string;
-}): Promise<void>;
-/**
- * BacklogからWikiをダウンロードする
- * @param command コマンドインスタンス
- * @param options Wikiダウンロードのオプション
- * @param options.apiKey Backlog API key
- * @param options.domain Backlogのドメイン
- * @param options.lastUpdated 最終更新日時
- * @param options.outputDir 出力ディレクトリ
- * @param options.projectIdOrKey プロジェクトIDまたはキー
- */
-export declare function downloadWikis(command: Command, options: {
-    apiKey: string;
-    domain: string;
-    lastUpdated?: string;
-    outputDir: string;
-    projectIdOrKey: string;
-}): Promise<void>;
-/**
- * Backlogからドキュメントをダウンロードする
- * @param command コマンドインスタンス
- * @param options ドキュメントダウンロードのオプション
- * @param options.apiKey Backlog API key
- * @param options.domain Backlogのドメイン
- * @param options.keyword キーワードフィルター
- * @param options.lastUpdated 最終更新日時
- * @param options.outputDir 出力ディレクトリ
- * @param options.projectId プロジェクトID
- * @param options.projectIdOrKey プロジェクトIDまたはキー
- */
-export declare function downloadDocuments(command: Command, options: {
-    apiKey: string;
-    domain: string;
-    keyword?: string;
-    lastUpdated?: string;
-    outputDir: string;
-    projectId: number;
-    projectIdOrKey: string;
-}): Promise<void>;

package/dist/utils/backlog-api.js

@@ -1,448 +0,0 @@
-import ky from 'ky';
-import * as fs from 'node:fs/promises';
-import path from 'node:path';
-import process from 'node:process';
-import { sanitizeFileName, sanitizeWikiFileName } from './common.js';
-import { appendLog } from './log.js';
-import { RateLimiter } from './sleep.js';
-/**
- * カスタム属性セクションを作成する
- * @param customFields カスタム属性の配列
- * @returns Markdownテーブル形式のカスタム属性セクション
- */
-export function createCustomFieldsSection(customFields) {
-    if (!customFields || customFields.length === 0) {
-        return '';
-    }
-    let customFieldsSection = '\n\n## カスタム属性\n\n| 属性名 | 値 |\n|--------|----|\n';
-    for (const customField of customFields) {
-        let fieldValue = 'なし';
-        if (customField.value !== null && customField.value !== undefined) {
-            if (Array.isArray(customField.value)) {
-                // 配列の場合（複数選択など）
-                fieldValue = customField.value
-                    .map((item) => item.name || item.value || String(item))
-                    .join(', ');
-            }
-            else if (typeof customField.value === 'object' && customField.value !== null) {
-                // オブジェクトの場合（単一選択など）
-                const valueObj = customField.value;
-                fieldValue = valueObj.name || valueObj.value || String(customField.value);
-            }
-            else {
-                // プリミティブ値の場合
-                fieldValue = String(customField.value);
-            }
-        }
-        // テーブル内では改行をHTMLの<br>タグに変換し、パイプ文字をエスケープ
-        const escapedFieldValue = fieldValue.replaceAll('|', String.raw `\|`).replaceAll('\n', '<br>');
-        customFieldsSection += `| ${customField.name} | ${escapedFieldValue} |\n`;
-    }
-    return customFieldsSection;
-}
-/**
- * Backlogから課題をダウンロードする
- * @param command コマンドインスタンス
- * @param options 課題ダウンロードのオプション
- * @param options.apiKey Backlog API key
- * @param options.count 取得する課題の最大数
- * @param options.domain Backlogのドメイン
- * @param options.lastUpdated 最終更新日時
- * @param options.outputDir 出力ディレクトリ
- * @param options.projectId プロジェクトID
- * @param options.statusId ステータスID
- * @param options.issueKeyFileName ファイル名を課題キーにするかどうか
- * @param options.issueKeyFolder 課題キーでフォルダを作成するかどうか
- */
-export async function downloadIssues(command, options) {
-    const baseUrl = `https://${options.domain}/api/v2`;
-    command.log('課題の取得を開始します...');
-    // 全ての課題を格納する配列
-    let allIssues = [];
-    // countのデフォルト値を5000に設定
-    const count = options.count ?? 5000;
-    const maxCount = Math.min(count, 100); // APIの制限は100件
-    // APIリクエスト数をカウントするためのRateLimiterを作成
-    const rateLimiter = new RateLimiter(command);
-    // 課題を取得する関数
-    const fetchIssues = async (offset) => {
-        // APIリクエスト数をインクリメント
-        await rateLimiter.increment();
-        // APIパラメータの構築
-        const params = new URLSearchParams({
-            apiKey: options.apiKey,
-            count: maxCount.toString(),
-            offset: offset.toString(),
-            'projectId[]': options.projectId.toString(),
-        });
-        // ステータスIDが指定されている場合は追加
-        if (options.statusId) {
-            params.append('statusId[]', options.statusId);
-        }
-        // 進捗状況を一行で更新
-        process.stdout.write(`\r課題を取得中... (${allIssues.length}件取得済み)`);
-        return ky.get(`${baseUrl}/issues?${params.toString()}`).json();
-    };
-    // 再帰的に全ての課題を取得
-    const fetchAllIssues = async (offset) => {
-        try {
-            const issues = await fetchIssues(offset);
-            // 取得した課題を追加
-            allIssues = [...allIssues, ...issues];
-            // 次のページがあるかどうかを確認
-            if (issues.length === maxCount) {
-                // 次のページを取得
-                await fetchAllIssues(offset + maxCount);
-            }
-        }
-        catch (error) {
-            command.error(`課題の取得に失敗しました: ${error instanceof Error ? error.message : String(error)}`);
-        }
-    };
-    // 課題取得開始
-    await fetchAllIssues(0);
-    command.log(`\n合計 ${allIssues.length}件の課題が見つかりました。`);
-    // 前回の更新日時より新しい課題のみをフィルタリング
-    let filteredIssues = allIssues;
-    if (options.lastUpdated) {
-        const lastUpdatedDate = new Date(options.lastUpdated);
-        filteredIssues = allIssues.filter((issue) => {
-            const issueUpdatedDate = new Date(issue.updated);
-            return issueUpdatedDate > lastUpdatedDate;
-        });
-        command.log(`前回の更新日時(${options.lastUpdated})以降に更新された${filteredIssues.length}件の課題を処理します。`);
-    }
-    if (filteredIssues.length === 0) {
-        command.log('更新が必要な課題はありません。');
-        return;
-    }
-    // 各課題の詳細情報を取得して保存
-    command.log('課題を保存しています...');
-    // 並列処理ではなく順次処理に変更
-    for (const issue of filteredIssues) {
-        try {
-            // 進捗状況を一行で更新
-            const currentIndex = filteredIssues.indexOf(issue) + 1;
-            process.stdout.write(`\r課題を保存中... (${currentIndex}/${filteredIssues.length}件)`);
-            // BacklogのIssueへのリンクを作成
-            const backlogIssueUrl = `https://${options.domain}/view/${issue.issueKey}`;
-            // コメントを取得する関数を呼び出し
-            // eslint-disable-next-line no-await-in-loop
-            const { comments: allComments } = await fetchAllCommentsForIssue({
-                apiKey: options.apiKey,
-                baseUrl,
-                command,
-                issueKey: issue.issueKey,
-                rateLimiter,
-            });
-            // コメントセクションを作成
-            let commentsSection = '';
-            if (allComments.length > 0) {
-                commentsSection = '\n\n## コメント\n';
-                let commentIndex = 1;
-                for (const comment of allComments) {
-                    const commentDate = new Date(comment.created).toLocaleString('ja-JP');
-                    commentsSection += `\n### コメント ${commentIndex}\n- **投稿者**: ${comment.createdUser.name}\n- **日時**: ${commentDate}\n\n${comment.content || '(内容なし)'}\n\n---\n`;
-                    commentIndex++;
-                }
-                // 最後の区切り線を削除
-                commentsSection = commentsSection.slice(0, -5);
-            }
-            // 課題の作成年を取得
-            const createdYear = new Date(issue.created).getFullYear();
-            // 年ごとのフォルダパスを作成
-            const yearDirPath = path.join(options.outputDir, createdYear.toString());
-            // 年ごとのフォルダを作成
-            // eslint-disable-next-line no-await-in-loop
-            await fs.mkdir(yearDirPath, { recursive: true });
-            let issueFilePath;
-            let issueFileName;
-            if (options.issueKeyFolder) {
-                // 年ごとのフォルダ内に、課題キーでフォルダを作成
-                const issueKeyDirPath = path.join(yearDirPath, issue.issueKey);
-                // eslint-disable-next-line no-await-in-loop
-                await fs.mkdir(issueKeyDirPath, { recursive: true });
-                // ファイル名を課題名（標準）にするか課題キーにするかを決定
-                issueFileName = options.issueKeyFileName ? `${issue.issueKey}.md` : `${sanitizeFileName(issue.summary)}.md`;
-                issueFilePath = path.join(issueKeyDirPath, issueFileName);
-            }
-            else {
-                // 年ごとのフォルダ内に、Markdownファイルを作成
-                issueFileName = options.issueKeyFileName ? `${issue.issueKey}.md` : `${sanitizeFileName(issue.summary)}.md`;
-                issueFilePath = path.join(yearDirPath, issueFileName);
-            }
-            // カスタム属性セクションを作成
-            const customFieldsSection = createCustomFieldsSection(issue.customFields);
-            // Markdownファイルに書き込む
-            const assigneeName = issue.assignee ? issue.assignee.name : '未割り当て';
-            const markdownContent = `# ${issue.summary}
-
-## 基本情報
-- 課題キー: ${issue.issueKey}
-- ステータス: ${issue.status.name}
-- 優先度: ${issue.priority.name}
-- 担当者: ${assigneeName}
-- 作成日時: ${new Date(issue.created).toLocaleString('ja-JP')}
-- 更新日時: ${new Date(issue.updated).toLocaleString('ja-JP')}
-- [Backlog Issue Link](${backlogIssueUrl})${customFieldsSection}
-
-## 詳細
-${issue.description || '詳細情報なし'}${commentsSection}`;
-            // eslint-disable-next-line no-await-in-loop
-            await fs.writeFile(issueFilePath, markdownContent);
-            // ログに記録
-            // eslint-disable-next-line no-await-in-loop
-            await appendLog(options.outputDir, `課題「${issue.summary}」を更新しました: ${backlogIssueUrl}`);
-        }
-        catch (error) {
-            command.warn(`課題 ${issue.issueKey} の保存に失敗しました: ${error instanceof Error ? error.message : String(error)}`);
-        }
-    }
-    command.log('\n課題のダウンロードが完了しました！');
-}
-/**
- * 課題のコメントを全て取得する
- */
-async function fetchAllCommentsForIssue({ apiKey, baseUrl, command, issueKey, rateLimiter, }) {
-    const allComments = [];
-    const fetchComments = async (minId) => {
-        // APIリクエスト数をインクリメント
-        await rateLimiter.increment();
-        let url = `${baseUrl}/issues/${issueKey}/comments?apiKey=${apiKey}&count=100`;
-        if (minId) {
-            url += `&minId=${minId}`;
-        }
-        const comments = await ky.get(url).json();
-        allComments.push(...comments);
-        if (comments.length === 100) {
-            // 取得したコメントの最後のIDを次のリクエストのminIdとして使用
-            const lastCommentId = comments.at(-1).id;
-            await fetchComments(lastCommentId + 1);
-        }
-    };
-    try {
-        await fetchComments();
-        // コメントを古い順（昇順）に並び替える
-        allComments.sort((a, b) => new Date(a.created).getTime() - new Date(b.created).getTime());
-        return { comments: allComments };
-    }
-    catch (error) {
-        command.warn(`課題 ${issueKey} のコメント取得に失敗しました: ${error instanceof Error ? error.message : String(error)}`);
-        return { comments: allComments };
-    }
-}
-/**
- * BacklogからWikiをダウンロードする
- * @param command コマンドインスタンス
- * @param options Wikiダウンロードのオプション
- * @param options.apiKey Backlog API key
- * @param options.domain Backlogのドメイン
- * @param options.lastUpdated 最終更新日時
- * @param options.outputDir 出力ディレクトリ
- * @param options.projectIdOrKey プロジェクトIDまたはキー
- */
-export async function downloadWikis(command, options) {
-    const baseUrl = `https://${options.domain}/api/v2`;
-    command.log('Wikiの取得を開始します...');
-    // APIリクエスト数をカウントするためのRateLimiterを作成
-    const rateLimiter = new RateLimiter(command);
-    // Wiki一覧の取得
-    command.log('Wiki一覧を取得しています...');
-    // APIリクエスト数をインクリメント
-    await rateLimiter.increment();
-    const wikis = await ky
-        .get(`${baseUrl}/wikis?apiKey=${options.apiKey}&projectIdOrKey=${options.projectIdOrKey}`)
-        .json();
-    command.log(`${wikis.length}件のWikiが見つかりました。`);
-    // 前回の更新日時より新しいWikiのみをフィルタリング
-    let filteredWikis = wikis;
-    if (options.lastUpdated) {
-        const lastUpdatedDate = new Date(options.lastUpdated);
-        filteredWikis = wikis.filter((wiki) => {
-            const wikiUpdatedDate = new Date(wiki.updated);
-            return wikiUpdatedDate > lastUpdatedDate;
-        });
-        command.log(`前回の更新日時(${options.lastUpdated})以降に更新された${filteredWikis.length}件のWikiを処理します。`);
-    }
-    if (filteredWikis.length === 0) {
-        command.log('更新が必要なWikiはありません。');
-        return;
-    }
-    // 各Wikiの詳細情報を取得
-    command.log('Wiki詳細を取得しています...');
-    // 並列処理ではなく順次処理に変更
-    for (const wiki of filteredWikis) {
-        const wikiId = wiki.id;
-        try {
-            // APIリクエスト数をインクリメント
-            // eslint-disable-next-line no-await-in-loop
-            await rateLimiter.increment();
-            // 進捗状況を一行で更新
-            const currentIndex = filteredWikis.indexOf(wiki) + 1;
-            process.stdout.write(`\rWikiを取得中... (${currentIndex}/${filteredWikis.length}件)`);
-            // eslint-disable-next-line no-await-in-loop
-            const wikiDetail = await ky
-                .get(`${baseUrl}/wikis/${wikiId}?projectIdOrKey=${options.projectIdOrKey}&apiKey=${options.apiKey}`)
-                .json();
-            // Wikiの名前をファイルパスとして使用
-            const wikiName = wiki.name;
-            // ファイル名のサニタイズ
-            const sanitizedName = sanitizeWikiFileName(wikiName);
-            // ファイル名の拡張子を追加
-            const wikiFileName = `${sanitizedName}.md`;
-            // ディレクトリ構造を作成（必要な場合）
-            const dirPath = path.dirname(wikiFileName);
-            if (dirPath !== '.') {
-                // eslint-disable-next-line no-await-in-loop
-                await fs.mkdir(path.join(options.outputDir, dirPath), { recursive: true });
-            }
-            // Markdownファイルを保存
-            const wikiFilePath = path.join(options.outputDir, wikiFileName);
-            // JSONからcontentフィールドを取得
-            const content = wikiDetail.content || '';
-            // BacklogのWikiへのリンクを作成
-            const backlogWikiUrl = `https://${options.domain}/alias/wiki/${wikiId}`;
-            // Markdownファイルに書き込む（タイトルとBacklogリンクを追加）
-            const markdownContent = `# ${wiki.name}\n\n[Backlog Wiki Link](${backlogWikiUrl})\n\n${content}`;
-            // eslint-disable-next-line no-await-in-loop
-            await fs.writeFile(wikiFilePath, markdownContent);
-            // ログに記録
-            // eslint-disable-next-line no-await-in-loop
-            await appendLog(options.outputDir, `Wiki「${wiki.name}」を更新しました: ${backlogWikiUrl}`);
-            // 進捗状況を一行で更新
-            const wikiIndex = filteredWikis.indexOf(wiki) + 1;
-            process.stdout.write(`\rWikiを保存中... (${wikiIndex}/${filteredWikis.length}件)`);
-        }
-        catch (error) {
-            command.warn(`Wiki ${wiki.name} の取得に失敗しました: ${error instanceof Error ? error.message : String(error)}`);
-        }
-    }
-    command.log('\nWikiのダウンロードが完了しました！');
-}
-/**
- * Backlogからドキュメントをダウンロードする
- * @param command コマンドインスタンス
- * @param options ドキュメントダウンロードのオプション
- * @param options.apiKey Backlog API key
- * @param options.domain Backlogのドメイン
- * @param options.keyword キーワードフィルター
- * @param options.lastUpdated 最終更新日時
- * @param options.outputDir 出力ディレクトリ
- * @param options.projectId プロジェクトID
- * @param options.projectIdOrKey プロジェクトIDまたはキー
- */
-export async function downloadDocuments(command, options) {
-    const baseUrl = `https://${options.domain}/api/v2`;
-    command.log('ドキュメントの取得を開始します...');
-    // APIリクエスト数をカウントするためのRateLimiterを作成
-    const rateLimiter = new RateLimiter(command);
-    // ドキュメントツリーの取得
-    command.log('ドキュメントツリーを取得しています...');
-    // APIリクエスト数をインクリメント
-    await rateLimiter.increment();
-    const documentTree = await ky
-        .get(`${baseUrl}/documents/tree?projectIdOrKey=${options.projectId}&apiKey=${options.apiKey}`)
-        .json();
-    command.log('アクティブなドキュメントツリーを処理します...');
-    // ツリー構造をトラバースして、各ドキュメントの詳細を取得・保存
-    const processedDocuments = [];
-    /**
-     * ドキュメントノードを再帰的に処理する
-     */
-    const processDocumentNode = async (node, currentPath) => {
-        // フォルダの場合
-        if (node.children && node.children.length > 0) {
-            // フォルダを作成
-            const folderPath = path.join(options.outputDir, currentPath, sanitizeFileName(node.name));
-            await fs.mkdir(folderPath, { recursive: true });
-            // 子ノードを処理
-            for (const child of node.children) {
-                // eslint-disable-next-line no-await-in-loop
-                await processDocumentNode(child, path.join(currentPath, sanitizeFileName(node.name)));
-            }
-        }
-        else {
-            // ドキュメントファイルの場合
-            try {
-                // 既に処理済みのドキュメントはスキップ
-                if (processedDocuments.includes(node.id)) {
-                    return;
-                }
-                processedDocuments.push(node.id);
-                // APIリクエスト数をインクリメント
-                await rateLimiter.increment();
-                // 進捗状況を表示
-                process.stdout.write(`\rドキュメント「${node.name}」を処理中...`);
-                // ドキュメント詳細を取得
-                const documentDetail = await ky.get(`${baseUrl}/documents/${node.id}?apiKey=${options.apiKey}`).json();
-                // 前回の更新日時チェック
-                if (options.lastUpdated) {
-                    const lastUpdatedDate = new Date(options.lastUpdated);
-                    const documentUpdatedDate = new Date(documentDetail.updated);
-                    if (documentUpdatedDate <= lastUpdatedDate) {
-                        return; // 更新が必要ない場合はスキップ
-                    }
-                }
-                // ファイルパスを構築
-                const sanitizedTitle = sanitizeFileName(documentDetail.title);
-                const documentFileName = `${sanitizedTitle}.md`;
-                const documentFilePath = path.join(options.outputDir, currentPath, documentFileName);
-                // ディレクトリを作成（必要に応じて）
-                const dirPath = path.dirname(documentFilePath);
-                await fs.mkdir(dirPath, { recursive: true });
-                // Backlogのドキュメントへのリンクを作成
-                const backlogDocumentUrl = `https://${options.domain}/document/${options.projectIdOrKey}/${node.id}`;
-                // 添付ファイルリストの作成
-                let attachmentsSection = '';
-                if (documentDetail.attachments && documentDetail.attachments.length > 0) {
-                    attachmentsSection = '\n\n## 添付ファイル\n';
-                    for (const attachment of documentDetail.attachments) {
-                        const attachmentDate = new Date(attachment.created).toLocaleString('ja-JP');
-                        const fileSize = (attachment.size / 1024).toFixed(1);
-                        attachmentsSection += `- **${attachment.name}** (${fileSize} KB) - 作成者: ${attachment.createdUser.name}, 作成日時: ${attachmentDate}\n`;
-                    }
-                }
-                // タグリストの作成
-                let tagsSection = '';
-                if (documentDetail.tags && documentDetail.tags.length > 0) {
-                    tagsSection = '\n\n## タグ\n';
-                    for (const tag of documentDetail.tags) {
-                        tagsSection += `- ${tag.name}\n`;
-                    }
-                }
-                // 作成者・更新者情報
-                const createdDate = new Date(documentDetail.created).toLocaleString('ja-JP');
-                const updatedDate = new Date(documentDetail.updated).toLocaleString('ja-JP');
-                // Markdownファイルに書き込む
-                const markdownContent = `# ${documentDetail.title}
-
-[Backlog Document Link](${backlogDocumentUrl})
-
-**ステータス**: ${documentDetail.statusId}${documentDetail.emoji ? ` ${documentDetail.emoji}` : ''}
-**作成者**: ${documentDetail.createdUser.name}
-**作成日時**: ${createdDate}
-**更新者**: ${documentDetail.updatedUser.name}
-**更新日時**: ${updatedDate}
-
-## 内容
-
-${documentDetail.plain || '（内容なし）'}${attachmentsSection}${tagsSection}`;
-                await fs.writeFile(documentFilePath, markdownContent);
-                // ログに記録
-                await appendLog(options.outputDir, `ドキュメント「${documentDetail.title}」を更新しました: ${backlogDocumentUrl}`);
-            }
-            catch (error) {
-                command.warn(`ドキュメント ${node.name} の取得に失敗しました: ${error instanceof Error ? error.message : String(error)}`);
-            }
-        }
-    };
-    // アクティブツリーのルートから処理開始
-    if (documentTree.activeTree.children && documentTree.activeTree.children.length > 0) {
-        for (const rootNode of documentTree.activeTree.children) {
-            // eslint-disable-next-line no-await-in-loop
-            await processDocumentNode(rootNode, '');
-        }
-    }
-    command.log(`\n合計 ${processedDocuments.length}件のドキュメントが処理されました。`);
-    command.log('ドキュメントのダウンロードが完了しました！');
-}

package/dist/utils/backlog.d.ts

@@ -1,16 +0,0 @@
-/**
- * プロジェクトキーからプロジェクトIDを取得する
- * @param domain Backlogドメイン (例: example.backlog.jp)
- * @param projectKey プロジェクトキー
- * @param apiKey BacklogのAPIキー
- * @returns プロジェクトID
- */
-export declare function getProjectIdFromKey(domain: string, projectKey: string, apiKey: string): Promise<number>;
-/**
- * プロジェクトIDまたはキーを検証し、必要に応じてキーからIDを取得する
- * @param domain Backlogドメイン
- * @param projectIdOrKey プロジェクトIDまたはキー
- * @param apiKey BacklogのAPIキー
- * @returns プロジェクトID
- */
-export declare function validateAndGetProjectId(domain: string, projectIdOrKey: string, apiKey: string): Promise<number>;

package/dist/utils/backlog.js

@@ -1,34 +0,0 @@
-import ky from 'ky';
-/**
- * プロジェクトキーからプロジェクトIDを取得する
- * @param domain Backlogドメイン (例: example.backlog.jp)
- * @param projectKey プロジェクトキー
- * @param apiKey BacklogのAPIキー
- * @returns プロジェクトID
- */
-export async function getProjectIdFromKey(domain, projectKey, apiKey) {
-    try {
-        const baseUrl = `https://${domain}/api/v2`;
-        const projectUrl = `${baseUrl}/projects/${projectKey}?apiKey=${apiKey}`;
-        const projectData = await ky.get(projectUrl).json();
-        return projectData.id;
-    }
-    catch (error) {
-        throw new Error(`プロジェクトキー "${projectKey}" からプロジェクトIDの取得に失敗しました: ${error instanceof Error ? error.message : String(error)}`);
-    }
-}
-/**
- * プロジェクトIDまたはキーを検証し、必要に応じてキーからIDを取得する
- * @param domain Backlogドメイン
- * @param projectIdOrKey プロジェクトIDまたはキー
- * @param apiKey BacklogのAPIキー
- * @returns プロジェクトID
- */
-export async function validateAndGetProjectId(domain, projectIdOrKey, apiKey) {
-    // 数値の場合はそのままプロジェクトIDとして返す
-    if (!Number.isNaN(Number(projectIdOrKey))) {
-        return Number(projectIdOrKey);
-    }
-    // 文字列の場合はプロジェクトキーとして扱い、IDを取得する
-    return getProjectIdFromKey(domain, projectIdOrKey, apiKey);
-}