@interactive-inc/flume 0.10.0 → 0.10.1

package/dist/time-source.js

@@ -1,427 +0,0 @@
-import { a as FlumeStartError, c as safeNormalizeError, i as safeNow, l as safeErrorMessage, n as safeInvokeCallback, o as FlumeParseError, r as FlumeLogger, s as attempt, t as FlumeSource } from "./flume-source.js";
-import { t as isRecord } from "./is-record.js";
-//#region lib/time/parse-cron-field.ts
-/**
-* 単一 cron フィールド (minute など) の spec を許可値の Set に展開する。
-* 対応: `*` / `* /n` / `a` / `a-b` / `a-b/n` とそれらのカンマ区切り。名前 (JAN, MON) は非対応
-*/
-function parseCronField(spec, min, max) {
-	const values = /* @__PURE__ */ new Set();
-	for (const part of spec.split(",")) {
-		const expanded = expandCronPart(part, min, max);
-		if (expanded instanceof FlumeParseError) return expanded;
-		for (const value of expanded) values.add(value);
-	}
-	if (values.size === 0) return new FlumeParseError(`cron field empty: "${spec}"`);
-	return values;
-}
-function expandCronPart(part, min, max) {
-	let range = part;
-	let step = 1;
-	const slash = part.indexOf("/");
-	if (slash !== -1) {
-		range = part.slice(0, slash);
-		const parsed = Number(part.slice(slash + 1));
-		if (!Number.isInteger(parsed) || parsed <= 0) return new FlumeParseError(`invalid cron step: "${part}"`);
-		step = parsed;
-	}
-	const bounds = resolveBounds(range, min, max);
-	if (bounds instanceof FlumeParseError) return bounds;
-	const numbers = [];
-	for (let value = bounds.lo; value <= bounds.hi; value += step) numbers.push(value);
-	return numbers;
-}
-function resolveBounds(range, min, max) {
-	if (range === "*") return {
-		lo: min,
-		hi: max
-	};
-	const dash = range.indexOf("-");
-	const lo = dash === -1 ? Number(range) : Number(range.slice(0, dash));
-	const hi = dash === -1 ? lo : Number(range.slice(dash + 1));
-	if (!Number.isInteger(lo) || !Number.isInteger(hi)) return new FlumeParseError(`invalid cron range: "${range}"`);
-	if (lo < min || hi > max || lo > hi) return new FlumeParseError(`cron value out of range [${min}-${max}]: "${range}"`);
-	return {
-		lo,
-		hi
-	};
-}
-//#endregion
-//#region lib/time/parse-cron.ts
-/**
-* 5 フィールド cron 式をパースする。dow は 0-7 を許可し 7 を 0 (日曜) に正規化する
-*/
-function parseCron(expression) {
-	const trimmed = expression.trim();
-	const fields = trimmed.split(/\s+/);
-	if (fields.length !== 5) return new FlumeParseError(`cron must have 5 fields, got ${fields.length}: "${expression}"`);
-	const minutes = parseCronField(fields[0] ?? "", 0, 59);
-	if (minutes instanceof FlumeParseError) return minutes;
-	const hours = parseCronField(fields[1] ?? "", 0, 23);
-	if (hours instanceof FlumeParseError) return hours;
-	const daysOfMonth = parseCronField(fields[2] ?? "", 1, 31);
-	if (daysOfMonth instanceof FlumeParseError) return daysOfMonth;
-	const months = parseCronField(fields[3] ?? "", 1, 12);
-	if (months instanceof FlumeParseError) return months;
-	const rawDaysOfWeek = parseCronField(fields[4] ?? "", 0, 7);
-	if (rawDaysOfWeek instanceof FlumeParseError) return rawDaysOfWeek;
-	const daysOfWeek = /* @__PURE__ */ new Set();
-	for (const value of rawDaysOfWeek) daysOfWeek.add(value === 7 ? 0 : value);
-	return {
-		source: trimmed,
-		minutes,
-		hours,
-		daysOfMonth,
-		months,
-		daysOfWeek,
-		domRestricted: fields[2] !== "*",
-		dowRestricted: fields[4] !== "*"
-	};
-}
-//#endregion
-//#region lib/time/cron-next.ts
-const MINUTE_MS = 6e4;
-const MAX_ITERATIONS = 5e5;
-/**
-* `afterMs` より後の最初の cron マッチ時刻 (epoch ms) を壁時計 (local time) で求める。
-* 到達不能なら FlumeParseError を返す
-*/
-function flumeCronNext(cron, afterMs) {
-	let candidate = Math.floor(afterMs / MINUTE_MS) * MINUTE_MS + MINUTE_MS;
-	for (let iteration = 0; iteration < MAX_ITERATIONS; iteration++) {
-		const date = new Date(candidate);
-		if (!cron.months.has(date.getMonth() + 1)) {
-			candidate = new Date(date.getFullYear(), date.getMonth() + 1, 1, 0, 0, 0, 0).getTime();
-			continue;
-		}
-		if (!matchesDay(cron, date)) {
-			candidate = new Date(date.getFullYear(), date.getMonth(), date.getDate() + 1, 0, 0, 0, 0).getTime();
-			continue;
-		}
-		if (!cron.hours.has(date.getHours())) {
-			candidate = new Date(date.getFullYear(), date.getMonth(), date.getDate(), date.getHours() + 1, 0, 0, 0).getTime();
-			continue;
-		}
-		if (!cron.minutes.has(date.getMinutes())) {
-			candidate += MINUTE_MS;
-			continue;
-		}
-		return candidate;
-	}
-	return new FlumeParseError(`cron "${cron.source}" has no next time within bound`);
-}
-function matchesDay(cron, date) {
-	const domMatch = cron.daysOfMonth.has(date.getDate());
-	const dowMatch = cron.daysOfWeek.has(date.getDay());
-	if (cron.domRestricted && cron.dowRestricted) return domMatch || dowMatch;
-	if (cron.domRestricted) return domMatch;
-	if (cron.dowRestricted) return dowMatch;
-	return true;
-}
-//#endregion
-//#region lib/time/time-scheduler.ts
-const MAX_TIMEOUT_MS = 2e9;
-const FIRE_TOLERANCE_MS = 1e3;
-/**
-* cron に従って `onTick` を駆動するタイマーループ。外部接続を持たないため reconnect 不要。
-* IO 境界は全て `attempt` 経由で扱い、停止後はコールバックを発火しない
-*/
-var FlumeTimeScheduler = class {
-	props;
-	log;
-	isStoppedFlag = false;
-	timer = null;
-	target = 0;
-	constructor(props) {
-		this.props = props;
-		this.log = new FlumeLogger({
-			source: "time.scheduler",
-			handler: props.onLog,
-			deps: props.deps
-		});
-	}
-	get isStopped() {
-		return this.isStoppedFlag;
-	}
-	start() {
-		const next = flumeCronNext(this.props.cron, safeNow({ deps: this.props.deps }));
-		if (next instanceof FlumeParseError) {
-			this.log.error({
-				action: "cron.no-next",
-				message: next.message,
-				error: next
-			});
-			return next;
-		}
-		this.target = next;
-		this.log.info({
-			action: "scheduler.start",
-			message: `next fire at ${new Date(next).toISOString()}`,
-			detail: { target: next }
-		});
-		this.arm();
-		return null;
-	}
-	stop() {
-		this.isStoppedFlag = true;
-		this.clearTimer();
-	}
-	arm() {
-		this.clearTimer();
-		const delay = Math.max(0, this.target - safeNow({ deps: this.props.deps }));
-		const capped = Math.min(delay, MAX_TIMEOUT_MS);
-		const result = attempt(() => this.props.deps.setTimeout(() => this.onWake(), capped));
-		if (result instanceof Error) {
-			this.log.error({
-				action: "scheduler.arm.error",
-				message: safeErrorMessage({ error: result }),
-				error: result
-			});
-			this.timer = null;
-			return;
-		}
-		this.timer = result;
-	}
-	onWake() {
-		this.timer = null;
-		if (this.isStoppedFlag) return;
-		if (this.target - safeNow({ deps: this.props.deps }) > FIRE_TOLERANCE_MS) {
-			this.arm();
-			return;
-		}
-		const firedAt = this.target;
-		safeInvokeCallback({
-			fn: () => this.props.onTick(firedAt),
-			onError: (error) => {
-				this.log.error({
-					action: "scheduler.tick.error",
-					message: safeErrorMessage({ error }),
-					error
-				});
-			}
-		});
-		const next = flumeCronNext(this.props.cron, firedAt);
-		if (next instanceof FlumeParseError) {
-			this.log.error({
-				action: "cron.no-next",
-				message: next.message,
-				error: next
-			});
-			return;
-		}
-		this.target = next;
-		this.arm();
-	}
-	clearTimer() {
-		if (this.timer === null) return;
-		const handle = this.timer;
-		const result = attempt(() => this.props.deps.clearTimeout(handle));
-		if (result instanceof Error) this.log.error({
-			action: "scheduler.timer.clear.error",
-			message: safeErrorMessage({ error: result }),
-			error: result
-		});
-		this.timer = null;
-	}
-};
-//#endregion
-//#region lib/time/time-catchup.ts
-const DEFAULT_MISSED_WINDOW_MS = 1440 * 60 * 1e3;
-const MAX_CATCHUP_MATCHES = 1e4;
-/**
-* `lastFiredAt` から `now` までに過ぎ去った cron マッチを policy に従って列挙する。
-*
-* - policy.mode === "off"      : 常に空配列
-* - policy.mode === "lastOnly" : 過ぎ去ったマッチの中で最も新しいもの 1 件
-* - policy.mode === "missed"   : maxWindowMs (既定 24h) 以内に過ぎ去ったすべてのマッチ。
-*                                window の起点は `max(lastFiredAt, now - maxWindowMs)`
-*
-* 到達不能 cron や catastrophic な policy ミス指定の場合は FlumeParseError を返す
-* (catchup 列挙だけで失敗させる。source 本体の起動は別判断)
-*/
-function flumeCollectCatchupMatches(props) {
-	if (props.policy.mode === "off") return [];
-	if (props.lastFiredAt >= props.now) return [];
-	const windowStart = props.policy.mode === "missed" ? Math.max(props.lastFiredAt, props.now - (props.policy.maxWindowMs ?? DEFAULT_MISSED_WINDOW_MS)) : props.lastFiredAt;
-	const matches = [];
-	let cursor = windowStart;
-	for (let i = 0; i < MAX_CATCHUP_MATCHES; i++) {
-		const next = flumeCronNext(props.cron, cursor);
-		if (next instanceof FlumeParseError) return next;
-		if (next > props.now) break;
-		matches.push(next);
-		cursor = next;
-	}
-	if (props.policy.mode === "lastOnly") {
-		const last = matches[matches.length - 1];
-		return last === void 0 ? [] : [last];
-	}
-	return matches;
-}
-//#endregion
-//#region lib/time/time-source.ts
-/**
-* cron スケジュールで tick を emit する Source。外部接続を持たないため
-* 起動成功と同時に `connected` になり reconnect の対象外。
-*
-* options.statePersister + options.catchupPolicy を渡すと:
-*  1. 起動時に lastFiredAt を読み出す
-*  2. lastFiredAt から now までの過ぎ去った cron マッチを policy に従って再発火する
-*  3. 各 tick 後に lastFiredAt を保存する (best-effort, ブロックしない)
-*
-* 保存先や形式は flume の関知ではなく statePersister の実装が決める (純粋 DI)
-*/
-var FlumeTimeSource = class extends FlumeSource {
-	options;
-	name = "time";
-	scheduler = null;
-	constructor(options) {
-		super();
-		this.options = options;
-	}
-	async connect(ctx) {
-		this.setStatus("connecting");
-		const cron = parseCron(this.options.cron);
-		if (cron instanceof FlumeParseError) {
-			const error = new FlumeStartError(`Time source: invalid cron "${this.options.cron}": ${cron.message}`);
-			ctx.log.error({
-				action: "source.start.failed",
-				message: safeErrorMessage({ error }),
-				error
-			});
-			this.setStatus("disconnected", error.message);
-			return error;
-		}
-		const persister = this.options.statePersister ?? null;
-		const lastFiredAt = persister === null ? null : await this.loadLastFiredAt(ctx, persister);
-		this.scheduler = new FlumeTimeScheduler({
-			cron,
-			onLog: ctx.log.handler,
-			deps: ctx.deps,
-			onTick: (firedAt) => this.handleTick(ctx, firedAt, persister)
-		});
-		const result = this.scheduler.start();
-		if (result instanceof Error) {
-			const error = new FlumeStartError(`Time source: ${safeErrorMessage({ error: result })}`);
-			this.setStatus("disconnected", error.message);
-			return error;
-		}
-		this.setStatus("connected");
-		if (lastFiredAt !== null && persister !== null) this.runCatchup({
-			ctx,
-			cron,
-			lastFiredAt,
-			persister
-		});
-		return null;
-	}
-	disconnect() {
-		this.scheduler?.stop();
-		this.scheduler = null;
-	}
-	handleTick(ctx, firedAt, persister) {
-		this.emitTick(ctx, firedAt);
-		if (persister !== null) this.saveLastFiredAt(ctx, persister, firedAt);
-	}
-	emitTick(ctx, firedAt) {
-		const tick = {
-			firedAt,
-			cron: this.options.cron
-		};
-		const custom = this.safeMessage(ctx, tick);
-		this.emit({
-			source: "time",
-			type: typeof custom.type === "string" ? custom.type : "tick",
-			data: isRecord(custom.data) ? custom.data : {
-				firedAt,
-				cron: this.options.cron
-			},
-			meta: this.normalizeMeta(custom.meta, this.options.cron),
-			receivedAt: safeNow({ deps: ctx.deps })
-		});
-	}
-	runCatchup(props) {
-		const policy = this.options.catchupPolicy ?? { mode: "off" };
-		if (policy.mode === "off") return;
-		const matches = flumeCollectCatchupMatches({
-			cron: props.cron,
-			lastFiredAt: props.lastFiredAt,
-			now: safeNow({ deps: props.ctx.deps }),
-			policy
-		});
-		if (matches instanceof FlumeParseError) {
-			props.ctx.log.warn({
-				action: "time.catchup.failed",
-				message: matches.message,
-				error: matches
-			});
-			return;
-		}
-		if (matches.length === 0) return;
-		props.ctx.log.info({
-			action: "time.catchup.fired",
-			message: `catchup ${matches.length} missed tick(s) since ${new Date(props.lastFiredAt).toISOString()}`,
-			detail: {
-				count: matches.length,
-				policy: policy.mode
-			}
-		});
-		for (const firedAt of matches) this.emitTick(props.ctx, firedAt);
-		const last = matches[matches.length - 1];
-		if (last !== void 0) this.saveLastFiredAt(props.ctx, props.persister, last);
-	}
-	async loadLastFiredAt(ctx, persister) {
-		const result = await attempt(() => persister.load());
-		if (result instanceof Error) {
-			ctx.log.warn({
-				action: "time.state.load.error",
-				message: safeErrorMessage({ error: result }),
-				error: result
-			});
-			return null;
-		}
-		if (result === null) return null;
-		if (typeof result.lastFiredAt !== "number" || !Number.isFinite(result.lastFiredAt)) return null;
-		return result.lastFiredAt;
-	}
-	saveLastFiredAt(ctx, persister, lastFiredAt) {
-		safeInvokeCallback({
-			fn: () => persister.save({ lastFiredAt }),
-			onError: (error) => {
-				ctx.log.warn({
-					action: "time.state.save.error",
-					message: safeErrorMessage({ error: safeNormalizeError({ value: error }) }),
-					error
-				});
-			}
-		});
-	}
-	safeMessage(ctx, tick) {
-		const message = this.options.message;
-		if (!message) return {};
-		const result = attempt(() => message(tick));
-		if (result instanceof Error) {
-			const error = safeNormalizeError({ value: result });
-			ctx.log.warn({
-				action: "message.error",
-				message: safeErrorMessage({ error }),
-				error,
-				detail: { firedAt: tick.firedAt }
-			});
-			return {};
-		}
-		return isRecord(result) ? result : {};
-	}
-	normalizeMeta(meta, cron) {
-		if (!isRecord(meta)) return { cron };
-		const normalized = {};
-		for (const key of Object.keys(meta)) {
-			const value = meta[key];
-			if (typeof value === "string") normalized[key] = value;
-		}
-		if (Object.keys(normalized).length === 0) return { cron };
-		return normalized;
-	}
-};
-//#endregion
-export { parseCron as i, flumeCollectCatchupMatches as n, flumeCronNext as r, FlumeTimeSource as t };