@ughuuu/game_server 1.0.382 → 1.0.791

package/dist/realtime.js

@@ -0,0 +1,247 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = exports.GameRealtime = void 0;
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _classCallCheck(a, n) { if (!(a instanceof n)) throw new TypeError("Cannot call a class as a function"); }
+function _defineProperties(e, r) { for (var t = 0; t < r.length; t++) { var o = r[t]; o.enumerable = o.enumerable || !1, o.configurable = !0, "value" in o && (o.writable = !0), Object.defineProperty(e, _toPropertyKey(o.key), o); } }
+function _createClass(e, r, t) { return r && _defineProperties(e.prototype, r), t && _defineProperties(e, t), Object.defineProperty(e, "prototype", { writable: !1 }), e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+/**
+ * GameRealtime — Phoenix WebSocket client for game_server.
+ *
+ * Wraps Phoenix.Socket to provide helpers for common game_server channel topics.
+ * Requires the `phoenix` npm package (peer dependency).
+ *
+ * Usage (browser / Node.js with bundler):
+ *
+ *   import { GameRealtime } from '@ughuuu/game_server'
+ *
+ *   const realtime = new GameRealtime('https://your-server.com', accessToken)
+ *
+ *   // Join the authenticated user channel
+ *   const userChannel = realtime.joinUserChannel(userId)
+ *   userChannel.on('notification', (payload) => console.log('notification:', payload))
+ *   userChannel.on('updated', (payload) => console.log('user updated:', payload))
+ *
+ *   // Join a lobby channel
+ *   const lobbyChannel = realtime.joinLobbyChannel(lobbyId)
+ *   lobbyChannel.on('updated', (payload) => console.log('lobby event:', payload))
+ *
+ *   realtime.disconnect()
+ *
+ * Peer dependency:
+ *
+ *   npm install phoenix
+ */
+
+var _Socket = null;
+try {
+  // Works in Node (bundled) and browser environments
+  // eslint-disable-next-line @typescript-eslint/no-var-requires
+  _Socket = require('phoenix').Socket;
+} catch (_) {
+  // Swallow — will throw a descriptive error at instantiation time
+}
+var GameRealtime = exports.GameRealtime = /*#__PURE__*/function () {
+  /**
+   * @param {string} serverUrl  - Base HTTP(S) or WS(S) server URL,
+   *                              e.g. "https://game.example.com" or "wss://game.example.com"
+   * @param {string} token      - JWT access token from the REST login endpoints
+   * @param {Object} socketOpts - Optional Phoenix.Socket constructor options
+   */
+  function GameRealtime(serverUrl, token) {
+    var socketOpts = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
+    _classCallCheck(this, GameRealtime);
+    if (!_Socket) {
+      throw new Error('GameRealtime requires the "phoenix" npm package. Install it: npm install phoenix');
+    }
+
+    // Normalise URL: strip trailing slash, ensure ws(s):// scheme, append /socket
+    var wsUrl = serverUrl.replace(/\/$/, '').replace(/^http(s?):\/\//, function (_m, s) {
+      return "ws".concat(s, "://");
+    }) + '/socket';
+    this._token = token;
+    this._socket = new _Socket(wsUrl, _objectSpread({
+      params: {
+        token: token
+      }
+    }, socketOpts));
+    this._socket.connect();
+    /** @type {Map<string, Object>} topic → Phoenix Channel */
+    this._channels = new Map();
+  }
+
+  // ── Channel helpers ──────────────────────────────────────────────────────
+
+  /**
+   * Join the user channel for notifications, presence, and real-time events.
+   * Topic: `"user:<userId>"`
+   * @param {string|number} userId
+   * @param {Object} params - Extra join params merged with the auth token
+   * @returns {Object} Phoenix Channel
+   */
+  return _createClass(GameRealtime, [{
+    key: "joinUserChannel",
+    value: function joinUserChannel(userId) {
+      var params = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+      return this._join("user:".concat(userId), params);
+    }
+
+    /**
+     * Join a lobby channel for in-lobby events (member joins/leaves, updates).
+     * Topic: `"lobby:<lobbyId>"`
+     * @param {string|number} lobbyId
+     * @param {Object} params
+     * @returns {Object} Phoenix Channel
+     */
+  }, {
+    key: "joinLobbyChannel",
+    value: function joinLobbyChannel(lobbyId) {
+      var params = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+      return this._join("lobby:".concat(lobbyId), params);
+    }
+
+    /**
+     * Join the global lobbies feed (lobby list changes).
+     * Topic: `"lobbies"`
+     * @param {Object} params
+     * @returns {Object} Phoenix Channel
+     */
+  }, {
+    key: "joinLobbiesChannel",
+    value: function joinLobbiesChannel() {
+      var params = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+      return this._join('lobbies', params);
+    }
+
+    /**
+     * Join a group channel for group events.
+     * Topic: `"group:<groupId>"`
+     * @param {string|number} groupId
+     * @param {Object} params
+     * @returns {Object} Phoenix Channel
+     */
+  }, {
+    key: "joinGroupChannel",
+    value: function joinGroupChannel(groupId) {
+      var params = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+      return this._join("group:".concat(groupId), params);
+    }
+
+    /**
+     * Join the global groups feed.
+     * Topic: `"groups"`
+     * @param {Object} params
+     * @returns {Object} Phoenix Channel
+     */
+  }, {
+    key: "joinGroupsChannel",
+    value: function joinGroupsChannel() {
+      var params = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+      return this._join('groups', params);
+    }
+
+    /**
+     * Join a party channel for party events.
+     * Topic: `"party:<partyId>"`
+     * @param {string|number} partyId
+     * @param {Object} params
+     * @returns {Object} Phoenix Channel
+     */
+  }, {
+    key: "joinPartyChannel",
+    value: function joinPartyChannel(partyId) {
+      var params = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+      return this._join("party:".concat(partyId), params);
+    }
+
+    /**
+     * Join an arbitrary channel topic.
+     * @param {string} topic  - Full Phoenix channel topic string
+     * @param {Object} params - Join params merged with the auth token
+     * @returns {Object} Phoenix Channel
+     */
+  }, {
+    key: "joinChannel",
+    value: function joinChannel(topic) {
+      var params = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+      return this._join(topic, params);
+    }
+
+    /**
+     * Leave and remove a channel by topic.
+     * @param {string} topic
+     */
+  }, {
+    key: "leaveChannel",
+    value: function leaveChannel(topic) {
+      var ch = this._channels.get(topic);
+      if (ch) {
+        ch.leave();
+        this._channels["delete"](topic);
+      }
+    }
+
+    /**
+     * Retrieve an already-joined channel by topic.
+     * @param {string} topic
+     * @returns {Object|undefined} Phoenix Channel or undefined if not joined
+     */
+  }, {
+    key: "channel",
+    value: function channel(topic) {
+      return this._channels.get(topic);
+    }
+
+    /**
+     * Access the underlying Phoenix.Socket instance.
+     * @returns {Object}
+     */
+  }, {
+    key: "socket",
+    get: function get() {
+      return this._socket;
+    }
+
+    /**
+     * Disconnect the socket and leave all channels.
+     */
+  }, {
+    key: "disconnect",
+    value: function disconnect() {
+      this._channels.forEach(function (ch) {
+        try {
+          ch.leave();
+        } catch (_) {}
+      });
+      this._channels.clear();
+      this._socket.disconnect();
+    }
+
+    // ── Private ────────────────────────────────────────────────────────────────
+  }, {
+    key: "_join",
+    value: function _join(topic) {
+      var extraParams = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+      if (this._channels.has(topic)) {
+        return this._channels.get(topic);
+      }
+      var ch = this._socket.channel(topic, _objectSpread({
+        token: this._token
+      }, extraParams));
+      ch.join().receive('error', function (err) {
+        return console.error("GameRealtime: failed to join channel \"".concat(topic, "\""), err);
+      });
+      this._channels.set(topic, ch);
+      return ch;
+    }
+  }]);
+}();
+var _default = exports["default"] = GameRealtime;

