unikvs 0.0.2 → 0.0.4

package/dist/src/errors.js

@@ -0,0 +1,169 @@
+var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p;
+import { setErrorMessage, ErrorBase } from "@unikvs/core";
+// -------------------------------------------------------------------------------------------------
+//
+// 境界エラー
+//
+// -------------------------------------------------------------------------------------------------
+export class InvalidUsageErrorBase extends ErrorBase {
+}
+export class InvalidInputError extends InvalidUsageErrorBase {
+    constructor(args, options) {
+        const { value: input, issues } = args;
+        super({ input, issues }, ({ issues }) => issues.map((i) => i.message).join(": "), options);
+    }
+}
+_a = InvalidInputError;
+(() => {
+    _a.prototype.name = "UniKvsInvalidInputError";
+})();
+export class InvalidOutputError extends InvalidUsageErrorBase {
+    constructor(args, options) {
+        const { value: output, issues } = args;
+        super({ output, issues }, ({ issues }) => issues.map((i) => i.message).join(": "), options);
+    }
+}
+_b = InvalidOutputError;
+(() => {
+    _b.prototype.name = "UniKvsInvalidOutputError";
+})();
+// -------------------------------------------------------------------------------------------------
+//
+// UniKvs
+//
+// -------------------------------------------------------------------------------------------------
+export class UniKvsIsOpenError extends ErrorBase {
+    constructor(options) {
+        super("UniKvs is open", options);
+    }
+}
+_c = UniKvsIsOpenError;
+(() => {
+    _c.prototype.name = "UniKvsIsOpenError";
+})();
+setErrorMessage(UniKvsIsOpenError, "UniKvs は開いています", "ja");
+export class UniKvsIsNotOpenError extends ErrorBase {
+    constructor(options) {
+        super("UniKvs is not open", options);
+    }
+}
+_d = UniKvsIsNotOpenError;
+(() => {
+    _d.prototype.name = "UniKvsIsNotOpenError";
+})();
+setErrorMessage(UniKvsIsNotOpenError, "UniKvs は開いていません", "ja");
+export class KeyNotFoundError extends ErrorBase {
+    constructor(args, options) {
+        super(args, ({ key }) => `Key ${JSON.stringify(key)} not found`, options);
+    }
+}
+_e = KeyNotFoundError;
+(() => {
+    _e.prototype.name = "UniKvsKeyNotFoundError";
+})();
+setErrorMessage(KeyNotFoundError, ({ key }) => `キー ${JSON.stringify(key)} が見つかりません`, "ja");
+export class StorageIsNotOpenError extends ErrorBase {
+    constructor(args, options) {
+        super(args, ({ name }) => `Storage "${name}" is not open`, options);
+    }
+}
+_f = StorageIsNotOpenError;
+(() => {
+    _f.prototype.name = "UniKvsStorageIsNotOpenError";
+})();
+setErrorMessage(StorageIsNotOpenError, ({ name }) => `ストレージ "${name}" は開いていません`, "ja");
+export class WritableStreamNotSupportedError extends ErrorBase {
+    constructor(args, options) {
+        super(args, ({ name }) => `Storage "${name}" does not support writable stream`, options);
+    }
+}
+_g = WritableStreamNotSupportedError;
+(() => {
+    _g.prototype.name = "UniKvsWritableStreamNotSupportedError";
+})();
+setErrorMessage(StorageIsNotOpenError, ({ name }) => `ストレージ "${name}" は書き込み可能なストリームをサポートしていません`, "ja");
+export class ReadableStreamNotSupportedError extends ErrorBase {
+    constructor(args, options) {
+        super(args, ({ name }) => `Storage "${name}" does not support readable stream`, options);
+    }
+}
+_h = ReadableStreamNotSupportedError;
+(() => {
+    _h.prototype.name = "UniKvsReadableStreamNotSupportedError";
+})();
+setErrorMessage(StorageIsNotOpenError, ({ name }) => `ストレージ "${name}" は読み取り可能なストリームをサポートしていません`, "ja");
+export class TransformerIsNotOpenError extends ErrorBase {
+    constructor(args, options) {
+        super(args, ({ name }) => `Transformer "${name}" is not open`, options);
+    }
+}
+_j = TransformerIsNotOpenError;
+(() => {
+    _j.prototype.name = "UniKvsTransformerIsNotOpenError";
+})();
+setErrorMessage(TransformerIsNotOpenError, ({ name }) => `トランスフォーマー "${name}" は開いていません`, "ja");
+export class EncodableStreamNotSupportedError extends ErrorBase {
+    constructor(args, options) {
+        super(args, ({ name }) => `Transformer "${name}" does not support encodable stream`, options);
+    }
+}
+_k = EncodableStreamNotSupportedError;
+(() => {
+    _k.prototype.name = "UniKvsEncodableStreamNotSupportedError";
+})();
+setErrorMessage(TransformerIsNotOpenError, ({ name }) => `トランスフォーマー "${name}" はエンコード可能なストリームをサポートしていません`, "ja");
+export class DecodableStreamNotSupportedError extends ErrorBase {
+    constructor(args, options) {
+        super(args, ({ name }) => `Transformer "${name}" does not support decodable stream`, options);
+    }
+}
+_l = DecodableStreamNotSupportedError;
+(() => {
+    _l.prototype.name = "UniKvsDecodableStreamNotSupportedError";
+})();
+setErrorMessage(TransformerIsNotOpenError, ({ name }) => `トランスフォーマー "${name}" はデコード可能なストリームをサポートしていません`, "ja");
+export class PluginOperationAggregateError extends ErrorBase {
+    constructor(args, options) {
+        const errors = args.errors.map((error) => ({
+            plugin: error.plugin ?? args.plugin ?? "",
+            reason: error.reason,
+        }));
+        const plugins = [...new Set(errors.map((error) => error.plugin))];
+        super({
+            plugin: plugins.length === 1 ? plugins[0] : "plugin",
+            action: args.action,
+            errors,
+        }, ({ action, errors, plugin }) => `${errors.length} ${plugin}(s) fail ${action} operation`, options);
+    }
+}
+_m = PluginOperationAggregateError;
+(() => {
+    _m.prototype.name = "UniKvsPluginOperationAggregateError";
+})();
+setErrorMessage(PluginOperationAggregateError, ({ action, errors, plugin }) => `${errors.length} 個の${{ plugin: "プラグイン", storage: "ストレージ", transformer: "トランスフォーマー" }[plugin]}が ${action} 操作に失敗`, "ja");
+// -------------------------------------------------------------------------------------------------
+//
+// その他
+//
+// -------------------------------------------------------------------------------------------------
+export class MissingStorageError extends ErrorBase {
+    constructor(options) {
+        super("At least one storage is required to use UniKvs", options);
+    }
+}
+_o = MissingStorageError;
+(() => {
+    _o.prototype.name = "UniKvsMissingStorageError";
+})();
+setErrorMessage(MissingStorageError, "UniKvs を使用するためには最低 1 つのストレージが必要です", "ja");
+// -------------------------------------------------------------------------------------------------
+export class TransformerRegistrationError extends ErrorBase {
+    constructor(options) {
+        super("Cannot add transformers after storage has already been registered", options);
+    }
+}
+_p = TransformerRegistrationError;
+(() => {
+    _p.prototype.name = "UniKvsTransformerRegistrationError";
+})();
+setErrorMessage(MissingStorageError, "ストレージが登録された後にトランスフォーマーを追加することはできません", "ja");

