@exabugs/dynamodb-client 1.3.20 → 1.3.22

package/CHANGELOG.md

@@ -7,6 +7,52 @@ 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
+
+- **Shadow仕様変更**: オブジェクト型はシャドウを作成しない仕様に変更
+  - `inferFieldType`: オブジェクト型に対して`null`を返すように変更
+  - `generateShadowRecords`: オブジェクト型を明示的にスキップ
+  - `formatFieldValue`: `object`型のケースを削除
+  - 理由: オブジェクトは構造が複雑で、シャドウキーとして適切でない
+  - 例外: GeoCoordinates型（`{latitude, longitude}`）は地理空間検索用にGeoHashシャドウを生成
+
 ## [1.3.20] - 2026-01-03
 
 ### Added

package/dist/server/handler.cjs

@@ -1,5 +1,5 @@
-// @exabugs/dynamodb-client v1.3.20
-// Built: 2026-01-02T23:49:33.625Z
+// @exabugs/dynamodb-client v1.3.22
+// Built: 2026-01-05T00:55:07.904Z
 "use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
@@ -29373,7 +29373,7 @@ function inferFieldType(value) {
     return "array";
   }
   if (typeof value === "object") {
-    return "object";
+    return null;
   }
   return null;
 }
@@ -29451,8 +29451,7 @@ function formatFieldValue2(type, value, config) {
       return formatDatetime2(value);
     case "boolean":
       return formatBoolean2(value);
-    case "array":
-    case "object": {
+    case "array": {
       const normalized = normalizeJson(value);
       const jsonStr = JSON.stringify(normalized);
       const maxBytes = config.stringMaxBytes * 2;
@@ -29480,17 +29479,19 @@ function generateShadowRecords(record, resourceName, config) {
     if (value === null || value === void 0) {
       continue;
     }
-    if (isGeoCoordinates(value)) {
-      const geohash = encodeGeoHash(
-        value.latitude,
-        value.longitude,
-        DEFAULT_GEOHASH_CONFIG.shadowPrecision
-      );
-      const sk2 = `${fieldName}#${geohash}#id#${record.id}`;
-      shadows.push({
-        PK: resourceName,
-        SK: sk2
-      });
+    if (typeof value === "object" && !Array.isArray(value)) {
+      if (isGeoCoordinates(value)) {
+        const geohash = encodeGeoHash(
+          value.latitude,
+          value.longitude,
+          DEFAULT_GEOHASH_CONFIG.shadowPrecision
+        );
+        const sk2 = `${fieldName}#${geohash}#id#${record.id}`;
+        shadows.push({
+          PK: resourceName,
+          SK: sk2
+        });
+      }
       continue;
     }
     const type = inferFieldType(value);
@@ -31503,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
@@ -31761,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);
@@ -31810,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
@@ -33458,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.20";
+      const version = "1.3.22";
       return createSuccessResponse({ version, timestamp: (/* @__PURE__ */ new Date()).toISOString() }, requestId);
     }
     if (event.requestContext.http.method !== "POST") {