unikvs 0.0.10 → 0.0.12

package/dist/src/errors.js

@@ -1,4 +1,4 @@
-var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q;
+var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p;
 import { setErrorMessage, ErrorBase, } from "@unikvs/core";
 // -------------------------------------------------------------------------------------------------
 //
@@ -6,14 +6,12 @@ import { setErrorMessage, ErrorBase, } from "@unikvs/core";
 //
 // -------------------------------------------------------------------------------------------------
 /**
- * 無効な入出力を表すエラーの基底クラスです。
- *
- * @template TMeta エラーのメタデータの型です。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
 export class InvalidUsageErrorBase extends ErrorBase {
 }
 /**
- * 入力値が期待するスキーマに適合しない場合に投げられるエラーです。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
 export class InvalidInputError extends InvalidUsageErrorBase {
     constructor(args) {
@@ -27,7 +25,7 @@ _a = InvalidInputError;
     _a.prototype.name = "UniKvsInvalidInputError";
 })();
 /**
- * 出力値が期待するスキーマに適合しない場合に投げられるエラーです。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
 export class InvalidOutputError extends InvalidUsageErrorBase {
     constructor(args) {
@@ -46,7 +44,7 @@ _b = InvalidOutputError;
 //
 // -------------------------------------------------------------------------------------------------
 /**
- * すでに開いている UniKvs に対して再度オープン操作が行われた場合に投げられるエラーです。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
 export class UniKvsIsOpenError extends ErrorBase {
     constructor(options) {
@@ -59,7 +57,7 @@ _c = UniKvsIsOpenError;
 })();
 setErrorMessage(UniKvsIsOpenError, "UniKvs は開いています", "ja");
 /**
- * UniKvs が開かれていない状態で操作が行われた場合に投げられるエラーです。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
 export class UniKvsIsNotOpenError extends ErrorBase {
     constructor(options) {
@@ -72,7 +70,7 @@ _d = UniKvsIsNotOpenError;
 })();
 setErrorMessage(UniKvsIsNotOpenError, "UniKvs は開いていません", "ja");
 /**
- * 指定したキーのデータがどのストレージにも存在しない場合に投げられるエラーです。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
 export class KeyNotFoundError extends ErrorBase {
     constructor(args) {
@@ -87,7 +85,7 @@ _e = KeyNotFoundError;
 })();
 setErrorMessage(KeyNotFoundError, ({ key }) => `キー ${JSON.stringify(key)} が見つかりません`, "ja");
 /**
- * ストレージが開かれていない状態で操作が行われた場合に投げられるエラーです。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
 export class StorageIsNotOpenError extends ErrorBase {
     constructor(args) {
@@ -102,7 +100,7 @@ _f = StorageIsNotOpenError;
 })();
 setErrorMessage(StorageIsNotOpenError, ({ name }) => `ストレージ "${name}" は開いていません`, "ja");
 /**
- * ストレージが書き込み可能なストリームをサポートしていない場合に投げられるエラーです。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
 export class WritableStreamNotSupportedError extends ErrorBase {
     constructor(args) {
@@ -117,7 +115,7 @@ _g = WritableStreamNotSupportedError;
 })();
 setErrorMessage(WritableStreamNotSupportedError, ({ name }) => `ストレージ "${name}" は書き込み可能なストリームをサポートしていません`, "ja");
 /**
- * ストレージが読み取り可能なストリームをサポートしていない場合に投げられるエラーです。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
 export class ReadableStreamNotSupportedError extends ErrorBase {
     constructor(args) {
@@ -147,7 +145,7 @@ _j = MultipartWriteNotSupportedError;
 })();
 setErrorMessage(MultipartWriteNotSupportedError, ({ name }) => `ストレージ "${name}" はマルチパート書き込みをサポートしていません`, "ja");
 /**
- * トランスフォーマーが開かれていない状態で操作が行われた場合に投げられるエラーです。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
 export class TransformerIsNotOpenError extends ErrorBase {
     constructor(args) {
@@ -162,7 +160,7 @@ _k = TransformerIsNotOpenError;
 })();
 setErrorMessage(TransformerIsNotOpenError, ({ name }) => `トランスフォーマー "${name}" は開いていません`, "ja");
 /**
- * トランスフォーマーがエンコード可能なストリームをサポートしていない場合に投げられるエラーです。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
 export class EncodableStreamNotSupportedError extends ErrorBase {
     constructor(args) {
@@ -177,7 +175,7 @@ _l = EncodableStreamNotSupportedError;
 })();
 setErrorMessage(EncodableStreamNotSupportedError, ({ name }) => `トランスフォーマー "${name}" はエンコード可能なストリームをサポートしていません`, "ja");
 /**
- * トランスフォーマーがデコード可能なストリームをサポートしていない場合に投げられるエラーです。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
 export class DecodableStreamNotSupportedError extends ErrorBase {
     constructor(args) {
@@ -192,7 +190,7 @@ _m = DecodableStreamNotSupportedError;
 })();
 setErrorMessage(DecodableStreamNotSupportedError, ({ name }) => `トランスフォーマー "${name}" はデコード可能なストリームをサポートしていません`, "ja");
 /**
- * 複数のストレージやトランスフォーマーの操作が失敗した場合に投げられる、個々の失敗を集約したエラーです。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
 export class PluginOperationAggregateError extends ErrorBase {
     constructor(args) {
@@ -222,7 +220,7 @@ setErrorMessage(PluginOperationAggregateError, ({ action, errors, plugin }) => `
 //
 // -------------------------------------------------------------------------------------------------
 /**
- * ストレージが一つも登録されていない状態で UniKvs を作成しようとした場合に投げられるエラーです。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
  */
 export class MissingStorageError extends ErrorBase {
     constructor(options) {
@@ -234,17 +232,3 @@ _p = MissingStorageError;
     _p.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);
-    }
-}
-_q = TransformerRegistrationError;
-(() => {
-    _q.prototype.name = "UniKvsTransformerRegistrationError";
-})();
-setErrorMessage(TransformerRegistrationError, "ストレージが登録された後にトランスフォーマーを追加することはできません", "ja");