package/dist/src/index.d.ts

@@ -0,0 +1,10 @@
+export type * from "./context.types.js";
+export type { DecodableStreamNotSupportedErrorArgs, DecodableStreamNotSupportedErrorMeta, EncodableStreamNotSupportedErrorArgs, EncodableStreamNotSupportedErrorMeta, InvalidInputErrorArgs, InvalidInputErrorMeta, InvalidOutputErrorArgs, InvalidOutputErrorMeta, Issue, KeyNotFoundErrorArgs, KeyNotFoundErrorMeta, PluginOperationAggregateErrorArgs, PluginOperationAggregateErrorMeta, ReadableStreamNotSupportedErrorArgs, ReadableStreamNotSupportedErrorMeta, StorageIsNotOpenErrorArgs, StorageIsNotOpenErrorMeta, TransformerIsNotOpenErrorArgs, TransformerIsNotOpenErrorMeta, WritableStreamNotSupportedErrorArgs, WritableStreamNotSupportedErrorMeta, } from "./errors.js";
+export { DecodableStreamNotSupportedError, EncodableStreamNotSupportedError, InvalidInputError, InvalidOutputError, InvalidUsageErrorBase, KeyNotFoundError, MissingStorageError, PluginOperationAggregateError, ReadableStreamNotSupportedError, StorageIsNotOpenError, TransformerIsNotOpenError, TransformerRegistrationError, UniKvsIsNotOpenError, UniKvsIsOpenError, WritableStreamNotSupportedError, } from "./errors.js";
+export type * from "./unikvs-config.js";
+export { default as UniKvsConfig } from "./unikvs-config.js";
+export type * from "./unikvs.js";
+export { default as UniKvs } from "./unikvs.js";
+export type * from "./utils.types.js";
+export type * from "./value-stream.types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,oBAAoB,CAAC;AAExC,YAAY,EACV,oCAAoC,EACpC,oCAAoC,EACpC,oCAAoC,EACpC,oCAAoC,EACpC,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,KAAK,EACL,oBAAoB,EACpB,oBAAoB,EACpB,iCAAiC,EACjC,iCAAiC,EACjC,mCAAmC,EACnC,mCAAmC,EACnC,yBAAyB,EACzB,yBAAyB,EACzB,6BAA6B,EAC7B,6BAA6B,EAC7B,mCAAmC,EACnC,mCAAmC,GACpC,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,gCAAgC,EAChC,gCAAgC,EAChC,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,6BAA6B,EAC7B,+BAA+B,EAC/B,qBAAqB,EACrB,yBAAyB,EACzB,4BAA4B,EAC5B,oBAAoB,EACpB,iBAAiB,EACjB,+BAA+B,GAChC,MAAM,aAAa,CAAC;AAErB,mBAAmB,oBAAoB,CAAC;AACxC,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE7D,mBAAmB,aAAa,CAAC;AACjC,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAEhD,mBAAmB,kBAAkB,CAAC;AAEtC,mBAAmB,yBAAyB,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,3 @@
+export { DecodableStreamNotSupportedError, EncodableStreamNotSupportedError, InvalidInputError, InvalidOutputError, InvalidUsageErrorBase, KeyNotFoundError, MissingStorageError, PluginOperationAggregateError, ReadableStreamNotSupportedError, StorageIsNotOpenError, TransformerIsNotOpenError, TransformerRegistrationError, UniKvsIsNotOpenError, UniKvsIsOpenError, WritableStreamNotSupportedError, } from "./errors.js";
+export { default as UniKvsConfig } from "./unikvs-config.js";
+export { default as UniKvs } from "./unikvs.js";

