@exabugs/dynamodb-client 1.26.0 → 1.27.1

package/dist/server/utils/filter.d.ts

@@ -1,15 +1,14 @@
 /**
- * DynamoDB フィルター式生成ユーティリティ
- * FilterExpression の構築とシャドーレコード除外条件の生成
+ * フィルターのフィールド指定（`field:$op:type`）の解析
  *
- * 要件: 5.5, 7.1, 12.1-12.12
+ * 要件: 12.1-12.12
  */
 /**
  * フィルター演算子（MongoDB互換）
  *
  * 要件: 12.2
  */
-export type FilterOperator = '$eq' | '$ne' | '$lt' | '$lte' | '$gt' | '$gte' | '$in' | '$nin' | '$starts' | '$ends' | '$contains' | '$regex' | '$exists' | '$near';
+export type FilterOperator = '$eq' | '$ne' | '$lt' | '$lte' | '$gt' | '$gte' | '$in' | '$nin' | '$starts' | '$ends' | '$contains' | '$exists' | '$near';
 /**
  * フィルター型
  *
@@ -29,17 +28,6 @@ export interface ParsedFilterField {
     /** データ型 */
     type: FilterType;
 }
-/**
- * フィルター式の構築結果
- */
-export interface FilterExpressionResult {
-    /** FilterExpression 文字列 */
-    expression: string;
-    /** ExpressionAttributeNames マッピング */
-    names: Record<string, string>;
-    /** ExpressionAttributeValues マッピング */
-    values: Record<string, unknown>;
-}
 /**
  * フィルターフィールド名をパースする
  *
@@ -59,94 +47,4 @@ export interface FilterExpressionResult {
  * @throws Error - 構文エラーの場合
  */
 export declare function parseFilterField(fieldKey: string): ParsedFilterField;
-/**
- * シャドーレコードを除外するフィルター式を生成する
- *
- * シャドーレコードの特徴:
- * - SK に '#' が含まれる（例: "name#value#id#ULID"）
- * - 本体レコードは "id#ULID" 形式で '#' が1つのみ
- *
- * 除外条件:
- * - attribute_exists(data) AND NOT contains(SK, '#id#')
- *
- * @returns シャドー除外フィルター式
- */
-export declare function createShadowExclusionFilter(): FilterExpressionResult;
-/**
- * ユーザー指定のフィルター条件から FilterExpression を構築する
- *
- * 注意: この実装は基本的な等価比較のみをサポート
- * より複雑な条件（範囲検索、部分一致など）は将来の拡張として実装可能
- *
- * @param filter - フィルター条件（キー: フィールド名、値: 期待値）
- * @returns フィルター式の構築結果
- */
-export declare function buildFilterExpression(filter: Record<string, unknown>): FilterExpressionResult | null;
-/**
- * 複数のフィルター式を AND 条件で結合する
- *
- * @param filters - 結合するフィルター式の配列
- * @returns 結合されたフィルター式
- */
-export declare function combineFilters(filters: (FilterExpressionResult | null)[]): FilterExpressionResult | null;
-/**
- * フィルター式を DynamoDB Query/Scan パラメータに適用する
- *
- * @param params - DynamoDB Query/Scan パラメータ
- * @param filter - フィルター式
- * @returns フィルター式が適用されたパラメータ
- */
-export declare function applyFilterExpression<T extends Record<string, unknown>>(params: T, filter: FilterExpressionResult | null): T;
-/**
- * 型変換ヘルパー
- *
- * 要件: 12.5
- *
- * @param value - 変換する値
- * @param type - 変換先の型
- * @returns 変換後の値
- */
-export declare function convertType(value: unknown, type: FilterType): string | number | Date | boolean;
-/**
- * レコードが単一のフィルター条件に一致するかチェックする
- *
- * 要件: 12.2, 12.6, 12.8, 12.9
- *
- * @param record - チェック対象レコード
- * @param parsed - パース済みフィルター条件
- * @param value - フィルター値
- * @returns 一致する場合true
- */
-export declare function matchesFilter(record: Record<string, unknown>, parsed: ParsedFilterField, value: unknown): boolean;
-/**
- * レコードがすべてのフィルター条件に一致するかチェックする（AND条件）
- *
- * 要件: 12.9
- *
- * @param record - チェック対象レコード
- * @param parsedFilters - パース済みフィルター条件の配列
- * @returns すべての条件に一致する場合true
- */
-export declare function matchesAllFilters(record: Record<string, unknown>, parsedFilters: Array<{
-    parsed: ParsedFilterField;
-    value: unknown;
-}>): boolean;
-/**
- * Query最適化が可能かチェックする
- *
- * ソートフィールドと一致し、Query可能な演算子を持つフィルター条件を検出する
- *
- * 要件: 12.7
- *
- * @param sortField - ソート対象フィールド
- * @param parsedFilters - パース済みフィルター条件
- * @returns 最適化可能なフィルター条件（なければnull）
- */
-export declare function findOptimizableFilter(sortField: string, parsedFilters: Array<{
-    parsed: ParsedFilterField;
-    value: unknown;
-}>): {
-    parsed: ParsedFilterField;
-    value: unknown;
-} | null;
 //# sourceMappingURL=filter.d.ts.map

