@unikvs/indexeddb 0.0.12 → 0.0.14

package/README.md

@@ -1,3 +1,3 @@
 # @unikvs/indexeddb
 
-[Documentation](https://tai-kun.github.io/unikvs/packages/indexeddb)
+[Document](https://tai-kun.github.io/unikvs/)

package/dist/index.d.ts

@@ -0,0 +1,102 @@
+import { IStorage } from "@unikvs/core";
+//#region ../src/indexeddb.d.ts
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#usage)
+ */
+type IndexeddbOptions = {};
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#usage)
+ */
+declare class Indexeddb implements IStorage {
+  #private;
+  /**
+   * ストレージ名です。常に `Indexeddb` を返します。
+   */
+  readonly name: string;
+  /**
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#usage)
+   */
+  constructor(dbName?: string, storeName?: string, _options?: IndexeddbOptions);
+  /**
+   * ストレージが開いているかどうかを返します。
+   *
+   * @returns データベース接続があれば true を返します。
+   */
+  get isOpen(): boolean;
+  /**
+   * データベースを開きます。並行した呼び出しは一つの接続処理に束ねます。
+   *
+   * @param c 中断を知らせるシグナルを持つコンテキストです。
+   *
+   * @returns 完了を知らせるプロミスです。
+   */
+  open(c: IStorage.OpenContext): Promise<void>;
+  /**
+   * データベース接続を閉じます。
+   *
+   * @param c 中断を知らせるシグナルを持つコンテキストです。
+   *
+   * @returns 完了を知らせるプロミスです。
+   */
+  close(c: IStorage.CloseContext): Promise<void>;
+  /**
+   * 指定したキーに値を保存します。Blob は中間形式に変換して保存します。
+   *
+   * @param c 書き込み対象のキーを持つコンテキストです。
+   * @param data 保存する値です。
+   *
+   * @returns 完了を知らせるプロミスです。
+   */
+  write(c: IStorage.WriteContext, data: any): Promise<void>;
+  /**
+   * 指定したキーの値を読み出します。中間形式は Blob または File に戻します。
+   *
+   * @param c 読み出すキーを持つコンテキストです。
+   *
+   * @returns 保存されている値です。
+   */
+  read(c: IStorage.ReadContext): Promise<any>;
+  /**
+   * 指定したキーが存在するかどうかを返します。
+   *
+   * @param c 確認するキーを持つコンテキストです。
+   *
+   * @returns キーが存在すれば true を返します。
+   */
+  exists(c: IStorage.ExistsContext): Promise<boolean>;
+  /**
+   * 指定したキーを削除します。
+   *
+   * @param c 削除するキーを持つコンテキストです。
+   *
+   * @returns 完了を知らせるプロミスです。
+   */
+  delete(c: IStorage.DeleteContext): Promise<void>;
+  /**
+   * オブジェクトストアのすべての値を削除します。
+   *
+   * @param c 中断を知らせるシグナルを持つコンテキストです。
+   *
+   * @returns 完了を知らせるプロミスです。
+   */
+  clear(c: IStorage.ClearContext): Promise<void>;
+  /**
+   * Uint8Array を書き込むためのストリームを作成します。close 時にまとめて保存します。
+   *
+   * @param c 書き込み対象のキーを持つコンテキストです。
+   *
+   * @returns Uint8Array を受け付ける書き込みストリームです。
+   */
+  getWritable(c: IStorage.GetWritableContext): WritableStream<Uint8Array>;
+  /**
+   * 保存済みの値を読み出すストリームを作成します。
+   *
+   * @param c 読み出すキーを持つコンテキストです。
+   *
+   * @returns Uint8Array を送出する読み取りストリームです。
+   */
+  getReadable(c: IStorage.GetReadableContext): ReadableStream<Uint8Array>;
+}
+//#endregion
+export { Indexeddb, type IndexeddbOptions };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/indexeddb.ts"],"mappings":";;;;;KAMY;;;;cAkGS,qBAAqB;;;;;WAIxB;;;;EA2BhB,YACE,iBACA,oBACA,WAAU;;;;;;MAcD;;;;;;;;EAWX,KAAkB,GAAG,SAAS,cAAc;;;;;;;;EAqD5C,MAAmB,GAAG,SAAS,eAAe;;;;;;;;;EAsB9C,MAAmB,GAAG,SAAS,cAAc,YAAY;;;;;;;;EA0BzD,KAAkB,GAAG,SAAS,cAAc;;;;;;;;EAoC5C,OAAoB,GAAG,SAAS,gBAAgB;;;;;;;;EAoBhD,OAAoB,GAAG,SAAS,gBAAgB;;;;;;;;EAgBhD,MAAmB,GAAG,SAAS,eAAe;;;;;;;;EAgB9C,YAAmB,GAAG,SAAS,qBAAqB,eAAe;;;;;;;;EAyCnE,YAAmB,GAAG,SAAS,qBAAqB,eAAe"}

package/dist/index.js

@@ -0,0 +1,304 @@
+import { openDB } from "idb";
+//#region \0@oxc-project+runtime@0.154.0/helpers/esm/checkPrivateRedeclaration.js
+function _checkPrivateRedeclaration(e, t) {
+	if (t.has(e)) throw new TypeError("Cannot initialize the same private elements twice on an object");
+}
+//#endregion
+//#region \0@oxc-project+runtime@0.154.0/helpers/esm/classPrivateMethodInitSpec.js
+function _classPrivateMethodInitSpec(e, a) {
+	_checkPrivateRedeclaration(e, a), a.add(e);
+}
+//#endregion
+//#region \0@oxc-project+runtime@0.154.0/helpers/esm/classPrivateFieldInitSpec.js
+function _classPrivateFieldInitSpec(e, t, a) {
+	_checkPrivateRedeclaration(e, t), t.set(e, a);
+}
+//#endregion
+//#region \0@oxc-project+runtime@0.154.0/helpers/esm/assertClassBrand.js
+function _assertClassBrand(e, t, n) {
+	if ("function" == typeof e ? e === t : e.has(t)) return arguments.length < 3 ? t : n;
+	throw new TypeError("Private element is not present on this object");
+}
+//#endregion
+//#region \0@oxc-project+runtime@0.154.0/helpers/esm/classPrivateFieldSet2.js
+function _classPrivateFieldSet2(s, a, r) {
+	return s.set(_assertClassBrand(s, a), r), r;
+}
+//#endregion
+//#region \0@oxc-project+runtime@0.154.0/helpers/esm/classPrivateFieldGet2.js
+function _classPrivateFieldGet2(s, a) {
+	return s.get(_assertClassBrand(s, a));
+}
+//#endregion
+//#region ../src/indexeddb.ts
+/**
+* 保存した中間形式かどうかを判定します。
+*
+* @param value 判定する値です。
+*
+* @returns 中間形式であれば true を返します。
+*/
+function isStoredBlob(value) {
+	if (typeof value !== "object" || value === null) return false;
+	return value["unikvsBlob"] === true;
+}
+/**
+* Blob を IndexedDB に保存できる中間形式に変換します。File の名前と更新時刻も保持します。
+*
+* @param signal 中断を知らせるシグナルです。
+* @param data 変換する Blob です。
+*
+* @returns 中間形式に変換した値です。
+*/
+async function toStoredBlob(signal, data) {
+	const buffer = await data.arrayBuffer();
+	signal.throwIfAborted();
+	const isFile = typeof File !== "undefined" && data instanceof File;
+	return {
+		name: isFile ? data.name : "",
+		type: data.type,
+		buffer,
+		unikvsBlob: true,
+		unikvsFile: isFile,
+		lastModified: isFile ? data.lastModified : 0
+	};
+}
+/**
+* 中間形式を Blob または File に戻します。
+*
+* @param stored 中間形式の値です。
+*
+* @returns 復元した Blob または File です。
+*/
+function fromStoredBlob(stored) {
+	if (stored.unikvsFile) return new File([stored.buffer], stored.name, {
+		type: stored.type,
+		lastModified: stored.lastModified
+	});
+	return new Blob([stored.buffer], { type: stored.type });
+}
+var _db = /* @__PURE__ */ new WeakMap();
+var _opening = /* @__PURE__ */ new WeakMap();
+var _dbName = /* @__PURE__ */ new WeakMap();
+var _storeName = /* @__PURE__ */ new WeakMap();
+var _Indexeddb_brand = /* @__PURE__ */ new WeakSet();
+/**
+* [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#usage)
+*/
+var Indexeddb = class {
+	/**
+	* [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#usage)
+	*/
+	constructor(dbName = "unikvs_db", storeName = "kvs_store", _options = {}) {
+		_classPrivateMethodInitSpec(this, _Indexeddb_brand);
+		_classPrivateFieldInitSpec(this, _db, void 0);
+		_classPrivateFieldInitSpec(this, _opening, void 0);
+		_classPrivateFieldInitSpec(this, _dbName, void 0);
+		_classPrivateFieldInitSpec(this, _storeName, void 0);
+		this.name = "Indexeddb";
+		_classPrivateFieldSet2(_db, this, null);
+		_classPrivateFieldSet2(_opening, this, null);
+		_classPrivateFieldSet2(_dbName, this, dbName);
+		_classPrivateFieldSet2(_storeName, this, storeName);
+	}
+	/**
+	* ストレージが開いているかどうかを返します。
+	*
+	* @returns データベース接続があれば true を返します。
+	*/
+	get isOpen() {
+		return _classPrivateFieldGet2(_db, this) !== null;
+	}
+	/**
+	* データベースを開きます。並行した呼び出しは一つの接続処理に束ねます。
+	*
+	* @param c 中断を知らせるシグナルを持つコンテキストです。
+	*
+	* @returns 完了を知らせるプロミスです。
+	*/
+	async open(c) {
+		c.signal.throwIfAborted();
+		if (_classPrivateFieldGet2(_db, this) !== null) return;
+		if (_classPrivateFieldGet2(_opening, this) !== null) {
+			await _classPrivateFieldGet2(_opening, this);
+			c.signal.throwIfAborted();
+			return;
+		}
+		const opening = openDB(_classPrivateFieldGet2(_dbName, this), 1, { upgrade: (upgraded) => {
+			if (!upgraded.objectStoreNames.contains(_classPrivateFieldGet2(_storeName, this))) upgraded.createObjectStore(_classPrivateFieldGet2(_storeName, this));
+		} });
+		_classPrivateFieldSet2(_opening, this, opening);
+		let opened = null;
+		try {
+			opened = await opening;
+			c.signal.throwIfAborted();
+			_classPrivateFieldSet2(_db, this, opened);
+			opened = null;
+		} catch (ex) {
+			if (opened !== null) try {
+				opened.close();
+			} catch {}
+			throw ex;
+		} finally {
+			_classPrivateFieldSet2(_opening, this, null);
+		}
+	}
+	/**
+	* データベース接続を閉じます。
+	*
+	* @param c 中断を知らせるシグナルを持つコンテキストです。
+	*
+	* @returns 完了を知らせるプロミスです。
+	*/
+	async close(c) {
+		c.signal.throwIfAborted();
+		const db = _classPrivateFieldGet2(_db, this);
+		if (db === null) throw new TypeError("Indexeddb is not open. Call open() first.");
+		await Promise.resolve();
+		db.close();
+		_classPrivateFieldSet2(_db, this, null);
+	}
+	/**
+	* 指定したキーに値を保存します。Blob は中間形式に変換して保存します。
+	*
+	* @param c 書き込み対象のキーを持つコンテキストです。
+	* @param data 保存する値です。
+	*
+	* @returns 完了を知らせるプロミスです。
+	*/
+	async write(c, data) {
+		c.signal.throwIfAborted();
+		const db = _assertClassBrand(_Indexeddb_brand, this, _getDb).call(this);
+		if (typeof Blob !== "undefined" && data instanceof Blob) {
+			const stored = await toStoredBlob(c.signal, data);
+			await db.put(_classPrivateFieldGet2(_storeName, this), stored, c.key);
+			c.signal.throwIfAborted();
+			return;
+		}
+		await db.put(_classPrivateFieldGet2(_storeName, this), data, c.key);
+		c.signal.throwIfAborted();
+	}
+	/**
+	* 指定したキーの値を読み出します。中間形式は Blob または File に戻します。
+	*
+	* @param c 読み出すキーを持つコンテキストです。
+	*
+	* @returns 保存されている値です。
+	*/
+	async read(c) {
+		c.signal.throwIfAborted();
+		const db = _assertClassBrand(_Indexeddb_brand, this, _getDb).call(this);
+		const value = await db.get(_classPrivateFieldGet2(_storeName, this), c.key);
+		c.signal.throwIfAborted();
+		if (isStoredBlob(value)) return fromStoredBlob(value);
+		if (value === void 0) {
+			const count = await db.count(_classPrivateFieldGet2(_storeName, this), c.key);
+			c.signal.throwIfAborted();
+			if (count === 0) throw new DOMException("A requested file or directory could not be found at the time an operation was processed.", "NotFoundError");
+		}
+		return value;
+	}
+	/**
+	* 指定したキーが存在するかどうかを返します。
+	*
+	* @param c 確認するキーを持つコンテキストです。
+	*
+	* @returns キーが存在すれば true を返します。
+	*/
+	async exists(c) {
+		c.signal.throwIfAborted();
+		const count = await _assertClassBrand(_Indexeddb_brand, this, _getDb).call(this).count(_classPrivateFieldGet2(_storeName, this), c.key);
+		c.signal.throwIfAborted();
+		return count > 0;
+	}
+	/**
+	* 指定したキーを削除します。
+	*
+	* @param c 削除するキーを持つコンテキストです。
+	*
+	* @returns 完了を知らせるプロミスです。
+	*/
+	async delete(c) {
+		c.signal.throwIfAborted();
+		await _assertClassBrand(_Indexeddb_brand, this, _getDb).call(this).delete(_classPrivateFieldGet2(_storeName, this), c.key);
+		c.signal.throwIfAborted();
+	}
+	/**
+	* オブジェクトストアのすべての値を削除します。
+	*
+	* @param c 中断を知らせるシグナルを持つコンテキストです。
+	*
+	* @returns 完了を知らせるプロミスです。
+	*/
+	async clear(c) {
+		c.signal.throwIfAborted();
+		await _assertClassBrand(_Indexeddb_brand, this, _getDb).call(this).clear(_classPrivateFieldGet2(_storeName, this));
+		c.signal.throwIfAborted();
+	}
+	/**
+	* Uint8Array を書き込むためのストリームを作成します。close 時にまとめて保存します。
+	*
+	* @param c 書き込み対象のキーを持つコンテキストです。
+	*
+	* @returns Uint8Array を受け付ける書き込みストリームです。
+	*/
+	getWritable(c) {
+		c.signal.throwIfAborted();
+		const chunks = [];
+		return new WritableStream({
+			abort: () => {
+				chunks.length = 0;
+			},
+			close: async () => {
+				c.signal.throwIfAborted();
+				const totalLength = chunks.reduce((sum, chunk) => sum + chunk.length, 0);
+				const merged = new Uint8Array(totalLength);
+				let offset = 0;
+				for (const chunk of chunks) {
+					merged.set(chunk, offset);
+					offset += chunk.length;
+				}
+				await _assertClassBrand(_Indexeddb_brand, this, _getDb).call(this).put(_classPrivateFieldGet2(_storeName, this), merged, c.key);
+				c.signal.throwIfAborted();
+			},
+			write: (chunk) => {
+				c.signal.throwIfAborted();
+				chunks.push(chunk);
+			}
+		});
+	}
+	/**
+	* 保存済みの値を読み出すストリームを作成します。
+	*
+	* @param c 読み出すキーを持つコンテキストです。
+	*
+	* @returns Uint8Array を送出する読み取りストリームです。
+	*/
+	getReadable(c) {
+		c.signal.throwIfAborted();
+		return new ReadableStream({ pull: async (controller) => {
+			try {
+				const data = await this.read(c);
+				c.signal.throwIfAborted();
+				controller.enqueue(data);
+				controller.close();
+			} catch (ex) {
+				controller.error(ex);
+			}
+		} });
+	}
+};
+/**
+* 開いているデータベースを返します。未オープン時はエラーを投げます。
+*
+* @returns 開いているデータベースです。
+*/
+function _getDb() {
+	const db = _classPrivateFieldGet2(_db, this);
+	if (db === null) throw new TypeError("Indexeddb is not open. Call open() first.");
+	return db;
+}
+//#endregion
+export { Indexeddb };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/indexeddb.ts"],"sourcesContent":["import type { IStorage } from \"@unikvs/core\";\nimport { type IDBPDatabase, openDB } from \"idb\";\n\n/**\n * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#usage)\n */\nexport type IndexeddbOptions = {};\n\n/**\n * WebKit で Blob を直接保存できない場合があるため、中間形式で保持します。\n */\ntype StoredBlob = {\n  /**\n   * File のときに保持するファイル名です。\n   */\n  readonly name: string;\n\n  /**\n   * 元の Blob の MIME 種別です。\n   */\n  readonly type: string;\n\n  /**\n   * Blob のバイト列です。\n   */\n  readonly buffer: ArrayBuffer;\n\n  /**\n   * 中間形式であることを示す目印です。\n   */\n  readonly unikvsBlob: true;\n\n  /**\n   * File 由来かどうかを示す目印です。\n   */\n  readonly unikvsFile: boolean;\n\n  /**\n   * File のときに保持する更新時刻です。\n   */\n  readonly lastModified: number;\n};\n\n/**\n * 保存した中間形式かどうかを判定します。\n *\n * @param value 判定する値です。\n *\n * @returns 中間形式であれば true を返します。\n */\nfunction isStoredBlob(value: unknown): value is StoredBlob {\n  if (typeof value !== \"object\" || value === null) {\n    return false;\n  }\n\n  return (value as Record<string, unknown>)[\"unikvsBlob\"] === true;\n}\n\n/**\n * Blob を IndexedDB に保存できる中間形式に変換します。File の名前と更新時刻も保持します。\n *\n * @param signal 中断を知らせるシグナルです。\n * @param data 変換する Blob です。\n *\n * @returns 中間形式に変換した値です。\n */\nasync function toStoredBlob(signal: AbortSignal, data: Blob): Promise<StoredBlob> {\n  const buffer = await data.arrayBuffer();\n\n  signal.throwIfAborted();\n\n  const isFile = typeof File !== \"undefined\" && data instanceof File;\n\n  return {\n    name: isFile ? data.name : \"\",\n    type: data.type,\n    buffer,\n    unikvsBlob: true,\n    unikvsFile: isFile,\n    lastModified: isFile ? data.lastModified : 0,\n  };\n}\n\n/**\n * 中間形式を Blob または File に戻します。\n *\n * @param stored 中間形式の値です。\n *\n * @returns 復元した Blob または File です。\n */\nfunction fromStoredBlob(stored: StoredBlob): Blob {\n  if (stored.unikvsFile) {\n    return new File([stored.buffer], stored.name, {\n      type: stored.type,\n      lastModified: stored.lastModified,\n    });\n  }\n\n  return new Blob([stored.buffer], { type: stored.type });\n}\n\n/**\n * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#usage)\n */\nexport default class Indexeddb implements IStorage {\n  /**\n   * ストレージ名です。常に `Indexeddb` を返します。\n   */\n  public readonly name: string;\n\n  /**\n   * IndexedDB のデータベースインスタンスを保持します。\n   *\n   * ストレージがオープンされるまで null です。\n   */\n  #db: IDBPDatabase | null;\n\n  /**\n   * 並行 open を束ねるための進行中 Promise です。\n   */\n  #opening: Promise<IDBPDatabase> | null;\n\n  /**\n   * 使用するデータベース名です。\n   */\n  readonly #dbName: string;\n\n  /**\n   * 使用するオブジェクトストア名です。\n   */\n  readonly #storeName: string;\n\n  /**\n   * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#usage)\n   */\n  public constructor(\n    dbName = \"unikvs_db\",\n    storeName = \"kvs_store\",\n    _options: IndexeddbOptions = {},\n  ) {\n    this.name = \"Indexeddb\";\n    this.#db = null;\n    this.#opening = null;\n    this.#dbName = dbName;\n    this.#storeName = storeName;\n  }\n\n  /**\n   * ストレージが開いているかどうかを返します。\n   *\n   * @returns データベース接続があれば true を返します。\n   */\n  public get isOpen(): boolean {\n    return this.#db !== null;\n  }\n\n  /**\n   * データベースを開きます。並行した呼び出しは一つの接続処理に束ねます。\n   *\n   * @param c 中断を知らせるシグナルを持つコンテキストです。\n   *\n   * @returns 完了を知らせるプロミスです。\n   */\n  public async open(c: IStorage.OpenContext): Promise<void> {\n    c.signal.throwIfAborted();\n\n    if (this.#db !== null) {\n      return;\n    }\n\n    if (this.#opening !== null) {\n      await this.#opening;\n      c.signal.throwIfAborted();\n\n      return;\n    }\n\n    const opening = openDB(this.#dbName, 1, {\n      upgrade: (upgraded) => {\n        // オブジェクトストアが存在しない場合は作成します。\n        if (!upgraded.objectStoreNames.contains(this.#storeName)) {\n          upgraded.createObjectStore(this.#storeName);\n        }\n      },\n    });\n    this.#opening = opening;\n\n    let opened: IDBPDatabase | null = null;\n\n    try {\n      opened = await opening;\n      c.signal.throwIfAborted();\n      this.#db = opened;\n      opened = null;\n    } catch (ex) {\n      if (opened !== null) {\n        try {\n          opened.close();\n        } catch {\n          // 閉鎖時の失敗は無視します。\n        }\n      }\n\n      throw ex;\n    } finally {\n      this.#opening = null;\n    }\n  }\n\n  /**\n   * データベース接続を閉じます。\n   *\n   * @param c 中断を知らせるシグナルを持つコンテキストです。\n   *\n   * @returns 完了を知らせるプロミスです。\n   */\n  public async close(c: IStorage.CloseContext): Promise<void> {\n    c.signal.throwIfAborted();\n\n    const db = this.#db;\n\n    if (db === null) {\n      throw new TypeError(\"Indexeddb is not open. Call open() first.\");\n    }\n\n    await Promise.resolve();\n    db.close();\n    this.#db = null;\n  }\n\n  /**\n   * 指定したキーに値を保存します。Blob は中間形式に変換して保存します。\n   *\n   * @param c 書き込み対象のキーを持つコンテキストです。\n   * @param data 保存する値です。\n   *\n   * @returns 完了を知らせるプロミスです。\n   */\n  public async write(c: IStorage.WriteContext, data: any): Promise<void> {\n    c.signal.throwIfAborted();\n\n    const db = this.#getDb();\n\n    if (typeof Blob !== \"undefined\" && data instanceof Blob) {\n      const stored = await toStoredBlob(c.signal, data);\n      await db.put(this.#storeName, stored, c.key);\n\n      c.signal.throwIfAborted();\n\n      return;\n    }\n\n    await db.put(this.#storeName, data, c.key);\n\n    c.signal.throwIfAborted();\n  }\n\n  /**\n   * 指定したキーの値を読み出します。中間形式は Blob または File に戻します。\n   *\n   * @param c 読み出すキーを持つコンテキストです。\n   *\n   * @returns 保存されている値です。\n   */\n  public async read(c: IStorage.ReadContext): Promise<any> {\n    c.signal.throwIfAborted();\n\n    const db = this.#getDb();\n    const value = await db.get(this.#storeName, c.key);\n\n    c.signal.throwIfAborted();\n\n    if (isStoredBlob(value)) {\n      return fromStoredBlob(value);\n    }\n\n    if (value === undefined) {\n      const count = await db.count(this.#storeName, c.key);\n\n      c.signal.throwIfAborted();\n\n      // 存在しない場合は DOMException (NotFoundError) を投げます。\n      if (count === 0) {\n        throw new DOMException(\n          \"A requested file or directory could not be found at the time an operation was processed.\",\n          \"NotFoundError\",\n        );\n      }\n    }\n\n    return value;\n  }\n\n  /**\n   * 指定したキーが存在するかどうかを返します。\n   *\n   * @param c 確認するキーを持つコンテキストです。\n   *\n   * @returns キーが存在すれば true を返します。\n   */\n  public async exists(c: IStorage.ExistsContext): Promise<boolean> {\n    c.signal.throwIfAborted();\n\n    const db = this.#getDb();\n\n    // 件数が 1 であれば存在し、0 であれば存在しません。\n    const count = await db.count(this.#storeName, c.key);\n\n    c.signal.throwIfAborted();\n\n    return count > 0;\n  }\n\n  /**\n   * 指定したキーを削除します。\n   *\n   * @param c 削除するキーを持つコンテキストです。\n   *\n   * @returns 完了を知らせるプロミスです。\n   */\n  public async delete(c: IStorage.DeleteContext): Promise<void> {\n    c.signal.throwIfAborted();\n\n    const db = this.#getDb();\n    await db.delete(this.#storeName, c.key);\n\n    c.signal.throwIfAborted();\n  }\n\n  /**\n   * オブジェクトストアのすべての値を削除します。\n   *\n   * @param c 中断を知らせるシグナルを持つコンテキストです。\n   *\n   * @returns 完了を知らせるプロミスです。\n   */\n  public async clear(c: IStorage.ClearContext): Promise<void> {\n    c.signal.throwIfAborted();\n\n    const db = this.#getDb();\n    await db.clear(this.#storeName);\n\n    c.signal.throwIfAborted();\n  }\n\n  /**\n   * Uint8Array を書き込むためのストリームを作成します。close 時にまとめて保存します。\n   *\n   * @param c 書き込み対象のキーを持つコンテキストです。\n   *\n   * @returns Uint8Array を受け付ける書き込みストリームです。\n   */\n  public getWritable(c: IStorage.GetWritableContext): WritableStream<Uint8Array> {\n    c.signal.throwIfAborted();\n\n    const chunks: Uint8Array[] = [];\n\n    return new WritableStream<Uint8Array>({\n      abort: (): void => {\n        chunks.length = 0;\n      },\n      close: async (): Promise<void> => {\n        // 保存は close のときだけ行うため、中断時はここまでのチャンクを破棄できます。\n        c.signal.throwIfAborted();\n\n        const totalLength = chunks.reduce((sum, chunk) => sum + chunk.length, 0);\n        const merged = new Uint8Array(totalLength);\n        let offset = 0;\n\n        for (const chunk of chunks) {\n          merged.set(chunk, offset);\n          offset += chunk.length;\n        }\n\n        const db = this.#getDb();\n        await db.put(this.#storeName, merged, c.key);\n\n        c.signal.throwIfAborted();\n      },\n      write: (chunk): void => {\n        c.signal.throwIfAborted();\n        chunks.push(chunk);\n      },\n    });\n  }\n\n  /**\n   * 保存済みの値を読み出すストリームを作成します。\n   *\n   * @param c 読み出すキーを持つコンテキストです。\n   *\n   * @returns Uint8Array を送出する読み取りストリームです。\n   */\n  public getReadable(c: IStorage.GetReadableContext): ReadableStream<Uint8Array> {\n    c.signal.throwIfAborted();\n\n    return new ReadableStream<Uint8Array>({\n      pull: async (controller: ReadableStreamDefaultController<Uint8Array>): Promise<void> => {\n        try {\n          const data = await this.read(c as unknown as IStorage.ReadContext);\n\n          c.signal.throwIfAborted();\n          controller.enqueue(data as Uint8Array);\n          controller.close();\n        } catch (ex) {\n          controller.error(ex);\n        }\n      },\n    });\n  }\n\n  /**\n   * 開いているデータベースを返します。未オープン時はエラーを投げます。\n   *\n   * @returns 開いているデータベースです。\n   */\n  #getDb(): IDBPDatabase {\n    const db = this.#db;\n\n    if (db === null) {\n      throw new TypeError(\"Indexeddb is not open. Call open() first.\");\n    }\n\n    return db;\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -1,49 +1,44 @@
 {
   "name": "@unikvs/indexeddb",
-  "version": "0.0.12",
+  "version": "0.0.14",
   "description": "Storage plugin that stores arbitrary data in the browser IndexedDB.",
-  "homepage": "https://github.com/tai-kun/unikvs",
+  "homepage": "https://tai-kun.github.io/unikvs/",
   "license": "MIT",
-  "author": "tai-kun",
   "repository": {
-    "url": "https://github.com/tai-kun/unikvs"
+    "url": "https://github.com/tai-kun/unikvs",
+    "directory": "packages/indexeddb"
   },
   "files": [
     "dist",
     "src",
     "package.json",
-    "README.md",
-    "LICENSE"
+    "LICENSE",
+    "README.md"
   ],
   "type": "module",
   "sideEffects": false,
-  "main": "./dist/src/index.js",
-  "types": "./dist/src/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/src/index.d.ts",
-      "default": "./dist/src/index.js"
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
     }
   },
   "dependencies": {
-    "@unikvs/core": "0.0.12",
-    "idb": "8.0.3"
+    "@unikvs/core": "0.0.14",
+    "idb": "^8.0.4"
   },
   "devDependencies": {
-    "@tsconfig/node24": "24.0.5",
-    "@tsconfig/strictest": "2.0.8",
-    "@types/node": "24.13.6",
-    "@vitest/browser": "4.1.11",
-    "@vitest/browser-playwright": "4.1.11",
-    "npm-check-updates": "20.0.2",
-    "playwright": "1.63.0",
-    "vite": "8.3.0",
-    "vitest": "4.1.11"
+    "@unikvs/testing": "0.0.0",
+    "@vitest/browser-playwright": "5.0.5",
+    "@vitest/coverage-istanbul": "5.0.5",
+    "playwright": "1.64.1",
+    "vite-plus": "1.3.0"
   },
   "peerDependencies": {
-    "@logtape/logtape": "2.0.0"
+    "@logtape/logtape": "^2.0.0"
   },
+  "readme": "README.md",
   "scripts": {
-    "build": "tsc --project ./.config/tsconfig.build.json"
+    "build": "vp -C .config pack"
   }
 }