package/dist/src/unikvs-config.d.ts

@@ -0,0 +1,255 @@
+import type { IReadableStreamStorage, IStorage, IWritableStreamStorage, Key, IDecodableStreamTransformer, IEncodableStreamTransformer, ITransformer } from "@unikvs/core";
+import type { ContextSource } from "./context.types.js";
+import type UniKvs from "./unikvs.js";
+import type { ValueOf } from "./utils.types.js";
+/**
+ * トランスフォーマーから、デコード時の入力データの型を推論するユーティリティー型です。
+ *
+ * @template TTransformer 対象となるトランスフォーマーの型です。
+ */
+type $InferDecodeDataInput<TTransformer extends ITransformer> = TTransformer extends ITransformer<any, infer TDecodeDataInput> ? TDecodeDataInput : never;
+/**
+ * トランスフォーマーから、エンコード時の出力データの型を推論するユーティリティー型です。
+ *
+ * @template TTransformer 対象となるトランスフォーマーの型です。
+ */
+type $InferEncodeDataOutput<TTransformer extends ITransformer> = TTransformer extends ITransformer<any, any, infer TEncodeDataOutput> ? TEncodeDataOutput : never;
+/**
+ * トランスフォーマーから、デコードストリームの入力チャンクデータの型を推論するユーティリティー型です。
+ *
+ * @template TTransformer 対象となるトランスフォーマーの型です。
+ */
+type $InferDecodeChunkInput<TTransformer extends ITransformer> = TTransformer extends IDecodableStreamTransformer<infer TDecodeChunkInput> ? TDecodeChunkInput : never;
+/**
+ * トランスフォーマーから、エンコードストリームの出力チャンクデータの型を推論するユーティリティー型です。
+ *
+ * @template TTransformer 対象となるトランスフォーマーの型です。
+ */
+type $InferEncodeChunkOutput<TTransformer extends ITransformer> = TTransformer extends IEncodableStreamTransformer<any, infer TEncodeChunkOutput> ? TEncodeChunkOutput : never;
+/**
+ * ストレージから、書き込みストリームの入力チャンクデータの型を推論するユーティリティー型です。
+ *
+ * @template TStorage 対象となるストレージの型です。
+ */
+type $InferWriteChunkInput<TStorage extends IStorage> = TStorage extends IWritableStreamStorage<infer TWriteChunkInput> ? TWriteChunkInput : never;
+/**
+ * ストレージから、読み込みストリームの出力チャンクデータの型を推論するユーティリティー型です。
+ *
+ * @template TStorage 対象となるストレージの型です。
+ */
+type $InferReadChunkOutput<TStorage extends IStorage> = TStorage extends IReadableStreamStorage<infer TReadChunkOutput> ? TReadChunkOutput : never;
+/**
+ * プレーンな値を識別するための固有のシンボルです。
+ */
+declare const PLAIN_VALUE: unique symbol;
+/**
+ * ストリームではない通常の値を表す型定義です。
+ *
+ * @template TData 保持するデータの型です。
+ */
+export type PlainValue<TData = any> = [Type: typeof PLAIN_VALUE, Data: TData];
+/**
+ * ストリーム形式の値を識別するための固有のシンボルです。
+ */
+declare const STREAM_VALUE: unique symbol;
+/**
+ * ストリームとして扱われる値を表す型定義です。
+ *
+ * @template TChunkData ストリームのチャンクデータの型です。
+ */
+export type StreamValue<TChunkData = any> = [Type: typeof STREAM_VALUE, ChunkData: TChunkData];
+/**
+ * UniKvs で扱う値の抽象型です。プレーンな値かストリーム値のいずれかになります。
+ *
+ * @template TDataAndChunkData データまたはチャンクデータの型です。
+ */
+export type Value<TDataAndChunkData = any> = PlainValue<TDataAndChunkData> | StreamValue<TDataAndChunkData>;
+/**
+ * キーと値のマッピングを定義するオブジェクトの型です。
+ *
+ * @template T マッピングされる値の型です。
+ */
+export type KeyValueMapping<T = any> = {
+    readonly [key: Key]: Value<T>;
+};
+/**
+ * PlainValue 型から内部のデータ型を抽出します。
+ *
+ * @template TPlainValue 対象となる PlainValue 型です。
+ */
+export type $InferPlainValueData<TPlainValue> = TPlainValue extends PlainValue<infer TData> ? TData : never;
+/**
+ * StreamValue 型から内部のチャンクデータ型を抽出します。
+ *
+ * @template TStremValue 対象となる StreamValue 型です。
+ */
+export type $InferStreamValueChunkData<TStremValue> = TStremValue extends StreamValue<infer TChunkData> ? TChunkData : never;
+/**
+ * KeyValueMapping から有効なキーの型を抽出します。
+ *
+ * @template TKeyValueMapping 対象となるマッピング型です。
+ */
+export type KeyofKeyValueMapping<TKeyValueMapping extends KeyValueMapping = KeyValueMapping> = Extract<keyof TKeyValueMapping, Key>;
+/**
+ * UniKvs の設定を構築するためのビルダーインターフェースです。
+ *
+ * トランスフォーマーの追加やストレージの登録を型安全に行うための流れるようなインターフェースを提供します。
+ *
+ * @template TKeyValueMapping キーと値のマッピング型です。
+ * @template TUniKvsDataInput UniKvs への入力データの型です。
+ * @template TUniKvsDataOutput UniKvs からの出力データの型です。
+ * @template TUniKvsChunkInput UniKvs への入力チャンクデータの型です。
+ * @template TUniKvsChunkOutput UniKvs からのストリーム出力チャンクデータの型です。
+ * @template TLastTransformerDecodeDataInput 最後に適用されたトランスフォーマーのデコード入力データの型です。
+ * @template TLastTransformerEncodeDataOutput 最後に適用されたトランスフォーマーのエンコード出力データの型です。
+ * @template TLastTransformerDecodeChunkInput 最後に適用されたトランスフォーマーのデコード入力チャンクデータの型です。
+ * @template TLastTransformerEncodeChunkOutput 最後に適用されたトランスフォーマーのエンコード出力チャンクデータの型です。
+ */
+export interface IUniKvsConfigBuilder<TKeyValueMapping extends KeyValueMapping = KeyValueMapping, TUniKvsDataInput = ValueOf<{
+    [TKey in KeyofKeyValueMapping<TKeyValueMapping>]: $InferPlainValueData<TKeyValueMapping[TKey]>;
+}>, TUniKvsDataOutput = TUniKvsDataInput, TUniKvsChunkInput = ValueOf<{
+    [TKey in KeyofKeyValueMapping<TKeyValueMapping>]: $InferStreamValueChunkData<TKeyValueMapping[TKey]>;
+}>, TUniKvsChunkOutput = TUniKvsChunkInput, TLastTransformerDecodeDataInput = TUniKvsDataOutput, TLastTransformerEncodeDataOutput = TUniKvsDataInput, TLastTransformerDecodeChunkInput = TUniKvsChunkOutput, TLastTransformerEncodeChunkOutput = TUniKvsChunkInput> {
+    /**
+     * コンテキスト情報を設定します。
+     *
+     * @param context 設定するコンテキストのソースです。
+     * @returns インスタンス自身を返します。
+     */
+    setContext(context: ContextSource): this;
+    /**
+     * ストレージをパイプラインの終端に追加します。
+     *
+     * ストレージが追加されると、設定はファイナライズ段階に移行します。
+     *
+     * @template TStorage 追加するストレージの型です。
+     * @param storage ストレージのインスタンスです。
+     * @returns ファイナライザーインターフェースを返します。
+     */
+    appendStorage<TStorage extends IStorage<[
+        TLastTransformerEncodeDataOutput
+    ] extends [never] ? any : TLastTransformerEncodeDataOutput, [
+        TLastTransformerDecodeDataInput
+    ] extends [never] ? any : TLastTransformerDecodeDataInput, [
+        TLastTransformerEncodeChunkOutput
+    ] extends [never] ? any : TLastTransformerEncodeChunkOutput, [
+        TLastTransformerDecodeChunkInput
+    ] extends [never] ? any : TLastTransformerDecodeChunkInput>>(storage: TStorage): IUniKvsConfigFinalizer<TKeyValueMapping, TLastTransformerEncodeDataOutput, TLastTransformerDecodeDataInput, [
+        TLastTransformerEncodeChunkOutput
+    ] extends [never] ? never : [$InferWriteChunkInput<TStorage>] extends [never] ? never : TLastTransformerEncodeChunkOutput, [
+        TLastTransformerDecodeChunkInput
+    ] extends [never] ? never : [$InferReadChunkOutput<TStorage>] extends [never] ? never : TLastTransformerDecodeChunkInput>;
+    /**
+     * トランスフォーマーをパイプラインに追加します。
+     *
+     * データ変換の層を積み重ねることで、シリアライズなどの処理を定義できます。
+     *
+     * @template TTransformer 追加するトランスフォーマーの型です。
+     * @param transformer トランスフォーマーのインスタンスです。
+     * @returns 新しい型情報を持つビルダーを返します。
+     */
+    appendTransformer<TTransformer extends ITransformer<[
+        TLastTransformerEncodeDataOutput
+    ] extends [never] ? any : TLastTransformerEncodeDataOutput, any, any, [
+        TLastTransformerDecodeDataInput
+    ] extends [never] ? any : TLastTransformerDecodeDataInput, [
+        TLastTransformerEncodeChunkOutput
+    ] extends [never] ? any : TLastTransformerEncodeChunkOutput, any, any, [
+        TLastTransformerDecodeChunkInput
+    ] extends [never] ? any : TLastTransformerDecodeChunkInput>>(transformer: TTransformer): IUniKvsConfigBuilder<TKeyValueMapping, TUniKvsDataInput, TUniKvsDataOutput, [
+        TUniKvsChunkInput
+    ] extends [never] ? never : [$InferDecodeChunkInput<TTransformer>] extends [never] ? never : TUniKvsChunkInput, [
+        TUniKvsChunkOutput
+    ] extends [never] ? never : [$InferEncodeChunkOutput<TTransformer>] extends [never] ? never : TUniKvsChunkOutput, $InferDecodeDataInput<TTransformer>, $InferEncodeDataOutput<TTransformer>, $InferDecodeChunkInput<TTransformer>, $InferEncodeChunkOutput<TTransformer>>;
+}
+/**
+ * UniKvs の設定を完了させるためのファイナライザーインターフェースです。
+ *
+ * @template TKeyValueMapping キーと値のマッピング型です。
+ * @template TWriteDataInput ストレージへの書き込み入力データの型です。
+ * @template TReadDataOutput ストレージからの読み込み出力データの型です。
+ * @template TWriteChunkInput ストレージへの書き込みチャンクデータの型です。
+ * @template TReadChunkOutput ストレージからの読み込みチャンクデータの型です。
+ */
+export interface IUniKvsConfigFinalizer<TKeyValueMapping extends KeyValueMapping = KeyValueMapping, TWriteDataInput = any, TReadDataOutput = any, TWriteChunkInput = any, TReadChunkOutput = any> {
+    /**
+     * 設定に基づいて UniKvs インスタンスを作成します。
+     *
+     * @returns 作成された UniKvs のインスタンスです。
+     */
+    create(): UniKvs<TKeyValueMapping>;
+    /**
+     * コンテキスト情報を設定します。
+     *
+     * @param context 設定するコンテキストのソースです。
+     * @returns インスタンス自身を返します。
+     */
+    setContext(context: ContextSource): this;
+    /**
+     * 追加のストレージを登録します。UniKvs は複数のストレージへのマルチキャスト書き込みをサポートします。
+     *
+     * @template TStorage 追加するストレージの型です。
+     * @param storage ストレージのインスタンスです。
+     * @returns ファイナライザーインターフェースを返します。
+     */
+    appendStorage<TStorage extends IStorage<[
+        TWriteDataInput
+    ] extends [never] ? any : TWriteDataInput, [
+        TReadDataOutput
+    ] extends [never] ? any : TReadDataOutput, [
+        TWriteChunkInput
+    ] extends [never] ? any : TWriteChunkInput, [
+        TReadChunkOutput
+    ] extends [never] ? any : TReadChunkOutput>>(storage: TStorage): IUniKvsConfigFinalizer<TKeyValueMapping, TWriteDataInput, TReadDataOutput, [
+        TWriteChunkInput
+    ] extends [never] ? never : [$InferWriteChunkInput<TStorage>] extends [never] ? never : TWriteChunkInput, [
+        TReadChunkOutput
+    ] extends [never] ? never : [$InferReadChunkOutput<TStorage>] extends [never] ? never : TReadChunkOutput>;
+}
+/**
+ * UniKvs の構成を管理する設定クラスです。
+ *
+ * ビルダーパターンを用いて、コンテキスト、トランスフォーマー、ストレージの順で設定を積み上げます。
+ */
+export default class UniKvsConfig implements IUniKvsConfigBuilder, IUniKvsConfigFinalizer {
+    #private;
+    /**
+     * UniKvsConfig インスタンスを初期化します。
+     *
+     * @param UniKvsConstructor UniKvs のクラスコンストラクターです。
+     */
+    constructor(UniKvsConstructor: typeof UniKvs);
+    /**
+     * 現在の設定を使用して UniKvs インスタンスを作成します。
+     *
+     * @returns 作成された UniKvs インスタンスです。
+     * @throws ストレージが一つも登録されていない場合にエラーを投げます。
+     */
+    create(): UniKvs;
+    /**
+     * コンテキスト情報を設定します。既存のコンテキストは上書きされます。
+     *
+     * @param context 設定するコンテキストのソースデータです。
+     * @returns インスタンス自身を返します。
+     */
+    setContext(context: ContextSource): this;
+    /**
+     * ストレージを登録リストに追加します。
+     *
+     * @param storage 追加するストレージインスタンスです。
+     * @returns ファイナライザーとして自身を返します。
+     */
+    appendStorage(storage: IStorage): IUniKvsConfigFinalizer;
+    /**
+     * トランスフォーマーを変換パイプラインに追加します。
+     *
+     * ストレージが登録された後には追加できない制約があります。
+     *
+     * @param transformer 追加するトランスフォーマーインスタンスです。
+     * @returns ビルダーとして自身を返します。
+     * @throws すでにストレージが登録されている状態で呼び出された場合にエラーを投げます。
+     */
+    appendTransformer(transformer: ITransformer): IUniKvsConfigBuilder;
+}
+export {};
+//# sourceMappingURL=unikvs-config.d.ts.map

