@exabugs/dynamodb-client 1.20.0 → 1.22.0

package/CHANGELOG.md

@@ -7,6 +7,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.22.0] - 2026-10-25
+
+### Added
+
+- **運用通知 Lambda のエントリ `createOpsNotifyHandler`**（新しいサブパス `@exabugs/dynamodb-client/notify/ops`。共通化の段階 1 = A5、ADR 0006 の延長）: asanowa・astro に複製されていた通知のエントリ（環境変数の読み取り、Slack〔SSM の Webhook。キャッシュ〕・メール〔SES v2〕のチャネル、通知ストア、管理者の一覧、alerts の記録の配線、`SKIP_RECORD_LOG_GROUPS` が空の警告）を 1 つにした。アプリのエントリは `export const handler = createOpsNotifyHandler();` だけになる。環境変数は `terraform/ops-notify`（1.21.0）の契約どおり（`PROJECT_NAME` も必須。`app` を渡せば不要）。両アプリの差は注入: `app`、`admins`（`recipientFields`・`sortById`・`maxAdmins`・`lister` = 読み取りを権限チェック層で包む）、`alertsCollection`（書き込みを包む）、`log`、`notify`（`createNotifyHandler` に渡す設定）、`overrides`（テスト用）。既定は両アプリの現行と同じ（`failOnAnyChannelError: true`、記録の上限・遮断、alerts の HTTP の時間切れ 2500 ms）。使い方は `docs/NOTIFY.md` の「通知 Lambda のエントリ」
+- `readOpsNotifyConfig`、定数 `OPS_NOTIFY_RECORD_LIMITS`・`OPS_NOTIFY_RECORD_BREAKER`・`OPS_NOTIFY_RECORD_HTTP_TIMEOUT_MS`、型
+- 依存に `@aws-sdk/client-sesv2`（3.946.0。他の AWS SDK と同じ版）を加えた。SSM・SES の SDK は `notify/ops` だけが静的に import する（`notify` 本体は読まない。`--external:@aws-sdk/*` の CJS バンドルでは `require` のまま残り、Lambda の実行環境の SDK で解決される）
+
+## [1.21.0] - 2026-10-24
+
+### Added
+
+- **Terraform モジュール `terraform/ops-notify`・`terraform/alerts-cleanup`・`terraform/system-change-recorder`**（ADR 0006 の段階 6 = (b)）: asanowa・astro に複製されていた運用の Lambda の Terraform（通知、alerts の定時削除、システム変更履歴の記録）を 1 つにした。`node_modules` のパスで `source` を指定して使う（`terraform/media` と同じ流儀）。**Lambda の成果物（エントリ）はアプリが作り、`source_file` と `handler` で渡す**（ライブラリの dist は使わない。`exports` への追加もない）。リソースのアドレスと AWS 上の名前は両アプリの旧モジュールと同じなので、module ブロックの名前を変えずに `source` だけを差し替えれば、`moved` なしで置き換えが起きない（astro dev の実機の plan で確認: 0 to add / 0 to destroy、in-place の 4 件だけ）。文言は asanowa を既定にした。ops-notify は asanowa の us-east-1 のアラームの転送（`forward_us_east_1_alarms`、既定 false）も持つので、**呼び出し側は `providers = { aws.us_east_1 = aws.us_east_1 }` を常に渡す**。provider は `hashicorp/aws >= 5.30, < 7.0`。使い方は各ディレクトリの README
+- DynamoDB の直接アクセスの許可リストに、`terraform/ops-notify` の通知 Lambda のロール（別テーブル `notices` への `UpdateItem`。`src/notify/store.ts` と同じ理由の permanent）を加えた
+
+### Fixed
+
+- `npm pack` が `terraform/` の中の Terraform の作業ファイル（`.terraform/`〔プロバイダのバイナリ〕、`.terraform.lock.hcl`、state、plan）を拾わないようにした（`terraform/.npmignore`。`files` の `terraform` の中で、`terraform init` などをしたときに入っていた）
+
 ## [1.20.0] - 2026-10-24
 
 ### Added

package/README.md

