@fishjam-cloud/js-server-sdk 0.28.0-rc.0 → 0.28.0

package/dist/{chunk-GERVP75S.mjs → chunk-7QSC3SIL.mjs}

@@ -1,7 +1,7 @@
 // package.json
 var package_default = {
   name: "@fishjam-cloud/js-server-sdk",
-  version: "0.28.0-rc.0",
+  version: "0.28.0",
   description: "Fishjam server SDK for JavaScript",
   homepage: "https://github.com/fishjam-cloud/js-server-sdk",
   author: "Fishjam Team",
@@ -90,8 +90,7 @@ var package_default = {
     "*.{js,ts,tsx,mjs,cjs}": [
       "eslint --fix --config eslint.config.mjs"
     ]
-  },
-  stableVersion: "0.27.0"
+  }
 };
 
 export {

package/dist/index.d.mts

@@ -926,6 +926,17 @@ type ChannelRemoved = Notifications['channelRemoved'];
 type NotificationEvents = {
     [K in ExpectedEvents]: (message: Notifications[K]) => void;
 };
+/**
+ * A single decoded, mapped server notification tagged with its event type.
+ * The discriminated `type` lets consumers narrow `notification` to the matching
+ * payload (e.g. `if (n.type === 'peerConnected') n.notification.peerType`).
+ */
+type ServerNotification = {
+    [K in ExpectedEvents]: {
+        type: K;
+        notification: Notifications[K];
+    };
+}[ExpectedEvents];
 
 declare const FishjamWSNotifier_base: new () => TypedEventEmitter<NotificationEvents>;
 /**
@@ -937,9 +948,37 @@ declare class FishjamWSNotifier extends FishjamWSNotifier_base {
     constructor(config: FishjamConfig, onError: ErrorEventHandler, onClose: CloseEventHandler);
     private dispatchNotification;
     private setupConnection;
-    private isExpectedEvent;
 }
 
+/**
+ * Decode a raw Fishjam webhook body (`application/x-protobuf`) into typed,
+ * mapped notifications.
+ *
+ * A room/stream created with `batchWebhookNotifications: true` may deliver
+ * several notifications coalesced into a single `NotificationBatch`; this helper
+ * transparently unwraps that batch, so a single message and a batch are handled
+ * the same way. Notifications are returned in wire order, with the same payload
+ * mapping the {@link FishjamWSNotifier} applies (branded ids, `peerType`/`track`
+ * enums). Non-surfaced variants (handshake, deprecated) are omitted.
+ *
+ * Accepts a Node `Buffer` (a `Uint8Array` subclass), a `Uint8Array`, or an
+ * `ArrayBuffer`.
+ *
+ * @example
+ * ```ts
+ * import { decodeServerNotifications } from '@fishjam-cloud/js-server-sdk';
+ *
+ * declare const body: Uint8Array;
+ * declare const handlePeerConnected: (notification: unknown) => void;
+ * // ---cut---
+ * for (const { type, notification } of decodeServerNotifications(body)) {
+ *   if (type === 'peerConnected') handlePeerConnected(notification);
+ * }
+ * ```
+ * @category Notifications
+ */
+declare const decodeServerNotifications: (data: Uint8Array | ArrayBuffer) => ServerNotification[];
+
 declare const expectedEventsList: readonly ["trackData"];
 /**
  * @useDeclaredType
@@ -1170,4 +1209,4 @@ declare class QuotaExceededException extends FishjamBaseException {
 declare class UnknownException extends FishjamBaseException {
 }
 
-export { type AgentCallbacks, type AgentEvents, type AgentTrack, type AudioCodecParameters, BadRequestException, type Brand, type ChannelAdded, type ChannelRemoved, type CloseEventHandler, type ErrorEventHandler, type ExpectedAgentEvents, type ExpectedEvents, FishjamAgent, FishjamBaseException, FishjamClient, type FishjamConfig, FishjamNotFoundException, FishjamWSNotifier, ForbiddenException, type IgnoredEvents, type IncomingTrackData, type IncomingTrackImage, InvalidFishjamCredentialsException, MissingFishjamIdException, type MoqToken, type MoqTokenConfig, type NotificationEvents, type OutgoingTrackData, type Override, type Peer, type PeerAdded, type PeerConnected, type PeerCrashed, type PeerDeleted, type PeerDisconnected, type PeerId, type PeerMetadataUpdated, PeerNotFoundException, type PeerOptions, type PeerOptionsAgent, type PeerOptionsVapi, type PeerOptionsWebRTC, PeerStatus, type PeerType, QuotaExceededException, type Room, type RoomConfig, type RoomCrashed, type RoomCreated, type RoomDeleted, type RoomId, RoomNotFoundException, RoomType, ServerMessage, ServiceUnavailableException, type StreamerConnected, type StreamerDisconnected, type StreamerToken, type Track, type TrackAdded, type TrackId, type TrackMetadataUpdated, type TrackRemoved, type TrackType, UnauthorizedException, UnknownException, VideoCodec, type ViewerConnected, type ViewerDisconnected, type ViewerToken };
+export { type AgentCallbacks, type AgentEvents, type AgentTrack, type AudioCodecParameters, BadRequestException, type Brand, type ChannelAdded, type ChannelRemoved, type CloseEventHandler, type ErrorEventHandler, type ExpectedAgentEvents, type ExpectedEvents, FishjamAgent, FishjamBaseException, FishjamClient, type FishjamConfig, FishjamNotFoundException, FishjamWSNotifier, ForbiddenException, type IgnoredEvents, type IncomingTrackData, type IncomingTrackImage, InvalidFishjamCredentialsException, MissingFishjamIdException, type MoqToken, type MoqTokenConfig, type NotificationEvents, type OutgoingTrackData, type Override, type Peer, type PeerAdded, type PeerConnected, type PeerCrashed, type PeerDeleted, type PeerDisconnected, type PeerId, type PeerMetadataUpdated, PeerNotFoundException, type PeerOptions, type PeerOptionsAgent, type PeerOptionsVapi, type PeerOptionsWebRTC, PeerStatus, type PeerType, QuotaExceededException, type Room, type RoomConfig, type RoomCrashed, type RoomCreated, type RoomDeleted, type RoomId, RoomNotFoundException, RoomType, ServerMessage, type ServerNotification, ServiceUnavailableException, type StreamerConnected, type StreamerDisconnected, type StreamerToken, type Track, type TrackAdded, type TrackId, type TrackMetadataUpdated, type TrackRemoved, type TrackType, UnauthorizedException, UnknownException, VideoCodec, type ViewerConnected, type ViewerDisconnected, type ViewerToken, decodeServerNotifications };

package/dist/index.d.ts

@@ -926,6 +926,17 @@ type ChannelRemoved = Notifications['channelRemoved'];
 type NotificationEvents = {
     [K in ExpectedEvents]: (message: Notifications[K]) => void;
 };
+/**
+ * A single decoded, mapped server notification tagged with its event type.
+ * The discriminated `type` lets consumers narrow `notification` to the matching
+ * payload (e.g. `if (n.type === 'peerConnected') n.notification.peerType`).
+ */
+type ServerNotification = {
+    [K in ExpectedEvents]: {
+        type: K;
+        notification: Notifications[K];
+    };
+}[ExpectedEvents];
 
 declare const FishjamWSNotifier_base: new () => TypedEventEmitter<NotificationEvents>;
 /**
@@ -937,9 +948,37 @@ declare class FishjamWSNotifier extends FishjamWSNotifier_base {
     constructor(config: FishjamConfig, onError: ErrorEventHandler, onClose: CloseEventHandler);
     private dispatchNotification;
     private setupConnection;
-    private isExpectedEvent;
 }
 
+/**
+ * Decode a raw Fishjam webhook body (`application/x-protobuf`) into typed,
+ * mapped notifications.
+ *
+ * A room/stream created with `batchWebhookNotifications: true` may deliver
+ * several notifications coalesced into a single `NotificationBatch`; this helper
+ * transparently unwraps that batch, so a single message and a batch are handled
+ * the same way. Notifications are returned in wire order, with the same payload
+ * mapping the {@link FishjamWSNotifier} applies (branded ids, `peerType`/`track`
+ * enums). Non-surfaced variants (handshake, deprecated) are omitted.
+ *
+ * Accepts a Node `Buffer` (a `Uint8Array` subclass), a `Uint8Array`, or an
+ * `ArrayBuffer`.
+ *
+ * @example
+ * ```ts
+ * import { decodeServerNotifications } from '@fishjam-cloud/js-server-sdk';
+ *
+ * declare const body: Uint8Array;
+ * declare const handlePeerConnected: (notification: unknown) => void;
+ * // ---cut---
+ * for (const { type, notification } of decodeServerNotifications(body)) {
+ *   if (type === 'peerConnected') handlePeerConnected(notification);
+ * }
+ * ```
+ * @category Notifications
+ */
+declare const decodeServerNotifications: (data: Uint8Array | ArrayBuffer) => ServerNotification[];
+
 declare const expectedEventsList: readonly ["trackData"];
 /**
  * @useDeclaredType
@@ -1170,4 +1209,4 @@ declare class QuotaExceededException extends FishjamBaseException {
 declare class UnknownException extends FishjamBaseException {
 }
 
-export { type AgentCallbacks, type AgentEvents, type AgentTrack, type AudioCodecParameters, BadRequestException, type Brand, type ChannelAdded, type ChannelRemoved, type CloseEventHandler, type ErrorEventHandler, type ExpectedAgentEvents, type ExpectedEvents, FishjamAgent, FishjamBaseException, FishjamClient, type FishjamConfig, FishjamNotFoundException, FishjamWSNotifier, ForbiddenException, type IgnoredEvents, type IncomingTrackData, type IncomingTrackImage, InvalidFishjamCredentialsException, MissingFishjamIdException, type MoqToken, type MoqTokenConfig, type NotificationEvents, type OutgoingTrackData, type Override, type Peer, type PeerAdded, type PeerConnected, type PeerCrashed, type PeerDeleted, type PeerDisconnected, type PeerId, type PeerMetadataUpdated, PeerNotFoundException, type PeerOptions, type PeerOptionsAgent, type PeerOptionsVapi, type PeerOptionsWebRTC, PeerStatus, type PeerType, QuotaExceededException, type Room, type RoomConfig, type RoomCrashed, type RoomCreated, type RoomDeleted, type RoomId, RoomNotFoundException, RoomType, ServerMessage, ServiceUnavailableException, type StreamerConnected, type StreamerDisconnected, type StreamerToken, type Track, type TrackAdded, type TrackId, type TrackMetadataUpdated, type TrackRemoved, type TrackType, UnauthorizedException, UnknownException, VideoCodec, type ViewerConnected, type ViewerDisconnected, type ViewerToken };
+export { type AgentCallbacks, type AgentEvents, type AgentTrack, type AudioCodecParameters, BadRequestException, type Brand, type ChannelAdded, type ChannelRemoved, type CloseEventHandler, type ErrorEventHandler, type ExpectedAgentEvents, type ExpectedEvents, FishjamAgent, FishjamBaseException, FishjamClient, type FishjamConfig, FishjamNotFoundException, FishjamWSNotifier, ForbiddenException, type IgnoredEvents, type IncomingTrackData, type IncomingTrackImage, InvalidFishjamCredentialsException, MissingFishjamIdException, type MoqToken, type MoqTokenConfig, type NotificationEvents, type OutgoingTrackData, type Override, type Peer, type PeerAdded, type PeerConnected, type PeerCrashed, type PeerDeleted, type PeerDisconnected, type PeerId, type PeerMetadataUpdated, PeerNotFoundException, type PeerOptions, type PeerOptionsAgent, type PeerOptionsVapi, type PeerOptionsWebRTC, PeerStatus, type PeerType, QuotaExceededException, type Room, type RoomConfig, type RoomCrashed, type RoomCreated, type RoomDeleted, type RoomId, RoomNotFoundException, RoomType, ServerMessage, type ServerNotification, ServiceUnavailableException, type StreamerConnected, type StreamerDisconnected, type StreamerToken, type Track, type TrackAdded, type TrackId, type TrackMetadataUpdated, type TrackRemoved, type TrackType, UnauthorizedException, UnknownException, VideoCodec, type ViewerConnected, type ViewerDisconnected, type ViewerToken, decodeServerNotifications };

package/dist/index.js

@@ -48,7 +48,8 @@ __export(index_exports, {
   ServiceUnavailableException: () => ServiceUnavailableException,
   UnauthorizedException: () => UnauthorizedException,
   UnknownException: () => UnknownException,
-  VideoCodec: () => VideoCodec
+  VideoCodec: () => VideoCodec,
+  decodeServerNotifications: () => decodeServerNotifications
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -6056,6 +6057,16 @@ var mapNotification = (event, msg) => {
   }
   return msg;
 };
+var isExpectedEvent = (event) => expectedEventsList.includes(event);
+var flattenServerMessage = (message) => message.notificationBatch?.notifications ?? [message];
+var toServerNotification = (message) => {
+  const entry = Object.entries(message).find(([, value]) => value);
+  if (!entry) return null;
+  const [event, msg] = entry;
+  if (!isExpectedEvent(event)) return null;
+  return { type: event, notification: mapNotification(event, msg) };
+};
+var extractNotifications = (message) => flattenServerMessage(message).map(toServerNotification).filter((notification) => notification !== null);
 
 // src/ws_notifier.ts
 var FishjamWSNotifier = class extends import_events.EventEmitter {
@@ -6073,12 +6084,11 @@ var FishjamWSNotifier = class extends import_events.EventEmitter {
   }
   dispatchNotification(message) {
     try {
-      const data = new Uint8Array(message.data);
-      const decodedMessage = ServerMessage.decode(data);
-      const [notification, msg] = Object.entries(decodedMessage).find(([_k, v]) => v);
-      if (!this.isExpectedEvent(notification)) return;
-      const emit = this.emit;
-      emit(notification, mapNotification(notification, msg));
+      const decodedMessage = ServerMessage.decode(new Uint8Array(message.data));
+      const emit = this.emit.bind(this);
+      for (const { type, notification } of extractNotifications(decodedMessage)) {
+        emit(type, notification);
+      }
     } catch (e) {
       console.error("Couldn't decode websocket server message", e, message);
     }
@@ -6091,11 +6101,11 @@ var FishjamWSNotifier = class extends import_events.EventEmitter {
     this.client.send(auth);
     this.client.send(subscription);
   }
-  isExpectedEvent(notification) {
-    return expectedEventsList.includes(notification);
-  }
 };
 
+// src/webhook.ts
+var decodeServerNotifications = (data) => extractNotifications(ServerMessage.decode(data instanceof Uint8Array ? data : new Uint8Array(data)));
+
 // src/agent.ts
 var import_events2 = require("events");
 var import_uuid = require("uuid");
@@ -6285,7 +6295,7 @@ var mapException = (error, entity) => {
 // package.json
 var package_default = {
   name: "@fishjam-cloud/js-server-sdk",
-  version: "0.28.0-rc.0",
+  version: "0.28.0",
   description: "Fishjam server SDK for JavaScript",
   homepage: "https://github.com/fishjam-cloud/js-server-sdk",
   author: "Fishjam Team",
@@ -6374,8 +6384,7 @@ var package_default = {
     "*.{js,ts,tsx,mjs,cjs}": [
       "eslint --fix --config eslint.config.mjs"
     ]
-  },
-  stableVersion: "0.27.0"
+  }
 };
 
 // src/client.ts
@@ -6671,5 +6680,6 @@ var FishjamClient = class _FishjamClient {
   ServiceUnavailableException,
   UnauthorizedException,
   UnknownException,
-  VideoCodec
+  VideoCodec,
+  decodeServerNotifications
 });

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import {
   package_default
-} from "./chunk-GERVP75S.mjs";
+} from "./chunk-7QSC3SIL.mjs";
 
 // ../fishjam-openapi/dist/index.js
 import globalAxios2 from "axios";
@@ -6006,6 +6006,16 @@ var mapNotification = (event, msg) => {
   }
   return msg;
 };
+var isExpectedEvent = (event) => expectedEventsList.includes(event);
+var flattenServerMessage = (message) => message.notificationBatch?.notifications ?? [message];
+var toServerNotification = (message) => {
+  const entry = Object.entries(message).find(([, value]) => value);
+  if (!entry) return null;
+  const [event, msg] = entry;
+  if (!isExpectedEvent(event)) return null;
+  return { type: event, notification: mapNotification(event, msg) };
+};
+var extractNotifications = (message) => flattenServerMessage(message).map(toServerNotification).filter((notification) => notification !== null);
 
 // src/ws_notifier.ts
 var FishjamWSNotifier = class extends EventEmitter {
@@ -6023,12 +6033,11 @@ var FishjamWSNotifier = class extends EventEmitter {
   }
   dispatchNotification(message) {
     try {
-      const data = new Uint8Array(message.data);
-      const decodedMessage = ServerMessage.decode(data);
-      const [notification, msg] = Object.entries(decodedMessage).find(([_k, v]) => v);
-      if (!this.isExpectedEvent(notification)) return;
-      const emit = this.emit;
-      emit(notification, mapNotification(notification, msg));
+      const decodedMessage = ServerMessage.decode(new Uint8Array(message.data));
+      const emit = this.emit.bind(this);
+      for (const { type, notification } of extractNotifications(decodedMessage)) {
+        emit(type, notification);
+      }
     } catch (e) {
       console.error("Couldn't decode websocket server message", e, message);
     }
@@ -6041,11 +6050,11 @@ var FishjamWSNotifier = class extends EventEmitter {
     this.client.send(auth);
     this.client.send(subscription);
   }
-  isExpectedEvent(notification) {
-    return expectedEventsList.includes(notification);
-  }
 };
 
+// src/webhook.ts
+var decodeServerNotifications = (data) => extractNotifications(ServerMessage.decode(data instanceof Uint8Array ? data : new Uint8Array(data)));
+
 // src/agent.ts
 import { EventEmitter as EventEmitter2 } from "events";
 import { v4 as uuid4 } from "uuid";
@@ -6524,5 +6533,6 @@ export {
   ServiceUnavailableException,
   UnauthorizedException,
   UnknownException,
-  VideoCodec
+  VideoCodec,
+  decodeServerNotifications
 };

package/dist/integrations/gemini.js

@@ -31,7 +31,7 @@ var import_genai = require("@google/genai");
 // package.json
 var package_default = {
   name: "@fishjam-cloud/js-server-sdk",
-  version: "0.28.0-rc.0",
+  version: "0.28.0",
   description: "Fishjam server SDK for JavaScript",
   homepage: "https://github.com/fishjam-cloud/js-server-sdk",
   author: "Fishjam Team",
@@ -120,8 +120,7 @@ var package_default = {
     "*.{js,ts,tsx,mjs,cjs}": [
       "eslint --fix --config eslint.config.mjs"
     ]
-  },
-  stableVersion: "0.27.0"
+  }
 };
 
 // src/integrations/gemini.ts

package/dist/integrations/gemini.mjs

@@ -1,6 +1,6 @@
 import {
   package_default
-} from "../chunk-GERVP75S.mjs";
+} from "../chunk-7QSC3SIL.mjs";
 
 // src/integrations/gemini.ts
 import { GoogleGenAI } from "@google/genai";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fishjam-cloud/js-server-sdk",
-  "version": "0.28.0-rc.0",
+  "version": "0.28.0",
   "description": "Fishjam server SDK for JavaScript",
   "homepage": "https://github.com/fishjam-cloud/js-server-sdk",
   "author": "Fishjam Team",
@@ -74,8 +74,8 @@
     }
   },
   "devDependencies": {
-    "@fishjam-cloud/fishjam-openapi": "0.28.0-rc.0",
-    "@fishjam-cloud/fishjam-proto": "0.28.0-rc.0",
+    "@fishjam-cloud/fishjam-openapi": "0.28.0",
+    "@fishjam-cloud/fishjam-proto": "0.28.0",
     "@openapitools/openapi-generator-cli": "^2.18.4",
     "@types/node": "^22.13.16",
     "@types/websocket": "^1.0.10",
@@ -89,6 +89,5 @@
     "*.{js,ts,tsx,mjs,cjs}": [
       "eslint --fix --config eslint.config.mjs"
     ]
-  },
-  "stableVersion": "0.27.0"
+  }
 }