@exabugs/dynamodb-client 1.11.3 → 1.12.0

package/CHANGELOG.md

@@ -7,6 +7,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.12.0] - 2026-10-15
+
+### Added
+
+- **alerts（`@exabugs/dynamodb-client/notify`、任意）**: 通知を、指紋ごとに 1 件の `alerts` レコード（呼び出し側の Single-Table）として残し、通知の本文に管理画面の URL（`詳細: <adminBaseUrl>/alerts/<id>/show`）を足す（ADR 0003）。`createNotifyHandler` の任意の `recorder` / `adminBaseUrl` / `region` / `recordLimits` / `skipRecordEvents` / `skipRecordLogGroups`（Records のロググループを入れて、記録の失敗のループを防ぐ） / `recordBreaker`（記録の失敗が続いたら、コンテナごとに一定時間記録しない）、`createAlertRecorder`、`cleanupAlerts`（定時の削除）、`alertKeyOf`、`normalizeWithLogs`（ログ参照つきの正規化）、任意のインターフェース `AlertIndex`（`DynamoNoticeStore` / `MemoryNoticeStore` が実装。`al#` 行の `UpdateItem` だけ）。`recorder` を渡さなければ、挙動・出力は従来と同じ
+- react-admin の共通部品 `cloudWatchLogUrl` / `CloudWatchLogButton`（ログ参照から CloudWatch コンソールを開く。URL の形式は、ap-northeast-1 の実機のコンソールで確認済み）
+- `Notice.detailUrl`（任意）、`NotifyResult.recorded` / `unrecorded`（記録の単位 = alertKey の数。recorder があるときだけ） / `recordSuspended`、`LogRef`
+
+## [1.11.4] - 2026-10-14
+
+### Changed
+
+- **`createErrorResponse`の第5引数`details`を`logContext`に改め、レスポンスボディから完全に除外した。** 例外オブジェクトは「何が起きたか」の診断情報を持つだけで、それを外部にどう見せるか（レスポンスの形）は呼び出し側の責務であり、例外から自動的に継承しない。`error.details`はこれまでもどこからも読まれていなかった（React Admin連携含め未使用）
+- `errorHandler.ts`で個別に行っていたスタックトレースのログ出力を廃止し、`createErrorResponse`の`logContext`経由に統一（二重ログ・最終ステータス確定前のerror固定ログを防ぐ）
+
+### Fixed
+
+- `client`（HTTPクライアント）がサーバーのエラーレスポンス（`{success:false, error:{code, message, statusCode}}`）を誤って平坦な形として読んでおり、常に`response.statusText`にフォールバックしていた。ネストを正しく読み、`code`/`statusCode`をスローするErrorのプロパティとして保持するようにした（呼び出し側が4xx/5xxを判別できるようになる）
+
 ## [1.11.3] - 2026-10-13
 
 ### Fixed

package/dist/client/Collection.d.ts.map

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

package/dist/client/Collection.js

@@ -73,8 +73,16 @@ export class Collection {
             });
             clearTimeout(timeoutId);
             if (!response.ok) {
-                const error = (await response.json().catch(() => ({ message: response.statusText })));
-                throw new Error(`Request failed: ${error.message || response.statusText}`);
+                // サーバーのエラーレスポンスは { success: false, error: { code, message, statusCode } }
+                // というネスト構造。呼び出し元が4xx(想定内)か5xx(障害)かを判断できるように、
+                // code/statusCodeをErrorオブジェクトのプロパティとして保持する（messageに
+                // 埋め込むだけだと、呼び出し元は文字列マッチでしか判別できなくなる）
+                const body = (await response.json().catch(() => ({})));
+                const message = body.error?.message || response.statusText;
+                const err = new Error(`Request failed: ${message}`);
+                err.code = body.error?.code;
+                err.statusCode = body.error?.statusCode ?? response.status;
+                throw err;
             }
             const result = (await response.json());
             return result.data;

package/dist/client/Collection.js.map

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

package/dist/integrations/react-admin/components/CloudWatchLog/CloudWatchLogButton.d.ts

