@exabugs/dynamodb-client 1.16.0 → 1.18.0

package/CHANGELOG.md

@@ -7,6 +7,32 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.18.0] - 2026-10-24
+
+### Added
+
+- **`createAlertsCleanupHandler(options?)`**（`@exabugs/dynamodb-client/notify`。ADR 0006 の段階 3 = (e)）: alerts の定時削除 Lambda のハンドラのファクトリ。asanowa・astro に複製されていた入口（`runCleanup` と環境変数の確認・接続）を 1 つにした。呼び出しごとに `withCollection('alerts', …)` で Records に接続し、`cleanupAlerts` を 1 回行い、結果を構造化ログに出す（失敗は error `ALERTS_CLEANUP_FAILED`、上限で止めたら warn `ALERTS_CLEANUP_BACKLOG`、それ以外は info。削除の失敗は例外にしない）。アプリ名・Records の URL はオプションか環境変数（`PROJECT_NAME` / `RECORDS_IAM_URL`）。読み取りの包み方（`collection`。権限チェック層を通すアプリ用）、保存期間（`olderThanDays`）、1 回の上限（`maxPerRun`）、ログ（`log`）を注入できる。使い方は `docs/NOTIFY.md`
+- `runAlertsCleanup(collection, options)`（削除 1 回と結果のログ）、定数 `ALERTS_CLEANUP_MAX_PER_RUN`（500）、型 `AlertsCleanupHandlerOptions` / `RunAlertsCleanupOptions` / `AlertsCleanupLog` / `AlertsCleanupRow`
+
+### Changed
+
+- 統合テスト（DynamoDB Local）の土台を `src/__tests__/helpers/recordsLocal.ts` に共通化した（テストのみ。公開 API・dist に変更なし）。DynamoDB アクセスの許可リストは、`src/system-changes/__tests__/*.integration.test.ts` をこの 1 ファイルに置き換えた。`tsconfig.json` はビルドから `**/__tests__/**` を除く（今は該当する非テストのファイルがこの土台だけで、dist は変わらない）
+
+## [1.17.0] - 2026-10-24
+
+### Added
+
+- **`@exabugs/dynamodb-client/system-changes`**（ADR 0006 の段階 2 = (a)）: システム変更履歴（`systemChanges`）の記録と Slack 通知。asanowa・astro に複製されていたロジックを 1 つにした。使い方は `docs/SYSTEM_CHANGES.md`
+  - `createSystemChangeHandler(options?)`: 記録 Lambda のハンドラのファクトリ。呼び出しごとに `withCollection` で Records に接続する。アプリ名・Records の URL・Slack の設定（SSM の名前、環境名、管理画面の URL、開始も送るか）は、オプションか環境変数（`PROJECT_NAME` / `RECORDS_IAM_URL` / `SLACK_WEBHOOK_PARAM` / `ENV_NAME` / `ADMIN_BASE_URL` / `NOTIFY_STARTED`）。書き込み先の包み方（`collection`。権限チェック層を通すアプリ用）、ログ（`log`）、SSM のクライアントを注入できる
+  - `recordSystemChange` / `recordAndNotify` / `systemChangesCollectionOf`、純粋な関数 `parseSystemChangeInput` / `toSystemChangeRecord` / `decideRunWrite` / `formatSystemChangeMessage` / `formatDuration` / `lambdaReleaseNames` / `shouldNotify`、定数・型
+  - Slack の文言は asanowa の版に揃えた（ADR 0006 の決定）。`details.lambdaReleases` の取り出しは公開関数 `lambdaReleaseNames` の 1 つ
+  - 既定の書き込み先は、`changeId` の読み取りを `find({ id }, { sort: { id: 'asc' }, limit: 1 })`（Records の ID の経路。PK/SK の Query 1 回） で行う（`findOne` の 404 で Records が ITEM_NOT_FOUND の warn を出さない）
+- **`postSlackText(url, text, options?)`**（`src/notify/channels/slack.ts`。内部用、notify の index からは出さない）: `createSlackChannel` の送信処理を切り出したもの。`system-changes` が使う
+
+### Changed
+
+- `createSlackChannel` の送信は、切り出した `postSlackText` を呼ぶ。挙動は同じ（URL の接頭辞の確認、timeout 既定 5 秒、URL を出さないエラー）。違いは、`fetchImpl` を省略したときの `fetch` を、チャネルの作成時ではなく送信のたびに読むことだけ
+
 ## [1.16.0] - 2026-10-20
 
 ### Added

package/README.md

@@ -198,6 +198,7 @@ const article = await articles.findOne({ title: 'Hello DynamoDB' });
 - **[疎な検索の警告と対応](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/SYSTEM_CHANGES.md)** - インフラの変更・リリースを `systemChanges` に記録し、Slack に送る部品と記録 Lambda のハンドラ（`@exabugs/dynamodb-client/system-changes`）
 - **[Deployment](docs/DEPLOYMENT.md)** - Production deployment guide
 - **[Terraform Modules](terraform/README.md)** - Infrastructure as Code
 

