unikvs 0.0.10 → 0.0.13

package/src/errors.ts

@@ -1,68 +1,54 @@
 import {
-  setErrorMessage,
-  ErrorBase,
   type ErrorOptions,
-  type ErrorMeta,
-  type IStorage,
+  ErrorBase,
+  setErrorMessage,
+  KeyNotFoundError,
+  InvalidUsageErrorBase,
 } from "@unikvs/core";
 import type { BaseIssue } from "valibot";
 
-// -------------------------------------------------------------------------------------------------
-//
-// 境界エラー
-//
-// -------------------------------------------------------------------------------------------------
+export { KeyNotFoundError, InvalidUsageErrorBase };
+export type { KeyNotFoundErrorArgs, KeyNotFoundErrorMeta } from "@unikvs/core";
 
-/**
- * 無効な入出力を表すエラーの基底クラスです。
- *
- * @template TMeta エラーのメタデータの型です。
- */
-export class InvalidUsageErrorBase<
-  TMeta extends ErrorMeta | undefined = ErrorMeta | undefined,
-> extends ErrorBase<TMeta> {}
-
-// -------------------------------------------------------------------------------------------------
+// -------------------------------------------------------------------------------------------------。
 
 /**
- * バリデーションの問題を表す valibot のイシューです。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
 export type Issue = BaseIssue<unknown>;
 
 /**
- * InvalidInputError に付与されるメタデータです。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
 export type InvalidInputErrorMeta = {
   /**
-   * 検証に失敗した入力値です。
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
    */
   readonly input: unknown;
 
   /**
-   * 検証で検出されたイシューのリストです。
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
    */
   readonly issues: readonly [Issue, ...Issue[]];
 };
 
 /**
- * InvalidInputError のコンストラクター引数です。
- *
- * エラーの追加情報 (`cause`) も含みます。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
 export type InvalidInputErrorArgs = ErrorOptions & {
   /**
-   * 検証の対象となった値です。
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
    */
   readonly value: unknown;
 
   /**
-   * 検証で検出されたイシューのリストです。
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
    */
   readonly issues: readonly [Issue, ...Issue[]];
 };
 
 /**
- * 入力値が期待するスキーマに適合しない場合に投げられるエラーです。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
 export class InvalidInputError extends InvalidUsageErrorBase<InvalidInputErrorMeta> {
   static {
@@ -71,47 +57,52 @@ export class InvalidInputError extends InvalidUsageErrorBase<InvalidInputErrorMe
 
   public constructor(args: InvalidInputErrorArgs) {
     const { value: input, issues, ...options } = args;
-    const meta: InvalidInputErrorMeta = { input, issues };
-    super(meta, ({ issues }) => issues.map((i) => i.message).join(": "), options);
+    const meta: InvalidInputErrorMeta = {
+      input,
+      issues,
+    };
+    super(
+      meta,
+      ({ issues: messageIssues }) => messageIssues.map((i) => i.message).join(": "),
+      options,
+    );
   }
 }
 
-// -------------------------------------------------------------------------------------------------
+// -------------------------------------------------------------------------------------------------。
 
 /**
- * InvalidOutputError に付与されるメタデータです。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
 export type InvalidOutputErrorMeta = {
   /**
-   * 検証に失敗した出力値です。
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
    */
   readonly output: unknown;
 
   /**
-   * 検証で検出されたイシューのリストです。
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
    */
   readonly issues: readonly [Issue, ...Issue[]];
 };
 
 /**
- * InvalidOutputError のコンストラクター引数です。
- *
- * エラーの追加情報 (`cause`) も含みます。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
 export type InvalidOutputErrorArgs = ErrorOptions & {
   /**
-   * 検証の対象となった値です。
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
    */
   readonly value: unknown;
 
   /**
-   * 検証で検出されたイシューのリストです。
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
    */
   readonly issues: readonly [Issue, ...Issue[]];
 };
 
 /**
- * 出力値が期待するスキーマに適合しない場合に投げられるエラーです。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
 export class InvalidOutputError extends InvalidUsageErrorBase<InvalidOutputErrorMeta> {
   static {
@@ -120,19 +111,26 @@ export class InvalidOutputError extends InvalidUsageErrorBase<InvalidOutputError
 
   public constructor(args: InvalidOutputErrorArgs) {
     const { value: output, issues, ...options } = args;
-    const meta: InvalidOutputErrorMeta = { output, issues };
-    super(meta, ({ issues }) => issues.map((i) => i.message).join(": "), options);
+    const meta: InvalidOutputErrorMeta = {
+      issues,
+      output,
+    };
+    super(
+      meta,
+      ({ issues: messageIssues }) => messageIssues.map((i) => i.message).join(": "),
+      options,
+    );
   }
 }
 
-// -------------------------------------------------------------------------------------------------
+// -------------------------------------------------------------------------------------------------。
 //
-// UniKvs
+// UniKvs。
 //
-// -------------------------------------------------------------------------------------------------
+// -------------------------------------------------------------------------------------------------。
 
 /**
- * すでに開いている UniKvs に対して再度オープン操作が行われた場合に投げられるエラーです。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
 export class UniKvsIsOpenError extends ErrorBase<undefined> {
   static {
@@ -147,7 +145,7 @@ export class UniKvsIsOpenError extends ErrorBase<undefined> {
 setErrorMessage(UniKvsIsOpenError, "UniKvs は開いています", "ja");
 
 /**
- * UniKvs が開かれていない状態で操作が行われた場合に投げられるエラーです。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
 export class UniKvsIsNotOpenError extends ErrorBase<undefined> {
   static {
@@ -161,87 +159,29 @@ export class UniKvsIsNotOpenError extends ErrorBase<undefined> {
 
 setErrorMessage(UniKvsIsNotOpenError, "UniKvs は開いていません", "ja");
 
-/**
- * KeyNotFoundError に付与されるメタデータです。
- */
-export type KeyNotFoundErrorMeta = {
-  /**
-   * 見つからなかったキーです。
-   */
-  readonly key: IStorage.Key;
-};
-
-/**
- * KeyNotFoundError のコンストラクター引数です。
- *
- * エラーの追加情報 (`cause`) も含みます。
- */
-export type KeyNotFoundErrorArgs = ErrorOptions & KeyNotFoundErrorMeta;
-
-/**
- * 指定したキーのデータがどのストレージにも存在しない場合に投げられるエラーです。
- */
-export class KeyNotFoundError extends ErrorBase<KeyNotFoundErrorMeta> {
-  static {
-    this.prototype.name = "UniKvsKeyNotFoundError";
-  }
-
-  public constructor(args: KeyNotFoundErrorArgs) {
-    const { key, ...options } = args;
-    const meta: KeyNotFoundErrorMeta = { key };
-    super(meta, ({ key }) => `IStorage.Key ${JSON.stringify(key)} not found`, options);
-  }
-}
-
-setErrorMessage(
-  KeyNotFoundError,
-  ({ key }) => `キー ${JSON.stringify(key)} が見つかりません`,
-  "ja",
-);
-
-// -------------------------------------------------------------------------------------------------
+// -------------------------------------------------------------------------------------------------。
 //
