mixi2-js 1.2.1 → 1.4.0

package/README.md

@@ -16,8 +16,7 @@
 [![Node.js](https://img.shields.io/node/v/mixi2-js?color=339933&logo=nodedotjs&logoColor=white)](package.json)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.9-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
 [![Build](https://img.shields.io/github/actions/workflow/status/otoneko1102/mixi2-js/publish.yml?label=build&logo=github)](https://github.com/otoneko1102/mixi2-js/actions)
-[![ESLint](https://img.shields.io/badge/ESLint-enabled-4B32C3?logo=eslint&logoColor=white)](eslint.config.js)
-[![Prettier](https://img.shields.io/badge/Prettier-enabled-F7B93E?logo=prettier&logoColor=white)](https://prettier.io/)
+[![Vite+](https://img.shields.io/badge/Vite%2B-enabled-646CFF?logo=vite&logoColor=white)](vite.config.ts)
 
 <div align="center">
 
@@ -50,23 +49,27 @@ ESM・CommonJS の両方に対応しています。TypeScript の型定義 (`.d.
 
 ## 機能概要
 
-| モジュール | 説明 |
-|---|---|
+| モジュール            | 説明                                                                                            |
+| --------------------- | ----------------------------------------------------------------------------------------------- |
 | `OAuth2Authenticator` | OAuth2 Client Credentials 認証（アクセストークンの取得・キャッシュ・有効期限 1 分前に自動更新） |
-| `Client` | gRPC API クライアント（8 つの RPC メソッドに対応） |
-| `WebhookServer` | HTTP Webhook サーバー（Ed25519 署名検証・Ping 自動応答） |
-| `StreamWatcher` | gRPC ストリーミング（指数バックオフによる自動再接続） |
+| `Client`              | gRPC API クライアント（8 つの RPC メソッドに対応）                                              |
+| `WebhookServer`       | HTTP Webhook サーバー（Ed25519 署名検証・Ping 自動応答）                                        |
+| `StreamWatcher`       | gRPC ストリーミング（指数バックオフによる自動再接続）                                           |
 
 ### Helpers (拡張機能)
 
 `mixi2-js/helpers` は、公式 API 仕様には含まれない **SDK 独自の便利ユーティリティ**を提供します。
 
-| ヘルパー | 説明 |
-|---|---|
-| `EventRouter` | イベントタイプ別にハンドラを登録できるルーター |
-| `PostBuilder` | メソッドチェーンでポスト作成リクエストを組み立てるビルダー |
-| `MediaUploader` | メディアアップロードの開始〜完了待機を自動化 |
-| `ReasonFilter` | `EventReason` ベースでイベントをフィルタリング |
+| ヘルパー            | 説明                                                       |
+| ------------------- | ---------------------------------------------------------- |
+| `EventRouter`       | イベントタイプ別にハンドラを登録できるルーター             |
+| `PostBuilder`       | メソッドチェーンでポスト作成リクエストを組み立てるビルダー |
+| `MediaUploader`     | メディアアップロードの開始〜完了待機を自動化               |
+| `ReasonFilter`      | `EventReason` ベースでイベントをフィルタリング             |
+| `EventDeduplicator` | Webhook リトライ等による重複イベントをスキップ             |
+| `EventLogger`       | 受信イベントをログ出力するデバッグ用ミドルウェア           |
+| `TextSplitter`      | 長いテキストを 149 文字制限内に自動分割                    |
+| `Address`           | 公式エンドポイント URL を返すヘルパー                      |
 
 ---
 

package/dist/client-DK9LqeiF.d.cts

@@ -0,0 +1,305 @@
+//#region src/types.d.ts
+declare enum EventType {
+  UNSPECIFIED = 0,
+  PING = 1,
+  POST_CREATED = 2,
+  CHAT_MESSAGE_RECEIVED = 4
+}
+declare enum EventReason {
+  UNSPECIFIED = 0,
+  PING = 1,
+  POST_REPLY = 2,
+  POST_MENTIONED = 3,
+  POST_QUOTED = 4,
+  DIRECT_MESSAGE_RECEIVED = 8
+}
+declare enum MediaType {
+  UNSPECIFIED = 0,
+  IMAGE = 1,
+  VIDEO = 2
+}
+declare enum PostMediaType {
+  UNSPECIFIED = 0,
+  IMAGE = 1,
+  VIDEO = 2
+}
+declare enum PostVisibility {
+  UNSPECIFIED = 0,
+  VISIBLE = 1,
+  INVISIBLE = 2
+}
+declare enum PostAccessLevel {
+  UNSPECIFIED = 0,
+  PUBLIC = 1,
+  PRIVATE = 2
+}
+declare enum PostMaskType {
+  UNSPECIFIED = 0,
+  SENSITIVE = 1,
+  SPOILER = 2
+}
+declare enum PostPublishingType {
+  UNSPECIFIED = 0,
+  NOT_PUBLISHING = 1
+}
+declare enum UserVisibility {
+  UNSPECIFIED = 0,
+  VISIBLE = 1,
+  INVISIBLE = 2
+}
+declare enum UserAccessLevel {
+  UNSPECIFIED = 0,
+  PUBLIC = 1,
+  PRIVATE = 2
+}
+declare enum LanguageCode {
+  UNSPECIFIED = 0,
+  JP = 1,
+  EN = 2
+}
+declare enum StampSetType {
+  UNSPECIFIED = 0,
+  DEFAULT = 1,
+  SEASONAL = 2
+}
+declare enum MediaUploadType {
+  UNSPECIFIED = 0,
+  IMAGE = 1,
+  VIDEO = 2
+}
+declare enum MediaUploadStatus {
+  UNSPECIFIED = 0,
+  UPLOAD_PENDING = 1,
+  PROCESSING = 2,
+  COMPLETED = 3,
+  FAILED = 4
+}
+interface UserAvatar {
+  largeImageUrl: string;
+  largeImageMimeType: string;
+  largeImageHeight: number;
+  largeImageWidth: number;
+  smallImageUrl: string;
+  smallImageMimeType: string;
+  smallImageHeight: number;
+  smallImageWidth: number;
+}
+interface User {
+  userId: string;
+  isDisabled: boolean;
+  name: string;
+  displayName: string;
+  profile: string;
+  userAvatar: UserAvatar | null;
+  visibility: UserVisibility;
+  accessLevel: UserAccessLevel;
+}
+interface MediaImage {
+  largeImageUrl: string;
+  largeImageMimeType: string;
+  largeImageHeight: number;
+  largeImageWidth: number;
+  smallImageUrl: string;
+  smallImageMimeType: string;
+  smallImageHeight: number;
+  smallImageWidth: number;
+}
+interface MediaVideo {
+  videoUrl: string;
+  videoMimeType: string;
+  videoHeight: number;
+  videoWidth: number;
+  previewImageUrl: string;
+  previewImageMimeType: string;
+  previewImageHeight: number;
+  previewImageWidth: number;
+  duration: number;
+}
+interface MediaStamp {
+  url: string;
+  mimeType: string;
+  height: number;
+  width: number;
+}
+interface Media {
+  mediaType: MediaType;
+  image?: MediaImage;
+  video?: MediaVideo;
+}
+interface PostMediaImage {
+  largeImageUrl: string;
+  largeImageMimeType: string;
+  largeImageHeight: number;
+  largeImageWidth: number;
+  smallImageUrl: string;
+  smallImageMimeType: string;
+  smallImageHeight: number;
+  smallImageWidth: number;
+}
+interface PostMediaVideo {
+  videoUrl: string;
+  videoMimeType: string;
+  videoHeight: number;
+  videoWidth: number;
+  previewImageUrl: string;
+  previewImageMimeType: string;
+  previewImageHeight: number;
+  previewImageWidth: number;
+  duration: number;
+}
+interface PostMedia {
+  mediaType: PostMediaType;
+  image?: PostMediaImage;
+  video?: PostMediaVideo;
+}
+interface PostMask {
+  maskType: PostMaskType;
+  caption: string;
+}
+interface PostStamp {
+  stamp: MediaStamp | null;
+  count: number;
+}
+interface Post {
+  postId: string;
+  isDeleted: boolean;
+  creatorId: string;
+  text: string;
+  createdAt: Date | null;
+  postMediaList: PostMedia[];
+  inReplyToPostId?: string;
+  postMask?: PostMask;
+  visibility: PostVisibility;
+  accessLevel: PostAccessLevel;
+  stamps: PostStamp[];
+  readerStampId?: string;
+}
+interface ChatMessage {
+  roomId: string;
+  messageId: string;
+  creatorId: string;
+  text: string;
+  createdAt: Date | null;
+  mediaList: Media[];
+  postId?: string;
+}
+interface OfficialStamp {
+  stampId: string;
+  index: number;
+  searchTags: string[];
+  url: string;
+}
+interface OfficialStampSet {
+  name: string;
+  spriteUrl: string;
+  stamps: OfficialStamp[];
+  stampSetId: string;
+  startAt?: Date;
+  endAt?: Date;
+  stampSetType: StampSetType;
+}
+interface PingEvent {}
+interface PostCreatedEvent {
+  eventReasonList: EventReason[];
+  post: Post | null;
+  issuer: User | null;
+}
+interface ChatMessageReceivedEvent {
+  eventReasonList: EventReason[];
+  message: ChatMessage | null;
+  issuer: User | null;
+}
+interface Event {
+  eventId: string;
+  eventType: EventType;
+  pingEvent?: PingEvent;
+  postCreatedEvent?: PostCreatedEvent;
+  chatMessageReceivedEvent?: ChatMessageReceivedEvent;
+}
+interface CreatePostRequest {
+  text: string;
+  inReplyToPostId?: string;
+  quotedPostId?: string;
+  mediaIdList?: string[];
+  postMask?: PostMask;
+  publishingType?: PostPublishingType;
+}
+interface InitiatePostMediaUploadRequest {
+  contentType: string;
+  dataSize: number;
+  mediaType: MediaUploadType;
+  description?: string;
+}
+interface InitiatePostMediaUploadResponse {
+  mediaId: string;
+  uploadUrl: string;
+}
+interface GetPostMediaStatusResponse {
+  status: MediaUploadStatus;
+}
+type SendChatMessageRequest = {
+  roomId: string;
+  text: string;
+  mediaId?: string;
+} | {
+  roomId: string;
+  text?: string;
+  mediaId: string;
+};
+interface GetStampsRequest {
+  officialStampLanguage?: LanguageCode;
+}
+//#endregion
+//#region src/event.d.ts
+interface EventHandler {
+  handle(event: Event): void | Promise<void>;
+}
+//#endregion
+//#region src/auth.d.ts
+interface Authenticator {
+  getAccessToken(): Promise<string>;
+}
+interface AuthenticatorOptions {
+  clientId: string;
+  clientSecret: string;
+  tokenUrl: string;
+}
+declare class OAuth2Authenticator implements Authenticator {
+  private readonly clientId;
+  private readonly clientSecret;
+  private readonly tokenUrl;
+  private accessToken;
+  private expiresAt;
+  private refreshPromise;
+  constructor(options: AuthenticatorOptions);
+  getAccessToken(): Promise<string>;
+  private refreshToken;
+}
+//#endregion
+//#region src/client.d.ts
+interface ClientOptions {
+  apiAddress: string;
+  authenticator: Authenticator;
+  authKey?: string;
+}
+declare class Client {
+  private readonly grpcClient;
+  private readonly authenticator;
+  private readonly authKey?;
+  constructor(options: ClientOptions);
+  getAccessToken(): Promise<string>;
+  private getMetadata;
+  private call;
+  getUsers(userIdList: string[]): Promise<User[]>;
+  getPosts(postIdList: string[]): Promise<Post[]>;
+  createPost(request: CreatePostRequest): Promise<Post>;
+  deletePost(postId: string): Promise<boolean>;
+  initiatePostMediaUpload(request: InitiatePostMediaUploadRequest): Promise<InitiatePostMediaUploadResponse>;
+  getPostMediaStatus(mediaId: string): Promise<GetPostMediaStatusResponse>;
+  sendChatMessage(request: SendChatMessageRequest): Promise<ChatMessage>;
+  getStamps(request?: GetStampsRequest): Promise<OfficialStampSet[]>;
+  addStampToPost(postId: string, stampId: string): Promise<Post>;
+  close(): void;
+}
+//#endregion
+export { PostCreatedEvent as A, SendChatMessageRequest as B, MediaUploadType as C, PingEvent as D, OfficialStampSet as E, PostMediaType as F, UserVisibility as G, User as H, PostMediaVideo as I, PostPublishingType as L, PostMaskType as M, PostMedia as N, Post as O, PostMediaImage as P, PostStamp as R, MediaUploadStatus as S, OfficialStamp as T, UserAccessLevel as U, StampSetType as V, UserAvatar as W, LanguageCode as _, OAuth2Authenticator as a, MediaStamp as b, ChatMessageReceivedEvent as c, EventReason as d, EventType as f, InitiatePostMediaUploadResponse as g, InitiatePostMediaUploadRequest as h, AuthenticatorOptions as i, PostMask as j, PostAccessLevel as k, CreatePostRequest as l, GetStampsRequest as m, ClientOptions as n, EventHandler as o, GetPostMediaStatusResponse as p, Authenticator as r, ChatMessage as s, Client as t, Event as u, Media as v, MediaVideo as w, MediaType as x, MediaImage as y, PostVisibility as z };

package/dist/client-GWUs7tD3.d.mts

@@ -0,0 +1,305 @@
+//#region src/types.d.ts
+declare enum EventType {
+  UNSPECIFIED = 0,
+  PING = 1,
+  POST_CREATED = 2,
+  CHAT_MESSAGE_RECEIVED = 4
+}
+declare enum EventReason {
+  UNSPECIFIED = 0,
+  PING = 1,
+  POST_REPLY = 2,
+  POST_MENTIONED = 3,
+  POST_QUOTED = 4,
+  DIRECT_MESSAGE_RECEIVED = 8
+}
+declare enum MediaType {
+  UNSPECIFIED = 0,
+  IMAGE = 1,
+  VIDEO = 2
+}
+declare enum PostMediaType {
+  UNSPECIFIED = 0,
+  IMAGE = 1,
+  VIDEO = 2
+}
+declare enum PostVisibility {
+  UNSPECIFIED = 0,
+  VISIBLE = 1,
+  INVISIBLE = 2
+}
+declare enum PostAccessLevel {
+  UNSPECIFIED = 0,
+  PUBLIC = 1,
+  PRIVATE = 2
+}
+declare enum PostMaskType {
+  UNSPECIFIED = 0,
+  SENSITIVE = 1,
+  SPOILER = 2
+}
+declare enum PostPublishingType {
+  UNSPECIFIED = 0,
+  NOT_PUBLISHING = 1
+}
+declare enum UserVisibility {
+  UNSPECIFIED = 0,
+  VISIBLE = 1,
+  INVISIBLE = 2
+}
+declare enum UserAccessLevel {
+  UNSPECIFIED = 0,
+  PUBLIC = 1,
+  PRIVATE = 2
+}
+declare enum LanguageCode {
+  UNSPECIFIED = 0,
+  JP = 1,
+  EN = 2
+}
+declare enum StampSetType {
+  UNSPECIFIED = 0,
+  DEFAULT = 1,
+  SEASONAL = 2
+}
+declare enum MediaUploadType {
+  UNSPECIFIED = 0,
+  IMAGE = 1,
+  VIDEO = 2
+}
+declare enum MediaUploadStatus {
+  UNSPECIFIED = 0,
+  UPLOAD_PENDING = 1,
+  PROCESSING = 2,
+  COMPLETED = 3,
+  FAILED = 4
+}
+interface UserAvatar {
+  largeImageUrl: string;
+  largeImageMimeType: string;
+  largeImageHeight: number;
+  largeImageWidth: number;
+  smallImageUrl: string;
+  smallImageMimeType: string;
+  smallImageHeight: number;
+  smallImageWidth: number;
+}
+interface User {
+  userId: string;
+  isDisabled: boolean;
+  name: string;
+  displayName: string;
+  profile: string;
+  userAvatar: UserAvatar | null;
+  visibility: UserVisibility;
+  accessLevel: UserAccessLevel;
+}
+interface MediaImage {
+  largeImageUrl: string;
+  largeImageMimeType: string;
+  largeImageHeight: number;
+  largeImageWidth: number;
+  smallImageUrl: string;
+  smallImageMimeType: string;
+  smallImageHeight: number;
+  smallImageWidth: number;
+}
+interface MediaVideo {
+  videoUrl: string;
+  videoMimeType: string;
+  videoHeight: number;
+  videoWidth: number;
+  previewImageUrl: string;
+  previewImageMimeType: string;
+  previewImageHeight: number;
+  previewImageWidth: number;
+  duration: number;
+}
+interface MediaStamp {
+  url: string;
+  mimeType: string;
+  height: number;
+  width: number;
+}
+interface Media {
+  mediaType: MediaType;
+  image?: MediaImage;
+  video?: MediaVideo;
+}
+interface PostMediaImage {
+  largeImageUrl: string;
+  largeImageMimeType: string;
+  largeImageHeight: number;
+  largeImageWidth: number;
+  smallImageUrl: string;
+  smallImageMimeType: string;
+  smallImageHeight: number;
+  smallImageWidth: number;
+}
+interface PostMediaVideo {
+  videoUrl: string;
+  videoMimeType: string;
+  videoHeight: number;
+  videoWidth: number;
+  previewImageUrl: string;
+  previewImageMimeType: string;
+  previewImageHeight: number;
+  previewImageWidth: number;
+  duration: number;
+}
+interface PostMedia {
+  mediaType: PostMediaType;
+  image?: PostMediaImage;
+  video?: PostMediaVideo;
+}
+interface PostMask {
+  maskType: PostMaskType;
+  caption: string;
+}
+interface PostStamp {
+  stamp: MediaStamp | null;
+  count: number;
+}
+interface Post {
+  postId: string;
+  isDeleted: boolean;
+  creatorId: string;
+  text: string;
+  createdAt: Date | null;
+  postMediaList: PostMedia[];
+  inReplyToPostId?: string;
+  postMask?: PostMask;
+  visibility: PostVisibility;
+  accessLevel: PostAccessLevel;
+  stamps: PostStamp[];
+  readerStampId?: string;
+}
+interface ChatMessage {
+  roomId: string;
+  messageId: string;
+  creatorId: string;
+  text: string;
+  createdAt: Date | null;
+  mediaList: Media[];
+  postId?: string;
+}
+interface OfficialStamp {
+  stampId: string;
+  index: number;
+  searchTags: string[];
+  url: string;
+}
+interface OfficialStampSet {
+  name: string;
+  spriteUrl: string;
+  stamps: OfficialStamp[];
+  stampSetId: string;
+  startAt?: Date;
+  endAt?: Date;
+  stampSetType: StampSetType;
+}
+interface PingEvent {}
+interface PostCreatedEvent {
+  eventReasonList: EventReason[];
+  post: Post | null;
+  issuer: User | null;
+}
+interface ChatMessageReceivedEvent {
+  eventReasonList: EventReason[];
+  message: ChatMessage | null;
+  issuer: User | null;
+}
+interface Event {
+  eventId: string;
+  eventType: EventType;
+  pingEvent?: PingEvent;
+  postCreatedEvent?: PostCreatedEvent;
+  chatMessageReceivedEvent?: ChatMessageReceivedEvent;
+}
+interface CreatePostRequest {
+  text: string;
+  inReplyToPostId?: string;
+  quotedPostId?: string;
+  mediaIdList?: string[];
+  postMask?: PostMask;
+  publishingType?: PostPublishingType;
+}
+interface InitiatePostMediaUploadRequest {
+  contentType: string;
+  dataSize: number;
+  mediaType: MediaUploadType;
+  description?: string;
+}
+interface InitiatePostMediaUploadResponse {
+  mediaId: string;
+  uploadUrl: string;
+}
+interface GetPostMediaStatusResponse {
+  status: MediaUploadStatus;
+}
+type SendChatMessageRequest = {
+  roomId: string;
+  text: string;
+  mediaId?: string;
+} | {
+  roomId: string;
+  text?: string;
+  mediaId: string;
+};
+interface GetStampsRequest {
+  officialStampLanguage?: LanguageCode;
+}
+//#endregion
+//#region src/event.d.ts
+interface EventHandler {
+  handle(event: Event): void | Promise<void>;
+}
+//#endregion
+//#region src/auth.d.ts
+interface Authenticator {
+  getAccessToken(): Promise<string>;
+}
+interface AuthenticatorOptions {
+  clientId: string;
+  clientSecret: string;
+  tokenUrl: string;
+}
+declare class OAuth2Authenticator implements Authenticator {
+  private readonly clientId;
+  private readonly clientSecret;
+  private readonly tokenUrl;
+  private accessToken;
+  private expiresAt;
+  private refreshPromise;
+  constructor(options: AuthenticatorOptions);
+  getAccessToken(): Promise<string>;
+  private refreshToken;
+}
+//#endregion
+//#region src/client.d.ts
+interface ClientOptions {
+  apiAddress: string;
+  authenticator: Authenticator;
+  authKey?: string;
+}
+declare class Client {
+  private readonly grpcClient;
+  private readonly authenticator;
+  private readonly authKey?;
+  constructor(options: ClientOptions);
+  getAccessToken(): Promise<string>;
+  private getMetadata;
+  private call;
+  getUsers(userIdList: string[]): Promise<User[]>;
+  getPosts(postIdList: string[]): Promise<Post[]>;
+  createPost(request: CreatePostRequest): Promise<Post>;
+  deletePost(postId: string): Promise<boolean>;
+  initiatePostMediaUpload(request: InitiatePostMediaUploadRequest): Promise<InitiatePostMediaUploadResponse>;
+  getPostMediaStatus(mediaId: string): Promise<GetPostMediaStatusResponse>;
+  sendChatMessage(request: SendChatMessageRequest): Promise<ChatMessage>;
+  getStamps(request?: GetStampsRequest): Promise<OfficialStampSet[]>;
+  addStampToPost(postId: string, stampId: string): Promise<Post>;
+  close(): void;
+}
+//#endregion
+export { PostCreatedEvent as A, SendChatMessageRequest as B, MediaUploadType as C, PingEvent as D, OfficialStampSet as E, PostMediaType as F, UserVisibility as G, User as H, PostMediaVideo as I, PostPublishingType as L, PostMaskType as M, PostMedia as N, Post as O, PostMediaImage as P, PostStamp as R, MediaUploadStatus as S, OfficialStamp as T, UserAccessLevel as U, StampSetType as V, UserAvatar as W, LanguageCode as _, OAuth2Authenticator as a, MediaStamp as b, ChatMessageReceivedEvent as c, EventReason as d, EventType as f, InitiatePostMediaUploadResponse as g, InitiatePostMediaUploadRequest as h, AuthenticatorOptions as i, PostMask as j, PostAccessLevel as k, CreatePostRequest as l, GetStampsRequest as m, ClientOptions as n, EventHandler as o, GetPostMediaStatusResponse as p, Authenticator as r, ChatMessage as s, Client as t, Event as u, Media as v, MediaVideo as w, MediaType as x, MediaImage as y, PostVisibility as z };