event-store-adapter-js 5.0.0 → 5.0.1

package/README.ja.md

@@ -62,7 +62,7 @@ headがなければ `getLatestSnapshotById` は `undefined` を返します。he
 
 ## DynamoDB
 
-[DATABASE_SCHEMA.ja.md](docs/DATABASE_SCHEMA.ja.md) に従い、3表と履歴GSIを作成してからストアを生成します。ライブラリは3表の共通設定項目を作成・照合します。
+[DATABASE_SCHEMA.ja.md](docs/DATABASE_SCHEMA.ja.md) に従い、3表と履歴GSIを作成してからストアを生成します。ライブラリは3表の共通設定項目を作成・照合します。3 つの表は同じリージョンに置き、書き込みもそのリージョンからだけ行ってください。グローバルテーブル（複数リージョンのレプリカ）は範囲外です。
 
 ```typescript
 const opened = await EventStore.createDynamoDB({
@@ -81,7 +81,7 @@ AWSクライアントは呼び出し側で管理します。snapshot書き込み
 
 既定の `PayloadSerializer.json()` はJSON値だけを扱います。任意の同期 `PayloadSerializer<P>` は `serialize(payload): Uint8Array` と `deserialize(bytes, manifest): P` を実装します。payloadだけを直列化し、クラスやbrandは `deserialize` で復元してください。実例の [domain serializer](../examples/src/domain/user-account-serializers.ts) を参照できます。
 
-storageを省略したMemory生成は独立します。共有する場合は `MemoryStorage.create()` の同じ値を複数のfactoryへ渡し、保持設定もstorageに指定します。
+メモリの保存先は単一プロセスのメモリだけを使います。ファイルへの保存、再起動後の回復、プロセス間の共有はしません。storageを省略したMemory生成は独立します。共有する場合は `MemoryStorage.create()` の同じ値を複数のfactoryへ渡し、保持設定もstorageに指定します。
 
 ```typescript
 const storage = unwrap(MemoryStorage.create({ retention: { count: 3 } }));

package/README.md

@@ -62,7 +62,7 @@ Both factories and all four operations return `Result`. DynamoDB creation is asy
 
 ## DynamoDB
 
-Create the three tables and history GSI described in [DATABASE_SCHEMA.md](docs/DATABASE_SCHEMA.md) before opening the store. The library creates or verifies their shared configuration items.
+Create the three tables and history GSI described in [DATABASE_SCHEMA.md](docs/DATABASE_SCHEMA.md) before opening the store. The library creates or verifies their shared configuration items. Keep the three tables in one Region and write to them only from that Region. Global tables (multi-Region replicas) are not supported.
 
 ```typescript
 const opened = await EventStore.createDynamoDB({
@@ -81,7 +81,7 @@ The caller owns the AWS client. Snapshot retention runs after a successful snaps
 
 The default `PayloadSerializer.json()` handles JSON values only. A custom synchronous `PayloadSerializer<P>` implements `serialize(payload): Uint8Array` and `deserialize(bytes, manifest): P`. Serialize the payload alone and restore domain classes or brands in `deserialize`. See the [domain serializers](../examples/src/domain/user-account-serializers.ts) in the runnable examples.
 
-Memory creation without a storage uses isolated storage. To share records, pass the same value returned by `MemoryStorage.create()` to multiple factories. Configure retention on that storage:
+The memory storage lives in a single process. It does not persist to files, survive restarts, or share data across processes. Memory creation without a storage uses isolated storage. To share records, pass the same value returned by `MemoryStorage.create()` to multiple factories. Configure retention on that storage:
 
 ```typescript
 const storage = unwrap(MemoryStorage.create({ retention: { count: 3 } }));

package/dist/internal/memory-event-store.js

@@ -17,6 +17,13 @@ const event_store_input_validation_1 = require("./event-store-input-validation")
 const memory_storage_records_1 = require("./memory-storage-records");
 const seq_nr_validation_1 = require("./seq-nr-validation");
 const validated_event_store_1 = require("./validated-event-store");
