@exabugs/dynamodb-client 1.26.0 → 1.27.1

package/dist/scripts/utils/cliParser.d.ts

@@ -1,30 +1,17 @@
 /**
- * コマンドライン引数解析ユーティリティ
- *
- * スクリプトのコマンドライン引数を解析する
- */
-/**
- * 修復スクリプトの設定
+ * repair-shadows の引数の解析
  */
 export interface RepairScriptConfig {
+    /** Records のテーブル名（必須。既定を持たない） */
+    table: string;
+    /** AWS のリージョン（必須。既定を持たない） */
+    region: string;
+    /** 対象のリソース（PK） */
     resource: string;
-    recordId?: string;
-    dryRun: boolean;
+    /** Records の Lambda の関数名。シャドーの設定（SHADOW_*）とテーブル名を読んで、確かめる */
+    lambda: string;
+    /** true のときだけ書く（既定は確認だけ） */
     repair: boolean;
 }
-/**
- * コマンドライン引数を解析する
- *
- * @param args - process.argv.slice(2)の結果
- * @returns 解析された設定
- * @throws {Error} 必須引数が不足している場合
- */
 export declare function parseRepairScriptArgs(args: string[]): RepairScriptConfig;
-/**
- * スクリプト設定を表示する
- *
- * @param config - スクリプト設定
- * @param apiUrl - Records API URL
- */
-export declare function displayScriptConfig(config: RepairScriptConfig, apiUrl: string): void;
 //# sourceMappingURL=cliParser.d.ts.map

