mixi2-js 1.2.1 → 1.3.0

package/dist/helpers/index.cjs

@@ -1,217 +1,315 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_types = require("../types-D9t_NdQ0.cjs");
+//#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;
+	}
 };
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
+//#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);
+	}
 };
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/helpers/index.ts
-var helpers_exports = {};
-__export(helpers_exports, {
-  EventRouter: () => EventRouter,
-  MediaUploader: () => MediaUploader,
-  PostBuilder: () => PostBuilder,
-  ReasonFilter: () => ReasonFilter,
-  apiAddress: () => apiAddress,
-  streamAddress: () => streamAddress,
-  tokenUrl: () => tokenUrl
-});
-module.exports = __toCommonJS(helpers_exports);
-
-// src/helpers/address.ts
-var tokenUrl = "https://application-auth.mixi.social/oauth2/token";
-var apiAddress = "application-api.mixi.social";
-var streamAddress = "application-stream.mixi.social";
-
-// src/helpers/event-router.ts
+//#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);
-    }
-  }
+	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);
+	}
 };
-
-// src/helpers/media-uploader.ts
+//#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 === 3 /* COMPLETED */) {
-        return mediaId;
-      }
-      if (status.status === 4 /* 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}`
-    );
-  }
+	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 === require_types.MediaUploadStatus.COMPLETED) return mediaId;
+			if (status.status === require_types.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}`);
+	}
 };
-
-// src/helpers/post-builder.ts
+//#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: 1 /* SENSITIVE */,
-      caption
-    };
-    return this;
-  }
-  /** ネタバレマスクを設定する。 */
-  spoiler(caption = "") {
-    this.request.postMask = {
-      maskType: 2 /* 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 };
-  }
+	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: require_types.PostMaskType.SENSITIVE,
+			caption
+		};
+		return this;
+	}
+	/** ネタバレマスクを設定する。 */
+	spoiler(caption = "") {
+		this.request.postMask = {
+			maskType: require_types.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 };
+	}
 };
-
-// src/helpers/reason-filter.ts
+//#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 [];
-  }
+	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 [];
+	}
 };
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  EventRouter,
-  MediaUploader,
-  PostBuilder,
-  ReasonFilter,
-  apiAddress,
-  streamAddress,
-  tokenUrl
-});
+//#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
+exports.EventDeduplicator = EventDeduplicator;
+exports.EventLogger = EventLogger;
+exports.EventRouter = EventRouter;
+exports.MediaUploader = MediaUploader;
+exports.PostBuilder = PostBuilder;
+exports.ReasonFilter = ReasonFilter;
+exports.TextSplitter = TextSplitter;
+exports.apiAddress = apiAddress;
+exports.maxPostLength = maxPostLength;
+exports.streamAddress = streamAddress;
+exports.tokenUrl = tokenUrl;