package/dist/notify/alerts-cleanup.d.ts

@@ -0,0 +1,63 @@
+/**
+ * alerts の定時削除 Lambda のハンドラのファクトリ（ADR 0006 の (e)。ADR 0003 の保存期間）。
+ *
+ * 運用通知の記録（alerts）のうち、最後の発生から保存期間（既定 28 日）を過ぎたものを消す
+ * （ネイティブ TTL は効かない）。削除そのものは `cleanupAlerts`（変えない）。ここは、その周りの定型
+ * （1 回の上限、結果の構造化ログ、環境変数の確認、Records への接続と close）を持つ。docs/NOTIFY.md
+ *
+ * 設定は、オプションが環境変数より優先される（どちらも呼び出しのたびに読む）:
+ * - `app`: PROJECT_NAME（必須）
+ * - `records.url` / `records.region`: RECORDS_IAM_URL（必須）/ AWS_REGION
+ *
+ * 失敗の扱い: 削除の失敗は握りつぶさず、構造化ログ（error。target は alerts）に出す。例外にはしない
+ * （このロググループは通知 Lambda が購読するので管理者に届く。Lambda の失敗としても通知すると 2 通になる。
+ * target が alerts なので alerts には記録されず、ループしない）。接続などの想定外の例外は、そのまま Lambda の
+ * 失敗になる。
+ */
+import { type RecordsClientOptions, type RecordsCollection } from '../client/recordsClient.js';
+import { type AlertsCleanupCollection, type CleanupAlertsResult } from './alerts.js';
+/**
+ * 1 回の実行で消す上限の既定。1 日 1 回の実行で、1 日に増える数より十分大きくする
+ * （指紋ごとに 1 件なので、通常は数件〜数十件。50 件 × 10 ページ = 読み・削除が 20 回で、時間切れにならない）
+ */
+export declare const ALERTS_CLEANUP_MAX_PER_RUN = 500;
+/** 削除の結果のログの出力先。fields には app・target（alerts）が入る */
+export type AlertsCleanupLog = (level: 'info' | 'warn' | 'error', fields: Record<string, unknown>) => void;
+export interface RunAlertsCleanupOptions {
+    /** アプリ名（ログの app） */
+    app: string;
+    /** 保存期間（日）。既定 ALERT_RETENTION_DAYS（28） */
+    olderThanDays?: number;
+    /** 1 回の実行で消す上限。既定 ALERTS_CLEANUP_MAX_PER_RUN（500） */
+    maxPerRun?: number;
+    /** ログの出力先（既定は logJson。app と target: alerts を付ける） */
+    log?: AlertsCleanupLog;
+    /** 現在時刻（テスト用） */
+    now?: () => Date;
+}
+/** 削除を 1 回行い、結果を構造化ログに出す（失敗は error、上限で止めたら warn、それ以外は info） */
+export declare function runAlertsCleanup(collection: AlertsCleanupCollection, options: RunAlertsCleanupOptions): Promise<CleanupAlertsResult>;
+/** 削除で読む alerts の行（使う項目だけ） */
+export type AlertsCleanupRow = {
+    id: string;
+    lastSeenAt?: unknown;
+    [key: string]: unknown;
+};
+export interface AlertsCleanupHandlerOptions extends Omit<RunAlertsCleanupOptions, 'app'> {
+    /** アプリ名。省略時は環境変数 PROJECT_NAME */
+    app?: string;
+    /** Records のクライアント。url / region は省略時に環境変数。timeout は DynamoClient の既定 */
+    records?: RecordsClientOptions;
+    /**
+     * 削除で使う形を作る（既定は生のコレクションをそのまま使う）。読み取りを権限チェック層（astro の
+     * authorizedCollection など）に通すアプリは、受け取った生のコレクションを自分の層で包んで返す
+     */
+    collection?: (raw: RecordsCollection<AlertsCleanupRow>) => AlertsCleanupCollection;
+}
+/**
+ * 削除の定時 Lambda のハンドラを作る。アプリのエントリは、これを export するだけ:
+ * `export const handler = createAlertsCleanupHandler();`
+ * 呼び出しごとに Records（IAM 版 Function URL）に接続し、終わったら閉じる（`withCollection`）。
+ */
+export declare function createAlertsCleanupHandler(options?: AlertsCleanupHandlerOptions): () => Promise<CleanupAlertsResult>;
+//# sourceMappingURL=alerts-cleanup.d.ts.map