@@ -0,0 +1,14 @@
+import type { ReactElement } from 'react';
+export interface CloudWatchLogButtonProps {
+    /** ログ参照の項目名。既定 'lastLog'（'firstLog' も可） */
+    source?: string;
+    /** 既定 'CloudWatch で開く' */
+    label?: string;
+}
+/**
+ * alerts のレコードのログ参照を、CloudWatch のコンソールで開くボタン（AWS を操作できる人向けの補助）。
+ * ログ参照が無い（アラーム・直接呼び出しから来た）レコードでは、何も描画しない。
+ * リージョン・ドメイン・時間幅は、この部品が決める（呼び出し側は何も渡さない）
+ */
+export declare const CloudWatchLogButton: (props: CloudWatchLogButtonProps) => ReactElement | null;
+//# sourceMappingURL=CloudWatchLogButton.d.ts.map

package/dist/integrations/react-admin/components/CloudWatchLog/CloudWatchLogButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CloudWatchLogButton.d.ts","sourceRoot":"","sources":["../../../../../src/integrations/react-admin/components/CloudWatchLog/CloudWatchLogButton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAK1C,MAAM,WAAW,wBAAwB;IACvC,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,OAAO,wBAAwB,KAAG,YAAY,GAAG,IAepF,CAAC"}

package/dist/integrations/react-admin/components/CloudWatchLog/CloudWatchLogButton.js

@@ -0,0 +1,17 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Button, useRecordContext } from 'react-admin';
+import { cloudWatchLogUrl } from './cloudWatchLogUrl.js';
+/**
+ * alerts のレコードのログ参照を、CloudWatch のコンソールで開くボタン（AWS を操作できる人向けの補助）。
+ * ログ参照が無い（アラーム・直接呼び出しから来た）レコードでは、何も描画しない。
+ * リージョン・ドメイン・時間幅は、この部品が決める（呼び出し側は何も渡さない）
+ */
+export const CloudWatchLogButton = (props) => {
+    const { source = 'lastLog', label = 'CloudWatch で開く' } = props;
+    const record = useRecordContext();
+    const url = cloudWatchLogUrl(record?.[source]);
+    if (!url)
+        return null;
+    return (_jsx(Button, { component: "a", href: url, target: "_blank", rel: "noopener noreferrer", label: label, onClick: (e) => e.stopPropagation() }));
+};
+//# sourceMappingURL=CloudWatchLogButton.js.map

package/dist/integrations/react-admin/components/CloudWatchLog/CloudWatchLogButton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CloudWatchLogButton.js","sourceRoot":"","sources":["../../../../../src/integrations/react-admin/components/CloudWatchLog/CloudWatchLogButton.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AASzD;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,KAA+B,EAAuB,EAAE;IAC1F,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,GAAG,gBAAgB,EAAE,GAAG,KAAK,CAAC;IAC/D,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;IAClC,MAAM,GAAG,GAAG,gBAAgB,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/C,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,OAAO,CACL,KAAC,MAAM,IACL,SAAS,EAAC,GAAG,EACb,IAAI,EAAE,GAAG,EACT,MAAM,EAAC,QAAQ,EACf,GAAG,EAAC,qBAAqB,EACzB,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,CAAC,CAAkC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,EAAE,GACpE,CACH,CAAC;AACJ,CAAC,CAAC"}

package/dist/integrations/react-admin/components/CloudWatchLog/cloudWatchLogUrl.d.ts

@@ -0,0 +1,32 @@
+/**
+ * ログ参照（alerts の firstLog / lastLog）から、CloudWatch コンソールのログイベントの URL を作る。
+ *
+ * 形式（ap-northeast-1 の実機のコンソールで確認済み。aws-cn / aws-us-gov のドメインは未確認。docs/adr/0003-alerts.md）:
+ *   https://<コンソールのドメイン>/cloudwatch/home?region=<region>#logsV2:log-groups/log-group/<G>/log-events/<S><Q>
+ *   - <G>・<S>: ロググループ名・ストリーム名に encodeURIComponent を 2 回かけ、`%` を `$` に置き換えたもの
+ *   - <Q>: `?start=<ms>&end=<ms>` に encodeURIComponent を 1 回かけ、`%` を `$` に置き換えたもの
+ * リージョンからドメインを決める（aws / aws-cn / aws-us-gov）。呼び出し側は何も渡さない。
+ * それ以外のパーティション（`us-iso-east-1` などの ISO）や、形の不正なリージョンでは URL を作らない
+ * （ボタンを出さない）。
+ */
+/** ログ参照（@exabugs/dynamodb-client/notify の LogRef と同じ形） */
+export interface CloudWatchLogRef {
+    region: string;
+    logGroup: string;
+    logStream: string;
+    /** エポックミリ秒 */
+    timestamp: number;
+    requestId?: string;
+}
+export interface CloudWatchLogUrlOptions {
+    /** 発生時刻の前後に見る幅（ミリ秒）。既定 5 分 */
+    spanMs?: number;
+}
+/**
+ * リージョン → コンソールのドメイン。既知の形（商用・中国・GovCloud）でなければ undefined
+ * （入力をそのままドメインに埋め込まない）
+ */
+export declare function consoleDomainOf(region: string): string | undefined;
+/** ログ参照から URL を作る。参照が不正、または既知でないリージョン（ISO など）なら undefined */
+export declare function cloudWatchLogUrl(ref: unknown, options?: CloudWatchLogUrlOptions): string | undefined;
+//# sourceMappingURL=cloudWatchLogUrl.d.ts.map

