mixi2-js 1.2.1 → 1.3.0

package/dist/helpers/index.mjs

@@ -0,0 +1,304 @@
+import { a as MediaUploadStatus, c as PostMaskType } from "../types-BrJ83qtL.mjs";
+//#region src/helpers/address.ts
+/**
+* アクセストークン取得用のエンドポイント URL です。
+*/
+const tokenUrl = "https://application-auth.mixi.social/oauth2/token";
+/**
+* API サーバーアドレスです。
+*/
+const apiAddress = "application-api.mixi.social";
+/**
+* gRPC ストリーミング接続用のサーバーアドレスです。
+*/
+const streamAddress = "application-stream.mixi.social";
+//#endregion
+//#region src/helpers/event-deduplicator.ts
+/**
+* 重複したイベントを検出してスキップするミドルウェア。
+* Webhook 方式のリトライなどで同じイベントが複数回届いた場合に、
+* 内部ハンドラへの二重処理を防ぐ。
+*
+* @example
+* const dedup = new EventDeduplicator(innerHandler);
+* const server = new WebhookServer({ handler: dedup, ... });
+*/
+var EventDeduplicator = class {
+	inner;
+	maxSize;
+	maxAge;
+	seen = /* @__PURE__ */ new Map();
+	constructor(handler, options) {
+		this.inner = handler;
+		this.maxSize = options?.maxSize ?? 1e3;
+		this.maxAge = options?.maxAge ?? 3e5;
+	}
+	async handle(event) {
+		const now = Date.now();
+		this.evict(now);
+		if (this.seen.has(event.eventId)) return;
+		this.seen.set(event.eventId, now);
+		if (this.seen.size > this.maxSize) {
+			const oldest = this.seen.keys().next().value;
+			if (oldest !== void 0) this.seen.delete(oldest);
+		}
+		await this.inner.handle(event);
+	}
+	evict(now) {
+		for (const [id, ts] of this.seen) if (now - ts > this.maxAge) this.seen.delete(id);
+		else break;
+	}
+};
+//#endregion
+//#region src/helpers/event-logger.ts
+/**
+* 受信したイベントをログ出力するデバッグ用ミドルウェア。
+* 内部ハンドラへの処理はそのまま委譲する。
+*
+* @example
+* const logger = new EventLogger(router);
+* await watcher.watch(logger);
+*/
+var EventLogger = class {
+	inner;
+	logger;
+	verbose;
+	constructor(handler, options) {
+		this.inner = handler;
+		this.logger = options?.logger ?? console.log;
+		this.verbose = options?.verbose ?? true;
+	}
+	async handle(event) {
+		if (this.verbose) this.logger(`[mixi2] event received: type=${event.eventType} id=${event.eventId}`);
+		else this.logger(`[mixi2] event received: type=${event.eventType}`);
+		await this.inner.handle(event);
+	}
+};
+//#endregion
+//#region src/helpers/event-router.ts
+/**
+* イベントタイプ別にハンドラを登録できる EventHandler 実装。
+* StreamWatcher.watch() や WebhookServer に直接渡して使用できる。
+*/
+var EventRouter = class {
+	listeners = /* @__PURE__ */ new Map();
+	/**
+	* 指定したイベントタイプのハンドラを登録する。
+	* 同じイベントタイプに複数のハンドラを登録可能（登録順に実行）。
+	*/
+	on(eventType, listener) {
+		const existing = this.listeners.get(eventType);
+		if (existing) existing.push(listener);
+		else this.listeners.set(eventType, [listener]);
+		return this;
+	}
+	/**
+	* 指定したイベントタイプのハンドラを削除する。
+	* listener を省略した場合、そのイベントタイプのすべてのハンドラを削除する。
+	*/
+	off(eventType, listener) {
+		if (!listener) {
+			this.listeners.delete(eventType);
+			return this;
+		}
+		const existing = this.listeners.get(eventType);
+		if (existing) {
+			const filtered = existing.filter((l) => l !== listener);
+			if (filtered.length > 0) this.listeners.set(eventType, filtered);
+			else this.listeners.delete(eventType);
+		}
+		return this;
+	}
+	/**
+	* EventHandler.handle() の実装。
+	* 登録されたリスナーに対してイベントをルーティングする。
+	*/
+	async handle(event) {
+		const listeners = this.listeners.get(event.eventType);
+		if (!listeners) return;
+		for (const listener of listeners) await listener(event);
+	}
+};
+//#endregion
+//#region src/helpers/media-uploader.ts
+/**
+* メディアアップロードの開始 → データ送信 → 処理完了待機を簡略化するヘルパー。
+*
+* 通常は initiatePostMediaUpload → HTTP POST → getPostMediaStatus のポーリングが必要だが、
+* このクラスで waitForReady() を呼ぶだけで完了まで待機できる。
+*/
+var MediaUploader = class {
+	client;
+	pollInterval;
+	timeout;
+	constructor(client, options) {
+		this.client = client;
+		this.pollInterval = options?.pollInterval ?? 1e3;
+		this.timeout = options?.timeout ?? 6e4;
+	}
+	/**
+	* メディアアップロードを開始し、uploadUrl と mediaId を返す。
+	*/
+	async initiate(request) {
+		const response = await this.client.initiatePostMediaUpload(request);
+		return {
+			mediaId: response.mediaId,
+			uploadUrl: response.uploadUrl
+		};
+	}
+	/**
+	* メディアの処理が完了するまでポーリングして待機する。
+	* 完了時に mediaId を返す。失敗時はエラーをスローする。
+	*/
+	async waitForReady(mediaId) {
+		const startTime = Date.now();
+		while (Date.now() - startTime < this.timeout) {
+			const status = await this.client.getPostMediaStatus(mediaId);
+			if (status.status === MediaUploadStatus.COMPLETED) return mediaId;
+			if (status.status === MediaUploadStatus.FAILED) throw new Error(`Media upload failed: ${mediaId}`);
+			await new Promise((resolve) => setTimeout(resolve, this.pollInterval));
+		}
+		throw new Error(`Media upload timed out after ${this.timeout}ms: ${mediaId}`);
+	}
+};
+//#endregion
+//#region src/helpers/post-builder.ts
+/**
+* ポスト作成リクエストをメソッドチェーンで組み立てるビルダー。
+*
+* @example
+* const request = new PostBuilder('Hello mixi2!')
+*   .reply('post-id')
+*   .media(['media-id-1'])
+*   .sensitive()
+*   .build();
+*/
+var PostBuilder = class {
+	request;
+	constructor(text) {
+		this.request = { text };
+	}
+	/** 返信先ポスト ID を設定する。 */
+	reply(postId) {
+		this.request.inReplyToPostId = postId;
+		this.request.quotedPostId = void 0;
+		return this;
+	}
+	/** 引用対象ポスト ID を設定する。 */
+	quote(postId) {
+		this.request.quotedPostId = postId;
+		this.request.inReplyToPostId = void 0;
+		return this;
+	}
+	/** 添付メディア ID を設定する（最大 4 件）。 */
+	media(mediaIdList) {
+		this.request.mediaIdList = mediaIdList;
+		return this;
+	}
+	/** センシティブマスクを設定する。 */
+	sensitive(caption = "") {
+		this.request.postMask = {
+			maskType: PostMaskType.SENSITIVE,
+			caption
+		};
+		return this;
+	}
+	/** ネタバレマスクを設定する。 */
+	spoiler(caption = "") {
+		this.request.postMask = {
+			maskType: PostMaskType.SPOILER,
+			caption
+		};
+		return this;
+	}
+	/** カスタムマスクを設定する。 */
+	mask(postMask) {
+		this.request.postMask = postMask;
+		return this;
+	}
+	/** 配信設定を設定する。 */
+	publishing(type) {
+		this.request.publishingType = type;
+		return this;
+	}
+	/** CreatePostRequest オブジェクトを構築する。 */
+	build() {
+		return { ...this.request };
+	}
+};
+//#endregion
+//#region src/helpers/reason-filter.ts
+/**
+* EventReason に基づいてイベントをフィルタリングするミドルウェア。
+* 指定した理由に一致するイベントのみを内部のハンドラに渡す。
+*
+* @example
+* const filter = new ReasonFilter(innerHandler, [
+*   EventReason.POST_REPLY,
+*   EventReason.POST_MENTIONED,
+* ]);
+* await watcher.watch(filter);
+*/
+var ReasonFilter = class {
+	inner;
+	allowedReasons;
+	constructor(handler, reasons) {
+		this.inner = handler;
+		this.allowedReasons = new Set(reasons);
+	}
+	async handle(event) {
+		const reasons = this.getReasons(event);
+		if (reasons.length === 0 || reasons.some((r) => this.allowedReasons.has(r))) await this.inner.handle(event);
+	}
+	getReasons(event) {
+		if (event.postCreatedEvent) return event.postCreatedEvent.eventReasonList || [];
+		if (event.chatMessageReceivedEvent) return event.chatMessageReceivedEvent.eventReasonList || [];
+		return [];
+	}
+};
+//#endregion
+//#region src/helpers/text-splitter.ts
+/** mixi2 の 1 ポストあたりの最大文字数 */
+const maxPostLength = 149;
+/**
+* 長いテキストを mixi2 の文字数制限内に収まる複数チャンクに分割するヘルパー。
+* デフォルトは 149 文字制限（mixi2 のポスト本文上限）に準拠。
+*
+* @example
+* const splitter = new TextSplitter();
+* const chunks = splitter.split('長いテキスト...');
+* for (const chunk of chunks) {
+*   await client.createPost({ text: chunk });
+* }
+*/
+var TextSplitter = class {
+	maxLength;
+	splitOnWord;
+	constructor(options) {
+		this.maxLength = options?.maxLength ?? 149;
+		this.splitOnWord = options?.splitOnWord ?? true;
+	}
+	/**
+	* テキストを maxLength 以内の複数チャンクに分割して返す。
+	* テキストが maxLength 以内の場合は 1 要素の配列を返す。
+	*/
+	split(text) {
+		if (text.length <= this.maxLength) return [text];
+		const chunks = [];
+		let remaining = text;
+		while (remaining.length > this.maxLength) {
+			let splitAt = this.maxLength;
+			if (this.splitOnWord) {
+				const candidate = remaining.slice(0, this.maxLength);
+				const lastBreak = Math.max(candidate.lastIndexOf(" "), candidate.lastIndexOf("　"), candidate.lastIndexOf("、"), candidate.lastIndexOf("。"), candidate.lastIndexOf("！"), candidate.lastIndexOf("？"), candidate.lastIndexOf("!"), candidate.lastIndexOf("?"), candidate.lastIndexOf("\n"));
+				if (lastBreak > 0) splitAt = lastBreak + 1;
+			}
+			chunks.push(remaining.slice(0, splitAt).trimEnd());
+			remaining = remaining.slice(splitAt).trimStart();
+		}
+		if (remaining.length > 0) chunks.push(remaining);
+		return chunks;
+	}
+};
+//#endregion
+export { EventDeduplicator, EventLogger, EventRouter, MediaUploader, PostBuilder, ReasonFilter, TextSplitter, apiAddress, maxPostLength, streamAddress, tokenUrl };