atl-fetch 1.0.0

package/dist/services/diff/index.d.ts

@@ -0,0 +1 @@
+export { diffText, formatConfluenceVersionDiff, formatJiraChangelog } from './diff-service.js';

package/dist/services/diff/index.js

@@ -0,0 +1 @@
+export { diffText, formatConfluenceVersionDiff, formatJiraChangelog } from './diff-service.js';

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

@@ -0,0 +1,112 @@
+import { type Result } from 'neverthrow';
+import type { FetchAndSaveOptions, FetchAndSaveResult, FetchError, FetchResult } from '../../types/fetch.js';
+import type { OutputOptions } from '../../types/output.js';
+/**
+ * URL からリソースを取得する
+ *
+ * Atlassian Cloud の URL を解析し、リソースタイプ（Jira / Confluence）に応じて
+ * 適切なサービスを呼び出してデータを取得する。
+ *
+ * @param url - Atlassian Cloud の URL
+ * @returns 成功時は {@link FetchResult} を含む Ok、失敗時は {@link FetchError} を含む Err
+ *
+ * @example
+ * ```typescript
+ * // Jira Issue を取得
+ * const result = await fetchResource('https://mycompany.atlassian.net/browse/PROJ-123');
+ * if (result.isOk()) {
+ *   if (result.value.type === 'jira') {
+ *     console.log(result.value.data.summary);
+ *   }
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Confluence ページを取得
+ * const result = await fetchResource('https://mycompany.atlassian.net/wiki/spaces/DOCS/pages/123456789');
+ * if (result.isOk()) {
+ *   if (result.value.type === 'confluence') {
+ *     console.log(result.value.data.title);
+ *   }
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // エラーハンドリング
+ * const result = await fetchResource('https://invalid-url.com');
+ * if (result.isErr()) {
+ *   console.log(result.error.kind); // 'URL_PARSE_ERROR'
+ * }
+ * ```
+ */
+export declare function fetchResource(url: string): Promise<Result<FetchResult, FetchError>>;
+/**
+ * URL からリソースを取得し、指定形式で出力する
+ *
+ * Atlassian Cloud の URL を解析してリソースを取得し、
+ * 出力オプションに応じて JSON/Markdown/YAML 形式でフォーマットする。
+ * outputPath が指定されている場合はファイルに書き込む。
+ *
+ * @param url - Atlassian Cloud の URL
+ * @param options - 出力オプション（形式、出力先パス、カラー有効化）
+ * @returns 成功時はフォーマット済み文字列を含む Ok、失敗時は {@link FetchError} を含む Err
+ *
+ * @example
+ * ```typescript
+ * // JSON 形式で標準出力
+ * const result = await fetchAndOutput(
+ *   'https://mycompany.atlassian.net/browse/PROJ-123',
+ *   { format: 'json', colorEnabled: true }
+ * );
+ * if (result.isOk()) {
+ *   console.log(result.value);
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Markdown 形式でファイル出力
+ * const result = await fetchAndOutput(
+ *   'https://mycompany.atlassian.net/wiki/spaces/DOCS/pages/123456789',
+ *   { format: 'markdown', outputPath: '/tmp/page.md', colorEnabled: false }
+ * );
+ * ```
+ */
+export declare function fetchAndOutput(url: string, options: OutputOptions): Promise<Result<string, FetchError>>;
+/**
+ * URL からリソースを取得し、ディレクトリ構造で保存する
+ *
+ * Atlassian Cloud の URL を解析してリソースを取得し、
+ * ダウンロードオプションに応じて StorageService を呼び出してディレクトリ構造で保存する。
+ *
+ * @param url - Atlassian Cloud の URL
+ * @param options - 保存オプション（ベースディレクトリ、CLI バージョン、入力 URL）
+ * @returns 成功時は {@link FetchAndSaveResult} を含む Ok、失敗時は {@link FetchError} を含む Err
+ *
+ * @example
+ * ```typescript
+ * // Jira Issue をディレクトリ構造で保存
+ * const result = await fetchAndSave(
+ *   'https://mycompany.atlassian.net/browse/PROJ-123',
+ *   { baseDir: '/tmp/output', cliVersion: '1.0.0', sourceUrl: 'https://mycompany.atlassian.net/browse/PROJ-123' }
+ * );
+ * if (result.isOk()) {
+ *   console.log('保存先:', result.value.directory);
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Confluence ページをディレクトリ構造で保存
+ * const result = await fetchAndSave(
+ *   'https://mycompany.atlassian.net/wiki/spaces/DOCS/pages/123456789',
+ *   { baseDir: '/tmp/output', cliVersion: '1.0.0', sourceUrl: 'https://mycompany.atlassian.net/wiki/spaces/DOCS/pages/123456789' }
+ * );
+ * if (result.isOk()) {
+ *   console.log('保存先:', result.value.directory);
+ * }
+ * ```
+ */
+export declare function fetchAndSave(url: string, options: FetchAndSaveOptions): Promise<Result<FetchAndSaveResult, FetchError>>;

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