package/dist/integrations/react-admin/components/CloudWatchLog/cloudWatchLogUrl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudWatchLogUrl.d.ts","sourceRoot":"","sources":["../../../../../src/integrations/react-admin/components/CloudWatchLog/cloudWatchLogUrl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,0DAA0D;AAC1D,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,8BAA8B;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AASD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMlE;AAmBD,6DAA6D;AAC7D,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,OAAO,EACZ,OAAO,GAAE,uBAA4B,GACpC,MAAM,GAAG,SAAS,CAcpB"}

package/dist/integrations/react-admin/components/CloudWatchLog/cloudWatchLogUrl.js

@@ -0,0 +1,63 @@
+/**
+ * ログ参照（alerts の firstLog / lastLog）から、CloudWatch コンソールのログイベントの URL を作る。
+ *
+ * 形式（ap-northeast-1 の実機のコンソールで確認済み。aws-cn / aws-us-gov のドメインは未確認。docs/adr/0003-alerts.md）:
+ *   https://<コンソールのドメイン>/cloudwatch/home?region=<region>#logsV2:log-groups/log-group/<G>/log-events/<S><Q>
+ *   - <G>・<S>: ロググループ名・ストリーム名に encodeURIComponent を 2 回かけ、`%` を `$` に置き換えたもの
+ *   - <Q>: `?start=<ms>&end=<ms>` に encodeURIComponent を 1 回かけ、`%` を `$` に置き換えたもの
+ * リージョンからドメインを決める（aws / aws-cn / aws-us-gov）。呼び出し側は何も渡さない。
+ * それ以外のパーティション（`us-iso-east-1` などの ISO）や、形の不正なリージョンでは URL を作らない
+ * （ボタンを出さない）。
+ */
+/** aws-us-gov（例: us-gov-west-1） */
+const GOV_REGION = /^us-gov-[a-z]+-\d{1,2}$/;
+/** aws-cn（例: cn-north-1） */
+const CN_REGION = /^cn-[a-z]+-\d{1,2}$/;
+/** aws（商用。例: ap-northeast-1）。ISO（us-iso-east-1、eu-isoe-west-1 など）は含めない */
+const COMMERCIAL_REGION = /^(?!cn-)[a-z]{2}-(?!gov-|iso)[a-z]+-\d{1,2}$/;
+/**
+ * リージョン → コンソールのドメイン。既知の形（商用・中国・GovCloud）でなければ undefined
+ * （入力をそのままドメインに埋め込まない）
+ */
+export function consoleDomainOf(region) {
+    if (typeof region !== 'string')
+        return undefined;
+    if (GOV_REGION.test(region))
+        return 'console.amazonaws-us-gov.com';
+    if (CN_REGION.test(region))
+        return 'console.amazonaws.cn';
+    if (COMMERCIAL_REGION.test(region))
+        return `${region}.console.aws.amazon.com`;
+    return undefined;
+}
+/** CloudWatch の URL のフラグメントのエンコード（`%` を `$` に） */
+const dollar = (s) => encodeURIComponent(s).replace(/%/g, '$');
+function isRef(v) {
+    if (typeof v !== 'object' || v === null)
+        return false;
+    const r = v;
+    return (typeof r.region === 'string' &&
+        typeof r.logGroup === 'string' &&
+        r.logGroup !== '' &&
+        typeof r.logStream === 'string' &&
+        r.logStream !== '' &&
+        typeof r.timestamp === 'number' &&
+        Number.isFinite(r.timestamp));
+}
+/** ログ参照から URL を作る。参照が不正、または既知でないリージョン（ISO など）なら undefined */
+export function cloudWatchLogUrl(ref, options = {}) {
+    if (!isRef(ref))
+        return undefined;
+    const domain = consoleDomainOf(ref.region);
+    if (!domain)
+        return undefined;
+    const span = Math.max(0, options.spanMs ?? 5 * 60 * 1000);
+    const start = Math.floor(ref.timestamp - span);
+    const end = Math.ceil(ref.timestamp + span);
+    const group = dollar(encodeURIComponent(ref.logGroup));
+    const stream = dollar(encodeURIComponent(ref.logStream));
+    const query = dollar(`?start=${start}&end=${end}`);
+    return (`https://${domain}/cloudwatch/home?region=${ref.region}` +
+        `#logsV2:log-groups/log-group/${group}/log-events/${stream}${query}`);
+}
+//# sourceMappingURL=cloudWatchLogUrl.js.map

