@wavezfm/api 0.7.14 → 0.7.15

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## Unreleased
 
+### API synchronization (October 1, after 0.7.14)
+
+- Added session-authenticated `client.privateMessages.openConversation()` and `sendMessage()` with typed conversation/message responses and optional `clientMessageId`. Callers reuse the same UUID v4 and content to retry one send; the SDK does not retry automatically.
+- Added admin-session `system.createGlobalAlert()`, `createRoomAlert()` and `createUserAlert()` with typed text responses and appearance inputs, including `iconBeforeTitle`. Chat messages now expose typed `systemColor` and `systemAppearance` fields.
+- Playback timing, literal whole-word blacklist matching, YouTube metadata refresh and Stripe dependency changes retain the existing HTTP routes and response shapes.
+
 ### API synchronization (September 26–October 1)
 
 - Removed `settings.replaceGifFavorites()`: the server rejects legacy whole-list `PUT` requests with `409 GIF_FAVORITES_RELOAD_REQUIRED`. Use `upsertGifFavorite()` and `removeGifFavorite()`; both return the current list. Favorite reads now use `no-store`, and metadata-only updates support `updateExistingOnly`.

package/README.md

@@ -104,6 +104,55 @@ npm run typecheck
 npm run build
 ```
 
+## Private-message retries and system alerts
+
+The helpers in this section are available in the local SDK build and await the
+next package release. Use a session-authenticated user client with the headers
+required by your deployment for these mutations.
+
+```ts
+const { data: conversation } = await client.privateMessages.openConversation({
+  recipientUserId: 'recipient-id',
+});
+const input = {
+  content: 'Hello!',
+  clientMessageId: crypto.randomUUID(),
+};
+const { data } = await client.privateMessages.sendMessage(conversation.id, input);
+console.log(data.message.id);
+```
+
+Generate `clientMessageId` once per send and keep the same UUID v4 and content
+when retrying after an uncertain failure. The updated server returns the same
+saved message for the same sender and conversation. Omitting the field keeps
+server-generated IDs. Membership and user-block checks still apply, and an ID
+conflict cannot overwrite another message. The SDK does not retry automatically.
+It also does not generate `clientMessageId`; callers choose whether to provide it.
+
+Administrative system alerts accept `appearance.iconBeforeTitle`, which defaults
+to `false`, and preserve the appearance in the realtime payload:
+
+```ts
+await client.system.createRoomAlert('room-id', {
+  delivery: 'popup',
+  message: 'The room will restart shortly.',
+  appearance: { icon: 'warning', iconBeforeTitle: true },
+});
+```
+
+`createGlobalAlert(input)` and `createRoomAlert(roomId, input)` default to `chat`.
+`createUserAlert(userId, input)` defaults to `popup`; user-targeted chat delivery
+also requires `roomId` in the input. All three require an admin session. Messages
+accept 3–1,000 characters, and optional titles accept 3–80 characters after
+trimming; empty titles use the localized default. With `bilingual: true`, provide
+both `messagePtBr` and `messageEnUs`, with optional localized titles.
+
+Appearance colors use six-digit hex strings. Icons accept `info`, `brand`,
+`warning`, `bell`, `gift` or `none`; positions accept `left`, `top` or `right`.
+Integer ranges are 16–96 for `iconSize`, 320–960 for `width`, 14–40 for
+`titleSize`, and 12–24 for `textSize`. HTTP responses return normalized text in
+`{ success, alert }`; color, appearance and delivery are sent through realtime.
+
 ## License
 
 MIT

package/dist/index.d.ts

@@ -7,6 +7,7 @@ export { createRoomResource } from "./resources/room.js";
 export { createPlaylistResource } from "./resources/playlist.js";
 export { createSourceResource } from "./resources/source.js";
 export { createChatResource } from "./resources/chat.js";
+export { createPrivateMessagesResource } from "./resources/privateMessages.js";
 export { createFriendResource } from "./resources/friend.js";
 export { createUserBlocksResource } from "./resources/userBlocks.js";
 export { createGiveawaysResource } from "./resources/giveaways.js";
@@ -18,7 +19,7 @@ export { createRoomBotResource } from "./resources/roomBot.js";
 export { parseRoomQueueSnapshot } from "./utils/roomQueue.js";
 export { formatMentionText } from "./utils/chat.js";
 export { createRoomBotRealtimeClient } from "./realtime/roomBot.js";
-export type { BotPrivateCommand, CountryFlagSettings, TeamDirectory, StageHoverSettings, UserProfileOptions, ApiClientConfig, ApiLike, ApiQuery, ApiQueryValue, ApiRequestOptions, ApiSuccessResponse, AuthMode, AuthUser, BadgeAssignment, ChatImageUploadResponse, ChatLinkReview, ChatMediaPreviewResponse, ChatMessage, CheckoutSessionResponse, GifFavorite, Giveaway, GiveawayEntry, GiveawayJoinEligibility, GiveawayListResponse, GiveawayMutationResponse, GiveawayPrizeDeliveryStatus, GiveawayPrizeType, GiveawayScope, GiveawayStatus, InventoryResponse, InventoryCatalogEntry, InventoryCatalogItem, LastFmAccountProfile, LastFmLinkStatus, LastFmWriteResponse, MediaSearchResponse, MediaSearchResult, MiscShopUserState, MiscStoreCurrency, MiscStoreItemKind, MiscStoreRenderMode, NotificationCenterClearResponse, NotificationCenterStatus, PlaylistExternalImportResult, PlaylistExternalImportSource, PlaylistJsonExport, PlaylistJsonImportResult, PlaylistJsonTrack, PlaylistSummary, PlaylistTrack, PlaylistTrackAvailabilityInput, PlaylistTrackAvailabilityResult, PlaylistTrackSearchResult, RoomBotPermission, RoomExternalMediaMetadataResponse, RoomExternalMediaProvider, RoomExternalMediaSubtitleTrack, RoomExternalMediaValidationResponse, RoomActiveUser, RoomCustomEmoji, RoomLinkFiltersUpdateInput, RoomGuestPresenceResponse, RoomGuestViewer, RoomGlobalLimits, RoomGlobalLimitsUpdateInput, RoomPlaybackHistoryEntry, RoomPermission, RoomPermissionOverrideMap, RoomQueueEntry, RoomQueuePlayback, RoomQueueSnapshot, RoomQueueStatusResponse, RoomQueueUser, RoomQueueViewerStatus, RoomRoleName, RoomSettingsUpdateInput, RoomStateSnapshot, RoomBotEditMessageInput, RoomBotChatEmbed, RoomBotMessageReplyInput, RoomBotEventsResponse, RoomPresenceEventFilterType, RoomBotQueueAddResponse, RoomBotRealtimeClient, RoomBotRealtimeSendMessageInput, RoomBotRealtimeOptions, RoomBotSendMessageInput, RoomBotSendMessageResponse, RoomBotState, RoomBotToken, RoomBotSettings, RoomBotSettingsUpdateInput, RoomPresenceEvent, RoomPresenceEventType, RoomSummary, RoomEvent, RoomEventApprovalStatus, RoomEventListResponse, RoomEventMutationResponse, RoomEventScope, RoomEventStatus, RoomEventSubmissionInput, WavezApiLocale, WavezApiMessageKey, WavezApiMessages, WavezApiMessageValues, StoreCatalogResponse, StoreCatalogItem, StoreCatalogSection, MiscStoreItem, AdminSystemHealth, AdminSystemStatus, SystemDonationGoal, SystemHealth, SystemPublicStats, SystemStatus, TwoFactorStatus, UserSettings, UserProfile, UserBlockState, WalletBalance, WebSocketLike, WsPacket, } from "./types.js";
+export type { BotPrivateCommand, CountryFlagSettings, TeamDirectory, StageHoverSettings, UserProfileOptions, ApiClientConfig, ApiLike, ApiQuery, ApiQueryValue, ApiRequestOptions, ApiSuccessResponse, AuthMode, AuthUser, BadgeAssignment, ChatImageUploadResponse, ChatLinkReview, ChatMediaPreviewResponse, ChatMessage, CheckoutSessionResponse, GifFavorite, Giveaway, GiveawayEntry, GiveawayJoinEligibility, GiveawayListResponse, GiveawayMutationResponse, GiveawayPrizeDeliveryStatus, GiveawayPrizeType, GiveawayScope, GiveawayStatus, InventoryResponse, InventoryCatalogEntry, InventoryCatalogItem, LastFmAccountProfile, LastFmLinkStatus, LastFmWriteResponse, MediaSearchResponse, MediaSearchResult, MiscShopUserState, MiscStoreCurrency, MiscStoreItemKind, MiscStoreRenderMode, NotificationCenterClearResponse, NotificationCenterStatus, PlaylistExternalImportResult, PlaylistExternalImportSource, PlaylistJsonExport, PlaylistJsonImportResult, PlaylistJsonTrack, PlaylistSummary, PlaylistTrack, PlaylistTrackAvailabilityInput, PlaylistTrackAvailabilityResult, PlaylistTrackSearchResult, PrivateConversation, PrivateMessage, PrivateMessageCustomEmoji, PrivateMessageReply, PrivateMessageSendInput, PrivateMessageSendResponse, PrivateMessageUser, RoomBotPermission, RoomExternalMediaMetadataResponse, RoomExternalMediaProvider, RoomExternalMediaSubtitleTrack, RoomExternalMediaValidationResponse, RoomActiveUser, RoomCustomEmoji, RoomLinkFiltersUpdateInput, RoomGuestPresenceResponse, RoomGuestViewer, RoomGlobalLimits, RoomGlobalLimitsUpdateInput, RoomPlaybackHistoryEntry, RoomPermission, RoomPermissionOverrideMap, RoomQueueEntry, RoomQueuePlayback, RoomQueueSnapshot, RoomQueueStatusResponse, RoomQueueUser, RoomQueueViewerStatus, RoomRoleName, RoomSettingsUpdateInput, RoomStateSnapshot, RoomBotEditMessageInput, RoomBotChatEmbed, RoomBotMessageReplyInput, RoomBotEventsResponse, RoomPresenceEventFilterType, RoomBotQueueAddResponse, RoomBotRealtimeClient, RoomBotRealtimeSendMessageInput, RoomBotRealtimeOptions, RoomBotSendMessageInput, RoomBotSendMessageResponse, RoomBotState, RoomBotToken, RoomBotSettings, RoomBotSettingsUpdateInput, RoomPresenceEvent, RoomPresenceEventType, RoomSummary, RoomSystemAlert, RoomEvent, RoomEventApprovalStatus, RoomEventListResponse, RoomEventMutationResponse, RoomEventScope, RoomEventStatus, RoomEventSubmissionInput, WavezApiLocale, WavezApiMessageKey, WavezApiMessages, WavezApiMessageValues, StoreCatalogResponse, StoreCatalogItem, StoreCatalogSection, MiscStoreItem, AdminSystemHealth, AdminSystemStatus, SystemDonationGoal, SystemAlert, SystemAlertAppearance, SystemAlertInput, SystemAlertResponse, SystemHealth, SystemPublicStats, SystemStatus, TwoFactorStatus, UserSettings, UserSystemAlert, UserProfile, UserBlockState, WalletBalance, WebSocketLike, WsPacket, } from "./types.js";
 import type { ApiClientConfig } from "./types.js";
 export declare function createApiClient(config: ApiClientConfig): {
     api: import("./core/api.js").WavezApi;
@@ -410,6 +411,13 @@ export declare function createApiClient(config: ApiClientConfig): {
             success: true;
         }>>;
     };
+    privateMessages: {
+        openConversation(input: {
+            recipientUserId?: string | null;
+            recipientUsername?: string | null;
+        }): Promise<import("./types.js").ApiSuccessResponse<import("./types.js").PrivateConversation>>;
+        sendMessage(conversationId: string, input: import("./types.js").PrivateMessageSendInput): Promise<import("./types.js").ApiSuccessResponse<import("./types.js").PrivateMessageSendResponse>>;
+    };
     friend: {
         follow(userId: string): Promise<import("./types.js").ApiSuccessResponse<{
             success: true;
@@ -575,6 +583,11 @@ export declare function createApiClient(config: ApiClientConfig): {
         markGiftSeen(giftId: string): Promise<import("./types.js").ApiSuccessResponse<Record<string, unknown>>>;
     };
     system: {
+        createGlobalAlert(input: import("./types.js").SystemAlertInput): Promise<import("./types.js").ApiSuccessResponse<import("./types.js").SystemAlertResponse<import("./types.js").SystemAlert>>>;
+        createRoomAlert(roomId: string, input: import("./types.js").SystemAlertInput): Promise<import("./types.js").ApiSuccessResponse<import("./types.js").SystemAlertResponse<import("./types.js").RoomSystemAlert>>>;
+        createUserAlert(userId: string, input: import("./types.js").SystemAlertInput & {
+            roomId?: string | null;
+        }): Promise<import("./types.js").ApiSuccessResponse<import("./types.js").SystemAlertResponse<import("./types.js").UserSystemAlert>>>;
         getTeam(): Promise<import("./types.js").ApiSuccessResponse<import("./types.js").TeamDirectory>>;
         getCountryFlags(): Promise<import("./types.js").ApiSuccessResponse<import("./types.js").CountryFlagSettings>>;
         updateCountryFlags(input: import("./types.js").CountryFlagSettings): Promise<import("./types.js").ApiSuccessResponse<import("./types.js").CountryFlagSettings>>;

package/dist/index.js

@@ -7,6 +7,7 @@ export { createRoomResource } from "./resources/room.js";
 export { createPlaylistResource } from "./resources/playlist.js";
 export { createSourceResource } from "./resources/source.js";
 export { createChatResource } from "./resources/chat.js";
+export { createPrivateMessagesResource } from "./resources/privateMessages.js";
 export { createFriendResource } from "./resources/friend.js";
 export { createUserBlocksResource } from "./resources/userBlocks.js";
 export { createGiveawaysResource } from "./resources/giveaways.js";
@@ -26,6 +27,7 @@ import { createRoomResource } from "./resources/room.js";
 import { createPlaylistResource } from "./resources/playlist.js";
 import { createSourceResource } from "./resources/source.js";
 import { createChatResource } from "./resources/chat.js";
+import { createPrivateMessagesResource } from "./resources/privateMessages.js";
 import { createFriendResource } from "./resources/friend.js";
 import { createUserBlocksResource } from "./resources/userBlocks.js";
 import { createGiveawaysResource } from "./resources/giveaways.js";
@@ -45,6 +47,7 @@ export function createApiClient(config) {
         playlist: createPlaylistResource(api),
         source: createSourceResource(api),
         chat: createChatResource(api),
+        privateMessages: createPrivateMessagesResource(api),
         friend: createFriendResource(api),
         userBlocks: createUserBlocksResource(api),
         giveaways: createGiveawaysResource(api),

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/resources/privateMessages.d.ts

@@ -0,0 +1,9 @@
+import type { ApiLike, PrivateConversation, PrivateMessageSendInput, PrivateMessageSendResponse } from "../types.js";
+export declare function createPrivateMessagesResource(api: ApiLike): {
+    openConversation(input: {
+        recipientUserId?: string | null;
+        recipientUsername?: string | null;
+    }): Promise<import("../types.js").ApiSuccessResponse<PrivateConversation>>;
+    /** Session-authenticated. Retries must reuse the original clientMessageId. */
+    sendMessage(conversationId: string, input: PrivateMessageSendInput): Promise<import("../types.js").ApiSuccessResponse<PrivateMessageSendResponse>>;
+};

package/dist/resources/privateMessages.js

@@ -0,0 +1,12 @@
+export function createPrivateMessagesResource(api) {
+    return {
+        openConversation(input) {
+            return api.post("/private-messages/conversations", input);
+        },
+        /** Session-authenticated. Retries must reuse the original clientMessageId. */
+        sendMessage(conversationId, input) {
+            return api.post(`/private-messages/conversations/${encodeURIComponent(conversationId)}/messages`, input);
+        },
+    };
+}
+//# sourceMappingURL=privateMessages.js.map

package/dist/resources/privateMessages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"privateMessages.js","sourceRoot":"","sources":["../../src/resources/privateMessages.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,6BAA6B,CAAC,GAAY;IACtD,OAAO;QACH,gBAAgB,CAAC,KAGhB;YACG,OAAO,GAAG,CAAC,IAAI,CACX,iCAAiC,EACjC,KAAK,CACR,CAAC;QACN,CAAC;QAED,8EAA8E;QAC9E,WAAW,CAAC,cAAsB,EAAE,KAA8B;YAC9D,OAAO,GAAG,CAAC,IAAI,CACX,mCAAmC,kBAAkB,CAAC,cAAc,CAAC,WAAW,EAChF,KAAK,CACR,CAAC;QACN,CAAC;KACJ,CAAC;AACN,CAAC"}

package/dist/resources/system.d.ts

@@ -1,5 +1,13 @@
-import type { AdminSystemHealth, AdminSystemStatus, ApiLike, CountryFlagSettings, StageHoverSettings, TeamDirectory, NotificationCenterClearResponse, NotificationCenterStatus, RoomGlobalLimits, RoomGlobalLimitsUpdateInput, SystemHealth, SystemPublicStats, SystemStatus } from "../types.js";
+import type { AdminSystemHealth, AdminSystemStatus, ApiLike, CountryFlagSettings, StageHoverSettings, TeamDirectory, NotificationCenterClearResponse, NotificationCenterStatus, RoomGlobalLimits, RoomGlobalLimitsUpdateInput, RoomSystemAlert, SystemAlertInput, SystemAlertResponse, SystemHealth, SystemPublicStats, SystemStatus, UserSystemAlert } from "../types.js";
 export declare function createSystemResource(api: ApiLike): {
+    /** Requires an admin session. Delivery defaults to room chat. */
+    createGlobalAlert(input: SystemAlertInput): Promise<import("../types.js").ApiSuccessResponse<SystemAlertResponse<import("../types.js").SystemAlert>>>;
+    /** Requires an admin session. Delivery defaults to room chat. */
+    createRoomAlert(roomId: string, input: SystemAlertInput): Promise<import("../types.js").ApiSuccessResponse<SystemAlertResponse<RoomSystemAlert>>>;
+    /** Requires an admin session. Defaults to popup; chat requires a roomId. */
+    createUserAlert(userId: string, input: SystemAlertInput & {
+        roomId?: string | null;
+    }): Promise<import("../types.js").ApiSuccessResponse<SystemAlertResponse<UserSystemAlert>>>;
     getTeam(): Promise<import("../types.js").ApiSuccessResponse<TeamDirectory>>;
     getCountryFlags(): Promise<import("../types.js").ApiSuccessResponse<CountryFlagSettings>>;
     updateCountryFlags(input: CountryFlagSettings): Promise<import("../types.js").ApiSuccessResponse<CountryFlagSettings>>;

package/dist/resources/system.js

@@ -1,5 +1,17 @@
 export function createSystemResource(api) {
     return {
+        /** Requires an admin session. Delivery defaults to room chat. */
+        createGlobalAlert(input) {
+            return api.post("/admin/system-alerts", input);
+        },
+        /** Requires an admin session. Delivery defaults to room chat. */
+        createRoomAlert(roomId, input) {
+            return api.post(`/admin/rooms/${encodeURIComponent(roomId)}/system-alerts`, input);
+        },
+        /** Requires an admin session. Defaults to popup; chat requires a roomId. */
+        createUserAlert(userId, input) {
+            return api.post(`/admin/users/${encodeURIComponent(userId)}/system-alerts`, input);
+        },
         getTeam() {
             return api.get("/team", { authMode: "none" });
         },

package/dist/resources/system.js.map

@@ -1 +1 @@
-{"version":3,"file":"system.js","sourceRoot":"","sources":["../../src/resources/system.ts"],"names":[],"mappings":"AAgBA,MAAM,UAAU,oBAAoB,CAAC,GAAY;IAC7C,OAAO;QACH,OAAO;YACH,OAAO,GAAG,CAAC,GAAG,CAAgB,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QACjE,CAAC;QAED,eAAe;YACX,OAAO,GAAG,CAAC,GAAG,CAAsB,uBAAuB,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QACvF,CAAC;QAED,kBAAkB,CAAC,KAA0B;YACzC,OAAO,GAAG,CAAC,IAAI,CAAsB,6BAA6B,EAAE,KAAK,CAAC,CAAC;QAC/E,CAAC;QAED,qBAAqB;YACjB,OAAO,GAAG,CAAC,GAAG,CAAqB,qBAAqB,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QACpF,CAAC;QAED,wBAAwB,CAAC,KAAkD;YACvE,OAAO,GAAG,CAAC,IAAI,CAAqB,2BAA2B,EAAE,KAAK,CAAC,CAAC;QAC5E,CAAC;QAED,aAAa;YACT,OAAO,GAAG,CAAC,GAAG,CAAmB,qBAAqB,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QAClF,CAAC;QAED,eAAe;YACX,OAAO,GAAG,CAAC,GAAG,CAAmB,2BAA2B,CAAC,CAAC;QAClE,CAAC;QAED,gBAAgB,CAAC,KAAkC;YAC/C,OAAO,GAAG,CAAC,GAAG,CAAmB,2BAA2B,EAAE,KAAK,CAAC,CAAC;QACzE,CAAC;QAED,MAAM;YACF,OAAO,GAAG,CAAC,GAAG,CAAe,gBAAgB,EAAE;gBAC3C,QAAQ,EAAE,MAAM;aACnB,CAAC,CAAC;QACP,CAAC;QAED,WAAW;YACP,OAAO,GAAG,CAAC,GAAG,CAAoB,sBAAsB,CAAC,CAAC;QAC9D,CAAC;QAED,WAAW;YACP,OAAO,GAAG,CAAC,GAAG,CAAoB,sBAAsB,CAAC,CAAC;QAC9D,CAAC;QAED,WAAW;YACP,OAAO,GAAG,CAAC,GAAG,CAAoB,sBAAsB,EAAE;gBACtD,QAAQ,EAAE,MAAM;aACnB,CAAC,CAAC;QACP,CAAC;QAED,2BAA2B;YACvB,OAAO,GAAG,CAAC,GAAG,CACV,8BAA8B,CACjC,CAAC;QACN,CAAC;QAED,uBAAuB;YACnB,OAAO,GAAG,CAAC,IAAI,CACX,6BAA6B,EAC7B,EAAE,CACL,CAAC;QACN,CAAC;QAED,MAAM;YACF,OAAO,GAAG,CAAC,GAAG,CAAe,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE;gBACpD,QAAQ,EAAE,MAAM;aACnB,CAAC,CAAC;QACP,CAAC;KACJ,CAAC;AACN,CAAC"}
+{"version":3,"file":"system.js","sourceRoot":"","sources":["../../src/resources/system.ts"],"names":[],"mappings":"AAoBA,MAAM,UAAU,oBAAoB,CAAC,GAAY;IAC7C,OAAO;QACH,iEAAiE;QACjE,iBAAiB,CAAC,KAAuB;YACrC,OAAO,GAAG,CAAC,IAAI,CAAsB,sBAAsB,EAAE,KAAK,CAAC,CAAC;QACxE,CAAC;QAED,iEAAiE;QACjE,eAAe,CAAC,MAAc,EAAE,KAAuB;YACnD,OAAO,GAAG,CAAC,IAAI,CACX,gBAAgB,kBAAkB,CAAC,MAAM,CAAC,gBAAgB,EAC1D,KAAK,CACR,CAAC;QACN,CAAC;QAED,4EAA4E;QAC5E,eAAe,CAAC,MAAc,EAAE,KAAoD;YAChF,OAAO,GAAG,CAAC,IAAI,CACX,gBAAgB,kBAAkB,CAAC,MAAM,CAAC,gBAAgB,EAC1D,KAAK,CACR,CAAC;QACN,CAAC;QAED,OAAO;YACH,OAAO,GAAG,CAAC,GAAG,CAAgB,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QACjE,CAAC;QAED,eAAe;YACX,OAAO,GAAG,CAAC,GAAG,CAAsB,uBAAuB,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QACvF,CAAC;QAED,kBAAkB,CAAC,KAA0B;YACzC,OAAO,GAAG,CAAC,IAAI,CAAsB,6BAA6B,EAAE,KAAK,CAAC,CAAC;QAC/E,CAAC;QAED,qBAAqB;YACjB,OAAO,GAAG,CAAC,GAAG,CAAqB,qBAAqB,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QACpF,CAAC;QAED,wBAAwB,CAAC,KAAkD;YACvE,OAAO,GAAG,CAAC,IAAI,CAAqB,2BAA2B,EAAE,KAAK,CAAC,CAAC;QAC5E,CAAC;QAED,aAAa;YACT,OAAO,GAAG,CAAC,GAAG,CAAmB,qBAAqB,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QAClF,CAAC;QAED,eAAe;YACX,OAAO,GAAG,CAAC,GAAG,CAAmB,2BAA2B,CAAC,CAAC;QAClE,CAAC;QAED,gBAAgB,CAAC,KAAkC;YAC/C,OAAO,GAAG,CAAC,GAAG,CAAmB,2BAA2B,EAAE,KAAK,CAAC,CAAC;QACzE,CAAC;QAED,MAAM;YACF,OAAO,GAAG,CAAC,GAAG,CAAe,gBAAgB,EAAE;gBAC3C,QAAQ,EAAE,MAAM;aACnB,CAAC,CAAC;QACP,CAAC;QAED,WAAW;YACP,OAAO,GAAG,CAAC,GAAG,CAAoB,sBAAsB,CAAC,CAAC;QAC9D,CAAC;QAED,WAAW;YACP,OAAO,GAAG,CAAC,GAAG,CAAoB,sBAAsB,CAAC,CAAC;QAC9D,CAAC;QAED,WAAW;YACP,OAAO,GAAG,CAAC,GAAG,CAAoB,sBAAsB,EAAE;gBACtD,QAAQ,EAAE,MAAM;aACnB,CAAC,CAAC;QACP,CAAC;QAED,2BAA2B;YACvB,OAAO,GAAG,CAAC,GAAG,CACV,8BAA8B,CACjC,CAAC;QACN,CAAC;QAED,uBAAuB;YACnB,OAAO,GAAG,CAAC,IAAI,CACX,6BAA6B,EAC7B,EAAE,CACL,CAAC;QACN,CAAC;QAED,MAAM;YACF,OAAO,GAAG,CAAC,GAAG,CAAe,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE;gBACpD,QAAQ,EAAE,MAAM;aACnB,CAAC,CAAC;QACP,CAAC;KACJ,CAAC;AACN,CAAC"}

package/dist/types.d.ts

@@ -578,8 +578,139 @@ export interface ChatMessage {
     targetUserIds?: string[];
     /** Structured card supplied by a room bot, when present. */
     embed?: RoomBotChatEmbed | null;
+    systemColor?: string | null;
+    systemAppearance?: SystemAlertAppearance | null;
     [key: string]: unknown;
 }
+/** Appearance values accepted by the administrative system-alert endpoints. */
+export interface SystemAlertAppearance {
+    background?: string;
+    border?: string;
+    titleColor?: string;
+    textColor?: string;
+    iconColor?: string;
+    iconBackground?: string;
+    iconBackgroundEnabled?: boolean;
+    /** Defaults to false. Places the icon before the title when enabled. */
+    iconBeforeTitle?: boolean;
+    icon?: "info" | "brand" | "warning" | "bell" | "gift" | "none";
+    iconPosition?: "left" | "top" | "right";
+    iconSize?: number;
+    width?: number;
+    titleSize?: number;
+    textSize?: number;
+}
+export interface SystemAlertInput {
+    color?: string;
+    appearance?: SystemAlertAppearance | null;
+    delivery?: "chat" | "popup";
+    bilingual?: boolean;
+    fallbackLocale?: string | null;
+    title?: string | null;
+    message?: string | null;
+    titlePtBr?: string | null;
+    messagePtBr?: string | null;
+    titleEnUs?: string | null;
+    messageEnUs?: string | null;
+}
+/** Text returned by HTTP; appearance, color and delivery are realtime fields. */
+export interface SystemAlert {
+    bilingual: boolean;
+    title: string;
+    message: string;
+    titlePtBr: string | null;
+    messagePtBr: string | null;
+    titleEnUs: string | null;
+    messageEnUs: string | null;
+}
+export interface RoomSystemAlert extends SystemAlert {
+    roomId: string;
+}
+export interface UserSystemAlert extends SystemAlert {
+    targetUserId: string;
+    targetUsername: string;
+    targetDisplayUsername: string;
+    roomId: string | null;
+    roomName: string | null;
+}
+export interface SystemAlertResponse<TAlert extends SystemAlert = SystemAlert> {
+    success: true;
+    alert: TAlert;
+}
+export interface PrivateMessageCustomEmoji {
+    id: string;
+    shortcode: string;
+    imageUrl: string;
+    source?: "room" | "favorite";
+    roomId?: string | null;
+    roomName?: string | null;
+    roomLogoUrl?: string | null;
+    roomSlug?: string | null;
+    roomIsPrivate?: boolean;
+    createdById?: string | null;
+    createdByUsername?: string | null;
+    createdAt?: string | null;
+}
+export interface PrivateMessageUser {
+    id: string;
+    username: string;
+    displayUsername: string;
+    avatar: string | null;
+    platformRole: string;
+    platformRoles: string[];
+    presenceStatus: "online" | "busy" | "away" | "offline";
+}
+export interface PrivateMessageReply {
+    id: string;
+    userId: string;
+    username: string;
+    content: string;
+    customEmojis: PrivateMessageCustomEmoji[];
+    deleted: boolean;
+}
+export interface PrivateMessage {
+    id: string;
+    conversationId: string;
+    senderUserId: string;
+    recipientUserId: string;
+    content: string;
+    customEmojis: PrivateMessageCustomEmoji[];
+    createdAt: string;
+    editedAt: string | null;
+    originalContent: string | null;
+    readAt: string | null;
+    replyTo: PrivateMessageReply | null;
+    reactions: Array<{
+        emoji: string;
+        count: number;
+        userIds: string[];
+        customEmoji?: PrivateMessageCustomEmoji | null;
+    }>;
+}
+export interface PrivateConversation {
+    id: string;
+    participantAId: string;
+    participantBId: string;
+    createdAt: string;
+    updatedAt: string;
+    participants: PrivateMessageUser[];
+    lastMessage: PrivateMessage | null;
+    unreadCount: number;
+}
+export interface PrivateMessageSendInput {
+    content: string;
+    /** Optional UUID v4. Reuse the same ID and content when retrying a send. */
+    clientMessageId?: string;
+    roomId?: string | null;
+    customEmojiIds?: string[];
+    replyTo?: {
+        id?: string | null;
+    } | null;
+}
+export interface PrivateMessageSendResponse {
+    conversation: PrivateConversation;
+    message: PrivateMessage;
+}
 export interface WalletBalance {
     coins: number;
     diamonds: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wavezfm/api",
-  "version": "0.7.14",
+  "version": "0.7.15",
   "description": "Official JavaScript/TypeScript API client for WavezFM.",
   "homepage": "https://docs.wavez.fm/docs",
   "repository": {
@@ -65,6 +65,10 @@
       "types": "./dist/resources/chat.d.ts",
       "import": "./dist/resources/chat.js"
     },
+    "./resources/private-messages": {
+      "types": "./dist/resources/privateMessages.d.ts",
+      "import": "./dist/resources/privateMessages.js"
+    },
     "./resources/friend": {
       "types": "./dist/resources/friend.d.ts",
       "import": "./dist/resources/friend.js"