@@ -197,7 +197,7 @@ const article = await articles.findOne({ title: 'Hello DynamoDB' });
 - **[Authorization & Secure Setup](docs/AUTHORIZATION.md)** - 認可モデルと安全な構成（必読。JWT の有効性しか検証しない／管理者専用ユーザープール／`aud` 検証）
 - **[疎な検索の警告と対応](docs/SCAN_WARNING.md)** - 検索を打ち切らず、警告(SPARSE_SCAN)で気づいてインデックス・スキーマ・ロジックを見直す
 - **[Records クライアントのヘルパー](docs/RECORDS_CLIENT.md)** - Lambda から Records を呼ぶ定型（`createRecordsClient` / `withCollection` / `lazyCollection`）
-- **[運用通知](docs/NOTIFY.md)** - ログ・アラームを、Slack・メールで管理者へ通知する部品（`@exabugs/dynamodb-client/notify`）
+- **[運用通知](docs/NOTIFY.md)** - ログ・アラームを、Slack・メールで管理者へ通知する部品（`@exabugs/dynamodb-client/notify`。通知 Lambda のエントリは `@exabugs/dynamodb-client/notify/ops`）
 - **[システム変更履歴](docs/SYSTEM_CHANGES.md)** - インフラの変更・リリースを `systemChanges` に記録し、Slack に送る部品と記録 Lambda のハンドラ（`@exabugs/dynamodb-client/system-changes`）、terraform のラッパーから記録する CLI（`dynamodb-system-change`）
 - **[Deployment](docs/DEPLOYMENT.md)** - Production deployment guide
 - **[Terraform Modules](terraform/README.md)** - Infrastructure as Code

package/dist/notify/ops/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 運用通知 Lambda のエントリ（`@exabugs/dynamodb-client/notify/ops`）
+ *
+ * `terraform/ops-notify` の Lambda のエントリは `export const handler = createOpsNotifyHandler();` だけでよい。
+ * SSM・SES の SDK を静的に import するので、`notify` 本体とはサブパスを分ける（SDK を使わない Lambda に
+ * 読み込ませない）。docs/NOTIFY.md の「通知 Lambda のエントリ」
+ */
+export { OPS_NOTIFY_RECORD_BREAKER, OPS_NOTIFY_RECORD_HTTP_TIMEOUT_MS, OPS_NOTIFY_RECORD_LIMITS, createOpsNotifyHandler, readOpsNotifyConfig, } from '../ops-notify.js';
+export type { OpsNotifyAdminsOptions, OpsNotifyAlertRow, OpsNotifyConfig, OpsNotifyHandlerOptions, OpsNotifyLog, OpsNotifyOverrides, OpsNotifyPassthrough, } from '../ops-notify.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/notify/ops/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/notify/ops/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,yBAAyB,EACzB,iCAAiC,EACjC,wBAAwB,EACxB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,sBAAsB,EACtB,iBAAiB,EACjB,eAAe,EACf,uBAAuB,EACvB,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC"}

package/dist/notify/ops/index.js

@@ -0,0 +1,9 @@
+/**
+ * 運用通知 Lambda のエントリ（`@exabugs/dynamodb-client/notify/ops`）
+ *
+ * `terraform/ops-notify` の Lambda のエントリは `export const handler = createOpsNotifyHandler();` だけでよい。
+ * SSM・SES の SDK を静的に import するので、`notify` 本体とはサブパスを分ける（SDK を使わない Lambda に
+ * 読み込ませない）。docs/NOTIFY.md の「通知 Lambda のエントリ」
+ */
+export { OPS_NOTIFY_RECORD_BREAKER, OPS_NOTIFY_RECORD_HTTP_TIMEOUT_MS, OPS_NOTIFY_RECORD_LIMITS, createOpsNotifyHandler, readOpsNotifyConfig, } from '../ops-notify.js';
+//# sourceMappingURL=index.js.map

package/dist/notify/ops/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/notify/ops/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,yBAAyB,EACzB,iCAAiC,EACjC,wBAAwB,EACxB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC"}

package/dist/notify/ops-notify.d.ts

