atl-fetch 1.1.0 → 1.2.1

package/dist/services/text-converter/types.d.ts

@@ -0,0 +1,40 @@
+/**
+ * テキスト変換サービスの型定義
+ */
+/**
+ * 添付ファイルパスのマッピング型
+ * filename -> savedPath
+ */
+export type AttachmentPathMapping = Record<string, string>;
+/**
+ * ADF マークの型定義
+ */
+export interface AdfMark {
+    readonly type: string;
+    readonly attrs?: Readonly<Record<string, unknown>>;
+}
+/**
+ * ADF ノードの型定義
+ */
+export interface AdfNode {
+    readonly type: string;
+    readonly text?: string;
+    readonly content?: readonly AdfNode[];
+    readonly attrs?: Readonly<Record<string, unknown>>;
+    readonly marks?: readonly AdfMark[];
+}
+/**
+ * ADF ドキュメントの型定義
+ */
+export interface AdfDocument {
+    readonly type: 'doc';
+    readonly version: number;
+    readonly content: readonly AdfNode[];
+}
+/**
+ * 入力が ADF ドキュメント形式かどうかを判定する
+ *
+ * @param input 入力値
+ * @returns ADF ドキュメント形式の場合 true
+ */
+export declare const isAdfDocument: (input: unknown) => input is AdfDocument;

package/dist/services/text-converter/types.js

@@ -0,0 +1,16 @@
+/**
+ * テキスト変換サービスの型定義
+ */
+/**
+ * 入力が ADF ドキュメント形式かどうかを判定する
+ *
+ * @param input 入力値
+ * @returns ADF ドキュメント形式の場合 true
+ */
+export const isAdfDocument = (input) => {
+    if (typeof input !== 'object' || input === null) {
+        return false;
+    }
+    const doc = input;
+    return doc['type'] === 'doc' && Array.isArray(doc['content']);
+};

package/dist/types/jira.d.ts

