unikvs 0.0.10 → 0.0.13

package/dist/src/unikvs.js

@@ -1,867 +0,0 @@
-var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
-    if (kind === "m") throw new TypeError("Private method is not writable");
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
-    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
-};
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var _UniKvs_instances, _UniKvs_con, _UniKvs_acSet, _UniKvs_context, _UniKvs_destinations, _UniKvs_transformers, _UniKvs_close;
-import { combineSignals } from "abort-signal-utils";
-import { asyncmux, Asyncmux } from "asyncmux";
-import logger from "./_logger.js";
-import mergeContext from "./_merge-context.js";
-import toValueStream from "./_to-value-stream.js";
-import * as v from "./_valibot.js";
-import { KeyNotFoundError, UniKvsIsOpenError, PluginOperationAggregateError, UniKvsIsNotOpenError, } from "./errors.js";
-import UniKvsConfig from "./unikvs-config.js";
-// -------------------------------------------------------------------------------------------------
-//
-// スキーマ
-//
-// -------------------------------------------------------------------------------------------------
-const ContextKeySchema = v.string();
-// 配列形式の context も正当な入力であるため、record スキーマより先に判定する必要があります。
-// record スキーマは配列にもマッチして数値キーのオブジェクトに変換してしまうため、配列形式を先に処理しないと mergeContext での配列としてのマージが行われません。
-const ContextSourceSchema = v.union([
-    v.array(v.tuple([ContextKeySchema, v.unknown()])),
-    v.record(v.any(), v.unknown()),
-]);
-const OpenOptionsSchema = v.object({
-    /**
-     * 処理の中断を通知するためのシグナルです。
-     */
-    signal: v.optional(v.instance(AbortSignal)),
-    /**
-     * 実行時のコンテキスト情報です。
-     */
-    context: v.optional(ContextSourceSchema),
-});
-const OpenArgsSchema = v.tuple([v.optional(OpenOptionsSchema)]);
-const CloseOptionsSchema = v.object({
-    /**
-     * 処理の中断を通知するためのシグナルです。
-     */
-    signal: v.optional(v.instance(AbortSignal)),
-    /**
-     * 実行時のコンテキスト情報です。
-     */
-    context: v.optional(ContextSourceSchema),
-});
-const CloseArgsSchema = v.tuple([v.optional(CloseOptionsSchema)]);
-const SetOptionsSchema = v.object({
-    key: v.string(),
-    value: v.unknown(),
-    signal: v.optional(v.instance(AbortSignal)),
-    context: v.optional(ContextSourceSchema),
-});
-const SetArgsSchema = v.union([
-    v.tuple([SetOptionsSchema]),
-    v.pipe(v.tuple([
-        SetOptionsSchema.entries.key,
-        SetOptionsSchema.entries.value,
-        v.optional(v.omit(SetOptionsSchema, ["key", "value"])),
-    ]), v.transform(([key, value, options]) => [{ ...options, key, value }])),
-]);
-const GetOptionsSchema = v.object({
-    key: v.string(),
-    signal: v.optional(v.instance(AbortSignal)),
-    context: v.optional(ContextSourceSchema),
-});
-const GetArgsSchema = v.union([
-    v.tuple([GetOptionsSchema]),
-    v.pipe(v.tuple([GetOptionsSchema.entries.key, v.optional(v.omit(GetOptionsSchema, ["key"]))]), v.transform(([key, options]) => [{ ...options, key }])),
-]);
-const StreamOptionsSchema = v.object({
-    key: v.string(),
-    signal: v.optional(v.instance(AbortSignal)),
-    context: v.optional(ContextSourceSchema),
-});
-const StreamArgsSchema = v.union([
-    v.tuple([StreamOptionsSchema]),
-    v.pipe(v.tuple([StreamOptionsSchema.entries.key, v.optional(v.omit(StreamOptionsSchema, ["key"]))]), v.transform(([key, options]) => [{ ...options, key }])),
-]);
-const HasOptionsSchema = v.object({
-    key: v.string(),
-    signal: v.optional(v.instance(AbortSignal)),
-    context: v.optional(ContextSourceSchema),
-});
-const HasArgsSchema = v.union([
-    v.tuple([HasOptionsSchema]),
-    v.pipe(v.tuple([HasOptionsSchema.entries.key, v.optional(v.omit(HasOptionsSchema, ["key"]))]), v.transform(([key, options]) => [{ ...options, key }])),
-]);
-const DeleteOptionsSchema = v.object({
-    key: v.string(),
-    signal: v.optional(v.instance(AbortSignal)),
-    context: v.optional(ContextSourceSchema),
-});
-const DeleteArgsSchema = v.union([
-    v.tuple([DeleteOptionsSchema]),
-    v.pipe(v.tuple([DeleteOptionsSchema.entries.key, v.optional(v.omit(DeleteOptionsSchema, ["key"]))]), v.transform(([key, options]) => [{ ...options, key }])),
-]);
-const ClearOptionsSchema = v.object({
-    /**
-     * 処理の中断を通知するためのシグナルです。
-     */
-    signal: v.optional(v.instance(AbortSignal)),
-    /**
-     * 実行時のコンテキスト情報です。
-     */
-    context: v.optional(ContextSourceSchema),
-});
-const ClearArgsSchema = v.tuple([v.optional(ClearOptionsSchema)]);
-// -------------------------------------------------------------------------------------------------
-//
-// UniKvs
-//
-// -------------------------------------------------------------------------------------------------
-/**
- * ストリームの読み取りロックを自動解放するための FinalizationRegistry です。
- */
-const ioLockRegistry = typeof FinalizationRegistry !== "function"
-    ? null
-    : new FinalizationRegistry((held) => {
-        if (!held.lock.released) {
-            held.lock.release();
-        }
-        // valueStream が読み取られないまま GC されたとき、ソースストリームが保持するリソース (S3 レスポンスボディなど) を解放するために破棄します。
-        // dispose は valueStream 自身を参照しないため、これを保持しても valueStream のガベージコレクションを妨げません。
-        // 失敗しても対処できないので無視します。
-        held.dispose().catch((ex) => {
-            logger.error `Failed to dispose value stream: ${ex}`;
-        });
-    });
-/**
- * UniKvs メインクラスです。
- *
- * 複数のストレージとトランスフォーマーを統合して KVS 操作を提供します。
- *
- * @template TKeyValueMapping キーと値のマッピング定義です。
- */
-export default class UniKvs {
-    /**
-     * UniKvs の設定ビルダーを作成します。
-     *
-     * @template TKeyValueMapping マッピング定義です。
-     * @returns 設定ビルダーのインスタンスです。
-     * @example
-     * ```typescript
-     * import { Compression } from "@unikvs/compression";
-     * import { FileSystem } from "@unikvs/fs.node";
-     * import { UniKvs, type Value } from "unikvs";
-     *
-     * const kvs = UniKvs.config<{
-     *   foo: Value<Uint8Array<ArrayBuffer>>;
-     * }>()
-     *   .appendTransformer(new Compression("gzip"))
-     *   .appendStorage(new FileSystem(".tmp"))
-     *   .create();
-     *
-     * await kvs.open();
-     *
-     * await kvs.set("foo", Uint8Array.from([0, 1, 2]));
-     *
-     * await kvs.close();
-     * ```
-     */
-    static config() {
-        return new UniKvsConfig(this);
-    }
-    /**
-     * インスタンスを初期化します。
-     *
-     * @internal UniKvs の設定ビルダー経由で使用します。
-     * @param context コンテキストです。
-     * @param destinations ストレージのリストです。
-     * @param transformers トランスフォーマーのリストです。
-     */
-    constructor(context, destinations, transformers) {
-        _UniKvs_instances.add(this);
-        /**
-         * 現在の接続状態です。非接続時は null となります。
-         */
-        _UniKvs_con.set(this, void 0);
-        _UniKvs_acSet.set(this, void 0);
-        /**
-         * 基本となる実行コンテキスト情報です。
-         */
-        _UniKvs_context.set(this, void 0);
-        /**
-         * データの永続化先となるストレージのリストです。
-         */
-        _UniKvs_destinations.set(this, void 0);
-        /**
-         * データの変換を行うトランスフォーマーのリストです。
-         */
-        _UniKvs_transformers.set(this, void 0);
-        __classPrivateFieldSet(this, _UniKvs_con, null, "f");
-        __classPrivateFieldSet(this, _UniKvs_acSet, new Set(), "f");
-        __classPrivateFieldSet(this, _UniKvs_context, { ...context }, "f");
-        __classPrivateFieldSet(this, _UniKvs_destinations, destinations, "f");
-        __classPrivateFieldSet(this, _UniKvs_transformers, transformers, "f");
-    }
-    /**
-     * UniKvs が利用可能であるかを確認します。
-     *
-     * @returns 利用可能である場合は true、そうでない場合は false を返します。
-     */
-    get isOpen() {
-        return __classPrivateFieldGet(this, _UniKvs_con, "f") !== null;
-    }
-    async open(...args) {
-        if (__classPrivateFieldGet(this, _UniKvs_con, "f") !== null) {
-            throw new UniKvsIsOpenError();
-        }
-        const [options = {}] = v.parseInput(OpenArgsSchema, args);
-        const { signal: signalOption, context: contextOption } = options;
-        const ac = new AbortController();
-        const signal = combineSignals([ac.signal, signalOption]);
-        const context = mergeContext(__classPrivateFieldGet(this, _UniKvs_context, "f"), contextOption);
-        context["unikvs:action"] = "open";
-        signal.throwIfAborted();
-        __classPrivateFieldGet(this, _UniKvs_acSet, "f").add(ac);
-        const dispose = [];
-        const lock = await asyncmux(this, signal);
-        try {
-            if (__classPrivateFieldGet(this, _UniKvs_con, "f") !== null) {
-                throw new UniKvsIsOpenError();
-            }
-            const openFns = [];
-            // 各ストレージのオープン処理をリストに追加します。
-            for (const storage of __classPrivateFieldGet(this, _UniKvs_destinations, "f")) {
-                openFns.push([
-                    async () => {
-                        await storage.open(context, signal);
-                        dispose.push(async () => {
-                            try {
-                                await storage.close(context, signal);
-                            }
-                            catch (ex) {
-                                logger.error `Failed to close storage: ${ex}`;
-                            }
-                        });
-                    },
-                    "storage",
-                ]);
-            }
-            // 各トランスフォーマーのオープン処理をリストに追加します。
-            for (const transformer of __classPrivateFieldGet(this, _UniKvs_transformers, "f")) {
-                openFns.push([
-                    async () => {
-                        await transformer.open(context, signal);
-                        dispose.push(async () => {
-                            try {
-                                await transformer.close(context, signal);
-                            }
-                            catch (ex) {
-                                logger.error `Failed to close transformer: ${ex}`;
-                            }
-                        });
-                    },
-                    "transformer",
-                ]);
-            }
-            // すべての処理を並列に実行し、エラーが発生した場合は集約します。
-            const errors = [];
-            await Promise.all(openFns.map(async ([f, plugin]) => {
-                try {
-                    await f();
-                }
-                catch (reason) {
-                    errors.push({ plugin, reason });
-                }
-            }));
-            if (errors.length > 0) {
-                // 中断以外の失敗が混在しない場合は、abort 理由が集約エラーに埋もれないようにそのまま投げます。
-                if (signal.aborted && errors.every((error) => error.reason === signal.reason)) {
-                    throw signal.reason;
-                }
-                throw new PluginOperationAggregateError({ action: "open", errors });
-            }
-            // すべてのプラグインのオープンが成功した後も、待機中に中断されていないか最終確認します。
-            // 中断済みのシグナルを持つ接続を作成すると、isOpen が true でありながら以降のすべての操作が即座に失敗する壊れた状態になります。
-            signal.throwIfAborted();
-            __classPrivateFieldSet(this, _UniKvs_con, {
-                ac,
-                io: new Asyncmux(),
-            }, "f");
-        }
-        catch (ex) {
-            if (dispose.length > 0) {
-                await Promise.all(dispose.map(async (f) => {
-                    await f();
-                }));
-            }
-            throw ex;
-        }
-        finally {
-            __classPrivateFieldGet(this, _UniKvs_acSet, "f").delete(ac);
-            lock.release();
-        }
-    }
-    close(...args) {
-        try {
-            const [options = {}] = v.parseInput(CloseArgsSchema, args);
-            const { signal = AbortSignal.timeout(10e3), context: contextOption } = options;
-            const context = mergeContext(__classPrivateFieldGet(this, _UniKvs_context, "f"), contextOption);
-            context["unikvs:action"] = "close";
-            if (__classPrivateFieldGet(this, _UniKvs_con, "f") === null) {
-                const acArr = [...__classPrivateFieldGet(this, _UniKvs_acSet, "f")];
-                __classPrivateFieldGet(this, _UniKvs_acSet, "f").clear();
-                for (const ac of acArr) {
-                    if (!ac.signal.aborted) {
-                        ac.abort(new UniKvsIsNotOpenError());
-                    }
-                }
-                throw new UniKvsIsNotOpenError();
-            }
-            const con = __classPrivateFieldGet(this, _UniKvs_con, "f");
-            const { ac } = con;
-            const acArr = [ac, ...__classPrivateFieldGet(this, _UniKvs_acSet, "f")];
-            __classPrivateFieldGet(this, _UniKvs_acSet, "f").clear();
-            for (const ac of acArr) {
-                if (!ac.signal.aborted) {
-                    ac.abort(new UniKvsIsNotOpenError());
-                }
-            }
-            return __classPrivateFieldGet(this, _UniKvs_instances, "m", _UniKvs_close).call(this, context, signal, con).catch(async (ex) => {
-                // #close が失敗した場合、コネクションの AbortController は既に abort 済みであり、以降の操作がすべて即座に失敗する壊れた状態になります。
-                // そこで接続を破棄して isOpen=false の一貫した状態にし、ベストエフォートでプラグインのクローズ処理を実行します。
-                if (__classPrivateFieldGet(this, _UniKvs_con, "f") === con) {
-                    __classPrivateFieldSet(this, _UniKvs_con, null, "f");
-                    const disposeSignal = AbortSignal.timeout(10e3);
-                    await Promise.all([...__classPrivateFieldGet(this, _UniKvs_destinations, "f"), ...__classPrivateFieldGet(this, _UniKvs_transformers, "f")].map(async (plugin) => {
-                        try {
-                            await plugin.close(context, disposeSignal);
-                        }
-                        catch (reason) {
-                            logger.error `Failed to close plugin after close failure: ${reason}`;
-                        }
-                    }));
-                }
-                throw ex;
-            });
-        }
-        catch (ex) {
-            return Promise.reject(ex);
-        }
-    }
-    /**
-     * UniKvs が開いている場合にクローズします。
-     *
-     * `await using` 構文による自動クローズに使用されます。
-     *
-     * @returns 完了を通知する Promise です。
-     */
-    async [(_UniKvs_con = new WeakMap(), _UniKvs_acSet = new WeakMap(), _UniKvs_context = new WeakMap(), _UniKvs_destinations = new WeakMap(), _UniKvs_transformers = new WeakMap(), _UniKvs_instances = new WeakSet(), _UniKvs_close = async function _UniKvs_close(context, signal, con) {
-        const lock = await asyncmux(this, signal);
-        try {
-            // ロック待機中に接続状態が変更されていないか再確認します。
-            if (__classPrivateFieldGet(this, _UniKvs_con, "f") !== con) {
-                throw new UniKvsIsNotOpenError();
-            }
-            const { io } = __classPrivateFieldGet(this, _UniKvs_con, "f");
-            const lock = await io.lock({ signal });
-            try {
-                const closeFns = [];
-                // ストレージのクローズ処理を登録します。
-                for (const plugin of __classPrivateFieldGet(this, _UniKvs_destinations, "f")) {
-                    closeFns.push([
-                        async () => {
-                            await plugin.close(context, signal);
-                        },
-                        "storage",
-                    ]);
-                }
-                // トランスフォーマーのクローズ処理を登録します。
-                for (const plugin of __classPrivateFieldGet(this, _UniKvs_transformers, "f")) {
-                    closeFns.push([
-                        async () => {
-                            await plugin.close(context, signal);
-                        },
-                        "transformer",
-                    ]);
-                }
-                // すべての処理を並列に実行し、エラーが発生した場合は集約します。
-                const errors = [];
-                await Promise.all(closeFns.map(async ([f, plugin]) => {
-                    try {
-                        await f();
-                    }
-                    catch (reason) {
-                        errors.push({ plugin, reason });
-                    }
-                }));
-                if (errors.length > 0) {
-                    throw new PluginOperationAggregateError({ action: "close", errors });
-                }
-            }
-            finally {
-                lock.release();
-            }
-            __classPrivateFieldSet(this, _UniKvs_con, null, "f");
-        }
-        finally {
-            lock.release();
-        }
-    }, Symbol.asyncDispose)]() {
-        if (!this.isOpen) {
-            return;
-        }
-        await this.close({
-            signal: AbortSignal.timeout(10e3),
-        });
-    }
-    async set(...args) {
-        if (__classPrivateFieldGet(this, _UniKvs_con, "f") === null) {
-            throw new UniKvsIsNotOpenError();
-        }
-        const [options] = v.parseInput(SetArgsSchema, args);
-        const { key, value, signal: signalOption, context: contextOption } = options;
-        const { ac, io } = __classPrivateFieldGet(this, _UniKvs_con, "f");
-        const signal = combineSignals([ac.signal, signalOption]);
-        const context = mergeContext(__classPrivateFieldGet(this, _UniKvs_context, "f"), contextOption);
-        context["unikvs:action"] = "set";
-        context["unikvs:key"] = key;
-        const lock = await asyncmux(this, signal);
-        try {
-            // ロック待機中に接続状態が変更されていないか再確認します。
-            if (__classPrivateFieldGet(this, _UniKvs_con, "f") === null) {
-                throw new UniKvsIsNotOpenError();
-            }
-            const errors = [];
-            const errorStorageSet = new Set();
-            if (value instanceof ReadableStream) {
-                // 各トランスフォーマーを通してデータをエンコードストリームへ変換します。
-                let data = value;
-                try {
-                    for (const transformer of __classPrivateFieldGet(this, _UniKvs_transformers, "f")) {
-                        const e = await transformer.getEncodable(context, signal);
-                        data = data.pipeThrough(e);
-                    }
-                }
-                catch (ex) {
-                    // チェーンの構築中に失敗した場合、パイプが保持するソースストリームのリソースを解放するためにキャンセルします。
-                    // キャンセルしないとソースストリームはロックされたままリークします。
-                    try {
-                        await data.cancel(ex);
-                    }
-                    catch {
-                        // キャンセルに失敗しても元の例外の伝播を優先します。
-                    }
-                    throw ex;
-                }
-                const lock = await io.lock({ key, signal });
-                try {
-                    await Promise.all(__classPrivateFieldGet(this, _UniKvs_destinations, "f").map(async (storage, i) => {
-                        // tee ブランチはキャンセルされるまで健康なブランチの読み取り分のチャンクを保持し続けるため、失敗時に放棄したブランチを確実にキャンセルできるよう参照を保持します。
-                        let branch = null;
-                        try {
-                            // 複数のストレージがある場合は、tee メソッドを使用してストリームを分岐させます。
-                            let r = data;
-                            if (i !== __classPrivateFieldGet(this, _UniKvs_destinations, "f").length - 1) {
-                                [r, data] = data.tee();
-                            }
-                            branch = r;
-                            const w = await storage.getWritable(context, signal, key);
-                            await r.pipeTo(w, { signal });
-                        }
-                        catch (reason) {
-                            if (branch !== null) {
-                                try {
-                                    await branch.cancel(reason);
-                                }
-                                catch {
-                                    // キャンセルに失敗してもエラー集約を優先します。
-                                }
-                            }
-                            errors.push({ reason });
-                            errorStorageSet.add(storage);
-                        }
-                    }));
-                }
-                finally {
-                    lock.release();
-                }
-            }
-            else {
-                // 登録されているトランスフォーマーを順番に適用してデータをエンコードします。
-                let data = value;
-                for (const transformer of __classPrivateFieldGet(this, _UniKvs_transformers, "f")) {
-                    data = await transformer.encode(context, signal, data);
-                }
-                const lock = await io.lock({ key, signal });
-                try {
-                    await Promise.all(__classPrivateFieldGet(this, _UniKvs_destinations, "f").map(async (storage) => {
-                        try {
-                            await storage.write(context, signal, key, data);
-                        }
-                        catch (reason) {
-                            errors.push({ reason });
-                            errorStorageSet.add(storage);
-                        }
-                    }));
-                }
-                finally {
-                    lock.release();
-                }
-            }
-            // エラーが発生した場合は集約します。
-            if (errors.length > 0) {
-                const error = new PluginOperationAggregateError({
-                    plugin: "storage",
-                    action: "write",
-                    errors,
-                });
-                {
-                    const errors = [];
-                    await Promise.all(__classPrivateFieldGet(this, _UniKvs_destinations, "f").map(async (storage) => {
-                        if (errorStorageSet.has(storage)) {
-                            return;
-                        }
-                        try {
-                            await storage.onOtherWriteError(context, signal, key, error);
-                        }
-                        catch (ex) {
-                            errors.push(ex);
-                        }
-                    }));
-                    if (errors.length > 0) {
-                        logger.error(new AggregateError(errors, "Failed to handle error"));
-                    }
-                }
-                throw error;
-            }
-        }
-        finally {
-            lock.release();
-        }
-    }
-    async get(...args) {
-        if (__classPrivateFieldGet(this, _UniKvs_con, "f") === null) {
-            throw new UniKvsIsNotOpenError();
-        }
-        const [options] = v.parseInput(GetArgsSchema, args);
-        const { key, signal: signalOption, context: contextOption } = options;
-        const { ac, io } = __classPrivateFieldGet(this, _UniKvs_con, "f");
-        const signal = combineSignals([ac.signal, signalOption]);
-        const context = mergeContext(__classPrivateFieldGet(this, _UniKvs_context, "f"), contextOption);
-        context["unikvs:action"] = "get";
-        context["unikvs:key"] = key;
-        const lock = await asyncmux.readonly(this, signal);
-        try {
-            // ロック待機中に接続状態が変更されていないか再確認します。
-            if (__classPrivateFieldGet(this, _UniKvs_con, "f") === null) {
-                throw new UniKvsIsNotOpenError();
-            }
-            const NONE = {};
-            let data = NONE;
-            const errors = [];
-            const lock = await io.rLock({ key, signal });
-            try {
-                // 各ストレージを巡回し、最初に見つかったデータを取得します。
-                // あるストレージの読み取りに失敗しても、他のストレージからデータを取得できるようにフォールバックします。
-                for (const storage of __classPrivateFieldGet(this, _UniKvs_destinations, "f")) {
-                    try {
-                        if (!(await storage.exists(context, signal, key))) {
-                            continue;
-                        }
-                        data = await storage.read(context, signal, key);
-                        break;
-                    }
-                    catch (ex) {
-                        if (signal.aborted) {
-                            throw ex;
-                        }
-                        errors.push({ reason: ex });
-                        logger.error `Failed to read from a storage: ${ex}`;
-                    }
-                }
-            }
-            finally {
-                lock.release();
-            }
-            if (data === NONE) {
-                const args = { key };
-                switch (errors.length) {
-                    case 0:
-                        break;
-                    case 1:
-                        args.cause = errors[0].reason;
-                        break;
-                    default:
-                        args.cause = new PluginOperationAggregateError({
-                            plugin: "storage",
-                            action: "read",
-                            errors,
-                        });
-                }
-                throw new KeyNotFoundError(args);
-            }
-            // トランスフォーマーを逆順に適用してデータをデコードします。
-            if (__classPrivateFieldGet(this, _UniKvs_transformers, "f").length > 0) {
-                for (const transformer of __classPrivateFieldGet(this, _UniKvs_transformers, "f").toReversed()) {
-                    data = await transformer.decode(context, signal, data);
-                }
-            }
-            return data;
-        }
-        finally {
-            lock.release();
-        }
-    }
-    async stream(...args) {
-        if (__classPrivateFieldGet(this, _UniKvs_con, "f") === null) {
-            throw new UniKvsIsNotOpenError();
-        }
-        const [options] = v.parseInput(StreamArgsSchema, args);
-        const { key, signal: signalOption, context: contextOption } = options;
-        const { ac, io } = __classPrivateFieldGet(this, _UniKvs_con, "f");
-        const signal = combineSignals([ac.signal, signalOption]);
-        const context = mergeContext(__classPrivateFieldGet(this, _UniKvs_context, "f"), contextOption);
-        context["unikvs:action"] = "stream";
-        context["unikvs:key"] = key;
-        const lock = await asyncmux.readonly(this, signal);
-        try {
-            // ロック待機中に接続状態が変更されていないか再確認します。
-            if (__classPrivateFieldGet(this, _UniKvs_con, "f") === null) {
-                throw new UniKvsIsNotOpenError();
-            }
-            const NONE = {};
-            let r = NONE;
-            const errors = [];
-            const lock = await io.rLock({ key, signal });
-            try {
-                // 各ストレージを巡回し、最初に見つかったデータを取得します。
-                // あるストレージの読み取りに失敗しても、他のストレージからデータを取得できるようにフォールバックします。
-                for (const storage of __classPrivateFieldGet(this, _UniKvs_destinations, "f")) {
-                    try {
-                        if (!(await storage.exists(context, signal, key))) {
-                            continue;
-                        }
-                        r = await storage.getReadable(context, signal, key);
-                        break;
-                    }
-                    catch (ex) {
-                        if (signal.aborted) {
-                            throw ex;
-                        }
-                        errors.push({ reason: ex });
-                        logger.error `Failed to read from a storage: ${ex}`;
-                    }
-                }
-                if (r === NONE) {
-                    const args = { key };
-                    switch (errors.length) {
-                        case 0:
-                            break;
-                        case 1:
-                            args.cause = errors[0].reason;
-                            break;
-                        default:
-                            args.cause = new PluginOperationAggregateError({
-                                plugin: "storage",
-                                action: "read",
-                                errors,
-                            });
-                    }
-                    throw new KeyNotFoundError(args);
-                }
-                // トランスフォーマーを逆順に適用し、デコード用トランスフォームを連結します。
-                for (const transformer of __classPrivateFieldGet(this, _UniKvs_transformers, "f").toReversed()) {
-                    const d = await transformer.getDecodable(context, signal);
-                    r = r.pipeThrough(d);
-                }
-                if (!ioLockRegistry) {
-                    return toValueStream(r, async () => {
-                        try {
-                            lock.release();
-                        }
-                        catch { }
-                    });
-                }
-                const unregisterToken = {};
-                const valueStream = toValueStream(r, async () => {
-                    try {
-                        ioLockRegistry.unregister(unregisterToken);
-                    }
-                    catch { }
-                    try {
-                        lock.release();
-                    }
-                    catch { }
-                });
-                // valueStream が GC されるタイミングでストリームが終了していなければロックを自動解放するとともに、ソースストリームが保持するリソース (S3 レスポンスボディなど) を解放できるように dispose を記録します。
-                ioLockRegistry.register(valueStream, {
-                    lock,
-                    dispose: valueStream.dispose,
-                }, unregisterToken);
-                return valueStream;
-            }
-            catch (ex) {
-                if (r !== NONE) {
-                    // getReadable 成功後のセットアップ中に失敗した場合、ソースストリームが保持するリソース (S3 レスポンスボディなど) を解放するためにキャンセルします。
-                    try {
-                        await r.cancel(ex);
-                    }
-                    catch { }
-                }
-                lock.release();
-                throw ex;
-            }
-        }
-        finally {
-            lock.release();
-        }
-    }
-    async has(...args) {
-        if (__classPrivateFieldGet(this, _UniKvs_con, "f") === null) {
-            throw new UniKvsIsNotOpenError();
-        }
-        const [options] = v.parseInput(HasArgsSchema, args);
-        const { key, signal: signalOption, context: contextOption } = options;
-        const { ac, io } = __classPrivateFieldGet(this, _UniKvs_con, "f");
-        const signal = combineSignals([ac.signal, signalOption]);
-        const context = mergeContext(__classPrivateFieldGet(this, _UniKvs_context, "f"), contextOption);
-        context["unikvs:action"] = "has";
-        context["unikvs:key"] = key;
-        const lock = await asyncmux.readonly(this, signal);
-        try {
-            // ロック待機中に接続状態が変更されていないか再確認します。
-            if (__classPrivateFieldGet(this, _UniKvs_con, "f") === null) {
-                throw new UniKvsIsNotOpenError();
-            }
-            const lock = await io.rLock({ key, signal });
-            try {
-                // いずれかのストレージに存在すれば true を返します。
-                // あるストレージの存在確認に失敗しても、他のストレージで存在を確認できるようにフォールバックします。
-                const errors = [];
-                for (const storage of __classPrivateFieldGet(this, _UniKvs_destinations, "f")) {
-                    try {
-                        if (await storage.exists(context, signal, key)) {
-                            return true;
-                        }
-                    }
-                    catch (ex) {
-                        if (signal.aborted) {
-                            throw ex;
-                        }
-                        errors.push({ reason: ex });
-                        logger.error `Failed to check existence in a storage: ${ex}`;
-                    }
-                }
-                // すべてのストレージで存在を確認できなかった場合は結果が不明のため、get() と同様にエラーとして報告します。
-                if (errors.length > 0) {
-                    const args = { key };
-                    switch (errors.length) {
-                        case 1:
-                            args.cause = errors[0].reason;
-                            break;
-                        default:
-                            args.cause = new PluginOperationAggregateError({
-                                plugin: "storage",
-                                action: "read",
-                                errors,
-                            });
-                    }
-                    throw new KeyNotFoundError(args);
-                }
-                return false;
-            }
-            finally {
-                lock.release();
-            }
-        }
-        finally {
-            lock.release();
-        }
-    }
-    async delete(...args) {
-        if (__classPrivateFieldGet(this, _UniKvs_con, "f") === null) {
-            throw new UniKvsIsNotOpenError();
-        }
-        const [options] = v.parseInput(DeleteArgsSchema, args);
-        const { key, signal: signalOption, context: contextOption } = options;
-        const { ac, io } = __classPrivateFieldGet(this, _UniKvs_con, "f");
-        const signal = combineSignals([ac.signal, signalOption]);
-        const context = mergeContext(__classPrivateFieldGet(this, _UniKvs_context, "f"), contextOption);
-        context["unikvs:action"] = "delete";
-        context["unikvs:key"] = key;
-        const lock = await asyncmux(this, signal);
-        try {
-            // ロック待機中に接続状態が変更されていないか再確認します。
-            if (__classPrivateFieldGet(this, _UniKvs_con, "f") === null) {
-                throw new UniKvsIsNotOpenError();
-            }
-            const lock = await io.lock({ key, signal });
-            try {
-                // すべてのストレージから対象データを削除します。
-                // すべての処理を並列に実行し、エラーが発生した場合は集約します。
-                const errors = [];
-                await Promise.all(__classPrivateFieldGet(this, _UniKvs_destinations, "f").map(async (storage) => {
-                    try {
-                        if (await storage.exists(context, signal, key)) {
-                            await storage.delete(context, signal, key);
-                        }
-                    }
-                    catch (reason) {
-                        errors.push({ reason });
-                    }
-                }));
-                if (errors.length > 0) {
-                    throw new PluginOperationAggregateError({ plugin: "storage", action: "delete", errors });
-                }
-            }
-            finally {
-                lock.release();
-            }
-        }
-        finally {
-            lock.release();
-        }
-    }
-    async clear(...args) {
-        if (__classPrivateFieldGet(this, _UniKvs_con, "f") === null) {
-            throw new UniKvsIsNotOpenError();
-        }
-        const [options = {}] = v.parseInput(ClearArgsSchema, args);
-        const { signal: signalOption, context: contextOption } = options;
-        const { ac, io } = __classPrivateFieldGet(this, _UniKvs_con, "f");
-        const signal = combineSignals([ac.signal, signalOption]);
-        const context = mergeContext(__classPrivateFieldGet(this, _UniKvs_context, "f"), contextOption);
-        context["unikvs:action"] = "clear";
-        const lock = await asyncmux(this, signal);
-        try {
-            // ロック待機中に接続状態が変更されていないか再確認します。
-            if (__classPrivateFieldGet(this, _UniKvs_con, "f") === null) {
-                throw new UniKvsIsNotOpenError();
-            }
-            const lock = await io.lock({ signal });
-            try {
-                // すべてのストレージで一括削除を実行します。
-                // すべての処理を並列に実行し、エラーが発生した場合は集約します。
-                const errors = [];
-                await Promise.all(__classPrivateFieldGet(this, _UniKvs_destinations, "f").map(async (storage) => {
-                    try {
-                        await storage.clear(context, signal);
-                    }
-                    catch (reason) {
-                        errors.push({ reason });
-                    }
-                }));
-                if (errors.length > 0) {
-                    throw new PluginOperationAggregateError({ plugin: "storage", action: "clear", errors });
-                }
-            }
-            finally {
-                lock.release();
-            }
-        }
-        finally {
-            lock.release();
-        }
-    }
-}