package/dist/integrations/react-admin/components/CloudWatchLog/cloudWatchLogUrl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudWatchLogUrl.js","sourceRoot":"","sources":["../../../../../src/integrations/react-admin/components/CloudWatchLog/cloudWatchLogUrl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAiBH,mCAAmC;AACnC,MAAM,UAAU,GAAG,yBAAyB,CAAC;AAC7C,4BAA4B;AAC5B,MAAM,SAAS,GAAG,qBAAqB,CAAC;AACxC,0EAA0E;AAC1E,MAAM,iBAAiB,GAAG,8CAA8C,CAAC;AAEzE;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACjD,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,8BAA8B,CAAC;IACnE,IAAI,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,sBAAsB,CAAC;IAC1D,IAAI,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,GAAG,MAAM,yBAAyB,CAAC;IAC9E,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,kDAAkD;AAClD,MAAM,MAAM,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AAE/E,SAAS,KAAK,CAAC,CAAU;IACvB,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,CAAC,GAAG,CAA4B,CAAC;IACvC,OAAO,CACL,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ;QAC5B,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ;QAC9B,CAAC,CAAC,QAAQ,KAAK,EAAE;QACjB,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ;QAC/B,CAAC,CAAC,SAAS,KAAK,EAAE;QAClB,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ;QAC/B,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAC7B,CAAC;AACJ,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,gBAAgB,CAC9B,GAAY,EACZ,UAAmC,EAAE;IAErC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAClC,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3C,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,MAAM,CAAC,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;IACzD,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,KAAK,QAAQ,GAAG,EAAE,CAAC,CAAC;IACnD,OAAO,CACL,WAAW,MAAM,2BAA2B,GAAG,CAAC,MAAM,EAAE;QACxD,gCAAgC,KAAK,eAAe,MAAM,GAAG,KAAK,EAAE,CACrE,CAAC;AACJ,CAAC"}

package/dist/integrations/react-admin/components/CloudWatchLog/index.d.ts

@@ -0,0 +1,5 @@
+export { CloudWatchLogButton } from './CloudWatchLogButton.js';
+export type { CloudWatchLogButtonProps } from './CloudWatchLogButton.js';
+export { cloudWatchLogUrl, consoleDomainOf } from './cloudWatchLogUrl.js';
+export type { CloudWatchLogRef, CloudWatchLogUrlOptions } from './cloudWatchLogUrl.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/integrations/react-admin/components/CloudWatchLog/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/integrations/react-admin/components/CloudWatchLog/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC1E,YAAY,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/integrations/react-admin/components/CloudWatchLog/index.js

@@ -0,0 +1,3 @@
+export { CloudWatchLogButton } from './CloudWatchLogButton.js';
+export { cloudWatchLogUrl, consoleDomainOf } from './cloudWatchLogUrl.js';
+//# sourceMappingURL=index.js.map

package/dist/integrations/react-admin/components/CloudWatchLog/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/integrations/react-admin/components/CloudWatchLog/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/integrations/react-admin/components/index.d.ts

@@ -1,5 +1,7 @@
 /**
- * React-Admin 多対多関係コンポーネント
+ * React-Admin の共通部品（多対多関係、CloudWatch のログを開くボタン）
  */
 export { ReferenceManyToManyField, ReferenceManyToManyInput } from './ReferenceManyToMany/index.js';