package/dist/src/index.d.ts

@@ -1,8 +1,8 @@
-export type * from "./context.types.js";
+export type * from "./variables.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 { DecodableStreamNotSupportedError, EncodableStreamNotSupportedError, InvalidInputError, InvalidOutputError, InvalidUsageErrorBase, KeyNotFoundError, MissingStorageError, PluginOperationAggregateError, ReadableStreamNotSupportedError, StorageIsNotOpenError, TransformerIsNotOpenError, UniKvsIsNotOpenError, UniKvsIsOpenError, WritableStreamNotSupportedError, } from "./errors.js";
 export type * from "./unikvs-config.js";
-export { default as UniKvsConfig } from "./unikvs-config.js";
+export { PlainValue, StreamValue, Value, 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";

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,sBAAsB,CAAC;AAE1C,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,oBAAoB,EACpB,iBAAiB,EACjB,+BAA+B,GAChC,MAAM,aAAa,CAAC;AAErB,mBAAmB,oBAAoB,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE7F,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

@@ -1,3 +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 { DecodableStreamNotSupportedError, EncodableStreamNotSupportedError, InvalidInputError, InvalidOutputError, InvalidUsageErrorBase, KeyNotFoundError, MissingStorageError, PluginOperationAggregateError, ReadableStreamNotSupportedError, StorageIsNotOpenError, TransformerIsNotOpenError, UniKvsIsNotOpenError, UniKvsIsOpenError, WritableStreamNotSupportedError, } from "./errors.js";
+export { PlainValue, StreamValue, Value, default as UniKvsConfig } from "./unikvs-config.js";
 export { default as UniKvs } from "./unikvs.js";

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

@@ -1,7 +1,9 @@
-import type { IReadableStreamStorage, IStorage, IWritableStreamStorage, IDecodableStreamTransformer, IEncodableStreamTransformer, ITransformer } from "@unikvs/core";
-import type { ContextSource } from "./context.types.js";
+import type { IStorage, ITransformer, IReadableStreamStorage, IWritableStreamStorage, IDecodableStreamTransformer, IEncodableStreamTransformer } from "@unikvs/core";
+import { type Value, type UniKvsSchema, type $InferPlainValueData, type $InferStreamValueChunkData } from "./_value-schemas.js";
 import type UniKvs from "./unikvs.js";
 import type { ValueOf } from "./utils.types.js";
+import type { VariablesSource } from "./variables.types.js";
+export { type UniKvsSchema, type ValueSchemaInfo, type UniKvsSchemaRecord, type UniKvsSchemaEntries, type $InferPlainValueData, type IValueSchemaResolver, type $InferKeyValueMapping, type $InferPlainValueInput, type $InferStreamValueChunkData, type $InferStreamValueChunkInput, Value, PlainValue, StreamValue, } from "./_value-schemas.js";
 /**
  * トランスフォーマーから、デコード時の入力データの型を推論するユーティリティー型です。
  *
@@ -39,71 +41,17 @@ type $InferWriteChunkInput<TStorage extends IStorage> = TStorage extends IWritab
  */
 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 TData データまたはチャンクデータの型です。
- */
-export type Value<TData = any> = PlainValue<TData> | StreamValue<TData>;
-/**
- * キーと値のマッピングを定義するオブジェクトの型です。
- *
- * @template T マッピングされる値の型です。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#value-types)
  */
 export type KeyValueMapping<T = any> = {
     readonly [key: IStorage.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 対象となるマッピング型です。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#value-types)
  */
 export type KeyofKeyValueMapping<TKeyValueMapping extends KeyValueMapping = KeyValueMapping> = Extract<keyof TKeyValueMapping, IStorage.Key>;
 /**
- * UniKvs の設定を構築するためのビルダーインターフェースです。
- *
- * トランスフォーマーの追加やストレージの登録を型安全に行うための流れるようなインターフェースを提供します。
- *
- * @template TKeyValueMapping キーと値のマッピング型です。
- * @template TUniKvsDataInput UniKvs への入力データの型です。
- * @template TUniKvsDataOutput UniKvs からの出力データの型です。
- * @template TUniKvsChunkInput UniKvs への入力チャンクデータの型です。
- * @template TUniKvsChunkOutput UniKvs からのストリーム出力チャンクデータの型です。
- * @template TLastTransformerDecodeDataInput 最後に適用されたトランスフォーマーのデコード入力データの型です。
- * @template TLastTransformerEncodeDataOutput 最後に適用されたトランスフォーマーのエンコード出力データの型です。
- * @template TLastTransformerDecodeChunkInput 最後に適用されたトランスフォーマーのデコード入力チャンクデータの型です。
- * @template TLastTransformerEncodeChunkOutput 最後に適用されたトランスフォーマーのエンコード出力チャンクデータの型です。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#config-builder)
  */
 export interface IUniKvsConfigBuilder<TKeyValueMapping extends KeyValueMapping = KeyValueMapping, TUniKvsDataInput = ValueOf<{
     [TKey in KeyofKeyValueMapping<TKeyValueMapping>]: $InferPlainValueData<TKeyValueMapping[TKey]>;
@@ -111,20 +59,11 @@ export interface IUniKvsConfigBuilder<TKeyValueMapping extends KeyValueMapping =
     [TKey in KeyofKeyValueMapping<TKeyValueMapping>]: $InferStreamValueChunkData<TKeyValueMapping[TKey]>;
 }>, TUniKvsChunkOutput = TUniKvsChunkInput, TLastTransformerDecodeDataInput = TUniKvsDataOutput, TLastTransformerEncodeDataOutput = TUniKvsDataInput, TLastTransformerDecodeChunkInput = TUniKvsChunkOutput, TLastTransformerEncodeChunkOutput = TUniKvsChunkInput> {
     /**
-     * コンテキスト情報を設定します。
-     *
-     * @param context 設定するコンテキストのソースです。
-     * @returns インスタンス自身を返します。
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#config-builder)
      */
-    setContext(context: ContextSource): this;
+    setVariables(vars: VariablesSource): this;
     /**
-     * ストレージをパイプラインの終端に追加します。
-     *
-     * ストレージが追加されると、設定はファイナライズ段階に移行します。
-     *
-     * @template TStorage 追加するストレージの型です。
-     * @param storage ストレージのインスタンスです。
-     * @returns ファイナライザーインターフェースを返します。
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#config-builder)
      */
     appendStorage<TStorage extends IStorage<[
         TLastTransformerEncodeDataOutput
@@ -138,15 +77,9 @@ export interface IUniKvsConfigBuilder<TKeyValueMapping extends KeyValueMapping =
         TLastTransformerEncodeChunkOutput
     ] extends [never] ? never : [$InferWriteChunkInput<TStorage>] extends [never] ? never : TLastTransformerEncodeChunkOutput, [
         TLastTransformerDecodeChunkInput
-    ] extends [never] ? never : [$InferReadChunkOutput<TStorage>] extends [never] ? never : TLastTransformerDecodeChunkInput>;
+    ] extends [never] ? never : [$InferReadChunkOutput<TStorage>] extends [never] ? never : TLastTransformerDecodeChunkInput, TLastTransformerDecodeDataInput, TLastTransformerEncodeDataOutput, TLastTransformerDecodeChunkInput, TLastTransformerEncodeChunkOutput>;
     /**
-     * トランスフォーマーをパイプラインに追加します。
-     *
-     * データ変換の層を積み重ねることで、シリアライズなどの処理を定義できます。
-     *
-     * @template TTransformer 追加するトランスフォーマーの型です。
-     * @param transformer トランスフォーマーのインスタンスです。
-     * @returns 新しい型情報を持つビルダーを返します。
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#config-builder)
      */
     appendTransformer<TTransformer extends ITransformer<[
         TLastTransformerEncodeDataOutput
@@ -163,93 +96,79 @@ export interface IUniKvsConfigBuilder<TKeyValueMapping extends KeyValueMapping =
     ] 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 ストレージからの読み込みチャンクデータの型です。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#config-builder)
  */
-export interface IUniKvsConfigFinalizer<TKeyValueMapping extends KeyValueMapping = KeyValueMapping, TWriteDataInput = any, TReadDataOutput = any, TWriteChunkInput = any, TReadChunkOutput = any> {
+export interface IUniKvsConfigFinalizer<TKeyValueMapping extends KeyValueMapping = KeyValueMapping, TWriteDataInput = any, TReadDataOutput = any, TWriteChunkInput = any, TReadChunkOutput = any, TLastTransformerDecodeDataInput = TReadDataOutput, TLastTransformerEncodeDataOutput = TWriteDataInput, TLastTransformerDecodeChunkInput = TReadChunkOutput, TLastTransformerEncodeChunkOutput = TWriteChunkInput> {
     /**
-     * 設定に基づいて UniKvs インスタンスを作成します。
-     *
-     * @returns 作成された UniKvs のインスタンスです。
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#config-builder)
      */
     create(): UniKvs<TKeyValueMapping>;
     /**
-     * コンテキスト情報を設定します。
-     *
-     * @param context 設定するコンテキストのソースです。
-     * @returns インスタンス自身を返します。
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#config-builder)
      */
-    setContext(context: ContextSource): this;
+    setVariables(vars: VariablesSource): this;
     /**
-     * 追加のストレージを登録します。UniKvs は複数のストレージへのマルチキャスト書き込みをサポートします。
-     *
-     * @template TStorage 追加するストレージの型です。
-     * @param storage ストレージのインスタンスです。
-     * @returns ファイナライザーインターフェースを返します。
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#config-builder)
      */
     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, [
+        TLastTransformerEncodeDataOutput
+    ] extends [never] ? any : TLastTransformerEncodeDataOutput, [
+        TLastTransformerDecodeDataInput
+    ] extends [never] ? any : TLastTransformerDecodeDataInput, [
+        TLastTransformerEncodeChunkOutput
+    ] extends [never] ? any : TLastTransformerEncodeChunkOutput, [
+        TLastTransformerDecodeChunkInput
+    ] extends [never] ? any : TLastTransformerDecodeChunkInput>>(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>;
+    ] extends [never] ? never : [$InferReadChunkOutput<TStorage>] extends [never] ? never : TReadChunkOutput, TLastTransformerDecodeDataInput, TLastTransformerEncodeDataOutput, TLastTransformerDecodeChunkInput, TLastTransformerEncodeChunkOutput>;
+    /**
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#config-builder)
+     */
+    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): IUniKvsConfigFinalizer<TKeyValueMapping, TWriteDataInput, TReadDataOutput, TWriteChunkInput, TReadChunkOutput, $InferDecodeDataInput<TTransformer>, $InferEncodeDataOutput<TTransformer>, $InferDecodeChunkInput<TTransformer>, $InferEncodeChunkOutput<TTransformer>>;
 }
 /**
- * UniKvs の構成を管理する設定クラスです。
- *
- * ビルダーパターンを用いて、コンテキスト、トランスフォーマー、ストレージの順で設定を積み上げます。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#config-builder)
+ */
+export type UniKvsConfigOptions = {
+    /**
+     * キーと値のスキーマ定義です。指定すると入出力値が検証されます。
+     */
+    readonly schema?: UniKvsSchema | undefined;
+};
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#config-builder)
  */
 export default class UniKvsConfig implements IUniKvsConfigBuilder, IUniKvsConfigFinalizer {
     #private;
     /**
-     * UniKvsConfig インスタンスを初期化します。
-     *
-     * @param UniKvsConstructor UniKvs のクラスコンストラクターです。
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#config-builder)
      */
-    constructor(UniKvsConstructor: typeof UniKvs);
+    constructor(UniKvsConstructor: typeof UniKvs, options?: UniKvsConfigOptions);
     /**
-     * 現在の設定を使用して UniKvs インスタンスを作成します。
-     *
-     * @returns 作成された UniKvs インスタンスです。
-     * @throws ストレージが一つも登録されていない場合にエラーを投げます。
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#config-builder)
      */
     create(): UniKvs;
     /**
-     * コンテキスト情報を設定します。既存のコンテキストは上書きされます。
-     *
-     * @param context 設定するコンテキストのソースデータです。
-     * @returns インスタンス自身を返します。
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#config-builder)
      */
-    setContext(context: ContextSource): this;
+    setVariables(vars: VariablesSource): this;
     /**
-     * ストレージを登録リストに追加します。
-     *
-     * @param storage 追加するストレージインスタンスです。
-     * @returns ファイナライザーとして自身を返します。
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#config-builder)
      */
-    appendStorage(storage: IStorage): IUniKvsConfigFinalizer;
+    appendStorage(storage: IStorage): this;
     /**
-     * トランスフォーマーを変換パイプラインに追加します。
-     *
-     * ストレージが登録された後には追加できない制約があります。
-     *
-     * @param transformer 追加するトランスフォーマーインスタンスです。
-     * @returns ビルダーとして自身を返します。
-     * @throws すでにストレージが登録されている状態で呼び出された場合にエラーを投げます。
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#config-builder)
      */
-    appendTransformer(transformer: ITransformer): IUniKvsConfigBuilder;
+    appendTransformer(transformer: ITransformer): this;
 }
-export {};
 //# sourceMappingURL=unikvs-config.d.ts.map

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

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

@@ -9,97 +9,92 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     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;
+var _UniKvsConfig_UniKvs, _UniKvsConfig_vars, _UniKvsConfig_destinations, _UniKvsConfig_transformers, _UniKvsConfig_valueSchemaResolver;
 import UniKvsStorage from "./_storage.js";
 import UniKvsTransformer from "./_transformer.js";
-import { MissingStorageError, TransformerRegistrationError } from "./errors.js";
+import * as v from "./_valibot.js";
+import { UniKvsSchemaSchema, createValueSchemaResolver, } from "./_value-schemas.js";
+import { MissingStorageError } from "./errors.js";
+export { Value, PlainValue, StreamValue, } from "./_value-schemas.js";
+const UniKvsConfigOptionsSchema = v.object({
+    /**
+     * キーと値のスキーマ定義です。
+     */
+    schema: v.optional(UniKvsSchemaSchema),
+});
+const UniKvsConfigArgsSchema = v.tuple([v.optional(UniKvsConfigOptionsSchema)]);
 /**
- * UniKvs の構成を管理する設定クラスです。
- *
- * ビルダーパターンを用いて、コンテキスト、トランスフォーマー、ストレージの順で設定を積み上げます。
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#config-builder)
  */
 class UniKvsConfig {
     /**
-     * UniKvsConfig インスタンスを初期化します。
-     *
-     * @param UniKvsConstructor UniKvs のクラスコンストラクターです。
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#config-builder)
      */
-    constructor(UniKvsConstructor) {
+    constructor(UniKvsConstructor, options) {
         /**
          * UniKvs のコンストラクターです。
          */
         _UniKvsConfig_UniKvs.set(this, void 0);
         /**
-         * アプリケーションの実行時情報を保持するコンテキストオブジェクトです。
+         * アプリケーションの実行時情報を保持する変数オブジェクトです。
          */
-        _UniKvsConfig_context.set(this, void 0);
+        _UniKvsConfig_vars.set(this, void 0);
         /**
-         * データの永続化先となるストレージのリストです。
+         * データの永続化先となるストレージのリストです。各ストレージは登録時点のトランスフォーマー数を保持します。
          */
         _UniKvsConfig_destinations.set(this, void 0);
         /**
-         * データを変換するためのトランスフォーマーのリストです。
+         * データを変換するためのトランスフォーマーのリストです。登録順に保持します。
          */
         _UniKvsConfig_transformers.set(this, void 0);
+        /**
+         * キーに対応する値のスキーマ情報を解決するリゾルバーです。スキーマ未設定時は null となります。
+         */
+        _UniKvsConfig_valueSchemaResolver.set(this, void 0);
+        const [parsed = {}] = v.parseInput(UniKvsConfigArgsSchema, [options]);
         __classPrivateFieldSet(this, _UniKvsConfig_UniKvs, UniKvsConstructor, "f");
-        __classPrivateFieldSet(this, _UniKvsConfig_context, {}, "f");
+        __classPrivateFieldSet(this, _UniKvsConfig_vars, {}, "f");
         __classPrivateFieldSet(this, _UniKvsConfig_destinations, [], "f");
         __classPrivateFieldSet(this, _UniKvsConfig_transformers, [], "f");
+        __classPrivateFieldSet(this, _UniKvsConfig_valueSchemaResolver, parsed.schema ? createValueSchemaResolver(parsed.schema) : null, "f");
     }
     /**
-     * 現在の設定を使用して UniKvs インスタンスを作成します。
-     *
-     * @returns 作成された UniKvs インスタンスです。
-     * @throws ストレージが一つも登録されていない場合にエラーを投げます。
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#config-builder)
      */
     create() {
-        // 登録されたストレージから先頭の要素を取得します。
-        const [dest, ...destinations] = __classPrivateFieldGet(this, _UniKvsConfig_destinations, "f").map((io) => new UniKvsStorage(io));
+        const transformers = __classPrivateFieldGet(this, _UniKvsConfig_transformers, "f").map((tf) => new UniKvsTransformer(tf));
+        const [first, ...rest] = __classPrivateFieldGet(this, _UniKvsConfig_destinations, "f").map(({ storage, transformerCount }) => ({
+            storage: new UniKvsStorage(storage),
+            transformers: transformers.slice(0, transformerCount),
+        }));
         // ストレージが空の場合は UniKvs として機能できないため、例外を投げます。
-        if (!dest) {
+        if (!first) {
             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)));
+        // 変数の参照を切り離すために浅いコピーを作成して UniKvs を初期化します。
+        return new (__classPrivateFieldGet(this, _UniKvsConfig_UniKvs, "f"))(__classPrivateFieldGet(this, _UniKvsConfig_vars, "f"), [first, ...rest], transformers, __classPrivateFieldGet(this, _UniKvsConfig_valueSchemaResolver, "f"));
     }
     /**
-     * コンテキスト情報を設定します。既存のコンテキストは上書きされます。
-     *
-     * @param context 設定するコンテキストのソースデータです。
-     * @returns インスタンス自身を返します。
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#config-builder)
      */
-    setContext(context) {
-        __classPrivateFieldSet(this, _UniKvsConfig_context, Array.isArray(context) ? Object.fromEntries(context) : { ...context }, "f");
+    setVariables(vars) {
+        __classPrivateFieldSet(this, _UniKvsConfig_vars, Array.isArray(vars) ? Object.fromEntries(vars) : { ...vars }, "f");
         return this;
     }
     /**
-     * ストレージを登録リストに追加します。
-     *
-     * @param storage 追加するストレージインスタンスです。
-     * @returns ファイナライザーとして自身を返します。
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#config-builder)
      */
     appendStorage(storage) {
-        __classPrivateFieldGet(this, _UniKvsConfig_destinations, "f").push(storage);
+        __classPrivateFieldGet(this, _UniKvsConfig_destinations, "f").push({ storage, transformerCount: __classPrivateFieldGet(this, _UniKvsConfig_transformers, "f").length });
         return this;
     }
     /**
-     * トランスフォーマーを変換パイプラインに追加します。
-     *
-     * ストレージが登録された後には追加できない制約があります。
-     *
-     * @param transformer 追加するトランスフォーマーインスタンスです。
-     * @returns ビルダーとして自身を返します。
-     * @throws すでにストレージが登録されている状態で呼び出された場合にエラーを投げます。
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#config-builder)
      */
     appendTransformer(transformer) {
-        // パイプラインの順序を守るため、終端であるストレージが登録済みでないか確認します。
-        if (__classPrivateFieldGet(this, _UniKvsConfig_destinations, "f").length > 0) {
-            throw new TransformerRegistrationError();
-        }
         __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();
+_UniKvsConfig_UniKvs = new WeakMap(), _UniKvsConfig_vars = new WeakMap(), _UniKvsConfig_destinations = new WeakMap(), _UniKvsConfig_transformers = new WeakMap(), _UniKvsConfig_valueSchemaResolver = new WeakMap();
 export default UniKvsConfig;