package/src/index.ts

@@ -0,0 +1,2 @@
+export type * from "./indexeddb.js";
+export { default as Indexeddb } from "./indexeddb.js";

package/src/indexeddb.ts

@@ -1,164 +1,426 @@
 import type { IStorage } from "@unikvs/core";
-import { openDB, type IDBPDatabase } from "idb";
+import { type IDBPDatabase, openDB } from "idb";
+
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#usage)
+ */
+export type IndexeddbOptions = {};
+
+/**
+ * WebKit で Blob を直接保存できない場合があるため、中間形式で保持します。
+ */
+type StoredBlob = {
+  /**
+   * File のときに保持するファイル名です。
+   */
+  readonly name: string;
+
+  /**
+   * 元の Blob の MIME 種別です。
+   */
+  readonly type: string;
+
+  /**
+   * Blob のバイト列です。
+   */
+  readonly buffer: ArrayBuffer;
+
+  /**
+   * 中間形式であることを示す目印です。
+   */
+  readonly unikvsBlob: true;
+
+  /**
+   * File 由来かどうかを示す目印です。
+   */
+  readonly unikvsFile: boolean;
+
+  /**
+   * File のときに保持する更新時刻です。
+   */
+  readonly lastModified: number;
+};
+
+/**
+ * 保存した中間形式かどうかを判定します。
+ *
+ * @param value 判定する値です。
+ *
+ * @returns 中間形式であれば true を返します。
+ */
+function isStoredBlob(value: unknown): value is StoredBlob {
+  if (typeof value !== "object" || value === null) {
+    return false;
+  }
+
+  return (value as Record<string, unknown>)["unikvsBlob"] === true;
+}
+
+/**
+ * Blob を IndexedDB に保存できる中間形式に変換します。File の名前と更新時刻も保持します。
+ *
+ * @param signal 中断を知らせるシグナルです。
+ * @param data 変換する Blob です。
+ *
+ * @returns 中間形式に変換した値です。
+ */
+async function toStoredBlob(signal: AbortSignal, data: Blob): Promise<StoredBlob> {
+  const buffer = await data.arrayBuffer();
+
+  signal.throwIfAborted();
+
+  const isFile = typeof File !== "undefined" && data instanceof File;
+
+  return {
+    name: isFile ? data.name : "",
+    type: data.type,
+    buffer,
+    unikvsBlob: true,
+    unikvsFile: isFile,
+    lastModified: isFile ? data.lastModified : 0,
+  };
+}
+
+/**
+ * 中間形式を Blob または File に戻します。
+ *
+ * @param stored 中間形式の値です。
+ *
+ * @returns 復元した Blob または File です。
+ */
+function fromStoredBlob(stored: StoredBlob): Blob {
+  if (stored.unikvsFile) {
+    return new File([stored.buffer], stored.name, {
+      type: stored.type,
+      lastModified: stored.lastModified,
+    });
+  }
+
+  return new Blob([stored.buffer], { type: stored.type });
+}
 
 /**
  * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#usage)
  */
 export default class Indexeddb implements IStorage {
+  /**
+   * ストレージ名です。常に `Indexeddb` を返します。
+   */
+  public readonly name: string;
+
   /**
    * IndexedDB のデータベースインスタンスを保持します。
    *
    * ストレージがオープンされるまで null です。
    */
-  private db: IDBPDatabase | null;
+  #db: IDBPDatabase | null;
 
   /**
-   * 使用するデータベース名です。
+   * 並行 open を束ねるための進行中 Promise です。
    */
-  private readonly dbName: string;
+  #opening: Promise<IDBPDatabase> | null;
 
   /**
-   * 使用するオブジェクトストア名です。
+   * 使用するデータベース名です。
    */
-  private readonly storeName: string;
+  readonly #dbName: string;
 
   /**
-   * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#usage)
+   * 使用するオブジェクトストア名です。
    */
-  public readonly name: string;
+  readonly #storeName: string;
 
   /**
    * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#usage)
    */
-  public constructor(dbName: string = "unikvs_db", storeName: string = "kvs_store") {
+  public constructor(
+    dbName = "unikvs_db",
+    storeName = "kvs_store",
+    _options: IndexeddbOptions = {},
+  ) {
     this.name = "Indexeddb";
-    this.db = null;
-    this.dbName = dbName;
-    this.storeName = storeName;
+    this.#db = null;
+    this.#opening = null;
+    this.#dbName = dbName;
+    this.#storeName = storeName;
   }
 
   /**
-   * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#usage)
+   * ストレージが開いているかどうかを返します。
+   *
+   * @returns データベース接続があれば true を返します。
    */
   public get isOpen(): boolean {
-    return this.db !== null;
+    return this.#db !== null;
   }
 
   /**
-   * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#usage)
+   * データベースを開きます。並行した呼び出しは一つの接続処理に束ねます。
+   *
+   * @param c 中断を知らせるシグナルを持つコンテキストです。
+   *
+   * @returns 完了を知らせるプロミスです。
    */
-  public async open(): Promise<void> {
-    if (this.db) {
+  public async open(c: IStorage.OpenContext): Promise<void> {
+    c.signal.throwIfAborted();
+
+    if (this.#db !== null) {
+      return;
+    }
+
+    if (this.#opening !== null) {
+      await this.#opening;
+      c.signal.throwIfAborted();
+
       return;
     }
 
-    this.db = await openDB(this.dbName, 1, {
-      upgrade: (db) => {
-        // オブジェクトストアが存在しない場合は作成します
-        if (!db.objectStoreNames.contains(this.storeName)) {
-          db.createObjectStore(this.storeName);
+    const opening = openDB(this.#dbName, 1, {
+      upgrade: (upgraded) => {
+        // オブジェクトストアが存在しない場合は作成します。
+        if (!upgraded.objectStoreNames.contains(this.#storeName)) {
+          upgraded.createObjectStore(this.#storeName);
         }
       },
     });
+    this.#opening = opening;
+
+    let opened: IDBPDatabase | null = null;
+
+    try {
+      opened = await opening;
+      c.signal.throwIfAborted();
+      this.#db = opened;
+      opened = null;
+    } catch (ex) {
+      if (opened !== null) {
+        try {
+          opened.close();
+        } catch {
+          // 閉鎖時の失敗は無視します。
+        }
+      }
+
+      throw ex;
+    } finally {
+      this.#opening = null;
+    }
   }
 
   /**
-   * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#usage)
+   * データベース接続を閉じます。
+   *
+   * @param c 中断を知らせるシグナルを持つコンテキストです。
+   *
+   * @returns 完了を知らせるプロミスです。
    */
-  public async close(): Promise<void> {
-    this.db!.close();
-    this.db = null;
+  public async close(c: IStorage.CloseContext): Promise<void> {
+    c.signal.throwIfAborted();
+
+    const db = this.#db;
+
+    if (db === null) {
+      throw new TypeError("Indexeddb is not open. Call open() first.");
+    }
+
+    await Promise.resolve();
+    db.close();
+    this.#db = null;
   }
 
   /**
-   * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#data)
+   * 指定したキーに値を保存します。Blob は中間形式に変換して保存します。
+   *
+   * @param c 書き込み対象のキーを持つコンテキストです。
+   * @param data 保存する値です。
+   *
+   * @returns 完了を知らせるプロミスです。
    */
-  public async write(args: Pick<IStorage.WriteArgs<any>, "key" | "data">): Promise<void> {
-    const { key, data } = args;
-    await this.db!.put(this.storeName, data, key);
+  public async write(c: IStorage.WriteContext, data: any): Promise<void> {
+    c.signal.throwIfAborted();
+
+    const db = this.#getDb();
+
+    if (typeof Blob !== "undefined" && data instanceof Blob) {
+      const stored = await toStoredBlob(c.signal, data);
+      await db.put(this.#storeName, stored, c.key);
+
+      c.signal.throwIfAborted();
+
+      return;
+    }
+
+    await db.put(this.#storeName, data, c.key);
+
+    c.signal.throwIfAborted();
   }
 
   /**
-   * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#data)
+   * 指定したキーの値を読み出します。中間形式は Blob または File に戻します。
+   *
+   * @param c 読み出すキーを持つコンテキストです。
+   *
+   * @returns 保存されている値です。
    */
-  public async read(args: Pick<IStorage.ReadArgs, "key">): Promise<any> {
-    const { key } = args;
-    // Opfs の挙動に合わせて、存在しない場合は DOMException (NotFoundError) を投げます
-    if (!(await this.exists({ key }))) {
-      throw new DOMException(
-        `A requested file or directory could not be found at the time an operation was processed.`,
-        "NotFoundError",
-      );
+  public async read(c: IStorage.ReadContext): Promise<any> {
+    c.signal.throwIfAborted();
+
+    const db = this.#getDb();
+    const value = await db.get(this.#storeName, c.key);
+
+    c.signal.throwIfAborted();
+
+    if (isStoredBlob(value)) {
+      return fromStoredBlob(value);
+    }
+
+    if (value === undefined) {
+      const count = await db.count(this.#storeName, c.key);
+
+      c.signal.throwIfAborted();
+
+      // 存在しない場合は DOMException (NotFoundError) を投げます。
+      if (count === 0) {
+        throw new DOMException(
+          "A requested file or directory could not be found at the time an operation was processed.",
+          "NotFoundError",
+        );
+      }
     }
 
-    return await this.db!.get(this.storeName, key);
+    return value;
   }
 
   /**
-   * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#usage)
+   * 指定したキーが存在するかどうかを返します。
+   *
+   * @param c 確認するキーを持つコンテキストです。
+   *
+   * @returns キーが存在すれば true を返します。
    */
-  public async exists(args: Pick<IStorage.ExistsArgs, "key">): Promise<boolean> {
-    const { key } = args;
+  public async exists(c: IStorage.ExistsContext): Promise<boolean> {
+    c.signal.throwIfAborted();
+
+    const db = this.#getDb();
+
+    // 件数が 1 であれば存在し、0 であれば存在しません。
+    const count = await db.count(this.#storeName, c.key);
+
+    c.signal.throwIfAborted();
 
-    // count() はキーが存在すれば 1 を、存在しなければ 0 を返します
-    const count = await this.db!.count(this.storeName, key);
     return count > 0;
   }
 
   /**
-   * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#usage)
+   * 指定したキーを削除します。
+   *
+   * @param c 削除するキーを持つコンテキストです。
+   *
+   * @returns 完了を知らせるプロミスです。
    */
-  public async delete(args: Pick<IStorage.DeleteArgs, "key">): Promise<void> {
-    const { key } = args;
+  public async delete(c: IStorage.DeleteContext): Promise<void> {
+    c.signal.throwIfAborted();
 
-    await this.db!.delete(this.storeName, key);
+    const db = this.#getDb();
+    await db.delete(this.#storeName, c.key);
+
+    c.signal.throwIfAborted();
   }
 
   /**
-   * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#usage)
+   * オブジェクトストアのすべての値を削除します。
+   *
+   * @param c 中断を知らせるシグナルを持つコンテキストです。
+   *
+   * @returns 完了を知らせるプロミスです。
    */
-  public async clear(): Promise<void> {
-    await this.db!.clear(this.storeName);
+  public async clear(c: IStorage.ClearContext): Promise<void> {
+    c.signal.throwIfAborted();
+
+    const db = this.#getDb();
+    await db.clear(this.#storeName);
+
+    c.signal.throwIfAborted();
   }
 
   /**
-   * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#data)
+   * Uint8Array を書き込むためのストリームを作成します。close 時にまとめて保存します。
+   *
+   * @param c 書き込み対象のキーを持つコンテキストです。
+   *
+   * @returns Uint8Array を受け付ける書き込みストリームです。
    */
-  public getWritable(args: Pick<IStorage.GetWritableArgs, "key">): WritableStream<Uint8Array> {
-    const { key } = args;
+  public getWritable(c: IStorage.GetWritableContext): WritableStream<Uint8Array> {
+    c.signal.throwIfAborted();
+
     const chunks: Uint8Array[] = [];
 
-    return new WritableStream({
-      write: (chunk) => {
-        chunks.push(chunk);
+    return new WritableStream<Uint8Array>({
+      abort: (): void => {
+        chunks.length = 0;
       },
-      close: async () => {
-        const totalLength = chunks.reduce((acc, chunk) => acc + chunk.length, 0);
-        const result = new Uint8Array(totalLength);
+      close: async (): Promise<void> => {
+        // 保存は close のときだけ行うため、中断時はここまでのチャンクを破棄できます。
+        c.signal.throwIfAborted();
+
+        const totalLength = chunks.reduce((sum, chunk) => sum + chunk.length, 0);
+        const merged = new Uint8Array(totalLength);
         let offset = 0;
 
         for (const chunk of chunks) {
-          result.set(chunk, offset);
+          merged.set(chunk, offset);
           offset += chunk.length;
         }
 
-        await this.db!.put(this.storeName, result, key);
+        const db = this.#getDb();
+        await db.put(this.#storeName, merged, c.key);
+
+        c.signal.throwIfAborted();
+      },
+      write: (chunk): void => {
+        c.signal.throwIfAborted();
+        chunks.push(chunk);
       },
     });
   }
 
   /**
-   * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#data)
+   * 保存済みの値を読み出すストリームを作成します。
+   *
+   * @param c 読み出すキーを持つコンテキストです。
+   *
+   * @returns Uint8Array を送出する読み取りストリームです。
    */
-  public getReadable(args: Pick<IStorage.GetReadableArgs, "key">): ReadableStream<Uint8Array> {
-    const { key } = args;
+  public getReadable(c: IStorage.GetReadableContext): ReadableStream<Uint8Array> {
+    c.signal.throwIfAborted();
 
-    return new ReadableStream({
-      pull: async (controller) => {
-        const data = await this.read({ key });
-        controller.enqueue(data);
-        controller.close();
+    return new ReadableStream<Uint8Array>({
+      pull: async (controller: ReadableStreamDefaultController<Uint8Array>): Promise<void> => {
+        try {
+          const data = await this.read(c as unknown as IStorage.ReadContext);
+
+          c.signal.throwIfAborted();
+          controller.enqueue(data as Uint8Array);
+          controller.close();
+        } catch (ex) {
+          controller.error(ex);
+        }
       },
     });
   }
+
+  /**
+   * 開いているデータベースを返します。未オープン時はエラーを投げます。
+   *
+   * @returns 開いているデータベースです。
+   */
+  #getDb(): IDBPDatabase {
+    const db = this.#db;
+
+    if (db === null) {
+      throw new TypeError("Indexeddb is not open. Call open() first.");
+    }
+
+    return db;
+  }
 }

package/dist/src/indexeddb.d.ts

@@ -1,69 +0,0 @@
-import type { IStorage } from "@unikvs/core";
-/**
- * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#usage)
- */
-export default class Indexeddb implements IStorage {
-    /**
-     * IndexedDB のデータベースインスタンスを保持します。
-     *
-     * ストレージがオープンされるまで null です。
-     */
-    private db;
-    /**
-     * 使用するデータベース名です。
-     */
-    private readonly dbName;
-    /**
-     * 使用するオブジェクトストア名です。
-     */
-    private readonly storeName;
-    /**
-     * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#usage)
-     */
-    readonly name: string;
-    /**
-     * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#usage)
-     */
-    constructor(dbName?: string, storeName?: string);
-    /**
-     * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#usage)
-     */
-    get isOpen(): boolean;
-    /**
-     * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#usage)
-     */
-    open(): Promise<void>;
-    /**
-     * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#usage)
-     */
-    close(): Promise<void>;
-    /**
-     * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#data)
-     */
-    write(args: Pick<IStorage.WriteArgs<any>, "key" | "data">): Promise<void>;
-    /**
-     * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#data)
-     */
-    read(args: Pick<IStorage.ReadArgs, "key">): Promise<any>;
-    /**
-     * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#usage)
-     */
-    exists(args: Pick<IStorage.ExistsArgs, "key">): Promise<boolean>;
-    /**
-     * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#usage)
-     */
-    delete(args: Pick<IStorage.DeleteArgs, "key">): Promise<void>;
-    /**
-     * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#usage)
-     */
-    clear(): Promise<void>;
-    /**
-     * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#data)
-     */
-    getWritable(args: Pick<IStorage.GetWritableArgs, "key">): WritableStream<Uint8Array>;
-    /**
-     * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#data)
-     */
-    getReadable(args: Pick<IStorage.GetReadableArgs, "key">): ReadableStream<Uint8Array>;
-}
-//# sourceMappingURL=indexeddb.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"indexeddb.d.ts","sourceRoot":"","sources":["../../src/indexeddb.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAG7C;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,SAAU,YAAW,QAAQ;IAChD;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAsB;IAEhC;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC;;OAEG;IACH,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,YAAmB,MAAM,GAAE,MAAoB,EAAE,SAAS,GAAE,MAAoB,EAK/E;IAED;;OAEG;IACH,IAAW,MAAM,IAAI,OAAO,CAE3B;IAED;;OAEG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAajC;IAED;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAGlC;IAED;;OAEG;IACU,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAGrF;IAED;;OAEG;IACU,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAWpE;IAED;;OAEG;IACU,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAM5E;IAED;;OAEG;IACU,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAIzE;IAED;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAElC;IAED;;OAEG;IACI,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,eAAe,EAAE,KAAK,CAAC,GAAG,cAAc,CAAC,UAAU,CAAC,CAqB1F;IAED;;OAEG;IACI,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,eAAe,EAAE,KAAK,CAAC,GAAG,cAAc,CAAC,UAAU,CAAC,CAU1F;CACF"}

package/dist/src/indexeddb.js

@@ -1,119 +0,0 @@
-import { openDB } from "idb";
-/**
- * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#usage)
- */
-export default class Indexeddb {
-    /**
-     * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#usage)
-     */
-    constructor(dbName = "unikvs_db", storeName = "kvs_store") {
-        this.name = "Indexeddb";
-        this.db = null;
-        this.dbName = dbName;
-        this.storeName = storeName;
-    }
-    /**
-     * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#usage)
-     */
-    get isOpen() {
-        return this.db !== null;
-    }
-    /**
-     * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#usage)
-     */
-    async open() {
-        if (this.db) {
-            return;
-        }
-        this.db = await openDB(this.dbName, 1, {
-            upgrade: (db) => {
-                // オブジェクトストアが存在しない場合は作成します
-                if (!db.objectStoreNames.contains(this.storeName)) {
-                    db.createObjectStore(this.storeName);
-                }
-            },
-        });
-    }
-    /**
-     * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#usage)
-     */
-    async close() {
-        this.db.close();
-        this.db = null;
-    }
-    /**
-     * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#data)
-     */
-    async write(args) {
-        const { key, data } = args;
-        await this.db.put(this.storeName, data, key);
-    }
-    /**
-     * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#data)
-     */
-    async read(args) {
-        const { key } = args;
-        // Opfs の挙動に合わせて、存在しない場合は DOMException (NotFoundError) を投げます
-        if (!(await this.exists({ key }))) {
-            throw new DOMException(`A requested file or directory could not be found at the time an operation was processed.`, "NotFoundError");
-        }
-        return await this.db.get(this.storeName, key);
-    }
-    /**
-     * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#usage)
-     */
-    async exists(args) {
-        const { key } = args;
-        // count() はキーが存在すれば 1 を、存在しなければ 0 を返します
-        const count = await this.db.count(this.storeName, key);
-        return count > 0;
-    }
-    /**
-     * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#usage)
-     */
-    async delete(args) {
-        const { key } = args;
-        await this.db.delete(this.storeName, key);
-    }
-    /**
-     * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#usage)
-     */
-    async clear() {
-        await this.db.clear(this.storeName);
-    }
-    /**
-     * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#data)
-     */
-    getWritable(args) {
-        const { key } = args;
-        const chunks = [];
-        return new WritableStream({
-            write: (chunk) => {
-                chunks.push(chunk);
-            },
-            close: async () => {
-                const totalLength = chunks.reduce((acc, chunk) => acc + chunk.length, 0);
-                const result = new Uint8Array(totalLength);
-                let offset = 0;
-                for (const chunk of chunks) {
-                    result.set(chunk, offset);
-                    offset += chunk.length;
-                }
-                await this.db.put(this.storeName, result, key);
-            },
-        });
-    }
-    /**
-     * [API Reference](https://tai-kun.github.io/unikvs/packages/indexeddb#data)
-     */
-    getReadable(args) {
-        const { key } = args;
-        return new ReadableStream({
-            pull: async (controller) => {
-                const data = await this.read({ key });
-                controller.enqueue(data);
-                controller.close();
-            },
-        });
-    }
-}