@@ -0,0 +1,106 @@
+import { SSMClient } from '@aws-sdk/client-ssm';
+import { type RecordsCollection } from '../client/recordsClient.js';
+import { type AdminDirectoryOptions, type AdminRecord, type AdminsLister } from './admins.js';
+import { type AlertsCollection } from './alerts.js';
+import { type EmailSender } from './channels/email.js';
+import { type NotifyHandlerOptions, type NotifyResult } from './handler.js';
+import type { AdminDirectory, AlertIndex, Channel, NoticeStore } from './types.js';
+/** 環境変数から読む設定（`readOpsNotifyConfig`） */
+export interface OpsNotifyConfig {
+    projectName: string;
+    envName: string;
+    recordsIamUrl: string;
+    noticeTable: string;
+    slackWebhookParam?: string;
+    mailFrom?: string;
+    sesRegion: string;
+    dryRun: boolean;
+    /** あるときだけ alerts に記録する（無ければ記録しない） */
+    adminBaseUrl?: string;
+    /** 記録しないロググループ（Records のロググループ） */
+    skipRecordLogGroups: string[];
+}
+/** 環境変数（terraform/ops-notify の契約）を読む。必須が無ければ、名前を示して例外 */
+export declare function readOpsNotifyConfig(env?: Record<string, string | undefined>): OpsNotifyConfig;
+/** 記録の上限（`createNotifyHandler` の既定値と同じ。明示して、変えるときに見えるようにする） */
+export declare const OPS_NOTIFY_RECORD_LIMITS: {
+    readonly timeoutMs: 3000;
+    readonly maxAlerts: 50;
+    readonly concurrency: 5;
+};
+/** 記録の遮断（同上） */
+export declare const OPS_NOTIFY_RECORD_BREAKER: {
+    readonly failures: 3;
+    readonly cooldownMs: 60000;
+};
+/**
+ * alerts の書き込みの HTTP の時間切れ（ミリ秒）。記録の上限（3 秒）より短くする
+ * （打ち切った後に HTTP が残らないように）
+ */
+export declare const OPS_NOTIFY_RECORD_HTTP_TIMEOUT_MS = 2500;
+/** alerts の書き込み先が受け取る、生のコレクションの行 */
+export type OpsNotifyAlertRow = {
+    id: string;
+    [key: string]: unknown;
+};
+/** 管理者の一覧（メールの宛先）の設定。Records への接続（url・region）は、ハンドラが渡す */
+export interface OpsNotifyAdminsOptions extends Omit<AdminDirectoryOptions, 'url' | 'region' | 'source'> {
+    /**
+     * 読み取りを包む（既定は生のコレクションを、ライブラリの既定の読み方で読む）。権限チェック層（astro の
+     * authorizedCollection など）を通すアプリは、受け取った生のコレクションを自分の層で包んで返す。
+     * 呼び出しごとに接続し、終わったら閉じる（`withCollection`）
+     */
+    lister?: (raw: RecordsCollection<AdminRecord>) => AdminsLister;
+}
+/** `createNotifyHandler` にそのまま渡すもの（既定はライブラリの既定） */
+export type OpsNotifyPassthrough = Pick<NotifyHandlerOptions, 'windows' | 'rate' | 'adminCacheSec' | 'failOnAnyChannelError' | 'now' | 'logger' | 'skipRecordEvents' | 'recordLimits' | 'recordBreaker'>;
+/** テスト用の差し替え（本番は使わない。外部の AWS に触れずに、分岐を確かめる） */
+export interface OpsNotifyOverrides {
+    store?: NoticeStore & AlertIndex;
+    alertsCollection?: AlertsCollection;
+    channels?: Channel[];
+    admins?: AdminDirectory;
+    /** Slack の Webhook の URL を読む SSM のクライアント */
+    ssmClient?: Pick<SSMClient, 'send'>;
+    /** メールの送信（既定は SES v2。SES_REGION のクライアント） */
+    emailSender?: EmailSender;
+}
+/** エントリ自身のログの出力先（今は設定の誤りの warn だけ。alerts-cleanup の log と同じ形） */
+export type OpsNotifyLog = (level: 'info' | 'warn' | 'error', fields: Record<string, unknown>) => void;
+export interface OpsNotifyHandlerOptions {
+    /** アプリ名（通知の app）。省略時は環境変数 PROJECT_NAME（必須） */
+    app?: string;
+    /** AWS のリージョン（通知ストア・SSM・Records・ログ参照）。省略時は AWS_REGION（無ければ REGION） */
+    region?: string;
+    /** 管理者の一覧（メールの宛先） */
+    admins?: OpsNotifyAdminsOptions;
+    /**
+     * alerts の書き込み先を作る（既定は生のコレクションをそのまま使う）。権限チェック層を通すアプリは、
+     * 受け取った生のコレクションを自分の層で包んで返す。生のコレクションは最初の書き込みで接続し、
+     * コンテナの中で使い回す（`lazyCollection`。接続に失敗したら、次の書き込みで作り直す）
+     */
+    alertsCollection?: (raw: RecordsCollection<OpsNotifyAlertRow>) => AlertsCollection;
+    /** alerts の書き込みの HTTP の時間切れ。既定 OPS_NOTIFY_RECORD_HTTP_TIMEOUT_MS（2500） */
+    recordHttpTimeoutMs?: number;
+    /** 設定の誤り（SKIP_RECORD_LOG_GROUPS が空）の警告の出力先。既定 logJson */
+    log?: OpsNotifyLog;
+    /** `createNotifyHandler` に渡す設定。既定: failOnAnyChannelError は true、記録の上限・遮断は上の定数 */
+    notify?: OpsNotifyPassthrough;
+    /** テスト用 */
+    overrides?: OpsNotifyOverrides;
+}
+type Handler = (event: unknown) => Promise<NotifyResult>;
+/**
+ * 運用通知 Lambda のハンドラを作る。アプリのエントリは、これを export するだけ:
+ * `export const handler = createOpsNotifyHandler();`
+ */
+export declare function createOpsNotifyHandler(options?: OpsNotifyHandlerOptions): Handler;
+/** 設定からハンドラを組み立てる（`createOpsNotifyHandler` の中身。設定を自前で用意するとき・テスト用） */
+export declare function buildOpsNotifyHandler(config: OpsNotifyConfig, options?: OpsNotifyHandlerOptions): Handler;
+/**
+ * alerts の記録（ADMIN_BASE_URL があるときだけ）。集計（ID・件数）は通知ストアの行（UpdateItem だけ）、
+ * レコードは Records の IAM URL（管理者の一覧と同じ経路）に書く。無ければ何も足さない（記録しない）
+ */
+export declare function opsNotifyAlertOptions(config: OpsNotifyConfig, index: AlertIndex, region: string, options?: OpsNotifyHandlerOptions): Pick<NotifyHandlerOptions, 'recorder' | 'adminBaseUrl' | 'region' | 'skipRecordLogGroups' | 'recordLimits' | 'recordBreaker'>;
+export {};
+//# sourceMappingURL=ops-notify.d.ts.map

