@interactive-inc/flume 0.9.4 → 0.10.1

package/dist/safe-json-parse.js

@@ -1,4 +1,4 @@
-import { o as FlumeParseError } from "./flume-source.js";
+import { s as FlumeParseError } from "./flume-source.js";
 //#region lib/utils/safe-json-parse.ts
 function safeJsonParse(raw) {
 	try {

package/dist/safe-read-text.js

@@ -1,17 +1,20 @@
-import { l as safeErrorMessage } from "./flume-source.js";
+import { c as attempt, u as safeErrorMessage } from "./flume-source.js";
 import { t as FlumeHttpError } from "./http-error.js";
 //#region lib/utils/safe-read-text.ts
 /**
 * `response.text()` を保護する。body 読み取り中の reject (接続切断 / 解凍失敗 / 二重消費) を
-* `FlumeHttpError` (status / cause 保持) に変換する。log には書かない (呼び出し側で書く)
+* `FlumeHttpError` (status / cause 保持) に変換する。DI モックの `status` getter が throw
+* しても reject しない。log には書かない (呼び出し側で書く)
 */
 async function safeReadText(props) {
 	try {
 		return await props.response.text();
 	} catch (err) {
+		const statusResult = attempt(() => props.response.status);
+		const status = typeof statusResult === "number" ? statusResult : 0;
 		return new FlumeHttpError({
 			message: `${props.context}: failed to read body: ${safeErrorMessage({ error: err })}`,
-			status: props.response.status,
+			status,
 			cause: err
 		});
 	}

package/dist/safe-stringify.js

@@ -1,32 +1,39 @@
-import { l as safeErrorMessage, n as safeInvokeCallback, s as attempt } from "./flume-source.js";
+import { c as attempt, r as safeInvokeCallback, s as FlumeParseError, u as safeErrorMessage } from "./flume-source.js";
 import { t as FlumeConnectionError } from "./connection-error.js";
 //#region lib/utils/safe-random.ts
 /**
-* `deps.random()` を保護する。throw / 範囲外値 / 非数値が返った場合は 0.5 を返す。
-* 0 以上 1 未満 (Math.random と同等) の値のみそのまま透過
+* `deps.random()` を保護する。throw / 範囲外値 / 非数値が返った場合は `Math.random()` へ
+* フォールバックする。0 以上 1 未満 (Math.random と同等) の値のみそのまま透過。
+* `Math.random` 自体まで壊れている病的環境でのみ 0.5 を返す
 */
 function safeRandom(props) {
 	try {
 		const value = props.deps.random();
-		if (typeof value !== "number" || !Number.isFinite(value)) return .5;
-		if (value < 0 || value >= 1) return .5;
-		return value;
+		if (typeof value === "number" && Number.isFinite(value) && value >= 0 && value < 1) return value;
+	} catch {}
+	try {
+		const native = Math.random();
+		if (typeof native === "number" && Number.isFinite(native) && native >= 0 && native < 1) return native;
+		return .5;
 	} catch {
 		return .5;
 	}
 }
 //#endregion
 //#region lib/reconnector.ts
+const MAX_TIMER_DELAY_MS = 2147483647;
 /**
 * 指数バックオフ + ジッタ付きの再接続スケジューラ。
-* `schedule()` の戻り値: 正の delay = 予約成功 / -1 = 試行上限到達 / 0 = cancel 済み or 内部 timer 拒否。
-* setTimeout コールバック内のユーザー fn が throw / reject しても reconnect ループは止めない
+* setTimeout コールバック内のユーザー fn が throw / reject しても reconnect ループは止めない。
+* `generation` は clearTimeout が throw して古い timer が生き残った場合でも
+* stale な発火を無視するための世代トークン
 */
 var FlumeReconnector = class {
 	props;
 	currentAttempt = 0;
 	isAborted = false;
 	timer = null;
+	generation = 0;
 	constructor(props) {
 		this.props = props;
 	}
@@ -36,12 +43,17 @@ var FlumeReconnector = class {
 	get aborted() {
 		return this.isAborted;
 	}
-	schedule(fn) {
-		if (this.isAborted) return 0;
-		if (this.currentAttempt >= this.props.maxAttempts) return -1;
+	schedule(fn, options) {
+		if (this.isAborted) return { kind: "refused" };
+		if (this.currentAttempt >= this.props.maxAttempts) {
+			this.generation++;
+			this.clearTimer();
+			return { kind: "exhausted" };
+		}
 		this.clearTimer();
-		const delay = this.computeDelay();
-		const timerResult = attempt(() => this.props.deps.setTimeout(() => this.runRetry(fn), delay));
+		const delay = this.computeDelay(options?.minDelayMs ?? 0);
+		const scheduledGeneration = ++this.generation;
+		const timerResult = attempt(() => this.props.deps.setTimeout(() => this.runRetry(fn, scheduledGeneration), delay));
 		if (timerResult instanceof Error) {
 			this.props.log.error({
 				action: "reconnect.timer.schedule.error",
@@ -49,20 +61,26 @@ var FlumeReconnector = class {
 				error: timerResult
 			});
 			this.timer = null;
-			return 0;
+			return { kind: "refused" };
 		}
 		this.currentAttempt++;
 		this.timer = timerResult;
-		return delay;
+		return {
+			kind: "scheduled",
+			delayMs: delay
+		};
 	}
 	reset() {
 		this.currentAttempt = 0;
 	}
 	cancel() {
 		this.isAborted = true;
+		this.generation++;
 		this.clearTimer();
 	}
-	runRetry(fn) {
+	runRetry(fn, scheduledGeneration) {
+		if (this.isAborted) return;
+		if (scheduledGeneration !== this.generation) return;
 		this.timer = null;
 		safeInvokeCallback({
 			fn,
@@ -86,19 +104,22 @@ var FlumeReconnector = class {
 		});
 		this.timer = null;
 	}
-	computeDelay() {
-		return Math.min(this.props.baseDelay * 2 ** this.currentAttempt, this.props.maxDelay) * (.5 + safeRandom({ deps: this.props.deps }) * .5);
+	computeDelay(minDelayMs) {
+		const jittered = Math.min(this.props.baseDelay * 2 ** this.currentAttempt, this.props.maxDelay) * (.5 + safeRandom({ deps: this.props.deps }) * .5);
+		return Math.min(Math.max(jittered, Number.isFinite(minDelayMs) && minDelayMs > 0 ? minDelayMs : 0), MAX_TIMER_DELAY_MS);
 	}
 };
 //#endregion
 //#region lib/schedule-reconnect.ts
 /**
 * 接続が落ちた際の共通再接続スケジューラ。
-* 再接続の設定状況 (無効 / 中止 / 試行尽き) を見極めてからステータス遷移する。
+* 再接続の設定状況 (無効 / 中止 / 試行尽き / timer 拒否) を見極めてからステータス遷移する。
 * - reconnector が無ければ reconnect.disabled を info ログし disconnected へ
 * - cancel 済みなら reconnect.aborted を info ログし disconnected へ
-* - schedule() が -1 を返したら reconnect.exhausted を error ログし disconnected へ
-* - それ以外は reconnecting へ遷移し reconnect.scheduled を info ログ
+* - schedule() が exhausted なら reconnect.exhausted を error ログし disconnected へ
+* - schedule() が refused (timer 予約失敗) なら reconnect.refused を error ログし disconnected へ
+*   ("reconnecting" のまま発火しない timer を待ち続けるハングを防ぐ)
+* - scheduled なら reconnecting へ遷移し reconnect.scheduled を info ログ
 */
 function scheduleFlumeReconnect(props) {
 	if (!props.reconnector) {
@@ -117,8 +138,8 @@ function scheduleFlumeReconnect(props) {
 		props.setStatus("disconnected");
 		return;
 	}
-	const delay = props.reconnector.schedule(props.retry);
-	if (delay === -1) {
+	const schedule = props.reconnector.schedule(props.retry, { minDelayMs: props.minDelayMs });
+	if (schedule.kind === "exhausted") {
 		const error = new FlumeConnectionError(`reconnect exhausted after ${props.reconnector.attempt} attempts`);
 		props.log.error({
 			action: "reconnect.exhausted",
@@ -128,24 +149,39 @@ function scheduleFlumeReconnect(props) {
 		props.setStatus("disconnected");
 		return;
 	}
+	if (schedule.kind === "refused") {
+		const error = new FlumeConnectionError("reconnect timer could not be scheduled");
+		props.log.error({
+			action: "reconnect.refused",
+			message: safeErrorMessage({ error }),
+			error
+		});
+		props.setStatus("disconnected");
+		return;
+	}
 	props.setStatus("reconnecting");
 	props.log.info({
 		action: "reconnect.scheduled",
-		message: `next attempt in ${Math.round(delay)}ms`,
+		message: `next attempt in ${Math.round(schedule.delayMs)}ms`,
 		detail: {
 			attempt: props.reconnector.attempt,
-			delayMs: Math.round(delay)
+			delayMs: Math.round(schedule.delayMs)
 		}
 	});
 }
 //#endregion
 //#region lib/utils/safe-stringify.ts
 /**
-* `JSON.stringify` を `string | Error` に変換するだけのラッパ。
-* cyclic / BigInt / throwing toJSON など標準が throw するケースを Error として返す
+* `JSON.stringify` を `string | Error` に変換するラッパ。
+* cyclic / BigInt / throwing toJSON など標準が throw するケースを Error として返す。
+* `undefined` / function / symbol は `JSON.stringify` が (型定義に反して) `undefined` を
+* 返すため、これも Error に正規化して戻り値を必ず string にする
 */
 function safeStringify(value) {
-	return attempt(() => JSON.stringify(value));
+	const result = attempt(() => JSON.stringify(value));
+	if (result instanceof Error) return result;
+	if (typeof result !== "string") return new FlumeParseError("value is not JSON-serializable (undefined / function / symbol)");
+	return result;
 }
 //#endregion
 export { safeRandom as i, scheduleFlumeReconnect as n, FlumeReconnector as r, safeStringify as t };

package/dist/slack.d.ts

@@ -1,4 +1,4 @@
-import { t as FlumeSource, w as FlumeSourceStartContext, x as FlumeSlackSourceOptions, y as FlumeSlackEnvelope } from "./flume-source.js";
+import { C as FlumeSlackEnvelope, O as FlumeSourceStartContext, T as FlumeSlackSourceOptions, t as FlumeSource } from "./flume-source.js";
 
 //#region lib/slack/slack-source.d.ts
 declare class FlumeSlackSource extends FlumeSource {
@@ -13,7 +13,14 @@ declare class FlumeSlackSource extends FlumeSource {
   protected disconnect(): void;
   private hasWebSocket;
   private connectInternal;
+  private isTerminalSlackError;
+  private minRetryDelayMs;
   private handleMessage;
+  /**
+   * Events API の再配送は envelope_id が変わり得るため、payload.event_id があれば
+   * そちらを重複判定キーとして優先する (再配送をまたいで安定な識別子)
+   */
+  private toDedupKey;
   private safeExtractMeta;
   private scheduleReconnect;
 }