atl-fetch 1.0.0 → 1.2.0

package/dist/cli/spinner.js

@@ -0,0 +1,247 @@
+/**
+ * CLI スピナー・進捗表示ユーティリティ
+ *
+ * ora と picocolors を使用した統一的な進捗表示を提供する。
+ */
+import ora, {} from 'ora';
+import pc from 'picocolors';
+/**
+ * 事前定義されたスピナーステップ
+ */
+export const SPINNER_STEPS = {
+    AUTH_CHECK: {
+        name: 'auth_check',
+        successText: '認証情報を確認しました',
+        text: '認証情報を確認中...',
+    },
+    DOWNLOAD_ATTACHMENTS: {
+        name: 'download_attachments',
+        successText: '添付ファイルをダウンロードしました',
+        text: '添付ファイルをダウンロード中...',
+    },
+    FETCH_CONFLUENCE: {
+        name: 'fetch_confluence',
+        successText: 'Confluence ページを取得しました',
+        text: 'Confluence ページを取得中...',
+    },
+    FETCH_DATA: {
+        name: 'fetch_data',
+        successText: 'データを取得しました',
+        text: 'データを取得中...',
+    },
+    FETCH_JIRA: {
+        name: 'fetch_jira',
+        successText: 'Jira Issue を取得しました',
+        text: 'Jira Issue を取得中...',
+    },
+    FORMAT_OUTPUT: {
+        name: 'format_output',
+        successText: '出力を整形しました',
+        text: '出力を整形中...',
+    },
+    SAVE_FILES: {
+        name: 'save_files',
+        successText: 'ファイルを保存しました',
+        text: 'ファイルを保存中...',
+    },
+    URL_PARSE: {
+        name: 'url_parse',
+        successText: 'URLを解析しました',
+        text: 'URLを解析中...',
+    },
+};
+/**
+ * CLI 出力のカラーヘルパー
+ */
+export const colors = {
+    /** 太字 */
+    bold: (text) => pc.bold(text),
+    /** シアン（ファイルパスなど） */
+    cyan: (text) => pc.cyan(text),
+    /** 薄いテキスト（グレー） */
+    dim: (text) => pc.dim(text),
+    /** エラーメッセージ（赤） */
+    error: (text) => pc.red(text),
+    /** 情報メッセージ（青） */
+    info: (text) => pc.blue(text),
+    /** マゼンタ（URL など） */
+    magenta: (text) => pc.magenta(text),
+    /** 成功メッセージ（緑） */
+    success: (text) => pc.green(text),
+    /** 警告メッセージ（黄） */
+    warn: (text) => pc.yellow(text),
+};
+/**
+ * CLI スピナー管理クラス
+ *
+ * 処理の進捗状況をユーザーに表示するためのスピナーを管理する。
+ *
+ * @example
+ * ```typescript
+ * const spinner = new CliSpinner();
+ * spinner.start('データを取得中...');
+ * // ... 処理 ...
+ * spinner.succeed('データを取得しました');
+ * ```
+ */
+export class CliSpinner {
+    spinner = null;
+    enabled;
+    /**
+     * CliSpinner インスタンスを作成する
+     *
+     * @param enabled スピナーを有効にするかどうか（CI環境などでは無効にする）
+     */
+    constructor(enabled = true) {
+        // CI環境やテスト環境ではスピナーを無効化
+        this.enabled = enabled && !process.env['CI'] && process.stdout.isTTY === true;
+    }
+    /**
+     * スピナーを開始する
+     *
+     * @param text 表示するテキスト
+     */
+    start(text) {
+        if (!this.enabled) {
+            return;
+        }
+        this.spinner = ora({
+            spinner: 'dots',
+            text,
+        }).start();
+    }
+    /**
+     * スピナーのテキストを更新する
+     *
+     * @param text 新しいテキスト
+     */
+    update(text) {
+        if (this.spinner) {
+            this.spinner.text = text;
+        }
+    }
+    /**
+     * スピナーを成功状態で終了する
+     *
+     * @param text 成功時に表示するテキスト
+     */
+    succeed(text) {
+        if (this.spinner) {
+            this.spinner.succeed(text);
+            this.spinner = null;
+        }
+    }
+    /**
+     * スピナーを失敗状態で終了する
+     *
+     * @param text 失敗時に表示するテキスト
+     */
+    fail(text) {
+        if (this.spinner) {
+            this.spinner.fail(text);
+            this.spinner = null;
+        }
+    }
+    /**
+     * スピナーを警告状態で終了する
+     *
+     * @param text 警告時に表示するテキスト
+     */
+    warn(text) {
+        if (this.spinner) {
+            this.spinner.warn(text);
+            this.spinner = null;
+        }
+    }
+    /**
+     * スピナーを情報状態で終了する
+     *
+     * @param text 情報として表示するテキスト
+     */
+    info(text) {
+        if (this.spinner) {
+            this.spinner.info(text);
+            this.spinner = null;
+        }
+    }
+    /**
+     * スピナーを停止する（状態なし）
+     */
+    stop() {
+        if (this.spinner) {
+            this.spinner.stop();
+            this.spinner = null;
+        }
+    }
+    /**
+     * 事前定義されたステップでスピナーを開始する
+     *
+     * @param step スピナーステップ定義
+     */
+    startStep(step) {
+        this.start(step.text);
+    }
+    /**
+     * 事前定義されたステップを成功状態で終了する
+     *
+     * @param step スピナーステップ定義
+     */
+    succeedStep(step) {
+        this.succeed(step.successText ?? step.text);
+    }
+}
+/**
+ * エラーメッセージを整形して出力する
+ *
+ * @param code エラーコード
+ * @param message エラーメッセージ
+ * @param cause 原因の説明（オプション）
+ * @param solution 解決策の説明（オプション）
+ * @returns 整形されたエラーメッセージ
+ */
+export function formatError(code, message, cause, solution) {
+    const lines = [];
+    lines.push(colors.error(`${colors.bold(code)}: ${message}`));
+    if (cause) {
+        lines.push(colors.dim(`  原因: ${cause}`));
+    }
+    if (solution) {
+        lines.push(colors.info(`  解決策: ${solution}`));
+    }
+    return lines.join('\n');
+}
+/**
+ * 成功メッセージを整形する
+ *
+ * @param message メッセージ
+ * @param details 詳細情報（オプション）
+ * @returns 整形されたメッセージ
+ */
+export function formatSuccess(message, details) {
+    const lines = [];
+    lines.push(colors.success(`✓ ${message}`));
+    if (details) {
+        for (const [key, value] of Object.entries(details)) {
+            lines.push(colors.dim(`  ${key}: ${colors.cyan(value)}`));
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * 情報メッセージを整形する
+ *
+ * @param message メッセージ
+ * @returns 整形されたメッセージ
+ */
+export function formatInfo(message) {
+    return colors.info(`ℹ ${message}`);
+}
+/**
+ * 警告メッセージを整形する
+ *
+ * @param message メッセージ
+ * @returns 整形されたメッセージ
+ */
+export function formatWarn(message) {
+    return colors.warn(`⚠ ${message}`);
+}

package/dist/services/fetch/fetch-service.js

@@ -3,7 +3,7 @@ import { fetchConfluencePage } from '../confluence/confluence-service.js';
 import { fetchJiraIssue } from '../jira/jira-service.js';
 import { formatConfluencePage, formatJiraIssue, writeToFile } from '../output/output-service.js';
 import { saveConfluencePage, saveConfluenceVersions, saveJiraIssue } from '../storage/storage-service.js';
-import { convertAdfToPlainText, convertStorageFormatToPlainText } from '../text-converter/text-converter.js';
+import { convertStorageFormatToPlainText } from '../text-converter/text-converter.js';
 import { parseUrl } from '../url-parser/url-parser.js';
 /**
  * Jira エラーを FetchError に変換する
@@ -230,15 +230,14 @@ export async function fetchAndSave(url, options) {
             return err(mapJiraErrorToFetchError(issueResult.error));
         }
         const issue = issueResult.value;
-        // ADF をプレーンテキストに変換
-        const descriptionPlainText = issue.description !== null ? convertAdfToPlainText(issue.description) : null;
         // Jira Issue をディレクトリ構造で保存
+        // description は ADF 形式で保存、descriptionPlainText は後方互換性のため維持
         const saveResult = await saveJiraIssue({
             attachments: issue.attachments,
             changelog: issue.changelog,
             comments: issue.comments,
-            description: issue.description,
-            descriptionPlainText,
+            description: issue.descriptionAdf,
+            descriptionPlainText: issue.description,
             key: issue.key,
             summary: issue.summary,
         }, {

package/dist/services/jira/jira-service.js

@@ -108,6 +108,7 @@ function mapApiCommentToJiraComment(apiComment) {
     return {
         author: apiComment.author.displayName,
         body: extractTextFromAdf(apiComment.body),
+        bodyAdf: apiComment.body,
         created: apiComment.created,
         id: apiComment.id,
         updated: apiComment.updated,
@@ -254,6 +255,7 @@ export async function fetchJiraIssue(organization, issueKey) {
         changelog: (apiResponse.changelog?.histories ?? []).map(mapApiChangelogEntryToJiraChangelogEntry),
         comments: (apiResponse.fields.comment?.comments ?? []).map(mapApiCommentToJiraComment),
         description: apiResponse.fields.description ? extractTextFromAdf(apiResponse.fields.description) : null,
+        descriptionAdf: apiResponse.fields.description,
         key: apiResponse.key,
         summary: apiResponse.fields.summary,
     };

package/dist/services/storage/storage-service.d.ts

@@ -16,9 +16,11 @@ import type { ConfluenceSaveData, ConfluenceSaveResult, ConfluenceStorageOptions
  * ├── manifest.json          # 取得メタデータ
  * ├── issue.json             # Issue 全データ（JSON 形式）
  * ├── description.txt        # 説明文のプレーンテキスト
- * ├── content.md             # Markdown 形式
- * ├── changelog.json         # 変更履歴
- * ├── comments.json          # コメント一覧
+ * ├── content.md             # Markdown 形式（Description + Attachments）
+ * ├── comments.md            # コメント一覧（Markdown 形式）
+ * ├── changelog.md           # 変更履歴（Markdown 形式）
+ * ├── changelog.json         # 変更履歴（JSON 形式）
+ * ├── comments.json          # コメント一覧（JSON 形式）
  * ├── attachments.json       # 添付ファイル一覧メタデータ
  * └── attachments/           # 添付ファイル実体
  *     └── {id}_{filename}