@@ -0,0 +1,302 @@
+import { err, ok } from 'neverthrow';
+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 { parseUrl } from '../url-parser/url-parser.js';
+/**
+ * Jira エラーを FetchError に変換する
+ *
+ * @param jiraError - Jira サービスから返されたエラー
+ * @returns FetchError
+ */
+function mapJiraErrorToFetchError(jiraError) {
+    switch (jiraError.kind) {
+        case 'NOT_FOUND':
+            return { kind: 'NOT_FOUND', message: jiraError.message };
+        case 'FORBIDDEN':
+            return { kind: 'FORBIDDEN', message: jiraError.message };
+        case 'AUTH_FAILED':
+            return { kind: 'AUTH_FAILED', message: jiraError.message };
+        case 'NETWORK_ERROR':
+            return { kind: 'NETWORK_ERROR', message: jiraError.message };
+        case 'PARSE_ERROR':
+            return { kind: 'JIRA_ERROR', message: jiraError.message };
+    }
+}
+/**
+ * Confluence エラーを FetchError に変換する
+ *
+ * @param confluenceError - Confluence サービスから返されたエラー
+ * @returns FetchError
+ */
+function mapConfluenceErrorToFetchError(confluenceError) {
+    switch (confluenceError.kind) {
+        case 'NOT_FOUND':
+            return { kind: 'NOT_FOUND', message: confluenceError.message };
+        case 'FORBIDDEN':
+            return { kind: 'FORBIDDEN', message: confluenceError.message };
+        case 'AUTH_FAILED':
+            return { kind: 'AUTH_FAILED', message: confluenceError.message };
+        case 'NETWORK_ERROR':
+            return { kind: 'NETWORK_ERROR', message: confluenceError.message };
+        case 'PARSE_ERROR':
+            return { kind: 'CONFLUENCE_ERROR', message: confluenceError.message };
+    }
+}
+/**
+ * URL からリソースを取得する
+ *
+ * Atlassian Cloud の URL を解析し、リソースタイプ（Jira / Confluence）に応じて
+ * 適切なサービスを呼び出してデータを取得する。
+ *
+ * @param url - Atlassian Cloud の URL
+ * @returns 成功時は {@link FetchResult} を含む Ok、失敗時は {@link FetchError} を含む Err
+ *
+ * @example
+ * ```typescript
+ * // Jira Issue を取得
+ * const result = await fetchResource('https://mycompany.atlassian.net/browse/PROJ-123');
+ * if (result.isOk()) {
+ *   if (result.value.type === 'jira') {
+ *     console.log(result.value.data.summary);
+ *   }
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Confluence ページを取得
+ * const result = await fetchResource('https://mycompany.atlassian.net/wiki/spaces/DOCS/pages/123456789');
+ * if (result.isOk()) {
+ *   if (result.value.type === 'confluence') {
+ *     console.log(result.value.data.title);
+ *   }
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // エラーハンドリング
+ * const result = await fetchResource('https://invalid-url.com');
+ * if (result.isErr()) {
+ *   console.log(result.error.kind); // 'URL_PARSE_ERROR'
+ * }
+ * ```
+ */
+export async function fetchResource(url) {
+    // URL を解析
+    const parseResult = parseUrl(url);
+    if (parseResult.isErr()) {
+        return err({
+            kind: 'URL_PARSE_ERROR',
+            message: parseResult.error.message,
+        });
+    }
+    const { type, organization, resourceId } = parseResult.value;
+    // リソースタイプに応じてサービスを呼び出す
+    if (type === 'jira') {
+        const issueResult = await fetchJiraIssue(organization, resourceId);
+        if (issueResult.isErr()) {
+            return err(mapJiraErrorToFetchError(issueResult.error));
+        }
+        return ok({
+            data: issueResult.value,
+            type: 'jira',
+        });
+    }
+    // type === 'confluence'
+    const pageResult = await fetchConfluencePage(organization, resourceId);
+    if (pageResult.isErr()) {
+        return err(mapConfluenceErrorToFetchError(pageResult.error));
+    }
+    return ok({
+        data: pageResult.value,
+        type: 'confluence',
+    });
+}
+/**
+ * URL からリソースを取得し、指定形式で出力する
+ *
+ * Atlassian Cloud の URL を解析してリソースを取得し、
+ * 出力オプションに応じて JSON/Markdown/YAML 形式でフォーマットする。
+ * outputPath が指定されている場合はファイルに書き込む。
+ *
+ * @param url - Atlassian Cloud の URL
+ * @param options - 出力オプション（形式、出力先パス、カラー有効化）
+ * @returns 成功時はフォーマット済み文字列を含む Ok、失敗時は {@link FetchError} を含む Err
+ *
+ * @example
+ * ```typescript
+ * // JSON 形式で標準出力
+ * const result = await fetchAndOutput(
+ *   'https://mycompany.atlassian.net/browse/PROJ-123',
+ *   { format: 'json', colorEnabled: true }
+ * );
+ * if (result.isOk()) {
+ *   console.log(result.value);
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Markdown 形式でファイル出力
+ * const result = await fetchAndOutput(
+ *   'https://mycompany.atlassian.net/wiki/spaces/DOCS/pages/123456789',
+ *   { format: 'markdown', outputPath: '/tmp/page.md', colorEnabled: false }
+ * );
+ * ```
+ */
+export async function fetchAndOutput(url, options) {
+    // リソースを取得
+    const fetchResult = await fetchResource(url);
+    if (fetchResult.isErr()) {
+        return err(fetchResult.error);
+    }
+    const { type, data } = fetchResult.value;
+    // リソースタイプに応じてフォーマット
+    const formatResult = type === 'jira'
+        ? formatJiraIssue(data, { format: options.format })
+        : formatConfluencePage(data, { format: options.format });
+    if (formatResult.isErr()) {
+        return err({
+            kind: 'OUTPUT_ERROR',
+            message: formatResult.error.message,
+        });
+    }
+    const formattedContent = formatResult.value;
+    // ファイル出力が指定されている場合は書き込む
+    if (options.outputPath !== undefined) {
+        const writeResult = await writeToFile(formattedContent, options.outputPath);
+        if (writeResult.isErr()) {
+            return err({
+                kind: 'OUTPUT_ERROR',
+                message: writeResult.error.message,
+            });
+        }
+    }
+    return ok(formattedContent);
+}
+/**
+ * URL からリソースを取得し、ディレクトリ構造で保存する
+ *
+ * Atlassian Cloud の URL を解析してリソースを取得し、
+ * ダウンロードオプションに応じて StorageService を呼び出してディレクトリ構造で保存する。
+ *
+ * @param url - Atlassian Cloud の URL
+ * @param options - 保存オプション（ベースディレクトリ、CLI バージョン、入力 URL）
+ * @returns 成功時は {@link FetchAndSaveResult} を含む Ok、失敗時は {@link FetchError} を含む Err
+ *
+ * @example
+ * ```typescript
+ * // Jira Issue をディレクトリ構造で保存
+ * const result = await fetchAndSave(
+ *   'https://mycompany.atlassian.net/browse/PROJ-123',
+ *   { baseDir: '/tmp/output', cliVersion: '1.0.0', sourceUrl: 'https://mycompany.atlassian.net/browse/PROJ-123' }
+ * );
+ * if (result.isOk()) {
+ *   console.log('保存先:', result.value.directory);
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Confluence ページをディレクトリ構造で保存
+ * const result = await fetchAndSave(
+ *   'https://mycompany.atlassian.net/wiki/spaces/DOCS/pages/123456789',
+ *   { baseDir: '/tmp/output', cliVersion: '1.0.0', sourceUrl: 'https://mycompany.atlassian.net/wiki/spaces/DOCS/pages/123456789' }
+ * );
+ * if (result.isOk()) {
+ *   console.log('保存先:', result.value.directory);
+ * }
+ * ```
+ */
+export async function fetchAndSave(url, options) {
+    // URL を解析
+    const parseResult = parseUrl(url);
+    if (parseResult.isErr()) {
+        return err({
+            kind: 'URL_PARSE_ERROR',
+            message: parseResult.error.message,
+        });
+    }
+    const { type, organization, resourceId } = parseResult.value;
+    // リソースタイプに応じてサービスを呼び出す
+    if (type === 'jira') {
+        // Jira Issue を取得
+        const issueResult = await fetchJiraIssue(organization, resourceId);
+        if (issueResult.isErr()) {
+            return err(mapJiraErrorToFetchError(issueResult.error));
+        }
+        const issue = issueResult.value;
+        // ADF をプレーンテキストに変換
+        const descriptionPlainText = issue.description !== null ? convertAdfToPlainText(issue.description) : null;
+        // Jira Issue をディレクトリ構造で保存
+        const saveResult = await saveJiraIssue({
+            attachments: issue.attachments,
+            changelog: issue.changelog,
+            comments: issue.comments,
+            description: issue.description,
+            descriptionPlainText,
+            key: issue.key,
+            summary: issue.summary,
+        }, {
+            baseDir: options.baseDir,
+            cliVersion: options.cliVersion,
+            sourceUrl: options.sourceUrl,
+        });
+        if (saveResult.isErr()) {
+            return err({
+                kind: 'STORAGE_ERROR',
+                message: saveResult.error.message,
+            });
+        }
+        return ok({
+            directory: saveResult.value.directory,
+            manifest: saveResult.value.manifest,
+        });
+    }
+    // type === 'confluence'
+    // Confluence ページを取得
+    const pageResult = await fetchConfluencePage(organization, resourceId);
+    if (pageResult.isErr()) {
+        return err(mapConfluenceErrorToFetchError(pageResult.error));
+    }
+    const page = pageResult.value;
+    // Storage Format をプレーンテキストに変換
+    const bodyPlainText = convertStorageFormatToPlainText(page.body);
+    // Confluence ページをディレクトリ構造で保存
+    const saveResult = await saveConfluencePage({
+        attachments: page.attachments,
+        body: page.body,
+        bodyPlainText,
+        currentVersion: page.currentVersion,
+        id: page.id,
+        spaceKey: page.spaceKey,
+        title: page.title,
+        versions: page.versions,
+    }, {
+        baseDir: options.baseDir,
+        cliVersion: options.cliVersion,
+        sourceUrl: options.sourceUrl,
+    });
+    if (saveResult.isErr()) {
+        return err({
+            kind: 'STORAGE_ERROR',
+            message: saveResult.error.message,
+        });
+    }
+    // バージョン別保存
+    const versionsResult = await saveConfluenceVersions(page.versions, saveResult.value.directory);
+    if (versionsResult.isErr()) {
+        return err({
+            kind: 'STORAGE_ERROR',
+            message: versionsResult.error.message,
+        });
+    }
+    return ok({
+        directory: saveResult.value.directory,
+        manifest: saveResult.value.manifest,
+    });
+}