package/dist/notify/alerts-cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alerts-cleanup.d.ts","sourceRoot":"","sources":["../../src/notify/alerts-cleanup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EAEvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAGL,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EAEzB,MAAM,aAAa,CAAC;AAGrB;;;GAGG;AACH,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAE9C,mDAAmD;AACnD,MAAM,MAAM,gBAAgB,GAAG,CAC7B,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,EAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B,IAAI,CAAC;AAEV,MAAM,WAAW,uBAAuB;IACtC,oBAAoB;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,0CAA0C;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,GAAG,CAAC,EAAE,gBAAgB,CAAC;IACvB,iBAAiB;IACjB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,+DAA+D;AAC/D,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,uBAAuB,EACnC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,mBAAmB,CAAC,CA+B9B;AAED,8BAA8B;AAC9B,MAAM,MAAM,gBAAgB,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAE5F,MAAM,WAAW,2BAA4B,SAAQ,IAAI,CAAC,uBAAuB,EAAE,KAAK,CAAC;IACvF,iCAAiC;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,iBAAiB,CAAC,gBAAgB,CAAC,KAAK,uBAAuB,CAAC;CACpF;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,GAAE,2BAAgC,GACxC,MAAM,OAAO,CAAC,mBAAmB,CAAC,CAapC"}

package/dist/notify/alerts-cleanup.js

@@ -0,0 +1,75 @@
+/**
+ * alerts の定時削除 Lambda のハンドラのファクトリ（ADR 0006 の (e)。ADR 0003 の保存期間）。
+ *
+ * 運用通知の記録（alerts）のうち、最後の発生から保存期間（既定 28 日）を過ぎたものを消す
+ * （ネイティブ TTL は効かない）。削除そのものは `cleanupAlerts`（変えない）。ここは、その周りの定型
+ * （1 回の上限、結果の構造化ログ、環境変数の確認、Records への接続と close）を持つ。docs/NOTIFY.md
+ *
+ * 設定は、オプションが環境変数より優先される（どちらも呼び出しのたびに読む）:
+ * - `app`: PROJECT_NAME（必須）
+ * - `records.url` / `records.region`: RECORDS_IAM_URL（必須）/ AWS_REGION
+ *
+ * 失敗の扱い: 削除の失敗は握りつぶさず、構造化ログ（error。target は alerts）に出す。例外にはしない
+ * （このロググループは通知 Lambda が購読するので管理者に届く。Lambda の失敗としても通知すると 2 通になる。
+ * target が alerts なので alerts には記録されず、ループしない）。接続などの想定外の例外は、そのまま Lambda の
+ * 失敗になる。
+ */
+import { withCollection, } from '../client/recordsClient.js';
+import { ALERTS_RESOURCE, ALERT_RETENTION_DAYS, cleanupAlerts, } from './alerts.js';
+import { logJson } from './logger.js';
+/**
+ * 1 回の実行で消す上限の既定。1 日 1 回の実行で、1 日に増える数より十分大きくする
+ * （指紋ごとに 1 件なので、通常は数件〜数十件。50 件 × 10 ページ = 読み・削除が 20 回で、時間切れにならない）
+ */
+export const ALERTS_CLEANUP_MAX_PER_RUN = 500;
+/** 削除を 1 回行い、結果を構造化ログに出す（失敗は error、上限で止めたら warn、それ以外は info） */
+export async function runAlertsCleanup(collection, options) {
+    const maxPerRun = options.maxPerRun ?? ALERTS_CLEANUP_MAX_PER_RUN;
+    const log = options.log ??
+        ((level, fields) => logJson(level, { app: options.app, target: ALERTS_RESOURCE, ...fields }));
+    const r = await cleanupAlerts({
+        collection,
+        olderThanDays: options.olderThanDays ?? ALERT_RETENTION_DAYS,
+        maxPerRun,
+        now: options.now,
+    });
+    const summary = { deleted: r.deleted, failed: r.failed, more: r.more };
+    if (r.errors.length > 0) {
+        log('error', {
+            event: 'ALERTS_CLEANUP_FAILED',
+            message: `alerts の削除に失敗しました: ${r.errors.join(' / ')}`.slice(0, 1000),
+            action: '翌日の定時実行で再試行されます。続く場合は Records Lambda のログを確認してください',
+            ...summary,
+        });
+    }
+    else if (r.more) {
+        log('warn', {
+            event: 'ALERTS_CLEANUP_BACKLOG',
+            message: `1 回の上限（${maxPerRun} 件）まで消しました。残りは翌日に消します`,
+            action: '毎日続く場合は、通知の発生源（同じ指紋で増え続けていないか）を確認してください',
+            ...summary,
+        });
+    }
+    else {
+        log('info', { message: 'alerts cleanup completed', ...summary });
+    }
+    return r;
+}
+/**
+ * 削除の定時 Lambda のハンドラを作る。アプリのエントリは、これを export するだけ:
+ * `export const handler = createAlertsCleanupHandler();`
+ * 呼び出しごとに Records（IAM 版 Function URL）に接続し、終わったら閉じる（`withCollection`）。
+ */
+export function createAlertsCleanupHandler(options = {}) {
+    const { app: appOption, records, collection: wrap, ...run } = options;
+    return async () => {
+        const app = appOption ?? (process.env.PROJECT_NAME || undefined);
+        if (!app)
+            throw new Error('PROJECT_NAME environment variable is required');
+        const url = records?.url ?? (process.env.RECORDS_IAM_URL || undefined);
+        if (!url)
+            throw new Error('RECORDS_IAM_URL environment variable is required');
+        return withCollection(ALERTS_RESOURCE, (raw) => runAlertsCleanup(wrap ? wrap(raw) : raw, { ...run, app }), { ...records, url });
+    };
+}
+//# sourceMappingURL=alerts-cleanup.js.map

