iosignal 9.12.0 → 9.14.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -9,14 +9,18 @@ import require$$7 from 'url';
9
9
  import require$$0 from 'zlib';
10
10
  import require$$0$1 from 'buffer';
11
11
  import require$$2 from 'util';
12
- import { performance } from 'node:perf_hooks';
12
+ import { performance, monitorEventLoopDelay } from 'node:perf_hooks';
13
13
  import { isIPv6 as isIPv6$1, isIPv4 as isIPv4$1, isIP } from 'node:net';
14
14
  import { networkInterfaces } from 'os';
15
- import fs, { readFileSync } from 'fs';
15
+ import fs, { readFileSync as readFileSync$1 } from 'fs';
16
16
  import { memoryUsage } from 'process';
17
+ import { readFile } from 'node:fs/promises';
18
+ import { timingSafeEqual, createHash } from 'node:crypto';
19
+ import { readFileSync } from 'node:fs';
20
+ import { totalmem } from 'node:os';
17
21
  import path from 'path';
18
22
 
19
- var version$1 = "9.12.0";
23
+ var version$1 = "9.14.0";
20
24
  var pkg = {
21
25
  version: version$1};
22
26
 
@@ -594,12 +598,12 @@ const STATUS$1 = {
594
598
  ERROR: 255
595
599
  };
596
600
 
597
- const encoder$2 = new TextEncoder();
601
+ const encoder$3 = new TextEncoder();
598
602
 
599
603
 
