@alneas/appkit-react 0.1.0 → 0.2.0

package/dist/tools/lib/error/AppError.d.ts

@@ -1,123 +1,217 @@
 /**
- * エラー表示モード
- * - inline: フォーム内のフィールド近くに表示
- * - notification: 画面上部のバナー通知
- * - dialog: モーダルダイアログ
- * - page: 全画面エラーページ
+ * Requested error presentation: inline field feedback, notification banner, modal dialog or full page.
+ * @remarks This is metadata; a host renderer must display the error.
+ * @see AppError for creation.
  */
 export type ErrorDisplayMode = 'inline' | 'notification' | 'dialog' | 'page';
 /**
- * エラーの重要度
+ * Presentation severity from informational through critical; does not change Error behavior.
+ * @see AppError for creation.
  */
 export type ErrorSeverity = 'info' | 'warning' | 'error' | 'critical';
 /**
- * AppError: アプリケーション全体で使用するエラークラス
- *
+ * Application Error carrying a code, display hint, severity and optional metadata/original error.
+ * @remarks Presentation hints do not render UI or enforce authorization. Metadata is retained
+ * by reference and included in toJSON; exclude secrets before displaying or serializing.
  * @example
- * ```typescript
- * // 基本的な使用法
- * throw new AppError('auth/user-not-found', 'User not found');
- *
- * // 表示モード指定
- * throw new AppError('network/timeout', 'Request timed out', {
- *   displayMode: 'notification',
- *   severity: 'warning'
- * });
- *
- * // メタデータ付き
- * throw new AppError('validation/invalid-field', 'Invalid input', {
- *   displayMode: 'inline',
- *   metadata: { field: 'email' }
- * });
+ * ```ts
+ * import { AppError } from '@alneas/appkit-react/tools/core';
+ * const error = new AppError('validation/input', 'Review the input', { displayMode: 'inline', severity: 'warning' });
  * ```
  */
 export declare class AppError extends Error {
-    /** エラーコード。i18n のキーとしても使用 (例: 'auth/user-not-found') */
+    /**
+   * Stable host error code, also usable for localized message lookup.
+   */
     readonly code: string;
-    /** 推奨される表示モード */
+    /**
+   * Recommended host display mode; defaults to notification.
+   */
     readonly displayMode: ErrorDisplayMode;
-    /** エラーの重要度 */
+    /**
+   * Presentation severity; defaults to error.
+   */
     readonly severity: ErrorSeverity;
-    /** 追加のメタデータ (フィールド名、HTTP ステータスなど) */
+    /**
+   * Optional host metadata retained by reference and included in JSON serialization.
+   */
     readonly metadata?: Record<string, unknown>;
-    /** 元のエラー (ラップする場合) */
+    /**
+   * Optional wrapped Error retained by reference; excluded from toJSON.
+   */
     readonly originalError?: Error;
     /**
-     * AppError の新しいインスタンスを生成します。
-     * @param code エラーコード
-     * @param message エラーメッセージ
-     * @param options 追加オプション
-     */
+   * Creates an Error with explicit application code and presentation metadata.
+   * @param code - Host error identifier; no format validation is applied.
+   * @param message - Error message stored by the Error base class.
+   * @param options - Optional displayMode/severity (defaults notification/error), metadata and wrapped Error.
+   * @example
+   * ```ts
+   * import { AppError } from '@alneas/appkit-react/tools/core';
+   * const error = new AppError('error/example', 'Operation failed');
+   * ```
+   */
     constructor(code: string, message: string, options?: {
+        /**
+         * Presentation hint, default notification.
+         */
         displayMode?: ErrorDisplayMode;
+        /**
+         * Presentation severity, default error.
+         */
         severity?: ErrorSeverity;
+        /**
+         * Optional host metadata included by toJSON.
+         */
         metadata?: Record<string, unknown>;
+        /**
+         * Optional wrapped Error, excluded from toJSON.
+         */
         originalError?: Error;
     });
     /**
-     * 任意のエラーを AppError に変換します。
-     * Firebase, Supabase 等のエラーを自動的にコードマッピングします。
-     */
+   * Converts an unknown value to AppError, preserving an existing AppError unchanged.
+   * @param error - Error or arbitrary thrown value to normalize.
+   * @param defaultDisplayMode - Hint for newly created wrappers; defaults to notification.
+   * @returns Existing AppError identity, or a new wrapper. Error instances with a string code
+   * retain that code and map selected known auth messages; other Errors use message matching
+   * or error/unknown. Non-Error values are stringified as error/unknown.
+   * @remarks Plain objects with code/message are not interpreted as Error instances. The
+   * default display hint does not override an existing AppError. No UI is rendered.
+   * @example
+   * ```ts
+   * import { AppError } from '@alneas/appkit-react/tools/core';
+   * const error = AppError.from(new Error('Unavailable'), 'dialog');
+   * ```
+   */
     static from(error: unknown, defaultDisplayMode?: ErrorDisplayMode): AppError;
     /**
-     * 文字列表現
-     */
+   * Formats the application code and message for display/logging.
+   * @returns String in [code] message form; does not include metadata or stack.
+   * @example
+   * ```ts
+   * import { AppError } from '@alneas/appkit-react/tools/core';
+   * const error = new AppError('error/example', 'Unavailable').toString();
+   * ```
+   */
     toString(): string;
     /**
-     * JSON シリアライズ用
-     */
+   * Selects enumerable presentation fields for JSON serialization.
+   * @returns New object with name/code/message/displayMode/severity/metadata; stack and originalError are omitted.
+   * @remarks Metadata remains referenced and may itself be non-serializable or sensitive.
+   * @example
+   * ```ts
+   * import { AppError } from '@alneas/appkit-react/tools/core';
+   * const error = new AppError('error/example', 'Unavailable').toJSON();
+   * ```
+   */
     toJSON(): Record<string, unknown>;
 }
 /**
- * ネットワークタイムアウトエラー
+ * Represents an operation timeout with notification/warning presentation.
+ * @remarks Construction does not start timers, perform a request or render error UI.
+ * @example
+ * ```ts
+ * import { TimeoutError } from '@alneas/appkit-react/tools/core';
+ * const error = new TimeoutError();
+ * ```
  */
 export declare class TimeoutError extends AppError {
     /**
-     * TimeoutError の新しいインスタンスを生成します。
-     * @param message エラーメッセージ
-     * @param duration タイムアウトした時間（ミリ秒）
-     */
+   * Creates an application error with code error/timeout.
+   * @param message - Message, default The operation timed out.
+   * @param duration - Optional timeout duration in milliseconds; retained in metadata.
+   * @example
+   * ```ts
+   * import { TimeoutError } from '@alneas/appkit-react/tools/core';
+   * const error = new TimeoutError();
+   * ```
+   */
     constructor(message?: string, duration?: number);
 }
 /**
- * ネットワークエラー
+ * Represents a network failure with notification/error presentation.
+ * @remarks Construction does not start timers, perform a request or render error UI.
+ * @example
+ * ```ts
+ * import { NetworkError } from '@alneas/appkit-react/tools/core';
+ * const error = new NetworkError();
+ * ```
  */
 export declare class NetworkError extends AppError {
     /**
-     * NetworkError の新しいインスタンスを生成します。
-     * @param message エラーメッセージ
-     */
+   * Creates an application error with code error/network.
+   * @param message - Message, default Network error occurred.
+   * @example
+   * ```ts
+   * import { NetworkError } from '@alneas/appkit-react/tools/core';
+   * const error = new NetworkError();
+   * ```
+   */
     constructor(message?: string);
 }
 /**
- * 認証不足エラー
+ * Represents denied access with dialog/error presentation.
+ * @remarks Construction does not start timers, perform a request or render error UI.
+ * @example
+ * ```ts
+ * import { UnauthorizedError } from '@alneas/appkit-react/tools/core';
+ * const error = new UnauthorizedError();
+ * ```
  */
 export declare class UnauthorizedError extends AppError {
     /**
-     * UnauthorizedError の新しいインスタンスを生成します。
-     * @param message エラーメッセージ
-     */
+   * Creates an application error with code error/unauthorized.
+   * @param message - Message, default You are not authorized to perform this action.
+   * @example
+   * ```ts
+   * import { UnauthorizedError } from '@alneas/appkit-react/tools/core';
+   * const error = new UnauthorizedError();
+   * ```
+   */
     constructor(message?: string);
 }
 /**
- * リソースが見つからないエラー
+ * Represents a missing resource with page/error presentation.
+ * @remarks Construction does not start timers, perform a request or render error UI.
+ * @example
+ * ```ts
+ * import { NotFoundError } from '@alneas/appkit-react/tools/core';
+ * const error = new NotFoundError();
+ * ```
  */
 export declare class NotFoundError extends AppError {
     /**
-     * NotFoundError の新しいインスタンスを生成します。
-     * @param message エラーメッセージ
-     * @param resource 見つからなかったリソース名
-     */
+   * Creates an application error with code error/not-found.
+   * @param message - Message, default The requested resource was not found.
+   * @param resource - Optional missing resource name retained in metadata.
+   * @example
+   * ```ts
+   * import { NotFoundError } from '@alneas/appkit-react/tools/core';
+   * const error = new NotFoundError();
+   * ```
+   */
     constructor(message?: string, resource?: string);
 }
 /**
- * バリデーションエラー
+ * Represents invalid input with inline/warning presentation.
+ * @remarks Construction does not start timers, perform a request or render error UI.
+ * @example
+ * ```ts
+ * import { ValidationError } from '@alneas/appkit-react/tools/core';
+ * const error = new ValidationError('Invalid input');
+ * ```
  */
 export declare class ValidationError extends AppError {
     /**
-     * ValidationError の新しいインスタンスを生成します。
-     * @param message エラーメッセージ
-     * @param fields フィールドごとのエラーマッピング
-     */
+   * Creates an application error with code error/validation.
+   * @param message - Required validation message.
+   * @param fields - Optional per-field error messages retained in metadata.
+   * @example
+   * ```ts
+   * import { ValidationError } from '@alneas/appkit-react/tools/core';
+   * const error = new ValidationError('Invalid input');
+   * ```
+   */
     constructor(message: string, fields?: Record<string, string>);
 }

