@interactive-inc/flume 0.4.0 → 0.9.0

package/dist/safe-invoke-callback-EpWXwfwp.js

@@ -1,170 +0,0 @@
-//#region lib/utils/safe-error-message.ts
-/**
-* 任意の値から人が読めるメッセージ文字列を取り出す。
-* `Error.message` getter / `Symbol.toPrimitive` / `toString` / `valueOf` が throw しても固定文字列に fallback。
-* 自身は決して throw しない
-*/
-function safeErrorMessage(props) {
-	if (props.error instanceof Error) try {
-		const message = props.error.message;
-		if (typeof message === "string") return message;
-		return "<non-string error message>";
-	} catch {
-		return "<unreadable error message>";
-	}
-	try {
-		return String(props.error);
-	} catch {
-		return "<unprintable error>";
-	}
-}
-//#endregion
-//#region lib/utils/safe-normalize-error.ts
-/**
-* 任意の値を `Error` インスタンスへ正規化する。すでに Error ならそのまま返し、
-* それ以外は `safeErrorMessage` で安全な文字列化を経由して new Error する。
-* Error コンストラクタ自体が throw する病的環境でも fallback を返し、決して throw しない
-*/
-function safeNormalizeError(props) {
-	if (props.value instanceof Error) return props.value;
-	const message = safeErrorMessage({ error: props.value });
-	try {
-		return new Error(message);
-	} catch {
-		try {
-			return /* @__PURE__ */ new Error("unknown error");
-		} catch {
-			const fallback = Object.create(Error.prototype);
-			fallback.name = "Error";
-			fallback.message = "unknown error";
-			return fallback;
-		}
-	}
-}
-//#endregion
-//#region lib/utils/attempt.ts
-function attempt(fn) {
-	try {
-		const result = fn();
-		if (result instanceof Promise) return result.catch((err) => safeNormalizeError({ value: err }));
-		return result;
-	} catch (err) {
-		return safeNormalizeError({ value: err });
-	}
-}
-//#endregion
-//#region lib/deps.ts
-const wsCandidate = attempt(() => globalThis.WebSocket);
-const cachedWebSocket = wsCandidate instanceof Error || typeof wsCandidate !== "function" ? null : wsCandidate;
-/**
-* platform 既定の IO を束ねた `FlumeRuntimeDeps`。
-* `FlumeTimerHandle` は不透明型 (`unknown`) のため、setTimeout / clearTimeout の戻り値・引数を
-* platform 型と橋渡しする際に境界で `as unknown as` を使う (IO 境界の最終手段)
-*/
-function createFlumeDefaultDeps() {
-	return {
-		fetch: (url, init) => globalThis.fetch(url, init),
-		WebSocket: cachedWebSocket,
-		now: () => Date.now(),
-		random: () => Math.random(),
-		setTimeout: (fn, ms) => globalThis.setTimeout(fn, ms),
-		clearTimeout: (id) => globalThis.clearTimeout(id),
-		setInterval: (fn, ms) => globalThis.setInterval(fn, ms),
-		clearInterval: (id) => globalThis.clearInterval(id)
-	};
-}
-//#endregion
-//#region lib/errors/parse-error.ts
-var FlumeParseError = class extends Error {
-	constructor(message, options) {
-		super(message, options?.cause === void 0 ? void 0 : { cause: options.cause });
-		this.name = "FlumeParseError";
-		Object.freeze(this);
-	}
-};
-//#endregion
-//#region lib/errors/start-error.ts
-var FlumeStartError = class extends Error {
-	constructor(message, options) {
-		super(message, options?.cause === void 0 ? void 0 : { cause: options.cause });
-		this.name = "FlumeStartError";
-		Object.freeze(this);
-	}
-};
-//#endregion
-//#region lib/utils/safe-now.ts
-/**
-* `deps.now()` を保護する。throw / 非数値が返った場合は 0 を返す。
-* IO 境界のため呼び出し側はこの戻り値を信頼できる
-*/
-function safeNow(props) {
-	try {
-		const value = props.deps.now();
-		if (typeof value !== "number" || !Number.isFinite(value)) return 0;
-		return value;
-	} catch {
-		return 0;
-	}
-}
-//#endregion
-//#region lib/logger.ts
-/**
-* 構造化ログを onLog に流す。handler が throw / reject してもループは継続する
-*/
-var FlumeLogger = class {
-	props;
-	constructor(props) {
-		this.props = props;
-		Object.freeze(this);
-	}
-	debug(entry) {
-		this.emit("debug", entry);
-	}
-	info(entry) {
-		this.emit("info", entry);
-	}
-	warn(entry) {
-		this.emit("warn", entry);
-	}
-	error(entry) {
-		this.emit("error", entry);
-	}
-	emit(level, input) {
-		const handler = this.props.handler;
-		if (!handler) return;
-		const log = {
-			level,
-			source: this.props.source,
-			action: input.action,
-			message: input.message,
-			timestamp: safeNow({ deps: this.props.deps }),
-			error: input.error,
-			detail: input.detail
-		};
-		try {
-			Promise.resolve(handler(log)).catch(() => {});
-		} catch {}
-	}
-};
-//#endregion
-//#region lib/utils/safe-invoke-callback.ts
-/**
-* fire-and-forget でユーザーコールバックを呼び出す。sync throw と async reject のどちらも
-* `onError(Error)` に正規化して通知。`onError` 自身が throw しても外に漏らさない。
-* 戻り値を持たない fire-and-forget 専用のため log/出力先には依存しない (caller が onError で決める)
-*/
-function safeInvokeCallback(props) {
-	try {
-		Promise.resolve(props.fn()).catch((err) => {
-			try {
-				props.onError(safeNormalizeError({ value: err }));
-			} catch {}
-		}).catch(() => {});
-	} catch (err) {
-		try {
-			props.onError(safeNormalizeError({ value: err }));
-		} catch {}
-	}
-}
-//#endregion
-export { FlumeParseError as a, safeNormalizeError as c, FlumeStartError as i, safeErrorMessage as l, FlumeLogger as n, createFlumeDefaultDeps as o, safeNow as r, attempt as s, safeInvokeCallback as t };

