@interactive-inc/flume 0.3.0 → 0.4.0

package/dist/{types-Bm9uKUQz.d.ts → types-D-tO-Mh2.d.ts}

@@ -3,7 +3,7 @@ import { z } from "zod/v4";
 //#region lib/discord/discord-gateway-message-schema.d.ts
 declare const FlumeGatewayMessageSchema: z.ZodObject<{
   op: z.ZodNumber;
-  d: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  d: z.ZodUnknown;
   s: z.ZodNullable<z.ZodNumber>;
   t: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
@@ -42,10 +42,10 @@ declare const FlumeSlackEnvelopeSchema: z.ZodObject<{
 }, z.core.$strip>;
 //#endregion
 //#region lib/types.d.ts
-type FlumeTimerHandle = ReturnType<typeof setTimeout>;
+type FlumeTimerHandle = unknown;
 type FlumeRuntimeDeps = {
   fetch(url: string | URL, init?: RequestInit): Promise<Response>;
-  WebSocket: new (url: string | URL) => WebSocket;
+  WebSocket: (new (url: string | URL) => WebSocket) | null;
   now(): number;
   random(): number;
   setTimeout(fn: () => void, ms: number): FlumeTimerHandle;
@@ -54,30 +54,44 @@ type FlumeRuntimeDeps = {
   clearInterval(id: FlumeTimerHandle): void;
 };
 type FlumeSourceName = "discord" | "slack" | "github";
-type FlumeEvent = {
-  source: FlumeSourceName;
+type FlumeDiscordEvent = {
+  source: "discord";
   type: string;
-  data: unknown;
+  data: Record<string, unknown>;
   meta: Record<string, string>;
   receivedAt: number;
 };
-type FlumeHandler = (event: FlumeEvent) => void | Promise<void>;
-type FlumeStartOk = {
-  ok: true;
+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 FlumeStartErr = {
-  ok: false;
-  error: Error;
+type FlumeEvent = FlumeDiscordEvent | FlumeSlackEvent | FlumeGitHubEvent;
+type FlumeHandler = (event: FlumeEvent) => void | Promise<void>;
+type FlumeSourceStartOptions = {
+  signal?: AbortSignal;
 };
-type FlumeStartResult = FlumeStartOk | FlumeStartErr;
 type FlumeSource = {
   readonly name: FlumeSourceName;
-  start(handler: FlumeHandler): Promise<FlumeStartResult>;
+  start(handler: FlumeHandler, options?: FlumeSourceStartOptions): Promise<Error | null>;
   stop(): Promise<void>;
   status(): FlumeStatus;
 };
 type FlumeSourceStatus = {
-  name: FlumeSourceName;
+  /**
+   * 多くは `FlumeSourceName` のいずれかだが、`source.name` getter が throw する
+   * 第三者 `FlumeSource` 実装に備えて `string` まで広げてある (fallback で `"?"`)
+   */
+  source: string;
   status: FlumeStatus;
 };
 type FlumeStatus = "disconnected" | "connecting" | "connected" | "reconnecting";
@@ -123,11 +137,8 @@ type FlumeDiscordSourceOptions = FlumeSourceOptions & {
 type FlumeSlackSourceOptions = FlumeSourceOptions & {
   appToken: string;
   /**
-   * Bot token (`xoxb-`). Required — used by the host (e.g. funnel) to call
-   * `auth.test` for self-detection and to post replies. Flume's Socket Mode
-   * transport only needs `appToken` to open the socket, but every realistic
-   * consumer needs the bot token too, so the type forces it to be present
-   * rather than leaving it optional and failing at runtime.
+   * Bot token (`xoxb-`). Slack の Socket Mode (受信) には不要だが、ホスト側 (返信や
+   * `auth.test` での self 検出) が必ず使うため型で保持を強制する
    */
   botToken: string;
 };
@@ -140,4 +151,4 @@ type FlumeSlackEnvelope = z.infer<typeof FlumeSlackEnvelopeSchema>;
 type FlumeSlackConnectionResponse = z.infer<typeof FlumeSlackConnectionResponseSchema>;
 type FlumeGitHubNotification = z.infer<typeof FlumeGitHubNotificationSchema>;
 //#endregion
-export { FlumeGatewayMessageSchema as A, FlumeStartResult as C, FlumeSlackEnvelopeSchema as D, FlumeTimerHandle as E, FlumeSlackConnectionResponseSchema as O, FlumeStartOk as S, FlumeStatusHandler as T, FlumeSource as _, FlumeGitHubSourceOptions as a, FlumeSourceStatus as b, FlumeLogHandler as c, FlumeReconnectConfig as d, FlumeReconnectOptions as f, FlumeSlackSourceOptions as g, FlumeSlackEnvelope as h, FlumeGitHubNotification as i, FlumeGitHubNotificationSchema as k, FlumeLogInput as l, FlumeSlackConnectionResponse as m, FlumeEvent as n, FlumeHandler as o, FlumeRuntimeDeps as p, FlumeGatewayMessage as r, FlumeLog as s, FlumeDiscordSourceOptions as t, FlumeLogLevel as u, FlumeSourceName as v, FlumeStatus as w, FlumeStartErr as x, FlumeSourceOptions as y };
+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 };

package/package.json

@@ -1,33 +1,38 @@
 {
   "name": "@interactive-inc/flume",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Unified notification listener for Discord, Slack, and GitHub. Raw WebSocket + fetch + Zod. No SDK dependencies.",
   "keywords": [
     "discord",
-    "slack",
+    "event-source",
+    "gateway",
     "github",
+    "listener",
     "notifications",
-    "webhook",
+    "slack",
     "socket-mode",
-    "gateway",
-    "event-source",
-    "listener"
+    "webhook"
   ],
+  "homepage": "https://github.com/interactive-inc/open-flume#readme",
+  "bugs": {
+    "url": "https://github.com/interactive-inc/open-flume/issues"
+  },
   "license": "MIT",
   "author": "interactive-inc",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/interactive-inc/open-flume.git"
   },
-  "homepage": "https://github.com/interactive-inc/open-flume#readme",
-  "bugs": {
-    "url": "https://github.com/interactive-inc/open-flume/issues"
-  },
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "LICENSE"
+  ],
   "type": "module",
+  "sideEffects": false,
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
-  "sideEffects": false,
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -51,11 +56,6 @@
     },
     "./package.json": "./package.json"
   },
-  "files": [
-    "dist/**/*",
-    "README.md",
-    "LICENSE"
-  ],
   "publishConfig": {
     "access": "public"
   },
@@ -67,11 +67,14 @@
     "lint": "vp lint",
     "fmt": "vp fmt"
   },
+  "dependencies": {
+    "zod": "^4.4.3"
+  },
   "devDependencies": {
     "vite-plus": "^0.1.21",
     "vitest": "^4.1.9"
   },
-  "dependencies": {
-    "zod": "^4.4.3"
+  "engines": {
+    "node": ">=22"
   }
 }

package/dist/connection-error-BOk97djj.d.ts

@@ -1,6 +0,0 @@
-//#region lib/errors/connection-error.d.ts
-declare class FlumeConnectionError extends Error {
-  constructor(message: string);
-}
-//#endregion
-export { FlumeConnectionError as t };

package/dist/http-error-K-Ym4lfK.d.ts

@@ -1,11 +0,0 @@
-//#region lib/errors/http-error.d.ts
-type Props = {
-  message: string;
-  status: number;
-};
-declare class FlumeHttpError extends Error {
-  readonly status: number;
-  constructor(props: Props);
-}
-//#endregion
-export { FlumeHttpError as t };

package/dist/logger-CpGB9WO_.js

@@ -1,49 +0,0 @@
-//#region lib/deps.ts
-function createFlumeDefaultDeps() {
-	return {
-		fetch: (url, init) => globalThis.fetch(url, init),
-		WebSocket: globalThis.WebSocket,
-		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/logger.ts
-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) {
-		if (!this.props.handler) return;
-		const log = {
-			level,
-			source: this.props.source,
-			action: input.action,
-			message: input.message,
-			timestamp: this.props.deps.now(),
-			error: input.error,
-			detail: input.detail
-		};
-		this.props.handler(log);
-	}
-};
-//#endregion
-export { createFlumeDefaultDeps as n, FlumeLogger as t };

package/dist/parse-error-BAiCLRmk.d.ts

@@ -1,6 +0,0 @@
-//#region lib/errors/parse-error.d.ts
-declare class FlumeParseError extends Error {
-  constructor(message: string);
-}
-//#endregion
-export { FlumeParseError as t };

package/dist/reconnector-BDoJ1xNX.js

@@ -1,67 +0,0 @@
-//#region lib/errors/connection-error.ts
-var FlumeConnectionError = class extends Error {
-	constructor(message) {
-		super(message);
-		this.name = "FlumeConnectionError";
-		Object.freeze(this);
-	}
-};
-//#endregion
-//#region lib/errors/parse-error.ts
-var FlumeParseError = class extends Error {
-	constructor(message) {
-		super(message);
-		this.name = "FlumeParseError";
-		Object.freeze(this);
-	}
-};
-//#endregion
-//#region lib/reconnect-config.ts
-const DEFAULTS = {
-	maxAttempts: Infinity,
-	baseDelay: 1e3,
-	maxDelay: 3e4
-};
-function resolveFlumeReconnectConfig(input) {
-	if (input === false || input === void 0) return null;
-	if (input === true) return { ...DEFAULTS };
-	return {
-		...DEFAULTS,
-		...input
-	};
-}
-//#endregion
-//#region lib/reconnector.ts
-var FlumeReconnector = class {
-	props;
-	attempt = 0;
-	aborted = false;
-	timer = null;
-	constructor(props) {
-		this.props = props;
-	}
-	schedule(fn) {
-		if (this.aborted) return 0;
-		if (this.attempt >= this.props.maxAttempts) return -1;
-		const delay = this.nextDelay();
-		this.timer = this.props.deps.setTimeout(fn, delay);
-		return delay;
-	}
-	reset() {
-		this.attempt = 0;
-	}
-	cancel() {
-		this.aborted = true;
-		if (this.timer !== null) {
-			this.props.deps.clearTimeout(this.timer);
-			this.timer = null;
-		}
-	}
-	nextDelay() {
-		const jitter = Math.min(this.props.baseDelay * 2 ** this.attempt, this.props.maxDelay) * (.5 + this.props.deps.random() * .5);
-		this.attempt++;
-		return jitter;
-	}
-};
-//#endregion
-export { FlumeConnectionError as i, resolveFlumeReconnectConfig as n, FlumeParseError as r, FlumeReconnector as t };

package/dist/safe-fetch-30ZzOKHL.js

@@ -1,20 +0,0 @@
-//#region lib/utils/safe-fetch.ts
-/**
-* deps.fetch を try/catch で包み、ネットワーク例外を Error として返す。
-* HTTP ステータスの解釈や追加の副作用 (リトライ計数等) は呼び出し側の責務
-*/
-async function safeFetch(props) {
-	try {
-		return await props.fetch(props.url, props.init);
-	} catch (error) {
-		const err = error instanceof Error ? error : new Error(String(error));
-		props.log.error({
-			action: "http.error",
-			message: `network error: ${err.message}`,
-			error: err
-		});
-		return err;
-	}
-}
-//#endregion
-export { safeFetch as t };

package/dist/safe-json-parse-BWlzGOLl.js

@@ -1,41 +0,0 @@
-//#region lib/schedule-reconnect.ts
-/**
-* 接続が落ちた際の共通再接続スケジューラ。reconnector の状態を見て次回試行を予約し、
-* 試行回数が尽きていれば disconnected に落とす
-*/
-function scheduleFlumeReconnect(props) {
-	if (!props.reconnector || props.reconnector.aborted) {
-		props.setStatus("disconnected");
-		return;
-	}
-	props.setStatus("reconnecting");
-	const delay = props.reconnector.schedule(props.retry);
-	if (delay === -1) {
-		props.log.error({
-			action: "reconnect.exhausted",
-			message: `gave up after ${props.reconnector.attempt} attempts`
-		});
-		props.setStatus("disconnected");
-		return;
-	}
-	props.log.info({
-		action: "reconnect.scheduled",
-		message: `next attempt in ${Math.round(delay)}ms`
-	});
-}
-//#endregion
-//#region lib/utils/is-record.ts
-function isRecord(value) {
-	return typeof value === "object" && value !== null;
-}
-//#endregion
-//#region lib/utils/safe-json-parse.ts
-function safeJsonParse(raw) {
-	try {
-		return JSON.parse(raw);
-	} catch {
-		return null;
-	}
-}
-//#endregion
-export { isRecord as n, scheduleFlumeReconnect as r, safeJsonParse as t };

package/dist/serial-queue-ExmlnpzQ.js

@@ -1,16 +0,0 @@
-//#region lib/utils/serial-queue.ts
-/**
-* 投入順を保ったまま task を直列実行する。各 task は前の完了を待ってから走る。
-* task が throw しても後続には伝播しない (キュー自体は止まらない)
-*/
-var FlumeSerialQueue = class {
-	chain = Promise.resolve();
-	add(task) {
-		this.chain = this.chain.then(task).catch(() => {});
-	}
-	async drain() {
-		await this.chain;
-	}
-};
-//#endregion
-export { FlumeSerialQueue as t };