unikvs 0.0.16 → 0.0.17

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "unikvs",
-  "version": "0.0.16",
+  "version": "0.0.17",
   "description": "A modular and portable KVS client implemented in TypeScript.",
   "homepage": "https://tai-kun.github.io/unikvs/",
   "license": "MIT",
@@ -25,7 +25,7 @@
   },
   "dependencies": {
     "@tai-kun/valibot-extra-lab": "^0.0.5",
-    "@unikvs/core": "0.0.16",
+    "@unikvs/core": "0.0.17",
     "abort-signal-utils": "^0.0.6",
     "asyncmux": "^0.0.12",
     "call-fn-once": "^0.0.12",
@@ -35,14 +35,14 @@
   "devDependencies": {
     "@babel/plugin-proposal-decorators": "^8.0.2",
     "@rolldown/plugin-babel": "^0.2.4",
-    "@unikvs/allow-repair": "0.0.16",
-    "@unikvs/checksum": "0.0.16",
-    "@unikvs/compression": "0.0.16",
-    "@unikvs/fs.node": "0.0.16",
-    "@unikvs/memory": "0.0.16",
-    "@unikvs/opfs": "0.0.16",
+    "@unikvs/allow-repair": "0.0.17",
+    "@unikvs/checksum": "0.0.17",
+    "@unikvs/compression": "0.0.17",
+    "@unikvs/fs.node": "0.0.17",
+    "@unikvs/memory": "0.0.17",
+    "@unikvs/opfs": "0.0.17",
     "@unikvs/testing": "0.0.0",
-    "@unikvs/utils": "0.0.16",
+    "@unikvs/utils": "0.0.17",
     "@vitest/browser-playwright": "5.0.5",
     "@vitest/coverage-istanbul": "5.0.5",
     "@vitest/coverage-v8": "5.0.5",

package/src/_contexts.ts

@@ -15,9 +15,9 @@ import {
   type IStreamContext,
   type IReadableStream,
   type IPipelineContext,
+  type ITransferContext,
   type ILifecycleContext,
   type ITransformContext,
-  type VariablesSnapshot,
   type IKeyedActionContext,
   type IDecodeStreamContext,
   type IEncodeStreamContext,
@@ -119,14 +119,9 @@ type PipelineContextInit = {
  */
 class PipelineContext implements IPipelineContext {
   /**
-   * 変数のマップです。共有ストアの参照である場合があります。
+   * 実行時変数のストアです。共有する場合は参照を共有します。
    */
-  readonly #data: Map<string, unknown>;
-
-  /**
-   * 読み取り専用の変数名の集合です。共有ストアの参照である場合があります。
-   */
-  readonly #readonly: Set<string>;
+  readonly #store: VariablesStore;
 
   /**
    * コンテキストを作成します。
@@ -136,22 +131,25 @@ class PipelineContext implements IPipelineContext {
   public constructor(init: PipelineContextInit) {
     const { store } = init;
 
-    if (store) {
-      // 共有ストアを参照し、下流の変更が上流に見えるようにします。
-      this.#data = store.data;
-      this.#readonly = store.readonly;
-    } else {
-      this.#data = new Map();
-      this.#readonly = new Set();
-    }
+    // 共有ストアを参照し、下流の変更が上流に見えるようにします。
+    this.#store = store ?? createVariablesStore();
 
     const vars = normalizeVariablesInit(init.vars);
 
     for (const [name, value] of vars) {
-      this.#data.set(name, value);
+      this.#store.data.set(name, value);
     }
   }
 
+  /**
+   * 共有する実行時変数のストアを取得します。
+   *
+   * @returns 実行時変数のストアを返します。
+   */
+  public get store(): VariablesStore {
+    return this.#store;
+  }
+
   /**
    * 変数の値を読み取ります。
    *
@@ -160,7 +158,7 @@ class PipelineContext implements IPipelineContext {
    * @returns 変数の値を返します。
    */
   public get(name: string): unknown {
-    return this.#data.get(name);
+    return this.#store.data.get(name);
   }
 
   /**
@@ -172,11 +170,11 @@ class PipelineContext implements IPipelineContext {
    * @returns 自身を返します。
    */
   public set(name: string, value: unknown): this {
-    if (this.#readonly.has(name)) {
+    if (this.#store.readonly.has(name)) {
       throw new ReadonlyVariableError({ name });
     }
 
-    this.#data.set(name, value);
+    this.#store.data.set(name, value);
 
     return this;
   }
@@ -190,24 +188,28 @@ class PipelineContext implements IPipelineContext {
    * @returns 自身を返します。
    */
   public setReadonly(name: string, value: unknown): this {
-    if (this.#readonly.has(name)) {
+    if (this.#store.readonly.has(name)) {
       throw new ReadonlyVariableError({ name });
     }
 
-    this.#data.set(name, value);
-    this.#readonly.add(name);
+    this.#store.data.set(name, value);
+    this.#store.readonly.add(name);
 
     return this;
   }
+}
 
-  /**
-   * 現在の実行時変数の浅いコピーを作成します。
-   *
-   * @returns 実行時変数のスナップショットを返します。
-   */
-  public snapshot(): VariablesSnapshot {
-    return new Map(this.#data);
-  }
+/**
+ * コンテキストが共有する実行時変数のストアを取得します。
+ *
+ * 外部実装のコンテキストは共有ストアを公開しないため、独立したストアを返します。
+ *
+ * @param context 対象のコンテキストです。
+ *
+ * @returns 実行時変数のストアを返します。
+ */
+export function getVariablesStore(context: IPipelineContext): VariablesStore {
+  return context instanceof PipelineContext ? context.store : createVariablesStore();
 }
 
 /**
@@ -748,7 +750,10 @@ type TransferContextInit<TAction extends "copy" | "move"> = KeyedActionContextIn
 /**
  * コピー・移動で共通のコンテキストです。
  */
-class TransferContext<TAction extends "copy" | "move"> extends KeyedActionContext<TAction> {
+class TransferContext<TAction extends "copy" | "move">
+  extends KeyedActionContext<TAction>
+  implements ITransferContext
+{
   /**
    * コピー先または移動先のキーです。
    */

package/src/_storage.ts

@@ -2,6 +2,7 @@ import type { IStorage, IReadableStream, IWritableStream } from "@unikvs/core";
 import { asyncmux } from "asyncmux";
 import { callFnOnce } from "call-fn-once";
 
+import { CopyContext, MoveContext, getVariablesStore } from "./_contexts.js";
 import { PluginLifecycle } from "./_plugin-lifecycle.js";
 import { ReadableStreamSchema, WritableStreamSchema } from "./_streams.schemas.js";
 import * as v from "./_valibot.js";
@@ -167,6 +168,27 @@ export default class UniKvsStorage {
       throw new StorageIsNotOpenError({ name: this.name });
     }
 
+    if (this.#io.copy === undefined) {
+      // copy 操作に伴う読み取りであることを伝えるために、必ず CopyContext を渡します。
+      const data = await this.#io.read(c);
+
+      if (c.key !== c.destinationKey) {
+        // copy 操作に伴う書き込みであることを伝えるために、必ず CopyContext を渡します。
+        // 書き込み先がコピー先になるように、キーを差し替えたコンテキストを作成します。
+        await this.#io.write(
+          new CopyContext({
+            key: c.destinationKey,
+            store: getVariablesStore(c),
+            signal: c.signal,
+            destinationKey: c.destinationKey,
+          }),
+          data,
+        );
+      }
+
+      return;
+    }
+
     await this.#io.copy(c);
   }
 
@@ -180,6 +202,38 @@ export default class UniKvsStorage {
       throw new StorageIsNotOpenError({ name: this.name });
     }
 
+    if (this.#io.move === undefined) {
+      if (c.key === c.destinationKey) {
+        // move 操作に伴う読み取りであることを伝えるために、必ず MoveContext を渡します。
+        await this.#io.read(c);
+
+        return;
+      }
+
+      if (this.#io.copy === undefined) {
+        const data = await this.#io.read(c);
+        // move 操作に伴う書き込みであることを伝えるために、必ず MoveContext を渡します。
+        // 書き込み先が移動先になるように、キーを差し替えたコンテキストを作成します。
+        await this.#io.write(
+          new MoveContext({
+            key: c.destinationKey,
+            store: getVariablesStore(c),
+            signal: c.signal,
+            destinationKey: c.destinationKey,
+          }),
+          data,
+        );
+      } else {
+        // move 操作に伴う複製であることを伝えるために、必ず MoveContext を渡します。
+        await this.#io.copy(c);
+      }
+
+      // move 操作に伴う削除であることを伝えるために、必ず MoveContext を渡します。
+      await this.#io.delete(c);
+
+      return;
+    }
+
     await this.#io.move(c);
   }