@unikvs/memory 0.0.9 → 0.0.10

package/dist/src/errors.d.ts

@@ -3,36 +3,61 @@ import { ErrorBase, type ErrorOptions } from "@unikvs/core";
  * 指定されたキーがストレージ内に存在しないことを示すエラーメタデータ型です。
  */
 export type KeyNotFoundErrorMeta = {
+    /**
+     * 存在しなかったキーです。
+     */
     readonly key: string;
 };
 /**
  * {@link KeyNotFoundError} のコンストラクター引数型です。
+ *
+ * エラーの追加情報 (`cause`) も含みます。
  */
-export type KeyNotFoundErrorArgs = KeyNotFoundErrorMeta;
+export type KeyNotFoundErrorArgs = ErrorOptions & KeyNotFoundErrorMeta;
 /**
  * 読み取りまたは削除を実行しようとしたキーがストレージ内に存在しない場合に投げられるエラーです。
  */
 export declare class KeyNotFoundError extends ErrorBase<KeyNotFoundErrorMeta> {
-    constructor(args: KeyNotFoundErrorArgs, options?: ErrorOptions);
+    /**
+     * KeyNotFoundError インスタンスを初期化します。
+     *
+     * @param args エラーメタデータとエラーの追加情報です。
+     */
+    constructor(args: KeyNotFoundErrorArgs);
 }
 /**
  * ストリーム書き込み時に無効なチャンク型が渡されたことを示すエラーメタデータ型です。
  */
 export type InvalidChunkTypeErrorMeta = {
+    /**
+     * 書き込み先または読み取り元のキーです。
+     */
     readonly key: string;
+    /**
+     * 型が無効だったチャンクの値です。
+     */
     readonly chunk: unknown;
+    /**
+     * 実際に渡されたチャンク値の型名です。
+     */
     readonly chunkType: string;
 };
 /**
  * {@link InvalidChunkTypeError} のコンストラクター引数型です。
  *
  * `chunkType` はコンストラクター内部で自動的に設定されるため、引数からは除外されています。
+ * また、エラーの追加情報 (`cause`) も含みます。
  */
-export type InvalidChunkTypeErrorArgs = Omit<InvalidChunkTypeErrorMeta, "chunkType">;
+export type InvalidChunkTypeErrorArgs = ErrorOptions & Omit<InvalidChunkTypeErrorMeta, "chunkType">;
 /**
  * `getWritable` が返すストリームに `Uint8Array<ArrayBuffer>` 以外の値が書き込まれた場合に投げられるエラーです。
  */
 export declare class InvalidChunkTypeError extends ErrorBase<InvalidChunkTypeErrorMeta> {
-    constructor(args: InvalidChunkTypeErrorArgs, options?: ErrorOptions);
+    /**
+     * InvalidChunkTypeError インスタンスを初期化します。
+     *
+     * @param args エラーメタデータとエラーの追加情報です。
+     */
+    constructor(args: InvalidChunkTypeErrorArgs);
 }
 //# sourceMappingURL=errors.d.ts.map

package/dist/src/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,YAAY,EAAmB,MAAM,cAAc,CAAC;AAG7E;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,CAAC;AAExD;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,SAAS,CAAC,oBAAoB,CAAC;gBAKhD,IAAI,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,YAAY;CAGtE;AAID;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAAC,yBAAyB,EAAE,WAAW,CAAC,CAAC;AAErF;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,SAAS,CAAC,yBAAyB,CAAC;gBAK1D,IAAI,EAAE,yBAAyB,EAAE,OAAO,CAAC,EAAE,YAAY;CAW3E"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,YAAY,EAAmB,MAAM,cAAc,CAAC;AAG7E;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG,oBAAoB,CAAC;AAEvE;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,SAAS,CAAC,oBAAoB,CAAC;IAKnE;;;;OAIG;IACH,YAAmB,IAAI,EAAE,oBAAoB,EAI5C;CACF;AAID;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,yBAAyB,GAAG,YAAY,GAAG,IAAI,CAAC,yBAAyB,EAAE,WAAW,CAAC,CAAC;AAEpG;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,SAAS,CAAC,yBAAyB,CAAC;IAK7E;;;;OAIG;IACH,YAAmB,IAAI,EAAE,yBAAyB,EASjD;CACF"}

