@crowdedkingdomstudios/crowdyjs 4.0.0 → 5.0.0

package/dist/domains/udp.js

@@ -1,4 +1,4 @@
-import { ConnectUdpProxyDocument, DisconnectUdpProxyDocument, UdpProxyConnectionStatusDocument, SendActorUpdateDocument, SendVoxelUpdateDocument, SendAudioPacketDocument, SendTextPacketDocument, SendClientEventDocument, SendSingleActorMessageDocument, } from '../generated/graphql.js';
+import { ConnectUdpProxyDocument, DisconnectUdpProxyDocument, UdpProxyConnectionStatusDocument, SendActorUpdateDocument, SendVoxelUpdateDocument, SendAudioPacketDocument, SendTextPacketDocument, SendClientEventDocument, SendSingleActorMessageDocument, SendChannelMessageDocument, } from '../generated/graphql.js';
 import { SequenceAllocator } from '../utils.js';
 /**
  * UDP proxy access for browser-style clients that can't open raw UDP
@@ -89,13 +89,28 @@ export class UdpAPI {
         return data.sendSingleActorMessage;
     }
     /**
-     * Subscribe to udpNotifications. Pass any combination of typename
-     * handlers; the returned function detaches all of them. The first
-     * subscriber opens the shared WebSocket; the last one to leave closes
-     * it.
+     * Publish a message to a channel. Delivered to every active member of the
+     * channel (regardless of location) as a `ChannelMessageNotification` on their
+     * `udpNotifications` subscription. Requires the channel `send_messages`
+     * permission; the server drops the message otherwise. Fire-and-forget: the
+     * sender receives no echo.
      */
-    subscribe(handlers) {
-        return this.subs.subscribe(handlers);
+    async sendChannelMessage(input) {
+        const data = await this.gql.request(SendChannelMessageDocument, { input });
+        return data.sendChannelMessage;
+    }
+    /**
+     * Subscribe to udpNotifications for a single app. Pass any combination of
+     * typename handlers; the returned function detaches all of them. The first
+     * subscriber opens the shared WebSocket; the last one to leave closes it.
+     *
+     * `appId` is required and scopes the subscription to one app: the game-api
+     * only delivers that app's spatial notifications and rejects app-agnostic
+     * subscriptions (a single game token reused across apps would otherwise
+     * cross-deliver). Use a separate client per app (sharing the token store).
+     */
+    subscribe(handlers, appId) {
+        return this.subs.subscribe(handlers, appId);
     }
     withSequence(input) {
         return {