package/dist/webrtc.js

@@ -0,0 +1,375 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = exports.GameWebRTC = void 0;
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _regenerator() { /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/babel/babel/blob/main/packages/babel-helpers/LICENSE */ var e, t, r = "function" == typeof Symbol ? Symbol : {}, n = r.iterator || "@@iterator", o = r.toStringTag || "@@toStringTag"; function i(r, n, o, i) { var c = n && n.prototype instanceof Generator ? n : Generator, u = Object.create(c.prototype); return _regeneratorDefine2(u, "_invoke", function (r, n, o) { var i, c, u, f = 0, p = o || [], y = !1, G = { p: 0, n: 0, v: e, a: d, f: d.bind(e, 4), d: function d(t, r) { return i = t, c = 0, u = e, G.n = r, a; } }; function d(r, n) { for (c = r, u = n, t = 0; !y && f && !o && t < p.length; t++) { var o, i = p[t], d = G.p, l = i[2]; r > 3 ? (o = l === n) && (u = i[(c = i[4]) ? 5 : (c = 3, 3)], i[4] = i[5] = e) : i[0] <= d && ((o = r < 2 && d < i[1]) ? (c = 0, G.v = n, G.n = i[1]) : d < l && (o = r < 3 || i[0] > n || n > l) && (i[4] = r, i[5] = n, G.n = l, c = 0)); } if (o || r > 1) return a; throw y = !0, n; } return function (o, p, l) { if (f > 1) throw TypeError("Generator is already running"); for (y && 1 === p && d(p, l), c = p, u = l; (t = c < 2 ? e : u) || !y;) { i || (c ? c < 3 ? (c > 1 && (G.n = -1), d(c, u)) : G.n = u : G.v = u); try { if (f = 2, i) { if (c || (o = "next"), t = i[o]) { if (!(t = t.call(i, u))) throw TypeError("iterator result is not an object"); if (!t.done) return t; u = t.value, c < 2 && (c = 0); } else 1 === c && (t = i["return"]) && t.call(i), c < 2 && (u = TypeError("The iterator does not provide a '" + o + "' method"), c = 1); i = e; } else if ((t = (y = G.n < 0) ? u : r.call(n, G)) !== a) break; } catch (t) { i = e, c = 1, u = t; } finally { f = 1; } } return { value: t, done: y }; }; }(r, o, i), !0), u; } var a = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} t = Object.getPrototypeOf; var c = [][n] ? t(t([][n]())) : (_regeneratorDefine2(t = {}, n, function () { return this; }), t), u = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(c); function f(e) { return Object.setPrototypeOf ? Object.setPrototypeOf(e, GeneratorFunctionPrototype) : (e.__proto__ = GeneratorFunctionPrototype, _regeneratorDefine2(e, o, "GeneratorFunction")), e.prototype = Object.create(u), e; } return GeneratorFunction.prototype = GeneratorFunctionPrototype, _regeneratorDefine2(u, "constructor", GeneratorFunctionPrototype), _regeneratorDefine2(GeneratorFunctionPrototype, "constructor", GeneratorFunction), GeneratorFunction.displayName = "GeneratorFunction", _regeneratorDefine2(GeneratorFunctionPrototype, o, "GeneratorFunction"), _regeneratorDefine2(u), _regeneratorDefine2(u, o, "Generator"), _regeneratorDefine2(u, n, function () { return this; }), _regeneratorDefine2(u, "toString", function () { return "[object Generator]"; }), (_regenerator = function _regenerator() { return { w: i, m: f }; })(); }
+function _regeneratorDefine2(e, r, n, t) { var i = Object.defineProperty; try { i({}, "", {}); } catch (e) { i = 0; } _regeneratorDefine2 = function _regeneratorDefine(e, r, n, t) { function o(r, n) { _regeneratorDefine2(e, r, function (e) { return this._invoke(r, n, e); }); } r ? i ? i(e, r, { value: n, enumerable: !t, configurable: !t, writable: !t }) : e[r] = n : (o("next", 0), o("throw", 1), o("return", 2)); }, _regeneratorDefine2(e, r, n, t); }
+function _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t["return"] || t["return"](); } finally { if (u) throw o; } } }; }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+function asyncGeneratorStep(n, t, e, r, o, a, c) { try { var i = n[a](c), u = i.value; } catch (n) { return void e(n); } i.done ? t(u) : Promise.resolve(u).then(r, o); }
+function _asyncToGenerator(n) { return function () { var t = this, e = arguments; return new Promise(function (r, o) { var a = n.apply(t, e); function _next(n) { asyncGeneratorStep(a, r, o, _next, _throw, "next", n); } function _throw(n) { asyncGeneratorStep(a, r, o, _next, _throw, "throw", n); } _next(void 0); }); }; }
+function _classCallCheck(a, n) { if (!(a instanceof n)) throw new TypeError("Cannot call a class as a function"); }
+function _defineProperties(e, r) { for (var t = 0; t < r.length; t++) { var o = r[t]; o.enumerable = o.enumerable || !1, o.configurable = !0, "value" in o && (o.writable = !0), Object.defineProperty(e, _toPropertyKey(o.key), o); } }
+function _createClass(e, r, t) { return r && _defineProperties(e.prototype, r), t && _defineProperties(e, t), Object.defineProperty(e, "prototype", { writable: !1 }), e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+/**
+ * GameWebRTC — Browser WebRTC DataChannel client for game_server.
+ *
+ * Uses an existing Phoenix channel (e.g. from GameRealtime.joinUserChannel)
+ * for SDP/ICE signaling. Once connected, named DataChannels carry game data
+ * alongside the WebSocket at lower latency.
+ *
+ * Requires a browser with native WebRTC support (RTCPeerConnection).
+ * Does NOT work in Node.js without a WebRTC polyfill.
+ *
+ * Usage:
+ *
+ *   import { GameRealtime, GameWebRTC } from '@ughuuu/game_server'
+ *
+ *   const realtime = new GameRealtime('https://your-server.com', token)
+ *   const userChannel = realtime.joinUserChannel(userId)
+ *
+ *   const webrtc = new GameWebRTC(userChannel, {
+ *     dataChannels: [
+ *       { label: 'events', ordered: true },
+ *       { label: 'state',  ordered: false, maxRetransmits: 0 },
+ *     ],
+ *     onData:         (label, data)  => console.log('data', label, data),
+ *     onChannelOpen:  (label)        => console.log('channel open', label),
+ *     onChannelClose: (label)        => console.log('channel close', label),
+ *     onStateChange:  (state)        => console.log('state', state),
+ *   })
+ *
+ *   await webrtc.connect()
+ *   webrtc.send('events', JSON.stringify({ type: 'player_move', x: 10, y: 20 }))
+ *   webrtc.close()
+ */
+
+/**
+ * Default DataChannel definitions.
+ * - "events": reliable, ordered — important game events
+ * - "state":  unreliable, unordered — high-frequency position/state sync
+ */
+var DEFAULT_DATA_CHANNELS = [{
+  label: 'events',
+  ordered: true
+}, {
+  label: 'state',
+  ordered: false,
+  maxRetransmits: 0
+}];
+var DEFAULT_ICE_SERVERS = [{
+  urls: 'stun:stun.l.google.com:19302'
+}];
+var GameWebRTC = exports.GameWebRTC = /*#__PURE__*/function () {
+  /**
+   * @param {Object} channel — A joined Phoenix channel (e.g. from GameRealtime.joinUserChannel)
+   * @param {Object} opts
+   * @param {Array}    opts.dataChannels   — Array of {label, ordered, maxRetransmits?} definitions
+   * @param {Array}    opts.iceServers     — RTCIceServer configs (default: Google STUN)
+   * @param {Function} opts.onData        — (label: string, data: ArrayBuffer|string) => void
+   * @param {Function} opts.onChannelOpen  — (label: string) => void
+   * @param {Function} opts.onChannelClose — (label: string) => void
+   * @param {Function} opts.onStateChange  — (state: string) => void
+   * @param {Function} opts.onError        — (error: Error) => void
+   */
+  function GameWebRTC(channel) {
+    var opts = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+    _classCallCheck(this, GameWebRTC);
+    this.channel = channel;
+    this.opts = opts;
+    this.iceServers = opts.iceServers || DEFAULT_ICE_SERVERS;
+    this.dataChannelDefs = opts.dataChannels || DEFAULT_DATA_CHANNELS;
+
+    /** @type {RTCPeerConnection|null} */
+    this.pc = null;
+    /** @type {Map<string, RTCDataChannel>} label → RTCDataChannel */
+    this.channels = new Map();
+    /** @type {string} */
+    this.connectionState = 'new';
+    this._resolveConnect = null;
+    this._rejectConnect = null;
+    this._setupChannelListeners();
+  }
+
+  // ── Public API ─────────────────────────────────────────────────────────────
+
+  /**
+   * Initiate the WebRTC connection.
+   * Creates an RTCPeerConnection, opens DataChannels, sends an SDP offer
+   * over the Phoenix channel, and exchanges ICE candidates.
+   *
+   * @returns {Promise<void>} Resolves when at least one DataChannel is open.
+   */
+  return _createClass(GameWebRTC, [{
+    key: "connect",
+    value: function () {
+      var _connect = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee() {
+        var _this = this;
+        var _iterator, _step, def, dcOpts, dc, offer;
+        return _regenerator().w(function (_context) {
+          while (1) switch (_context.n) {
+            case 0:
+              this.pc = new RTCPeerConnection({
+                iceServers: this.iceServers
+              });
+              this.pc.onicecandidate = function (event) {
+                return _this._onIceCandidate(event);
+              };
+              this.pc.onconnectionstatechange = function () {
+                return _this._onConnectionStateChange();
+              };
+
+              // Create DataChannels on the client side (client-initiated)
+              _iterator = _createForOfIteratorHelper(this.dataChannelDefs);
+              try {
+                for (_iterator.s(); !(_step = _iterator.n()).done;) {
+                  def = _step.value;
+                  dcOpts = {
+                    ordered: def.ordered !== false
+                  };
+                  if (def.maxRetransmits !== undefined) dcOpts.maxRetransmits = def.maxRetransmits;
+                  if (def.maxPacketLifeTime !== undefined) dcOpts.maxPacketLifeTime = def.maxPacketLifeTime;
+                  dc = this.pc.createDataChannel(def.label, dcOpts);
+                  this._wireDataChannel(dc);
+                  this.channels.set(def.label, dc);
+                }
+
+                // Create and send SDP offer
+              } catch (err) {
+                _iterator.e(err);
+              } finally {
+                _iterator.f();
+              }
+              _context.n = 1;
+              return this.pc.createOffer();
+            case 1:
+              offer = _context.v;
+              _context.n = 2;
+              return this.pc.setLocalDescription(offer);
+            case 2:
+              return _context.a(2, new Promise(function (resolve, reject) {
+                _this.channel.push('webrtc:offer', {
+                  sdp: offer.sdp,
+                  type: offer.type
+                }).receive('ok', function () {
+                  // Offer accepted — wait for webrtc:answer from server
+                  _this._resolveConnect = resolve;
+                  _this._rejectConnect = reject;
+                }).receive('error', function (resp) {
+                  reject(new Error(resp.error || 'webrtc:offer rejected'));
+                });
+
+                // Timeout after 15 seconds
+                setTimeout(function () {
+                  if (_this._resolveConnect) {
+                    _this._resolveConnect = null;
+                    reject(new Error('WebRTC connection timed out'));
+                  }
+                }, 15000);
+              }));
+          }
+        }, _callee, this);
+      }));
+      function connect() {
+        return _connect.apply(this, arguments);
+      }
+      return connect;
+    }()
+    /**
+     * Send data over a named DataChannel.
+     * @param {string} label — channel label (e.g. "events" or "state")
+     * @param {string|ArrayBuffer|Blob} data
+     * @returns {boolean} true if sent, false if channel is not open
+     */
+  }, {
+    key: "send",
+    value: function send(label, data) {
+      var dc = this.channels.get(label);
+      if (!dc || dc.readyState !== 'open') return false;
+      dc.send(data);
+      return true;
+    }
+
+    /**
+     * Check if a specific DataChannel is open.
+     * @param {string} label
+     * @returns {boolean}
+     */
+  }, {
+    key: "isChannelOpen",
+    value: function isChannelOpen(label) {
+      var dc = this.channels.get(label);
+      return dc ? dc.readyState === 'open' : false;
+    }
+
+    /**
+     * Check if the WebRTC connection is active.
+     * @returns {boolean}
+     */
+  }, {
+    key: "isConnected",
+    value: function isConnected() {
+      return this.pc != null && this.connectionState === 'connected';
+    }
+
+    /**
+     * Close the WebRTC connection and all DataChannels.
+     * Notifies the server via the Phoenix channel.
+     */
+  }, {
+    key: "close",
+    value: function close() {
+      this._removeChannelListeners();
+
+      // Close all DataChannels
+      var _iterator2 = _createForOfIteratorHelper(this.channels.values()),
+        _step2;
+      try {
+        for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+          var dc = _step2.value;
+          try {
+            dc.close();
+          } catch (_) {}
+        }
+      } catch (err) {
+        _iterator2.e(err);
+      } finally {
+        _iterator2.f();
+      }
+      this.channels.clear();
+
+      // Close PeerConnection
+      if (this.pc) {
+        try {
+          this.pc.close();
+        } catch (_) {}
+        this.pc = null;
+      }
+
+      // Notify server
+      this.channel.push('webrtc:close', {});
+      this.connectionState = 'closed';
+    }
+
+    // ── Private: signaling channel listeners ──────────────────────────────────
+  }, {
+    key: "_setupChannelListeners",
+    value: function _setupChannelListeners() {
+      var _this2 = this;
+      // Server sends SDP answer
+      this._answerRef = this.channel.on('webrtc:answer', function (payload) {
+        if (_this2.pc) {
+          _this2.pc.setRemoteDescription(new RTCSessionDescription({
+            sdp: payload.sdp,
+            type: payload.type
+          }));
+        }
+      });
+
+      // Server sends ICE candidate
+      this._iceRef = this.channel.on('webrtc:ice', function (payload) {
+        if (_this2.pc && payload.candidate) {
+          _this2.pc.addIceCandidate(new RTCIceCandidate(payload))["catch"](function (err) {
+            return _this2._emitError(err);
+          });
+        }
+      });
+
+      // Server notifies about connection state changes
+      this._stateRef = this.channel.on('webrtc:state', function (payload) {
+        var cb = _this2.opts.onStateChange;
+        if (cb) cb(payload.state);
+      });
+
+      // Server relays DataChannel data back via WebSocket (fallback)
+      this._dataRef = this.channel.on('webrtc:data', function (payload) {
+        var cb = _this2.opts.onData;
+        if (cb) cb(payload.channel, payload.data);
+      });
+
+      // Server confirms channel open
+      this._openRef = this.channel.on('webrtc:channel_open', function (payload) {
+        var cb = _this2.opts.onChannelOpen;
+        if (cb) cb(payload.channel);
+      });
+    }
+  }, {
+    key: "_removeChannelListeners",
+    value: function _removeChannelListeners() {
+      if (this._answerRef) this.channel.off('webrtc:answer', this._answerRef);
+      if (this._iceRef) this.channel.off('webrtc:ice', this._iceRef);
+      if (this._stateRef) this.channel.off('webrtc:state', this._stateRef);
+      if (this._dataRef) this.channel.off('webrtc:data', this._dataRef);
+      if (this._openRef) this.channel.off('webrtc:channel_open', this._openRef);
+    }
+
+    // ── Private: RTCPeerConnection event handlers ─────────────────────────────
+  }, {
+    key: "_onIceCandidate",
+    value: function _onIceCandidate(event) {
+      if (event.candidate) {
+        this.channel.push('webrtc:ice', event.candidate.toJSON());
+      }
+    }
+  }, {
+    key: "_onConnectionStateChange",
+    value: function _onConnectionStateChange() {
+      var state = this.pc.connectionState;
+      this.connectionState = state;
+      var cb = this.opts.onStateChange;
+      if (cb) cb(state);
+      if (state === 'connected' && this._resolveConnect) {
+        this._resolveConnect();
+        this._resolveConnect = null;
+        this._rejectConnect = null;
+      }
+      if (state === 'failed' && this._rejectConnect) {
+        this._rejectConnect(new Error('WebRTC connection failed'));
+        this._resolveConnect = null;
+        this._rejectConnect = null;
+      }
+    }
+
+    // ── Private: DataChannel wiring ───────────────────────────────────────────
+  }, {
+    key: "_wireDataChannel",
+    value: function _wireDataChannel(dc) {
+      var _this3 = this;
+      dc.onopen = function () {
+        var cb = _this3.opts.onChannelOpen;
+        if (cb) cb(dc.label);
+
+        // Resolve connect() promise when the FIRST channel opens
+        if (_this3._resolveConnect) {
+          _this3._resolveConnect();
+          _this3._resolveConnect = null;
+          _this3._rejectConnect = null;
+        }
+      };
+      dc.onclose = function () {
+        var cb = _this3.opts.onChannelClose;
+        if (cb) cb(dc.label);
+      };
+      dc.onmessage = function (event) {
+        var cb = _this3.opts.onData;
+        if (cb) cb(dc.label, event.data);
+      };
+      dc.onerror = function (event) {
+        _this3._emitError(event.error || event);
+      };
+    }
+  }, {
+    key: "_emitError",
+    value: function _emitError(error) {
+      var cb = this.opts.onError;
+      if (cb) cb(error);
+    }
+  }]);
+}();
+var _default = exports["default"] = GameWebRTC;