@exabugs/dynamodb-client 1.24.1 → 1.25.0

package/dist/server/utils/updateOperators.js

@@ -0,0 +1,76 @@
+/**
+ * 更新演算子（$set / $setOnInsert / $unset）の解釈
+ *
+ * 対応していない演算子（$inc など）を黙って無視しない。無視すると、呼び出し側は更新できたと
+ * 思い込む（$unset が無視され、項目を空にする操作が保存されない不具合が実際に起きた）。
+ */
+import { AppError, ErrorCode } from '../../shared/index.js';
+const SUPPORTED_OPERATORS = ['$set', '$setOnInsert', '$unset'];
+function invalid(message) {
+    return new AppError(ErrorCode.VALIDATION_ERROR, message, 400);
+}
+function asObject(value, operator) {
+    if (value === undefined)
+        return {};
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        throw invalid(`${operator} must be an object`);
+    }
+    return value;
+}
+/** $unset は、項目名の配列（`['a', 'b.c']`）と、MongoDB の形（`{ a: '' }`）の両方を受ける */
+function unsetFields(value) {
+    if (value === undefined)
+        return [];
+    if (Array.isArray(value)) {
+        if (!value.every((f) => typeof f === 'string')) {
+            throw invalid('$unset must be an array of field names or an object');
+        }
+        return value;
+    }
+    return Object.keys(asObject(value, '$unset'));
+}
+/**
+ * 更新のデータを解釈する
+ *
+ * - 演算子（`$` で始まるキー）が無ければ、全体を JSON Merge Patch として扱う
+ * - 演算子があれば、$set / $setOnInsert / $unset だけを受け付ける（ほかは 400）
+ *
+ * @throws AppError VALIDATION_ERROR（400）
+ */
+export function resolveUpdateOperators(data) {
+    const operators = Object.keys(data).filter((key) => key.startsWith('$'));
+    if (operators.length === 0) {
+        return { patch: data, setOnInsert: {}, returned: data };
+    }
+    const unsupported = operators.filter((op) => !SUPPORTED_OPERATORS.includes(op));
+    if (unsupported.length > 0) {
+        throw invalid(`Unsupported update operator: ${unsupported.join(', ')} (supported: ${SUPPORTED_OPERATORS.join(', ')})`);
+    }
+    const set = asObject(data.$set, '$set');
+    const patch = { ...set };
+    for (const field of unsetFields(data.$unset)) {
+        if (field in set) {
+            throw invalid(`Field "${field}" is in both $set and $unset`);
+        }
+        patch[field] = null;
+    }
+    return { patch, setOnInsert: asObject(data.$setOnInsert, '$setOnInsert'), returned: set };
+}
+/**
+ * フィルタから、新規作成（upsert）のレコードに入れる値を取り出す
+ *
+ * 等値の条件（`{ field: 値 }`）だけを使う。演算子つき（`{ field: { $gte: … } }`、`'field:$in'`）は、
+ * 値として保存できないので使わない。
+ */
+export function equalityFieldsOf(filter) {
+    const fields = {};
+    for (const [key, value] of Object.entries(filter)) {
+        if (key.includes(':') || key.startsWith('$'))
+            continue;
+        if (typeof value === 'object' && value !== null)
+            continue;
+        fields[key] = value;
+    }
+    return fields;
+}
+//# sourceMappingURL=updateOperators.js.map

package/dist/server/utils/updateOperators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateOperators.js","sourceRoot":"","sources":["../../../src/server/utils/updateOperators.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAC;AAW/D,SAAS,OAAO,CAAC,OAAe;IAC9B,OAAO,IAAI,QAAQ,CAAC,SAAS,CAAC,gBAAgB,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc,EAAE,QAAgB;IAChD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,OAAO,CAAC,GAAG,QAAQ,oBAAoB,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,KAAgC,CAAC;AAC1C,CAAC;AAED,sEAAsE;AACtE,SAAS,WAAW,CAAC,KAAc;IACjC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACnC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,EAAE,CAAC;YAC/C,MAAM,OAAO,CAAC,qDAAqD,CAAC,CAAC;QACvE,CAAC;QACD,OAAO,KAAiB,CAAC;IAC3B,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;AAChD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAA6B;IAClE,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IACzE,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1D,CAAC;IAED,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,mBAAmB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;IAChF,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,OAAO,CACX,gCAAgC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACxG,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxC,MAAM,KAAK,GAA4B,EAAE,GAAG,GAAG,EAAE,CAAC;IAClD,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7C,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;YACjB,MAAM,OAAO,CAAC,UAAU,KAAK,8BAA8B,CAAC,CAAC;QAC/D,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IACtB,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,cAAc,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;AAC5F,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAA+B;IAC9D,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QACvD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;YAAE,SAAS;QAC1D,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACtB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exabugs/dynamodb-client",
-  "version": "1.24.1",
+  "version": "1.25.0",
   "description": "DynamoDB Single-Table Client SDK with MongoDB-like API, Shadow Records, and Lambda implementation for serverless applications",
   "author": "exabugs",
   "license": "MIT",