package/dist/serial-queue-B9LoBc64.js

@@ -1,162 +0,0 @@
-import { a as FlumeParseError, c as safeNormalizeError, l as safeErrorMessage, s as attempt, t as safeInvokeCallback } from "./safe-invoke-callback-EpWXwfwp.js";
-//#region lib/utils/safe-json-parse.ts
-function safeJsonParse(raw) {
-	try {
-		return JSON.parse(raw);
-	} catch (error) {
-		return new FlumeParseError(error instanceof Error ? `invalid JSON: ${error.message}` : "invalid JSON", { cause: error });
-	}
-}
-//#endregion
-//#region lib/source-helpers/flume-signal-registry.ts
-/**
-* Source 群に共通する AbortSignal の登録・解除・abort 判定を集約する。
-* 異常な polyfill / poisoned getter / 凍結 signal を吸収するため境界呼び出しは全て try/catch で
-* 包み、失敗時はログに流して握り潰す
-*/
-var FlumeSignalRegistry = class {
-	props;
-	signals = [];
-	constructor(props) {
-		this.props = props;
-	}
-	isAnyAborted(extra) {
-		if (this.isAborted(extra)) return true;
-		for (const signal of this.signals) if (this.isAborted(signal)) return true;
-		return false;
-	}
-	register(signal) {
-		if (!signal) return;
-		const result = attempt(() => signal.addEventListener("abort", this.props.onAbort, { once: true }));
-		if (result instanceof Error) {
-			const error = safeNormalizeError({ value: result });
-			this.props.log.error({
-				action: "signal.addListener.failed",
-				message: safeErrorMessage({ error }),
-				error
-			});
-			return;
-		}
-		this.signals.push(signal);
-	}
-	unregisterAll() {
-		for (const signal of this.signals) {
-			const result = attempt(() => signal.removeEventListener("abort", this.props.onAbort));
-			if (result instanceof Error) {
-				const error = safeNormalizeError({ value: result });
-				this.props.log.error({
-					action: "signal.removeListener.failed",
-					message: safeErrorMessage({ error }),
-					error
-				});
-			}
-		}
-		this.signals.length = 0;
-	}
-	get size() {
-		return this.signals.length;
-	}
-	isAborted(signal) {
-		if (!signal) return false;
-		const result = attempt(() => signal.aborted === true);
-		return result instanceof Error ? true : result;
-	}
-};
-//#endregion
-//#region lib/source-helpers/flume-status-emitter.ts
-/**
-* Source の `currentStatus` と `onStatus` 通知を集約する。
-* 同一 (status, detail) の連続遷移は冪等に握り潰し、ユーザーコールバックは `safeInvokeCallback`
-* 経由で例外を隔離する
-*/
-var FlumeStatusEmitter = class {
-	props;
-	currentStatus = "disconnected";
-	currentDetail = null;
-	constructor(props) {
-		this.props = props;
-	}
-	get value() {
-		return this.currentStatus;
-	}
-	set(next, detail) {
-		const normalizedDetail = detail ?? null;
-		if (this.currentStatus === next && this.currentDetail === normalizedDetail) return;
-		const prev = this.currentStatus;
-		const suffix = detail ? ` (${detail})` : "";
-		this.props.log.info({
-			action: "status",
-			message: `${prev} → ${next}${suffix}`,
-			detail: {
-				from: prev,
-				to: next,
-				reason: normalizedDetail
-			}
-		});
-		this.currentStatus = next;
-		this.currentDetail = normalizedDetail;
-		const onStatus = this.props.onStatus;
-		if (!onStatus) return;
-		safeInvokeCallback({
-			fn: detail !== void 0 ? () => onStatus(next, detail) : () => onStatus(next),
-			onError: (error) => {
-				this.props.log.error({
-					action: "onStatus.error",
-					message: safeErrorMessage({ error }),
-					error
-				});
-			}
-		});
-	}
-};
-//#endregion
-//#region lib/utils/serial-queue.ts
-/**
-* 投入順を保ったまま task を直列実行する。各 task は前の完了を待ってから走る。
-* task が throw しても後続には伝播しない (キュー自体は止まらない)。
-* maxDepth を超えた場合は新規 task を drop し onOverflow に通知。
-* cancel() 後の add() は no-op となり drain() は即時 resolve する
-*/
-var FlumeSerialQueue = class {
-	props;
-	chain = Promise.resolve();
-	depth = 0;
-	cancelled = false;
-	constructor(props = {}) {
-		this.props = props;
-	}
-	add(task) {
-		if (this.cancelled) return;
-		if (this.props.maxDepth !== void 0 && this.depth >= this.props.maxDepth) {
-			this.props.onOverflow?.({
-				dropped: 1,
-				depth: this.depth
-			});
-			return;
-		}
-		this.depth++;
-		this.chain = this.chain.then(async () => {
-			try {
-				await task();
-			} catch {} finally {
-				this.depth--;
-			}
-		});
-	}
-	async drain() {
-		await this.chain;
-	}
-	cancel() {
-		this.cancelled = true;
-		this.depth = 0;
-		this.chain = Promise.resolve();
-	}
-	size() {
-		return this.depth;
-	}
-	isCancelled() {
-		return this.cancelled;
-	}
-};
-//#endregion
-export { safeJsonParse as i, FlumeStatusEmitter as n, FlumeSignalRegistry as r, FlumeSerialQueue as t };