package/dist/server/utils/filter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../../src/server/utils/filter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,MAAM,MAAM,cAAc,GACtB,KAAK,GACL,KAAK,GACL,KAAK,GACL,MAAM,GACN,KAAK,GACL,MAAM,GACN,KAAK,GACL,MAAM,GACN,SAAS,GACT,OAAO,GACP,WAAW,GACX,QAAQ,GACR,SAAS,GACT,OAAO,CAAC;AAEZ;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAElE;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,gBAAgB;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU;IACV,QAAQ,EAAE,cAAc,CAAC;IACzB,WAAW;IACX,IAAI,EAAE,UAAU,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAiCpE;AA+BD;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,IAAI,sBAAsB,CAWpE;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,sBAAsB,GAAG,IAAI,CA4B/B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,CAAC,sBAAsB,GAAG,IAAI,CAAC,EAAE,GACzC,sBAAsB,GAAG,IAAI,CA6B/B;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrE,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,sBAAsB,GAAG,IAAI,GACpC,CAAC,CAiBH;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,CAe9F;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,OAAO,GACb,OAAO,CAqCT;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,aAAa,EAAE,KAAK,CAAC;IAAE,MAAM,EAAE,iBAAiB,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,GAClE,OAAO,CAET;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,KAAK,CAAC;IAAE,MAAM,EAAE,iBAAiB,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,GAClE;IAAE,MAAM,EAAE,iBAAiB,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAUtD"}
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../../src/server/utils/filter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,MAAM,MAAM,cAAc,GACtB,KAAK,GACL,KAAK,GACL,KAAK,GACL,MAAM,GACN,KAAK,GACL,MAAM,GACN,KAAK,GACL,MAAM,GACN,SAAS,GACT,OAAO,GACP,WAAW,GACX,SAAS,GACT,OAAO,CAAC;AAEZ;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAElE;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,gBAAgB;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU;IACV,QAAQ,EAAE,cAAc,CAAC;IACzB,WAAW;IACX,IAAI,EAAE,UAAU,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CA6BpE"}

package/dist/server/utils/filter.js