package/dist/notify/ops-notify.d.ts.map

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

package/dist/notify/ops-notify.js

@@ -0,0 +1,205 @@
+/**
+ * 運用通知 Lambda のハンドラのファクトリ（ADR 0006 の延長。asanowa・astro の通知のエントリを 1 つにしたもの）。
+ *
+ * 入力: CloudWatch Logs の購読（warn 以上のログ）、EventBridge（CloudWatch アラームの状態変化）、
+ * 直接呼び出し（週 1 回の生存確認など）。重複抑制・流量制限のうえ、Slack とメール（管理者全員）へ送る。
+ * 処理そのものは `createNotifyHandler`。ここは、その周りの定型（環境変数の読み取り、チャネル・通知ストア・
+ * 管理者の一覧・alerts の書き込み先の組み立て）を持つ。docs/NOTIFY.md
+ *
+ * 環境変数（terraform/ops-notify が設定する）:
+ *   PROJECT_NAME / ENV_NAME / RECORDS_IAM_URL / NOTICE_TABLE（必須。PROJECT_NAME は `app` を渡せば不要）
+ *   SLACK_WEBHOOK_PARAM（SSM の SecureString の名前。Webhook の URL は秘密）
+ *   MAIL_FROM（送信元。未設定ならメールは送らない）/ SES_REGION（既定 us-east-1）
+ *   DRY_RUN=true（送らず、計画だけを返す）
+ *   ADMIN_BASE_URL（任意。あるときだけ alerts に記録し、通知に詳細の URL を載せる）
+ *   SKIP_RECORD_LOG_GROUPS（カンマ区切り。記録しないロググループ。Records のロググループを必ず入れる。
+ *     記録の失敗 → Records のエラーログ → 通知 → 記録、のループを防ぐ。通知は送る）
+ *
+ * ハンドラは最初の呼び出しで組み立て、以降はコンテナの中で使い回す（重複抑制の遮断・管理者の一覧の
+ * キャッシュを保つため）。組み立てに失敗したら、次の呼び出しでやり直す。
+ * このハンドラ自身のロググループは購読しない（自分のログで無限ループになる）。
+ *
+ * 公開はサブパス `@exabugs/dynamodb-client/notify/ops`（`./ops/index.ts`）だけ。`notify` 本体からは読まない
+ * （SSM・SES の SDK を静的に import するので、それを使わない Lambda に読み込ませない）。静的 import にするのは、
+ * `--external:@aws-sdk/*` の CJS バンドルで `require()` になり、Lambda の同梱 SDK（NODE_PATH）で解決されるため
+ * （動的 `import()` は NODE_PATH を使わない）。ops/__tests__/bundle.test.ts で固定する。
+ */
+import { SESv2Client, SendEmailCommand } from '@aws-sdk/client-sesv2';
+import { GetParameterCommand, SSMClient } from '@aws-sdk/client-ssm';
+import { lazyCollection, withCollection, } from '../client/recordsClient.js';
+import { createAdminDirectory, } from './admins.js';
+import { ALERTS_RESOURCE, createAlertRecorder } from './alerts.js';
+import { createEmailChannel, sesSender } from './channels/email.js';
+import { createSlackChannel } from './channels/slack.js';
+import { createNotifyHandler } from './handler.js';
+import { logJson } from './logger.js';
+import { createDynamoNoticeStore } from './store.js';
+/** 環境変数（terraform/ops-notify の契約）を読む。必須が無ければ、名前を示して例外 */
+export function readOpsNotifyConfig(env = process.env) {
+    const need = (name) => {
+        const v = env[name];
+        if (!v)
+            throw new Error(`${name} environment variable is required`);
+        return v;
+    };
+    return {
+        projectName: need('PROJECT_NAME'),
+        envName: need('ENV_NAME'),
+        recordsIamUrl: need('RECORDS_IAM_URL'),
+        noticeTable: need('NOTICE_TABLE'),
+        slackWebhookParam: env.SLACK_WEBHOOK_PARAM || undefined,
+        mailFrom: env.MAIL_FROM || undefined,
+        sesRegion: env.SES_REGION || 'us-east-1',
+        dryRun: env.DRY_RUN === 'true',
+        adminBaseUrl: env.ADMIN_BASE_URL || undefined,
+        skipRecordLogGroups: (env.SKIP_RECORD_LOG_GROUPS ?? '')
+            .split(',')
+            .map((g) => g.trim())
+            .filter(Boolean),
+    };
+}
+/** 記録の上限（`createNotifyHandler` の既定値と同じ。明示して、変えるときに見えるようにする） */
+export const OPS_NOTIFY_RECORD_LIMITS = { timeoutMs: 3000, maxAlerts: 50, concurrency: 5 };
+/** 記録の遮断（同上） */
+export const OPS_NOTIFY_RECORD_BREAKER = { failures: 3, cooldownMs: 60_000 };
+/**
+ * alerts の書き込みの HTTP の時間切れ（ミリ秒）。記録の上限（3 秒）より短くする
+ * （打ち切った後に HTTP が残らないように）
+ */
+export const OPS_NOTIFY_RECORD_HTTP_TIMEOUT_MS = 2500;
+/**
+ * 運用通知 Lambda のハンドラを作る。アプリのエントリは、これを export するだけ:
+ * `export const handler = createOpsNotifyHandler();`
+ */
+export function createOpsNotifyHandler(options = {}) {
+    let built;
+    return async (event) => {
+        if (!built) {
+            const env = options.app ? { ...process.env, PROJECT_NAME: options.app } : process.env;
+            built = buildOpsNotifyHandler(readOpsNotifyConfig(env), options);
+        }
+        return built(event);
+    };
+}
+function regionOf(options) {
+    const region = options.region ?? (process.env.AWS_REGION || process.env.REGION || undefined);
+    if (!region)
+        throw new Error('AWS_REGION environment variable is not set');
+    return region;
+}
+/** 設定からハンドラを組み立てる（`createOpsNotifyHandler` の中身。設定を自前で用意するとき・テスト用） */
+export function buildOpsNotifyHandler(config, options = {}) {
+    const region = regionOf(options);
+    const o = options.overrides ?? {};
+    const channels = o.channels ?? buildChannels(config, region, o);
+    const store = o.store ?? createDynamoNoticeStore(config.noticeTable, region);
+    return createNotifyHandler({
+        // 一部のチャネルだけの失敗（Webhook の失効など）も、Lambda の失敗先（運用者のメール）へ届ける
+        failOnAnyChannelError: true,
+        // 記録の上限・遮断は、記録するときだけ opsNotifyAlertOptions が渡す（現行の両アプリと同じ）
+        ...options.notify,
+        app: options.app ?? config.projectName,
+        env: config.envName,
+        channels,
+        store,
+        admins: o.admins ?? adminDirectoryOf(config, region, options.admins),
+        dryRun: config.dryRun,
+        region,
+        ...opsNotifyAlertOptions(config, store, region, options),
+    });
+}
+function adminDirectoryOf(config, region, admins = {}) {
+    const { lister, ...directory } = admins;
+    const records = {
+        url: config.recordsIamUrl,
+        region,
+        ...(directory.timeout !== undefined ? { timeout: directory.timeout } : {}),
+    };
+    if (!lister)
+        return createAdminDirectory({ ...directory, ...records });
+    const name = directory.collection ?? 'admins';
+    return createAdminDirectory({
+        ...directory,
+        source: {
+            list: (filter, listOptions) => withCollection(name, (raw) => lister(raw).list(filter, listOptions), records),
+        },
+    });
+}
+/** Slack（SSM の Webhook。実行環境の間はキャッシュ）とメール（SES v2）のチャネル */
+function buildChannels(config, region, o) {
+    const channels = [];
+    if (config.slackWebhookParam) {
+        const name = config.slackWebhookParam;
+        let ssm = o.ssmClient;
+        let cached;
+        channels.push(createSlackChannel({
+            getWebhookUrl: async () => {
+                if (cached)
+                    return cached;
+                ssm ??= new SSMClient({ region });
+                const r = await ssm.send(new GetParameterCommand({ Name: name, WithDecryption: true }));
+                const value = r.Parameter?.Value;
+                if (!value)
+                    throw new Error('Slack の Webhook の URL が取得できません');
+                cached = value;
+                return value;
+            },
+        }));
+    }
+    if (config.mailFrom) {
+        channels.push(createEmailChannel({
+            from: config.mailFrom,
+            send: o.emailSender ?? lazySesSender(config.sesRegion),
+        }));
+    }
+    return channels;
+}
+/** SES v2 の送信。クライアントは最初の送信のときに作る */
+function lazySesSender(sesRegion) {
+    let send;
+    return async (message) => {
+        send ??= sesSender({ client: new SESv2Client({ region: sesRegion }), SendEmailCommand });
+        return send(message);
+    };
+}
+/**
+ * alerts の記録（ADMIN_BASE_URL があるときだけ）。集計（ID・件数）は通知ストアの行（UpdateItem だけ）、
+ * レコードは Records の IAM URL（管理者の一覧と同じ経路）に書く。無ければ何も足さない（記録しない）
+ */
+export function opsNotifyAlertOptions(config, index, region, options = {}) {
+    if (!config.adminBaseUrl)
+        return {};
+    if (config.skipRecordLogGroups.length === 0) {
+        // 自分のログは購読されないので、Lambda の設定の誤りとして残すだけ（遮断が最後の防壁）
+        (options.log ?? logJson)('warn', {
+            event: 'ALERTS_SKIP_LOG_GROUPS_EMPTY',
+            message: 'SKIP_RECORD_LOG_GROUPS が空です（Records のロググループを入れないと、記録の失敗がループしうる）',
+        });
+    }
+    return {
+        recorder: createAlertRecorder({
+            collection: options.overrides?.alertsCollection ?? alertsCollectionOf(config, region, options),
+            index,
+        }),
+        adminBaseUrl: config.adminBaseUrl,
+        region,
+        skipRecordLogGroups: config.skipRecordLogGroups,
+        recordLimits: options.notify?.recordLimits ?? OPS_NOTIFY_RECORD_LIMITS,
+        recordBreaker: options.notify?.recordBreaker ?? OPS_NOTIFY_RECORD_BREAKER,
+    };
+}
+/** alerts の書き込み先。生のコレクションは最初の書き込みで接続し、使い回す */
+function alertsCollectionOf(config, region, options) {
+    const get = lazyCollection(ALERTS_RESOURCE, {
+        url: config.recordsIamUrl,
+        region,
+        timeout: options.recordHttpTimeoutMs ?? OPS_NOTIFY_RECORD_HTTP_TIMEOUT_MS,
+    });
+    const wrap = options.alertsCollection ?? ((raw) => raw);
+    return {
+        async updateOne(filter, update, updateOptions) {
+            return wrap(await get()).updateOne(filter, update, updateOptions);
+        },
+    };
+}
+//# sourceMappingURL=ops-notify.js.map

