unikvs 0.0.9 → 0.0.12

package/dist/src/_value-schemas.d.ts

@@ -0,0 +1,179 @@
+import * as v from "./_valibot.js";
+/**
+ * プレーンな値を識別するための固有のシンボルです。
+ */
+declare const PLAIN_VALUE: unique symbol;
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#value-types)
+ *
+ * @template TData 入出力されるデータの型です。
+ * @template TInput `set` が受け付ける入力データの型です。
+ */
+export type PlainValue<TData = any, TInput = TData> = [
+    Type: typeof PLAIN_VALUE,
+    Data: TData,
+    Input: TInput
+];
+/**
+ * ストリーム形式の値を識別するための固有のシンボルです。
+ */
+declare const STREAM_VALUE: unique symbol;
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#value-types)
+ *
+ * @template TChunkData 入出力されるチャンクデータの型です。
+ * @template TChunkInput `set` が受け付ける入力チャンクデータの型です。
+ */
+export type StreamValue<TChunkData = any, TChunkInput = TChunkData> = [
+    Type: typeof STREAM_VALUE,
+    ChunkData: TChunkData,
+    ChunkInput: TChunkInput
+];
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#value-types)
+ *
+ * @template TDataAndChunkData データまたはチャンクデータの型です。
+ * @template TInput `set` が受け付ける入力データまたは入力チャンクデータの型です。
+ */
+export type Value<TDataAndChunkData = any, TInput = TDataAndChunkData> = PlainValue<TDataAndChunkData, TInput> | StreamValue<TDataAndChunkData, TInput>;
+/**
+ * PlainValue 型から内部のデータ型を抽出します。
+ *
+ * @template TPlainValue 対象となる PlainValue 型です。
+ */
+export type $InferPlainValueData<TPlainValue> = TPlainValue extends PlainValue<infer TData, any> ? TData : never;
+/**
+ * PlainValue 型から入力データの型を抽出します。
+ *
+ * @template TPlainValue 対象となる PlainValue 型です。
+ */
+export type $InferPlainValueInput<TPlainValue> = TPlainValue extends PlainValue<any, infer TInput> ? TInput : never;
+/**
+ * StreamValue 型から内部のチャンクデータ型を抽出します。
+ *
+ * @template TStreamValue 対象となる StreamValue 型です。
+ */
+export type $InferStreamValueChunkData<TStreamValue> = TStreamValue extends StreamValue<infer TChunkData, any> ? TChunkData : never;
+/**
+ * StreamValue 型から入力チャンクデータの型を抽出します。
+ *
+ * @template TStreamValue 対象となる StreamValue 型です。
+ */
+export type $InferStreamValueChunkInput<TStreamValue> = TStreamValue extends StreamValue<any, infer TChunkInput> ? TChunkInput : never;
+/**
+ * スキーマ付きの値が扱うデータの種類です。
+ *
+ * - `"plain"`: プレーンな値のみを扱います。
+ * - `"stream"`: ストリーム形式の値のみを扱います。
+ * - `"any"`: プレーンな値とストリーム形式の値のどちらも扱います。
+ */
+export type ValueSchemaKind = "plain" | "stream" | "any";
+/**
+ * キーに対応する値のスキーマ情報です。
+ */
+export type ValueSchemaInfo = {
+    /**
+     * 扱うデータの種類です。
+     */
+    readonly kind: ValueSchemaKind;
+    /**
+     * データの検証に使用するスキーマです。
+     */
+    readonly schema: v.GenericSchema;
+};
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#value-types)
+ *
+ * プレーンな値のスキーマを定義します。
+ *
+ * @template TSchema スキーマの型です。
+ * @param schema 値の検証に使用する Valibot スキーマです。
+ * @returns プレーンな値であることを示す型情報を返します。
+ */
+export declare function PlainValue<const TSchema extends v.GenericSchema>(schema: TSchema): PlainValue<v.InferOutput<TSchema>, v.InferInput<TSchema>>;
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#value-types)
+ *
+ * ストリーム形式の値のスキーマを定義します。
+ *
+ * @template TSchema スキーマの型です。
+ * @param schema チャンクデータの検証に使用する Valibot スキーマです。
+ * @returns ストリーム形式の値であることを示す型情報を返します。
+ */
+export declare function StreamValue<const TSchema extends v.GenericSchema>(schema: TSchema): StreamValue<v.InferOutput<TSchema>, v.InferInput<TSchema>>;
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#value-types)
+ *
+ * プレーンな値とストリーム形式の値の両方で使えるスキーマを定義します。
+ *
+ * @template TSchema スキーマの型です。
+ * @param schema データとチャンクデータの検証に使用する Valibot スキーマです。
+ * @returns どちらの形式でも使える値であることを示す型情報を返します。
+ */
+export declare function Value<const TSchema extends v.GenericSchema>(schema: TSchema): Value<v.InferOutput<TSchema>, v.InferInput<TSchema>>;
+/**
+ * オブジェクト形式のスキーマ定義です。キーをそのままキーとして扱います。
+ */
+export type UniKvsSchemaRecord = {
+    readonly [key: string]: Value<any, any>;
+};
+/**
+ * 配列形式のスキーマ定義です。キーのスキーマと値のスキーマの組を並べます。
+ */
+export type UniKvsSchemaEntries = readonly (readonly [v.GenericSchema, Value<any, any>])[];
+/**
+ * `UniKvs.config()` の `schema` オプションに指定できるスキーマ定義です。
+ */
+export type UniKvsSchema = UniKvsSchemaRecord | UniKvsSchemaEntries;
+/**
+ * スキーマ定義からキーと値のマッピング型を推論します。
+ *
+ * @template TSchema 対象となるスキーマ定義の型です。
+ */
+export type $InferKeyValueMapping<TSchema extends UniKvsSchema> = TSchema extends readonly (readonly [v.GenericSchema, infer TValue extends Value<any, any>])[] ? {
+    readonly [key: string]: TValue;
+} : TSchema extends {
+    readonly [key: string]: Value<any, any>;
+} ? {
+    readonly [TKey in keyof TSchema]: TSchema[TKey];
+} : never;
+/**
+ * 検証済みのオブジェクト形式のスキーマ定義です。
+ */
+export type UniKvsSchemaInfoRecord = {
+    readonly [key: string]: ValueSchemaInfo;
+};
+/**
+ * 検証済みの配列形式のスキーマ定義です。
+ */
+export type UniKvsSchemaInfoEntries = readonly (readonly [v.GenericSchema, ValueSchemaInfo])[];
+/**
+ * 検証済みのスキーマ定義です。
+ */
+export type UniKvsSchemaInfo = UniKvsSchemaInfoRecord | UniKvsSchemaInfoEntries;
+/**
+ * `schema` オプションの検証に使用するスキーマです。
+ */
+export declare const UniKvsSchemaSchema: import("valibot").UnionSchema<[import("@tai-kun/valibot-extra-lab").ArraySchema<import("@tai-kun/valibot-extra-lab").TupleSchema<[import("valibot").CustomSchema<v.GenericSchema, undefined>, import("valibot").CustomSchema<ValueSchemaInfo, undefined>], undefined>, undefined>, import("@tai-kun/valibot-extra-lab").RecordSchema<import("valibot").StringSchema<undefined>, import("valibot").CustomSchema<ValueSchemaInfo, undefined>, undefined>], undefined>;
+/**
+ * キーに対応する値のスキーマ情報を解決するインターフェースです。
+ */
+export interface IValueSchemaResolver {
+    /**
+     * キーに対応する値のスキーマ情報を返します。
+     *
+     * @param key 解決するキーです。
+     * @returns 対応するスキーマ情報を返します。対応する定義がない場合は `undefined` を返します。
+     * @throws キーがどのキースキーマにも一致しない場合に `InvalidInputError` を投げます。
+     */
+    resolve(key: string): ValueSchemaInfo | undefined;
+}
+/**
+ * 検証済みのスキーマ定義からスキーマリゾルバーを生成します。
+ *
+ * @param schema 検証済みのスキーマ定義です。
+ * @returns スキーマリゾルバーを返します。
+ */
+export declare function createValueSchemaResolver(schema: UniKvsSchemaInfo): IValueSchemaResolver;
+export {};
+//# sourceMappingURL=_value-schemas.d.ts.map