package/dist/types-D-tO-Mh2.d.ts

@@ -1,154 +0,0 @@
-import { z } from "zod/v4";
-
-//#region lib/discord/discord-gateway-message-schema.d.ts
-declare const FlumeGatewayMessageSchema: z.ZodObject<{
-  op: z.ZodNumber;
-  d: z.ZodUnknown;
-  s: z.ZodNullable<z.ZodNumber>;
-  t: z.ZodNullable<z.ZodString>;
-}, z.core.$strip>;
-//#endregion
-//#region lib/github/github-notification-schema.d.ts
-declare const FlumeGitHubNotificationSchema: z.ZodObject<{
-  id: z.ZodString;
-  reason: z.ZodString;
-  unread: z.ZodBoolean;
-  updated_at: z.ZodString;
-  subject: z.ZodObject<{
-    title: z.ZodString;
-    url: z.ZodNullable<z.ZodString>;
-    type: z.ZodString;
-  }, z.core.$strip>;
-  repository: z.ZodObject<{
-    full_name: z.ZodString;
-  }, z.core.$strip>;
-}, z.core.$strip>;
-//#endregion
-//#region lib/slack/slack-connection-response-schema.d.ts
-declare const FlumeSlackConnectionResponseSchema: z.ZodObject<{
-  ok: z.ZodBoolean;
-  url: z.ZodOptional<z.ZodString>;
-  error: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-//#endregion
-//#region lib/slack/slack-envelope-schema.d.ts
-declare const FlumeSlackEnvelopeSchema: z.ZodObject<{
-  envelope_id: z.ZodString;
-  type: z.ZodString;
-  payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-  accepts_response_payload: z.ZodOptional<z.ZodBoolean>;
-  retry_attempt: z.ZodOptional<z.ZodNumber>;
-  retry_reason: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-//#endregion
-//#region lib/types.d.ts
-type FlumeTimerHandle = unknown;
-type FlumeRuntimeDeps = {
-  fetch(url: string | URL, init?: RequestInit): Promise<Response>;
-  WebSocket: (new (url: string | URL) => WebSocket) | null;
-  now(): number;
-  random(): number;
-  setTimeout(fn: () => void, ms: number): FlumeTimerHandle;
-  clearTimeout(id: FlumeTimerHandle): void;
-  setInterval(fn: () => void, ms: number): FlumeTimerHandle;
-  clearInterval(id: FlumeTimerHandle): void;
-};
-type FlumeSourceName = "discord" | "slack" | "github";
-type FlumeDiscordEvent = {
-  source: "discord";
-  type: string;
-  data: Record<string, unknown>;
-  meta: Record<string, string>;
-  receivedAt: number;
-};
-type FlumeSlackEvent = {
-  source: "slack";
-  type: string;
-  data: Record<string, unknown>;
-  meta: Record<string, string>;
-  receivedAt: number;
-};
-type FlumeGitHubEvent = {
-  source: "github";
-  type: "notification";
-  data: FlumeGitHubNotification;
-  meta: Record<string, string>;
-  receivedAt: number;
-};
-type FlumeEvent = FlumeDiscordEvent | FlumeSlackEvent | FlumeGitHubEvent;
-type FlumeHandler = (event: FlumeEvent) => void | Promise<void>;
-type FlumeSourceStartOptions = {
-  signal?: AbortSignal;
-};
-type FlumeSource = {
-  readonly name: FlumeSourceName;
-  start(handler: FlumeHandler, options?: FlumeSourceStartOptions): Promise<Error | null>;
-  stop(): Promise<void>;
-  status(): FlumeStatus;
-};
-type FlumeSourceStatus = {
-  /**
-   * 多くは `FlumeSourceName` のいずれかだが、`source.name` getter が throw する
-   * 第三者 `FlumeSource` 実装に備えて `string` まで広げてある (fallback で `"?"`)
-   */
-  source: string;
-  status: FlumeStatus;
-};
-type FlumeStatus = "disconnected" | "connecting" | "connected" | "reconnecting";
-type FlumeStatusHandler = (status: FlumeStatus, detail?: string) => void;
-type FlumeLogLevel = "debug" | "info" | "warn" | "error";
-type FlumeLog = {
-  level: FlumeLogLevel;
-  source: string;
-  action: string;
-  message: string;
-  error?: Error;
-  detail?: Record<string, unknown>;
-  timestamp: number;
-};
-type FlumeLogHandler = (log: FlumeLog) => void;
-type FlumeLogInput = {
-  action: string;
-  message: string;
-  error?: Error;
-  detail?: Record<string, unknown>;
-};
-type FlumeReconnectOptions = {
-  maxAttempts?: number;
-  baseDelay?: number;
-  maxDelay?: number;
-};
-type FlumeReconnectConfig = {
-  maxAttempts: number;
-  baseDelay: number;
-  maxDelay: number;
-};
-type FlumeSourceOptions = {
-  reconnect?: boolean | FlumeReconnectOptions;
-  onStatus?: FlumeStatusHandler;
-  onLog?: FlumeLogHandler;
-  signal?: AbortSignal;
-  deps?: FlumeRuntimeDeps;
-};
-type FlumeDiscordSourceOptions = FlumeSourceOptions & {
-  token: string;
-  intents?: number;
-};
-type FlumeSlackSourceOptions = FlumeSourceOptions & {
-  appToken: string;
-  /**
-   * Bot token (`xoxb-`). Slack の Socket Mode (受信) には不要だが、ホスト側 (返信や
-   * `auth.test` での self 検出) が必ず使うため型で保持を強制する
-   */
-  botToken: string;
-};
-type FlumeGitHubSourceOptions = FlumeSourceOptions & {
-  token: string;
-  pollInterval?: number;
-};
-type FlumeGatewayMessage = z.infer<typeof FlumeGatewayMessageSchema>;
-type FlumeSlackEnvelope = z.infer<typeof FlumeSlackEnvelopeSchema>;
-type FlumeSlackConnectionResponse = z.infer<typeof FlumeSlackConnectionResponseSchema>;
-type FlumeGitHubNotification = z.infer<typeof FlumeGitHubNotificationSchema>;
-//#endregion
-export { FlumeSourceStartOptions as C, FlumeTimerHandle as D, FlumeStatusHandler as E, FlumeSourceOptions as S, FlumeStatus as T, FlumeSlackEnvelope as _, FlumeGitHubEvent as a, FlumeSource as b, FlumeHandler as c, FlumeLogInput as d, FlumeLogLevel as f, FlumeSlackConnectionResponse as g, FlumeRuntimeDeps as h, FlumeGatewayMessage as i, FlumeLog as l, FlumeReconnectOptions as m, FlumeDiscordSourceOptions as n, FlumeGitHubNotification as o, FlumeReconnectConfig as p, FlumeEvent as r, FlumeGitHubSourceOptions as s, FlumeDiscordEvent as t, FlumeLogHandler as u, FlumeSlackEvent as v, FlumeSourceStatus as w, FlumeSourceName as x, FlumeSlackSourceOptions as y };