@@ -6,8 +6,10 @@ export interface JiraComment {
     readonly id: string;
     /** 作成者の表示名 */
     readonly author: string;
-    /** コメント本文 */
+    /** コメント本文（プレーンテキスト） */
     readonly body: string;
+    /** コメント本文（ADF 形式、Markdown 変換用） */
+    readonly bodyAdf: unknown;
     /** 作成日時（ISO 8601 形式） */
     readonly created: string;
     /** 更新日時（ISO 8601 形式） */
@@ -62,6 +64,8 @@ export interface JiraIssue {
     readonly summary: string;
     /** Issue 説明（null の場合は説明なし） */
     readonly description: string | null;
+    /** Issue 説明（ADF 形式、Markdown 変換用） */
+    readonly descriptionAdf: unknown;
     /** コメント一覧 */
     readonly comments: readonly JiraComment[];
     /** 変更履歴一覧 */

package/dist/types/result.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Result 型 - 成功または失敗を表現する discriminated union
+ *
+ * @example
+ * ```typescript
+ * function divide(a: number, b: number): Result<number, DivisionError> {
+ *   if (b === 0) {
+ *     return err({ kind: 'DIVISION_BY_ZERO', message: 'Cannot divide by zero' });
+ *   }
+ *   return ok(a / b);
+ * }
+ * ```
+ */
+/**
+ * 成功を表す型
+ */
+export interface Ok<T> {
+    readonly success: true;
+    readonly value: T;
+}
+/**
+ * 失敗を表す型
+ */
+export interface Err<E> {
+    readonly success: false;
+    readonly error: E;
+}
+/**
+ * Result 型 - 成功（Ok）または失敗（Err）のどちらかを表す
+ */
+export type Result<T, E> = Ok<T> | Err<E>;
+/**
+ * 成功 Result を作成する
+ *
+ * @param value - 成功値
+ * @returns 成功 Result
+ */
+export declare function ok<T>(value: T): Ok<T>;
+/**
+ * 失敗 Result を作成する
+ *
+ * @param error - エラー値
+ * @returns 失敗 Result
+ */
+export declare function err<E>(error: E): Err<E>;
+/**
+ * Result が成功かどうかを判定する型ガード
+ *
+ * @param result - 判定対象の Result
+ * @returns 成功の場合 true
+ */
+export declare function isOk<T, E>(result: Result<T, E>): result is Ok<T>;
+/**
+ * Result が失敗かどうかを判定する型ガード
+ *
+ * @param result - 判定対象の Result
+ * @returns 失敗の場合 true
+ */
+export declare function isErr<T, E>(result: Result<T, E>): result is Err<E>;
+/**
+ * 成功 Result から値を取り出す
+ * 失敗 Result の場合はエラーをスローする
+ *
+ * @param result - 対象の Result
+ * @returns 成功値
+ * @throws 失敗 Result の場合
+ */
+export declare function unwrap<T, E>(result: Result<T, E>): T;
+/**
+ * 失敗 Result からエラー値を取り出す
+ * 成功 Result の場合はエラーをスローする
+ *
+ * @param result - 対象の Result
+ * @returns エラー値
+ * @throws 成功 Result の場合
+ */
+export declare function unwrapErr<T, E>(result: Result<T, E>): E;
+/**
+ * 成功 Result から値を取り出す
+ * 失敗 Result の場合はデフォルト値を返す
+ *
+ * @param result - 対象の Result
+ * @param defaultValue - 失敗時のデフォルト値
+ * @returns 成功値またはデフォルト値
+ */
+export declare function unwrapOr<T, E>(result: Result<T, E>, defaultValue: T): T;
+/**
+ * 成功 Result の値を変換する
+ * 失敗 Result の場合はそのまま返す
+ *
+ * @param result - 対象の Result
+ * @param fn - 変換関数
+ * @returns 変換された Result
+ */
+export declare function mapResult<T, U, E>(result: Result<T, E>, fn: (value: T) => U): Result<U, E>;
+/**
+ * 失敗 Result のエラー値を変換する
+ * 成功 Result の場合はそのまま返す
+ *
+ * @param result - 対象の Result
+ * @param fn - 変換関数
+ * @returns 変換された Result
+ */
+export declare function mapErr<T, E, F>(result: Result<T, E>, fn: (error: E) => F): Result<T, F>;

package/dist/types/result.js

@@ -0,0 +1,119 @@
+/**
+ * Result 型 - 成功または失敗を表現する discriminated union
+ *
+ * @example
+ * ```typescript
+ * function divide(a: number, b: number): Result<number, DivisionError> {
+ *   if (b === 0) {
+ *     return err({ kind: 'DIVISION_BY_ZERO', message: 'Cannot divide by zero' });
+ *   }
+ *   return ok(a / b);
+ * }
+ * ```
+ */
+/**
+ * 成功 Result を作成する
+ *
+ * @param value - 成功値
+ * @returns 成功 Result
+ */
+export function ok(value) {
+    return { success: true, value };
+}
+/**
+ * 失敗 Result を作成する
+ *
+ * @param error - エラー値
+ * @returns 失敗 Result
+ */
+export function err(error) {
+    return { error, success: false };
+}
+/**
+ * Result が成功かどうかを判定する型ガード
+ *
+ * @param result - 判定対象の Result
+ * @returns 成功の場合 true
+ */
+export function isOk(result) {
+    return result.success;
+}
+/**
+ * Result が失敗かどうかを判定する型ガード
+ *
+ * @param result - 判定対象の Result
+ * @returns 失敗の場合 true
+ */
+export function isErr(result) {
+    return !result.success;
+}
+/**
+ * 成功 Result から値を取り出す
+ * 失敗 Result の場合はエラーをスローする
+ *
+ * @param result - 対象の Result
+ * @returns 成功値
+ * @throws 失敗 Result の場合
+ */
+export function unwrap(result) {
+    if (isOk(result)) {
+        return result.value;
+    }
+    throw new Error(`Attempted to unwrap an Err value: ${String(result.error)}`);
+}
+/**
+ * 失敗 Result からエラー値を取り出す
+ * 成功 Result の場合はエラーをスローする
+ *
+ * @param result - 対象の Result
+ * @returns エラー値
+ * @throws 成功 Result の場合
+ */
+export function unwrapErr(result) {
+    if (isErr(result)) {
+        return result.error;
+    }
+    throw new Error('Attempted to unwrapErr an Ok value');
+}
+/**
+ * 成功 Result から値を取り出す
+ * 失敗 Result の場合はデフォルト値を返す
+ *
+ * @param result - 対象の Result
+ * @param defaultValue - 失敗時のデフォルト値
+ * @returns 成功値またはデフォルト値
+ */
+export function unwrapOr(result, defaultValue) {
+    if (isOk(result)) {
+        return result.value;
+    }
+    return defaultValue;
+}
+/**
+ * 成功 Result の値を変換する
+ * 失敗 Result の場合はそのまま返す
+ *
+ * @param result - 対象の Result
+ * @param fn - 変換関数
+ * @returns 変換された Result
+ */
+export function mapResult(result, fn) {
+    if (isOk(result)) {
+        return ok(fn(result.value));
+    }
+    return result;
+}
+/**
+ * 失敗 Result のエラー値を変換する
+ * 成功 Result の場合はそのまま返す
+ *
+ * @param result - 対象の Result
+ * @param fn - 変換関数
+ * @returns 変換された Result
+ */
+export function mapErr(result, fn) {
+    if (isErr(result)) {
+        return err(fn(result.error));
+    }
+    return result;
+}

package/dist/types/storage.d.ts

@@ -93,9 +93,9 @@ export interface JiraSaveData {
     readonly key: string;
     /** Issue タイトル（要約） */
     readonly summary: string;
-    /** Issue 説明（null の場合は説明なし） */
-    readonly description: string | null;
-    /** 説明のプレーンテキスト（null の場合は説明なし） */
+    /** Issue 説明（ADF 形式、null の場合は説明なし） */
+    readonly description: unknown;
+    /** 説明のプレーンテキスト（null の場合は説明なし、後方互換性のため維持） */
     readonly descriptionPlainText: string | null;
     /** コメント一覧 */
     readonly comments: readonly JiraComment[];

package/package.json

@@ -82,7 +82,7 @@
   },
   "type": "module",
   "types": "./dist/index.d.ts",
-  "version": "1.1.0",
+  "version": "1.2.1",
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",