-// ストレージ
+// ストレージ。
 //
-// -------------------------------------------------------------------------------------------------
-
-// export type StorageIsOpenErrorMeta = {
-//   readonly name: string;
-// };
-
-// export type StorageIsOpenErrorArgs = StorageIsOpenErrorMeta;
-
-// export class StorageIsOpenError extends ErrorBase<StorageIsOpenErrorMeta> {
-//   static {
-//     this.prototype.name = "UniKvsStorageIsOpenError";
-//   }
-
-//   public constructor(args: StorageIsOpenErrorArgs, options?: ErrorOptions) {
-//     super(args, ({ name }) => `Storage "${name}" is open`, options);
-//   }
-// }
-
-// setErrorMessage(StorageIsOpenError, ({ name }) => `ストレージ "${name}" は開いています`, "ja");
+// -------------------------------------------------------------------------------------------------。
 
 /**
- * StorageIsNotOpenError に付与されるメタデータです。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
 export type StorageIsNotOpenErrorMeta = {
   /**
-   * 開かれていないストレージの名前です。
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
    */
   readonly name: string;
 };
 
 /**
- * StorageIsNotOpenError のコンストラクター引数です。
- *
- * エラーの追加情報 (`cause`) も含みます。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
 export type StorageIsNotOpenErrorArgs = ErrorOptions & StorageIsNotOpenErrorMeta;
 
 /**
- * ストレージが開かれていない状態で操作が行われた場合に投げられるエラーです。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
 export class StorageIsNotOpenError extends ErrorBase<StorageIsNotOpenErrorMeta> {
   static {
@@ -251,32 +191,30 @@ export class StorageIsNotOpenError extends ErrorBase<StorageIsNotOpenErrorMeta>
   public constructor(args: StorageIsNotOpenErrorArgs) {
     const { name, ...options } = args;
     const meta: StorageIsNotOpenErrorMeta = { name };
-    super(meta, ({ name }) => `Storage "${name}" is not open`, options);
+    super(meta, ({ name: messageName }) => `Storage "${messageName}" is not open`, options);
   }
 }
 
 setErrorMessage(StorageIsNotOpenError, ({ name }) => `ストレージ "${name}" は開いていません`, "ja");
 
 /**
- * WritableStreamNotSupportedError に付与されるメタデータです。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
 export type WritableStreamNotSupportedErrorMeta = {
   /**
-   * 対象のストレージの名前です。
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
    */
   readonly name: string;
 };
 
 /**
- * WritableStreamNotSupportedError のコンストラクター引数です。
- *
- * エラーの追加情報 (`cause`) も含みます。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
 export type WritableStreamNotSupportedErrorArgs = ErrorOptions &
   WritableStreamNotSupportedErrorMeta;
 
 /**
- * ストレージが書き込み可能なストリームをサポートしていない場合に投げられるエラーです。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
 export class WritableStreamNotSupportedError extends ErrorBase<WritableStreamNotSupportedErrorMeta> {
   static {
@@ -286,7 +224,11 @@ export class WritableStreamNotSupportedError extends ErrorBase<WritableStreamNot
   public constructor(args: WritableStreamNotSupportedErrorArgs) {
     const { name, ...options } = args;
     const meta: WritableStreamNotSupportedErrorMeta = { name };
-    super(meta, ({ name }) => `Storage "${name}" does not support writable stream`, options);
+    super(
+      meta,
+      ({ name: messageName }) => `Storage "${messageName}" does not support writable stream`,
+      options,
+    );
   }
 }
 
@@ -297,25 +239,23 @@ setErrorMessage(
 );
 
 /**
- * ReadableStreamNotSupportedError に付与されるメタデータです。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
 export type ReadableStreamNotSupportedErrorMeta = {
   /**
-   * 対象のストレージの名前です。
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
    */
   readonly name: string;
 };
 
 /**
- * ReadableStreamNotSupportedError のコンストラクター引数です。
- *
- * エラーの追加情報 (`cause`) も含みます。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
 export type ReadableStreamNotSupportedErrorArgs = ErrorOptions &
   ReadableStreamNotSupportedErrorMeta;
 
 /**
- * ストレージが読み取り可能なストリームをサポートしていない場合に投げられるエラーです。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
 export class ReadableStreamNotSupportedError extends ErrorBase<ReadableStreamNotSupportedErrorMeta> {
   static {
@@ -325,7 +265,11 @@ export class ReadableStreamNotSupportedError extends ErrorBase<ReadableStreamNot
   public constructor(args: ReadableStreamNotSupportedErrorArgs) {
     const { name, ...options } = args;
     const meta: ReadableStreamNotSupportedErrorMeta = { name };
-    super(meta, ({ name }) => `Storage "${name}" does not support readable stream`, options);
+    super(
+      meta,
+      ({ name: messageName }) => `Storage "${messageName}" does not support readable stream`,
+      options,
+    );
   }
 }
 
@@ -364,7 +308,11 @@ export class MultipartWriteNotSupportedError extends ErrorBase<MultipartWriteNot
   public constructor(args: MultipartWriteNotSupportedErrorArgs) {
     const { name, ...options } = args;
     const meta: MultipartWriteNotSupportedErrorMeta = { name };
-    super(meta, ({ name }) => `Storage "${name}" does not support multipart-write`, options);
+    super(
+      meta,
+      ({ name: messageName }) => `Storage "${messageName}" does not support multipart-write`,
+      options,
+    );
   }
 }
 
@@ -374,222 +322,480 @@ setErrorMessage(
   "ja",
 );
 
-// -------------------------------------------------------------------------------------------------
+// -------------------------------------------------------------------------------------------------。
 //
-// トランスフォーマー
+// ミドルウェア。
 //
-// -------------------------------------------------------------------------------------------------
+// -------------------------------------------------------------------------------------------------。
 
-// export type TransformerIsOpenErrorMeta = {
-//   readonly name: string;
-// };
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
+export type MiddlewareIsNotOpenErrorMeta = {
+  /**
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+   */
+  readonly name: string;
+};
 