package/dist/services/fetch/index.d.ts

@@ -0,0 +1 @@
+export { fetchAndOutput, fetchResource } from './fetch-service.js';

package/dist/services/fetch/index.js

@@ -0,0 +1 @@
+export { fetchAndOutput, fetchResource } from './fetch-service.js';

package/dist/services/jira/index.d.ts

@@ -0,0 +1 @@
+export { downloadJiraAttachment, fetchJiraIssue } from './jira-service.js';

package/dist/services/jira/index.js

@@ -0,0 +1 @@
+export { downloadJiraAttachment, fetchJiraIssue } from './jira-service.js';

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

@@ -0,0 +1,100 @@
+import { type Result } from 'neverthrow';
+import type { JiraAttachment, JiraError, JiraIssue } from '../../types/jira.js';
+/**
+ * ADF (Atlassian Document Format) からプレーンテキストを抽出する
+ *
+ * Jira Cloud API v3 は説明やコメントを ADF 形式で返す。
+ * この関数は ADF ドキュメントからテキストコンテンツを抽出する。
+ *
+ * @param adf - ADF ドキュメント
+ * @returns プレーンテキスト
+ *
+ * @internal テスト用に export
+ */
+export declare function extractTextFromAdf(adf: unknown): string;
+/**
+ * HTTP エラーを JiraError に変換する
+ *
+ * @param status - HTTP ステータスコード
+ * @param message - エラーメッセージ
+ * @returns JiraError
+ *
+ * @internal テスト用に export
+ */
+export declare function mapHttpStatusToJiraError(status: number, message: string): JiraError;
+/**
+ * Jira Issue を取得する
+ *
+ * Jira Cloud API を使用して Issue の基本情報（タイトル、説明、コメント、
+ * 変更履歴、添付ファイル）を取得する。
+ *
+ * @param organization - 組織名（.atlassian.net のサブドメイン）
+ * @param issueKey - Issue キー（例: PROJECT-123）
+ * @returns 成功時は {@link JiraIssue} を含む Ok、失敗時は {@link JiraError} を含む Err
+ *
+ * @example
+ * ```typescript
+ * // 基本的な使用例
+ * const result = await fetchJiraIssue('my-company', 'PROJECT-123');
+ * if (result.isOk()) {
+ *   console.log(result.value.summary);
+ *   console.log(result.value.description);
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // エラーハンドリング
+ * const result = await fetchJiraIssue('my-company', 'NOTEXIST-999');
+ * if (result.isErr()) {
+ *   if (result.error.kind === 'NOT_FOUND') {
+ *     console.log('Issue が見つかりません');
+ *   }
+ * }
+ * ```
+ */
+export declare function fetchJiraIssue(organization: string, issueKey: string): Promise<Result<JiraIssue, JiraError>>;
+/**
+ * HTTP エラーステータスをダウンロード用の JiraError に変換する
+ *
+ * @param status - HTTP ステータスコード
+ * @returns JiraError
+ *
+ * @internal テスト用に export
+ */
+export declare function mapHttpStatusToDownloadError(status: number): JiraError;
+/**
+ * Jira 添付ファイルをダウンロードする
+ *
+ * Jira Cloud API を使用して添付ファイルを指定パスにダウンロードする。
+ *
+ * @param attachment - ダウンロード対象の添付ファイル情報
+ * @param destPath - 保存先ファイルパス
+ * @param onProgress - 進捗コールバック関数（オプション）
+ * @returns 成功時は void を含む Ok、失敗時は {@link JiraError} を含む Err
+ *
+ * @example
+ * ```typescript
+ * // 基本的な使用例
+ * const attachment = issue.attachments[0];
+ * const result = await downloadJiraAttachment(attachment, '/path/to/save/file.png');
+ * if (result.isOk()) {
+ *   console.log('ダウンロード完了');
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // 進捗表示付き
+ * const result = await downloadJiraAttachment(
+ *   attachment,
+ *   '/path/to/save/file.png',
+ *   (transferred, total) => {
+ *     if (total) {
+ *       console.log(`Progress: ${(transferred / total * 100).toFixed(1)}%`);
+ *     }
+ *   }
+ * );
+ * ```
+ */
+export declare function downloadJiraAttachment(attachment: JiraAttachment, destPath: string, onProgress?: (transferred: number, total: number | undefined) => void): Promise<Result<void, JiraError>>;