600
604
  function getSignalPack(tag, ...args) {
601
605
  if (typeof tag !== 'string') throw TypeError('tag should be string.')
602
- let tagEncoded = encoder$2.encode(tag);
606
+ let tagEncoded = encoder$3.encode(tag);
603
607
  if (tagEncoded.byteLength > SIZE_LIMIT.TAG_LEN1) throw TypeError('tag UTF-8 byte length exceeds 255')
604
608
  let payload = parsePayload(args);
605
609
 
@@ -641,7 +645,7 @@ function parsePayload(args) {
641
645
  } else if (args.length == 1) {
642
646
  if (typeof args[0] === 'string' || typeof args[0] === 'number') {
643
647
  type = PAYLOAD_TYPE.TEXT;
644
- pack = encoder$2.encode(args[0] + "."); // add null byte area.
648
+ pack = encoder$3.encode(args[0] + "."); // add null byte area.
645
649
  pack[pack.byteLength - 1] = 0; // set byte-zero : '\0' in C/C++
646
650
 
647
651
  } else if (ArrayBuffer.isView(args[0]) || args[0] instanceof ArrayBuffer) {
@@ -649,7 +653,7 @@ function parsePayload(args) {
649
653
  pack = $$1.B8(args[0]);
650
654
  } else if (typeof args[0] === 'object') {
651
655
  type = PAYLOAD_TYPE.OBJECT;
652
- pack = encoder$2.encode(JSON.stringify(args[0]));
656
+ pack = encoder$3.encode(JSON.stringify(args[0]));
653
657
  } else {
654
658
  throw new Error('unknown payload arguments')
655
659
  }
@@ -663,7 +667,7 @@ function parsePayload(args) {
663
667
  type = PAYLOAD_TYPE.MBA;
664
668
  } else {
665
669
  type = PAYLOAD_TYPE.MJSON;
666
- pack = encoder$2.encode(JSON.stringify(args));
670
+ pack = encoder$3.encode(JSON.stringify(args));
667
671
  }
668
672
 
669
673
  }
@@ -675,6 +679,42 @@ function getPayloadFromSignalPack(signalPack) {
675
679
  let tagLen = signalPack.readUint8(1);
676
680
  return signalPack.subarray(3 + tagLen)
677
681
  }
682
+ const decoder$5 = new TextDecoder();
683
+
684
+ /**
685
+ * Arguments of a SIGNAL payload, as IO emits them after the tag: EMPTY [], TEXT [string] (the
686
+ * trailing NUL that C/C++ senders add is removed), BINARY [the buffer itself], OBJECT [value],
687
+ * MJSON [...values], MBA [...args]. null for an unknown payload type. Throws on malformed JSON/MBA.
688
+ * @param {number} payloadType
689
+ * @param {Uint8Array} payloadBuffer
690
+ * @returns {any[] | null}
691
+ */
692
+ function decodeSignalArgs(payloadType, payloadBuffer) {
693
+ switch (payloadType) {
694
+ case PAYLOAD_TYPE.EMPTY:
695
+ return []
696
+ case PAYLOAD_TYPE.TEXT: {
697
+ const end = payloadBuffer[payloadBuffer.byteLength - 1] === 0 ? payloadBuffer.byteLength - 1 : payloadBuffer.byteLength;
698
+ return [decoder$5.decode(payloadBuffer.subarray(0, end))]
699
+ }
700
+ case PAYLOAD_TYPE.BINARY:
701
+ return [payloadBuffer]
702
+ case PAYLOAD_TYPE.OBJECT:
703
+ return [JSON.parse(decoder$5.decode(payloadBuffer))]
704
+ case PAYLOAD_TYPE.MJSON: {
705
+ const values = JSON.parse(decoder$5.decode(payloadBuffer));
706
+ if (!Array.isArray(values)) throw new TypeError('MJSON payload is not an array')
707
+ return values
708
+ }
709
+ case PAYLOAD_TYPE.MBA: {
710
+ const mba = $$1.unpack(payloadBuffer);
711
+ if (!mba) throw new TypeError('malformed MBA payload')
712
+ return mba.args
713
+ }
714
+ default:
715
+ return null
716
+ }
717
+ }
678
718
 
679
719
  const t=new Uint32Array([1116352408,1899447441,3049323471,3921009573,961987163,1508970993,2453635748,2870763221,3624381080,310598401,607225278,1426881987,1925078388,2162078206,2614888103,3248222580,3835390401,4022224774,264347078,604807628,770255983,1249150122,1555081692,1996064986,2554220882,2821834349,2952996808,3210313671,3336571891,3584528711,113926993,338241895,666307205,773529912,1294757372,1396182291,1695183700,1986661051,2177026350,2456956037,2730485921,2820302411,3259730800,3345764771,3516065817,3600352804,4094571909,275423344,430227734,506948616,659060556,883997877,958139571,1322822218,1537002063,1747873779,1955562222,2024104815,2227730452,2361852424,2428436474,2756734187,3204031479,3329325298]);function e(e,r,n,i,o){let f,s,u,h,a,c,l,p,y,g,d,b,w;for(;o>=64;){for(f=r[0],s=r[1],u=r[2],h=r[3],a=r[4],c=r[5],l=r[6],p=r[7],g=0;g<16;g++)d=i+4*g,e[g]=(255&n[d])<<24|(255&n[d+1])<<16|(255&n[d+2])<<8|255&n[d+3];for(g=16;g<64;g++)y=e[g-2],b=(y>>>17|y<<15)^(y>>>19|y<<13)^y>>>10,y=e[g-15],w=(y>>>7|y<<25)^(y>>>18|y<<14)^y>>>3,e[g]=(b+e[g-7]|0)+(w+e[g-16]|0);for(g=0;g<64;g++)b=(((a>>>6|a<<26)^(a>>>11|a<<21)^(a>>>25|a<<7))+(a&c^~a&l)|0)+(p+(t[g]+e[g]|0)|0)|0,w=((f>>>2|f<<30)^(f>>>13|f<<19)^(f>>>22|f<<10))+(f&s^f&u^s&u)|0,p=l,l=c,c=a,a=h+b|0,h=u,u=s,s=f,f=b+w|0;r[0]+=f,r[1]+=s,r[2]+=u,r[3]+=h,r[4]+=a,r[5]+=c,r[6]+=l,r[7]+=p,i+=64,o-=64;}return i}const r=function(){function t(){this.digestLength=32,this.blockSize=64,this.state=new Int32Array(8),this.temp=new Int32Array(64),this.buffer=new Uint8Array(128),this.bufferLength=0,this.bytesHashed=0,this.finished=false,this.reset();}return t.prototype.reset=function(){return this.state[0]=1779033703,this.state[1]=3144134277,this.state[2]=1013904242,this.state[3]=2773480762,this.state[4]=1359893119,this.state[5]=2600822924,this.state[6]=528734635,this.state[7]=1541459225,this.bufferLength=0,this.bytesHashed=0,this.finished=false,this},t.prototype.clean=function(){for(var t=0;t<this.buffer.length;t++)this.buffer[t]=0;for(t=0;t<this.temp.length;t++)this.temp[t]=0;this.reset();},t.prototype.update=function(t,r){if(void 0===r&&(r=t.length),this.finished)throw new Error("SHA256: can't update because hash was finished.");let n=0;if(this.bytesHashed+=r,this.bufferLength>0){for(;this.bufferLength<64&&r>0;)this.buffer[this.bufferLength++]=t[n++],r--;64===this.bufferLength&&(e(this.temp,this.state,this.buffer,0,64),this.bufferLength=0);}for(r>=64&&(n=e(this.temp,this.state,t,n,r),r%=64);r>0;)this.buffer[this.bufferLength++]=t[n++],r--;return this},t.prototype.finish=function(t){if(!this.finished){const t=this.bytesHashed,n=this.bufferLength,i=t/536870912|0,o=t<<3,f=t%64<56?64:128;this.buffer[n]=128;for(var r=n+1;r<f-8;r++)this.buffer[r]=0;this.buffer[f-8]=i>>>24&255,this.buffer[f-7]=i>>>16&255,this.buffer[f-6]=i>>>8&255,this.buffer[f-5]=i>>>0&255,this.buffer[f-4]=o>>>24&255,this.buffer[f-3]=o>>>16&255,this.buffer[f-2]=o>>>8&255,this.buffer[f-1]=o>>>0&255,e(this.temp,this.state,this.buffer,0,f),this.finished=true;}for(r=0;r<8;r++)t[4*r+0]=this.state[r]>>>24&255,t[4*r+1]=this.state[r]>>>16&255,t[4*r+2]=this.state[r]>>>8&255,t[4*r+3]=this.state[r]>>>0&255;return this},t.prototype.digest=function(){const t=new Uint8Array(this.digestLength);return this.finish(t),t},t.prototype._saveState=function(t){for(let e=0;e<this.state.length;e++)t[e]=this.state[e];},t.prototype._restoreState=function(t,e){for(let e=0;e<this.state.length;e++)this.state[e]=t[e];this.bytesHashed=e,this.finished=false,this.bufferLength=0;},t}(),n=function(){function t(t){this.inner=new r,this.outer=new r,this.blockSize=this.inner.blockSize,this.digestLength=this.inner.digestLength;const e=new Uint8Array(this.blockSize);if(t.length>this.blockSize)(new r).update(t).finish(e).clean();else for(var n=0;n<t.length;n++)e[n]=t[n];for(n=0;n<e.length;n++)e[n]^=54;this.inner.update(e);for(n=0;n<e.length;n++)e[n]^=106;this.outer.update(e),this.istate=new Uint32Array(8),this.ostate=new Uint32Array(8),this.inner._saveState(this.istate),this.outer._saveState(this.ostate);for(n=0;n<e.length;n++)e[n]=0;}return t.prototype.reset=function(){return this.inner._restoreState(this.istate,this.inner.blockSize),this.outer._restoreState(this.ostate,this.outer.blockSize),this},t.prototype.clean=function(){for(let t=0;t<this.istate.length;t++)this.ostate[t]=this.istate[t]=0;this.inner.clean(),this.outer.clean();},t.prototype.update=function(t){return this.inner.update(t),this},t.prototype.finish=function(t){return this.outer.finished?this.outer.finish(t):(this.inner.finish(t),this.outer.update(t,this.digestLength).finish(t)),this},t.prototype.digest=function(){const t=new Uint8Array(this.digestLength);return this.finish(t),t},t}();function i(t){const e=(new r).update(t),n=e.digest();return e.clean(),n}var o,f,s,u={},h={},a={};
680
720
  /*! ieee754. BSD-3-Clause License. Feross Aboukhadijeh <https://feross.org/opensource> */function c(){return f||(f=1,a.read=function(t,e,r,n,i){var o,f,s=8*i-n-1,u=(1<<s)-1,h=u>>1,a=-7,c=r?i-1:0,l=r?-1:1,p=t[e+c];for(c+=l,o=p&(1<<-a)-1,p>>=-a,a+=s;a>0;o=256*o+t[e+c],c+=l,a-=8);for(f=o&(1<<-a)-1,o>>=-a,a+=n;a>0;f=256*f+t[e+c],c+=l,a-=8);if(0===o)o=1-h;else {if(o===u)return f?NaN:1/0*(p?-1:1);f+=Math.pow(2,n),o-=h;}return (p?-1:1)*f*Math.pow(2,o-n)},a.write=function(t,e,r,n,i,o){var f,s,u,h=8*o-i-1,a=(1<<h)-1,c=a>>1,l=23===i?Math.pow(2,-24)-Math.pow(2,-77):0,p=n?0:o-1,y=n?1:-1,g=e<0||0===e&&1/e<0?1:0;for(e=Math.abs(e),isNaN(e)||e===1/0?(s=isNaN(e)?1:0,f=a):(f=Math.floor(Math.log(e)/Math.LN2),e*(u=Math.pow(2,-f))<1&&(f--,u*=2),(e+=f+c>=1?l/u:l*Math.pow(2,1-c))*u>=2&&(f++,u/=2),f+c>=a?(s=0,f=a):f+c>=1?(s=(e*u-1)*Math.pow(2,i),f+=c):(s=e*Math.pow(2,c-1)*Math.pow(2,i),f=0));i>=8;t[r+p]=255&s,p+=y,s/=256,i-=8);for(f=f<<i|s,h+=i;h>0;t[r+p]=255&f,p+=y,f/=256,h-=8);t[r+p-y]|=128*g;}),a}
@@ -703,13 +743,13 @@ const t=new Uint32Array([1116352408,1899447441,3049323471,3921009573,961987163,1
703
743
  */
704
744
 
705
745
  const Buffer$1 = $$1.Buffer;
706
- const encoder$1 = new TextEncoder();
746
+ const encoder$2 = new TextEncoder();
707
747
  const decoder$4 = new TextDecoder();
708
748
 
709
749
  // Wire tag lengths use one byte, regardless of JavaScript string length.
710
750
  function encodeTag(tag, allowEmpty = true) {
711
751
  if (typeof tag !== 'string') throw TypeError('tag should be string.')
712
- const encoded = encoder$1.encode(tag);
752
+ const encoded = encoder$2.encode(tag);
713
753
  if ((!allowEmpty && encoded.byteLength === 0) || encoded.byteLength > SIZE_LIMIT.TAG_LEN1) {
714
754
  throw TypeError('tag UTF-8 byte length must be ' + (allowEmpty ? '0' : '1') + '~255')
715
755
  }
@@ -1289,83 +1329,15 @@ class IOCore extends EventEmitter {
1289
1329
  > cid_sub message: tag includes cid and @ both : 'cid@*'
1290
1330
  > ch_sub message: else.
1291
1331
  */
1292
- // console.log('payloadType', payloadType )
1293
- switch (payloadType) {
1294
-
1295
- case PAYLOAD_TYPE.EMPTY:
1296
- if (tag.indexOf('@') === 0) {
1297
- this.emit('@', tag);
1298
- if (tag !== '@') this.emit(tag, tag);
1299
- } else {
1300
- this.emit(tag, tag);
1301
- this.emit('message', tag);
1302
- }
1303
- break;
1304
-
1305
- case PAYLOAD_TYPE.TEXT:
1306
- // !! Must remove null char before decode in JS.
1307
- // string payload contains null char for the c/cpp devices.
1308
- let payloadStringWithoutNull = payloadBuffer;
1309
- if (payloadBuffer[payloadBuffer.byteLength - 1] === 0) {
1310
- payloadStringWithoutNull = payloadBuffer.subarray(0, payloadBuffer.byteLength - 1);
1311
- }
1312
- let oneString = decoder$4.decode(payloadStringWithoutNull);
1313
- if (tag.indexOf('@') === 0) {
1314
- this.emit('@', tag, oneString);
1315
- if (tag !== '@') this.emit(tag, tag, oneString);
1316
- } else {
1317
- this.emit(tag, tag, oneString);
1318
- this.emit('message', tag, oneString);
1319
- }
1320
- break;
1321
-
1322
- case PAYLOAD_TYPE.BINARY:
1323
- if (tag.indexOf('@') === 0) {
1324
- this.emit('@', tag, payloadBuffer);
1325
- if (tag !== '@') this.emit(tag, tag, payloadBuffer);
1326
- } else {
1327
- this.emit(tag, tag, payloadBuffer);
1328
- this.emit('message', tag, payloadBuffer);
1329
- }
1330
- break;
1331
-
1332
- case PAYLOAD_TYPE.OBJECT:
1333
- let oneObjectBuffer = decoder$4.decode(payloadBuffer);
1334
- let oneJSONObject = JSON.parse(oneObjectBuffer);
1335
- if (tag.indexOf('@') === 0) {
1336
- this.emit('@', tag, oneJSONObject);
1337
- if (tag !== '@') this.emit(tag, tag, oneJSONObject);
1338
- } else {
1339
- this.emit(tag, tag, oneJSONObject);
1340
- this.emit('message', tag, oneJSONObject);
1341
- }
1342
- break;
1343
-
1344
- case PAYLOAD_TYPE.MJSON:
1345
- let mjsonBuffer = decoder$4.decode(payloadBuffer);
1346
- let mjson = JSON.parse(mjsonBuffer);
1347
- if (tag.indexOf('@') === 0) {
1348
- this.emit('@', tag, ...mjson);
1349
- if (tag !== '@') this.emit(tag, tag, ...mjson);
1350
- } else {
1351
- this.emit(tag, tag, ...mjson);
1352
- this.emit('message', tag, ...mjson);
1353
- }
1354
- break;
1355
-
1356
- case PAYLOAD_TYPE.MBA:
1357
- let mbaObject = $$1.unpack(payloadBuffer);
1358
- if (tag.indexOf('@') === 0) {
1359
- this.emit('@', tag, ...mbaObject.args);
1360
- if (tag !== '@') this.emit(tag, tag, ...mbaObject.args);
1361
- } else {
1362
- this.emit(tag, tag, ...mbaObject.args);
1363
- this.emit('message', tag, ...mbaObject.args);
1364
- }
1365
- break;
1366
-
1367
- default:
1368
- // console.log('## Unkown payloadtype', payloadType)
1332
+ const args = decodeSignalArgs(payloadType, payloadBuffer);
1333
+ if (args) {
1334
+ if (tag.indexOf('@') === 0) {
1335
+ this.emit('@', tag, ...args);
1336
+ if (tag !== '@') this.emit(tag, tag, ...args);
1337
+ } else {
1338
+ this.emit(tag, tag, ...args);
1339
+ this.emit('message', tag, ...args);
1340
+ }
1369
1341
  }
1370
1342
 
1371
1343
  } catch (err) {
@@ -8743,6 +8715,385 @@ function deliveryAllowed(target, sender) {
8743
8715
  return policy.defaultAllow
8744
8716
  }
8745
8717
 
8718
+ const encoder$1 = new TextEncoder();
8719
+ const NAME = /^[A-Za-z0-9_.-]{1,64}$/;
8720
+
8721
+ /**
8722
+ * Validates one tag pattern of a host. A trailing '*' makes it a prefix; '*' is allowed nowhere else.
8723
+ * Channel patterns (inbound, and own without '@'): global channel tags, so no '@' and no leading
8724
+ * '#' (home channels belong to one network) or '$'. Unicast patterns (own, leading '@'): the topic
8725
+ * of '<cid>@topic' messages.
8726
+ * @returns {{ pattern: string, text: string, prefix: boolean, unicast: boolean }}
8727
+ */
8728
+ function parsePattern(pattern, allowUnicast) {
8729
+ if (typeof pattern !== 'string' || pattern.length === 0) throw new TypeError('host tag must be a non-empty string')
8730
+ const prefix = pattern.endsWith('*');
8731
+ const text = prefix ? pattern.slice(0, -1) : pattern;
8732
+ if (text.includes('*')) throw new TypeError(`host tag ${pattern}: '*' is allowed only at the end`)
8733
+ if (text.includes(',')) throw new TypeError(`host tag ${pattern}: ',' separates tags`)
8734
+ if (encoder$1.encode(text).byteLength > SIZE_LIMIT.TAG_LEN1) throw new TypeError(`host tag ${pattern} exceeds 255 UTF-8 bytes`)
8735
+ const unicast = text.startsWith('@');
8736
+ if (unicast) {
8737
+ if (!allowUnicast) throw new TypeError(`host tag ${pattern}: inbound tags are channel tags (no '@')`)
8738
+ if (text.indexOf('@', 1) !== -1) throw new TypeError(`host tag ${pattern}: a unicast topic has one '@'`)
8739
+ if (text.length === 1) throw new TypeError(`host tag ${pattern}: empty topic`)
8740
+ } else {
8741
+ if (text.includes('@')) throw new TypeError(`host tag ${pattern}: channel tags have no '@'`)
8742
+ if (text.startsWith('#')) throw new TypeError(`host tag ${pattern}: home channel tags ('#...') cannot be hosted`)
8743
+ if (text.startsWith('$')) throw new TypeError(`host tag ${pattern}: '$' prefix is reserved`)
8744
+ if (text.length === 0) throw new TypeError(`host tag ${pattern}: empty tag`)
8745
+ }
8746
+ return { pattern, text, prefix, unicast }
8747
+ }
8748
+
8749
+ function overlaps(a, b) {
8750
+ if (a.prefix && b.text.startsWith(a.text)) return true
8751
+ if (b.prefix && a.text.startsWith(b.text)) return true
8752
+ return a.text === b.text
8753
+ }
8754
+
8755
+ /**
8756
+ * The tags all hosts of one server have claimed. Patterns never overlap, so a tag matches at most one.
8757
+ */
8758
+ class HostTable {
8759
+ constructor() {
8760
+ this.exact = new Map(); // text -> entry
8761
+ this.prefixes = []; // entries
8762
+ this.hosts = new Map(); // name -> Host
8763
+ }
8764
+
8765
+ get size() {
8766
+ return this.hosts.size
8767
+ }
8768
+
8769
+ add(host, entries) {
8770
+ if (this.hosts.has(host.name)) throw new Error(`host ${host.name} already exists`)
8771
+ const all = [...this.exact.values(), ...this.prefixes];
8772
+ entries.forEach((entry, i) => {
8773
+ for (const other of [...all, ...entries.slice(0, i)]) {
8774
+ if (overlaps(entry, other)) {
8775
+ throw new Error(`host tag ${entry.pattern} overlaps ${other.pattern}` +
8776
+ (other.host === host ? '' : ` of host ${other.host.name}`))
8777
+ }
8778
+ }
8779
+ });
8780
+ for (const entry of entries) {
8781
+ if (entry.prefix) this.prefixes.push(entry);
8782
+ else this.exact.set(entry.text, entry);
8783
+ }
8784
+ this.hosts.set(host.name, host);
8785
+ }
8786
+
8787
+ remove(host) {
8788
+ if (this.hosts.get(host.name) !== host) return
8789
+ this.hosts.delete(host.name);
8790
+ for (const [text, entry] of this.exact) if (entry.host === host) this.exact.delete(text);
8791
+ this.prefixes = this.prefixes.filter(entry => entry.host !== host);
8792
+ }
8793
+
8794
+ // tag: a client channel tag, or '@topic' of a unicast. Returns the entry or undefined.
8795
+ match(tag) {
8796
+ const entry = this.exact.get(tag);
8797
+ if (entry) return entry
8798
+ for (const p of this.prefixes) if (tag.startsWith(p.text)) return p
8799
+ return undefined
8800
+ }
8801
+
8802
+ // A connection closed. ownsCid: it still owned its CID (no newer connection took it over).
8803
+ remoteClosed(remote, ownsCid) {
8804
+ if (!ownsCid || !remote.cid) return
8805
+ for (const host of this.hosts.values()) host._remoteClosed(remote);
8806
+ }
8807
+ }
8808
+
8809
+ /**
8810
+ * Game logic (or any server-side logic) inside the server process. Created by server.host().
8811
+ *
8812
+ * Events:
8813
+ * 'message' (from, tag, ...args) a client signal to one of the inbound tags. from is the
8814
+ * server's view of the sender (never anything in the payload).
8815
+ * 'leave' (from, reason) a participant's connection closed (it no longer has its CID)
8816
+ * 'error' (error) a 'message' or 'leave' handler threw
8817
+ * 'close' () the host was closed
8818
+ */
8819
+ class Host extends require$$0$3 {
8820
+
8821
+ constructor(manager, name, options = {}) {
8822
+ super();
8823
+ if (typeof name !== 'string' || !NAME.test(name)) {
8824
+ throw new TypeError('host name: 1-64 characters of A-Z a-z 0-9 _ . -')
8825
+ }
8826
+ if (options === null || typeof options !== 'object') throw new TypeError('host options must be an object')
8827
+ for (const key of Object.keys(options)) {
8828
+ if (!['inbound', 'own', 'fanout', 'retain'].includes(key)) throw new TypeError(`unknown host option: ${key}`)
8829
+ }
8830
+ const list = (key) => {
8831
+ const value = options[key] ?? [];
8832
+ if (!Array.isArray(value)) throw new TypeError(`host option ${key} must be an array of tags`)
8833
+ return value
8834
+ };
8835
+ /** @type {Host} */
8836
+ const host = this;
8837
+ const inbound = list('inbound').map(p => ({ ...parsePattern(p, false), kind: 'inbound', host }));
8838
+ const own = list('own').map(p => ({ ...parsePattern(p, true), kind: 'own', host }));
8839
+ if (inbound.length === 0) throw new TypeError('host needs at least one inbound tag')
8840
+
8841
+ const fanout = options.fanout ?? null;
8842
+ if (fanout !== null && !(Number.isSafeInteger(fanout) && fanout > 0)) {
8843
+ throw new RangeError('host fanout must be null or a positive integer')
8844
+ }
8845
+ const retain = options.retain ?? {};
8846
+ for (const key of ['tags', 'bytes']) {
8847
+ if (retain[key] !== undefined && !(Number.isSafeInteger(retain[key]) && retain[key] > 0)) {
8848
+ throw new RangeError(`host retain.${key} must be a positive integer`)
8849
+ }
8850
+ }
8851
+
8852
+ this.name = name;
8853
+ this.manager = manager;
8854
+ this.fanout = fanout;
8855
+ this.retainTags = retain.tags ?? null; // null: the server's retain.tagsPerOwner
8856
+ this.retainBytes = retain.bytes ?? null; // null: the server's retain.bytesPerOwner
8857
+ this.retainOwnerKey = 'host:' + name;
8858
+ this.ownChannels = own.filter(e => !e.unicast);
8859
+ this.closed = false;
8860
+ /** @type {Map<string, Readonly<object>>} cid -> from, connections that sent to this host */
8861
+ this._participants = new Map();
8862
+ /** cid -> { inputs, firstAt, lastAt }: activity of each participant, for the dashboard */
8863
+ this._activity = new Map();
8864
+ // Cumulative since the host opened; readers compute rates from deltas (see Dashboard).
8865
+ this.counters = {
8866
+ inbound: 0, // inputs handed to 'message'
8867
+ rejected: 0, // inputs to an inbound tag that were not handed over (E2E, unreadable payload)
8868
+ denied: 0, // client messages to a tag this host owns, dropped
8869
+ published: 0, delivered: 0, // publish() calls and the connections they reached
8870
+ sent: 0, // to() messages sent
8871
+ joins: 0, leaves: 0, errors: 0,
8872
+ handlerMs: 0, // time spent in 'message' and 'leave' handlers
8873
+ };
8874
+ this.handlerMaxMs = 0;
8875
+ this.reported = {}; // last host.report() values
8876
+ this._journal = []; // recent notable events (join, leave, denied, error), oldest first
8877
+ this._journalSeq = 0;
8878
+ this._loops = new Set();
8879
+
8880
+ manager.hosts.add(this, [...inbound, ...own]);
8881
+ // Values a client retained on these tags before the host claimed them are not the host's.
8882
+ for (const tag of [...manager.retain_messages.keys()]) {
8883
+ if (!tag.startsWith(manager.CHANNEL_PREFIX)) continue
8884
+ const entry = manager.hosts.match(tag.slice(manager.CHANNEL_PREFIX.length));
8885
+ if (entry?.host === this) manager.dropChannelRetain(tag);
8886
+ }
8887
+ }
8888
+
8889
+ /** Connections that have sent to this host and are still online: cid -> from. */
8890
+ get participants() {
8891
+ return this._participants
8892
+ }
8893
+
8894
+ /** Stop tracking a participant; no 'leave' is emitted for it (until it sends again). */
8895
+ forget(cid) {
8896
+ this._activity.delete(cid);
8897
+ return this._participants.delete(cid)
8898
+ }
8899
+
8900
+ /**
8901
+ * Publish to one of the host's own channel tags. A tag with '$' is also retained, owned by the
8902
+ * host. Returns the number of connections it was delivered to.
8903
+ */
8904
+ publish(tag, ...args) {
8905
+ this._open();
8906
+ if (typeof tag !== 'string') throw new TypeError('tag should be string.')
8907
+ const entry = this.manager.hosts.match(tag);
8908
+ if (tag.startsWith('@') || entry?.host !== this || entry.kind !== 'own') {
8909
+ throw new Error(`host ${this.name} does not own channel tag ${tag}`)
8910
+ }
8911
+ const message = getSignalPack(tag, ...args);
8912
+ const n = this.manager.hostPublish(this, this.manager.CHANNEL_PREFIX + tag, message);
8913
+ this.counters.published++;
8914
+ this.counters.delivered += n;
8915
+ return n
8916
+ }
8917
+
8918
+ /**
8919
+ * Send to one connection. It receives '@' + topic. Returns false when the CID is not online
8920
+ * or its receive buffer is too small for the message.
8921
+ */
8922
+ to(cid, topic, ...args) {
8923
+ this._open();
8924
+ if (typeof topic !== 'string' || topic.length === 0 || topic.includes('@')) {
8925
+ throw new TypeError('topic must be a non-empty string without @')
8926
+ }
8927
+ const remote = this.manager.cid2remote.get(cid);
8928
+ const message = getSignalPack('@' + topic, ...args);
8929
+ if (!remote || remote._closing) return false
8930
+ const skipped = remote.peerRxLimitSkipped;
8931
+ remote.send_enc_mode(message);
8932
+ if (remote.peerRxLimitSkipped !== skipped) return false
8933
+ this.counters.sent++;
8934
+ return true
8935
+ }
8936
+
8937
+ /**
8938
+ * Values to show on the server dashboard ("game" panel), e.g. { round: 3, players: 8 }.
8939
+ * Merged into the last report; a key set to null is removed. Numbers, short strings and booleans,
8940
+ * at most 20 keys.
8941
+ */
8942
+ report(values) {
8943
+ if (values === null || typeof values !== 'object') throw new TypeError('report() takes an object')
8944
+ for (const [key, value] of Object.entries(values)) {
8945
+ if (value === null || value === undefined) { delete this.reported[key]; continue }
8946
+ if (!['number', 'string', 'boolean'].includes(typeof value)) throw new TypeError(`report value ${key} must be a number, string or boolean`)
8947
+ if (!(key in this.reported) && Object.keys(this.reported).length >= 20) continue
8948
+ this.reported[String(key).slice(0, 32)] = typeof value === 'string' ? value.slice(0, 64) : value;
8949
+ }
8950
+ return this
8951
+ }
8952
+
8953
+ /**
8954
+ * Run fn(now) every intervalMs, like setInterval, and measure it for the dashboard: the gap between
8955
+ * ticks and how long each tick took. A throwing tick is reported as an 'error' and the loop goes on.
8956
+ * Returns a stop function; close() stops every loop.
8957
+ */
8958
+ loop(intervalMs, fn) {
8959
+ this._open();
8960
+ if (!(Number.isFinite(intervalMs) && intervalMs >= 1)) throw new RangeError('loop interval must be at least 1 ms')
8961
+ if (typeof fn !== 'function') throw new TypeError('loop needs a function')
8962
+ const stats = { intervalMs, ticks: 0, gaps: [], steps: [], last: 0 };
8963
+ const timer = setInterval(() => {
8964
+ const t0 = performance.now();
8965
+ if (stats.last) { stats.gaps.push(t0 - stats.last); if (stats.gaps.length > 200) stats.gaps.shift(); }
8966
+ stats.last = t0;
8967
+ try { fn(Date.now()); } catch (error) { this._failed(error); }
8968
+ stats.steps.push(performance.now() - t0); if (stats.steps.length > 200) stats.steps.shift();
8969
+ stats.ticks++;
8970
+ }, intervalMs);
8971
+ const entry = { timer, stats };
8972
+ this._loops.add(entry);
8973
+ return () => { clearInterval(timer); this._loops.delete(entry); }
8974
+ }
8975
+
8976
+ /** Timing of the loops started with loop(): target, ticks, gap p50/p99 and step average/max (ms). */
8977
+ loopStats() {
8978
+ const pct = (a, p) => { if (!a.length) return 0; const s = [...a].sort((x, y) => x - y); return s[Math.min(s.length - 1, Math.floor(p / 100 * s.length))] };
8979
+ return [...this._loops].map(({ stats: s }) => ({
8980
+ intervalMs: s.intervalMs, ticks: s.ticks,
8981
+ gapP50: pct(s.gaps, 50), gapP99: pct(s.gaps, 99), gapMax: s.gaps.length ? Math.max(...s.gaps) : 0,
8982
+ stepAvg: s.steps.length ? s.steps.reduce((a, b) => a + b, 0) / s.steps.length : 0,
8983
+ stepMax: s.steps.length ? Math.max(...s.steps) : 0,
8984
+ }))
8985
+ }
8986
+
8987
+ /** Participants with their activity: [{ from, inputs, firstAt, lastAt }]. */
8988
+ activity() {
8989
+ return [...this._participants.values()].map((from) => ({ from, ...(this._activity.get(from.cid) ?? { inputs: 0, firstAt: 0, lastAt: 0 }) }))
8990
+ }
8991
+
8992
+ /** Notable events after sequence `after`: [{ seq, at, kind: 'join'|'leave'|'denied'|'error', ... }]. */
8993
+ journal(after = 0) {
8994
+ return this._journal.filter((e) => e.seq > after)
8995
+ }
8996
+
8997
+ _note(kind, data) {
8998
+ this._journal.push({ seq: ++this._journalSeq, at: Date.now(), kind, ...data });
8999
+ if (this._journal.length > 200) this._journal.shift();
9000
+ }
9001
+
9002
+ // A client sent to a tag this host owns (Manager.sender dropped it).
9003
+ _denied(remote, tag) {
9004
+ this.counters.denied++;
9005
+ this._note('denied', { cid: remote.cid, tag });
9006
+ }
9007
+
9008
+ _failed(error) {
9009
+ this.counters.errors++;
9010
+ this._note('error', { message: String(error?.message ?? error).slice(0, 200) });
9011
+ if (this.listenerCount('error')) this.emit('error', error);
9012
+ else console.error(`host ${this.name} error:`, error);
9013
+ }
9014
+
9015
+ /** Release the tags (they become ordinary channels again) and the host's retained values. */
9016
+ close() {
9017
+ if (this.closed) return
9018
+ this.closed = true;
9019
+ for (const { timer } of this._loops) clearInterval(timer);
9020
+ this._loops.clear();
9021
+ this.manager.hosts.remove(this);
9022
+ const owner = this.manager.retainOwners.get(this.retainOwnerKey);
9023
+ if (owner) for (const tag of [...owner.tags]) this.manager.dropChannelRetain(tag);
9024
+ this._participants.clear();
9025
+ this._activity.clear();
9026
+ this.emit('close');
9027
+ }
9028
+
9029
+ _open() {
9030
+ if (this.closed) throw new Error(`host ${this.name} is closed`)
9031
+ }
9032
+
9033
+ // The server's view of a sender; reused while nothing in it changes.
9034
+ static from(remote) {
9035
+ const authorized = remote.boho?.isAuthorized === true;
9036
+ const f = remote._hostFrom;
9037
+ if (f && f.cid === remote.cid && f.uid === remote.uid && f.role === remote.role &&
9038
+ f.nick === remote.nick && f.authorized === authorized) return f
9039
+ return remote._hostFrom = Object.freeze({
9040
+ cid: remote.cid, uid: remote.uid || null, role: remote.role, authorized,
9041
+ nick: remote.nick || '', ssid: remote.ssid
9042
+ })
9043
+ }
9044
+
9045
+ // A SIGNAL from a client to one of the inbound tags. Returns false if it was not delivered.
9046
+ _receive(remote, tag, message) {
9047
+ if (message[0] !== IOMsg.SIGNAL || !remote.cid) return false
9048
+ const tagLen = message[1];
9049
+ if (message.byteLength < tagLen + 3) return false
9050
+ let args;
9051
+ try {
9052
+ args = decodeSignalArgs(message[2 + tagLen], message.subarray(3 + tagLen));
9053
+ } catch {
9054
+ return false
9055
+ }
9056
+ if (!args) return false
9057
+ const from = Host.from(remote);
9058
+ const now = Date.now();
9059
+ let act = this._activity.get(from.cid);
9060
+ if (!act) {
9061
+ act = { inputs: 0, firstAt: now, lastAt: now };
9062
+ this._activity.set(from.cid, act);
9063
+ this.counters.joins++;
9064
+ this._note('join', { cid: from.cid, nick: from.nick, authorized: from.authorized });
9065
+ }
9066
+ act.inputs++;
9067
+ act.lastAt = now;
9068
+ this._participants.set(from.cid, from);
9069
+ this.counters.inbound++;
9070
+ this._emitSafely('message', from, tag, ...args);
9071
+ return true
9072
+ }
9073
+
9074
+ _remoteClosed(remote) {
9075
+ const from = this._participants.get(remote.cid);
9076
+ if (!from) return
9077
+ this._participants.delete(remote.cid);
9078
+ this._activity.delete(remote.cid);
9079
+ this.counters.leaves++;
9080
+ this._note('leave', { cid: remote.cid, reason: remote.closeReason ?? 'close' });
9081
+ this._emitSafely('leave', Host.from(remote), remote.closeReason ?? 'close');
9082
+ }
9083
+
9084
+ _emitSafely(name, ...args) {
9085
+ const t0 = performance.now();
9086
+ try {
9087
+ this.emit(name, ...args);
9088
+ } catch (error) {
9089
+ this._failed(error);
9090
+ }
9091
+ const ms = performance.now() - t0;
9092
+ this.counters.handlerMs += ms;
9093
+ if (ms > this.handlerMaxMs) this.handlerMaxMs = ms;
9094
+ }
9095
+ }
9096
+
8746
9097
  // Characters of an anonymous CID after its '?': lowercase Crockford base32, easy to read aloud and type.
8747
9098
  const ANONYMOUS_CID_ALPHABET = '0123456789abcdefghjkmnpqrstvwxyz';
8748
9099
 
@@ -8764,7 +9115,10 @@ class Manager {
8764
9115
  this.counters = { rxMessages: 0, rxBytes: 0, txMessages: 0, txBytes: 0,
8765
9116
  publishes: 0, deliveryAttempts: 0, quotaExcluded: 0, oversizeRejected: 0, rateLimited: 0,
8766
9117
  peerRxLimitSkipped: 0, // messages not sent: larger than the peer's advertised RX buffer
8767
- policyDenied: 0 }; // unicasts and CID publications a device's delivery policy kept back
9118
+ policyDenied: 0, // unicasts and CID publications a device's delivery policy kept back
9119
+ hostInbound: 0, // client signals handed to a host (server.host)
9120
+ hostRejected: 0, // signals to a host tag that were not handed over (E2E, malformed payload)
9121
+ hostDenied: 0 }; // client signals to a tag a host owns, dropped
8768
9122
 
8769
9123
  this.authManager = authManager;
8770
9124
 
@@ -8789,6 +9143,7 @@ class Manager {
8789
9143
  this.retainExpiry = new Map(); // key: channel retain tag in a grace pool -> expiry time
8790
9144
  this.retainBytes = 0; // all retained messages, channel and CID
8791
9145
  this.channel_map = new Map(); // key: channelName -> value: < remote : Set >
9146
+ this.hosts = new HostTable(); // tags claimed by server.host() hosts
8792
9147
  this.CHANNEL_PREFIX = 'CH:';
8793
9148
  this.CID_PREFIX = 'CID:';
8794
9149
  this.metrics = new Metrics(this);
@@ -8934,10 +9289,12 @@ class Manager {
8934
9289
  if (this.connectionLogger) this.connectionLogger.log(remoteInfo);
8935
9290
  // A replaced duplicate login no longer owns its CID; the new connection is still online.
8936
9291
  const cidOwner = this.cid2remote.get(remote.cid);
8937
- if (!remote.cid || !cidOwner || cidOwner === remote) {
9292
+ const ownsCid = !remote.cid || !cidOwner || cidOwner === remote;
9293
+ if (ownsCid) {
8938
9294
  this.deligateSignal(remote, '@state', 'close');
8939
9295
  this.deligateSignal(remote, '@$state', 'close');
8940
9296
  }
9297
+ if (this.hosts.size) this.hosts.remoteClosed(remote, ownsCid);
8941
9298
 
8942
9299
  // remove subscriber
8943
9300
  for (let ch of remote.channels.keys()) {
@@ -9060,6 +9417,28 @@ class Manager {
9060
9417
  if (tag.indexOf('$') == 0) return ['err', 'prefix $ is reserved for userSet tag.']
9061
9418
 
9062
9419
  let cidIndex = tag.indexOf('@');
9420
+
9421
+ // Hosts (server.host): a signal to an inbound tag goes to the host only, with its sender; a
9422
+ // client may not send to a tag a host owns. CID publications ('@topic') name their sender and
9423
+ // are never hosted.
9424
+ if (this.hosts.size && cidIndex !== 0) {
9425
+ const entry = this.hosts.match(cidIndex > 0 ? tag.slice(cidIndex) : tag);
9426
+ if (entry?.kind === 'inbound') {
9427
+ if (entry.host._receive(remote, tag, message)) {
9428
+ this.counters.hostInbound++;
9429
+ return ['ok', 1]
9430
+ }
9431
+ this.counters.hostRejected++;
9432
+ entry.host.counters.rejected++;
9433
+ return ['err', 'Not accepted by the host']
9434
+ }
9435
+ if (entry) {
9436
+ this.counters.hostDenied++;
9437
+ entry.host._denied(remote, tag);
9438
+ if (this.server?.listenerCount?.('host:denied')) this.server.emit('host:denied', remote, tag, entry.host.name);
9439
+ return ['err', 'Tag is reserved by a host']
9440
+ }
9441
+ }
9063
9442
  // A device whose policy also covers its publications: each subscriber is checked (see deliveryPolicy.js).
9064
9443
  const publisher = cidIndex === 0 && remote.rxPolicy?.filterPublish ? remote : null;
9065
9444
  if (cidIndex === 0) {
@@ -9124,36 +9503,39 @@ class Manager {
9124
9503
  }
9125
9504
 
9126
9505
  this.counters.publishes++;
9506
+ const sent = this.deliver(tag, message, remote.quota.fanout, publisher);
9507
+ if (sent === null) return ['err', 'No subscriber.']
9508
+ return ['ok', sent]
9509
+ }
9510
+
9511
+ // Sends a SIGNAL to the subscribers of a full channel key ('CH:…', 'CID:…', home channel), at
9512
+ // most fanout (null: all). publisher: a device whose delivery policy filters its publications.
9513
+ // Returns the number sent, or null when the channel has no subscribers.
9514
+ deliver(tag, message, fanout, publisher = null) {
9515
+ const remotes = this.channel_map.get(tag);
9516
+ if (!remotes || remotes.size === 0) return null
9517
+ const limit = fanout === null ? remotes.size : Math.min(fanout, remotes.size);
9518
+ this.counters.quotaExcluded += remotes.size - limit;
9127
9519
  let sentCounter = 0;
9128
- if (this.channel_map.has(tag)) {
9129
- // console.log('raw channel_map matched tag:', tag)
9130
- let remotes = this.channel_map.get(tag);
9131
- if (remotes.size >= 1) {
9132
- const fanout = remote.quota.fanout;
9133
- const limit = fanout === null ? remotes.size : Math.min(fanout, remotes.size);
9134
- this.counters.quotaExcluded += remotes.size - limit;
9135
- let peers = remotes.values();
9136
- while (sentCounter < limit) {
9137
- let c = peers.next().value;
9138
- if (!c) {
9139
- // console.log('## null remote' )
9140
- break;
9141
- }
9142
- if (publisher && !deliveryAllowed(publisher, c)) {
9143
- this.deliveryDenied(publisher, c, 'publish');
9144
- continue
9145
- }
9146
- // change: from v4.x allow receiveSelfMessages.
9147
- c.send_enc_mode(message);
9148
- sentCounter++;
9149
- }
9150
-
9151
- this.counters.deliveryAttempts += sentCounter;
9152
- return ['ok', sentCounter]
9520
+ for (const c of remotes) {
9521
+ if (sentCounter >= limit) break;
9522
+ if (publisher && !deliveryAllowed(publisher, c)) {
9523
+ this.deliveryDenied(publisher, c, 'publish');
9524
+ continue
9153
9525
  }
9526
+ // change: from v4.x allow receiveSelfMessages.
9527
+ c.send_enc_mode(message);
9528
+ sentCounter++;
9154
9529
  }
9155
- // console.log('-- No subscriber. ch: ' , tag )
9156
- return ['err', 'No subscriber.']
9530
+ this.counters.deliveryAttempts += sentCounter;
9531
+ return sentCounter
9532
+ }
9533
+
9534
+ // A host's publication (Host.publish): full channel key, already packed.
9535
+ hostPublish(host, tag, message) {
9536
+ if (tag.includes('$') && this.retainOptions.enabled) this.storeChannelRetain(tag, message, null, host);
9537
+ this.counters.publishes++;
9538
+ return this.deliver(tag, message, host.fanout) ?? 0
9157
9539
  }
9158
9540
 
9159
9541
 
@@ -9201,14 +9583,18 @@ class Manager {
9201
9583
  return owner
9202
9584
  }
9203
9585
 
9204
- storeChannelRetain(tag, message, remote) {
9205
- const owner = this.retainOwner(remote.boho.isAuthorized ? 'cid:' + remote.cid : 'conn:' + remote.ssid);
9586
+ // host: a Host (server.host) writing its own tag, with its own budget; remote is then null.
9587
+ storeChannelRetain(tag, message, remote, host = null) {
9588
+ const owner = this.retainOwner(host ? host.retainOwnerKey
9589
+ : remote.boho.isAuthorized ? 'cid:' + remote.cid : 'conn:' + remote.ssid);
9590
+ const tagsPerOwner = host?.retainTags ?? this.retainOptions.tagsPerOwner;
9591
+ const bytesPerOwner = host?.retainBytes ?? this.retainOptions.bytesPerOwner;
9206
9592
  const old = this.retain_messages.get(tag);
9207
9593
  const freed = old?.byteLength ?? 0;
9208
9594
  const room = old || (this.retain_messages.size < this.retainOptions.limitCounter &&
9209
- owner.tags.size < this.retainOptions.tagsPerOwner);
9595
+ owner.tags.size < tagsPerOwner);
9210
9596
  const ownerBytes = owner.bytes - (this.retain_owner.get(tag) === owner ? freed : 0);
9211
- if (room && this.retainFits(message, freed, ownerBytes, this.retainOptions.bytesPerOwner)) {
9597
+ if (room && this.retainFits(message, freed, ownerBytes, bytesPerOwner)) {
9212
9598
  if (old) this.releaseChannelRetain(tag, freed);
9213
9599
  this.retain_messages.set(tag, this.retainCopy(message));
9214
9600
  owner.bytes += message.byteLength;
@@ -9423,12 +9809,81 @@ class Manager {
9423
9809
  }
9424
9810
  }
9425
9811
 
9426
- const STATUS = {
9427
- OK: 0,
9428
- //0~127: success
9429
- //128~255: fail
9430
- ERROR: 255
9431
- };
9812
+ // Live server telemetry, sampled once a second and shared by every reader (the dashboard, the
9813
+ // monitor service): CPU, event-loop delay and utilisation, memory, connections by transport and
9814
+ // state, send queues of slow peers, and per-second rates of the manager's counters.
9815
+ // `value` holds the latest sample. dispose() stops the timer.
9816
+ class ServerStats {
9817
+ // onSample(value): called after each sample (the dashboard keeps its history from it).
9818
+ constructor(server, { onSample = null } = {}) {
9819
+ this.server = server;
9820
+ this.onSample = onSample;
9821
+ // Traffic counters come from the manager's cumulative counters, counted since this service started.
9822
+ this.base = { ...server.manager.counters };
9823
+ this.counters = { opened: 0, closed: 0, authFailed: 0,
9824
+ ...Object.fromEntries(Object.keys(this.base).map(key => [key, 0])) };
9825
+ this.onState = (_peer, _previous) => {
9826
+ if (_peer.state === STATE.OPEN) this.counters.opened++;
9827
+ if (_peer.state === STATE.CLOSED) this.counters.closed++;
9828
+ if (_peer.state === STATE.AUTH_FAIL) this.counters.authFailed++;
9829
+ };
9830
+ server.on('remote:state', this.onState);
9831
+ this.delay = monitorEventLoopDelay({ resolution: 20 }); this.delay.enable();
9832
+ this.cpu = process.cpuUsage(); this.elu = performance.eventLoopUtilization();
9833
+ this.previousAt = performance.now(); this.previous = { ...this.counters };
9834
+ this.sample();
9835
+ this.timer = setInterval(() => this.sample(), 1000); this.timer.unref();
9836
+ }
9837
+ sample() {
9838
+ const now = performance.now(), elapsed = Math.max(1, now - this.previousAt);
9839
+ for (const key in this.base) this.counters[key] = this.server.manager.counters[key] - this.base[key];
9840
+ let authenticated = 0, websocket = 0, queuedBytes = 0, maxQueuedBytes = 0;
9841
+ let txQueuePeakBytes = 0, txWriteFalseCount = 0, txDrainMaxMs = 0;
9842
+ let txBlockedConnections = 0, txBlockedMaxMs = 0;
9843
+ const states = {};
9844
+ const transports = { websocket: { total: 0, authenticated: 0 }, tcp: { total: 0, authenticated: 0 } };
9845
+ for (const peer of this.server.manager.remotes) {
9846
+ const transport = transports[peer.socketType === 'websocket' ? 'websocket' : 'tcp']; transport.total++;
9847
+ if (peer.boho.isAuthorized) { authenticated++; transport.authenticated++; }
9848
+ if (peer.socketType === 'websocket') websocket++;
9849
+ const queued = peer.socket.bufferedAmount ?? peer.socket.writableLength ?? 0;
9850
+ queuedBytes += queued; maxQueuedBytes = Math.max(maxQueuedBytes, queued);
9851
+ txQueuePeakBytes = Math.max(txQueuePeakBytes, peer.txQueuePeakBytes ?? 0);
9852
+ txWriteFalseCount += peer.txWriteFalseCount ?? 0;
9853
+ txDrainMaxMs = Math.max(txDrainMaxMs, peer.txDrainMaxMs ?? 0);
9854
+ if (peer.txBlockedSince != null) {
9855
+ txBlockedConnections++;
9856
+ txBlockedMaxMs = Math.max(txBlockedMaxMs, now - peer.txBlockedSince);
9857
+ }
9858
+ const name = peer.getStateName(); states[name] = (states[name] || 0) + 1;
9859
+ }
9860
+ const rates = Object.fromEntries(Object.entries(this.counters).map(([key, value]) => [key, (value - this.previous[key]) * 1000 / elapsed]));
9861
+ const cpu = process.cpuUsage(), elu = performance.eventLoopUtilization();
9862
+ const delta = performance.eventLoopUtilization(elu, this.elu);
9863
+ const mem = process.memoryUsage(), total = this.server.manager.remotes.size;
9864
+ let hostAvailableBytes = null;
9865
+ if (process.platform === 'linux') {
9866
+ try { const match = readFileSync('/proc/meminfo', 'utf8').match(/^MemAvailable:\s+(\d+) kB/m); if (match) hostAvailableBytes = Number(match[1]) * 1024; }
9867
+ catch { /* Optional host telemetry must not interrupt service. */ }
9868
+ }
9869
+ this.value = { at: Date.now(), total, authenticated, anonymous: total - authenticated, websocket,
9870
+ transports, hostAvailableBytes, hostTotalBytes: totalmem(), channels: this.server.manager.channel_map.size, states, queuedBytes, maxQueuedBytes,
9871
+ txQueuePeakBytes, txWriteFalseCount, txDrainMaxMs, txBlockedConnections, txBlockedMaxMs,
9872
+ counters: { ...this.counters }, rates, rss: mem.rss, heapUsed: mem.heapUsed,
9873
+ cpuPercent: ((cpu.user - this.cpu.user) + (cpu.system - this.cpu.system)) / (elapsed * 10),
9874
+ eventLoopUtilization: delta.utilization,
9875
+ eventLoopP99Ms: this.delay.percentile(99) / 1e6,
9876
+ // anonymous: profile name of unauthenticated connections; profiles: the server's quotas now.
9877
+ quota: { anonymous: this.server.anonymousQuota, profiles: structuredClone(this.server.quotas) } };
9878
+ this.previousAt = now; this.previous = { ...this.counters }; this.cpu = cpu; this.elu = elu; this.delay.reset();
9879
+ if (this.onSample) {
9880
+ try { this.onSample(this.value); } catch (error) { console.error('server stats reader error:', error); }
9881
+ }
9882
+ }
9883
+ dispose() {
9884
+ clearInterval(this.timer); this.delay.disable(); this.server.off('remote:state', this.onState);
9885
+ }
9886
+ }
9432
9887
 
9433
9888
  const decoder = new TextDecoder();
9434
9889
  const DUPLICATE_LOGIN_POLICIES = ['keepOld', 'keepNew'];
@@ -9733,6 +10188,718 @@ class BohoAuth {
9733
10188
 
9734
10189
  }
9735
10190
 
10191
+ // The dashboard web page, kept as a string so it ships inside the package (no CDN, works offline).
10192
+ // No backticks or template placeholders inside: the page is plain HTML, CSS and ES5-ish JavaScript.
10193
+ const PAGE = String.raw`<!doctype html>
10194
+ <html lang="ko">
10195
+ <head>
10196
+ <meta charset="utf-8">
10197
+ <meta name="viewport" content="width=device-width, initial-scale=1">
10198
+ <title>IOSignal Dashboard</title>
10199
+ <style>
10200
+ :root {
10201
+ --bg: #f3f5fa; --panel: #ffffff; --ink: #172036; --muted: #5f6a85; --line: #dde3ef; --grid: #e9edf5;
10202
+ --a: #0ea5a0; --b: #4f6bed; --c: #f59e0b; --d: #e5484d; --e: #8b5cf6; --ok: #22b573;
10203
+ --mono: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
10204
+ --sans: system-ui, -apple-system, "Apple SD Gothic Neo", "Noto Sans KR", sans-serif;
10205
+ color-scheme: light;
10206
+ }
10207
+ @media (prefers-color-scheme: dark) {
10208
+ :root { --bg: #0d1220; --panel: #151c30; --ink: #e6ebf7; --muted: #8e99b8; --line: #263050; --grid: #1d2640;
10209
+ --a: #2dd4bf; --b: #7c93ff; --c: #fbbf24; --d: #ff6b6b; --e: #a78bfa; --ok: #34d399; color-scheme: dark; }
10210
+ }
10211
+ * { box-sizing: border-box; }
10212
+ body { margin: 0; background: var(--bg); color: var(--ink); font: 14px/1.5 var(--sans); }
10213
+ header { position: sticky; top: 0; z-index: 5; display: flex; flex-wrap: wrap; gap: 10px 16px; align-items: center;
10214
+ padding: 10px max(16px, env(safe-area-inset-left)); background: color-mix(in srgb, var(--bg) 88%, transparent);
10215
+ backdrop-filter: blur(8px); border-bottom: 1px solid var(--line); }
10216
+ h1 { font-size: 16px; margin: 0; letter-spacing: .01em; }
10217
+ h1 b { color: var(--a); }
10218
+ .pill { font: 600 12px var(--mono); padding: 3px 10px; border-radius: 99px; background: var(--grid); color: var(--muted); }
10219
+ .pill.live { background: color-mix(in srgb, var(--ok) 18%, transparent); color: var(--ok); }
10220
+ .pill.live::before { content: ""; display: inline-block; width: 7px; height: 7px; border-radius: 50%; background: var(--ok); margin-right: 6px; animation: blink 1.2s infinite; }
10221
+ .pill.bad { background: color-mix(in srgb, var(--d) 18%, transparent); color: var(--d); }
10222
+ @keyframes blink { 50% { opacity: .25; } }
10223
+ .meta { font: 12px var(--mono); color: var(--muted); }
10224
+ .chips { display: flex; flex-wrap: wrap; gap: 6px; margin-left: auto; }
10225
+ .chip { font: 600 12px var(--sans); border: 1px solid var(--line); background: var(--panel); color: var(--muted); border-radius: 99px; padding: 4px 11px; cursor: pointer; }
10226
+ .chip[aria-pressed="true"] { background: var(--ink); color: var(--panel); border-color: var(--ink); }
10227
+ .chip:focus-visible, button:focus-visible, input:focus-visible { outline: 2px solid var(--a); outline-offset: 2px; }
10228
+ main { padding: 16px max(16px, env(safe-area-inset-left)) 40px; display: grid; gap: 14px; grid-template-columns: repeat(12, minmax(0, 1fr)); }
10229
+ section.panel { background: var(--panel); border: 1px solid var(--line); border-radius: 14px; padding: 14px 16px; min-width: 0; display: grid; gap: 10px; align-content: start; }
10230
+ section.panel h2 { font-size: 13px; margin: 0; color: var(--muted); font-weight: 700; letter-spacing: .06em; text-transform: uppercase; display: flex; gap: 8px; align-items: baseline; }
10231
+ section.panel h2 small { text-transform: none; letter-spacing: 0; font-weight: 500; font-family: var(--mono); }
10232
+ .w12 { grid-column: span 12; } .w8 { grid-column: span 8; } .w6 { grid-column: span 6; } .w4 { grid-column: span 4; }
10233
+ @media (max-width: 1100px) { .w8, .w4 { grid-column: span 12; } .w6 { grid-column: span 12; } }
10234
+ .gauges { display: grid; grid-template-columns: repeat(4, minmax(0, 1fr)); gap: 10px; }
10235
+ @media (max-width: 640px) { .gauges { grid-template-columns: repeat(2, minmax(0, 1fr)); } }
10236
+ .gauge { display: grid; justify-items: center; gap: 2px; }
10237
+ .gauge canvas { width: 100%; max-width: 150px; aspect-ratio: 1.45; }
10238
+ .gauge span { font-size: 12px; color: var(--muted); }
10239
+ canvas.chart { width: 100%; height: 150px; display: block; }
10240
+ canvas.chart.tall { height: 190px; }
10241
+ .legend { display: flex; flex-wrap: wrap; gap: 12px; font: 12px var(--mono); color: var(--muted); }
10242
+ .legend i { display: inline-block; width: 10px; height: 3px; border-radius: 2px; margin-right: 5px; vertical-align: middle; }
10243
+ .stats { display: grid; grid-template-columns: repeat(auto-fit, minmax(118px, 1fr)); gap: 8px; }
10244
+ .stat { border: 1px solid var(--line); border-radius: 10px; padding: 8px 10px; display: grid; gap: 2px; }
10245
+ .stat b { font: 700 20px var(--mono); font-variant-numeric: tabular-nums; }
10246
+ .stat span { font-size: 12px; color: var(--muted); }
10247
+ .stat.flash { animation: flash .8s ease-out; }
10248
+ @keyframes flash { from { background: color-mix(in srgb, var(--d) 30%, transparent); } }
10249
+ .hosts { display: grid; grid-template-columns: repeat(auto-fit, minmax(270px, 1fr)); gap: 12px; }
10250
+ .host { border: 1px solid var(--line); border-radius: 12px; padding: 12px; display: grid; gap: 8px; position: relative; overflow: hidden; }
10251
+ .host header { all: unset; display: flex; align-items: center; gap: 8px; }
10252
+ .host h3 { margin: 0; font: 700 15px var(--mono); }
10253
+ .pulse { width: 12px; height: 12px; border-radius: 50%; background: var(--a); box-shadow: 0 0 0 0 color-mix(in srgb, var(--a) 60%, transparent); }
10254
+ .host .big { font: 800 30px var(--mono); line-height: 1; font-variant-numeric: tabular-nums; }
10255
+ .host .row { display: flex; flex-wrap: wrap; gap: 4px 14px; font: 12px var(--mono); color: var(--muted); }
10256
+ .host .row b { color: var(--ink); font-weight: 600; }
10257
+ .host canvas { width: 100%; height: 56px; display: block; }
10258
+ .shield { position: absolute; right: 10px; top: 10px; font: 700 11px var(--mono); color: var(--d); opacity: 0; transition: opacity .3s; }
10259
+ .shield.on { opacity: 1; }
10260
+ .loop { display: grid; gap: 6px; }
10261
+ .bar { height: 10px; border-radius: 6px; background: var(--grid); position: relative; overflow: hidden; }
10262
+ .bar > i { position: absolute; inset: 0 auto 0 0; border-radius: 6px; background: var(--a); transition: width .4s; }
10263
+ .bar > em { position: absolute; top: -2px; bottom: -2px; width: 2px; background: var(--ink); opacity: .6; }
10264
+ .kv { display: grid; grid-template-columns: repeat(auto-fit, minmax(110px, 1fr)); gap: 6px; }
10265
+ .kv div { background: var(--grid); border-radius: 8px; padding: 6px 9px; display: grid; }
10266
+ .kv span { font-size: 11px; color: var(--muted); } .kv b { font: 700 16px var(--mono); overflow-wrap: anywhere; }
10267
+ .table { overflow-x: auto; }
10268
+ table { border-collapse: collapse; width: 100%; font: 12.5px var(--mono); }
10269
+ th, td { padding: 6px 8px; border-bottom: 1px solid var(--line); text-align: left; white-space: nowrap; }
10270
+ th { color: var(--muted); font-weight: 600; font-family: var(--sans); }
10271
+ .act { display: inline-block; height: 8px; border-radius: 4px; background: var(--b); vertical-align: middle; min-width: 2px; }
10272
+ .badge { font-size: 11px; padding: 1px 6px; border-radius: 6px; background: var(--grid); color: var(--muted); }
10273
+ .badge.auth { background: color-mix(in srgb, var(--ok) 20%, transparent); color: var(--ok); }
10274
+ .events { list-style: none; margin: 0; padding: 0; display: grid; gap: 4px; max-height: 340px; overflow: auto; font: 12.5px var(--mono); }
10275
+ .events li { display: flex; gap: 8px; align-items: baseline; padding: 4px 6px; border-radius: 6px; animation: slide .5s ease-out; }
10276
+ @keyframes slide { from { background: color-mix(in srgb, var(--a) 22%, transparent); transform: translateX(-6px); } }
10277
+ .events time { color: var(--muted); }
10278
+ .k { font: 700 11px var(--sans); padding: 1px 7px; border-radius: 6px; }
10279
+ .k.join { background: color-mix(in srgb, var(--ok) 22%, transparent); color: var(--ok); }
10280
+ .k.leave { background: var(--grid); color: var(--muted); }
10281
+ .k.denied { background: color-mix(in srgb, var(--d) 22%, transparent); color: var(--d); }
10282
+ .k.error { background: color-mix(in srgb, var(--c) 25%, transparent); color: var(--c); }
10283
+ .empty { color: var(--muted); font-size: 13px; padding: 6px 0; }
10284
+ .overlay { position: fixed; inset: 0; z-index: 10; display: grid; place-items: center; background: color-mix(in srgb, var(--bg) 80%, transparent); backdrop-filter: blur(6px); padding: 16px; }
10285
+ .overlay form { background: var(--panel); border: 1px solid var(--line); border-radius: 16px; padding: 20px; width: min(360px, 100%); display: grid; gap: 10px; box-shadow: 0 20px 50px rgba(0,0,0,.2); }
10286
+ .overlay h2 { margin: 0; font-size: 18px; }
10287
+ .overlay input { padding: 9px 11px; border-radius: 9px; border: 1px solid var(--line); background: var(--bg); color: var(--ink); font: 14px var(--mono); }
10288
+ .overlay button { padding: 10px; border: 0; border-radius: 10px; background: var(--a); color: #fff; font-weight: 700; cursor: pointer; }
10289
+ .overlay p { margin: 0; color: var(--muted); font-size: 13px; }
10290
+ .overlay .err { color: var(--d); }
10291
+ [hidden] { display: none !important; }
10292
+ @media (prefers-reduced-motion: reduce) { * { animation: none !important; transition: none !important; } }
10293
+ </style>
10294
+ </head>
10295
+ <body>
10296
+ <header>
10297
+ <h1><b>IOSignal</b> Dashboard</h1>
10298
+ <span id="status" class="pill">연결 중</span>
10299
+ <span id="meta" class="meta"></span>
10300
+ <nav class="chips" id="chips" aria-label="패널"></nav>
10301
+ </header>
10302
+ <main id="main">
10303
+ <section class="panel w12" data-panel="server">
10304
+ <h2>서버 <small id="uptime"></small></h2>
10305
+ <div class="gauges">
10306
+ <div class="gauge"><canvas id="gCpu"></canvas><span>CPU</span></div>
10307
+ <div class="gauge"><canvas id="gEld"></canvas><span>이벤트 루프 지연 p99</span></div>
10308
+ <div class="gauge"><canvas id="gElu"></canvas><span>이벤트 루프 사용률</span></div>
10309
+ <div class="gauge"><canvas id="gMem"></canvas><span>메모리 (RSS)</span></div>
10310
+ </div>
10311
+ <canvas class="chart" id="cLoad"></canvas>
10312
+ <div class="legend"><span><i style="background:var(--a)"></i>CPU %</span><span><i style="background:var(--c)"></i>지연 p99 ms</span><span><i style="background:var(--e)"></i>연결 수</span></div>
10313
+ <div class="stats" id="sConn"></div>
10314
+ </section>
10315
+ <section class="panel w8" data-panel="traffic">
10316
+ <h2>트래픽 <small>초당</small></h2>
10317
+ <canvas class="chart tall" id="cMsg"></canvas>
10318
+ <div class="legend"><span><i style="background:var(--b)"></i>받은 메시지</span><span><i style="background:var(--a)"></i>보낸 메시지</span><span><i style="background:var(--d)"></i>버린 메시지(쿼터)</span></div>
10319
+ <canvas class="chart" id="cBytes"></canvas>
10320
+ <div class="legend"><span><i style="background:var(--b)"></i>받은 바이트</span><span><i style="background:var(--a)"></i>보낸 바이트</span></div>
10321
+ </section>
10322
+ <section class="panel w4" data-panel="traffic">
10323
+ <h2>전송 상태</h2>
10324
+ <div class="stats" id="sTraffic"></div>
10325
+ </section>
10326
+ <section class="panel w12" data-panel="hosts">
10327
+ <h2>호스트 <small id="hostCount"></small></h2>
10328
+ <div class="hosts" id="hosts"></div>
10329
+ </section>
10330
+ <section class="panel w6" data-panel="game">
10331
+ <h2>게임 루프</h2>
10332
+ <div id="game" class="loop"></div>
10333
+ </section>
10334
+ <section class="panel w6" data-panel="events">
10335
+ <h2>이벤트 <small>입장 · 퇴장 · 위조 차단 · 오류</small></h2>
10336
+ <ul class="events" id="events"></ul>
10337
+ </section>
10338
+ <section class="panel w12" data-panel="participants">
10339
+ <h2>참가자</h2>
10340
+ <div class="table" id="players"></div>
10341
+ </section>
10342
+ </main>
10343
+
10344
+ <div class="overlay" id="gate" hidden>
10345
+ <form id="gateForm">
10346
+ <h2 id="gateTitle">대시보드 로그인</h2>
10347
+ <p id="gateHelp"></p>
10348
+ <input id="gateId" placeholder="ID" autocomplete="username">
10349
+ <input id="gateKey" type="password" placeholder="키" autocomplete="current-password">
10350
+ <p id="gateErr" class="err" hidden></p>
10351
+ <button type="submit">보기</button>
10352
+ </form>
10353
+ </div>
10354
+
10355
+ <script>var CONFIG = __CONFIG__;</script>
10356
+ <script src="__IO__"></script>
10357
+ <script>
10358
+ (function () {
10359
+ "use strict";
10360
+ var $ = function (id) { return document.getElementById(id); };
10361
+ var css = function (name) { return getComputedStyle(document.documentElement).getPropertyValue(name).trim(); };
10362
+ var store = { get: function (k) { try { return localStorage.getItem(k); } catch (e) { return null; } },
10363
+ set: function (k, v) { try { localStorage.setItem(k, v); } catch (e) {} },
10364
+ sget: function (k) { try { return sessionStorage.getItem(k); } catch (e) { return null; } },
10365
+ sset: function (k, v) { try { sessionStorage.setItem(k, v); } catch (e) {} } };
10366
+ var esc = function (s) { return String(s == null ? "" : s).replace(/[&<>"]/g, function (c) { return { "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;" }[c]; }); };
10367
+ var fmtB = function (n) { n = n || 0; return n >= 1048576 ? (n / 1048576).toFixed(1) + " MB" : n >= 1024 ? (n / 1024).toFixed(1) + " KB" : Math.round(n) + " B"; };
10368
+ var fmtN = function (n) { n = n || 0; return n >= 10000 ? (n / 1000).toFixed(1) + "k" : n >= 100 ? Math.round(n) + "" : (Math.round(n * 10) / 10) + ""; };
10369
+ var fmtT = function (ms) { var s = Math.floor(ms / 1000), h = Math.floor(s / 3600), m = Math.floor(s % 3600 / 60); return (h ? h + "시간 " : "") + m + "분 " + (s % 60) + "초"; };
10370
+
10371
+ // ------------------------------------------------ panels the viewer turns on and off
10372
+ var NAMES = { server: "서버", traffic: "트래픽", hosts: "호스트", game: "게임 루프", participants: "참가자", events: "이벤트" };
10373
+ var saved = store.get("iosignal.dashboard.panels");
10374
+ var shown = saved ? saved.split(",") : CONFIG.panels.slice();
10375
+ function applyPanels() {
10376
+ var nodes = document.querySelectorAll("[data-panel]");
10377
+ for (var i = 0; i < nodes.length; i++) nodes[i].hidden = shown.indexOf(nodes[i].getAttribute("data-panel")) < 0;
10378
+ var chips = $("chips").children;
10379
+ for (var j = 0; j < chips.length; j++) chips[j].setAttribute("aria-pressed", String(shown.indexOf(chips[j].getAttribute("data-p")) >= 0));
10380
+ store.set("iosignal.dashboard.panels", shown.join(","));
10381
+ draw();
10382
+ }
10383
+ Object.keys(NAMES).forEach(function (p) {
10384
+ var b = document.createElement("button");
10385
+ b.className = "chip"; b.type = "button"; b.textContent = NAMES[p]; b.setAttribute("data-p", p);
10386
+ b.onclick = function () { var i = shown.indexOf(p); if (i >= 0) shown.splice(i, 1); else shown.push(p); applyPanels(); };
10387
+ $("chips").appendChild(b);
10388
+ });
10389
+
10390
+ // ------------------------------------------------ state
10391
+ var series = [], latest = null, hosts = [], events = [], info = null, startedAt = 0, hostHist = {};
10392
+ var pulses = {};
10393
+
10394
+ // ------------------------------------------------ canvas helpers
10395
+ function fit(cv) {
10396
+ var r = cv.getBoundingClientRect(), d = Math.min(2, window.devicePixelRatio || 1);
10397
+ var w = Math.max(10, Math.round(r.width * d)), h = Math.max(10, Math.round(r.height * d));
10398
+ if (cv.width !== w || cv.height !== h) { cv.width = w; cv.height = h; }
10399
+ var c = cv.getContext("2d"); c.setTransform(d, 0, 0, d, 0, 0);
10400
+ return { c: c, w: r.width, h: r.height };
10401
+ }
10402
+ // Lines over time with a soft area under the first one. lines: [{ values, color, scale? }]
10403
+ function chart(cv, lines, opts) {
10404
+ if (!cv.offsetParent) return;
10405
+ var f = fit(cv), c = f.c, w = f.w, h = f.h, pad = { l: 58, r: 12, t: 8, b: 18 };
10406
+ c.clearRect(0, 0, w, h);
10407
+ var max = (opts && opts.max) || 1;
10408
+ lines.forEach(function (l) { if (!l.own) l.values.forEach(function (v) { if (v > max) max = v; }); });
10409
+ max = niceMax(max);
10410
+ var n = Math.max(2, CONFIG.history), x0 = pad.l, x1 = w - pad.r, y0 = h - pad.b, y1 = pad.t;
10411
+ c.strokeStyle = css("--grid"); c.lineWidth = 1; c.fillStyle = css("--muted"); c.font = "11px " + css("--mono"); c.textAlign = "right";
10412
+ for (var g = 0; g <= 3; g++) {
10413
+ var y = y0 - (y0 - y1) * g / 3;
10414
+ c.beginPath(); c.moveTo(x0, y); c.lineTo(x1, y); c.stroke();
10415
+ c.fillText((opts && opts.fmt ? opts.fmt(max * g / 3) : fmtN(max * g / 3)), x0 - 6, y + 4);
10416
+ }
10417
+ c.textAlign = "left"; c.fillText("-" + Math.round(n / 60) + "분", x0, h - 3); c.textAlign = "right"; c.fillText("지금", x1, h - 3);
10418
+ lines.forEach(function (l, li) {
10419
+ var v = l.values, m = l.own ? niceMax(Math.max.apply(null, v.concat([1]))) : max;
10420
+ if (!v.length) return;
10421
+ var X = function (i) { return x1 - (v.length - 1 - i) * (x1 - x0) / (n - 1); };
10422
+ var Y = function (val) { return y0 - (y0 - y1) * Math.min(1, (val || 0) / m); };
10423
+ c.beginPath();
10424
+ for (var i = 0; i < v.length; i++) { var px = X(i), py = Y(v[i]); if (i) c.lineTo(px, py); else c.moveTo(px, py); }
10425
+ c.strokeStyle = css(l.color); c.lineWidth = 2; c.lineJoin = "round"; c.stroke();
10426
+ if (li === 0) {
10427
+ c.lineTo(X(v.length - 1), y0); c.lineTo(X(0), y0); c.closePath();
10428
+ var grad = c.createLinearGradient(0, y1, 0, y0);
10429
+ grad.addColorStop(0, hexA(css(l.color), 0.28)); grad.addColorStop(1, hexA(css(l.color), 0));
10430
+ c.fillStyle = grad; c.fill();
10431
+ }
10432
+ var lx = X(v.length - 1), ly = Y(v[v.length - 1]);
10433
+ c.fillStyle = css(l.color); c.beginPath(); c.arc(lx, ly, 3.5, 0, 6.3); c.fill();
10434
+ });
10435
+ }
10436
+ function niceMax(v) { var p = Math.pow(10, Math.floor(Math.log10(Math.max(v, 1e-9)))); var m = v / p; return (m <= 1 ? 1 : m <= 2 ? 2 : m <= 5 ? 5 : 10) * p; }
10437
+ function hexA(col, a) {
10438
+ if (col.charAt(0) === "#") { var n = parseInt(col.slice(1), 16); return "rgba(" + (n >> 16) + "," + ((n >> 8) & 255) + "," + (n & 255) + "," + a + ")"; }
10439
+ return col;
10440
+ }
10441
+ // Half-ring gauge with an animated needle value.
10442
+ var gaugeNow = {};
10443
+ function gauge(id, value, max, label, color) {
10444
+ var cv = $(id); if (!cv.offsetParent) return;
10445
+ var cur = gaugeNow[id] == null ? value : gaugeNow[id] + (value - gaugeNow[id]) * 0.18;
10446
+ gaugeNow[id] = cur;
10447
+ var f = fit(cv), c = f.c, w = f.w, h = f.h, r = Math.min(w / 2, h) * 0.86, cx = w / 2, cy = h * 0.9;
10448
+ c.clearRect(0, 0, w, h);
10449
+ c.lineCap = "round"; c.lineWidth = r * 0.17;
10450
+ c.strokeStyle = css("--grid"); c.beginPath(); c.arc(cx, cy, r, Math.PI, 2 * Math.PI); c.stroke();
10451
+ var frac = Math.max(0, Math.min(1, cur / max));
10452
+ var col = frac > 0.85 ? css("--d") : frac > 0.6 ? css("--c") : css(color);
10453
+ c.strokeStyle = col; c.beginPath(); c.arc(cx, cy, r, Math.PI, Math.PI + Math.PI * Math.max(0.01, frac)); c.stroke();
10454
+ c.fillStyle = css("--ink"); c.textAlign = "center"; c.font = "700 " + Math.round(r * 0.36) + "px " + css("--mono");
10455
+ c.fillText(label(cur), cx, cy - r * 0.2);
10456
+ }
10457
+ function spark(cv, values, color) {
10458
+ if (!cv.offsetParent) return;
10459
+ var f = fit(cv), c = f.c, w = f.w, h = f.h; c.clearRect(0, 0, w, h);
10460
+ if (!values.length) return;
10461
+ var m = niceMax(Math.max.apply(null, values.concat([1]))), n = 60;
10462
+ c.beginPath();
10463
+ for (var i = 0; i < values.length; i++) {
10464
+ var x = w - (values.length - 1 - i) * w / (n - 1), y = h - 3 - (h - 6) * values[i] / m;
10465
+ if (i) c.lineTo(x, y); else c.moveTo(x, y);
10466
+ }
10467
+ c.strokeStyle = css(color); c.lineWidth = 1.8; c.stroke();
10468
+ c.lineTo(w, h); c.lineTo(w - (values.length - 1) * w / (n - 1), h); c.closePath();
10469
+ c.fillStyle = hexA(css(color), 0.18); c.fill();
10470
+ }
10471
+
10472
+ // ------------------------------------------------ render
10473
+ function stat(label, value, flash) { return '<div class="stat' + (flash ? " flash" : "") + '"><b>' + value + "</b><span>" + label + "</span></div>"; }
10474
+ var prevDropped = 0, prevDenied = {};
10475
+ function render() {
10476
+ if (!latest) return;
10477
+ var p = latest.point, s = latest.server;
10478
+ $("uptime").textContent = "가동 " + fmtT(s.uptime);
10479
+ $("meta").textContent = "시청 " + s.own.viewers + "명" + (info ? " · Node " + info.node : "");
10480
+ $("sConn").innerHTML = stat("연결", p.conns) + stat("WebSocket", p.ws) + stat("TCP (보드)", p.tcp) + stat("로그인", p.auth) + stat("채널", s.channels);
10481
+ var dropped = s.counters.rateLimited + s.counters.oversizeRejected;
10482
+ $("sTraffic").innerHTML = stat("버린 메시지 (누적)", fmtN(dropped), dropped > prevDropped) +
10483
+ stat("느린 연결", s.txBlockedConnections) + stat("밀린 송신", fmtB(s.queuedBytes)) +
10484
+ stat("가장 많이 밀린 연결", fmtB(s.maxQueuedBytes)) + stat("수신 버퍼 초과로 안 보냄", fmtN(s.counters.peerRxLimitSkipped));
10485
+ prevDropped = dropped;
10486
+ renderHosts();
10487
+ renderGame();
10488
+ renderPlayers();
10489
+ }
10490
+ function renderHosts() {
10491
+ $("hostCount").textContent = hosts.length ? hosts.length + "개" : "";
10492
+ if (!hosts.length) { $("hosts").innerHTML = '<p class="empty">등록된 호스트가 없습니다. server.host()로 게임을 올리면 여기에 나옵니다.</p>'; return; }
10493
+ var box = $("hosts");
10494
+ hosts.forEach(function (h) {
10495
+ var el = box.querySelector('[data-host="' + CSS.escape(h.name) + '"]');
10496
+ if (!el) {
10497
+ el = document.createElement("div"); el.className = "host"; el.setAttribute("data-host", h.name);
10498
+ el.innerHTML = '<header><span class="pulse"></span><h3></h3></header><span class="shield">위조 차단!</span>' +
10499
+ '<div><span class="big"></span> <span class="meta">참가자</span></div><canvas></canvas><div class="row"></div>';
10500
+ el.querySelector("h3").textContent = h.name;
10501
+ box.appendChild(el);
10502
+ }
10503
+ el.querySelector(".big").textContent = h.participants;
10504
+ var r = h.rates;
10505
+ el.querySelector(".row").innerHTML = "<span>입력 <b>" + fmtN(r.inbound) + "/s</b></span><span>방송 <b>" + fmtN(r.published) + "/s</b></span>" +
10506
+ "<span>1:1 <b>" + fmtN(r.sent) + "/s</b></span><span>처리 <b>" + h.handlerAvgMs.toFixed(2) + "ms</b> (최대 " + h.handlerMaxMs.toFixed(1) + ")</span>" +
10507
+ "<span>차단 <b>" + h.totals.denied + "</b></span><span>오류 <b>" + h.totals.errors + "</b></span>";
10508
+ var shield = el.querySelector(".shield");
10509
+ if ((prevDenied[h.name] || 0) < h.totals.denied) { shield.classList.add("on"); setTimeout(function () { shield.classList.remove("on"); }, 1500); }
10510
+ prevDenied[h.name] = h.totals.denied;
10511
+ pulses[h.name] = r.inbound;
10512
+ spark(el.querySelector("canvas"), (hostHist[h.name] || []).map(function (x) { return x.in || 0; }), "--a");
10513
+ });
10514
+ Array.prototype.slice.call(box.children).forEach(function (el) {
10515
+ if (!hosts.some(function (h) { return h.name === el.getAttribute("data-host"); })) el.remove();
10516
+ });
10517
+ }
10518
+ function renderGame() {
10519
+ if (!hosts.length) { $("game").innerHTML = '<p class="empty">호스트가 없습니다.</p>'; return; }
10520
+ var html = "";
10521
+ hosts.forEach(function (h) {
10522
+ html += '<div><b style="font-family:var(--mono)">' + esc(h.name) + "</b></div>";
10523
+ if (!h.loops.length) html += '<p class="empty">host.loop(ms, fn)를 쓰면 틱 간격과 처리 시간이 여기에 나옵니다.</p>';
10524
+ h.loops.forEach(function (l) {
10525
+ var scale = l.intervalMs * 2, gap = Math.min(1, l.gapP99 / scale), target = l.intervalMs / scale;
10526
+ html += '<div class="row" style="display:flex;gap:12px;font:12px var(--mono);color:var(--muted)"><span>목표 <b style="color:var(--ink)">' + l.intervalMs + 'ms</b></span><span>틱 간격 p50 <b style="color:var(--ink)">' + l.gapP50.toFixed(1) + '</b> · p99 <b style="color:var(--ink)">' + l.gapP99.toFixed(1) + '</b></span><span>처리 평균 <b style="color:var(--ink)">' + l.stepAvg.toFixed(2) + 'ms</b> · 최대 ' + l.stepMax.toFixed(1) + '</span><span>' + l.ticks + '틱</span></div>' +
10527
+ '<div class="bar" title="틱 간격 p99 (선: 목표)"><i style="width:' + (gap * 100).toFixed(1) + '%;background:' + (l.gapP99 > l.intervalMs * 1.5 ? "var(--d)" : l.gapP99 > l.intervalMs * 1.15 ? "var(--c)" : "var(--a)") + '"></i><em style="left:' + (target * 100).toFixed(1) + '%"></em></div>' +
10528
+ '<div class="bar" title="처리 시간 / 목표"><i style="width:' + Math.min(100, l.stepAvg / l.intervalMs * 100).toFixed(1) + '%;background:var(--b)"></i></div>';
10529
+ });
10530
+ var keys = Object.keys(h.report || {});
10531
+ if (keys.length) {
10532
+ html += '<div class="kv">' + keys.map(function (k) { return "<div><span>" + esc(k) + "</span><b>" + esc(h.report[k]) + "</b></div>"; }).join("") + "</div>";
10533
+ } else html += '<p class="empty">host.report({ ... })로 보낸 값이 여기에 나옵니다.</p>';
10534
+ });
10535
+ $("game").innerHTML = html;
10536
+ }
10537
+ function renderPlayers() {
10538
+ var rows = [];
10539
+ hosts.forEach(function (h) { (h.players || []).forEach(function (p) { rows.push([h.name, p]); }); });
10540
+ if (!rows.length) { $("players").innerHTML = '<p class="empty">아직 입력을 보낸 참가자가 없습니다.</p>'; return; }
10541
+ var max = Math.max.apply(null, rows.map(function (r) { return r[1].inputs; }).concat([1]));
10542
+ $("players").innerHTML = "<table><thead><tr><th>호스트</th><th>CID</th><th>이름</th><th>로그인</th><th>입력</th><th>참가</th><th>마지막 입력</th></tr></thead><tbody>" +
10543
+ rows.map(function (r) {
10544
+ var p = r[1];
10545
+ return "<tr><td>" + esc(r[0]) + "</td><td>" + esc(p.cid) + "</td><td>" + esc(p.nick || "-") + "</td><td>" +
10546
+ (p.authorized ? '<span class="badge auth">로그인</span>' : '<span class="badge">익명</span>') + '</td><td><span class="act" style="width:' + Math.round(80 * p.inputs / max) + 'px"></span> ' + p.inputs +
10547
+ "</td><td>" + fmtT(p.since) + "</td><td>" + (p.idle < 1000 ? "방금" : Math.round(p.idle / 1000) + "초 전") + "</td></tr>";
10548
+ }).join("") + "</tbody></table>";
10549
+ }
10550
+ var KIND = { join: "입장", leave: "퇴장", denied: "위조 차단", error: "오류" };
10551
+ function addEvents(list, initial) {
10552
+ if (!list || !list.length) return;
10553
+ var ul = $("events");
10554
+ list.forEach(function (e) {
10555
+ events.push(e);
10556
+ var li = document.createElement("li");
10557
+ var t = new Date(e.at);
10558
+ var detail = e.kind === "denied" ? (e.cid || "") + " → " + (e.tag || "") : e.kind === "error" ? (e.message || "") : (e.cid || "") + (e.reason ? " (" + e.reason + ")" : "");
10559
+ li.innerHTML = "<time>" + t.toLocaleTimeString() + '</time><span class="k ' + e.kind + '">' + (KIND[e.kind] || e.kind) + "</span><span>" + esc(e.host) + "</span><span>" + esc(detail) + "</span>";
10560
+ if (initial) li.style.animation = "none";
10561
+ ul.insertBefore(li, ul.firstChild);
10562
+ });
10563
+ while (ul.children.length > 120) ul.removeChild(ul.lastChild);
10564
+ if (!ul.children.length) ul.innerHTML = '<li class="empty">아직 이벤트가 없습니다.</li>';
10565
+ }
10566
+
10567
+ function draw() {
10568
+ var pick = function (k) { return series.map(function (p) { return p[k] || 0; }); };
10569
+ chart($("cLoad"), [{ values: pick("cpu"), color: "--a" }, { values: pick("eld"), color: "--c" }, { values: pick("conns"), color: "--e", own: true }], { max: 10 });
10570
+ chart($("cMsg"), [{ values: pick("rxMsg"), color: "--b" }, { values: pick("txMsg"), color: "--a" }, { values: pick("dropped"), color: "--d" }], { max: 10 });
10571
+ chart($("cBytes"), [{ values: pick("rxB"), color: "--b" }, { values: pick("txB"), color: "--a" }], { max: 1024, fmt: fmtB });
10572
+ }
10573
+ // Gauges and host pulses move every frame; charts redraw on each sample.
10574
+ function frame(t) {
10575
+ if (latest) {
10576
+ var p = latest.point, total = latest.server.hostTotalBytes || 1;
10577
+ gauge("gCpu", p.cpu, 100, function (v) { return Math.round(v) + "%"; }, "--a");
10578
+ gauge("gEld", p.eld, 100, function (v) { return v.toFixed(1) + "ms"; }, "--c");
10579
+ gauge("gElu", p.elu * 100, 100, function (v) { return Math.round(v) + "%"; }, "--b");
10580
+ gauge("gMem", p.rss / 1048576, Math.max(256, Math.min(total / 1048576, 2048)), function (v) { return Math.round(v) + "MB"; }, "--e");
10581
+ }
10582
+ var dots = document.querySelectorAll(".host");
10583
+ for (var i = 0; i < dots.length; i++) {
10584
+ var rate = pulses[dots[i].getAttribute("data-host")] || 0;
10585
+ var speed = Math.min(8, 0.6 + rate / 8);
10586
+ var k = (Math.sin(t / 1000 * speed * Math.PI) + 1) / 2;
10587
+ var dot = dots[i].querySelector(".pulse");
10588
+ dot.style.boxShadow = rate > 0 ? "0 0 0 " + (k * 7).toFixed(1) + "px " + hexA(css("--a"), 0.35 * (1 - k)) : "none";
10589
+ dot.style.background = rate > 0 ? css("--a") : css("--muted");
10590
+ }
10591
+ requestAnimationFrame(frame);
10592
+ }
10593
+ requestAnimationFrame(frame);
10594
+ addEventListener("resize", draw);
10595
+
10596
+ // ------------------------------------------------ IOSignal connection
10597
+ var io = null, helloTimer = 0, cred = {};
10598
+ function status(text, cls) { var el = $("status"); el.textContent = text; el.className = "pill" + (cls ? " " + cls : ""); }
10599
+ function connect() {
10600
+ if (io) { try { io.destroy(); } catch (e) {} }
10601
+ io = new IO();
10602
+ if (CONFIG.access === "login" && cred.id) io.auth(cred.id, cred.key);
10603
+ io.on("change", function () {
10604
+ if (io.stateName !== "ready") status(io.stateName === "closed" ? "연결 끊김" : "연결 중", io.stateName === "closed" ? "bad" : "");
10605
+ });
10606
+ io.on("ready", function () { hello(); });
10607
+ io.on(CONFIG.topic, function (tag, msg) { onMessage(msg); });
10608
+ io.open((location.protocol === "https:" ? "wss://" : "ws://") + location.host + CONFIG.ws);
10609
+ clearInterval(helloTimer);
10610
+ helloTimer = setInterval(hello, 5000);
10611
+ }
10612
+ function hello() { if (io && io.stateName === "ready") io.signal(CONFIG.tag, { op: "hello", token: cred.token }); }
10613
+ function onMessage(m) {
10614
+ if (!m || !m.type) return;
10615
+ if (m.type === "denied") { status("권한 없음", "bad"); askAccess(true); return; }
10616
+ if (m.type === "full") { status("시청자가 가득 찼습니다", "bad"); return; }
10617
+ if (m.type === "init") {
10618
+ $("gate").hidden = true;
10619
+ status("실시간", "live");
10620
+ info = m.server; startedAt = m.startedAt; series = m.series.slice();
10621
+ hostHist = {};
10622
+ series.forEach(function (p) { Object.keys(p.hosts || {}).forEach(function (n) { (hostHist[n] = hostHist[n] || []).push(p.hosts[n]); }); });
10623
+ $("events").innerHTML = "";
10624
+ addEvents(m.events, true);
10625
+ if (!saved) { shown = m.panels.slice(); applyPanels(); }
10626
+ return;
10627
+ }
10628
+ if (m.type === "tick") {
10629
+ latest = m; hosts = m.hosts;
10630
+ series.push(m.point); if (series.length > CONFIG.history) series.shift();
10631
+ Object.keys(m.point.hosts || {}).forEach(function (n) { var a = (hostHist[n] = hostHist[n] || []); a.push(m.point.hosts[n]); if (a.length > 60) a.shift(); });
10632
+ addEvents(m.events, false);
10633
+ render(); draw();
10634
+ }
10635
+ }
10636
+ function askAccess(failed) {
10637
+ var gate = $("gate");
10638
+ $("gateErr").hidden = !failed; $("gateErr").textContent = failed ? "확인하지 못했습니다. 다시 입력해 주세요." : "";
10639
+ if (CONFIG.access === "token") {
10640
+ $("gateTitle").textContent = "대시보드 토큰"; $("gateHelp").textContent = "서버 설정의 dashboard.access.token 값을 입력하세요.";
10641
+ $("gateId").hidden = true; $("gateKey").placeholder = "토큰";
10642
+ } else {
10643
+ $("gateTitle").textContent = "대시보드 로그인"; $("gateHelp").textContent = "이 서버에 로그인할 수 있는 ID와 키를 입력하세요(허용된 역할 또는 CID).";
10644
+ }
10645
+ gate.hidden = false;
10646
+ (CONFIG.access === "token" ? $("gateKey") : $("gateId")).focus();
10647
+ }
10648
+ $("gateForm").addEventListener("submit", function (e) {
10649
+ e.preventDefault();
10650
+ if (CONFIG.access === "token") { cred = { token: $("gateKey").value }; store.sset("iosignal.dashboard.token", cred.token); hello(); }
10651
+ else { cred = { id: $("gateId").value.trim(), key: $("gateKey").value }; connect(); }
10652
+ });
10653
+ addEventListener("pagehide", function () { if (io && io.stateName === "ready") io.signal(CONFIG.tag, { op: "bye" }); });
10654
+
10655
+ applyPanels();
10656
+ addEvents([], true);
10657
+ if (CONFIG.access === "token") { var t = store.sget("iosignal.dashboard.token") || new URLSearchParams(location.search).get("key"); if (t) cred = { token: t }; }
10658
+ connect();
10659
+ if (CONFIG.access === "login" || (CONFIG.access === "token" && !cred.token)) askAccess(false);
10660
+ })();
10661
+ </script>
10662
+ </body>
10663
+ </html>`;
10664
+
10665
+ /** The page with its settings: { io, ws, access, panels, history, tag, topic }. */
10666
+ function dashboardPage(config) {
10667
+ const json = JSON.stringify(config).replace(/</g, '\\u003c');
10668
+ return PAGE.replace('__CONFIG__', json).replace('__IO__', config.io.replace(/"/g, ''))
10669
+ }
10670
+
10671
+ /** Tags of the dashboard's own host. Viewers send to IN; the host sends to one viewer as '@' + TOPIC. */
10672
+ const DASHBOARD = { HOST: 'iosignal.dashboard', IN: 'iosignal.dashboard#in', TOPIC: 'iosignal.dashboard' };
10673
+ const DASHBOARD_PANELS = ['server', 'traffic', 'hosts', 'game', 'participants', 'events'];
10674
+
10675
+ const IO_BUNDLE = new URL('../../dist/browser/iife/io.js', import.meta.url);
10676
+ const VIEWER_TTL_MS = 15000;
10677
+ const PARTICIPANT_LIMIT = 60;
10678
+ const sha = (s) => createHash('sha256').update(String(s)).digest();
10679
+
10680
+ /**
10681
+ * The server dashboard: a web page (options.path) that shows the server and its hosts live.
10682
+ * It talks to the page through IOSignal itself: viewers send 'hello' to DASHBOARD.IN, a host checks
10683
+ * access, and every second it sends the latest sample to each viewer with host.to().
10684
+ *
10685
+ * options (all optional):
10686
+ * path: '/dashboard'
10687
+ * access: 'open' | { token: '...' } | { login: { roles: ['admin'], cids: [] } }
10688
+ * panels: panels shown first (DASHBOARD_PANELS); viewers can switch them
10689
+ * history: seconds kept for the charts (default 300, 10-3600)
10690
+ * maxViewers: default 20
10691
+ * showIdentities: show participant CIDs and names (default: true unless access is 'open')
10692
+ */
10693
+ class Dashboard {
10694
+ constructor(server, options = {}) {
10695
+ if (options === true) options = {};
10696
+ if (options === null || typeof options !== 'object') throw new TypeError('dashboard options must be an object or true')
10697
+ for (const key of Object.keys(options)) {
10698
+ if (!['path', 'access', 'panels', 'history', 'maxViewers', 'showIdentities'].includes(key)) {
10699
+ throw new TypeError(`unknown dashboard option: ${key}`)
10700
+ }
10701
+ }
10702
+ const path = options.path ?? '/dashboard';
10703
+ if (typeof path !== 'string' || !/^\/[A-Za-z0-9._~\-/]*$/.test(path) || path.length > 64) {
10704
+ throw new TypeError("dashboard path must start with '/' and use URL-safe characters")
10705
+ }
10706
+ this.path = path.length > 1 ? path.replace(/\/+$/, '') : path;
10707
+ this.access = this.#access(options.access ?? 'open');
10708
+ const panels = options.panels ?? DASHBOARD_PANELS;
10709
+ if (!Array.isArray(panels) || panels.some((p) => !DASHBOARD_PANELS.includes(p))) {
10710
+ throw new TypeError(`dashboard panels must be some of: ${DASHBOARD_PANELS.join(', ')}`)
10711
+ }
10712
+ this.panels = [...new Set(panels)];
10713
+ this.history = Number.isInteger(options.history) && options.history >= 10 && options.history <= 3600 ? options.history : 300;
10714
+ if (options.history !== undefined && this.history !== options.history) throw new RangeError('dashboard history: 10-3600 seconds')
10715
+ this.maxViewers = options.maxViewers ?? 20;
10716
+ if (!Number.isInteger(this.maxViewers) || this.maxViewers < 1 || this.maxViewers > 200) throw new RangeError('dashboard maxViewers: 1-200')
10717
+ this.showIdentities = options.showIdentities ?? this.access.mode !== 'open';
10718
+
10719
+ this.server = server;
10720
+ this.startedAt = Date.now();
10721
+ this.viewers = new Map(); // cid -> { lastAt }
10722
+ this.series = []; // [{ at, ... }] one point a second, at most `history`
10723
+ this.lastHostCounters = new Map();
10724
+ this.lastJournal = new Map(); // host name -> last journal seq sent
10725
+ this.events = []; // recent events for a viewer that just arrived
10726
+
10727
+ this.host = server.host(DASHBOARD.HOST, { inbound: [DASHBOARD.IN], own: ['@' + DASHBOARD.TOPIC] });
10728
+ this.host.on('message', (from, tag, msg) => this.#onViewer(from, msg));
10729
+ this.host.on('leave', (from) => this.viewers.delete(from.cid));
10730
+ this.host.on('error', (error) => console.error('dashboard error:', error));
10731
+ this.stats = new ServerStats(server, { onSample: (value) => this.#onSample(value) });
10732
+ }
10733
+
10734
+ #access(access) {
10735
+ if (access === 'open') return { mode: 'open' }
10736
+ if (access && typeof access === 'object' && typeof access.token === 'string') {
10737
+ if (access.token.length < 8) throw new RangeError('dashboard token: at least 8 characters')
10738
+ return { mode: 'token', hash: sha(access.token) }
10739
+ }
10740
+ if (access && typeof access === 'object' && access.login && typeof access.login === 'object') {
10741
+ const roles = access.login.roles ?? ['admin'];
10742
+ const cids = access.login.cids ?? [];
10743
+ if (!Array.isArray(roles) || !Array.isArray(cids)) throw new TypeError('dashboard login: roles and cids are arrays')
10744
+ for (const role of roles) if (!ROLES.includes(role)) throw new RangeError(`dashboard login role must be one of: ${ROLES.join(', ')}`)
10745
+ return { mode: 'login', roles, cids: new Set(cids) }
10746
+ }
10747
+ throw new TypeError("dashboard access must be 'open', { token } or { login: { roles, cids } }")
10748
+ }
10749
+
10750
+ /** Whether this viewer (the server's view of it) may watch. */
10751
+ allowed(from, msg) {
10752
+ const a = this.access;
10753
+ if (a.mode === 'open') return true
10754
+ if (a.mode === 'token') return typeof msg?.token === 'string' && timingSafeEqual(sha(msg.token), a.hash)
10755
+ if (!from.authorized) return false
10756
+ return a.cids.has(from.cid) || a.roles.some((role) => hasRole({ role: from.role, boho: { isAuthorized: true } }, role))
10757
+ }
10758
+
10759
+ #onViewer(from, msg) {
10760
+ if (msg?.op === 'bye') { this.viewers.delete(from.cid); return }
10761
+ if (msg?.op !== 'hello') return
10762
+ const known = this.viewers.get(from.cid);
10763
+ if (!this.allowed(from, msg)) { this.host.to(from.cid, DASHBOARD.TOPIC, { type: 'denied', mode: this.access.mode }); return }
10764
+ if (!known && this.viewers.size >= this.maxViewers) { this.host.to(from.cid, DASHBOARD.TOPIC, { type: 'full' }); return }
10765
+ this.viewers.set(from.cid, { lastAt: Date.now() });
10766
+ if (!known) this.host.to(from.cid, DASHBOARD.TOPIC, this.#init());
10767
+ }
10768
+
10769
+ #init() {
10770
+ return {
10771
+ type: 'init', at: Date.now(), startedAt: this.startedAt, panels: this.panels, history: this.history,
10772
+ showIdentities: this.showIdentities, server: this.#serverInfo(), series: this.series, events: this.events.slice(-60),
10773
+ }
10774
+ }
10775
+
10776
+ #serverInfo() {
10777
+ const s = this.server;
10778
+ return {
10779
+ ws: s.port ?? null, tcp: s.congPort ?? null, membersOnly: s.membersOnly, anonymousQuota: s.anonymousQuota,
10780
+ quota: s.quotas?.[s.anonymousQuota] ?? null, node: process.version,
10781
+ }
10782
+ }
10783
+
10784
+ #mask(cid) {
10785
+ if (this.showIdentities) return cid
10786
+ const s = String(cid ?? '');
10787
+ return s.length <= 2 ? '••' : s.slice(0, 2) + '•'.repeat(Math.min(4, s.length - 2))
10788
+ }
10789
+
10790
+ #hosts(now) {
10791
+ const out = [];
10792
+ for (const host of this.server.hosts) {
10793
+ if (host === this.host || host.closed) continue
10794
+ const c = host.counters;
10795
+ const prev = this.lastHostCounters.get(host) ?? { ...c, at: now - 1000 };
10796
+ const sec = Math.max(0.001, (now - prev.at) / 1000);
10797
+ const rate = (k) => (c[k] - prev[k]) / sec;
10798
+ const handled = (c.inbound - prev.inbound) + (c.leaves - prev.leaves);
10799
+ this.lastHostCounters.set(host, { ...c, at: now });
10800
+ const item = {
10801
+ name: host.name, participants: host.participants.size,
10802
+ rates: { inbound: rate('inbound'), denied: rate('denied'), rejected: rate('rejected'), published: rate('published'), delivered: rate('delivered'), sent: rate('sent'), errors: rate('errors') },
10803
+ totals: { inbound: c.inbound, denied: c.denied, rejected: c.rejected, joins: c.joins, leaves: c.leaves, errors: c.errors },
10804
+ handlerAvgMs: handled > 0 ? (c.handlerMs - prev.handlerMs) / handled : 0,
10805
+ handlerMaxMs: host.handlerMaxMs,
10806
+ loops: host.loopStats(), report: host.reported,
10807
+ };
10808
+ {
10809
+ item.players = host.activity()
10810
+ .sort((a, b) => b.lastAt - a.lastAt).slice(0, PARTICIPANT_LIMIT)
10811
+ .map(({ from, inputs, firstAt, lastAt }) => ({
10812
+ cid: this.#mask(from.cid), nick: this.showIdentities ? from.nick : '', authorized: from.authorized,
10813
+ inputs, since: now - firstAt, idle: now - lastAt,
10814
+ }));
10815
+ }
10816
+ const after = this.lastJournal.get(host.name) ?? 0;
10817
+ const fresh = host.journal(after);
10818
+ if (fresh.length) this.lastJournal.set(host.name, fresh.at(-1).seq);
10819
+ for (const e of fresh) {
10820
+ this.events.push({ host: host.name, at: e.at, kind: e.kind, cid: e.cid ? this.#mask(e.cid) : undefined, tag: e.tag, reason: e.reason, message: e.message });
10821
+ }
10822
+ out.push(item);
10823
+ }
10824
+ if (this.events.length > 200) this.events.splice(0, this.events.length - 200);
10825
+ return out
10826
+ }
10827
+
10828
+ #onSample(v) {
10829
+ const now = v.at;
10830
+ for (const [cid, viewer] of this.viewers) if (now - viewer.lastAt > VIEWER_TTL_MS) this.viewers.delete(cid);
10831
+ const eventsBefore = this.events.length;
10832
+ const hosts = this.#hosts(now);
10833
+ // The dashboard's own traffic, so it can be told apart from the game's.
10834
+ const own = { viewers: this.viewers.size };
10835
+ const point = {
10836
+ at: now, cpu: v.cpuPercent, elu: v.eventLoopUtilization, eld: v.eventLoopP99Ms, rss: v.rss, heap: v.heapUsed,
10837
+ conns: v.total, ws: v.websocket, tcp: v.total - v.websocket, auth: v.authenticated,
10838
+ rxMsg: v.rates.rxMessages ?? 0, txMsg: v.rates.txMessages ?? 0, rxB: v.rates.rxBytes ?? 0, txB: v.rates.txBytes ?? 0,
10839
+ dropped: (v.rates.rateLimited ?? 0) + (v.rates.oversizeRejected ?? 0),
10840
+ hosts: Object.fromEntries(hosts.map((h) => [h.name, { in: h.rates.inbound, denied: h.rates.denied, players: h.participants, step: h.loops[0]?.stepAvg ?? null, gap: h.loops[0]?.gapP99 ?? null }])),
10841
+ };
10842
+ this.series.push(point);
10843
+ if (this.series.length > this.history) this.series.shift();
10844
+ if (!this.viewers.size) return
10845
+ const frame = {
10846
+ type: 'tick', point,
10847
+ server: {
10848
+ uptime: now - this.startedAt, states: v.states, queuedBytes: v.queuedBytes, maxQueuedBytes: v.maxQueuedBytes,
10849
+ txBlockedConnections: v.txBlockedConnections, channels: v.channels, hostTotalBytes: v.hostTotalBytes,
10850
+ counters: { rateLimited: v.counters.rateLimited, oversizeRejected: v.counters.oversizeRejected, peerRxLimitSkipped: v.counters.peerRxLimitSkipped },
10851
+ own,
10852
+ },
10853
+ hosts, events: this.events.slice(eventsBefore),
10854
+ };
10855
+ for (const cid of this.viewers.keys()) this.host.to(cid, DASHBOARD.TOPIC, frame);
10856
+ }
10857
+
10858
+ /**
10859
+ * Serves the page (GET path) and the browser client (path + '/io.js'). Returns true when it
10860
+ * answered. A Server with `port` calls it itself; with your own httpServer call it first in
10861
+ * your request handler: if (server.dashboard.handle(req, res)) return
10862
+ */
10863
+ handle(req, res) {
10864
+ let pathname;
10865
+ try { pathname = new URL(req.url || '/', 'http://localhost').pathname; } catch { return false }
10866
+ const root = this.path === '/' ? '' : this.path;
10867
+ if (pathname !== this.path && pathname !== root + '/' && pathname !== root + '/io.js') return false
10868
+ if (req.method !== 'GET' && req.method !== 'HEAD') { res.writeHead(405, { Allow: 'GET, HEAD' }); res.end(); return true }
10869
+ const headers = { 'Cache-Control': 'no-store', 'X-Content-Type-Options': 'nosniff', 'Referrer-Policy': 'no-referrer' };
10870
+ if (pathname === root + '/io.js') {
10871
+ readFile(IO_BUNDLE).then((js) => {
10872
+ res.writeHead(200, { ...headers, 'Content-Type': 'text/javascript; charset=utf-8' });
10873
+ res.end(req.method === 'HEAD' ? undefined : js);
10874
+ }, () => { res.writeHead(500); res.end('IOSignal browser bundle not found (build dist first)'); });
10875
+ return true
10876
+ }
10877
+ const config = {
10878
+ io: root + '/io.js', ws: this.server.wsPath || '/', access: this.access.mode, panels: this.panels,
10879
+ history: this.history, tag: DASHBOARD.IN, topic: '@' + DASHBOARD.TOPIC,
10880
+ };
10881
+ res.writeHead(200, {
10882
+ ...headers, 'Content-Type': 'text/html; charset=utf-8',
10883
+ 'Content-Security-Policy': "default-src 'self'; script-src 'self' 'unsafe-inline'; style-src 'self' 'unsafe-inline'; connect-src 'self' ws: wss:; img-src 'self' data:",
10884
+ });
10885
+ res.end(req.method === 'HEAD' ? undefined : dashboardPage(config));
10886
+ return true
10887
+ }
10888
+
10889
+ close() {
10890
+ this.stats.dispose();
10891
+ this.host.close();
10892
+ this.viewers.clear();
10893
+ }
10894
+ }
10895
+
10896
+ const STATUS = {
10897
+ OK: 0,
10898
+ //0~127: success
10899
+ //128~255: fail
10900
+ ERROR: 255
10901
+ };
10902
+
9736
10903
  /**
9737
10904
  * LocalKeyProvider.js
9738
10905
  *
@@ -9905,6 +11072,9 @@ class Server extends require$$0$3 {
9905
11072
  * options.anonymousQuota: profile of a connection that has not authenticated (default 'anonymous').
9906
11073
  * options.duplicateLogin: 'keepOld' | 'keepNew' for this Server's connections; overrides the auth
9907
11074
  * manager's own policy without changing it, so an auth manager can be shared between servers.
11075
+ * options.dashboard: true or { path, access, panels, history, maxViewers, showIdentities } shows a live
11076
+ * status page of the server and its hosts (see Dashboard.js); off by default. With `port` the Server
11077
+ * serves it itself; with your own httpServer call server.dashboard.handle(req, res) in its handler.
9908
11078
  * A failed listen (e.g. EADDRINUSE) is emitted as 'error'.
9909
11079
  * @param {any} [authManager] Optional authentication manager.
9910
11080
  */
@@ -9943,6 +11113,7 @@ class Server extends require$$0$3 {
9943
11113
  this.membersOnly = boolean('membersOnly', options.membersOnly ?? serverOption.membersOnly);
9944
11114
  this.serviceNames = new Set();
9945
11115
  this.services = new Map(); // name -> service module (for lifecycle hooks)
11116
+ this.hosts = new Set(); // open hosts (server.host)
9946
11117
  // Stays null for a CongSocket-only server, so close() does not wait on a WebSocket server.
9947
11118
  this.wss = null;
9948
11119
  this.port = null;
@@ -9976,6 +11147,16 @@ class Server extends require$$0$3 {
9976
11147
  }
9977
11148
 
9978
11149
  this.manager = new Manager(this, authManager);
11150
+ // The status page; null when off.
11151
+ this.dashboard = null;
11152
+ if (options.dashboard) {
11153
+ try {
11154
+ this.dashboard = new Dashboard(this, options.dashboard);
11155
+ } catch (error) {
11156
+ this.manager.close(); // a bad dashboard option must not leave the heartbeat timer running
11157
+ throw error
11158
+ }
11159
+ }
9979
11160
 
9980
11161
  this.serverCountToListen = 0;
9981
11162
  this.listeningServerCount = 0;
@@ -9994,7 +11175,15 @@ class Server extends require$$0$3 {
9994
11175
 
9995
11176
  startWSServer() {
9996
11177
  // console.log('optoins', options )
9997
- if (this.port || this.port == 0) {
11178
+ if ((this.port || this.port == 0) && this.dashboard) {
11179
+ // The WebSocket server alone answers plain HTTP with 426; the dashboard needs pages too.
11180
+ this.ownHttp = require$$2$1.createServer((req, res) => {
11181
+ if (!this.dashboard.handle(req, res)) { res.writeHead(404, { 'Content-Type': 'text/plain' }); res.end('Not found'); }
11182
+ });
11183
+ this.ownHttp.on('error', (err) => this.onListenerError('ws', err));
11184
+ this.wss = new WebSocketServer({ server: this.ownHttp, path: this.wsPath, maxPayload: this.maxPayload });
11185
+ this.ownHttp.listen(this.port);
11186
+ } else if (this.port || this.port == 0) {
9998
11187
  this.wss = new WebSocketServer({ port: this.port , path: this.wsPath, maxPayload: this.maxPayload });
9999
11188
  } else if (this.httpServer ) {
10000
11189
  this.wss = new WebSocketServer({ server: this.httpServer, path: this.wsPath, maxPayload: this.maxPayload });
@@ -10068,6 +11257,25 @@ class Server extends require$$0$3 {
10068
11257
  return this.manager.metrics.snapshot()
10069
11258
  }
10070
11259
 
11260
+ /**
11261
+ * Server-side logic (a game, a room) in this process. Signals clients send to the inbound tags go
11262
+ * to the host only, with the server's view of the sender; clients cannot send to the tags it owns.
11263
+ * @param {string} name 1-64 characters of A-Z a-z 0-9 _ . -
11264
+ * @param {{ inbound: string[], own?: string[], fanout?: number|null,
11265
+ * retain?: { tags?: number, bytes?: number } }} options
11266
+ * inbound: channel tags clients send to the host (a trailing '*' is a prefix). Not relayed.
11267
+ * own: channel tags only the host publishes, and '@topic' unicast topics only the host sends.
11268
+ * fanout: most subscribers one publish reaches (default null: all).
11269
+ * retain: budget of the host's retained ('$') values (default: retain.tagsPerOwner/bytesPerOwner).
11270
+ * @returns {Host}
11271
+ */
11272
+ host(name, options) {
11273
+ const host = new Host(this.manager, name, options);
11274
+ host.once('close', () => this.hosts.delete(host));
11275
+ this.hosts.add(host);
11276
+ return host
11277
+ }
11278
+
10071
11279
  /**
10072
11280
  * RPC service register.
10073
11281
  * service: service_name <string>
@@ -10127,6 +11335,8 @@ class Server extends require$$0$3 {
10127
11335
  */
10128
11336
  close(callback) {
10129
11337
  console.log('closing iosignal server...');
11338
+ if (this.dashboard) this.dashboard.close();
11339
+ for (const host of [...this.hosts]) host.close();
10130
11340
  if (this.manager) {
10131
11341
  this.manager.close();
10132
11342
  }
@@ -10156,7 +11366,10 @@ class Server extends require$$0$3 {
10156
11366
  if (this.wss) {
10157
11367
  this.wss.close(() => {
10158
11368
  // console.log('wss server closed.')
10159
- onClosed();
11369
+ if (!this.ownHttp) return onClosed()
11370
+ // The HTTP server this Server made for the dashboard closes with it.
11371
+ this.ownHttp.close(() => onClosed());
11372
+ this.ownHttp.closeAllConnections?.();
10160
11373
  });
10161
11374
  }
10162
11375
 
@@ -10204,7 +11417,7 @@ class FileKeyProvider {
10204
11417
  }
10205
11418
 
10206
11419
  loadAuthInfoFile_JSON(path) {
10207
- let file = readFileSync(path);
11420
+ let file = readFileSync$1(path);
10208
11421
  file = new TextDecoder().decode(file);
10209
11422
  let list = JSON.parse(file);
10210
11423
  list.forEach(item => {