package/dist/tools/lib/error/AppError.js.map

@@ -1 +1 @@
-{"version":3,"file":"AppError.js","names":["m.errors_auth_invalid_email","m.errors_auth_wrong_password","m.errors_auth_user_not_found","m.errors_auth_user_disabled","m.errors_auth_too_many_requests","m.errors_auth_operation_not_allowed","m.errors_auth_email_already_in_use","m.errors_auth_requires_recent_login","m.errors_auth_account_exists_with_different_credential","m.errors_auth_weak_password","m.errors_auth_network_request_failed","m.errors_supabase_invalid_credentials","m.errors_supabase_email_not_confirmed","AppError","message","code","options","error","errors_auth_invalid_email","errors_auth_wrong_password","errors_auth_user_not_found","errors_auth_user_disabled","errors_auth_too_many_requests","errors_auth_operation_not_allowed","errors_auth_email_already_in_use","errors_auth_requires_recent_login","errors_auth_account_exists_with_different_credential","errors_auth_weak_password","errors_auth_network_request_failed","defaultDisplayMode","errorRecord","msg","errors_supabase_invalid_credentials","errors_supabase_email_not_confirmed","TimeoutError","NetworkError","UnauthorizedError","NotFoundError","ValidationError"],"sources":["../../../../src/tools/lib/error/AppError.ts"],"sourcesContent":["import * as m from '../../paraglide/messages';\n\n/**\n * エラー表示モード\n * - inline: フォーム内のフィールド近くに表示\n * - notification: 画面上部のバナー通知\n * - dialog: モーダルダイアログ\n * - page: 全画面エラーページ\n */\nexport type ErrorDisplayMode = 'inline' | 'notification' | 'dialog' | 'page';\n\n/**\n * エラーの重要度\n */\nexport type ErrorSeverity = 'info' | 'warning' | 'error' | 'critical';\n\n/**\n * AppError: アプリケーション全体で使用するエラークラス\n *\n * @example\n * ```typescript\n * // 基本的な使用法\n * throw new AppError('auth/user-not-found', 'User not found');\n *\n * // 表示モード指定\n * throw new AppError('network/timeout', 'Request timed out', {\n *   displayMode: 'notification',\n *   severity: 'warning'\n * });\n *\n * // メタデータ付き\n * throw new AppError('validation/invalid-field', 'Invalid input', {\n *   displayMode: 'inline',\n *   metadata: { field: 'email' }\n * });\n * ```\n */\nexport class AppError extends Error {\n  /** エラーコード。i18n のキーとしても使用 (例: 'auth/user-not-found') */\n  readonly code: string;\n\n  /** 推奨される表示モード */\n  readonly displayMode: ErrorDisplayMode;\n\n  /** エラーの重要度 */\n  readonly severity: ErrorSeverity;\n\n  /** 追加のメタデータ (フィールド名、HTTP ステータスなど) */\n  readonly metadata?: Record<string, unknown>;\n\n  /** 元のエラー (ラップする場合) */\n  readonly originalError?: Error;\n\n  /**\n   * AppError の新しいインスタンスを生成します。\n   * @param code エラーコード\n   * @param message エラーメッセージ\n   * @param options 追加オプション\n   */\n  constructor(\n    code: string,\n    message: string,\n    options?: {\n      displayMode?: ErrorDisplayMode;\n      severity?: ErrorSeverity;\n      metadata?: Record<string, unknown>;\n      originalError?: Error;\n    },\n  ) {\n    super(message);\n    this.name = 'AppError';\n    this.code = code;\n    this.displayMode = options?.displayMode ?? 'notification';\n    this.severity = options?.severity ?? 'error';\n    this.metadata = options?.metadata;\n    this.originalError = options?.originalError;\n\n    // Error の prototype chain を正しく設定\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  /**\n   * 任意のエラーを AppError に変換します。\n   * Firebase, Supabase 等のエラーを自動的にコードマッピングします。\n   */\n  static from(error: unknown, defaultDisplayMode: ErrorDisplayMode = 'notification'): AppError {\n    if (error instanceof AppError) {\n      return error;\n    }\n\n    if (error instanceof Error) {\n      // Firebase Auth Error\n      if ('code' in error && typeof (error as { code: unknown }).code === 'string') {\n        const code = (error as { code: string }).code;\n        let message = error.message;\n\n        switch (code) {\n          case 'auth/invalid-email':\n            message = m.errors_auth_invalid_email();\n            break;\n          case 'auth/wrong-password':\n            message = m.errors_auth_wrong_password();\n            break;\n          case 'auth/user-not-found':\n            message = m.errors_auth_user_not_found();\n            break;\n          case 'auth/user-disabled':\n            message = m.errors_auth_user_disabled();\n            break;\n          case 'auth/too-many-requests':\n            message = m.errors_auth_too_many_requests();\n            break;\n          case 'auth/operation-not-allowed':\n            message = m.errors_auth_operation_not_allowed();\n            break;\n          case 'auth/email-already-in-use':\n            message = m.errors_auth_email_already_in_use();\n            break;\n          case 'auth/requires-recent-login':\n            message = m.errors_auth_requires_recent_login();\n            break;\n          case 'auth/credential-already-in-use':\n            message = m.errors_auth_account_exists_with_different_credential();\n            break;\n          case 'auth/weak-password':\n            message = m.errors_auth_weak_password();\n            break;\n          case 'auth/network-request-failed':\n            message = m.errors_auth_network_request_failed();\n            break;\n        }\n\n        return new AppError(code, message, {\n          displayMode: defaultDisplayMode,\n          originalError: error,\n        });\n      }\n\n      // Supabase/PostgreSQL Error\n      // Supabase errors often have 'code' and 'message'.\n      // We can also look for specific strings in the message if the code is generic.\n      if ('code' in error || 'message' in error) {\n        const errorRecord = error as { code?: unknown; message?: unknown };\n        const msg = typeof errorRecord.message === 'string' ? errorRecord.message : '';\n\n        // Supabase generic error message mapping\n        if (msg.includes('Invalid login credentials')) {\n          return new AppError(\n            'bg-auth/invalid-credentials',\n            m.errors_supabase_invalid_credentials(),\n            { displayMode: defaultDisplayMode, originalError: error },\n          );\n        }\n        if (msg.includes('Email not confirmed')) {\n          return new AppError(\n            'bg-auth/email-not-confirmed',\n            m.errors_supabase_email_not_confirmed(),\n            { displayMode: defaultDisplayMode, originalError: error },\n          );\n        }\n      }\n\n      // Generic Error\n      return new AppError('error/unknown', error.message, {\n        displayMode: defaultDisplayMode,\n        originalError: error,\n      });\n    }\n\n    // Unknown type\n    return new AppError('error/unknown', String(error), {\n      displayMode: defaultDisplayMode,\n    });\n  }\n\n  /**\n   * 文字列表現\n   */\n  toString(): string {\n    return `[${this.code}] ${this.message}`;\n  }\n\n  /**\n   * JSON シリアライズ用\n   */\n  toJSON(): Record<string, unknown> {\n    return {\n      name: this.name,\n      code: this.code,\n      message: this.message,\n      displayMode: this.displayMode,\n      severity: this.severity,\n      metadata: this.metadata,\n    };\n  }\n}\n\n/**\n * ネットワークタイムアウトエラー\n */\nexport class TimeoutError extends AppError {\n  /**\n   * TimeoutError の新しいインスタンスを生成します。\n   * @param message エラーメッセージ\n   * @param duration タイムアウトした時間（ミリ秒）\n   */\n  constructor(message = 'The operation timed out', duration?: number) {\n    super('error/timeout', message, {\n      displayMode: 'notification',\n      severity: 'warning',\n      metadata: { duration },\n    });\n    this.name = 'TimeoutError';\n  }\n}\n\n/**\n * ネットワークエラー\n */\nexport class NetworkError extends AppError {\n  /**\n   * NetworkError の新しいインスタンスを生成します。\n   * @param message エラーメッセージ\n   */\n  constructor(message = 'Network error occurred') {\n    super('error/network', message, {\n      displayMode: 'notification',\n      severity: 'error',\n    });\n    this.name = 'NetworkError';\n  }\n}\n\n/**\n * 認証不足エラー\n */\nexport class UnauthorizedError extends AppError {\n  /**\n   * UnauthorizedError の新しいインスタンスを生成します。\n   * @param message エラーメッセージ\n   */\n  constructor(message = 'You are not authorized to perform this action') {\n    super('error/unauthorized', message, {\n      displayMode: 'dialog',\n      severity: 'error',\n    });\n    this.name = 'UnauthorizedError';\n  }\n}\n\n/**\n * リソースが見つからないエラー\n */\nexport class NotFoundError extends AppError {\n  /**\n   * NotFoundError の新しいインスタンスを生成します。\n   * @param message エラーメッセージ\n   * @param resource 見つからなかったリソース名\n   */\n  constructor(message = 'The requested resource was not found', resource?: string) {\n    super('error/not-found', message, {\n      displayMode: 'page',\n      severity: 'error',\n      metadata: { resource },\n    });\n    this.name = 'NotFoundError';\n  }\n}\n\n/**\n * バリデーションエラー\n */\nexport class ValidationError extends AppError {\n  /**\n   * ValidationError の新しいインスタンスを生成します。\n   * @param message エラーメッセージ\n   * @param fields フィールドごとのエラーマッピング\n   */\n  constructor(message: string, fields?: Record<string, string>) {\n    super('error/validation', message, {\n      displayMode: 'inline',\n      severity: 'warning',\n      metadata: { fields },\n    });\n    this.name = 'ValidationError';\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;AAqCA,IAAaa,IAAb,MAAaA,UAAiB,MAAM;CAElC;CAGA;CAGA;CAGA;CAGA;CAQA,YACE,GACA,GACA,GAMA;EAUA,AATA,MAAMC,CAAO,GACb,KAAK,OAAO,YACZ,KAAK,OAAOC,GACZ,KAAK,cAAcC,GAAS,eAAe,gBAC3C,KAAK,WAAWA,GAAS,YAAY,SACrC,KAAK,WAAWA,GAAS,UACzB,KAAK,gBAAgBA,GAAS,eAG9B,OAAO,eAAe,MAAM,WAAW,SAAS;CAClD;CAMA,OAAO,KAAK,GAAgB,IAAuC,gBAA0B;EAC3F,IAAIC,aAAiBJ,GACnB,OAAOI;EAGT,IAAIA,aAAiB,OAAO;GAE1B,IAAI,UAAUA,KAAS,OAAQA,EAA4B,QAAS,UAAU;IAC5E,IAAMF,IAAQE,EAA2B,MACrCH,IAAUG,EAAM;IAEpB,QAAQF,GAAR;KACE,KAAK;MACH,IAAUf,EAA4B;MACtC;KACF,KAAK;MACH,IAAUC,EAA6B;MACvC;KACF,KAAK;MACH,IAAUC,EAA6B;MACvC;KACF,KAAK;MACH,IAAUC,EAA4B;MACtC;KACF,KAAK;MACH,IAAUC,EAAgC;MAC1C;KACF,KAAK;MACH,IAAUC,EAAoC;MAC9C;KACF,KAAK;MACH,IAAUC,EAAmC;MAC7C;KACF,KAAK;MACH,IAAUC,EAAoC;MAC9C;KACF,KAAK;MACH,IAAUC,EAAuD;MACjE;KACF,KAAK;MACH,IAAUC,EAA4B;MACtC;KACF,KAAK,+BACH,IAAUC,EAAqC;IAEnD;IAEA,OAAO,IAAIG,EAASE,GAAMD,GAAS;KACjC,aAAae;KACb,eAAeZ;IACjB,CAAC;GACH;GAKA,IAAI,UAAUA,KAAS,aAAaA,GAAO;IACzC,IAAMa,IAAcb,GACdc,IAAM,OAAOD,EAAY,WAAY,WAAWA,EAAY,UAAU;IAG5E,IAAIC,EAAI,SAAS,2BAA2B,GAC1C,OAAO,IAAIlB,EACT,+BACAF,EAAsC,GACtC;KAAE,aAAakB;KAAoB,eAAeZ;IAAM,CAC1D;IAEF,IAAIc,EAAI,SAAS,qBAAqB,GACpC,OAAO,IAAIlB,EACT,+BACAD,EAAsC,GACtC;KAAE,aAAaiB;KAAoB,eAAeZ;IAAM,CAC1D;GAEJ;GAGA,OAAO,IAAIJ,EAAS,iBAAiBI,EAAM,SAAS;IAClD,aAAaY;IACb,eAAeZ;GACjB,CAAC;EACH;EAGA,OAAO,IAAIJ,EAAS,iBAAiB,OAAOI,CAAK,GAAG,EAClD,aAAaY,EACf,CAAC;CACH;CAKA,WAAmB;EACjB,OAAO,IAAI,KAAK,KAAK,IAAI,KAAK;CAChC;CAKA,SAAkC;EAChC,OAAO;GACL,MAAM,KAAK;GACX,MAAM,KAAK;GACX,SAAS,KAAK;GACd,aAAa,KAAK;GAClB,UAAU,KAAK;GACf,UAAU,KAAK;EACjB;CACF;AACF,GAKaK,IAAb,cAAkCrB,EAAS;CAMzC,YAAY,IAAU,2BAA2B,GAAmB;EAMlE,AALA,MAAM,iBAAiBC,GAAS;GAC9B,aAAa;GACb,UAAU;GACV,UAAU,EAAE,YAAS;EACvB,CAAC,GACD,KAAK,OAAO;CACd;AACF,GAKaqB,IAAb,cAAkCtB,EAAS;CAKzC,YAAY,IAAU,0BAA0B;EAK9C,AAJA,MAAM,iBAAiBC,GAAS;GAC9B,aAAa;GACb,UAAU;EACZ,CAAC,GACD,KAAK,OAAO;CACd;AACF,GAKasB,IAAb,cAAuCvB,EAAS;CAK9C,YAAY,IAAU,iDAAiD;EAKrE,AAJA,MAAM,sBAAsBC,GAAS;GACnC,aAAa;GACb,UAAU;EACZ,CAAC,GACD,KAAK,OAAO;CACd;AACF,GAKauB,IAAb,cAAmCxB,EAAS;CAM1C,YAAY,IAAU,wCAAwC,GAAmB;EAM/E,AALA,MAAM,mBAAmBC,GAAS;GAChC,aAAa;GACb,UAAU;GACV,UAAU,EAAE,YAAS;EACvB,CAAC,GACD,KAAK,OAAO;CACd;AACF,GAKawB,IAAb,cAAqCzB,EAAS;CAM5C,YAAY,GAAiB,GAAiC;EAM5D,AALA,MAAM,oBAAoBC,GAAS;GACjC,aAAa;GACb,UAAU;GACV,UAAU,EAAE,UAAO;EACrB,CAAC,GACD,KAAK,OAAO;CACd;AACF"}
+{"version":3,"file":"AppError.js","names":["m.errors_auth_invalid_email","m.errors_auth_wrong_password","m.errors_auth_user_not_found","m.errors_auth_user_disabled","m.errors_auth_too_many_requests","m.errors_auth_operation_not_allowed","m.errors_auth_email_already_in_use","m.errors_auth_requires_recent_login","m.errors_auth_account_exists_with_different_credential","m.errors_auth_weak_password","m.errors_auth_network_request_failed","m.errors_supabase_invalid_credentials","m.errors_supabase_email_not_confirmed","AppError","message","code","options","error","errors_auth_invalid_email","errors_auth_wrong_password","errors_auth_user_not_found","errors_auth_user_disabled","errors_auth_too_many_requests","errors_auth_operation_not_allowed","errors_auth_email_already_in_use","errors_auth_requires_recent_login","errors_auth_account_exists_with_different_credential","errors_auth_weak_password","errors_auth_network_request_failed","defaultDisplayMode","errorRecord","msg","errors_supabase_invalid_credentials","errors_supabase_email_not_confirmed","TimeoutError","NetworkError","UnauthorizedError","NotFoundError","ValidationError"],"sources":["../../../../src/tools/lib/error/AppError.ts"],"sourcesContent":["import * as m from '../../paraglide/messages';\n\n/**\n * Requested error presentation: inline field feedback, notification banner, modal dialog or full page.\n * @remarks This is metadata; a host renderer must display the error.\n * @see AppError for creation.\n */\nexport type ErrorDisplayMode = 'inline' | 'notification' | 'dialog' | 'page';\n\n/**\n * Presentation severity from informational through critical; does not change Error behavior.\n * @see AppError for creation.\n */\nexport type ErrorSeverity = 'info' | 'warning' | 'error' | 'critical';\n\n/**\n * Application Error carrying a code, display hint, severity and optional metadata/original error.\n * @remarks Presentation hints do not render UI or enforce authorization. Metadata is retained\n * by reference and included in toJSON; exclude secrets before displaying or serializing.\n * @example\n * ```ts\n * import { AppError } from '@alneas/appkit-react/tools/core';\n * const error = new AppError('validation/input', 'Review the input', { displayMode: 'inline', severity: 'warning' });\n * ```\n */\nexport class AppError extends Error {\n    /**\n   * Stable host error code, also usable for localized message lookup.\n   */\n  readonly code: string;\n\n    /**\n   * Recommended host display mode; defaults to notification.\n   */\n  readonly displayMode: ErrorDisplayMode;\n\n    /**\n   * Presentation severity; defaults to error.\n   */\n  readonly severity: ErrorSeverity;\n\n    /**\n   * Optional host metadata retained by reference and included in JSON serialization.\n   */\n  readonly metadata?: Record<string, unknown>;\n\n    /**\n   * Optional wrapped Error retained by reference; excluded from toJSON.\n   */\n  readonly originalError?: Error;\n\n  /**\n * Creates an Error with explicit application code and presentation metadata.\n * @param code - Host error identifier; no format validation is applied.\n * @param message - Error message stored by the Error base class.\n * @param options - Optional displayMode/severity (defaults notification/error), metadata and wrapped Error.\n * @example\n * ```ts\n * import { AppError } from '@alneas/appkit-react/tools/core';\n * const error = new AppError('error/example', 'Operation failed');\n * ```\n */\n  constructor(\n    code: string,\n    message: string,\n    options?: {\n      /**\n       * Presentation hint, default notification.\n       */\n      displayMode?: ErrorDisplayMode;\n      /**\n       * Presentation severity, default error.\n       */\n      severity?: ErrorSeverity;\n      /**\n       * Optional host metadata included by toJSON.\n       */\n      metadata?: Record<string, unknown>;\n      /**\n       * Optional wrapped Error, excluded from toJSON.\n       */\n      originalError?: Error;\n    },\n  ) {\n    super(message);\n    this.name = 'AppError';\n    this.code = code;\n    this.displayMode = options?.displayMode ?? 'notification';\n    this.severity = options?.severity ?? 'error';\n    this.metadata = options?.metadata;\n    this.originalError = options?.originalError;\n\n    // Error の prototype chain を正しく設定\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  /**\n * Converts an unknown value to AppError, preserving an existing AppError unchanged.\n * @param error - Error or arbitrary thrown value to normalize.\n * @param defaultDisplayMode - Hint for newly created wrappers; defaults to notification.\n * @returns Existing AppError identity, or a new wrapper. Error instances with a string code\n * retain that code and map selected known auth messages; other Errors use message matching\n * or error/unknown. Non-Error values are stringified as error/unknown.\n * @remarks Plain objects with code/message are not interpreted as Error instances. The\n * default display hint does not override an existing AppError. No UI is rendered.\n * @example\n * ```ts\n * import { AppError } from '@alneas/appkit-react/tools/core';\n * const error = AppError.from(new Error('Unavailable'), 'dialog');\n * ```\n */\n  static from(error: unknown, defaultDisplayMode: ErrorDisplayMode = 'notification'): AppError {\n    if (error instanceof AppError) {\n      return error;\n    }\n\n    if (error instanceof Error) {\n      // Firebase Auth Error\n      if ('code' in error && typeof (error as { code: unknown }).code === 'string') {\n        const code = (error as { code: string }).code;\n        let message = error.message;\n\n        switch (code) {\n          case 'auth/invalid-email':\n            message = m.errors_auth_invalid_email();\n            break;\n          case 'auth/wrong-password':\n            message = m.errors_auth_wrong_password();\n            break;\n          case 'auth/user-not-found':\n            message = m.errors_auth_user_not_found();\n            break;\n          case 'auth/user-disabled':\n            message = m.errors_auth_user_disabled();\n            break;\n          case 'auth/too-many-requests':\n            message = m.errors_auth_too_many_requests();\n            break;\n          case 'auth/operation-not-allowed':\n            message = m.errors_auth_operation_not_allowed();\n            break;\n          case 'auth/email-already-in-use':\n            message = m.errors_auth_email_already_in_use();\n            break;\n          case 'auth/requires-recent-login':\n            message = m.errors_auth_requires_recent_login();\n            break;\n          case 'auth/credential-already-in-use':\n            message = m.errors_auth_account_exists_with_different_credential();\n            break;\n          case 'auth/weak-password':\n            message = m.errors_auth_weak_password();\n            break;\n          case 'auth/network-request-failed':\n            message = m.errors_auth_network_request_failed();\n            break;\n        }\n\n        return new AppError(code, message, {\n          displayMode: defaultDisplayMode,\n          originalError: error,\n        });\n      }\n\n      // Supabase/PostgreSQL Error\n      // Supabase errors often have 'code' and 'message'.\n      // We can also look for specific strings in the message if the code is generic.\n      if ('code' in error || 'message' in error) {\n        const errorRecord = error as { code?: unknown; message?: unknown };\n        const msg = typeof errorRecord.message === 'string' ? errorRecord.message : '';\n\n        // Supabase generic error message mapping\n        if (msg.includes('Invalid login credentials')) {\n          return new AppError(\n            'bg-auth/invalid-credentials',\n            m.errors_supabase_invalid_credentials(),\n            { displayMode: defaultDisplayMode, originalError: error },\n          );\n        }\n        if (msg.includes('Email not confirmed')) {\n          return new AppError(\n            'bg-auth/email-not-confirmed',\n            m.errors_supabase_email_not_confirmed(),\n            { displayMode: defaultDisplayMode, originalError: error },\n          );\n        }\n      }\n\n      // Generic Error\n      return new AppError('error/unknown', error.message, {\n        displayMode: defaultDisplayMode,\n        originalError: error,\n      });\n    }\n\n    // Unknown type\n    return new AppError('error/unknown', String(error), {\n      displayMode: defaultDisplayMode,\n    });\n  }\n\n  /**\n * Formats the application code and message for display/logging.\n * @returns String in [code] message form; does not include metadata or stack.\n * @example\n * ```ts\n * import { AppError } from '@alneas/appkit-react/tools/core';\n * const error = new AppError('error/example', 'Unavailable').toString();\n * ```\n */\n  toString(): string {\n    return `[${this.code}] ${this.message}`;\n  }\n\n  /**\n * Selects enumerable presentation fields for JSON serialization.\n * @returns New object with name/code/message/displayMode/severity/metadata; stack and originalError are omitted.\n * @remarks Metadata remains referenced and may itself be non-serializable or sensitive.\n * @example\n * ```ts\n * import { AppError } from '@alneas/appkit-react/tools/core';\n * const error = new AppError('error/example', 'Unavailable').toJSON();\n * ```\n */\n  toJSON(): Record<string, unknown> {\n    return {\n      name: this.name,\n      code: this.code,\n      message: this.message,\n      displayMode: this.displayMode,\n      severity: this.severity,\n      metadata: this.metadata,\n    };\n  }\n}\n\n/**\n * Represents an operation timeout with notification/warning presentation.\n * @remarks Construction does not start timers, perform a request or render error UI.\n * @example\n * ```ts\n * import { TimeoutError } from '@alneas/appkit-react/tools/core';\n * const error = new TimeoutError();\n * ```\n */\nexport class TimeoutError extends AppError {\n  /**\n * Creates an application error with code error/timeout.\n * @param message - Message, default The operation timed out.\n * @param duration - Optional timeout duration in milliseconds; retained in metadata.\n * @example\n * ```ts\n * import { TimeoutError } from '@alneas/appkit-react/tools/core';\n * const error = new TimeoutError();\n * ```\n */\n  constructor(message = 'The operation timed out', duration?: number) {\n    super('error/timeout', message, {\n      displayMode: 'notification',\n      severity: 'warning',\n      metadata: { duration },\n    });\n    this.name = 'TimeoutError';\n  }\n}\n\n/**\n * Represents a network failure with notification/error presentation.\n * @remarks Construction does not start timers, perform a request or render error UI.\n * @example\n * ```ts\n * import { NetworkError } from '@alneas/appkit-react/tools/core';\n * const error = new NetworkError();\n * ```\n */\nexport class NetworkError extends AppError {\n  /**\n * Creates an application error with code error/network.\n * @param message - Message, default Network error occurred.\n * @example\n * ```ts\n * import { NetworkError } from '@alneas/appkit-react/tools/core';\n * const error = new NetworkError();\n * ```\n */\n  constructor(message = 'Network error occurred') {\n    super('error/network', message, {\n      displayMode: 'notification',\n      severity: 'error',\n    });\n    this.name = 'NetworkError';\n  }\n}\n\n/**\n * Represents denied access with dialog/error presentation.\n * @remarks Construction does not start timers, perform a request or render error UI.\n * @example\n * ```ts\n * import { UnauthorizedError } from '@alneas/appkit-react/tools/core';\n * const error = new UnauthorizedError();\n * ```\n */\nexport class UnauthorizedError extends AppError {\n  /**\n * Creates an application error with code error/unauthorized.\n * @param message - Message, default You are not authorized to perform this action.\n * @example\n * ```ts\n * import { UnauthorizedError } from '@alneas/appkit-react/tools/core';\n * const error = new UnauthorizedError();\n * ```\n */\n  constructor(message = 'You are not authorized to perform this action') {\n    super('error/unauthorized', message, {\n      displayMode: 'dialog',\n      severity: 'error',\n    });\n    this.name = 'UnauthorizedError';\n  }\n}\n\n/**\n * Represents a missing resource with page/error presentation.\n * @remarks Construction does not start timers, perform a request or render error UI.\n * @example\n * ```ts\n * import { NotFoundError } from '@alneas/appkit-react/tools/core';\n * const error = new NotFoundError();\n * ```\n */\nexport class NotFoundError extends AppError {\n  /**\n * Creates an application error with code error/not-found.\n * @param message - Message, default The requested resource was not found.\n * @param resource - Optional missing resource name retained in metadata.\n * @example\n * ```ts\n * import { NotFoundError } from '@alneas/appkit-react/tools/core';\n * const error = new NotFoundError();\n * ```\n */\n  constructor(message = 'The requested resource was not found', resource?: string) {\n    super('error/not-found', message, {\n      displayMode: 'page',\n      severity: 'error',\n      metadata: { resource },\n    });\n    this.name = 'NotFoundError';\n  }\n}\n\n/**\n * Represents invalid input with inline/warning presentation.\n * @remarks Construction does not start timers, perform a request or render error UI.\n * @example\n * ```ts\n * import { ValidationError } from '@alneas/appkit-react/tools/core';\n * const error = new ValidationError('Invalid input');\n * ```\n */\nexport class ValidationError extends AppError {\n  /**\n * Creates an application error with code error/validation.\n * @param message - Required validation message.\n * @param fields - Optional per-field error messages retained in metadata.\n * @example\n * ```ts\n * import { ValidationError } from '@alneas/appkit-react/tools/core';\n * const error = new ValidationError('Invalid input');\n * ```\n */\n  constructor(message: string, fields?: Record<string, string>) {\n    super('error/validation', message, {\n      displayMode: 'inline',\n      severity: 'warning',\n      metadata: { fields },\n    });\n    this.name = 'ValidationError';\n  }\n}\n"],"mappings":"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"}

package/dist/tools/lib/hooks/useAsyncWithTimeout.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"useAsyncWithTimeout.cjs","names":["useState","useError","useRef","useCallback","TimeoutError","AppError","require_tools_lib_error_AppError","require_tools_lib_hooks_useError","react","DEFAULT_TIMEOUT","useAsyncWithTimeout","options","isLoading","setIsLoading","error","setError","data","setData","abortControllerRef","isMountedRef","timeoutPromise","reject","timeout","result","fn","onSuccess","err","appError","errorDisplayMode","showErrorOnFailure","showError","onError","withTimeout","promise"],"sources":["../../../../src/tools/lib/hooks/useAsyncWithTimeout.ts"],"sourcesContent":["import { useState, useCallback, useRef, useEffect } from 'react';\nimport { AppError, TimeoutError, ErrorDisplayMode } from \"../error\";\nimport { useError } from './useError';\n\n/** デフォルトのタイムアウト時間 (30秒) */\nconst DEFAULT_TIMEOUT = 30000;\n\nexport interface UseAsyncWithTimeoutOptions<T> {\n  /** 実行する非同期関数 */\n  fn: () => Promise<T>;\n  /** タイムアウト時間 (ミリ秒)。デフォルト: 30000 */\n  timeout?: number;\n  /** エラー発生時の表示モード */\n  errorDisplayMode?: ErrorDisplayMode;\n  /** エラー発生時に自動で表示するか。デフォルト: true */\n  showErrorOnFailure?: boolean;\n  /** 成功時のコールバック */\n  onSuccess?: (data: T) => void;\n  /** エラー時のコールバック */\n  onError?: (error: AppError) => void;\n}\n\nexport interface UseAsyncWithTimeoutReturn<T> {\n  /** 非同期処理を実行 */\n  execute: () => Promise<T | undefined>;\n  /** 現在読み込み中か */\n  isLoading: boolean;\n  /** 最後に発生したエラー */\n  error: AppError | null;\n  /** 成功したデータ */\n  data: T | undefined;\n  /** エラー状態をリセット */\n  reset: () => void;\n}\n\n/**\n * タイムアウト付き非同期処理フック\n *\n * @example\n * ```tsx\n * const { execute, isLoading, error, data } = useAsyncWithTimeout({\n *     fn: async () => await api.fetchData(),\n *     timeout: 10000, // 10秒\n *     errorDisplayMode: 'notification',\n *     onSuccess: (data) => console.log('Success:', data),\n * });\n *\n * // ボタンクリックで実行\n * <button onClick={execute} disabled={isLoading}>\n *     {isLoading ? 'Loading...' : 'Fetch Data'}\n * </button>\n * ```\n */\nexport function useAsyncWithTimeout<T>(\n  options: UseAsyncWithTimeoutOptions<T>,\n): UseAsyncWithTimeoutReturn<T> {\n  const {\n    fn,\n    timeout = DEFAULT_TIMEOUT,\n    errorDisplayMode = 'notification',\n    showErrorOnFailure = true,\n    onSuccess,\n    onError,\n  } = options;\n\n  const [isLoading, setIsLoading] = useState(false);\n  const [error, setError] = useState<AppError | null>(null);\n  const [data, setData] = useState<T | undefined>(undefined);\n\n  const { showError } = useError();\n  const abortControllerRef = useRef<AbortController | null>(null);\n  const isMountedRef = useRef(true);\n\n  // コンポーネントのアンマウント時にクリーンアップ\n  useEffect(() => {\n    isMountedRef.current = true;\n    return () => {\n      isMountedRef.current = false;\n      abortControllerRef.current?.abort();\n    };\n  }, []);\n\n  const execute = useCallback(async (): Promise<T | undefined> => {\n    // 既存のリクエストをキャンセル\n    abortControllerRef.current?.abort();\n    abortControllerRef.current = new AbortController();\n\n    setIsLoading(true);\n    setError(null);\n\n    // タイムアウト用のPromise\n    const timeoutPromise = new Promise<never>((_, reject) => {\n      setTimeout(() => {\n        reject(new TimeoutError('The operation timed out', timeout));\n      }, timeout);\n    });\n\n    try {\n      // fetchとtimeoutのレース\n      const result = await Promise.race([fn(), timeoutPromise]);\n\n      if (isMountedRef.current) {\n        setData(result);\n        setIsLoading(false);\n        onSuccess?.(result);\n      }\n\n      return result;\n    } catch (err) {\n      if (!isMountedRef.current) return undefined;\n\n      const appError = AppError.from(err, errorDisplayMode);\n      setError(appError);\n      setIsLoading(false);\n\n      if (showErrorOnFailure) {\n        showError(appError);\n      }\n\n      onError?.(appError);\n      return undefined;\n    }\n  }, [fn, timeout, errorDisplayMode, showErrorOnFailure, showError, onSuccess, onError]);\n\n  const reset = useCallback(() => {\n    setIsLoading(false);\n    setError(null);\n    setData(undefined);\n    abortControllerRef.current?.abort();\n  }, []);\n\n  return {\n    execute,\n    isLoading,\n    error,\n    data,\n    reset,\n  };\n}\n\n/**\n * タイムアウト付きで Promise を実行するユーティリティ関数\n * (フック外で使用する場合)\n */\nexport async function withTimeout<T>(\n  promise: Promise<T>,\n  timeout: number = DEFAULT_TIMEOUT,\n): Promise<T> {\n  const timeoutPromise = new Promise<never>((_, reject) => {\n    setTimeout(() => {\n      reject(new TimeoutError('The operation timed out', timeout));\n    }, timeout);\n  });\n\n  return Promise.race([promise, timeoutPromise]);\n}\n"],"mappings":"A,4KAKA,IAAMS,EAAkB,IAgDxB,SAAgBC,EACd,EAC8B,CAC9B,GAAM,CACJ,KACA,UAAUD,EACV,mBAAmB,eACnB,qBAAqB,GACrB,YACA,WACEE,EAEE,CAACC,EAAWC,IAAA,EAAgBb,EAAAA,SAAAA,CAAS,EAAK,EAC1C,CAACc,EAAOC,IAAA,EAAYf,EAAAA,SAAAA,CAA0B,IAAI,EAClD,CAACgB,EAAMC,IAAA,EAAWjB,EAAAA,SAAAA,CAAwB,IAAA,EAAS,EAEnD,CAAE,aAAcC,EAAAA,SAAS,EACzBiB,GAAA,EAAqBhB,EAAAA,OAAAA,CAA+B,IAAI,EACxDiB,GAAA,EAAejB,EAAAA,OAAAA,CAAO,EAAI,EA4DhC,OAzDA,EAAAM,EAAA,UAAA,MACE,EAAa,QAAU,OACV,CACX,EAAa,QAAU,GACvBU,EAAmB,SAAS,MAAM,CACpC,GACC,CAAC,CAAC,EAmDE,CACL,SAAA,EAlDcf,EAAAA,YAAAA,CAAY,SAAoC,CAE9De,EAAmB,SAAS,MAAM,EAClC,EAAmB,QAAU,IAAI,gBAEjCL,EAAa,EAAI,EACjBE,EAAS,IAAI,EAGb,IAAMK,EAAiB,IAAI,SAAgB,EAAG,IAAW,CACvD,eAAiB,CACfC,EAAO,IAAIjB,EAAAA,aAAa,0BAA2BkB,CAAO,CAAC,CAC7D,EAAGA,CAAO,CACZ,CAAC,EAED,GAAI,CAEF,IAAMC,EAAS,MAAM,QAAQ,KAAK,CAACC,EAAG,EAAGJ,CAAc,CAAC,EAQxD,OANID,EAAa,UACfF,EAAQM,CAAM,EACdV,EAAa,EAAK,EAClBY,IAAYF,CAAM,GAGbA,CACT,OAASG,EAAK,CACZ,GAAI,CAACP,EAAa,QAAS,OAE3B,IAAMQ,EAAWtB,EAAAA,SAAS,KAAKqB,EAAKE,CAAgB,EACpDb,EAASY,CAAQ,EACjBd,EAAa,EAAK,EAEdgB,GACFC,EAAUH,CAAQ,EAGpBI,IAAUJ,CAAQ,EAClB,MACF,CACF,EAAG,CAACH,EAAIF,EAASM,EAAkBC,EAAoBC,EAAWL,EAAWM,CAAO,CAUlF,EACA,YACA,QACA,OACA,OAAA,EAZY5B,EAAAA,YAAAA,KAAkB,CAC9BU,EAAa,EAAK,EAClBE,EAAS,IAAI,EACbE,EAAQ,IAAA,EAAS,EACjBC,EAAmB,SAAS,MAAM,CACpC,EAAG,CAAC,CAOF,CACF,CACF,CAMA,eAAsBc,EACpB,EACA,EAAkBvB,EACN,CACZ,IAAMW,EAAiB,IAAI,SAAgB,EAAG,IAAW,CACvD,eAAiB,CACfC,EAAO,IAAIjB,EAAAA,aAAa,0BAA2BkB,CAAO,CAAC,CAC7D,EAAGA,CAAO,CACZ,CAAC,EAED,OAAO,QAAQ,KAAK,CAACW,EAASb,CAAc,CAAC,CAC/C,C"}
+{"version":3,"file":"useAsyncWithTimeout.cjs","names":["useState","useError","useRef","useCallback","TimeoutError","AppError","require_tools_lib_error_AppError","require_tools_lib_hooks_useError","react","DEFAULT_TIMEOUT","useAsyncWithTimeout","options","isLoading","setIsLoading","error","setError","data","setData","abortControllerRef","isMountedRef","timeoutPromise","reject","timeout","result","fn","onSuccess","err","appError","errorDisplayMode","showErrorOnFailure","showError","onError","withTimeout","promise"],"sources":["../../../../src/tools/lib/hooks/useAsyncWithTimeout.ts"],"sourcesContent":["import { useState, useCallback, useRef, useEffect } from 'react';\nimport { AppError, TimeoutError, ErrorDisplayMode } from \"../error\";\nimport { useError } from './useError';\n\n/** Default timeout delay in milliseconds (30 seconds). */\nconst DEFAULT_TIMEOUT = 30000;\n\n/**\n * Host asynchronous operation and timeout/presentation settings.\n * @typeParam T - Operation result shape.\n * @see useAsyncWithTimeout for usage.\n */\nexport interface UseAsyncWithTimeoutOptions<T> {\n    /**\n   * Host operation invoked with no abort signal.\n   * @returns Promise resolving the operation result; rejection is normalized by execute.\n   */\n  fn: () => Promise<T>;\n    /**\n   * Timeout in milliseconds; defaults to 30000. Does not cancel underlying work.\n   */\n  timeout?: number;\n    /**\n   * Display hint for newly wrapped errors; defaults to notification.\n   */\n  errorDisplayMode?: ErrorDisplayMode;\n    /**\n   * Add normalized failure to the shared error store; defaults to true.\n   */\n  showErrorOnFailure?: boolean;\n    /**\n   * Optional synchronous callback after a mounted success; errors are handled as execution failures.\n   * @param data - Resolved operation result.\n   * @returns No value.\n   */\n  onSuccess?: (data: T) => void;\n    /**\n   * Optional synchronous callback after mounted failure normalization/presentation.\n   * @param error - Normalized AppError.\n   * @returns No value; thrown callback errors reject execute.\n   */\n  onError?: (error: AppError) => void;\n}\n\n/**\n * Last result/status with explicit execute/reset controls.\n * @typeParam T - Host operation result shape.\n * @see useAsyncWithTimeout for usage.\n */\nexport interface UseAsyncWithTimeoutReturn<T> {\n    /**\n   * Race a new host operation against a timeout.\n   * @returns Host result on success, or undefined on handled failure/unmounted rejection.\n   * @throws Errors from onError/error-presentation callbacks may reject.\n   */\n  execute: () => Promise<T | undefined>;\n    /**\n   * Whether execute last set pending state; overlapping completions can overwrite this flag.\n   */\n  isLoading: boolean;\n    /**\n   * Most recent mounted execution failure or null.\n   */\n  error: AppError | null;\n    /**\n   * Last mounted success, initially undefined; errors do not clear prior data.\n   */\n  data: T | undefined;\n    /**\n   * Clear displayed loading/error/data state.\n   * @returns No value; in-flight host work can still finish and update state on this mount.\n   */\n  reset: () => void;\n}\n\n/**\n * Runs explicit asynchronous work against a display timeout and tracks the last completion.\n * @typeParam T - Host operation result shape.\n * @param options - Host operation, timeout, presentation settings and synchronous outcome callbacks.\n * @returns Execute/reset controls and displayed loading, result and normalized error state.\n * @remarks Requires React and the shared error store; no context or styles are required by\n * the hook. The internal AbortController is never passed to fn: new executes, reset and\n * unmount do not cancel host work. Unmount suppresses state/callback updates; overlapping\n * operations on one mount can complete out of order. Timeout timers are not cleared on\n * settlement. onSuccess errors enter failure handling; onError errors may reject execute.\n * To display errors, mount a host renderer for useError's shared store.\n * @example\n * ```tsx\n * import { useAsyncWithTimeout } from '@alneas/appkit-react/tools/core';\n * export function Load({ load }: { load: () => Promise<string> }) {\n *   const task = useAsyncWithTimeout({ fn: load, timeout: 10000 });\n *   return <button disabled={task.isLoading} onClick={() => { void task.execute(); }}>{task.data ?? 'Load'}</button>;\n * }\n * ```\n */\nexport function useAsyncWithTimeout<T>(\n  options: UseAsyncWithTimeoutOptions<T>,\n): UseAsyncWithTimeoutReturn<T> {\n  const {\n    fn,\n    timeout = DEFAULT_TIMEOUT,\n    errorDisplayMode = 'notification',\n    showErrorOnFailure = true,\n    onSuccess,\n    onError,\n  } = options;\n\n  const [isLoading, setIsLoading] = useState(false);\n  const [error, setError] = useState<AppError | null>(null);\n  const [data, setData] = useState<T | undefined>(undefined);\n\n  const { showError } = useError();\n  const abortControllerRef = useRef<AbortController | null>(null);\n  const isMountedRef = useRef(true);\n\n  // コンポーネントのアンマウント時にクリーンアップ\n  useEffect(() => {\n    isMountedRef.current = true;\n    return () => {\n      isMountedRef.current = false;\n      abortControllerRef.current?.abort();\n    };\n  }, []);\n\n  const execute = useCallback(async (): Promise<T | undefined> => {\n    // 既存のリクエストをキャンセル\n    abortControllerRef.current?.abort();\n    abortControllerRef.current = new AbortController();\n\n    setIsLoading(true);\n    setError(null);\n\n    // タイムアウト用のPromise\n    const timeoutPromise = new Promise<never>((_, reject) => {\n      setTimeout(() => {\n        reject(new TimeoutError('The operation timed out', timeout));\n      }, timeout);\n    });\n\n    try {\n      // fetchとtimeoutのレース\n      const result = await Promise.race([fn(), timeoutPromise]);\n\n      if (isMountedRef.current) {\n        setData(result);\n        setIsLoading(false);\n        onSuccess?.(result);\n      }\n\n      return result;\n    } catch (err) {\n      if (!isMountedRef.current) return undefined;\n\n      const appError = AppError.from(err, errorDisplayMode);\n      setError(appError);\n      setIsLoading(false);\n\n      if (showErrorOnFailure) {\n        showError(appError);\n      }\n\n      onError?.(appError);\n      return undefined;\n    }\n  }, [fn, timeout, errorDisplayMode, showErrorOnFailure, showError, onSuccess, onError]);\n\n  const reset = useCallback(() => {\n    setIsLoading(false);\n    setError(null);\n    setData(undefined);\n    abortControllerRef.current?.abort();\n  }, []);\n\n  return {\n    execute,\n    isLoading,\n    error,\n    data,\n    reset,\n  };\n}\n\n/**\n * Races an existing promise against a timeout rejection without cancelling either task.\n * @typeParam T - Promise result shape.\n * @param promise - Already-started host operation.\n * @param timeout - Delay in milliseconds before TimeoutError rejection; defaults to 30000.\n * @returns Original result if it wins the race.\n * @throws Rejects with the original rejection or TimeoutError, whichever settles first.\n * @remarks No React context is required. The timer is not cleared when the host promise\n * settles; timeout does not abort the operation or roll back its effects.\n * @example\n * ```ts\n * import { withTimeout } from '@alneas/appkit-react/tools/core';\n * export function limited<T>(operation: Promise<T>) { return withTimeout(operation, 5000); }\n * ```\n */\nexport async function withTimeout<T>(\n  promise: Promise<T>,\n  timeout: number = DEFAULT_TIMEOUT,\n): Promise<T> {\n  const timeoutPromise = new Promise<never>((_, reject) => {\n    setTimeout(() => {\n      reject(new TimeoutError('The operation timed out', timeout));\n    }, timeout);\n  });\n\n  return Promise.race([promise, timeoutPromise]);\n}\n"],"mappings":"A,4KAKA,IAAMS,EAAkB,IA0FxB,SAAgBC,EACd,EAC8B,CAC9B,GAAM,CACJ,KACA,UAAUD,EACV,mBAAmB,eACnB,qBAAqB,GACrB,YACA,WACEE,EAEE,CAACC,EAAWC,IAAA,EAAgBb,EAAAA,SAAAA,CAAS,EAAK,EAC1C,CAACc,EAAOC,IAAA,EAAYf,EAAAA,SAAAA,CAA0B,IAAI,EAClD,CAACgB,EAAMC,IAAA,EAAWjB,EAAAA,SAAAA,CAAwB,IAAA,EAAS,EAEnD,CAAE,aAAcC,EAAAA,SAAS,EACzBiB,GAAA,EAAqBhB,EAAAA,OAAAA,CAA+B,IAAI,EACxDiB,GAAA,EAAejB,EAAAA,OAAAA,CAAO,EAAI,EA4DhC,OAzDA,EAAAM,EAAA,UAAA,MACE,EAAa,QAAU,OACV,CACX,EAAa,QAAU,GACvBU,EAAmB,SAAS,MAAM,CACpC,GACC,CAAC,CAAC,EAmDE,CACL,SAAA,EAlDcf,EAAAA,YAAAA,CAAY,SAAoC,CAE9De,EAAmB,SAAS,MAAM,EAClC,EAAmB,QAAU,IAAI,gBAEjCL,EAAa,EAAI,EACjBE,EAAS,IAAI,EAGb,IAAMK,EAAiB,IAAI,SAAgB,EAAG,IAAW,CACvD,eAAiB,CACfC,EAAO,IAAIjB,EAAAA,aAAa,0BAA2BkB,CAAO,CAAC,CAC7D,EAAGA,CAAO,CACZ,CAAC,EAED,GAAI,CAEF,IAAMC,EAAS,MAAM,QAAQ,KAAK,CAACC,EAAG,EAAGJ,CAAc,CAAC,EAQxD,OANID,EAAa,UACfF,EAAQM,CAAM,EACdV,EAAa,EAAK,EAClBY,IAAYF,CAAM,GAGbA,CACT,OAASG,EAAK,CACZ,GAAI,CAACP,EAAa,QAAS,OAE3B,IAAMQ,EAAWtB,EAAAA,SAAS,KAAKqB,EAAKE,CAAgB,EACpDb,EAASY,CAAQ,EACjBd,EAAa,EAAK,EAEdgB,GACFC,EAAUH,CAAQ,EAGpBI,IAAUJ,CAAQ,EAClB,MACF,CACF,EAAG,CAACH,EAAIF,EAASM,EAAkBC,EAAoBC,EAAWL,EAAWM,CAAO,CAUlF,EACA,YACA,QACA,OACA,OAAA,EAZY5B,EAAAA,YAAAA,KAAkB,CAC9BU,EAAa,EAAK,EAClBE,EAAS,IAAI,EACbE,EAAQ,IAAA,EAAS,EACjBC,EAAmB,SAAS,MAAM,CACpC,EAAG,CAAC,CAOF,CACF,CACF,CAiBA,eAAsBc,EACpB,EACA,EAAkBvB,EACN,CACZ,IAAMW,EAAiB,IAAI,SAAgB,EAAG,IAAW,CACvD,eAAiB,CACfC,EAAO,IAAIjB,EAAAA,aAAa,0BAA2BkB,CAAO,CAAC,CAC7D,EAAGA,CAAO,CACZ,CAAC,EAED,OAAO,QAAQ,KAAK,CAACW,EAASb,CAAc,CAAC,CAC/C,C"}