package/dist/scripts/utils/cliParser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cliParser.d.ts","sourceRoot":"","sources":["../../../src/scripts/utils/cliParser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,kBAAkB,CAqBxE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAUpF"}
+{"version":3,"file":"cliParser.d.ts","sourceRoot":"","sources":["../../../src/scripts/utils/cliParser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,kBAAkB;IACjC,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,MAAM,EAAE,OAAO,CAAC;CACjB;AAYD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,kBAAkB,CAQxE"}

package/dist/scripts/utils/cliParser.js

@@ -1,44 +1,21 @@
 /**
- * コマンドライン引数解析ユーティリティ
- *
- * スクリプトのコマンドライン引数を解析する
- */
-/**
- * コマンドライン引数を解析する
- *
- * @param args - process.argv.slice(2)の結果
- * @returns 解析された設定
- * @throws {Error} 必須引数が不足している場合
+ * repair-shadows の引数の解析
  */
+const USAGE = 'Usage: repair-shadows --table <table> --region <region> --lambda <records-function> --resource <resource> [--repair]';
+function valueOf(args, name) {
+    const index = args.indexOf(name);
+    const value = index === -1 ? undefined : args[index + 1];
+    if (!value || value.startsWith('--'))
+        throw new Error(`${name} が必要です。\n${USAGE}`);
+    return value;
+}
 export function parseRepairScriptArgs(args) {
-    const resourceIndex = args.indexOf('--resource');
-    const idIndex = args.indexOf('--id');
-    const dryRun = args.includes('--dry-run');
-    const repair = args.includes('--repair');
-    if (resourceIndex === -1 || !args[resourceIndex + 1]) {
-        throw new Error('Usage: pnpm --filter @exabugs/dynamodb-client tsx scripts/repair-shadows.ts --resource <resource> [--id <id>] [--dry-run|--repair]');
-    }
-    const resource = args[resourceIndex + 1];
-    const recordId = idIndex !== -1 ? args[idIndex + 1] : undefined;
     return {
-        resource,
-        recordId,
-        dryRun,
-        repair,
+        table: valueOf(args, '--table'),
+        region: valueOf(args, '--region'),
+        lambda: valueOf(args, '--lambda'),
+        resource: valueOf(args, '--resource'),
+        repair: args.includes('--repair'),
     };
 }
-/**
- * スクリプト設定を表示する
- *
- * @param config - スクリプト設定
- * @param apiUrl - Records API URL
- */
-export function displayScriptConfig(config, apiUrl) {
-    console.log(`Records API: ${apiUrl}`);
-    console.log(`Resource: ${config.resource}`);
-    console.log(`Mode: ${config.dryRun ? 'DRY RUN' : config.repair ? 'REPAIR' : 'DRY RUN (default)'}`);
-    if (config.recordId) {
-        console.log(`Target Record ID: ${config.recordId}`);
-    }
-}
 //# sourceMappingURL=cliParser.js.map

package/dist/scripts/utils/cliParser.js.map

@@ -1 +1 @@
-{"version":3,"file":"cliParser.js","sourceRoot":"","sources":["../../../src/scripts/utils/cliParser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAc;IAClD,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IAEzC,IAAI,aAAa,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CACb,oIAAoI,CACrI,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEhE,OAAO;QACL,QAAQ;QACR,QAAQ;QACR,MAAM;QACN,MAAM;KACP,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAA0B,EAAE,MAAc;IAC5E,OAAO,CAAC,GAAG,CAAC,gBAAgB,MAAM,EAAE,CAAC,CAAC;IACtC,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,GAAG,CACT,SAAS,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,mBAAmB,EAAE,CACtF,CAAC;IAEF,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,qBAAqB,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IACtD,CAAC;AACH,CAAC"}
+{"version":3,"file":"cliParser.js","sourceRoot":"","sources":["../../../src/scripts/utils/cliParser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAeH,MAAM,KAAK,GACT,sHAAsH,CAAC;AAEzH,SAAS,OAAO,CAAC,IAAc,EAAE,IAAY;IAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,KAAK,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IACzD,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,YAAY,KAAK,EAAE,CAAC,CAAC;IAClF,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAc;IAClD,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC;QAC/B,MAAM,EAAE,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC;QACjC,MAAM,EAAE,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC;QACjC,QAAQ,EAAE,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC;QACrC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;KAClC,CAAC;AACJ,CAAC"}

package/dist/scripts/utils/shadowAudit.d.ts

@@ -0,0 +1,49 @@
+/**
+ * シャドーの食い違いの判定（純粋関数。DynamoDB に触れない）
+ *
+ * テーブルから読んだ項目（本体とシャドー）を比べ、3 種類の食い違いを数える。
+ * - 孤立: 実在するが、本体のあるべき一覧に無いシャドー
+ * - 欠け: あるべきだが、実在しないシャドー
+ * - 一覧の食い違い: 本体の `__shadowKeys` が、あるべき一覧と違う
+ * - 本体の無いシャドー
+ */
+import { type ShadowConfig } from '../../server/shadow/index.js';
+import { generateMainRecordSK } from '../../shadows/index.js';
+/** Query で読んだ 1 項目 */
+export type TableItem = Record<string, unknown>;
+/** 1 つの本体レコードの食い違い */
+export interface RecordIssue {
+    id: string;
+    /** 読んだときの版（`__rev`。無ければ undefined） */
+    revision: number | undefined;
+    /** あるべきシャドーの SK（本体の `__shadowKeys` に書き直す値） */
+    expected: string[];
+    /** 孤立（削除する） */
+    orphans: string[];
+    /** 欠け（作る） */
+    missing: string[];
+    /** 本体の `__shadowKeys` が、あるべき一覧と違う */
+    listMismatch: boolean;
+}
+/** 本体の無いシャドー（id ごと） */
+export interface BodylessIssue {
+    id: string;
+    shadows: string[];
+}
+export interface AuditResult {
+    bodies: number;
+    shadows: number;
+    records: RecordIssue[];
+    bodyless: BodylessIssue[];
+}
+/** シャドーの SK から、本体の id を取る（値に `#id#` が現れうるので、最後の区切りを使う） */
+export declare function recordIdOfShadow(sk: string): string | null;
+/**
+ * 項目を比べて、食い違いを返す
+ *
+ * @param items - 1 つのリソース（PK）の全項目
+ */
+export declare function auditShadows(items: TableItem[], resource: string, config: ShadowConfig): AuditResult;
+/** 本体の SK（確認・テスト用） */
+export declare const mainSKOf: typeof generateMainRecordSK;
+//# sourceMappingURL=shadowAudit.d.ts.map

package/dist/scripts/utils/shadowAudit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadowAudit.d.ts","sourceRoot":"","sources":["../../../src/scripts/utils/shadowAudit.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,KAAK,YAAY,EAAyB,MAAM,8BAA8B,CAAC;AACxF,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,sBAAsB;AACtB,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEhD,sBAAsB;AACtB,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,sCAAsC;IACtC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,eAAe;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,aAAa;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,qCAAqC;IACrC,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,uBAAuB;AACvB,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAKD,0DAA0D;AAC1D,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG1D;AAkBD;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,SAAS,EAAE,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,YAAY,GACnB,WAAW,CAiDb;AAED,sBAAsB;AACtB,eAAO,MAAM,QAAQ,6BAAuB,CAAC"}

package/dist/scripts/utils/shadowAudit.js

@@ -0,0 +1,84 @@
+/**
+ * シャドーの食い違いの判定（純粋関数。DynamoDB に触れない）
+ *
+ * テーブルから読んだ項目（本体とシャドー）を比べ、3 種類の食い違いを数える。
+ * - 孤立: 実在するが、本体のあるべき一覧に無いシャドー
+ * - 欠け: あるべきだが、実在しないシャドー
+ * - 一覧の食い違い: 本体の `__shadowKeys` が、あるべき一覧と違う
+ * - 本体の無いシャドー
+ */
+import { generateShadowRecords } from '../../server/shadow/index.js';
+import { generateMainRecordSK } from '../../shadows/index.js';
+const BODY_PREFIX = 'id#';
+const ID_SEPARATOR = '#id#';
+/** シャドーの SK から、本体の id を取る（値に `#id#` が現れうるので、最後の区切りを使う） */
+export function recordIdOfShadow(sk) {
+    const index = sk.lastIndexOf(ID_SEPARATOR);
+    return index >= 0 ? sk.slice(index + ID_SEPARATOR.length) : null;
+}
+function sameSet(a, b) {
+    if (a.length !== b.length)
+        return false;
+    const set = new Set(a);
+    return set.size === new Set(b).size && b.every((x) => set.has(x));
+}
+/** 本体の `data` から、あるべきシャドーの SK を作る（Records の書き込みと同じ関数） */
+function expectedShadowKeys(id, data, resource, config) {
+    return generateShadowRecords({ ...data, id }, resource, config).map((s) => s.SK);
+}
+/**
+ * 項目を比べて、食い違いを返す
+ *
+ * @param items - 1 つのリソース（PK）の全項目
+ */
+export function auditShadows(items, resource, config) {
+    const bodies = new Map();
+    const shadowsById = new Map();
+    let shadowCount = 0;
+    for (const item of items) {
+        const sk = item.SK;
+        if (sk.startsWith(BODY_PREFIX)) {
+            bodies.set(sk.slice(BODY_PREFIX.length), item);
+            continue;
+        }
+        const id = recordIdOfShadow(sk);
+        if (id === null)
+            continue;
+        shadowCount++;
+        const list = shadowsById.get(id) ?? [];
+        list.push(sk);
+        shadowsById.set(id, list);
+    }
+    const records = [];
+    for (const [id, body] of bodies) {
+        const data = body.data ?? {};
+        const expected = expectedShadowKeys(id, data, resource, config);
+        const actual = shadowsById.get(id) ?? [];
+        const actualSet = new Set(actual);
+        const expectedSet = new Set(expected);
+        const orphans = actual.filter((sk) => !expectedSet.has(sk));
+        const missing = expected.filter((sk) => !actualSet.has(sk));
+        const list = Array.isArray(body.__shadowKeys) ? body.__shadowKeys : [];
+        const listMismatch = !sameSet(list, expected);
+        if (orphans.length > 0 || missing.length > 0 || listMismatch) {
+            const rev = body.__rev;
+            records.push({
+                id,
+                revision: typeof rev === 'number' ? rev : undefined,
+                expected,
+                orphans,
+                missing,
+                listMismatch,
+            });
+        }
+    }
+    const bodyless = [];
+    for (const [id, shadows] of shadowsById) {
+        if (!bodies.has(id))
+            bodyless.push({ id, shadows });
+    }
+    return { bodies: bodies.size, shadows: shadowCount, records, bodyless };
+}
+/** 本体の SK（確認・テスト用） */
+export const mainSKOf = generateMainRecordSK;
+//# sourceMappingURL=shadowAudit.js.map

package/dist/scripts/utils/shadowAudit.js.map

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

package/dist/scripts/utils/shadowRepair.d.ts

@@ -0,0 +1,42 @@
+/**
+ * シャドーの食い違いの確認・修復（テーブルを直接読み書きする運用の道具）
+ *
+ * Records の HTTP は `__shadowKeys` を返さず、`updateMany` は古い一覧との差分しか書かない。
+ * そのため、孤立・欠け・本体の無いシャドーは HTTP 経由では直せない。テーブルを直接読んで比べる。
+ * アプリのコードから呼ばない（scripts/dynamodb-access-allowlist.json の permanent）。
+ *
+ * 修復は、食い違いのあるレコードだけ、1 レコード 1 トランザクション。本体の `data`・`updatedAt` は変えない。
+ */
+import { DynamoDBDocumentClient, TransactWriteCommand } from '@aws-sdk/lib-dynamodb';
+import type { ShadowConfig } from '../../server/shadow/index.js';
+import { type AuditResult, type BodylessIssue, type RecordIssue, type TableItem } from './shadowAudit.js';
+/** 1 つのリソース（PK）の全項目を、強い整合性で最後まで読む */
+export declare function readResource(doc: DynamoDBDocumentClient, table: string, resource: string): Promise<TableItem[]>;
+type TransactItem = NonNullable<ConstructorParameters<typeof TransactWriteCommand>[0]['TransactItems']>[number];
+/** 食い違いのある本体レコードの修復（本体の一覧と版だけを更新し、シャドーを足し引きする） */
+export declare function repairItemsOfRecord(table: string, resource: string, issue: RecordIssue): TransactItem[];
+/** 本体の無いシャドーの削除（同じトランザクションで、本体が無いことを確かめる） */
+export declare function repairItemsOfBodyless(table: string, resource: string, issue: BodylessIssue): TransactItem[];
+export interface RepairOutcome {
+    repaired: number;
+    /** 条件に外れた（修復中に書き込まれた）・項目数が多すぎるなどで飛ばした。再実行で直す */
+    skipped: Array<{
+        id: string;
+        reason: string;
+    }>;
+}
+export interface RunOptions {
+    doc: DynamoDBDocumentClient;
+    table: string;
+    resource: string;
+    config: ShadowConfig;
+    /** true のときだけ書く（既定は読み取りだけ） */
+    repair: boolean;
+}
+/** 確認（と、repair が true なら修復）。結果を返す */
+export declare function runShadowRepair(options: RunOptions): Promise<{
+    audit: AuditResult;
+    outcome?: RepairOutcome;
+}>;
+export {};
+//# sourceMappingURL=shadowRepair.d.ts.map

package/dist/scripts/utils/shadowRepair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadowRepair.d.ts","sourceRoot":"","sources":["../../../src/scripts/utils/shadowRepair.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,sBAAsB,EAAgB,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAEnG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAEjE,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,SAAS,EAGf,MAAM,kBAAkB,CAAC;AAK1B,qCAAqC;AACrC,wBAAsB,YAAY,CAChC,GAAG,EAAE,sBAAsB,EAC3B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,SAAS,EAAE,CAAC,CAiBtB;AAED,KAAK,YAAY,GAAG,WAAW,CAC7B,qBAAqB,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CACvE,CAAC,MAAM,CAAC,CAAC;AAEV,kDAAkD;AAClD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,WAAW,GACjB,YAAY,EAAE,CAyBhB;AAED,6CAA6C;AAC7C,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,aAAa,GACnB,YAAY,EAAE,CAahB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AA6BD,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,sBAAsB,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC;IACrB,8BAA8B;IAC9B,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,qCAAqC;AACrC,wBAAsB,eAAe,CACnC,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,OAAO,CAAC,EAAE,aAAa,CAAA;CAAE,CAAC,CAS1D"}

package/dist/scripts/utils/shadowRepair.js

@@ -0,0 +1,110 @@
+/**
+ * シャドーの食い違いの確認・修復（テーブルを直接読み書きする運用の道具）
+ *
+ * Records の HTTP は `__shadowKeys` を返さず、`updateMany` は古い一覧との差分しか書かない。
+ * そのため、孤立・欠け・本体の無いシャドーは HTTP 経由では直せない。テーブルを直接読んで比べる。
+ * アプリのコードから呼ばない（scripts/dynamodb-access-allowlist.json の permanent）。
+ *
+ * 修復は、食い違いのあるレコードだけ、1 レコード 1 トランザクション。本体の `data`・`updatedAt` は変えない。
+ */
+import { QueryCommand, TransactWriteCommand } from '@aws-sdk/lib-dynamodb';
+import { nextRevision, unchangedCondition } from '../../server/utils/revision.js';
+import { auditShadows, mainSKOf, } from './shadowAudit.js';
+/** TransactWriteItems の項目数の上限 */
+const MAX_TRANSACTION_ITEMS = 100;
+/** 1 つのリソース（PK）の全項目を、強い整合性で最後まで読む */
+export async function readResource(doc, table, resource) {
+    const items = [];
+    let startKey;
+    do {
+        const out = await doc.send(new QueryCommand({
+            TableName: table,
+            KeyConditionExpression: 'PK = :pk',
+            ExpressionAttributeValues: { ':pk': resource },
+            ConsistentRead: true,
+            ExclusiveStartKey: startKey,
+        }));
+        items.push(...(out.Items ?? []));
+        startKey = out.LastEvaluatedKey;
+    } while (startKey);
+    return items;
+}
+/** 食い違いのある本体レコードの修復（本体の一覧と版だけを更新し、シャドーを足し引きする） */
+export function repairItemsOfRecord(table, resource, issue) {
+    const condition = unchangedCondition(issue.revision);
+    const items = [
+        {
+            Update: {
+                TableName: table,
+                Key: { PK: resource, SK: mainSKOf(issue.id) },
+                UpdateExpression: 'SET #sk = :sk, #rev = :next',
+                ConditionExpression: condition.ConditionExpression,
+                ExpressionAttributeNames: { ...condition.ExpressionAttributeNames, '#sk': '__shadowKeys' },
+                ExpressionAttributeValues: {
+                    ...condition.ExpressionAttributeValues,
+                    ':sk': issue.expected,
+                    ':next': nextRevision(issue.revision),
+                },
+            },
+        },
+    ];
+    for (const sk of issue.orphans) {
+        items.push({ Delete: { TableName: table, Key: { PK: resource, SK: sk } } });
+    }
+    for (const sk of issue.missing) {
+        items.push({ Put: { TableName: table, Item: { PK: resource, SK: sk, data: {} } } });
+    }
+    return items;
+}
+/** 本体の無いシャドーの削除（同じトランザクションで、本体が無いことを確かめる） */
+export function repairItemsOfBodyless(table, resource, issue) {
+    return [
+        {
+            ConditionCheck: {
+                TableName: table,
+                Key: { PK: resource, SK: mainSKOf(issue.id) },
+                ConditionExpression: 'attribute_not_exists(PK)',
+            },
+        },
+        ...issue.shadows.map((sk) => ({
+            Delete: { TableName: table, Key: { PK: resource, SK: sk } },
+        })),
+    ];
+}
+async function executeAll(doc, groups) {
+    const outcome = { repaired: 0, skipped: [] };
+    for (const { id, items } of groups) {
+        if (items.length > MAX_TRANSACTION_ITEMS) {
+            outcome.skipped.push({
+                id,
+                reason: `項目が ${items.length} 件で、1 トランザクションに収まらない`,
+            });
+            continue;
+        }
+        try {
+            await doc.send(new TransactWriteCommand({ TransactItems: items }));
+            outcome.repaired++;
+        }
+        catch (error) {
+            if (error.name === 'TransactionCanceledException') {
+                outcome.skipped.push({ id, reason: '条件に外れた（修復中に書き込まれた）' });
+                continue;
+            }
+            throw error;
+        }
+    }
+    return outcome;
+}
+/** 確認（と、repair が true なら修復）。結果を返す */
+export async function runShadowRepair(options) {
+    const { doc, table, resource, config, repair } = options;
+    const audit = auditShadows(await readResource(doc, table, resource), resource, config);
+    if (!repair)
+        return { audit };
+    const outcome = await executeAll(doc, [
+        ...audit.records.map((r) => ({ id: r.id, items: repairItemsOfRecord(table, resource, r) })),
+        ...audit.bodyless.map((b) => ({ id: b.id, items: repairItemsOfBodyless(table, resource, b) })),
+    ]);
+    return { audit, outcome };
+}
+//# sourceMappingURL=shadowRepair.js.map

package/dist/scripts/utils/shadowRepair.js.map

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