-// export type TransformerIsOpenErrorArgs = TransformerIsOpenErrorMeta;
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
+export type MiddlewareIsNotOpenErrorArgs = ErrorOptions & MiddlewareIsNotOpenErrorMeta;
 
-// export class TransformerIsOpenError extends ErrorBase<TransformerIsOpenErrorMeta> {
-//   static {
-//     this.prototype.name = "UniKvsTransformerIsOpenError";
-//   }
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
+export class MiddlewareIsNotOpenError extends ErrorBase<MiddlewareIsNotOpenErrorMeta> {
+  static {
+    this.prototype.name = "UniKvsMiddlewareIsNotOpenError";
+  }
 
-//   public constructor(args: TransformerIsOpenErrorArgs, options?: ErrorOptions) {
-//     super(args, ({ name }) => `Transformer "${name}" is open`, options);
-//   }
-// }
+  public constructor(args: MiddlewareIsNotOpenErrorArgs) {
+    const { name, ...options } = args;
+    const meta: MiddlewareIsNotOpenErrorMeta = { name };
+    super(meta, ({ name: messageName }) => `Middleware "${messageName}" is not open`, options);
+  }
+}
 
-// setErrorMessage(TransformerIsOpenError, ({ name }) => `トランスフォーマー "${name}" は開いています`, "ja");
+setErrorMessage(
+  MiddlewareIsNotOpenError,
+  ({ name }) => `ミドルウェア "${name}" は開いていません`,
+  "ja",
+);
 
 /**
- * TransformerIsNotOpenError に付与されるメタデータです。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
-export type TransformerIsNotOpenErrorMeta = {
+export type MiddlewareDestinationMissingErrorMeta = {
   /**
-   * 開かれていないトランスフォーマーの名前です。
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
    */
   readonly name: string;