package/dist/notify/alerts-cleanup.js.map

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

package/dist/notify/channels/slack.d.ts

@@ -8,5 +8,13 @@ export interface SlackOptions {
     fetchImpl?: typeof fetch;
     timeoutMs?: number;
 }
+/** `postSlackText` のオプション（`createSlackChannel` と共通） */
+export type SlackPostOptions = Pick<SlackOptions, 'urlPrefix' | 'fetchImpl' | 'timeoutMs'>;
+/**
+ * 文字列（mrkdwn）を 1 通、Webhook に送る。失敗は例外（メッセージに URL を出さない）。
+ * `createSlackChannel` の送信と同じ処理（URL の接頭辞の確認、timeout 既定 5 秒）。
+ * Notice を経由しない直接の投稿（システム変更履歴など）に使う
+ */
+export declare function postSlackText(url: string, text: string, options?: SlackPostOptions): Promise<void>;
 export declare function createSlackChannel(options: SlackOptions): Channel;
 //# sourceMappingURL=slack.d.ts.map

package/dist/notify/channels/slack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"slack.d.ts","sourceRoot":"","sources":["../../../src/notify/channels/slack.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAQnD,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAKnD;AAED,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,aAAa,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CA0BjE"}
+{"version":3,"file":"slack.d.ts","sourceRoot":"","sources":["../../../src/notify/channels/slack.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAQnD,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAKnD;AAED,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,aAAa,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,uDAAuD;AACvD,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,YAAY,EAAE,WAAW,GAAG,WAAW,GAAG,WAAW,CAAC,CAAC;AAE3F;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAUjE"}

package/dist/notify/channels/slack.js

@@ -13,8 +13,33 @@ export function slackText(notices) {
         parts.push(`…ほか ${notices.length - shown.length} 件`);
     return parts.join('\n\n');
 }
-export function createSlackChannel(options) {
+/**
+ * 文字列（mrkdwn）を 1 通、Webhook に送る。失敗は例外（メッセージに URL を出さない）。
+ * `createSlackChannel` の送信と同じ処理（URL の接頭辞の確認、timeout 既定 5 秒）。
+ * Notice を経由しない直接の投稿（システム変更履歴など）に使う
+ */
+export async function postSlackText(url, text, options = {}) {
+    if (!url.startsWith(options.urlPrefix ?? 'https://hooks.slack.com/')) {
+        throw new Error('Slack の Webhook の URL が不正です（許可した接頭辞で始まっていません）');
+    }
     const doFetch = options.fetchImpl ?? fetch;
+    let res;
+    try {
+        res = await doFetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ text }),
+            signal: AbortSignal.timeout(options.timeoutMs ?? 5000),
+        });
+    }
+    catch (e) {
+        // fetch のエラーには URL（秘密）が入ることがあるので、原因の種類だけを残す
+        throw new Error(`Slack への送信に失敗しました (${e instanceof Error ? e.name : 'error'})`);
+    }
+    if (!res.ok)
+        throw new Error(`Slack への送信に失敗しました (HTTP ${res.status})`);
+}
+export function createSlackChannel(options) {
     return {
         name: 'slack',
         needsRecipients: false,
@@ -22,24 +47,7 @@ export function createSlackChannel(options) {
             if (notices.length === 0)
                 return;
             const url = await options.getWebhookUrl();
-            if (!url.startsWith(options.urlPrefix ?? 'https://hooks.slack.com/')) {
-                throw new Error('Slack の Webhook の URL が不正です（許可した接頭辞で始まっていません）');
-            }
-            let res;
-            try {
-                res = await doFetch(url, {
-                    method: 'POST',
-                    headers: { 'Content-Type': 'application/json' },
-                    body: JSON.stringify({ text: slackText(notices) }),
-                    signal: AbortSignal.timeout(options.timeoutMs ?? 5000),
-                });
-            }
-            catch (e) {
-                // fetch のエラーには URL（秘密）が入ることがあるので、原因の種類だけを残す
-                throw new Error(`Slack への送信に失敗しました (${e instanceof Error ? e.name : 'error'})`);
-            }
-            if (!res.ok)
-                throw new Error(`Slack への送信に失敗しました (HTTP ${res.status})`);
+            await postSlackText(url, slackText(notices), options);
         },
     };
 }