package/dist/src/errors.js

@@ -5,8 +5,15 @@ import getTypeName from "type-name";
  * 読み取りまたは削除を実行しようとしたキーがストレージ内に存在しない場合に投げられるエラーです。
  */
 export class KeyNotFoundError extends ErrorBase {
-    constructor(args, options) {
-        super(args, ({ key }) => `Key not found: ${key}`, options);
+    /**
+     * KeyNotFoundError インスタンスを初期化します。
+     *
+     * @param args エラーメタデータとエラーの追加情報です。
+     */
+    constructor(args) {
+        const { key, ...options } = args;
+        const meta = { key };
+        super(meta, ({ key }) => `Key not found: ${key}`, options);
     }
 }
 _a = KeyNotFoundError;
@@ -18,11 +25,15 @@ setErrorMessage(KeyNotFoundError, ({ key }) => `キー ${key} が見つかりま
  * `getWritable` が返すストリームに `Uint8Array<ArrayBuffer>` 以外の値が書き込まれた場合に投げられるエラーです。
  */
 export class InvalidChunkTypeError extends ErrorBase {
-    constructor(args, options) {
-        super({
-            ...args,
-            chunkType: getTypeName(args.chunk),
-        }, ({ key, chunkType }) => `Expected chunk for key ${JSON.stringify(key)} is Uint8Array<ArrayBuffer>, but got ${chunkType}`, options);
+    /**
+     * InvalidChunkTypeError インスタンスを初期化します。
+     *
+     * @param args エラーメタデータとエラーの追加情報です。
+     */
+    constructor(args) {
+        const { key, chunk, ...options } = args;
+        const meta = { key, chunk, chunkType: getTypeName(chunk) };
+        super(meta, ({ key, chunkType }) => `Expected chunk for key ${JSON.stringify(key)} is Uint8Array<ArrayBuffer>, but got ${chunkType}`, options);
     }
 }
 _b = InvalidChunkTypeError;

package/dist/src/memory.d.ts

@@ -10,7 +10,9 @@ export default class Memory implements IStorage {
      * キーと値のペアを保持する内部マップです。
      */
     private readonly map;
-    /** ストレージの名前です。デバッグやエラーメッセージなどに使用されます。 */
+    /**
+     * ストレージの名前です。デバッグやエラーメッセージなどに使用されます。
+     */
     readonly name: string;
     /**
      * Memory インスタンスを初期化します。
@@ -18,13 +20,61 @@ export default class Memory implements IStorage {
      * 内部のマップを初期化し、常にオープン状態として動作します。
      */
     constructor();
+    /**
+     * メモリーストレージは常に利用可能なため、常に `true` を返します。
+     */
     get isOpen(): boolean;
+    /**
+     * 指定されたデータを、対応するキーでストレージに保存します。
+     *
+     * @param args.key 保存先のキーです。
+     * @param args.data 保存するデータです。
+     */
     write(args: Pick<IStorage.WriteArgs<any>, "key" | "data">): void;
+    /**
+     * 指定されたキーに対応するデータをストレージから取得します。
+     *
+     * @param args.key 取得元のキーです。
+     * @returns キーに対応するデータです。
+     * @throws キーがストレージ内に存在しない場合に {@link KeyNotFoundError} を投げます。
+     */
     read(args: Pick<IStorage.ReadArgs, "key">): any;
+    /**
+     * 指定されたキーに対応するデータがストレージ内に存在するかを確認します。
+     *
+     * @param args.key 確認するキーです。
+     * @returns キーに対応するデータが存在する場合は true、それ以外は false です。
+     */
     exists(args: Pick<IStorage.ExistsArgs, "key">): boolean;
+    /**
+     * 指定されたキーに対応するデータをストレージから削除します。
+     *
+     * @param args.key 削除するキーです。
+     * @throws キーがストレージ内に存在しない場合に {@link KeyNotFoundError} を投げます。
+     */
     delete(args: Pick<IStorage.DeleteArgs, "key">): void;
+    /**
+     * ストレージ内のすべてのデータを完全に消去します。
+     */
     clear(): void;
+    /**
+     * 指定されたキーに対応する書き込み可能なストリームを取得します。
+     *
+     * メモリーストレージにはネイティブなストリームがないため、書き込まれたチャンクをメモリー上に保持し、ストリームがクローズされたときに結合して保存します。
+     *
+     * @param args.key 書き込み先のキーです。
+     * @returns 書き込み可能なストリームです。
+     */
     getWritable(args: Pick<IStorage.GetWritableArgs, "key">): WritableStream<Uint8Array<ArrayBuffer>>;
+    /**
+     * 指定されたキーに対応する読み取り可能なストリームを取得します。
+     *
+     * メモリーストレージにはネイティブなストリームがないため、既存の値を単一チャンクとしてストリームで送出します。
+     *
+     * @param args.key 読み取り元のキーです。
+     * @returns 読み取り可能なストリームです。
+     * @throws キーがストレージ内に存在しない場合に {@link KeyNotFoundError} を投げます。
+     */
     getReadable(args: Pick<IStorage.GetReadableArgs, "key">): ReadableStream<Uint8Array<ArrayBuffer>>;
 }
 //# sourceMappingURL=memory.d.ts.map

package/dist/src/memory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAI7C;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,MAAO,YAAW,QAAQ;IAC7C;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAmB;IAEvC,yCAAyC;IACzC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B;;;;OAIG;;IAMH,IAAW,MAAM,IAAI,OAAO,CAE3B;IAEM,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,GAAG,IAAI;IAKhE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,GAAG;IAW/C,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC,GAAG,OAAO;IAOvD,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC,GAAG,IAAI;IASpD,KAAK,IAAI,IAAI;IAIb,WAAW,CAChB,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,eAAe,EAAE,KAAK,CAAC,GAC1C,cAAc,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;IA6BnC,WAAW,CAChB,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,eAAe,EAAE,KAAK,CAAC,GAC1C,cAAc,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;CAqB3C"}
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAI7C;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,MAAO,YAAW,QAAQ;IAC7C;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAmB;IAEvC;;OAEG;IACH,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B;;;;OAIG;IACH,cAGC;IAED;;OAEG;IACH,IAAW,MAAM,IAAI,OAAO,CAE3B;IAED;;;;;OAKG;IACI,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,GAAG,IAAI,CAGtE;IAED;;;;;;OAMG;IACI,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,GAAG,CASrD;IAED;;;;;OAKG;IACI,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC,GAAG,OAAO,CAK7D;IAED;;;;;OAKG;IACI,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC,GAAG,IAAI,CAO1D;IAED;;OAEG;IACI,KAAK,IAAI,IAAI,CAEnB;IAED;;;;;;;OAOG;IACI,WAAW,CAChB,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,eAAe,EAAE,KAAK,CAAC,GAC1C,cAAc,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CA2BzC;IAED;;;;;;;;OAQG;IACI,WAAW,CAChB,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,eAAe,EAAE,KAAK,CAAC,GAC1C,cAAc,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAoBzC;CACF"}

package/dist/src/memory.js

@@ -15,13 +15,29 @@ export default class Memory {
         this.name = "Memory";
         this.map = new Map();
     }
+    /**
+     * メモリーストレージは常に利用可能なため、常に `true` を返します。
+     */
     get isOpen() {
         return true;
     }
+    /**
+     * 指定されたデータを、対応するキーでストレージに保存します。
+     *
+     * @param args.key 保存先のキーです。
+     * @param args.data 保存するデータです。
+     */
     write(args) {
         const { key, data } = args;
         this.map.set(key, data);
     }
+    /**
+     * 指定されたキーに対応するデータをストレージから取得します。
+     *
+     * @param args.key 取得元のキーです。
+     * @returns キーに対応するデータです。
+     * @throws キーがストレージ内に存在しない場合に {@link KeyNotFoundError} を投げます。
+     */
     read(args) {
         const { key } = args;
         if (!this.map.has(key)) {
@@ -30,11 +46,23 @@ export default class Memory {
         const value = this.map.get(key);
         return value;
     }
+    /**
+     * 指定されたキーに対応するデータがストレージ内に存在するかを確認します。
+     *
+     * @param args.key 確認するキーです。
+     * @returns キーに対応するデータが存在する場合は true、それ以外は false です。
+     */
     exists(args) {
         const { key } = args;
         const exists = this.map.has(key);
         return exists;
     }
+    /**
+     * 指定されたキーに対応するデータをストレージから削除します。
+     *
+     * @param args.key 削除するキーです。
+     * @throws キーがストレージ内に存在しない場合に {@link KeyNotFoundError} を投げます。
+     */
     delete(args) {
         const { key } = args;
         if (!this.map.has(key)) {
@@ -42,9 +70,20 @@ export default class Memory {
         }
         this.map.delete(key);
     }
+    /**
+     * ストレージ内のすべてのデータを完全に消去します。
+     */
     clear() {
         this.map.clear();
     }
+    /**
+     * 指定されたキーに対応する書き込み可能なストリームを取得します。
+     *
+     * メモリーストレージにはネイティブなストリームがないため、書き込まれたチャンクをメモリー上に保持し、ストリームがクローズされたときに結合して保存します。
+     *
+     * @param args.key 書き込み先のキーです。
+     * @returns 書き込み可能なストリームです。
+     */
     getWritable(args) {
         const { key } = args;
         // メモリーストレージにはネイティブなストリームがないため、書き込まれたチャンクを配列に保持し、クローズ時に結合して保存します。
@@ -69,6 +108,15 @@ export default class Memory {
         });
         return stream;
     }
+    /**
+     * 指定されたキーに対応する読み取り可能なストリームを取得します。
+     *
+     * メモリーストレージにはネイティブなストリームがないため、既存の値を単一チャンクとしてストリームで送出します。
+     *
+     * @param args.key 読み取り元のキーです。
+     * @returns 読み取り可能なストリームです。
+     * @throws キーがストレージ内に存在しない場合に {@link KeyNotFoundError} を投げます。
+     */
     getReadable(args) {
         const { key } = args;
         if (!this.map.has(key)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unikvs/memory",
-  "version": "0.0.9",
+  "version": "0.0.10",
   "description": "",
   "homepage": "https://github.com/tai-kun/unikvs",
   "license": "MIT",
@@ -25,23 +25,23 @@
     }
   },
   "dependencies": {
-    "@unikvs/core": "0.0.9",
-    "type-name": "^2.0.2"
+    "@unikvs/core": "0.0.10",
+    "type-name": "2.0.2"
   },
   "devDependencies": {
-    "@tsconfig/node24": "^24.0.4",
-    "@tsconfig/strictest": "^2.0.8",
-    "@types/node": "^24.12.4",
-    "@types/type-name": "^1.0.32",
-    "@vitest/browser": "^4.1.6",
-    "@vitest/browser-playwright": "^4.1.6",
-    "npm-check-updates": "^20.0.2",
-    "playwright": "^1.60.0",
-    "vite": "^8.0.12",
-    "vitest": "^4.1.6"
+    "@tsconfig/node24": "24.0.5",
+    "@tsconfig/strictest": "2.0.8",
+    "@types/node": "24.13.3",
+    "@types/type-name": "1.0.32",
+    "@vitest/browser": "4.1.10",
+    "@vitest/browser-playwright": "4.1.10",
+    "npm-check-updates": "20.0.2",
+    "playwright": "1.62.1",
+    "vite": "8.2.1",
+    "vitest": "4.1.10"
   },
   "peerDependencies": {
-    "@logtape/logtape": "^2.0.0"
+    "@logtape/logtape": "2.0.0"
   },
   "scripts": {
     "build": "tsc --project ./.config/tsconfig.build.json"

package/src/errors.ts

@@ -5,13 +5,18 @@ import getTypeName from "type-name";
  * 指定されたキーがストレージ内に存在しないことを示すエラーメタデータ型です。
  */
 export type KeyNotFoundErrorMeta = {
+  /**
+   * 存在しなかったキーです。
+   */
   readonly key: string;
 };
 
 /**
  * {@link KeyNotFoundError} のコンストラクター引数型です。
+ *
+ * エラーの追加情報 (`cause`) も含みます。
  */
-export type KeyNotFoundErrorArgs = KeyNotFoundErrorMeta;
+export type KeyNotFoundErrorArgs = ErrorOptions & KeyNotFoundErrorMeta;
 
 /**
  * 読み取りまたは削除を実行しようとしたキーがストレージ内に存在しない場合に投げられるエラーです。
@@ -21,8 +26,15 @@ export class KeyNotFoundError extends ErrorBase<KeyNotFoundErrorMeta> {
     this.prototype.name = "MemoryKeyNotFoundError";
   }
 
-  public constructor(args: KeyNotFoundErrorArgs, options?: ErrorOptions) {
-    super(args, ({ key }) => `Key not found: ${key}`, options);
+  /**
+   * KeyNotFoundError インスタンスを初期化します。
+   *
+   * @param args エラーメタデータとエラーの追加情報です。
+   */
+  public constructor(args: KeyNotFoundErrorArgs) {
+    const { key, ...options } = args;
+    const meta: KeyNotFoundErrorMeta = { key };
+    super(meta, ({ key }) => `Key not found: ${key}`, options);
   }
 }
 
@@ -32,8 +44,19 @@ setErrorMessage(KeyNotFoundError, ({ key }) => `キー ${key} が見つかりま
  * ストリーム書き込み時に無効なチャンク型が渡されたことを示すエラーメタデータ型です。
  */
 export type InvalidChunkTypeErrorMeta = {
+  /**
+   * 書き込み先または読み取り元のキーです。
+   */
   readonly key: string;
+
+  /**
+   * 型が無効だったチャンクの値です。
+   */
   readonly chunk: unknown;
+
+  /**
+   * 実際に渡されたチャンク値の型名です。
+   */
   readonly chunkType: string;
 };
 
@@ -41,8 +64,9 @@ export type InvalidChunkTypeErrorMeta = {
  * {@link InvalidChunkTypeError} のコンストラクター引数型です。
  *
  * `chunkType` はコンストラクター内部で自動的に設定されるため、引数からは除外されています。
+ * また、エラーの追加情報 (`cause`) も含みます。
  */
-export type InvalidChunkTypeErrorArgs = Omit<InvalidChunkTypeErrorMeta, "chunkType">;
+export type InvalidChunkTypeErrorArgs = ErrorOptions & Omit<InvalidChunkTypeErrorMeta, "chunkType">;
 
 /**
  * `getWritable` が返すストリームに `Uint8Array<ArrayBuffer>` 以外の値が書き込まれた場合に投げられるエラーです。
@@ -52,12 +76,16 @@ export class InvalidChunkTypeError extends ErrorBase<InvalidChunkTypeErrorMeta>
     this.prototype.name = "MemoryInvalidChunkTypeError";
   }
 
-  public constructor(args: InvalidChunkTypeErrorArgs, options?: ErrorOptions) {
+  /**
+   * InvalidChunkTypeError インスタンスを初期化します。
+   *
+   * @param args エラーメタデータとエラーの追加情報です。
+   */
+  public constructor(args: InvalidChunkTypeErrorArgs) {
+    const { key, chunk, ...options } = args;
+    const meta: InvalidChunkTypeErrorMeta = { key, chunk, chunkType: getTypeName(chunk) };
     super(
-      {
-        ...args,
-        chunkType: getTypeName(args.chunk),
-      },
+      meta,
       ({ key, chunkType }) =>
         `Expected chunk for key ${JSON.stringify(key)} is Uint8Array<ArrayBuffer>, but got ${chunkType}`,
       options,

package/src/memory.ts

@@ -14,7 +14,9 @@ export default class Memory implements IStorage {
    */
   private readonly map: Map<string, any>;
 
-  /** ストレージの名前です。デバッグやエラーメッセージなどに使用されます。 */
+  /**
+   * ストレージの名前です。デバッグやエラーメッセージなどに使用されます。
+   */
   public readonly name: string;
 
   /**
@@ -27,15 +29,31 @@ export default class Memory implements IStorage {
     this.map = new Map();
   }
 
+  /**
+   * メモリーストレージは常に利用可能なため、常に `true` を返します。
+   */
   public get isOpen(): boolean {
     return true;
   }
 
+  /**
+   * 指定されたデータを、対応するキーでストレージに保存します。
+   *
+   * @param args.key 保存先のキーです。
+   * @param args.data 保存するデータです。
+   */
   public write(args: Pick<IStorage.WriteArgs<any>, "key" | "data">): void {
     const { key, data } = args;
     this.map.set(key, data);
   }
 
+  /**
+   * 指定されたキーに対応するデータをストレージから取得します。
+   *
+   * @param args.key 取得元のキーです。
+   * @returns キーに対応するデータです。
+   * @throws キーがストレージ内に存在しない場合に {@link KeyNotFoundError} を投げます。
+   */
   public read(args: Pick<IStorage.ReadArgs, "key">): any {
     const { key } = args;
     if (!this.map.has(key)) {
@@ -47,6 +65,12 @@ export default class Memory implements IStorage {
     return value;
   }
 
+  /**
+   * 指定されたキーに対応するデータがストレージ内に存在するかを確認します。
+   *
+   * @param args.key 確認するキーです。
+   * @returns キーに対応するデータが存在する場合は true、それ以外は false です。
+   */
   public exists(args: Pick<IStorage.ExistsArgs, "key">): boolean {
     const { key } = args;
     const exists = this.map.has(key);
@@ -54,6 +78,12 @@ export default class Memory implements IStorage {
     return exists;
   }
 
+  /**
+   * 指定されたキーに対応するデータをストレージから削除します。
+   *
+   * @param args.key 削除するキーです。
+   * @throws キーがストレージ内に存在しない場合に {@link KeyNotFoundError} を投げます。
+   */
   public delete(args: Pick<IStorage.DeleteArgs, "key">): void {
     const { key } = args;
     if (!this.map.has(key)) {
@@ -63,10 +93,21 @@ export default class Memory implements IStorage {
     this.map.delete(key);
   }
 
+  /**
+   * ストレージ内のすべてのデータを完全に消去します。
+   */
   public clear(): void {
     this.map.clear();
   }
 
+  /**
+   * 指定されたキーに対応する書き込み可能なストリームを取得します。
+   *
+   * メモリーストレージにはネイティブなストリームがないため、書き込まれたチャンクをメモリー上に保持し、ストリームがクローズされたときに結合して保存します。
+   *
+   * @param args.key 書き込み先のキーです。
+   * @returns 書き込み可能なストリームです。
+   */
   public getWritable(
     args: Pick<IStorage.GetWritableArgs, "key">,
   ): WritableStream<Uint8Array<ArrayBuffer>> {
@@ -98,6 +139,15 @@ export default class Memory implements IStorage {
     return stream;
   }
 
+  /**
+   * 指定されたキーに対応する読み取り可能なストリームを取得します。
+   *
+   * メモリーストレージにはネイティブなストリームがないため、既存の値を単一チャンクとしてストリームで送出します。
+   *
+   * @param args.key 読み取り元のキーです。
+   * @returns 読み取り可能なストリームです。
+   * @throws キーがストレージ内に存在しない場合に {@link KeyNotFoundError} を投げます。
+   */
   public getReadable(
     args: Pick<IStorage.GetReadableArgs, "key">,
   ): ReadableStream<Uint8Array<ArrayBuffer>> {