@@ -1,8 +1,7 @@
 /**
- * DynamoDB フィルター式生成ユーティリティ
- * FilterExpression の構築とシャドーレコード除外条件の生成
+ * フィルターのフィールド指定（`field:$op:type`）の解析
  *
- * 要件: 5.5, 7.1, 12.1-12.12
+ * 要件: 12.1-12.12
  */
 /**
  * フィルターフィールド名をパースする
@@ -30,19 +29,15 @@ export function parseFilterField(fieldKey) {
     }
     if (parts.length === 2) {
         // "priority:$gte" → { field: "priority", operator: "$gte", type: "string" }
+        assertSupportedOperator(parts[1]);
         const operator = parts[1];
-        if (!isValidOperator(operator)) {
-            throw new Error(`Invalid filter operator: ${parts[1]}`);
-        }
         return { field: parts[0], operator, type: 'string' };
     }
     if (parts.length === 3) {
         // "priority:$gte:number" → { field: "priority", operator: "$gte", type: "number" }
+        assertSupportedOperator(parts[1]);
         const operator = parts[1];
         const type = parts[2];
-        if (!isValidOperator(operator)) {
-            throw new Error(`Invalid filter operator: ${parts[1]}`);
-        }
         if (!isValidType(type)) {
             throw new Error(`Invalid filter type: ${parts[2]}`);
         }
@@ -66,226 +61,27 @@ function isValidOperator(operator) {
         '$starts',
         '$ends',
         '$contains',
-        '$regex',
         '$exists',
         '$near',
     ].includes(operator);
 }
 /**
- * 型が有効かチェックする
- */
-function isValidType(type) {
-    return ['string', 'number', 'date', 'boolean'].includes(type);
-}
-/**
- * シャドーレコードを除外するフィルター式を生成する
- *
- * シャドーレコードの特徴:
- * - SK に '#' が含まれる（例: "name#value#id#ULID"）
- * - 本体レコードは "id#ULID" 形式で '#' が1つのみ
- *
- * 除外条件:
- * - attribute_exists(data) AND NOT contains(SK, '#id#')
+ * 演算子が使えるものかを確かめる（使えなければ例外。find の呼び出し側で 400 になる）
  *
- * @returns シャドー除外フィルター式
+ * `$regex` は正規表現ではなく部分一致として動いていたため、黙って誤った結果を返さないよう受け付けない。
  */