package/dist/tools/lib/hooks/useAsyncWithTimeout.d.cts

@@ -1,51 +1,104 @@
 import { AppError, ErrorDisplayMode } from '../error/index.cjs';
+/**
+ * Host asynchronous operation and timeout/presentation settings.
+ * @typeParam T - Operation result shape.
+ * @see useAsyncWithTimeout for usage.
+ */
 export interface UseAsyncWithTimeoutOptions<T> {
-    /** 実行する非同期関数 */
+    /**
+   * Host operation invoked with no abort signal.
+   * @returns Promise resolving the operation result; rejection is normalized by execute.
+   */
     fn: () => Promise<T>;
-    /** タイムアウト時間 (ミリ秒)。デフォルト: 30000 */
+    /**
+   * Timeout in milliseconds; defaults to 30000. Does not cancel underlying work.
+   */
     timeout?: number;
-    /** エラー発生時の表示モード */
+    /**
+   * Display hint for newly wrapped errors; defaults to notification.
+   */
     errorDisplayMode?: ErrorDisplayMode;
-    /** エラー発生時に自動で表示するか。デフォルト: true */
+    /**
+   * Add normalized failure to the shared error store; defaults to true.
+   */
     showErrorOnFailure?: boolean;
-    /** 成功時のコールバック */
+    /**
+   * Optional synchronous callback after a mounted success; errors are handled as execution failures.
+   * @param data - Resolved operation result.
+   * @returns No value.
+   */
     onSuccess?: (data: T) => void;
-    /** エラー時のコールバック */
+    /**
+   * Optional synchronous callback after mounted failure normalization/presentation.
+   * @param error - Normalized AppError.
+   * @returns No value; thrown callback errors reject execute.
+   */
     onError?: (error: AppError) => void;
 }