+const knownSettings = new Set([
+    "storage",
+    "eventSerializer",
+    "snapshotSerializer",
+    "onRetentionFailure",
+    "logger",
+]);
 /** 実Storageと保持処理に接続した4操作を返す内部入口。 */
 function createMemoryEventStoreInternal(input, hooks) {
     const settings = (0, event_store_input_validation_1.validateEventStoreInput)(input);
@@ -30,6 +37,19 @@ function createMemoryEventStoreInternal(input, hooks) {
     catch (cause) {
         return result_1.Result.err(event_store_error_1.EventStoreError.configuration("storage", "storage could not be read", cause));
     }
+    let unknownSetting;
+    try {
+        unknownSetting = Object.keys(input !== null && input !== void 0 ? input : {}).find((key) => !knownSettings.has(key));
+    }
+    catch (cause) {
+        return result_1.Result.err(event_store_error_1.EventStoreError.configuration("input", "input settings could not be read", cause));
+    }
+    if (unknownSetting !== undefined) {
+        return result_1.Result.err(event_store_error_1.EventStoreError.configuration(unknownSetting, "unsupported Memory setting; retention belongs to MemoryStorage.create"));
+    }
+    if (inputStorage !== undefined && !(0, memory_storage_records_1.isRegisteredMemoryStorage)(inputStorage)) {
+        return result_1.Result.err(event_store_error_1.EventStoreError.configuration("storage", "storage must be created by MemoryStorage.create"));
+    }
     const storage = inputStorage === undefined
         ? memory_storage_1.MemoryStorage.create()
         : result_1.Result.ok(inputStorage);

package/dist/internal/memory-storage-records.d.ts

@@ -25,6 +25,7 @@ type AggregateRecords = Readonly<{
     history: readonly SnapshotEnvelope<Uint8Array>[];
 }>;
 export declare function createMemoryStorageRecords(configuration: Configuration): MemoryStorage;
+export declare function isRegisteredMemoryStorage(storage: unknown): boolean;
 /** 検査済みのキーと開始番号で、同じ排他制御内に全件の独立した記録を確保する。 */
 export declare function readMemoryStorageEvents(storage: MemoryStorage, aggregateId: string, seqNr: number, beforeRead?: () => void | Promise<void>): Promise<Result<StoredEvent[], EventStoreError>>;
 /** 検査済みのキーで、同じ排他制御内にヘッド番号と独立したsnapshotを確保する。 */

package/dist/internal/memory-storage-records.js

@@ -10,6 +10,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createMemoryStorageRecords = createMemoryStorageRecords;
+exports.isRegisteredMemoryStorage = isRegisteredMemoryStorage;
 exports.readMemoryStorageEvents = readMemoryStorageEvents;
 exports.readMemoryStorageLatestSnapshot = readMemoryStorageLatestSnapshot;
 exports.commitMemoryStorageRecords = commitMemoryStorageRecords;
@@ -30,6 +31,10 @@ function createMemoryStorageRecords(configuration) {
     });
     return storage;
 }
+function isRegisteredMemoryStorage(storage) {
+    // WeakMap.has は、オブジェクト以外の値には false を返す。
+    return states.has(storage);
+}
 function stateOf(storage) {
     const state = states.get(storage);
     if (state === undefined)

package/docs/DATABASE_SCHEMA.ja.md

@@ -1,6 +1,6 @@
 # DynamoDBのテーブル構成
 
-同一リージョンに独立した3表を作成します。表作成は呼び出し側が行い、`EventStore.createDynamoDB` が共通設定項目を照合します。表名と履歴index名は入力で指定します。
+同一リージョンに独立した3表を作成します。3 つの表は同じリージョンに置き、書き込みもそのリージョンからだけ行ってください。グローバルテーブル（複数リージョンのレプリカ）は範囲外です。表作成は呼び出し側が行い、`EventStore.createDynamoDB` が共通設定項目を照合します。表名と履歴index名は入力で指定します。
 
 | 表 | パーティションキー | ソートキー | Index / Streams |
 | --- | --- | --- | --- |

package/docs/DATABASE_SCHEMA.md

@@ -1,6 +1,6 @@
 # DynamoDB schema
 
-Use three distinct tables in one region. The caller creates them; `EventStore.createDynamoDB` verifies shared configuration records. Table names and the history index name come from its input.
+Use three distinct tables in one region. Keep the three tables in one Region and write to them only from that Region. Global tables (multi-Region replicas) are not supported. The caller creates them; `EventStore.createDynamoDB` verifies shared configuration records. Table names and the history index name come from its input.
 
 | Table | Partition key | Sort key | Index / Streams |
 | --- | --- | --- | --- |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "event-store-adapter-js",
-  "version": "5.0.0",
+  "version": "5.0.1",
   "description": "This library is designed to turn DynamoDB into an Event Store for Event Sourcing.",
   "engines": {
     "node": ">=24.0.0"