@wavezfm/api 0.7.19 → 0.7.21

package/README.md

@@ -89,6 +89,24 @@ await client.roomBot.sendMessage('room-id', {
 });
 ```
 
+Embed images keep their natural size by default, capped at the chat width,
+480 CSS pixels wide and 288 CSS pixels high. Set `imageWidth` to an integer from
+16 to 480 with `imageUrl` to limit the displayed width; the web client preserves
+its aspect ratio, never upscales it, and fits it within the available chat space.
+Clicking the image still opens the original full-size preview.
+
+```ts
+await client.roomBot.sendMessage('room-id', {
+  content: '@Alice is away. Back soon.',
+  embed: {
+    title: 'AFK',
+    description: '@Alice is away. Back soon.',
+    imageUrl: 'https://images.example.com/afk.png',
+    imageWidth: 64,
+  },
+});
+```
+
 Bots with `send_chat` permission can upload a chat image with
 `client.roomBot.uploadImage(roomId, imageBlob, 'photo.png')`. It accepts a `Blob`
 or an existing `FormData` containing the `image` field; a `FormData` may also

package/dist/types.d.ts

@@ -198,6 +198,8 @@ export interface BadgeAssignment {
     [key: string]: unknown;
 }
 export interface RoomActiveUser {
+    /** Approximate country detected from the current connection IP, never the profile flag. */
+    connectionCountryCode?: string | null;
     id: string;
     username: string;
     displayUsername?: string | null;
@@ -984,6 +986,8 @@ export interface RoomBotChatEmbed {
     description?: string;
     color?: string;
     imageUrl?: string;
+    /** Maximum display width in CSS pixels (integer 16-480); requires imageUrl. Images are not upscaled. */
+    imageWidth?: number;
     fields?: Array<{
         name: string;
         value: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wavezfm/api",
-  "version": "0.7.19",
+  "version": "0.7.21",
   "description": "Official JavaScript/TypeScript API client for WavezFM.",
   "homepage": "https://docs.wavez.fm/docs",
   "repository": {