-export function createShadowExclusionFilter() {
-    return {
-        expression: 'attribute_exists(#data) AND NOT contains(#sk, :shadowMarker)',
-        names: {
-            '#data': 'data',
-            '#sk': 'SK',
-        },
-        values: {
-            ':shadowMarker': '#id#',
-        },
-    };
-}
-/**
- * ユーザー指定のフィルター条件から FilterExpression を構築する
- *
- * 注意: この実装は基本的な等価比較のみをサポート
- * より複雑な条件（範囲検索、部分一致など）は将来の拡張として実装可能
- *
- * @param filter - フィルター条件（キー: フィールド名、値: 期待値）
- * @returns フィルター式の構築結果
- */
-export function buildFilterExpression(filter) {
-    const entries = Object.entries(filter);
-    // フィルター条件が空の場合は null を返す
-    if (entries.length === 0) {
-        return null;
-    }
-    const expressions = [];
-    const names = {};
-    const values = {};
-    entries.forEach(([key, value], index) => {
-        const nameKey = `#field${index}`;
-        const valueKey = `:value${index}`;
-        // data.{field} = :value 形式の条件を生成
-        expressions.push(`#data.${nameKey} = ${valueKey}`);
-        names['#data'] = 'data';
-        names[nameKey] = key;
-        values[valueKey] = value;
-    });
-    return {
-        expression: expressions.join(' AND '),
-        names,
-        values,
-    };
-}
-/**
- * 複数のフィルター式を AND 条件で結合する
- *
- * @param filters - 結合するフィルター式の配列
- * @returns 結合されたフィルター式
- */
-export function combineFilters(filters) {
-    // null を除外
-    const validFilters = filters.filter((f) => f !== null);
-    if (validFilters.length === 0) {
-        return null;
-    }
-    if (validFilters.length === 1) {
-        return validFilters[0];
+function assertSupportedOperator(operator) {
+    if (operator === '$regex') {
+        throw new Error('Invalid filter operator: $regex is not supported (use $contains or $starts)');
     }
-    // 式を AND で結合
-    const expression = validFilters.map((f) => `(${f.expression})`).join(' AND ');
-    // names と values をマージ
-    const names = {};
-    const values = {};
-    validFilters.forEach((f) => {
-        Object.assign(names, f.names);
-        Object.assign(values, f.values);
-    });
-    return {
-        expression,
-        names,
-        values,
-    };
-}
-/**
- * フィルター式を DynamoDB Query/Scan パラメータに適用する
- *
- * @param params - DynamoDB Query/Scan パラメータ
- * @param filter - フィルター式
- * @returns フィルター式が適用されたパラメータ
- */
-export function applyFilterExpression(params, filter) {
-    if (!filter) {
-        return params;
+    if (!isValidOperator(operator)) {
+        throw new Error(`Invalid filter operator: ${operator}`);
     }
-    return {
-        ...params,
-        FilterExpression: filter.expression,
-        ExpressionAttributeNames: {
-            ...params.ExpressionAttributeNames,
-            ...filter.names,
-        },
-        ExpressionAttributeValues: {
-            ...params.ExpressionAttributeValues,
-            ...filter.values,
-        },
-    };
 }
 /**
- * 型変換ヘルパー
- *
- * 要件: 12.5
- *
- * @param value - 変換する値
- * @param type - 変換先の型
- * @returns 変換後の値
- */
-export function convertType(value, type) {
-    switch (type) {
-        case 'string':
-            return String(value);
-        case 'number':
-            return Number(value);
-        case 'date':
-            return new Date(String(value));
-        case 'boolean':
-            // 文字列 "true"/"false" または boolean値を処理
-            if (typeof value === 'boolean')
-                return value;
-            return String(value).toLowerCase() === 'true';
-        default:
-            return String(value);
-    }
-}
-/**
- * レコードが単一のフィルター条件に一致するかチェックする
- *
- * 要件: 12.2, 12.6, 12.8, 12.9
- *
- * @param record - チェック対象レコード
- * @param parsed - パース済みフィルター条件
- * @param value - フィルター値
- * @returns 一致する場合true
- */
-export function matchesFilter(record, parsed, value) {
-    const fieldValue = record[parsed.field];
-    // フィールドが存在しない場合は不一致
-    if (fieldValue === undefined || fieldValue === null) {
-        return false;
-    }
-    // 型変換
-    const typedFieldValue = convertType(fieldValue, parsed.type);
-    const typedFilterValue = convertType(value, parsed.type);
-    // 演算子に応じた比較
-    switch (parsed.operator) {
-        case '$eq':
-            return typedFieldValue === typedFilterValue;
-        case '$lt':
-            return typedFieldValue < typedFilterValue;
-        case '$lte':
-            return typedFieldValue <= typedFilterValue;
-        case '$gt':
-            return typedFieldValue > typedFilterValue;
-        case '$gte':
-            return typedFieldValue >= typedFilterValue;
-        case '$in':
-            // value は配列のため convertType を使わず直接比較
-            return Array.isArray(value) && value.map(String).includes(String(fieldValue));
-        case '$nin':
-            // value は配列のため convertType を使わず直接比較
-            return Array.isArray(value) && !value.map(String).includes(String(fieldValue));
-        case '$starts':
-            return String(typedFieldValue).startsWith(String(typedFilterValue));
-        case '$ends':
-            return String(typedFieldValue).endsWith(String(typedFilterValue));
-        default:
-            return false;
-    }
-}
-/**
- * レコードがすべてのフィルター条件に一致するかチェックする（AND条件）
- *
- * 要件: 12.9
- *
- * @param record - チェック対象レコード
- * @param parsedFilters - パース済みフィルター条件の配列
- * @returns すべての条件に一致する場合true
- */
-export function matchesAllFilters(record, parsedFilters) {
-    return parsedFilters.every((f) => matchesFilter(record, f.parsed, f.value));
-}
-/**
- * Query最適化が可能かチェックする
- *
- * ソートフィールドと一致し、Query可能な演算子を持つフィルター条件を検出する
- *
- * 要件: 12.7
- *
- * @param sortField - ソート対象フィールド
- * @param parsedFilters - パース済みフィルター条件
- * @returns 最適化可能なフィルター条件（なければnull）
+ * 型が有効かチェックする
  */
-export function findOptimizableFilter(sortField, parsedFilters) {
-    // Query可能な演算子
-    const queryableOperators = ['$eq', '$lt', '$lte', '$gt', '$gte', '$starts'];
-    // ソートフィールドと一致し、Query可能な演算子を持つフィルターを探す
-    return (parsedFilters.find((f) => f.parsed.field === sortField && queryableOperators.includes(f.parsed.operator)) || null);
+function isValidType(type) {
+    return ['string', 'number', 'date', 'boolean'].includes(type);
 }
 //# sourceMappingURL=filter.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../../src/server/utils/filter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../../src/server/utils/filter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA2CH;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAElC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,kEAAkE;QAClE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC9D,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,4EAA4E;QAC5E,uBAAuB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAmB,CAAC;QAC5C,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACvD,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,mFAAmF;QACnF,uBAAuB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAmB,CAAC;QAC5C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAe,CAAC;QAEpC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,wBAAwB,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACtD,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC7C,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,gCAAgC,QAAQ,EAAE,CAAC,CAAC;AAC9D,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,QAAgB;IACvC,OAAO;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,MAAM;QACN,KAAK;QACL,MAAM;QACN,KAAK;QACL,MAAM;QACN,SAAS;QACT,OAAO;QACP,WAAW;QACX,SAAS;QACT,OAAO;KACR,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACvB,CAAC;AAED;;;;GAIG;AACH,SAAS,uBAAuB,CAAC,QAAgB;IAC/C,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAC;IACjG,CAAC;IACD,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,EAAE,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAChE,CAAC"}

package/dist/server/utils/updateOperators.d.ts

@@ -3,14 +3,25 @@ export interface ResolvedUpdate {
     patch: Record<string, unknown>;
     /** 新規作成のときだけ入れる値（$setOnInsert） */
     setOnInsert: Record<string, unknown>;
+    /** 足す値（$inc。項目名（ドット記法可）→ 有限の数値）。今の値の読み取りと加算は updateMany が行う */
+    inc: Record<string, number>;
     /** レスポンスの items に返す値（$set の値。演算子が無ければパッチそのもの） */
     returned: Record<string, unknown>;
 }
+/** ドット記法のパスで、今の値を読む（途中がオブジェクトでなければ undefined） */
+export declare function readByPath(data: Record<string, unknown>, path: string): unknown;
+/**
+ * $inc を当てる（今の値に足した値を $set として書くパッチを作る）
+ *
+ * 項目が無い・null のときは 0 から足す。数値でないときは 400。
+ * 返す `added` は、足した後の値（レスポンスの items 用）。
+ */
+export declare function applyInc(data: Record<string, unknown>, inc: Record<string, number>): Record<string, number>;
 /**
  * 更新のデータを解釈する
  *
  * - 演算子（`$` で始まるキー）が無ければ、全体を JSON Merge Patch として扱う
- * - 演算子があれば、$set / $setOnInsert / $unset だけを受け付ける（ほかは 400）
+ * - 演算子があれば、$set / $setOnInsert / $unset / $inc だけを受け付ける（ほかは 400）
  *
  * @throws AppError VALIDATION_ERROR（400）
  */

package/dist/server/utils/updateOperators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"updateOperators.d.ts","sourceRoot":"","sources":["../../../src/server/utils/updateOperators.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,cAAc;IAC7B,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AA0BD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc,CAuBpF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzF"}
+{"version":3,"file":"updateOperators.d.ts","sourceRoot":"","sources":["../../../src/server/utils/updateOperators.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,cAAc;IAC7B,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,+DAA+D;IAC/D,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAsCD,iDAAiD;AACjD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAO/E;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAcxB;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc,CA6BpF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzF"}

package/dist/server/utils/updateOperators.js

@@ -1,11 +1,11 @@
 /**
- * 更新演算子（$set / $setOnInsert / $unset）の解釈
+ * 更新演算子（$set / $setOnInsert / $unset / $inc）の解釈
  *
- * 対応していない演算子（$inc など）を黙って無視しない。無視すると、呼び出し側は更新できたと
+ * 対応していない演算子（$push など）を黙って無視しない。無視すると、呼び出し側は更新できたと
  * 思い込む（$unset が無視され、項目を空にする操作が保存されない不具合が実際に起きた）。
  */
 import { AppError, ErrorCode } from '../../shared/index.js';
-const SUPPORTED_OPERATORS = ['$set', '$setOnInsert', '$unset'];
+const SUPPORTED_OPERATORS = ['$set', '$setOnInsert', '$unset', '$inc'];
 function invalid(message) {
     return new AppError(ErrorCode.VALIDATION_ERROR, message, 400);
 }
@@ -29,18 +29,58 @@ function unsetFields(value) {
     }
     return Object.keys(asObject(value, '$unset'));
 }
+/** $inc は、項目名 → 有限の数値。それ以外は 400 */
+function incFields(value) {
+    const inc = {};
+    for (const [field, amount] of Object.entries(asObject(value, '$inc'))) {
+        if (typeof amount !== 'number' || !Number.isFinite(amount)) {
+            throw invalid(`$inc value for "${field}" must be a finite number`);
+        }
+        inc[field] = amount;
+    }
+    return inc;
+}
+/** ドット記法のパスで、今の値を読む（途中がオブジェクトでなければ undefined） */
+export function readByPath(data, path) {
+    let current = data;
+    for (const key of path.split('.')) {
+        if (typeof current !== 'object' || current === null)
+            return undefined;
+        current = current[key];
+    }
+    return current;
+}
+/**
+ * $inc を当てる（今の値に足した値を $set として書くパッチを作る）
+ *
+ * 項目が無い・null のときは 0 から足す。数値でないときは 400。
+ * 返す `added` は、足した後の値（レスポンスの items 用）。
+ */
+export function applyInc(data, inc) {
+    const added = {};
+    for (const [field, amount] of Object.entries(inc)) {
+        const current = readByPath(data, field);
+        if (current !== undefined &&
+            current !== null &&
+            (typeof current !== 'number' || !Number.isFinite(current))) {
+            throw invalid(`Field "${field}" is not a number, $inc cannot be applied`);
+        }
+        added[field] = (current ?? 0) + amount;
+    }
+    return added;
+}
 /**
  * 更新のデータを解釈する
  *
  * - 演算子（`$` で始まるキー）が無ければ、全体を JSON Merge Patch として扱う
- * - 演算子があれば、$set / $setOnInsert / $unset だけを受け付ける（ほかは 400）
+ * - 演算子があれば、$set / $setOnInsert / $unset / $inc だけを受け付ける（ほかは 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 };
+        return { patch: data, setOnInsert: {}, inc: {}, returned: data };
     }
     const unsupported = operators.filter((op) => !SUPPORTED_OPERATORS.includes(op));
     if (unsupported.length > 0) {
@@ -54,7 +94,14 @@ export function resolveUpdateOperators(data) {
         }
         patch[field] = null;
     }
-    return { patch, setOnInsert: asObject(data.$setOnInsert, '$setOnInsert'), returned: set };
+    const inc = incFields(data.$inc);
+    for (const field of Object.keys(inc)) {
+        if (field in set)
+            throw invalid(`Field "${field}" is in both $set and $inc`);
+        if (field in patch)
+            throw invalid(`Field "${field}" is in both $unset and $inc`);
+    }
+    return { patch, setOnInsert: asObject(data.$setOnInsert, '$setOnInsert'), inc, returned: set };
 }
 /**
  * フィルタから、新規作成（upsert）のレコードに入れる値を取り出す

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

@@ -1 +1 @@
-{"version":3,"file":"updateOperators.js","sourceRoot":"","sources":["../../../src/server/utils/updateOperators.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"updateOperators.js","sourceRoot":"","sources":["../../../src/server/utils/updateOperators.ts"],"names":[],"mappings":"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"}

package/docs/README.md

@@ -126,23 +126,20 @@ pnpm build:lambda # サーバーのみをビルド
 
 ### シャドーレコード修復
 
-DynamoClient（IAM認証）を使用してシャドーレコードを修復するスクリプトです。
+運用の道具です（アプリのコードから呼ばない）。テーブルを直接読み、本体とシャドーの食い違い（孤立・欠け・一覧の食い違い・本体の無いシャドー）を数えて直します。Records の HTTP は `__shadowKeys` を返さず、`updateMany` は古い一覧との差分しか書かないので、HTTP 経由では判定も修復もできません。
 
 ```bash
-# Dry run（変更なし）
-pnpm repair-shadows -- --resource articles --dry-run
+# 確認（既定。読み取りだけ）
+tsx src/scripts/repair-shadows.ts --table <テーブル名> --region <リージョン> --lambda <Records の関数名> --resource articles
 
-# 単一レコードを修復
-pnpm repair-shadows -- --resource articles --id <RECORD_ID> --repair
-
-# 全レコードを修復
-pnpm repair-shadows -- --resource articles --repair
+# 修復（食い違いのあるレコードだけ、1 レコード 1 トランザクション）
+tsx src/scripts/repair-shadows.ts --table <テーブル名> --region <リージョン> --lambda <Records の関数名> --resource articles --repair
 ```
 
-環境変数:
-
-- `ENV`: 環境（dev/stg/prd）、デフォルト: `dev`
-- `AWS_REGION`: AWSリージョン、デフォルト: `us-east-1`
+- テーブル名・リージョン・Lambda は必須（既定を持たない）。`--table` が Lambda の `TABLE_NAME` と違えば止まる
+- シャドーの設定（`SHADOW_*`）は Lambda の環境変数から読み、実行の最初に表示する
+- 本体の `data`・`updatedAt` は変えない。本体の `__shadowKeys` と `__rev` だけを更新し、孤立を削除し、欠けを作る。本体の無いシャドーは、本体が無いことを同じトランザクションで確かめて削除する
+- 修復中に書き込まれたレコードは、条件に外れて飛ばす。もう一度実行すると直る
 - `RECORDS_API_URL`: Records Lambda Function URL（省略時はAWS CLIで自動取得）
 
 ## ドキュメント

package/package.json

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

package/dist/scripts/operations/bulkRecordRepair.d.ts

@@ -1,17 +0,0 @@
-/**
- * 一括レコード修復処理
- *
- * 全レコードをスキャンして修復する
- */
-import type { Collection } from '../../client/index.iam.js';
-/**
- * 全レコードをスキャンして修復
- *
- * @param collection - DynamoClientのコレクション
- * @param dryRun - ドライランモード（trueの場合は実際の修復は行わない）
- */
-export declare function repairAllRecords<TAuthOptions = unknown>(collection: Collection<{
-    id: string;
-    [key: string]: unknown;
-}, TAuthOptions>, dryRun: boolean): Promise<void>;
-//# sourceMappingURL=bulkRecordRepair.d.ts.map

package/dist/scripts/operations/bulkRecordRepair.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"bulkRecordRepair.d.ts","sourceRoot":"","sources":["../../../src/scripts/operations/bulkRecordRepair.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAS5D;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,YAAY,GAAG,OAAO,EAC3D,UAAU,EAAE,UAAU,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,EAAE,YAAY,CAAC,EAC5E,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,IAAI,CAAC,CAuBf"}