+export { CloudWatchLogButton, cloudWatchLogUrl, consoleDomainOf } from './CloudWatchLog/index.js';
+export type { CloudWatchLogButtonProps, CloudWatchLogRef, CloudWatchLogUrlOptions, } from './CloudWatchLog/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/integrations/react-admin/components/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/integrations/react-admin/components/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/integrations/react-admin/components/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AACpG,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAClG,YAAY,EACV,wBAAwB,EACxB,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,0BAA0B,CAAC"}

package/dist/integrations/react-admin/components/index.js

@@ -1,5 +1,6 @@
 /**
- * React-Admin 多対多関係コンポーネント
+ * React-Admin の共通部品（多対多関係、CloudWatch のログを開くボタン）
  */
 export { ReferenceManyToManyField, ReferenceManyToManyInput } from './ReferenceManyToMany/index.js';
+export { CloudWatchLogButton, cloudWatchLogUrl, consoleDomainOf } from './CloudWatchLog/index.js';
 //# sourceMappingURL=index.js.map

package/dist/integrations/react-admin/components/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/integrations/react-admin/components/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/integrations/react-admin/components/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AACpG,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/integrations/react-admin/index.d.ts

@@ -23,4 +23,6 @@ export { createDataProvider } from './dataProvider.js';
 export type { DynamoDataProvider } from './dataProvider.js';
 export type { DataProviderOptions, ReferenceManyToManyFieldProps, ReferenceManyToManyInputProps, TokenProvider, } from './types.js';
 export { ReferenceManyToManyField, ReferenceManyToManyInput } from './components/index.js';
+export { CloudWatchLogButton, cloudWatchLogUrl, consoleDomainOf } from './components/index.js';
+export type { CloudWatchLogButtonProps, CloudWatchLogRef, CloudWatchLogUrlOptions, } from './components/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/integrations/react-admin/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/integrations/react-admin/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,YAAY,EACV,mBAAmB,EACnB,6BAA6B,EAC7B,6BAA6B,EAC7B,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/integrations/react-admin/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,YAAY,EACV,mBAAmB,EACnB,6BAA6B,EAC7B,6BAA6B,EAC7B,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAC3F,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC/F,YAAY,EACV,wBAAwB,EACxB,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC"}

package/dist/integrations/react-admin/index.js

@@ -21,4 +21,5 @@
  */
 export { createDataProvider } from './dataProvider.js';
 export { ReferenceManyToManyField, ReferenceManyToManyInput } from './components/index.js';
+export { CloudWatchLogButton, cloudWatchLogUrl, consoleDomainOf } from './components/index.js';
 //# sourceMappingURL=index.js.map

package/dist/integrations/react-admin/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/integrations/react-admin/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAQvD,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/integrations/react-admin/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAQvD,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAC3F,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/notify/alerts.d.ts