package/dist/src/_value-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_value-schemas.d.ts","sourceRoot":"","sources":["../../src/_value-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,eAAe,CAAC;AASnC;;GAEG;AACH,OAAO,CAAC,MAAM,WAAW,EAAE,OAAO,MAAM,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,MAAM,UAAU,CAAC,KAAK,GAAG,GAAG,EAAE,MAAM,GAAG,KAAK,IAAI;IACpD,IAAI,EAAE,OAAO,WAAW;IACxB,IAAI,EAAE,KAAK;IACX,KAAK,EAAE,MAAM;CACd,CAAC;AAEF;;GAEG;AACH,OAAO,CAAC,MAAM,YAAY,EAAE,OAAO,MAAM,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,MAAM,WAAW,CAAC,UAAU,GAAG,GAAG,EAAE,WAAW,GAAG,UAAU,IAAI;IACpE,IAAI,EAAE,OAAO,YAAY;IACzB,SAAS,EAAE,UAAU;IACrB,UAAU,EAAE,WAAW;CACxB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,KAAK,CAAC,iBAAiB,GAAG,GAAG,EAAE,MAAM,GAAG,iBAAiB,IACjE,UAAU,CAAC,iBAAiB,EAAE,MAAM,CAAC,GACrC,WAAW,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;AAE3C;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,CAAC,WAAW,IAC1C,WAAW,SAAS,UAAU,CAAC,MAAM,KAAK,EAAE,GAAG,CAAC,GAAG,KAAK,GAAG,KAAK,CAAC;AAEnE;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,CAAC,WAAW,IAC3C,WAAW,SAAS,UAAU,CAAC,GAAG,EAAE,MAAM,MAAM,CAAC,GAAG,MAAM,GAAG,KAAK,CAAC;AAErE;;;;GAIG;AACH,MAAM,MAAM,0BAA0B,CAAC,YAAY,IACjD,YAAY,SAAS,WAAW,CAAC,MAAM,UAAU,EAAE,GAAG,CAAC,GAAG,UAAU,GAAG,KAAK,CAAC;AAE/E;;;;GAIG;AACH,MAAM,MAAM,2BAA2B,CAAC,YAAY,IAClD,YAAY,SAAS,WAAW,CAAC,GAAG,EAAE,MAAM,WAAW,CAAC,GAAG,WAAW,GAAG,KAAK,CAAC;AAejF;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAE/B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,aAAa,CAAC;CAClC,CAAC;AAyCF;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC,aAAa,EAC9D,MAAM,EAAE,OAAO,GACd,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAK3D;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC,aAAa,EAC/D,MAAM,EAAE,OAAO,GACd,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAK5D;AAED;;;;;;;;GAQG;AACH,wBAAgB,KAAK,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC,aAAa,EACzD,MAAM,EAAE,OAAO,GACd,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAKtD;AAQD;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;CAAE,CAAC;AAE7E;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,EAAE,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;AAE3F;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,kBAAkB,GAAG,mBAAmB,CAAC;AAEpE;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,CAAC,OAAO,SAAS,YAAY,IAC5D,OAAO,SAAS,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,EAAE,MAAM,MAAM,SAAS,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,GACzF;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GAClC,OAAO,SAAS;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;CAAE,GACzD;IAAE,QAAQ,EAAE,IAAI,IAAI,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAAE,GACnD,KAAK,CAAC;AAEd;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,eAAe,CAAA;CAAE,CAAC;AAEjF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC;AAE/F;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,sBAAsB,GAAG,uBAAuB,CAAC;AAEhF;;GAEG;AACH,eAAO,MAAM,kBAAkB,qcAQ7B,CAAC;AAQH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;OAMG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAAC;CACnD;AAuDD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,gBAAgB,GAAG,oBAAoB,CAMxF"}