+
+  /**
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+   */
+  readonly operation: "encode" | "decode";
 };
 
 /**
- * TransformerIsNotOpenError のコンストラクター引数です。
- *
- * エラーの追加情報 (`cause`) も含みます。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
-export type TransformerIsNotOpenErrorArgs = ErrorOptions & TransformerIsNotOpenErrorMeta;
+export type MiddlewareDestinationMissingErrorArgs = ErrorOptions &
+  MiddlewareDestinationMissingErrorMeta;
 
 /**
- * トランスフォーマーが開かれていない状態で操作が行われた場合に投げられるエラーです。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
-export class TransformerIsNotOpenError extends ErrorBase<TransformerIsNotOpenErrorMeta> {
+export class MiddlewareDestinationMissingError extends ErrorBase<MiddlewareDestinationMissingErrorMeta> {
   static {
-    this.prototype.name = "UniKvsTransformerIsNotOpenError";
+    this.prototype.name = "UniKvsMiddlewareDestinationMissingError";
   }
 
-  public constructor(args: TransformerIsNotOpenErrorArgs) {
-    const { name, ...options } = args;
-    const meta: TransformerIsNotOpenErrorMeta = { name };
-    super(meta, ({ name }) => `Transformer "${name}" is not open`, options);
+  public constructor(args: MiddlewareDestinationMissingErrorArgs) {
+    const { name, operation, ...options } = args;
+    const meta: MiddlewareDestinationMissingErrorMeta = {
+      name,
+      operation,
+    };
+    super(
+      meta,
+      ({ name: messageName, operation: messageOperation }) =>
+        `Middleware "${messageName}" did not set destination for ${messageOperation}.`,
+      options,
+    );
   }
 }
 
 setErrorMessage(
-  TransformerIsNotOpenError,
-  ({ name }) => `トランスフォーマー "${name}" は開いていません`,
+  MiddlewareDestinationMissingError,
+  ({ name, operation }) =>
+    `ミドルウェア "${name}" は ${operation} の destination を設定しませんでした。`,
   "ja",
 );
 
 /**
- * EncodableStreamNotSupportedError に付与されるメタデータです。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
-export type EncodableStreamNotSupportedErrorMeta = {
+export type MiddlewareDestinationFrozenErrorMeta = {
   /**
-   * 対象のトランスフォーマーの名前です。
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+   */
+  readonly action: "set" | "get" | "stream";
+
+  /**
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+   */
+  readonly key: string;
+};
+
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
+export type MiddlewareDestinationFrozenErrorArgs = ErrorOptions &
+  MiddlewareDestinationFrozenErrorMeta;
+
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
+export class MiddlewareDestinationFrozenError extends ErrorBase<MiddlewareDestinationFrozenErrorMeta> {
+  static {
+    this.prototype.name = "UniKvsMiddlewareDestinationFrozenError";
+  }
+
+  public constructor(args: MiddlewareDestinationFrozenErrorArgs) {
+    const { key, action, ...options } = args;
+    const meta: MiddlewareDestinationFrozenErrorMeta = {
+      key,
+      action,
+    };
+    super(
+      meta,
+      ({ key: messageKey, action: messageAction }) =>
+        `Cannot set destination after next() was called for ${messageAction} operation on key ${JSON.stringify(messageKey)}.`,
+      options,
+    );
+  }
+}
+
+setErrorMessage(
+  MiddlewareDestinationFrozenError,
+  ({ key: messageKey, action: messageAction }) =>
+    `next() を呼び出した後に destination を設定できません（${messageAction} 操作、キー ${JSON.stringify(messageKey)}）。`,
+  "ja",
+);
+
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
+export type MiddlewareNextNotCalledErrorMeta = {
+  /**
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
    */
   readonly name: string;
+
+  /**
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+   */
+  readonly operation: "encode" | "decode" | "use";
 };
 
 /**
- * EncodableStreamNotSupportedError のコンストラクター引数です。
- *
- * エラーの追加情報 (`cause`) も含みます。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
+export type MiddlewareNextNotCalledErrorArgs = ErrorOptions & MiddlewareNextNotCalledErrorMeta;
+
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
+export class MiddlewareNextNotCalledError extends ErrorBase<MiddlewareNextNotCalledErrorMeta> {
+  static {
+    this.prototype.name = "UniKvsMiddlewareNextNotCalledError";
+  }
+
+  public constructor(args: MiddlewareNextNotCalledErrorArgs) {
+    const { name, operation, ...options } = args;
+    const meta: MiddlewareNextNotCalledErrorMeta = {
+      name,
+      operation,
+    };
+    super(
+      meta,
+      ({ name: messageName, operation: messageOperation }) =>
+        `Middleware "${messageName}" did not call next() for ${messageOperation}.`,
+      options,
+    );
+  }
+}
+
+setErrorMessage(
+  MiddlewareNextNotCalledError,
+  ({ name, operation }) => `ミドルウェア "${name}" は ${operation} で next() を呼びませんでした。`,
+  "ja",
+);
+
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
+export type MiddlewareNextNotAwaitedErrorMeta = {
+  /**
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+   */
+  readonly name: string;
+
+  /**
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+   */
+  readonly operation: "encode" | "decode" | "use";
+};
+
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
+export type MiddlewareNextNotAwaitedErrorArgs = ErrorOptions & MiddlewareNextNotAwaitedErrorMeta;
+
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
+export class MiddlewareNextNotAwaitedError extends ErrorBase<MiddlewareNextNotAwaitedErrorMeta> {
+  static {
+    this.prototype.name = "UniKvsMiddlewareNextNotAwaitedError";
+  }
+
+  public constructor(args: MiddlewareNextNotAwaitedErrorArgs) {
+    const { name, operation, ...options } = args;
+    const meta: MiddlewareNextNotAwaitedErrorMeta = {
+      name,
+      operation,
+    };
+    super(
+      meta,
+      ({ name: messageName, operation: messageOperation }) =>
+        `Middleware "${messageName}" did not await next() for ${messageOperation}.`,
+      options,
+    );
+  }
+}
+
+setErrorMessage(
+  MiddlewareNextNotAwaitedError,
+  ({ name, operation }) =>
+    `ミドルウェア "${name}" は ${operation} で next() を await しませんでした。`,
+  "ja",
+);
+
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
+export type MiddlewareNextCalledMultipleTimesErrorMeta = {
+  /**
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+   */
+  readonly name: string;
+
+  /**
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+   */
+  readonly operation: "encode" | "decode" | "use";
+};
+
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
+export type MiddlewareNextCalledMultipleTimesErrorArgs = ErrorOptions &
+  MiddlewareNextCalledMultipleTimesErrorMeta;
+
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
+export class MiddlewareNextCalledMultipleTimesError extends ErrorBase<MiddlewareNextCalledMultipleTimesErrorMeta> {
+  static {
+    this.prototype.name = "UniKvsMiddlewareNextCalledMultipleTimesError";
+  }
+
+  public constructor(args: MiddlewareNextCalledMultipleTimesErrorArgs) {
+    const { name, operation, ...options } = args;
+    const meta: MiddlewareNextCalledMultipleTimesErrorMeta = {
+      name,
+      operation,
+    };
+    super(
+      meta,
+      ({ name: messageName, operation: messageOperation }) =>
+        `Middleware "${messageName}" called next() multiple times for ${messageOperation}.`,
+      options,
+    );
+  }
+}
+
+setErrorMessage(
+  MiddlewareNextCalledMultipleTimesError,
+  ({ name, operation }) => `ミドルウェア "${name}" は ${operation} で next() を複数回呼びました。`,
+  "ja",
+);
+
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
+export type StreamEncodingNotSupportedErrorMeta = {
+  /**
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+   */
+  readonly name: string;
+};
+
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
-export type EncodableStreamNotSupportedErrorArgs = ErrorOptions &
-  EncodableStreamNotSupportedErrorMeta;
+export type StreamEncodingNotSupportedErrorArgs = ErrorOptions &
+  StreamEncodingNotSupportedErrorMeta;
 
 /**
- * トランスフォーマーがエンコード可能なストリームをサポートしていない場合に投げられるエラーです。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
-export class EncodableStreamNotSupportedError extends ErrorBase<EncodableStreamNotSupportedErrorMeta> {
+export class StreamEncodingNotSupportedError extends ErrorBase<StreamEncodingNotSupportedErrorMeta> {
   static {
-    this.prototype.name = "UniKvsEncodableStreamNotSupportedError";
+    this.prototype.name = "UniKvsStreamEncodingNotSupportedError";
   }
 
-  public constructor(args: EncodableStreamNotSupportedErrorArgs) {
+  public constructor(args: StreamEncodingNotSupportedErrorArgs) {
     const { name, ...options } = args;
-    const meta: EncodableStreamNotSupportedErrorMeta = { name };
-    super(meta, ({ name }) => `Transformer "${name}" does not support encodable stream`, options);
+    const meta: StreamEncodingNotSupportedErrorMeta = { name };
+    super(
+      meta,
+      ({ name: messageName }) => `Middleware "${messageName}" does not support stream encoding.`,
+      options,
+    );
   }
 }
 
 setErrorMessage(
-  EncodableStreamNotSupportedError,
-  ({ name }) => `トランスフォーマー "${name}" はエンコード可能なストリームをサポートしていません`,
+  StreamEncodingNotSupportedError,
+  ({ name }) => `ミドルウェア "${name}" はストリームのエンコードをサポートしていません。`,
   "ja",
 );
 
 /**
- * DecodableStreamNotSupportedError に付与されるメタデータです。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
-export type DecodableStreamNotSupportedErrorMeta = {
+export type StreamDecodingNotSupportedErrorMeta = {
   /**
-   * 対象のトランスフォーマーの名前です。
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
    */
   readonly name: string;
 };
 
 /**
- * DecodableStreamNotSupportedError のコンストラクター引数です。
- *
- * エラーの追加情報 (`cause`) も含みます。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
-export type DecodableStreamNotSupportedErrorArgs = ErrorOptions &
-  DecodableStreamNotSupportedErrorMeta;
+export type StreamDecodingNotSupportedErrorArgs = ErrorOptions &
+  StreamDecodingNotSupportedErrorMeta;
 
 /**
- * トランスフォーマーがデコード可能なストリームをサポートしていない場合に投げられるエラーです。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
-export class DecodableStreamNotSupportedError extends ErrorBase<DecodableStreamNotSupportedErrorMeta> {
+export class StreamDecodingNotSupportedError extends ErrorBase<StreamDecodingNotSupportedErrorMeta> {
   static {
-    this.prototype.name = "UniKvsDecodableStreamNotSupportedError";
+    this.prototype.name = "UniKvsStreamDecodingNotSupportedError";
   }
 
-  public constructor(args: DecodableStreamNotSupportedErrorArgs) {
+  public constructor(args: StreamDecodingNotSupportedErrorArgs) {
     const { name, ...options } = args;
-    const meta: DecodableStreamNotSupportedErrorMeta = { name };
-    super(meta, ({ name }) => `Transformer "${name}" does not support decodable stream`, options);
+    const meta: StreamDecodingNotSupportedErrorMeta = { name };
+    super(
+      meta,
+      ({ name: messageName }) => `Middleware "${messageName}" does not support decodable stream`,
+      options,
+    );
   }
 }
 
 setErrorMessage(
-  DecodableStreamNotSupportedError,
-  ({ name }) => `トランスフォーマー "${name}" はデコード可能なストリームをサポートしていません`,
+  StreamDecodingNotSupportedError,
+  ({ name }) => `ミドルウェア "${name}" はデコード可能なストリームをサポートしていません`,
   "ja",
 );
 
-// -------------------------------------------------------------------------------------------------
+// -------------------------------------------------------------------------------------------------。
 //
-// ストレージ / トランスフォーマー
+// ストレージ / ミドルウェア。
 //
-// -------------------------------------------------------------------------------------------------
+// -------------------------------------------------------------------------------------------------。
 
 /**
- * PluginOperationAggregateError に付与されるメタデータです。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
 export type PluginOperationAggregateErrorMeta = {
   /**
-   * 失敗した操作の対象となったプラグインの種別です。
-   *
-   * - `"plugin"`: 複数の種別のプラグインが混在しています。
-   * - `"storage"`: ストレージです。
-   * - `"transformer"`: トランスフォーマーです。
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
    */