+/**
+ * Last result/status with explicit execute/reset controls.
+ * @typeParam T - Host operation result shape.
+ * @see useAsyncWithTimeout for usage.
+ */
 export interface UseAsyncWithTimeoutReturn<T> {
-    /** 非同期処理を実行 */
+    /**
+   * Race a new host operation against a timeout.
+   * @returns Host result on success, or undefined on handled failure/unmounted rejection.
+   * @throws Errors from onError/error-presentation callbacks may reject.
+   */
     execute: () => Promise<T | undefined>;
-    /** 現在読み込み中か */
+    /**
+   * Whether execute last set pending state; overlapping completions can overwrite this flag.
+   */
     isLoading: boolean;
-    /** 最後に発生したエラー */
+    /**
+   * Most recent mounted execution failure or null.
+   */
     error: AppError | null;
-    /** 成功したデータ */
+    /**
+   * Last mounted success, initially undefined; errors do not clear prior data.
+   */
     data: T | undefined;
-    /** エラー状態をリセット */
+    /**
+   * Clear displayed loading/error/data state.
+   * @returns No value; in-flight host work can still finish and update state on this mount.
+   */
     reset: () => void;
 }
 /**
- * タイムアウト付き非同期処理フック
- *
+ * Runs explicit asynchronous work against a display timeout and tracks the last completion.
+ * @typeParam T - Host operation result shape.
+ * @param options - Host operation, timeout, presentation settings and synchronous outcome callbacks.
+ * @returns Execute/reset controls and displayed loading, result and normalized error state.
+ * @remarks Requires React and the shared error store; no context or styles are required by
+ * the hook. The internal AbortController is never passed to fn: new executes, reset and
+ * unmount do not cancel host work. Unmount suppresses state/callback updates; overlapping
+ * operations on one mount can complete out of order. Timeout timers are not cleared on
+ * settlement. onSuccess errors enter failure handling; onError errors may reject execute.
+ * To display errors, mount a host renderer for useError's shared store.
  * @example
  * ```tsx
- * const { execute, isLoading, error, data } = useAsyncWithTimeout({
- *     fn: async () => await api.fetchData(),
- *     timeout: 10000, // 10秒
- *     errorDisplayMode: 'notification',
- *     onSuccess: (data) => console.log('Success:', data),
- * });
- *
- * // ボタンクリックで実行
- * <button onClick={execute} disabled={isLoading}>
- *     {isLoading ? 'Loading...' : 'Fetch Data'}
- * </button>
+ * import { useAsyncWithTimeout } from '@alneas/appkit-react/tools/core';
+ * export function Load({ load }: { load: () => Promise<string> }) {
+ *   const task = useAsyncWithTimeout({ fn: load, timeout: 10000 });
+ *   return <button disabled={task.isLoading} onClick={() => { void task.execute(); }}>{task.data ?? 'Load'}</button>;
+ * }
  * ```
  */
 export declare function useAsyncWithTimeout<T>(options: UseAsyncWithTimeoutOptions<T>): UseAsyncWithTimeoutReturn<T>;
 /**
- * タイムアウト付きで Promise を実行するユーティリティ関数
- * (フック外で使用する場合)
+ * Races an existing promise against a timeout rejection without cancelling either task.
+ * @typeParam T - Promise result shape.
+ * @param promise - Already-started host operation.
+ * @param timeout - Delay in milliseconds before TimeoutError rejection; defaults to 30000.
+ * @returns Original result if it wins the race.
+ * @throws Rejects with the original rejection or TimeoutError, whichever settles first.
+ * @remarks No React context is required. The timer is not cleared when the host promise
+ * settles; timeout does not abort the operation or roll back its effects.
+ * @example
+ * ```ts
+ * import { withTimeout } from '@alneas/appkit-react/tools/core';
+ * export function limited<T>(operation: Promise<T>) { return withTimeout(operation, 5000); }
+ * ```
  */
 export declare function withTimeout<T>(promise: Promise<T>, timeout?: number): Promise<T>;