package/dist/src/_value-schemas.js

@@ -0,0 +1,150 @@
+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 _RecordValueSchemaResolver_entries, _EntriesValueSchemaResolver_entries, _EntriesValueSchemaResolver_keySchema;
+import * as v from "./_valibot.js";
+import { InvalidInputError } from "./errors.js";
+// -------------------------------------------------------------------------------------------------
+//
+// 値のスキーマ
+//
+// -------------------------------------------------------------------------------------------------
+/**
+ * スキーマ付きの値であることを識別するためのブランドです。
+ *
+ * 同じライブラリーが複数読み込まれた環境でも認識できるようにグローバルシンボルを使用します。
+ */
+const VALUE_SCHEMA_BRAND = Symbol.for("unikvs.valueSchema");
+/**
+ * 値が Valibot のスキーマであるかどうかを判定します。
+ */
+function isGenericSchema(input) {
+    return (typeof input === "object" &&
+        input !== null &&
+        typeof input["~run"] === "function");
+}
+/**
+ * 値がスキーマ情報であるかどうかを判定します。
+ */
+function isValueSchemaInfo(input) {
+    return (typeof input === "object" &&
+        input !== null &&
+        input[VALUE_SCHEMA_BRAND] === true);
+}
+/**
+ * スキーマ情報を内部オブジェクトとして生成します。
+ */
+function createValueSchemaDescriptor(kind, schema) {
+    return { [VALUE_SCHEMA_BRAND]: true, kind, schema };
+}
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#value-types)
+ *
+ * プレーンな値のスキーマを定義します。
+ *
+ * @template TSchema スキーマの型です。
+ * @param schema 値の検証に使用する Valibot スキーマです。
+ * @returns プレーンな値であることを示す型情報を返します。
+ */
+export function PlainValue(schema) {
+    return createValueSchemaDescriptor("plain", schema);
+}
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#value-types)
+ *
+ * ストリーム形式の値のスキーマを定義します。
+ *
+ * @template TSchema スキーマの型です。
+ * @param schema チャンクデータの検証に使用する Valibot スキーマです。
+ * @returns ストリーム形式の値であることを示す型情報を返します。
+ */
+export function StreamValue(schema) {
+    return createValueSchemaDescriptor("stream", schema);
+}
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#value-types)
+ *
+ * プレーンな値とストリーム形式の値の両方で使えるスキーマを定義します。
+ *
+ * @template TSchema スキーマの型です。
+ * @param schema データとチャンクデータの検証に使用する Valibot スキーマです。
+ * @returns どちらの形式でも使える値であることを示す型情報を返します。
+ */
+export function Value(schema) {
+    return createValueSchemaDescriptor("any", schema);
+}
+/**
+ * `schema` オプションの検証に使用するスキーマです。
+ */
+export const UniKvsSchemaSchema = v.union([
+    v.array(v.tuple([
+        v.custom(isGenericSchema),
+        v.custom(isValueSchemaInfo),
+    ])),
+    v.record(v.string(), v.custom(isValueSchemaInfo)),
+]);
+/**
+ * オブジェクト形式のスキーマ定義からスキーマ情報を解決します。
+ */
+class RecordValueSchemaResolver {
+    constructor(entries) {
+        _RecordValueSchemaResolver_entries.set(this, void 0);
+        __classPrivateFieldSet(this, _RecordValueSchemaResolver_entries, new Map(Object.entries(entries)), "f");
+    }
+    resolve(key) {
+        return __classPrivateFieldGet(this, _RecordValueSchemaResolver_entries, "f").get(key);
+    }
+}
+_RecordValueSchemaResolver_entries = new WeakMap();
+/**
+ * 配列形式のスキーマ定義からスキーマ情報を解決します。
+ *
+ * キースキーマに最初に一致した定義を採用します。
+ */
+class EntriesValueSchemaResolver {
+    constructor(entries) {
+        _EntriesValueSchemaResolver_entries.set(this, void 0);
+        _EntriesValueSchemaResolver_keySchema.set(this, void 0);
+        __classPrivateFieldSet(this, _EntriesValueSchemaResolver_entries, entries, "f");
+        __classPrivateFieldSet(this, _EntriesValueSchemaResolver_keySchema, entries.length > 0 ? v.union(entries.map(([keySchema]) => keySchema)) : undefined, "f");
+    }
+    resolve(key) {
+        for (const [keySchema, valueSchema] of __classPrivateFieldGet(this, _EntriesValueSchemaResolver_entries, "f")) {
+            const result = v.safeParse(keySchema, key);
+            if (result.success) {
+                return valueSchema;
+            }
+        }
+        if (__classPrivateFieldGet(this, _EntriesValueSchemaResolver_keySchema, "f")) {
+            const result = v.safeParse(__classPrivateFieldGet(this, _EntriesValueSchemaResolver_keySchema, "f"), key);
+            if (!result.success) {
+                throw new InvalidInputError({
+                    value: key,
+                    issues: result.issues,
+                });
+            }
+        }
+        return undefined;
+    }
+}
+_EntriesValueSchemaResolver_entries = new WeakMap(), _EntriesValueSchemaResolver_keySchema = new WeakMap();
+/**
+ * 検証済みのスキーマ定義からスキーマリゾルバーを生成します。
+ *
+ * @param schema 検証済みのスキーマ定義です。
+ * @returns スキーマリゾルバーを返します。
+ */
+export function createValueSchemaResolver(schema) {
+    if (Array.isArray(schema)) {
+        return new EntriesValueSchemaResolver(schema);
+    }
+    return new RecordValueSchemaResolver(schema);
+}