-  readonly plugin: "plugin" | "storage" | "transformer";
+  readonly plugin: "plugin" | "storage" | "middleware";
 
   /**
-   * 失敗した操作の種類です。
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
    */
   readonly action: "open" | "close" | "write" | "read" | "delete" | "clear";
 
   /**
-   * 失敗した各プラグインの操作と原因のリストです。
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
    */
   readonly errors: readonly {
     /**
-     * 失敗したプラグインの種別です。
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
      */
-    readonly plugin: "storage" | "transformer";
+    readonly plugin: "storage" | "middleware";
 
     /**
-     * 操作が失敗した原因です。
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+     */
+    readonly name?: string;
+
+    /**
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+     */
+    readonly index?: number;
+
+    /**
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
      */
     readonly reason: unknown;
   }[];
 };
 
 /**
- * PluginOperationAggregateError のコンストラクター引数です。
- *
- * エラーの追加情報 (`cause`) も含みます。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
 export type PluginOperationAggregateErrorArgs = ErrorOptions & {
   /**
-   * 失敗したプラグインの既定の種別です。
-   *
-   * 個々のエラーで種別が指定されていない場合に使用されます。
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
    */
-  readonly plugin?: "storage" | "transformer";
+  readonly plugin?: "storage" | "middleware";
 
   /**
-   * 失敗した操作の種類です。
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
    */
   readonly action: "open" | "close" | "write" | "read" | "delete" | "clear";
 
   /**
-   * 失敗した各プラグインの操作と原因のリストです。
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
    */
   readonly errors: readonly {
     /**
-     * 失敗したプラグインの種別です。
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
      */
-    readonly plugin?: "storage" | "transformer";
+    readonly plugin?: "storage" | "middleware";
 
     /**
-     * 操作が失敗した原因です。
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+     */
+    readonly name?: string;
+
+    /**
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+     */
+    readonly index?: number;
+
+    /**
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
      */
     readonly reason: unknown;
   }[];
 };
 
 /**
- * 複数のストレージやトランスフォーマーの操作が失敗した場合に投げられる、個々の失敗を集約したエラーです。
+ * プラグイン種別を正規化します。
+ *
+ * @param plugin 種別名です。
+ *
+ * @returns 正規化された種別を返します。
+ */
+function normalizePlugin(plugin: string): "storage" | "middleware" {
+  return plugin as "storage" | "middleware";
+}
+
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
 export class PluginOperationAggregateError extends ErrorBase<PluginOperationAggregateErrorMeta> {
   static {
@@ -597,21 +803,24 @@ export class PluginOperationAggregateError extends ErrorBase<PluginOperationAggr
   }
 
   public constructor(args: PluginOperationAggregateErrorArgs) {
-    const { plugin, action, errors, ...options } = args;
-    // 個々のエラーで種別が指定されていない場合は、既定の種別で補完します。
+    const { action, errors, plugin, ...options } = args;
     const normalizedErrors = errors.map((error) => ({
-      plugin: error.plugin ?? plugin ?? ("" as never),
+      plugin: normalizePlugin((error.plugin ?? plugin ?? "") as string),
+      ...(error.name !== undefined ? { name: error.name } : {}),
+      ...(error.index !== undefined ? { index: error.index } : {}),
       reason: error.reason,
     }));
     const plugins = [...new Set(normalizedErrors.map((error) => error.plugin))];
+    const [onlyPlugin] = plugins;
     const meta: PluginOperationAggregateErrorMeta = {
-      plugin: plugins.length === 1 ? plugins[0]! : "plugin",
       action,
       errors: normalizedErrors,
+      plugin: plugins.length === 1 && onlyPlugin !== undefined ? onlyPlugin : "plugin",
     };
     super(
       meta,
-      ({ action, errors, plugin }) => `${errors.length} ${plugin}(s) fail ${action} operation`,
+      ({ action: messageAction, errors: messageErrors, plugin: messagePlugin }) =>
+        `${messageErrors.length} ${messagePlugin}(s) fail ${messageAction} operation`,
       options,
     );
   }
@@ -620,18 +829,24 @@ export class PluginOperationAggregateError extends ErrorBase<PluginOperationAggr
 setErrorMessage(
   PluginOperationAggregateError,
   ({ action, errors, plugin }) =>
-    `${errors.length} 個の${{ plugin: "プラグイン", storage: "ストレージ", transformer: "トランスフォーマー" }[plugin]}が ${action} 操作に失敗`,
+    `${errors.length} 個の${
+      {
+        plugin: "プラグイン",
+        storage: "ストレージ",
+        middleware: "ミドルウェア",
+      }[plugin]
+    }が ${action} 操作に失敗`,
   "ja",
 );
 
-// -------------------------------------------------------------------------------------------------
+// -------------------------------------------------------------------------------------------------。
 //
-// その他
+// その他。
 //
-// -------------------------------------------------------------------------------------------------
+// -------------------------------------------------------------------------------------------------。
 
 /**
- * ストレージが一つも登録されていない状態で UniKvs を作成しようとした場合に投げられるエラーです。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
 export class MissingStorageError extends ErrorBase<undefined> {
   static {
@@ -648,24 +863,3 @@ setErrorMessage(
   "UniKvs を使用するためには最低 1 つのストレージが必要です",
   "ja",
 );
-
-// -------------------------------------------------------------------------------------------------
-
-/**
- * ストレージが登録された後にトランスフォーマーを追加しようとした場合に投げられるエラーです。
- */
-export class TransformerRegistrationError extends ErrorBase<undefined> {
-  static {
-    this.prototype.name = "UniKvsTransformerRegistrationError";
-  }
-
-  public constructor(options?: ErrorOptions) {
-    super("Cannot add transformers after storage has already been registered", options);
-  }
-}
-
-setErrorMessage(
-  TransformerRegistrationError,
-  "ストレージが登録された後にトランスフォーマーを追加することはできません",
-  "ja",
-);