@@ -0,0 +1,145 @@
+import type { AlertIndex, LogRef, Notice } from './types.js';
+/**
+ * alerts のリソース名。target が alerts の通知は記録しない。
+ * ただし Records の失敗ログの多く（`Request failed` など）には resource が出ないので、これだけでは
+ * ループを防げない。Records のロググループは skipRecordLogGroups に入れる（handler の遮断は最後の防壁）
+ */
+export declare const ALERTS_RESOURCE = "alerts";
+/** 保存期間（最後の発生から） */
+export declare const ALERT_RETENTION_DAYS = 28;
+/**
+ * alerts のキー。重複抑制の指紋（fingerprintOf）と同じだが、アラーム（`ALARM:` で始まる event）は
+ * level を除いて 1 件にまとめる（ALARM → OK を同じレコードの state で追う）
+ */
+export declare function alertKeyOf(n: Pick<Notice, 'app' | 'env' | 'level' | 'event' | 'target'>): string;
+/** 1 回の発生（最初・最後） */
+export interface AlertOccurrence {
+    /** ISO 8601 */
+    occurredAt: string;
+    /** ログの購読から来た通知だけ */
+    log?: LogRef;
+}
+/** 記録する 1 件（同じ alertKey の、同じ呼び出しの中の発生をまとめたもの） */
+export interface AlertInput {
+    /** 最後の発生の通知（level・message などは、これを写す） */
+    notice: Notice;
+    /** この呼び出しの中の発生の件数 */
+    count: number;
+    first: AlertOccurrence;
+    last: AlertOccurrence;
+}
+/** alerts のレコード（管理画面が読む形） */
+export interface AlertRecord {
+    id: string;
+    level: Notice['level'];
+    event: string;
+    message: string;
+    target?: string;
+    action?: string;
+    /** alertKey */
+    fingerprint: string;
+    /** アラームだけ: 'ALARM' | 'OK' */
+    state?: 'ALARM' | 'OK';
+    /** 通知ストアの件数を写した目安 */
+    count: number;
+    firstSeenAt: string;
+    lastSeenAt: string;
+    firstLog?: LogRef;
+    lastLog?: LogRef;
+    createdAt?: string;
+    updatedAt?: string;
+}
+/**
+ * 書き込み先（`collection.updateOne` を持つもの。IAM クライアントの Collection がそのまま合う）。
+ * - upsert（`upsert: true`）: 必ず `$set` と `$setOnInsert` を一緒に送る（`$setOnInsert` だけだと、
+ *   キーがそのまま項目になる）。新規作成になりうるので、null を送らない（作成では null がそのまま保存される）
+ * - 項目の削除（`upsert: false`）: `$set` に null だけを送る。既存のレコードにだけ効く（無ければ作らない）
+ */
+export interface AlertsCollection {
+    updateOne(filter: {
+        id: string;
+    }, update: {
+        $set: Record<string, unknown>;
+        $setOnInsert?: Record<string, unknown>;
+    }, options: {
+        upsert: boolean;
+    }): Promise<unknown>;
+}
+export interface AlertRecorder {
+    record(input: AlertInput): Promise<{
+        id: string;
+        isNew: boolean;
+        count: number;
+    }>;
+}
+export interface AlertRecorderOptions {
+    collection: AlertsCollection;
+    /** 集計（通常は DynamoNoticeStore。UpdateItem だけを使う） */
+    index: AlertIndex;
+    /** 既定 28（cleanupAlerts の olderThanDays と揃える） */
+    retentionDays?: number;
+    now?: () => Date;
+    /** 既定 ULID */
+    newId?: () => string;
+}
+/**
+ * 通知 1 件を、alerts レコードに記録する部品。
+ * 集計（ID・件数・最初の時刻）を通知ストアで原子的に更新し、その結果を Records の upsert で写す。
+ *
+ * isNew が false でも、レコードがまだ無いことがある（前回の Records への書き込みが失敗・時間切れで、
+ * 通知ストアの行だけが進んだ）。そのため、どの回でも:
+ * - upsert には null を入れない（作成では null がそのまま保存される）
+ * - firstSeenAt は通知ストアの値（count と同じ行）を使う。firstLog は isNew のときだけ
+ *   （isNew でないのに作成になったときは、firstLog の無いレコードになる。違う回のログを最初として残さない）
+ * - 無くなった任意の項目（action・lastLog.requestId。target は alertKey に含まれるので変わらない）は、upsert の後に、既存のレコードにだけ効く
+ *   更新（upsert: false。null は JSON Merge Patch の削除）で消す。isNew のときは消すものが無いので送らない
+ */
+export declare function createAlertRecorder(options: AlertRecorderOptions): AlertRecorder;
+/** 削除で使う形（`find` と `deleteMany` を持つもの。IAM クライアントの Collection がそのまま合う） */
+export interface AlertsCleanupCollection {
+    find(filter: Record<string, never>, options: {
+        sort: {
+            lastSeenAt: 'asc';
+        };
+        limit: number;
+    }): {
+        toArray(): Promise<Array<{
+            id: string;
+            lastSeenAt?: unknown;
+        }>>;
+    };
+    deleteMany(filter: {
+        id: {
+            $in: string[];
+        };
+    }): Promise<{
+        deletedCount: number;
+    }>;
+}
+export interface CleanupAlertsOptions {
+    collection: AlertsCleanupCollection;
+    /** 既定 28 */
+    olderThanDays?: number;
+    /** 1 回の実行で消す上限（残りは次回）。既定 500 */
+    maxPerRun?: number;
+    now?: () => Date;
+}
+export interface CleanupAlertsResult {
+    /** 消した件数 */
+    deleted: number;
+    /** 消せなかった件数（deleteMany の結果が要求より少なかった分） */
+    failed: number;
+    /** 失敗の内容（握りつぶさない。呼び出し側がログ・例外にする） */
+    errors: string[];
+    /** 上限で止めた（古いものが残っているかもしれない） */
+    more: boolean;
+}
+/**
+ * 最後の発生から olderThanDays 日を過ぎた alerts を消す（アプリの定時 Lambda から呼ぶ）。
+ *
+ * `lastSeenAt: { $lt }` の範囲検索は、実際の DynamoDB では ValidationException になる（TODO.md）。
+ * そのため、条件なしに `lastSeenAt` 昇順で 1 ページずつ読み、期限内のものが出たら止める。
+ * 読んだら直ちに ID で消す（読み→削除の間を短くし、存在しない ID の削除で warn を出さない）
+ */
+export declare function cleanupAlerts(options: CleanupAlertsOptions): Promise<CleanupAlertsResult>;
+//# sourceMappingURL=alerts.d.ts.map

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

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