package/dist/src/errors.d.ts

@@ -1,115 +1,306 @@
 import { ErrorBase, type ErrorOptions, type ErrorMeta, type IStorage } from "@unikvs/core";
 import type { BaseIssue } from "valibot";
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
 export declare class InvalidUsageErrorBase<TMeta extends ErrorMeta | undefined = ErrorMeta | undefined> extends ErrorBase<TMeta> {
 }
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
 export type Issue = BaseIssue<unknown>;
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
 export type InvalidInputErrorMeta = {
+    /**
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+     */
     readonly input: unknown;
+    /**
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+     */
     readonly issues: readonly [Issue, ...Issue[]];
 };
-export type InvalidInputErrorArgs = {
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
+export type InvalidInputErrorArgs = ErrorOptions & {
+    /**
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+     */
     readonly value: unknown;
+    /**
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+     */
     readonly issues: readonly [Issue, ...Issue[]];
 };
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
 export declare class InvalidInputError extends InvalidUsageErrorBase<InvalidInputErrorMeta> {
-    constructor(args: InvalidInputErrorArgs, options?: ErrorOptions);
+    constructor(args: InvalidInputErrorArgs);
 }
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
 export type InvalidOutputErrorMeta = {
+    /**
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+     */
     readonly output: unknown;
+    /**
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+     */
     readonly issues: readonly [Issue, ...Issue[]];
 };
-export type InvalidOutputErrorArgs = {
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
+export type InvalidOutputErrorArgs = ErrorOptions & {
+    /**
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+     */
     readonly value: unknown;
+    /**
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+     */
     readonly issues: readonly [Issue, ...Issue[]];
 };
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
 export declare class InvalidOutputError extends InvalidUsageErrorBase<InvalidOutputErrorMeta> {
-    constructor(args: InvalidOutputErrorArgs, options?: ErrorOptions);
+    constructor(args: InvalidOutputErrorArgs);
 }
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
 export declare class UniKvsIsOpenError extends ErrorBase<undefined> {
     constructor(options?: ErrorOptions);
 }
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
 export declare class UniKvsIsNotOpenError extends ErrorBase<undefined> {
     constructor(options?: ErrorOptions);
 }
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
 export type KeyNotFoundErrorMeta = {
+    /**
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+     */
     readonly key: IStorage.Key;
 };
-export type KeyNotFoundErrorArgs = KeyNotFoundErrorMeta;
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
+export type KeyNotFoundErrorArgs = ErrorOptions & KeyNotFoundErrorMeta;
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
 export declare class KeyNotFoundError extends ErrorBase<KeyNotFoundErrorMeta> {
-    constructor(args: KeyNotFoundErrorArgs, options?: ErrorOptions);
+    constructor(args: KeyNotFoundErrorArgs);
 }
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
 export type StorageIsNotOpenErrorMeta = {
+    /**
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+     */
     readonly name: string;
 };
-export type StorageIsNotOpenErrorArgs = StorageIsNotOpenErrorMeta;
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
+export type StorageIsNotOpenErrorArgs = ErrorOptions & StorageIsNotOpenErrorMeta;
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
 export declare class StorageIsNotOpenError extends ErrorBase<StorageIsNotOpenErrorMeta> {
-    constructor(args: StorageIsNotOpenErrorArgs, options?: ErrorOptions);
+    constructor(args: StorageIsNotOpenErrorArgs);
 }
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
 export type WritableStreamNotSupportedErrorMeta = {
+    /**
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+     */
     readonly name: string;
 };
-export type WritableStreamNotSupportedErrorArgs = WritableStreamNotSupportedErrorMeta;
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
+export type WritableStreamNotSupportedErrorArgs = ErrorOptions & WritableStreamNotSupportedErrorMeta;
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
 export declare class WritableStreamNotSupportedError extends ErrorBase<WritableStreamNotSupportedErrorMeta> {
-    constructor(args: WritableStreamNotSupportedErrorArgs, options?: ErrorOptions);
+    constructor(args: WritableStreamNotSupportedErrorArgs);
 }
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
 export type ReadableStreamNotSupportedErrorMeta = {
+    /**
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+     */
     readonly name: string;
 };
-export type ReadableStreamNotSupportedErrorArgs = ReadableStreamNotSupportedErrorMeta;
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
+export type ReadableStreamNotSupportedErrorArgs = ErrorOptions & ReadableStreamNotSupportedErrorMeta;
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
 export declare class ReadableStreamNotSupportedError extends ErrorBase<ReadableStreamNotSupportedErrorMeta> {
-    constructor(args: ReadableStreamNotSupportedErrorArgs, options?: ErrorOptions);
+    constructor(args: ReadableStreamNotSupportedErrorArgs);
 }
+/**
+ * MultipartWriteNotSupportedError に付与されるメタデータです。
+ */
 export type MultipartWriteNotSupportedErrorMeta = {
+    /**
+     * 対象のストレージの名前です。
+     */
     readonly name: string;
 };
-export type MultipartWriteNotSupportedErrorArgs = MultipartWriteNotSupportedErrorMeta;
+/**
+ * MultipartWriteNotSupportedError のコンストラクター引数です。
+ *
+ * エラーの追加情報 (`cause`) も含みます。
+ */
+export type MultipartWriteNotSupportedErrorArgs = ErrorOptions & MultipartWriteNotSupportedErrorMeta;
+/**
+ * ストレージがマルチパート書き込みをサポートしていない場合に投げられるエラーです。
+ */
 export declare class MultipartWriteNotSupportedError extends ErrorBase<MultipartWriteNotSupportedErrorMeta> {
-    constructor(args: MultipartWriteNotSupportedErrorArgs, options?: ErrorOptions);
+    constructor(args: MultipartWriteNotSupportedErrorArgs);
 }
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
 export type TransformerIsNotOpenErrorMeta = {
+    /**
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+     */
     readonly name: string;
 };
-export type TransformerIsNotOpenErrorArgs = TransformerIsNotOpenErrorMeta;
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
+export type TransformerIsNotOpenErrorArgs = ErrorOptions & TransformerIsNotOpenErrorMeta;
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
 export declare class TransformerIsNotOpenError extends ErrorBase<TransformerIsNotOpenErrorMeta> {
-    constructor(args: TransformerIsNotOpenErrorArgs, options?: ErrorOptions);
+    constructor(args: TransformerIsNotOpenErrorArgs);
 }
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
 export type EncodableStreamNotSupportedErrorMeta = {
+    /**
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+     */
     readonly name: string;
 };
-export type EncodableStreamNotSupportedErrorArgs = EncodableStreamNotSupportedErrorMeta;
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
+export type EncodableStreamNotSupportedErrorArgs = ErrorOptions & EncodableStreamNotSupportedErrorMeta;
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
 export declare class EncodableStreamNotSupportedError extends ErrorBase<EncodableStreamNotSupportedErrorMeta> {
-    constructor(args: EncodableStreamNotSupportedErrorArgs, options?: ErrorOptions);
+    constructor(args: EncodableStreamNotSupportedErrorArgs);
 }
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
 export type DecodableStreamNotSupportedErrorMeta = {
+    /**
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+     */
     readonly name: string;
 };
-export type DecodableStreamNotSupportedErrorArgs = DecodableStreamNotSupportedErrorMeta;
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
+export type DecodableStreamNotSupportedErrorArgs = ErrorOptions & DecodableStreamNotSupportedErrorMeta;
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
 export declare class DecodableStreamNotSupportedError extends ErrorBase<DecodableStreamNotSupportedErrorMeta> {
-    constructor(args: DecodableStreamNotSupportedErrorArgs, options?: ErrorOptions);
+    constructor(args: DecodableStreamNotSupportedErrorArgs);
 }
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
 export type PluginOperationAggregateErrorMeta = {
+    /**
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+     */
     readonly plugin: "plugin" | "storage" | "transformer";
-    readonly action: "open" | "close" | "write" | "delete" | "clear";
+    /**
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+     */
+    readonly action: "open" | "close" | "write" | "read" | "delete" | "clear";
+    /**
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+     */
     readonly errors: readonly {
+        /**
+         * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+         */
         readonly plugin: "storage" | "transformer";
+        /**
+         * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+         */
         readonly reason: unknown;
     }[];
 };
-export type PluginOperationAggregateErrorArgs = {
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
+export type PluginOperationAggregateErrorArgs = ErrorOptions & {
+    /**
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+     */
     readonly plugin?: "storage" | "transformer";
-    readonly action: "open" | "close" | "write" | "delete" | "clear";
+    /**
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+     */
+    readonly action: "open" | "close" | "write" | "read" | "delete" | "clear";
+    /**
+     * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+     */
     readonly errors: readonly {
+        /**
+         * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+         */
         readonly plugin?: "storage" | "transformer";
+        /**
+         * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+         */
         readonly reason: unknown;
     }[];
 };
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
 export declare class PluginOperationAggregateError extends ErrorBase<PluginOperationAggregateErrorMeta> {
-    constructor(args: PluginOperationAggregateErrorArgs, options?: ErrorOptions);
+    constructor(args: PluginOperationAggregateErrorArgs);
 }
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/unikvs#errors)
+ */
 export declare class MissingStorageError extends ErrorBase<undefined> {
     constructor(options?: ErrorOptions);
 }
-export declare class TransformerRegistrationError extends ErrorBase<undefined> {
-    constructor(options?: ErrorOptions);
-}
 //# sourceMappingURL=errors.d.ts.map