@exabugs/dynamodb-client 1.9.0 → 1.11.0

package/dist/notify/types.d.ts

@@ -0,0 +1,63 @@
+/**
+ * 運用通知の型
+ *
+ * 通知は `Notice` に正規化してから、重複抑制 → チャネルへ配信する。
+ * `Notice` には許可したフィールドだけを入れる（ログ全体を転送しない）。
+ */
+/** 通知するレベル。`ok` はアラームの復旧 */
+export type NoticeLevel = 'warn' | 'error' | 'fatal' | 'ok';
+export interface Notice {
+    level: NoticeLevel;
+    /** 機械可読の種別（例: SPARSE_SCAN、ALARM:astro-dev-xxx） */
+    event: string;
+    message: string;
+    app: string;
+    env: string;
+    /** 対象（コレクション名など）。重複抑制の指紋に使う */
+    target?: string;
+    /** 対策の案内 */
+    action?: string;
+    /** ISO 8601 */
+    occurredAt: string;
+    /** 抑制していた同種の通知の件数（今回を含まない） */
+    suppressed: number;
+}
+/** 配信先 */
+export interface Channel {
+    name: string;
+    /** メールなど、宛先（管理者）が必要なチャネルか */
+    needsRecipients: boolean;
+    send(notices: Notice[], recipients: string[]): Promise<void>;
+}
+/** 宛先（管理者のメールアドレス）の取得。スキーマは強制しない */
+export interface AdminDirectory {
+    listEmails(): Promise<string[]>;
+}
+export interface ClaimResult {
+    granted: boolean;
+    /** granted のとき、前回の窓の間に抑制した件数 */
+    suppressed: number;
+    /** granted のとき、確保の印（release に渡す。別の実行が取り直した確保を壊さないため） */
+    token: number;
+}
+/** 重複抑制・流量制限の記録 */
+export interface NoticeStore {
+    /**
+     * 指紋の窓を確保する。窓の中なら granted: false にして、抑制の件数を count 増やす。
+     * count は、この呼び出しが代表する発生の件数（同じバッチの重複をまとめたもの）
+     */
+    claim(fingerprint: string, windowSec: number, nowSec: number, count: number): Promise<ClaimResult>;
+    /**
+     * 送れなかった確保を解放する（次の発生で、窓を待たずに通知できる）。自分の確保（token）のときだけ。
+     * restore 件を抑制の件数に戻す（前回ぶん + 今回の発生）
+     */
+    release(fingerprint: string, token: number, restore: number): Promise<void>;
+    /** 流量の計数を n 増やし、窓の中の件数（増やした後）を返す */
+    consume(bucket: string, windowSec: number, nowSec: number, n: number): Promise<number>;
+}
+export interface NotifyLogger {
+    info(message: string, meta?: Record<string, unknown>): void;
+    warn(message: string, meta?: Record<string, unknown>): void;
+    error(message: string, meta?: Record<string, unknown>): void;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/notify/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,4BAA4B;AAC5B,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,IAAI,CAAC;AAE5D,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,WAAW,CAAC;IACnB,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,UAAU;AACV,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,eAAe,EAAE,OAAO,CAAC;IACzB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9D;AAED,oCAAoC;AACpC,MAAM,WAAW,cAAc;IAC7B,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;CACf;AAED,mBAAmB;AACnB,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,KAAK,CACH,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,WAAW,CAAC,CAAC;IACxB;;;OAGG;IACH,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5E,oCAAoC;IACpC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACxF;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC9D"}

package/dist/notify/types.js

@@ -0,0 +1,8 @@
+/**
+ * 運用通知の型
+ *
+ * 通知は `Notice` に正規化してから、重複抑制 → チャネルへ配信する。
+ * `Notice` には許可したフィールドだけを入れる（ログ全体を転送しない）。
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/notify/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/notify/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}