package/dist/notify/alerts.js

@@ -0,0 +1,152 @@
+/**
+ * alerts（ADR 0003）: 通知を、管理画面で見られるレコードとして残す。
+ *
+ * - 指紋（alertKey）ごとに 1 レコード。ID は ULID。集計（ID・件数）の正は通知ストアの行（AlertIndex）
+ * - レコードは、呼び出し側の Records（IAM の Function URL など）に `alerts` リソースとして書く。
+ *   ライブラリはクライアントを import せず、構造的な型（AlertsCollection）で受け取る
+ * - 保存は最後の発生から 28 日。削除は、アプリの定時 Lambda が cleanupAlerts を呼ぶ（ネイティブ TTL は効かない）
+ */
+import { ulid } from '../shared/utils/ulid.js';
+/**
+ * alerts のリソース名。target が alerts の通知は記録しない。
+ * ただし Records の失敗ログの多く（`Request failed` など）には resource が出ないので、これだけでは
+ * ループを防げない。Records のロググループは skipRecordLogGroups に入れる（handler の遮断は最後の防壁）
+ */
+export const ALERTS_RESOURCE = 'alerts';
+/** 保存期間（最後の発生から） */
+export const ALERT_RETENTION_DAYS = 28;
+const isAlarm = (n) => n.event.startsWith('ALARM:');
+/**
+ * alerts のキー。重複抑制の指紋（fingerprintOf）と同じだが、アラーム（`ALARM:` で始まる event）は
+ * level を除いて 1 件にまとめる（ALARM → OK を同じレコードの state で追う）
+ */
+export function alertKeyOf(n) {
+    const level = isAlarm(n) ? 'alarm' : n.level;
+    return [n.app, n.env, level, n.event, n.target ?? ''].join('#').slice(0, 512);
+}
+/** undefined の項目を除く（JSON に出ない値を、送る前に落とす） */
+function defined(o) {
+    return Object.fromEntries(Object.entries(o).filter(([, v]) => v !== undefined));
+}
+/**
+ * 通知 1 件を、alerts レコードに記録する部品。
+ * 集計（ID・件数・最初の時刻）を通知ストアで原子的に更新し、その結果を Records の upsert で写す。
+ *
+ * isNew が false でも、レコードがまだ無いことがある（前回の Records への書き込みが失敗・時間切れで、
+ * 通知ストアの行だけが進んだ）。そのため、どの回でも:
+ * - upsert には null を入れない（作成では null がそのまま保存される）
+ * - firstSeenAt は通知ストアの値（count と同じ行）を使う。firstLog は isNew のときだけ
+ *   （isNew でないのに作成になったときは、firstLog の無いレコードになる。違う回のログを最初として残さない）
+ * - 無くなった任意の項目（action・lastLog.requestId。target は alertKey に含まれるので変わらない）は、upsert の後に、既存のレコードにだけ効く
+ *   更新（upsert: false。null は JSON Merge Patch の削除）で消す。isNew のときは消すものが無いので送らない
+ */
+export function createAlertRecorder(options) {
+    const now = options.now ?? (() => new Date());
+    const newId = options.newId ?? ulid;
+    const keepSec = (options.retentionDays ?? ALERT_RETENTION_DAYS) * 86400;
+    return {
+        async record({ notice: n, count, first, last }) {
+            const key = alertKeyOf(n);
+            const t = await options.index.touchAlert(key, {
+                newId: newId(),
+                n: count,
+                nowSec: Math.floor(now().getTime() / 1000),
+                at: last.occurredAt,
+                firstAt: first.occurredAt,
+                keepSec,
+            });
+            // 既存のレコードの更新は JSON Merge Patch（入れ子は深くマージ）。lastLog は必須のキーを全部送る
+            const $set = defined({
+                level: n.level,
+                event: n.event,
+                message: n.message,
+                target: n.target,
+                action: n.action,
+                fingerprint: key,
+                state: isAlarm(n) ? (n.level === 'ok' ? 'OK' : 'ALARM') : undefined,
+                count: t.count,
+                lastSeenAt: last.occurredAt,
+                lastLog: last.log ? defined({ ...last.log }) : undefined,
+            });
+            const $setOnInsert = defined({
+                firstSeenAt: t.firstSeenAt,
+                firstLog: t.isNew ? first.log : undefined,
+            });
+            await options.collection.updateOne({ id: t.alertId }, { $set, $setOnInsert }, { upsert: true });
+            if (!t.isNew) {
+                // 直前の upsert でレコードは必ずある。lastLog も直前に書いたので、requestId だけを消せる
+                // target は alertKey に含まれるので、同じレコードでは変わらない（消すことは無い）
+                const unset = defined({
+                    action: n.action === undefined ? null : undefined,
+                    lastLog: last.log && last.log.requestId === undefined ? { requestId: null } : undefined,
+                });
+                if (Object.keys(unset).length > 0) {
+                    await options.collection.updateOne({ id: t.alertId }, { $set: unset }, { upsert: false });
+                }
+            }
+            return { id: t.alertId, isNew: t.isNew, count: t.count };
+        },
+    };
+}
+/** Records の 1 ページの上限 */
+const PAGE = 50;
+/**
+ * 最後の発生から olderThanDays 日を過ぎた alerts を消す（アプリの定時 Lambda から呼ぶ）。
+ *
+ * `lastSeenAt: { $lt }` の範囲検索は、実際の DynamoDB では ValidationException になる（TODO.md）。
+ * そのため、条件なしに `lastSeenAt` 昇順で 1 ページずつ読み、期限内のものが出たら止める。
+ * 読んだら直ちに ID で消す（読み→削除の間を短くし、存在しない ID の削除で warn を出さない）
+ */
+export async function cleanupAlerts(options) {
+    const now = options.now ?? (() => new Date());
+    const days = options.olderThanDays ?? ALERT_RETENTION_DAYS;
+    const maxPerRun = Math.max(1, options.maxPerRun ?? 500);
+    const cutoff = new Date(now().getTime() - days * 86400 * 1000).toISOString();
+    const result = { deleted: 0, failed: 0, errors: [], more: false };
+    while (result.deleted < maxPerRun) {
+        const limit = Math.min(PAGE, maxPerRun - result.deleted);
+        let page;
+        try {
+            page = await options.collection.find({}, { sort: { lastSeenAt: 'asc' }, limit }).toArray();
+        }
+        catch (e) {
+            result.errors.push(`取得に失敗しました: ${e instanceof Error ? e.message : String(e)}`);
+            return result;
+        }
+        const ids = [];
+        let reachedFresh = false;
+        for (const r of page) {
+            if (typeof r.lastSeenAt !== 'string') {
+                result.errors.push(`lastSeenAt が文字列でないレコードで止めました: ${r.id}`);
+                return result;
+            }
+            if (r.lastSeenAt >= cutoff) {
+                reachedFresh = true;
+                break;
+            }
+            ids.push(r.id);
+        }
+        if (ids.length > 0) {
+            try {
+                const r = await options.collection.deleteMany({ id: { $in: ids } });
+                result.deleted += r.deletedCount;
+                if (r.deletedCount < ids.length) {
+                    // 同じものを読み直して回り続けないよう、ここで止める
+                    result.failed += ids.length - r.deletedCount;
+                    result.errors.push(`${ids.length} 件のうち ${ids.length - r.deletedCount} 件を消せませんでした`);
+                    return result;
+                }
+            }
+            catch (e) {
+                result.failed += ids.length;
+                result.errors.push(`削除に失敗しました: ${e instanceof Error ? e.message : String(e)}`);
+                return result;
+            }
+        }
+        if (reachedFresh || page.length < limit)
+            return result;
+    }
+    result.more = true;
+    return result;
+}
+//# sourceMappingURL=alerts.js.map