package/dist/notify/channels/slack.js.map

@@ -1 +1 @@
-{"version":3,"file":"slack.js","sourceRoot":"","sources":["../../../src/notify/channels/slack.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGvD,MAAM,eAAe,GAAG,EAAE,CAAC;AAE3B,kCAAkC;AAClC,MAAM,GAAG,GAAG,CAAC,CAAS,EAAU,EAAE,CAChC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAEvE,MAAM,UAAU,SAAS,CAAC,OAAiB;IACzC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACvF,IAAI,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;IACxF,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAWD,MAAM,UAAU,kBAAkB,CAAC,OAAqB;IACtD,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC;IAC3C,OAAO;QACL,IAAI,EAAE,OAAO;QACb,eAAe,EAAE,KAAK;QACtB,KAAK,CAAC,IAAI,CAAC,OAAO;YAChB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO;YACjC,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC;YAC1C,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,SAAS,IAAI,0BAA0B,CAAC,EAAE,CAAC;gBACrE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;YACnE,CAAC;YACD,IAAI,GAAa,CAAC;YAClB,IAAI,CAAC;gBACH,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE;oBACvB,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;oBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;oBAClD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC;iBACvD,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,4CAA4C;gBAC5C,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC;YAClF,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;QACzE,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"slack.js","sourceRoot":"","sources":["../../../src/notify/channels/slack.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGvD,MAAM,eAAe,GAAG,EAAE,CAAC;AAE3B,kCAAkC;AAClC,MAAM,GAAG,GAAG,CAAC,CAAS,EAAU,EAAE,CAChC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAEvE,MAAM,UAAU,SAAS,CAAC,OAAiB;IACzC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACvF,IAAI,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;IACxF,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAcD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,GAAW,EACX,IAAY,EACZ,UAA4B,EAAE;IAE9B,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,SAAS,IAAI,0BAA0B,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC;IAC3C,IAAI,GAAa,CAAC;IAClB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE;YACvB,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC;YAC9B,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC;SACvD,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,4CAA4C;QAC5C,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC;IAClF,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAqB;IACtD,OAAO;QACL,IAAI,EAAE,OAAO;QACb,eAAe,EAAE,KAAK;QACtB,KAAK,CAAC,IAAI,CAAC,OAAO;YAChB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO;YACjC,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC;YAC1C,MAAM,aAAa,CAAC,GAAG,EAAE,SAAS,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;QACxD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/notify/index.d.ts

@@ -7,6 +7,8 @@
 export { createAdminDirectory, emailsOf, normalizeEmail } from './admins.js';
 export type { AdminDirectoryOptions, AdminRecord, AdminsLister } from './admins.js';
 export { ALERTS_RESOURCE, ALERT_RETENTION_DAYS, alertKeyOf, cleanupAlerts, createAlertRecorder, } from './alerts.js';
+export { ALERTS_CLEANUP_MAX_PER_RUN, createAlertsCleanupHandler, runAlertsCleanup, } from './alerts-cleanup.js';
+export type { AlertsCleanupHandlerOptions, AlertsCleanupLog, AlertsCleanupRow, RunAlertsCleanupOptions, } from './alerts-cleanup.js';
 export type { AlertInput, AlertOccurrence, AlertRecord, AlertRecorder, AlertRecorderOptions, AlertsCleanupCollection, AlertsCollection, CleanupAlertsOptions, CleanupAlertsResult, } from './alerts.js';
 export { createEmailChannel, sesSender } from './channels/email.js';
 export type { EmailMessage, EmailOptions, EmailSender, SesSendInput } from './channels/email.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/notify/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7E,YAAY,EAAE,qBAAqB,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACpF,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,UAAU,EACV,aAAa,EACb,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,UAAU,EACV,eAAe,EACf,WAAW,EACX,aAAa,EACb,oBAAoB,EACpB,uBAAuB,EACvB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACpE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACjG,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,YAAY,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,EACrB,QAAQ,EACR,OAAO,GACR,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACjF,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAClE,YAAY,EACV,cAAc,EACd,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,OAAO,EACP,MAAM,EACN,WAAW,EACX,MAAM,EACN,WAAW,EACX,WAAW,EACX,YAAY,GACb,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/notify/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7E,YAAY,EAAE,qBAAqB,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACpF,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,UAAU,EACV,aAAa,EACb,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,0BAA0B,EAC1B,0BAA0B,EAC1B,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,2BAA2B,EAC3B,gBAAgB,EAChB,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,UAAU,EACV,eAAe,EACf,WAAW,EACX,aAAa,EACb,oBAAoB,EACpB,uBAAuB,EACvB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACpE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACjG,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,YAAY,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,EACrB,QAAQ,EACR,OAAO,GACR,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACjF,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAClE,YAAY,EACV,cAAc,EACd,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,OAAO,EACP,MAAM,EACN,WAAW,EACX,MAAM,EACN,WAAW,EACX,WAAW,EACX,YAAY,GACb,MAAM,YAAY,CAAC"}

package/dist/notify/index.js

@@ -6,6 +6,7 @@
  */
 export { createAdminDirectory, emailsOf, normalizeEmail } from './admins.js';
 export { ALERTS_RESOURCE, ALERT_RETENTION_DAYS, alertKeyOf, cleanupAlerts, createAlertRecorder, } from './alerts.js';
+export { ALERTS_CLEANUP_MAX_PER_RUN, createAlertsCleanupHandler, runAlertsCleanup, } from './alerts-cleanup.js';
 export { createEmailChannel, sesSender } from './channels/email.js';
 export { createSlackChannel } from './channels/slack.js';
 export { createNotifyHandler } from './handler.js';

package/dist/notify/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/notify/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7E,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,UAAU,EACV,aAAa,EACb,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAYrB,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,EACrB,QAAQ,EACR,OAAO,GACR,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEjF,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/notify/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7E,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,UAAU,EACV,aAAa,EACb,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,0BAA0B,EAC1B,0BAA0B,EAC1B,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAkB7B,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,EACrB,QAAQ,EACR,OAAO,GACR,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEjF,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/dist/server/handler.cjs

@@ -1,5 +1,5 @@
-// @exabugs/dynamodb-client v1.16.0
-// Built: 2026-10-20T00:50:17.412Z
+// @exabugs/dynamodb-client v1.18.0
+// Built: 2026-10-24T04:27:35.011Z
 "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.16.0";
+      const version = "1.18.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.16.0
-// Built: 2026-10-20T00:50:17.412Z
+// @exabugs/dynamodb-client v1.18.0
+// Built: 2026-10-24T04:27:35.011Z
 "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.16.0
-// Built: 2026-10-20T00:50:17.412Z
+// @exabugs/dynamodb-client v1.18.0
+// Built: 2026-10-24T04:27:35.011Z
 "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.16.0
-// Built: 2026-10-20T00:50:17.412Z
+// @exabugs/dynamodb-client v1.18.0
+// Built: 2026-10-24T04:27:35.011Z
 "use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;

package/dist/system-changes/handler.d.ts

@@ -0,0 +1,47 @@
+/**
+ * システム変更履歴の記録 Lambda のハンドラのファクトリ（ADR 0006 の (a)）。
+ *
+ * 直接呼び出し（`aws lambda invoke`。terraform のラッパー・人・CI）で使う。入力と応答は docs/SYSTEM_CHANGES.md。
+ * 呼び出しごとに Records（IAM 版 Function URL）のクライアントを作り、終わったら閉じる（`withCollection`）。
+ *
+ * 設定は、オプションが環境変数より優先される（どちらも呼び出しのたびに読む）:
+ * - `app`: PROJECT_NAME（必須）
+ * - `records.url` / `records.region`: RECORDS_IAM_URL（必須）/ AWS_REGION
+ * - Slack（任意。webhookParam が無ければ送らない）: SLACK_WEBHOOK_PARAM（SSM の SecureString の名前）/ ENV_NAME /
+ *   ADMIN_BASE_URL / NOTIFY_STARTED（'true' で開始も送る）
+ *
+ * 失敗の扱い: 入力の誤り・Records への書き込みの失敗は、構造化ログ（warn / error）に出し、例外にする（呼び出し元が
+ * `FunctionError` で分かるように）。Slack への送信の失敗は、記録を失敗にしない。
+ */
+import { SSMClient } from '@aws-sdk/client-ssm';
+import { type RecordsClientOptions, type RecordsCollection } from '../client/recordsClient.js';
+import { type StoredSystemChange } from './record.js';
+import { type SystemChangeLog, type SystemChangeResponse, type SystemChangeSlackOptions, type SystemChangesCollection } from './recorder.js';
+export interface SystemChangeHandlerOptions {
+    /** アプリ名。省略時は環境変数 PROJECT_NAME */
+    app?: string;
+    /** Records のクライアント。url / region は省略時に環境変数。timeout の既定は RECORD_HTTP_TIMEOUT_MS（5 秒） */
+    records?: RecordsClientOptions;
+    /**
+     * 書き込み先を作る（既定 systemChangesCollectionOf）。権限チェック層（astro の authorizedCollection など）を
+     * 通すアプリは、受け取った生のコレクションを自分の層で包んで返す
+     */
+    collection?: (raw: RecordsCollection<StoredSystemChange>) => SystemChangesCollection;
+    /**
+     * Slack の設定。各項目は省略時に環境変数（上記）。getWebhookUrl の既定は SSM（SecureString。実行環境の間は
+     * キャッシュ）。false で送らない
+     */
+    slack?: Partial<SystemChangeSlackOptions> | false;
+    /** SSM のクライアント（既定は AWS_REGION の SSMClient。テスト用） */
+    ssmClient?: Pick<SSMClient, 'send'>;
+    /** ログの出力先（既定は notify の logJson） */
+    log?: SystemChangeLog;
+    /** 現在時刻（テスト用） */
+    now?: () => Date;
+}
+/**
+ * 記録 Lambda のハンドラを作る。アプリのエントリは、これを export するだけ:
+ * `export const handler = createSystemChangeHandler();`
+ */
+export declare function createSystemChangeHandler(options?: SystemChangeHandlerOptions): (event: unknown) => Promise<SystemChangeResponse>;
+//# sourceMappingURL=handler.d.ts.map

package/dist/system-changes/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/system-changes/handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAuB,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErE,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EAEvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAA2B,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAG7B,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,0BAA0B;IACzC,iCAAiC;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sFAAsF;IACtF,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,iBAAiB,CAAC,kBAAkB,CAAC,KAAK,uBAAuB,CAAC;IACrF;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC,GAAG,KAAK,CAAC;IAClD,mDAAmD;IACnD,SAAS,CAAC,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACpC,mCAAmC;IACnC,GAAG,CAAC,EAAE,eAAe,CAAC;IACtB,iBAAiB;IACjB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAmCD;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,0BAA+B,GACvC,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAwBnD"}

package/dist/system-changes/handler.js

@@ -0,0 +1,74 @@
+/**
+ * システム変更履歴の記録 Lambda のハンドラのファクトリ（ADR 0006 の (a)）。
+ *
+ * 直接呼び出し（`aws lambda invoke`。terraform のラッパー・人・CI）で使う。入力と応答は docs/SYSTEM_CHANGES.md。
+ * 呼び出しごとに Records（IAM 版 Function URL）のクライアントを作り、終わったら閉じる（`withCollection`）。
+ *
+ * 設定は、オプションが環境変数より優先される（どちらも呼び出しのたびに読む）:
+ * - `app`: PROJECT_NAME（必須）
+ * - `records.url` / `records.region`: RECORDS_IAM_URL（必須）/ AWS_REGION
+ * - Slack（任意。webhookParam が無ければ送らない）: SLACK_WEBHOOK_PARAM（SSM の SecureString の名前）/ ENV_NAME /
+ *   ADMIN_BASE_URL / NOTIFY_STARTED（'true' で開始も送る）
+ *
+ * 失敗の扱い: 入力の誤り・Records への書き込みの失敗は、構造化ログ（warn / error）に出し、例外にする（呼び出し元が
+ * `FunctionError` で分かるように）。Slack への送信の失敗は、記録を失敗にしない。
+ */
+import { GetParameterCommand, SSMClient } from '@aws-sdk/client-ssm';
+import { withCollection, } from '../client/recordsClient.js';
+import { SYSTEM_CHANGES_RESOURCE } from './record.js';
+import { RECORD_HTTP_TIMEOUT_MS, recordAndNotify, systemChangesCollectionOf, } from './recorder.js';
+/** SSM（SecureString）から webhook の URL を取る関数。param ごとに、実行環境の間は使い回す */
+function ssmWebhookGetter(client) {
+    const cache = new Map();
+    return async (param) => {
+        const hit = cache.get(param);
+        if (hit)
+            return hit;
+        const r = await client().send(new GetParameterCommand({ Name: param, WithDecryption: true }));
+        const url = r.Parameter?.Value;
+        if (!url)
+            throw new Error('webhook の値が空です');
+        cache.set(param, url);
+        return url;
+    };
+}
+const envOf = (name) => process.env[name] || undefined;
+/** Slack の設定を、オプションと環境変数から決める */
+function slackOf(options, defaultGetter) {
+    if (options.slack === false)
+        return undefined;
+    const s = options.slack ?? {};
+    return {
+        ...s,
+        webhookParam: s.webhookParam ?? envOf('SLACK_WEBHOOK_PARAM'),
+        env: s.env ?? envOf('ENV_NAME'),
+        adminBaseUrl: s.adminBaseUrl ?? envOf('ADMIN_BASE_URL'),
+        notifyStarted: s.notifyStarted ?? process.env.NOTIFY_STARTED === 'true',
+        getWebhookUrl: s.getWebhookUrl ?? defaultGetter,
+    };
+}
+/**
+ * 記録 Lambda のハンドラを作る。アプリのエントリは、これを export するだけ:
+ * `export const handler = createSystemChangeHandler();`
+ */
+export function createSystemChangeHandler(options = {}) {
+    let ssm = options.ssmClient;
+    const getFromSsm = ssmWebhookGetter(() => (ssm ??= new SSMClient({ region: options.records?.region ?? process.env.AWS_REGION })));
+    const wrap = options.collection ?? systemChangesCollectionOf;
+    return async (event) => {
+        const app = options.app ?? envOf('PROJECT_NAME');
+        if (!app)
+            throw new Error('PROJECT_NAME environment variable is required');
+        const url = options.records?.url ?? envOf('RECORDS_IAM_URL');
+        if (!url)
+            throw new Error('RECORDS_IAM_URL environment variable is required');
+        const records = {
+            ...options.records,
+            url,
+            timeout: options.records?.timeout ?? RECORD_HTTP_TIMEOUT_MS,
+        };
+        const slack = slackOf(options, getFromSsm);
+        return withCollection(SYSTEM_CHANGES_RESOURCE, (raw) => recordAndNotify(wrap(raw), event, { app, slack, log: options.log, now: options.now }), records);
+    };
+}
+//# sourceMappingURL=handler.js.map

package/dist/system-changes/handler.js.map

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

package/dist/system-changes/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * システム変更履歴（`@exabugs/dynamodb-client/system-changes`。ADR 0006 の (a)）
+ *
+ * 環境に起きたシステム変更（インフラの変更・Lambda のリリース・アプリのリリース・OTA）を、Records の
+ * `systemChanges` に記録し、結果を Slack に送る部品。記録 Lambda のハンドラのファクトリも持つ。
+ * アプリが渡すのは設定（アプリ名、SSM の名前、管理画面の URL、書き込み先の包み方）だけ。docs/SYSTEM_CHANGES.md
+ */
+export { createSystemChangeHandler } from './handler.js';
+export type { SystemChangeHandlerOptions } from './handler.js';
+export { CHANGE_ID_PATTERN, LIMITS, SYSTEM_CHANGES_RESOURCE, SYSTEM_CHANGE_KINDS, SYSTEM_CHANGE_RESULTS, SystemChangeInputError, decideRunWrite, isFinished, parseSystemChangeInput, toSystemChangeRecord, } from './record.js';
+export type { RunDecision, StoredSystemChange, SystemChangeInput, SystemChangeKind, SystemChangeRecord, SystemChangeResult, } from './record.js';
+export { RECORD_HTTP_TIMEOUT_MS, SLACK_HTTP_TIMEOUT_MS, recordAndNotify, recordSystemChange, systemChangesCollectionOf, } from './recorder.js';
+export type { RecordAndNotifyOptions, RecordOutcome, RecordSystemChangeOptions, SystemChangeLog, SystemChangeLogLevel, SystemChangeResponse, SystemChangeSlackOptions, SystemChangesCollection, } from './recorder.js';
+export { formatDuration, formatSystemChangeMessage, lambdaReleaseNames, shouldNotify, } from './slack.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/system-changes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/system-changes/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,YAAY,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EACL,iBAAiB,EACjB,MAAM,EACN,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,cAAc,EACd,UAAU,EACV,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,sBAAsB,EACtB,aAAa,EACb,yBAAyB,EACzB,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,cAAc,EACd,yBAAyB,EACzB,kBAAkB,EAClB,YAAY,GACb,MAAM,YAAY,CAAC"}

package/dist/system-changes/index.js

@@ -0,0 +1,12 @@
+/**
+ * システム変更履歴（`@exabugs/dynamodb-client/system-changes`。ADR 0006 の (a)）
+ *
+ * 環境に起きたシステム変更（インフラの変更・Lambda のリリース・アプリのリリース・OTA）を、Records の
+ * `systemChanges` に記録し、結果を Slack に送る部品。記録 Lambda のハンドラのファクトリも持つ。
+ * アプリが渡すのは設定（アプリ名、SSM の名前、管理画面の URL、書き込み先の包み方）だけ。docs/SYSTEM_CHANGES.md
+ */
+export { createSystemChangeHandler } from './handler.js';
+export { CHANGE_ID_PATTERN, LIMITS, SYSTEM_CHANGES_RESOURCE, SYSTEM_CHANGE_KINDS, SYSTEM_CHANGE_RESULTS, SystemChangeInputError, decideRunWrite, isFinished, parseSystemChangeInput, toSystemChangeRecord, } from './record.js';
+export { RECORD_HTTP_TIMEOUT_MS, SLACK_HTTP_TIMEOUT_MS, recordAndNotify, recordSystemChange, systemChangesCollectionOf, } from './recorder.js';
+export { formatDuration, formatSystemChangeMessage, lambdaReleaseNames, shouldNotify, } from './slack.js';
+//# sourceMappingURL=index.js.map

package/dist/system-changes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/system-changes/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAEzD,OAAO,EACL,iBAAiB,EACjB,MAAM,EACN,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,cAAc,EACd,UAAU,EACV,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AASrB,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,eAAe,CAAC;AAWvB,OAAO,EACL,cAAc,EACd,yBAAyB,EACzB,kBAAkB,EAClB,YAAY,GACb,MAAM,YAAY,CAAC"}