@exabugs/dynamodb-client 1.3.21 → 1.3.22

package/CHANGELOG.md

@@ -7,6 +7,41 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.3.22] - 2026-01-05
+
+### Added
+
+- **$setOnInsert オペレータ**: MongoDB互換のupsert専用フィールド設定機能
+  - upsert時のinsert専用フィールドを指定可能（`$setOnInsert`）
+  - update時は`$setOnInsert`が無視され、`$set`のみが適用される
+  - `$set`と`$setOnInsert`で同じフィールドを指定した場合、`$set`が優先
+  - タイムスタンプ管理（`createdAt`は初回のみ、`updatedAt`は常に更新）が明確に
+  - MongoDB公式ドキュメントと完全互換
+
+### Changed
+
+- **UpdateOperators型**: `$setOnInsert?: Partial<T>` フィールドを追加
+- **handleUpsertCreate**: `$set`と`$setOnInsert`をマージして新規作成（`$set`が優先）
+- **handleUpsertUpdate**: `$setOnInsert`を無視して`$set`のみを適用
+
+### Documentation
+
+- **API.md**: `$setOnInsert`オペレータの詳細な説明を追加
+  - 動作仕様（insert時/update時の挙動）
+  - 使用例とコードスニペット
+  - MongoDB互換性の説明
+  - ユースケース（タイムスタンプ管理、デフォルト値設定、初期ステータス）
+
+### Technical
+
+- **テスト**: 包括的なテストカバレッジ（単体テスト・統合テスト）
+  - insert時に`$set`と`$setOnInsert`の両方を適用するテスト
+  - update時に`$setOnInsert`を無視するテスト
+  - `$set`が`$setOnInsert`より優先されるテスト
+  - `createdAt`の保持テスト
+  - シャドウレコード生成の確認
+  - 後方互換性テスト（従来のパッチ形式）
+
 ## [1.3.21] - 2026-01-04
 
 ### Changed

package/dist/server/handler.cjs

@@ -1,5 +1,5 @@
-// @exabugs/dynamodb-client v1.3.21
-// Built: 2026-01-04T11:18:43.181Z
+// @exabugs/dynamodb-client v1.3.22
+// Built: 2026-01-05T00:55:07.904Z
 "use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
@@ -31504,7 +31504,8 @@ async function handleUpdateMany(resource, params, requestId) {
       const existingData = item.data;
       const id = existingData.id;
       const oldShadowKeys = existingData.__shadowKeys || [];
-      const mergedData = applyJsonMergePatch(removeShadowKeys(existingData), patchData);
+      const actualPatchData = patchData.$set ? patchData.$set : patchData;
+      const mergedData = applyJsonMergePatch(removeShadowKeys(existingData), actualPatchData);
       const updatedData = addUpdateTimestamp({
         ...mergedData,
         id
@@ -31762,7 +31763,13 @@ async function handleUpdateOne(resource, params, requestId) {
 }
 __name(handleUpdateOne, "handleUpdateOne");
 async function handleUpsertCreate(resource, id, data2, requestId) {
-  const recordData = addCreateTimestamps({ ...data2, id });
+  const $set = data2.$set || {};
+  const $setOnInsert = data2.$setOnInsert || {};
+  const mergedData = {
+    ...$setOnInsert,
+    ...$set
+  };
+  const recordData = addCreateTimestamps({ ...mergedData, id });
   const shadowConfig = getShadowConfig();
   const shadowRecords = generateShadowRecords(recordData, resource, shadowConfig);
   const shadowKeys = shadowRecords.map((shadow) => shadow.SK);
@@ -31811,7 +31818,8 @@ __name(handleUpsertCreate, "handleUpsertCreate");
 async function handleUpsertUpdate(resource, id, existingItem, patchData, requestId) {
   const existingData = existingItem.data;
   const oldShadowKeys = existingData.__shadowKeys || [];
-  const mergedData = applyJsonMergePatch2(removeShadowKeys(existingData), patchData);
+  const actualPatchData = patchData.$set ? patchData.$set : patchData;
+  const mergedData = applyJsonMergePatch2(removeShadowKeys(existingData), actualPatchData);
   const updatedData = addUpdateTimestamp({
     ...mergedData,
     id
@@ -33459,7 +33467,7 @@ async function handler(event) {
       return createCorsResponse(HTTP_STATUS.OK);
     }
     if (event.requestContext.http.method === "GET" && event.requestContext.http.path === "/version") {
-      const version = "1.3.21";
+      const version = "1.3.22";
       return createSuccessResponse({ version, timestamp: (/* @__PURE__ */ new Date()).toISOString() }, requestId);
     }
     if (event.requestContext.http.method !== "POST") {