package/dist/src/unikvs-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unikvs-config.d.ts","sourceRoot":"","sources":["../../src/unikvs-config.ts"],"names":[],"mappings":"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"}

package/dist/src/unikvs-config.js

@@ -0,0 +1,105 @@
+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 _UniKvsConfig_UniKvs, _UniKvsConfig_context, _UniKvsConfig_destinations, _UniKvsConfig_transformers;
+import { UniKvsStorage } from "./_storage.js";
+import UniKvsTransformer from "./_transformer.js";
+import { MissingStorageError } from "./errors.js";
+/**
+ * UniKvs の構成を管理する設定クラスです。
+ *
+ * ビルダーパターンを用いて、コンテキスト、トランスフォーマー、ストレージの順で設定を積み上げます。
+ */
+class UniKvsConfig {
+    /**
+     * UniKvsConfig インスタンスを初期化します。
+     *
+     * @param UniKvsConstructor UniKvs のクラスコンストラクターです。
+     */
+    constructor(UniKvsConstructor) {
+        /**
+         * UniKvs のコンストラクターです。
+         */
+        _UniKvsConfig_UniKvs.set(this, void 0);
+        /**
+         * アプリケーションの実行時情報を保持するコンテキストオブジェクトです。
+         */
+        _UniKvsConfig_context.set(this, void 0);
+        /**
+         * データの永続化先となるストレージのリストです。
+         */
+        _UniKvsConfig_destinations.set(this, void 0);
+        /**
+         * データを変換するためのトランスフォーマーのリストです。
+         */
+        _UniKvsConfig_transformers.set(this, void 0);
+        __classPrivateFieldSet(this, _UniKvsConfig_UniKvs, UniKvsConstructor, "f");
+        __classPrivateFieldSet(this, _UniKvsConfig_context, {}, "f");
+        __classPrivateFieldSet(this, _UniKvsConfig_destinations, [], "f");
+        __classPrivateFieldSet(this, _UniKvsConfig_transformers, [], "f");
+    }
+    /**
+     * 現在の設定を使用して UniKvs インスタンスを作成します。
+     *
+     * @returns 作成された UniKvs インスタンスです。
+     * @throws ストレージが一つも登録されていない場合にエラーを投げます。
+     */
+    create() {
+        // 登録されたストレージから先頭の要素を取得します。
+        const [dest, ...destinations] = __classPrivateFieldGet(this, _UniKvsConfig_destinations, "f").map((io) => new UniKvsStorage(io));
+        // ストレージが空の場合は UniKvs として機能できないため、例外を投げます。
+        if (!dest) {
+            throw new MissingStorageError();
+        }
+        // コンテキストの参照を切り離すために浅いコピーを作成して UniKvs を初期化します。
+        // トランスフォーマーの配列もスライスしてコピーを渡し、内部状態の安全性を確保します。
+        return new (__classPrivateFieldGet(this, _UniKvsConfig_UniKvs, "f"))(__classPrivateFieldGet(this, _UniKvsConfig_context, "f"), [dest, ...destinations], __classPrivateFieldGet(this, _UniKvsConfig_transformers, "f").map((tf) => new UniKvsTransformer(tf)));
+    }
+    /**
+     * コンテキスト情報を設定します。既存のコンテキストは上書きされます。
+     *
+     * @param context 設定するコンテキストのソースデータです。
+     * @returns インスタンス自身を返します。
+     */
+    setContext(context) {
+        __classPrivateFieldSet(this, _UniKvsConfig_context, Array.isArray(context) ? Object.fromEntries(context) : { ...context }, "f");
+        return this;
+    }
+    /**
+     * ストレージを登録リストに追加します。
+     *
+     * @param storage 追加するストレージインスタンスです。
+     * @returns ファイナライザーとして自身を返します。
+     */
+    appendStorage(storage) {
+        __classPrivateFieldGet(this, _UniKvsConfig_destinations, "f").push(storage);
+        return this;
+    }
+    /**
+     * トランスフォーマーを変換パイプラインに追加します。
+     *
+     * ストレージが登録された後には追加できない制約があります。
+     *
+     * @param transformer 追加するトランスフォーマーインスタンスです。
+     * @returns ビルダーとして自身を返します。
+     * @throws すでにストレージが登録されている状態で呼び出された場合にエラーを投げます。
+     */
+    appendTransformer(transformer) {
+        // パイプラインの順序を守るため、終端であるストレージが登録済みでないか確認します。
+        if (__classPrivateFieldGet(this, _UniKvsConfig_destinations, "f").length > 0) {
+            throw new TransformStreamDefaultController();
+        }
+        __classPrivateFieldGet(this, _UniKvsConfig_transformers, "f").push(transformer);
+        return this;
+    }
+}
+_UniKvsConfig_UniKvs = new WeakMap(), _UniKvsConfig_context = new WeakMap(), _UniKvsConfig_destinations = new WeakMap(), _UniKvsConfig_transformers = new WeakMap();
+export default UniKvsConfig;