package/dist/notify/ops-notify.js.map

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

package/dist/notify/store.d.ts

@@ -14,6 +14,11 @@ export declare class DynamoNoticeStore implements NoticeStore, AlertIndex {
      */
     touchAlert(alertKey: string, input: AlertTouchInput): Promise<AlertTouchResult>;
 }
+/**
+ * 通知テーブル（notices）の `DynamoNoticeStore` を、リージョンの DynamoDB クライアントで作る
+ * （`createOpsNotifyHandler` の既定。SDK のクライアントの生成を、許可リストに載ったこのファイルに閉じる）
+ */
+export declare function createDynamoNoticeStore(tableName: string, region: string): DynamoNoticeStore;
 /** テスト・ローカル用（1 プロセス内だけ） */
 export declare class MemoryNoticeStore implements NoticeStore, AlertIndex {
     readonly alerts: Map<string, {

package/dist/notify/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/notify/store.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,sBAAsB,EAAiB,MAAM,uBAAuB,CAAC;AAE9E,OAAO,KAAK,EACV,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,WAAW,EACZ,MAAM,YAAY,CAAC;AAIpB,qBAAa,iBAAkB,YAAW,WAAW,EAAE,UAAU;IAE7D,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBADT,GAAG,EAAE,IAAI,CAAC,sBAAsB,EAAE,MAAM,CAAC,EACzC,SAAS,EAAE,MAAM;IAG9B,KAAK,CACT,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,WAAW,CAAC;IAiDjB,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB3E,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAe5F;;;;OAIG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAwDtF;AAcD,2BAA2B;AAC3B,qBAAa,iBAAkB,YAAW,WAAW,EAAE,UAAU;IAC/D,QAAQ,CAAC,MAAM;iBAEF,MAAM;aAAO,MAAM;qBAAe,MAAM;oBAAc,MAAM;aAAO,MAAM;OAClF;IACJ,QAAQ,CAAC,GAAG;mBAAgC,MAAM;oBAAc,MAAM;OAAM;IAC5E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IAE9C,KAAK,CACT,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,WAAW,CAAC;IAWjB,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM3E,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAOtF,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAmBtF"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/notify/store.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,sBAAsB,EAAiB,MAAM,uBAAuB,CAAC;AAE9E,OAAO,KAAK,EACV,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,WAAW,EACZ,MAAM,YAAY,CAAC;AAIpB,qBAAa,iBAAkB,YAAW,WAAW,EAAE,UAAU;IAE7D,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBADT,GAAG,EAAE,IAAI,CAAC,sBAAsB,EAAE,MAAM,CAAC,EACzC,SAAS,EAAE,MAAM;IAG9B,KAAK,CACT,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,WAAW,CAAC;IAiDjB,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB3E,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAe5F;;;;OAIG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAwDtF;AAcD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAK5F;AAED,2BAA2B;AAC3B,qBAAa,iBAAkB,YAAW,WAAW,EAAE,UAAU;IAC/D,QAAQ,CAAC,MAAM;iBAEF,MAAM;aAAO,MAAM;qBAAe,MAAM;oBAAc,MAAM;aAAO,MAAM;OAClF;IACJ,QAAQ,CAAC,GAAG;mBAAgC,MAAM;oBAAc,MAAM;OAAM;IAC5E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IAE9C,KAAK,CACT,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,WAAW,CAAC;IAWjB,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM3E,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAOtF,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAmBtF"}

package/dist/notify/store.js

@@ -2,8 +2,8 @@
  * 重複抑制・流量制限の記録（DynamoDB。専用のテーブル: パーティションキー `pk`（文字列）、TTL 属性 `ttl`）
  * 同時実行でも二重に確保しないよう、条件付き更新を使う。窓の判定は `expiresAt`（TTL の削除の遅れに影響されない）。
  */
-import { ConditionalCheckFailedException } from '@aws-sdk/client-dynamodb';
-import { UpdateCommand } from '@aws-sdk/lib-dynamodb';
+import { ConditionalCheckFailedException, DynamoDBClient } from '@aws-sdk/client-dynamodb';
+import { DynamoDBDocumentClient, UpdateCommand } from '@aws-sdk/lib-dynamodb';
 const KEEP_SEC = 86400;
 export class DynamoNoticeStore {
     doc;
@@ -156,6 +156,13 @@ function touched(attrs, input) {
     const firstSeenAt = typeof attrs?.firstSeenAt === 'string' ? attrs.firstSeenAt : (input.firstAt ?? input.at);
     return { alertId, count, firstSeenAt, isNew: alertId === input.newId };
 }
+/**
+ * 通知テーブル（notices）の `DynamoNoticeStore` を、リージョンの DynamoDB クライアントで作る
+ * （`createOpsNotifyHandler` の既定。SDK のクライアントの生成を、許可リストに載ったこのファイルに閉じる）
+ */
+export function createDynamoNoticeStore(tableName, region) {
+    return new DynamoNoticeStore(DynamoDBDocumentClient.from(new DynamoDBClient({ region })), tableName);
+}
 /** テスト・ローカル用（1 プロセス内だけ） */
 export class MemoryNoticeStore {
     alerts = new Map();

package/dist/notify/store.js.map

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

package/dist/server/handler.cjs

@@ -1,5 +1,5 @@
-// @exabugs/dynamodb-client v1.20.0
-// Built: 2026-10-24T11:55:31.940Z
+// @exabugs/dynamodb-client v1.22.0
+// Built: 2026-10-25T05:38:01.970Z
 "use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
@@ -38980,7 +38980,7 @@ async function handler(event) {
       return createCorsResponse(HTTP_STATUS.OK);
     }
     if (event.requestContext.http.method === "GET" && event.requestContext.http.path === "/version") {
-      const version = "1.20.0";
+      const version = "1.22.0";
       return createSuccessResponse({ version, timestamp: (/* @__PURE__ */ new Date()).toISOString() }, requestId);
     }
     if (event.requestContext.http.method !== "POST") {

package/dist/server/media-handler.cjs

@@ -1,5 +1,5 @@
-// @exabugs/dynamodb-client v1.20.0
-// Built: 2026-10-24T11:55:31.940Z
+// @exabugs/dynamodb-client v1.22.0
+// Built: 2026-10-25T05:38:01.970Z
 "use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;

package/dist/server/media-process-handler-dlq.cjs

@@ -1,5 +1,5 @@
-// @exabugs/dynamodb-client v1.20.0
-// Built: 2026-10-24T11:55:31.940Z
+// @exabugs/dynamodb-client v1.22.0
+// Built: 2026-10-25T05:38:01.970Z
 "use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;

package/dist/server/media-process-handler.cjs

@@ -1,5 +1,5 @@
-// @exabugs/dynamodb-client v1.20.0
-// Built: 2026-10-24T11:55:31.940Z
+// @exabugs/dynamodb-client v1.22.0
+// Built: 2026-10-25T05:38:01.970Z
 "use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;

package/docs/DYNAMODB_ACCESS.md

@@ -138,7 +138,7 @@ ESLint は、エディタでも違反をその場で示す。CLI は ESLint の
 
 ## 許可リストの種別と約束
 
-- **恒久（permanent）**: 構造上必要な例外。このライブラリでは、Records の本体、Records が使う共有部品、別テーブル `notices`（`src/notify/store.ts`）。`notices` は例外ではなく原則の**対象外**（構造が違う別テーブルで、通知の重複抑制・流量制限の内部用。ビジネスのデータではない）。検査が IAM をテーブルごとに区別できないため permanent として載せる（ADR 0005）
+- **恒久（permanent）**: 構造上必要な例外。このライブラリでは、Records の本体、Records が使う共有部品、別テーブル `notices`（`src/notify/store.ts` と、通知 Lambda のロール `terraform/ops-notify` の `UpdateItem`）。`notices` は例外ではなく原則の**対象外**（構造が違う別テーブルで、通知の重複抑制・流量制限の内部用。ビジネスのデータではない）。検査が IAM をテーブルごとに区別できないため permanent として載せる（ADR 0005）
 - **負債（debt）**: 期限つき。消す作業が決まっている
 
 運用の約束: