playsocketjs 1.0.13 → 1.1.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.
@@ -7,6 +7,2178 @@ function getDefaultExportFromCjs (x) {
7
7
  return x && x.__esModule && Object.prototype.hasOwnProperty.call(x, 'default') ? x['default'] : x;
8
8
  }
9
9
 
10
+ function getAugmentedNamespace(n) {
11
+ if (Object.prototype.hasOwnProperty.call(n, '__esModule')) return n;
12
+ var f = n.default;
13
+ if (typeof f == "function") {
14
+ var a = function a () {
15
+ if (this instanceof a) {
16
+ return Reflect.construct(f, arguments, this.constructor);
17
+ }
18
+ return f.apply(this, arguments);
19
+ };
20
+ a.prototype = f.prototype;
21
+ } else a = {};
22
+ Object.defineProperty(a, '__esModule', {value: true});
23
+ Object.keys(n).forEach(function (k) {
24
+ var d = Object.getOwnPropertyDescriptor(n, k);
25
+ Object.defineProperty(a, k, d.get ? d : {
26
+ enumerable: true,
27
+ get: function () {
28
+ return n[k];
29
+ }
30
+ });
31
+ });
32
+ return a;
33
+ }
34
+
35
+ function utf8Count(str) {
36
+ const strLength = str.length;
37
+ let byteLength = 0;
38
+ let pos = 0;
39
+ while (pos < strLength) {
40
+ let value = str.charCodeAt(pos++);
41
+ if ((value & 0xffffff80) === 0) {
42
+ // 1-byte
43
+ byteLength++;
44
+ continue;
45
+ }
46
+ else if ((value & 0xfffff800) === 0) {
47
+ // 2-bytes
48
+ byteLength += 2;
49
+ }
50
+ else {
51
+ // handle surrogate pair
52
+ if (value >= 0xd800 && value <= 0xdbff) {
53
+ // high surrogate
54
+ if (pos < strLength) {
55
+ const extra = str.charCodeAt(pos);
56
+ if ((extra & 0xfc00) === 0xdc00) {
57
+ ++pos;
58
+ value = ((value & 0x3ff) << 10) + (extra & 0x3ff) + 0x10000;
59
+ }
60
+ }
61
+ }
62
+ if ((value & 0xffff0000) === 0) {
63
+ // 3-byte
64
+ byteLength += 3;
65
+ }
66
+ else {
67
+ // 4-byte
68
+ byteLength += 4;
69
+ }
70
+ }
71
+ }
72
+ return byteLength;
73
+ }
74
+ function utf8EncodeJs(str, output, outputOffset) {
75
+ const strLength = str.length;
76
+ let offset = outputOffset;
77
+ let pos = 0;
78
+ while (pos < strLength) {
79
+ let value = str.charCodeAt(pos++);
80
+ if ((value & 0xffffff80) === 0) {
81
+ // 1-byte
82
+ output[offset++] = value;
83
+ continue;
84
+ }
85
+ else if ((value & 0xfffff800) === 0) {
86
+ // 2-bytes
87
+ output[offset++] = ((value >> 6) & 0x1f) | 0xc0;
88
+ }
89
+ else {
90
+ // handle surrogate pair
91
+ if (value >= 0xd800 && value <= 0xdbff) {
92
+ // high surrogate
93
+ if (pos < strLength) {
94
+ const extra = str.charCodeAt(pos);
95
+ if ((extra & 0xfc00) === 0xdc00) {
96
+ ++pos;
97
+ value = ((value & 0x3ff) << 10) + (extra & 0x3ff) + 0x10000;
98
+ }
99
+ }
100
+ }
101
+ if ((value & 0xffff0000) === 0) {
102
+ // 3-byte
103
+ output[offset++] = ((value >> 12) & 0x0f) | 0xe0;
104
+ output[offset++] = ((value >> 6) & 0x3f) | 0x80;
105
+ }
106
+ else {
107
+ // 4-byte
108
+ output[offset++] = ((value >> 18) & 0x07) | 0xf0;
109
+ output[offset++] = ((value >> 12) & 0x3f) | 0x80;
110
+ output[offset++] = ((value >> 6) & 0x3f) | 0x80;
111
+ }
112
+ }
113
+ output[offset++] = (value & 0x3f) | 0x80;
114
+ }
115
+ }
116
+ // TextEncoder and TextDecoder are standardized in whatwg encoding:
117
+ // https://encoding.spec.whatwg.org/
118
+ // and available in all the modern browsers:
119
+ // https://caniuse.com/textencoder
120
+ // They are available in Node.js since v12 LTS as well:
121
+ // https://nodejs.org/api/globals.html#textencoder
122
+ const sharedTextEncoder = new TextEncoder();
123
+ // This threshold should be determined by benchmarking, which might vary in engines and input data.
124
+ // Run `npx ts-node benchmark/encode-string.ts` for details.
125
+ const TEXT_ENCODER_THRESHOLD = 50;
126
+ function utf8EncodeTE(str, output, outputOffset) {
127
+ sharedTextEncoder.encodeInto(str, output.subarray(outputOffset));
128
+ }
129
+ function utf8Encode(str, output, outputOffset) {
130
+ if (str.length > TEXT_ENCODER_THRESHOLD) {
131
+ utf8EncodeTE(str, output, outputOffset);
132
+ }
133
+ else {
134
+ utf8EncodeJs(str, output, outputOffset);
135
+ }
136
+ }
137
+ const CHUNK_SIZE = 4096;
138
+ function utf8DecodeJs(bytes, inputOffset, byteLength) {
139
+ let offset = inputOffset;
140
+ const end = offset + byteLength;
141
+ const units = [];
142
+ let result = "";
143
+ while (offset < end) {
144
+ const byte1 = bytes[offset++];
145
+ if ((byte1 & 0x80) === 0) {
146
+ // 1 byte
147
+ units.push(byte1);
148
+ }
149
+ else if ((byte1 & 0xe0) === 0xc0) {
150
+ // 2 bytes
151
+ const byte2 = bytes[offset++] & 0x3f;
152
+ units.push(((byte1 & 0x1f) << 6) | byte2);
153
+ }
154
+ else if ((byte1 & 0xf0) === 0xe0) {
155
+ // 3 bytes
156
+ const byte2 = bytes[offset++] & 0x3f;
157
+ const byte3 = bytes[offset++] & 0x3f;
158
+ units.push(((byte1 & 0x1f) << 12) | (byte2 << 6) | byte3);
159
+ }
160
+ else if ((byte1 & 0xf8) === 0xf0) {
161
+ // 4 bytes
162
+ const byte2 = bytes[offset++] & 0x3f;
163
+ const byte3 = bytes[offset++] & 0x3f;
164
+ const byte4 = bytes[offset++] & 0x3f;
165
+ let unit = ((byte1 & 0x07) << 0x12) | (byte2 << 0x0c) | (byte3 << 0x06) | byte4;
166
+ if (unit > 0xffff) {
167
+ unit -= 0x10000;
168
+ units.push(((unit >>> 10) & 0x3ff) | 0xd800);
169
+ unit = 0xdc00 | (unit & 0x3ff);
170
+ }
171
+ units.push(unit);
172
+ }
173
+ else {
174
+ units.push(byte1);
175
+ }
176
+ if (units.length >= CHUNK_SIZE) {
177
+ result += String.fromCharCode(...units);
178
+ units.length = 0;
179
+ }
180
+ }
181
+ if (units.length > 0) {
182
+ result += String.fromCharCode(...units);
183
+ }
184
+ return result;
185
+ }
186
+ const sharedTextDecoder = new TextDecoder();
187
+ // This threshold should be determined by benchmarking, which might vary in engines and input data.
188
+ // Run `npx ts-node benchmark/decode-string.ts` for details.
189
+ const TEXT_DECODER_THRESHOLD = 200;
190
+ function utf8DecodeTD(bytes, inputOffset, byteLength) {
191
+ const stringBytes = bytes.subarray(inputOffset, inputOffset + byteLength);
192
+ return sharedTextDecoder.decode(stringBytes);
193
+ }
194
+ function utf8Decode(bytes, inputOffset, byteLength) {
195
+ if (byteLength > TEXT_DECODER_THRESHOLD) {
196
+ return utf8DecodeTD(bytes, inputOffset, byteLength);
197
+ }
198
+ else {
199
+ return utf8DecodeJs(bytes, inputOffset, byteLength);
200
+ }
201
+ }
202
+
203
+ /**
204
+ * ExtData is used to handle Extension Types that are not registered to ExtensionCodec.
205
+ */
206
+ class ExtData {
207
+ constructor(type, data) {
208
+ this.type = type;
209
+ this.data = data;
210
+ }
211
+ }
212
+
213
+ class DecodeError extends Error {
214
+ constructor(message) {
215
+ super(message);
216
+ // fix the prototype chain in a cross-platform way
217
+ const proto = Object.create(DecodeError.prototype);
218
+ Object.setPrototypeOf(this, proto);
219
+ Object.defineProperty(this, "name", {
220
+ configurable: true,
221
+ enumerable: false,
222
+ value: DecodeError.name,
223
+ });
224
+ }
225
+ }
226
+
227
+ // Integer Utility
228
+ const UINT32_MAX = 4294967295;
229
+ // DataView extension to handle int64 / uint64,
230
+ // where the actual range is 53-bits integer (a.k.a. safe integer)
231
+ function setUint64(view, offset, value) {
232
+ const high = value / 4294967296;
233
+ const low = value; // high bits are truncated by DataView
234
+ view.setUint32(offset, high);
235
+ view.setUint32(offset + 4, low);
236
+ }
237
+ function setInt64(view, offset, value) {
238
+ const high = Math.floor(value / 4294967296);
239
+ const low = value; // high bits are truncated by DataView
240
+ view.setUint32(offset, high);
241
+ view.setUint32(offset + 4, low);
242
+ }
243
+ function getInt64(view, offset) {
244
+ const high = view.getInt32(offset);
245
+ const low = view.getUint32(offset + 4);
246
+ return high * 4294967296 + low;
247
+ }
248
+ function getUint64(view, offset) {
249
+ const high = view.getUint32(offset);
250
+ const low = view.getUint32(offset + 4);
251
+ return high * 4294967296 + low;
252
+ }
253
+
254
+ // https://github.com/msgpack/msgpack/blob/master/spec.md#timestamp-extension-type
255
+ const EXT_TIMESTAMP = -1;
256
+ const TIMESTAMP32_MAX_SEC = 0x100000000 - 1; // 32-bit unsigned int
257
+ const TIMESTAMP64_MAX_SEC = 0x400000000 - 1; // 34-bit unsigned int
258
+ function encodeTimeSpecToTimestamp({ sec, nsec }) {
259
+ if (sec >= 0 && nsec >= 0 && sec <= TIMESTAMP64_MAX_SEC) {
260
+ // Here sec >= 0 && nsec >= 0
261
+ if (nsec === 0 && sec <= TIMESTAMP32_MAX_SEC) {
262
+ // timestamp 32 = { sec32 (unsigned) }
263
+ const rv = new Uint8Array(4);
264
+ const view = new DataView(rv.buffer);
265
+ view.setUint32(0, sec);
266
+ return rv;
267
+ }
268
+ else {
269
+ // timestamp 64 = { nsec30 (unsigned), sec34 (unsigned) }
270
+ const secHigh = sec / 0x100000000;
271
+ const secLow = sec & 0xffffffff;
272
+ const rv = new Uint8Array(8);
273
+ const view = new DataView(rv.buffer);
274
+ // nsec30 | secHigh2
275
+ view.setUint32(0, (nsec << 2) | (secHigh & 0x3));
276
+ // secLow32
277
+ view.setUint32(4, secLow);
278
+ return rv;
279
+ }
280
+ }
281
+ else {
282
+ // timestamp 96 = { nsec32 (unsigned), sec64 (signed) }
283
+ const rv = new Uint8Array(12);
284
+ const view = new DataView(rv.buffer);
285
+ view.setUint32(0, nsec);
286
+ setInt64(view, 4, sec);
287
+ return rv;
288
+ }
289
+ }
290
+ function encodeDateToTimeSpec(date) {
291
+ const msec = date.getTime();
292
+ const sec = Math.floor(msec / 1e3);
293
+ const nsec = (msec - sec * 1e3) * 1e6;
294
+ // Normalizes { sec, nsec } to ensure nsec is unsigned.
295
+ const nsecInSec = Math.floor(nsec / 1e9);
296
+ return {
297
+ sec: sec + nsecInSec,
298
+ nsec: nsec - nsecInSec * 1e9,
299
+ };
300
+ }
301
+ function encodeTimestampExtension(object) {
302
+ if (object instanceof Date) {
303
+ const timeSpec = encodeDateToTimeSpec(object);
304
+ return encodeTimeSpecToTimestamp(timeSpec);
305
+ }
306
+ else {
307
+ return null;
308
+ }
309
+ }
310
+ function decodeTimestampToTimeSpec(data) {
311
+ const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
312
+ // data may be 32, 64, or 96 bits
313
+ switch (data.byteLength) {
314
+ case 4: {
315
+ // timestamp 32 = { sec32 }
316
+ const sec = view.getUint32(0);
317
+ const nsec = 0;
318
+ return { sec, nsec };
319
+ }
320
+ case 8: {
321
+ // timestamp 64 = { nsec30, sec34 }
322
+ const nsec30AndSecHigh2 = view.getUint32(0);
323
+ const secLow32 = view.getUint32(4);
324
+ const sec = (nsec30AndSecHigh2 & 0x3) * 0x100000000 + secLow32;
325
+ const nsec = nsec30AndSecHigh2 >>> 2;
326
+ return { sec, nsec };
327
+ }
328
+ case 12: {
329
+ // timestamp 96 = { nsec32 (unsigned), sec64 (signed) }
330
+ const sec = getInt64(view, 4);
331
+ const nsec = view.getUint32(0);
332
+ return { sec, nsec };
333
+ }
334
+ default:
335
+ throw new DecodeError(`Unrecognized data size for timestamp (expected 4, 8, or 12): ${data.length}`);
336
+ }
337
+ }
338
+ function decodeTimestampExtension(data) {
339
+ const timeSpec = decodeTimestampToTimeSpec(data);
340
+ return new Date(timeSpec.sec * 1e3 + timeSpec.nsec / 1e6);
341
+ }
342
+ const timestampExtension = {
343
+ type: EXT_TIMESTAMP,
344
+ encode: encodeTimestampExtension,
345
+ decode: decodeTimestampExtension,
346
+ };
347
+
348
+ // ExtensionCodec to handle MessagePack extensions
349
+ class ExtensionCodec {
350
+ constructor() {
351
+ // built-in extensions
352
+ this.builtInEncoders = [];
353
+ this.builtInDecoders = [];
354
+ // custom extensions
355
+ this.encoders = [];
356
+ this.decoders = [];
357
+ this.register(timestampExtension);
358
+ }
359
+ register({ type, encode, decode, }) {
360
+ if (type >= 0) {
361
+ // custom extensions
362
+ this.encoders[type] = encode;
363
+ this.decoders[type] = decode;
364
+ }
365
+ else {
366
+ // built-in extensions
367
+ const index = -1 - type;
368
+ this.builtInEncoders[index] = encode;
369
+ this.builtInDecoders[index] = decode;
370
+ }
371
+ }
372
+ tryToEncode(object, context) {
373
+ // built-in extensions
374
+ for (let i = 0; i < this.builtInEncoders.length; i++) {
375
+ const encodeExt = this.builtInEncoders[i];
376
+ if (encodeExt != null) {
377
+ const data = encodeExt(object, context);
378
+ if (data != null) {
379
+ const type = -1 - i;
380
+ return new ExtData(type, data);
381
+ }
382
+ }
383
+ }
384
+ // custom extensions
385
+ for (let i = 0; i < this.encoders.length; i++) {
386
+ const encodeExt = this.encoders[i];
387
+ if (encodeExt != null) {
388
+ const data = encodeExt(object, context);
389
+ if (data != null) {
390
+ const type = i;
391
+ return new ExtData(type, data);
392
+ }
393
+ }
394
+ }
395
+ if (object instanceof ExtData) {
396
+ // to keep ExtData as is
397
+ return object;
398
+ }
399
+ return null;
400
+ }
401
+ decode(data, type, context) {
402
+ const decodeExt = type < 0 ? this.builtInDecoders[-1 - type] : this.decoders[type];
403
+ if (decodeExt) {
404
+ return decodeExt(data, type, context);
405
+ }
406
+ else {
407
+ // decode() does not fail, returns ExtData instead.
408
+ return new ExtData(type, data);
409
+ }
410
+ }
411
+ }
412
+ ExtensionCodec.defaultCodec = new ExtensionCodec();
413
+
414
+ function isArrayBufferLike(buffer) {
415
+ return (buffer instanceof ArrayBuffer || (typeof SharedArrayBuffer !== "undefined" && buffer instanceof SharedArrayBuffer));
416
+ }
417
+ function ensureUint8Array(buffer) {
418
+ if (buffer instanceof Uint8Array) {
419
+ return buffer;
420
+ }
421
+ else if (ArrayBuffer.isView(buffer)) {
422
+ return new Uint8Array(buffer.buffer, buffer.byteOffset, buffer.byteLength);
423
+ }
424
+ else if (isArrayBufferLike(buffer)) {
425
+ return new Uint8Array(buffer);
426
+ }
427
+ else {
428
+ // ArrayLike<number>
429
+ return Uint8Array.from(buffer);
430
+ }
431
+ }
432
+
433
+ const DEFAULT_MAX_DEPTH = 100;
434
+ const DEFAULT_INITIAL_BUFFER_SIZE = 2048;
435
+ class Encoder {
436
+ constructor(options) {
437
+ this.entered = false;
438
+ this.extensionCodec = options?.extensionCodec ?? ExtensionCodec.defaultCodec;
439
+ this.context = options?.context; // needs a type assertion because EncoderOptions has no context property when ContextType is undefined
440
+ this.useBigInt64 = options?.useBigInt64 ?? false;
441
+ this.maxDepth = options?.maxDepth ?? DEFAULT_MAX_DEPTH;
442
+ this.initialBufferSize = options?.initialBufferSize ?? DEFAULT_INITIAL_BUFFER_SIZE;
443
+ this.sortKeys = options?.sortKeys ?? false;
444
+ this.forceFloat32 = options?.forceFloat32 ?? false;
445
+ this.ignoreUndefined = options?.ignoreUndefined ?? false;
446
+ this.forceIntegerToFloat = options?.forceIntegerToFloat ?? false;
447
+ this.pos = 0;
448
+ this.view = new DataView(new ArrayBuffer(this.initialBufferSize));
449
+ this.bytes = new Uint8Array(this.view.buffer);
450
+ }
451
+ clone() {
452
+ // Because of slightly special argument `context`,
453
+ // type assertion is needed.
454
+ // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
455
+ return new Encoder({
456
+ extensionCodec: this.extensionCodec,
457
+ context: this.context,
458
+ useBigInt64: this.useBigInt64,
459
+ maxDepth: this.maxDepth,
460
+ initialBufferSize: this.initialBufferSize,
461
+ sortKeys: this.sortKeys,
462
+ forceFloat32: this.forceFloat32,
463
+ ignoreUndefined: this.ignoreUndefined,
464
+ forceIntegerToFloat: this.forceIntegerToFloat,
465
+ });
466
+ }
467
+ reinitializeState() {
468
+ this.pos = 0;
469
+ }
470
+ /**
471
+ * This is almost equivalent to {@link Encoder#encode}, but it returns an reference of the encoder's internal buffer and thus much faster than {@link Encoder#encode}.
472
+ *
473
+ * @returns Encodes the object and returns a shared reference the encoder's internal buffer.
474
+ */
475
+ encodeSharedRef(object) {
476
+ if (this.entered) {
477
+ const instance = this.clone();
478
+ return instance.encodeSharedRef(object);
479
+ }
480
+ try {
481
+ this.entered = true;
482
+ this.reinitializeState();
483
+ this.doEncode(object, 1);
484
+ return this.bytes.subarray(0, this.pos);
485
+ }
486
+ finally {
487
+ this.entered = false;
488
+ }
489
+ }
490
+ /**
491
+ * @returns Encodes the object and returns a copy of the encoder's internal buffer.
492
+ */
493
+ encode(object) {
494
+ if (this.entered) {
495
+ const instance = this.clone();
496
+ return instance.encode(object);
497
+ }
498
+ try {
499
+ this.entered = true;
500
+ this.reinitializeState();
501
+ this.doEncode(object, 1);
502
+ return this.bytes.slice(0, this.pos);
503
+ }
504
+ finally {
505
+ this.entered = false;
506
+ }
507
+ }
508
+ doEncode(object, depth) {
509
+ if (depth > this.maxDepth) {
510
+ throw new Error(`Too deep objects in depth ${depth}`);
511
+ }
512
+ if (object == null) {
513
+ this.encodeNil();
514
+ }
515
+ else if (typeof object === "boolean") {
516
+ this.encodeBoolean(object);
517
+ }
518
+ else if (typeof object === "number") {
519
+ if (!this.forceIntegerToFloat) {
520
+ this.encodeNumber(object);
521
+ }
522
+ else {
523
+ this.encodeNumberAsFloat(object);
524
+ }
525
+ }
526
+ else if (typeof object === "string") {
527
+ this.encodeString(object);
528
+ }
529
+ else if (this.useBigInt64 && typeof object === "bigint") {
530
+ this.encodeBigInt64(object);
531
+ }
532
+ else {
533
+ this.encodeObject(object, depth);
534
+ }
535
+ }
536
+ ensureBufferSizeToWrite(sizeToWrite) {
537
+ const requiredSize = this.pos + sizeToWrite;
538
+ if (this.view.byteLength < requiredSize) {
539
+ this.resizeBuffer(requiredSize * 2);
540
+ }
541
+ }
542
+ resizeBuffer(newSize) {
543
+ const newBuffer = new ArrayBuffer(newSize);
544
+ const newBytes = new Uint8Array(newBuffer);
545
+ const newView = new DataView(newBuffer);
546
+ newBytes.set(this.bytes);
547
+ this.view = newView;
548
+ this.bytes = newBytes;
549
+ }
550
+ encodeNil() {
551
+ this.writeU8(0xc0);
552
+ }
553
+ encodeBoolean(object) {
554
+ if (object === false) {
555
+ this.writeU8(0xc2);
556
+ }
557
+ else {
558
+ this.writeU8(0xc3);
559
+ }
560
+ }
561
+ encodeNumber(object) {
562
+ if (!this.forceIntegerToFloat && Number.isSafeInteger(object)) {
563
+ if (object >= 0) {
564
+ if (object < 0x80) {
565
+ // positive fixint
566
+ this.writeU8(object);
567
+ }
568
+ else if (object < 0x100) {
569
+ // uint 8
570
+ this.writeU8(0xcc);
571
+ this.writeU8(object);
572
+ }
573
+ else if (object < 0x10000) {
574
+ // uint 16
575
+ this.writeU8(0xcd);
576
+ this.writeU16(object);
577
+ }
578
+ else if (object < 0x100000000) {
579
+ // uint 32
580
+ this.writeU8(0xce);
581
+ this.writeU32(object);
582
+ }
583
+ else if (!this.useBigInt64) {
584
+ // uint 64
585
+ this.writeU8(0xcf);
586
+ this.writeU64(object);
587
+ }
588
+ else {
589
+ this.encodeNumberAsFloat(object);
590
+ }
591
+ }
592
+ else {
593
+ if (object >= -32) {
594
+ // negative fixint
595
+ this.writeU8(0xe0 | (object + 0x20));
596
+ }
597
+ else if (object >= -128) {
598
+ // int 8
599
+ this.writeU8(0xd0);
600
+ this.writeI8(object);
601
+ }
602
+ else if (object >= -32768) {
603
+ // int 16
604
+ this.writeU8(0xd1);
605
+ this.writeI16(object);
606
+ }
607
+ else if (object >= -2147483648) {
608
+ // int 32
609
+ this.writeU8(0xd2);
610
+ this.writeI32(object);
611
+ }
612
+ else if (!this.useBigInt64) {
613
+ // int 64
614
+ this.writeU8(0xd3);
615
+ this.writeI64(object);
616
+ }
617
+ else {
618
+ this.encodeNumberAsFloat(object);
619
+ }
620
+ }
621
+ }
622
+ else {
623
+ this.encodeNumberAsFloat(object);
624
+ }
625
+ }
626
+ encodeNumberAsFloat(object) {
627
+ if (this.forceFloat32) {
628
+ // float 32
629
+ this.writeU8(0xca);
630
+ this.writeF32(object);
631
+ }
632
+ else {
633
+ // float 64
634
+ this.writeU8(0xcb);
635
+ this.writeF64(object);
636
+ }
637
+ }
638
+ encodeBigInt64(object) {
639
+ if (object >= BigInt(0)) {
640
+ // uint 64
641
+ this.writeU8(0xcf);
642
+ this.writeBigUint64(object);
643
+ }
644
+ else {
645
+ // int 64
646
+ this.writeU8(0xd3);
647
+ this.writeBigInt64(object);
648
+ }
649
+ }
650
+ writeStringHeader(byteLength) {
651
+ if (byteLength < 32) {
652
+ // fixstr
653
+ this.writeU8(0xa0 + byteLength);
654
+ }
655
+ else if (byteLength < 0x100) {
656
+ // str 8
657
+ this.writeU8(0xd9);
658
+ this.writeU8(byteLength);
659
+ }
660
+ else if (byteLength < 0x10000) {
661
+ // str 16
662
+ this.writeU8(0xda);
663
+ this.writeU16(byteLength);
664
+ }
665
+ else if (byteLength < 0x100000000) {
666
+ // str 32
667
+ this.writeU8(0xdb);
668
+ this.writeU32(byteLength);
669
+ }
670
+ else {
671
+ throw new Error(`Too long string: ${byteLength} bytes in UTF-8`);
672
+ }
673
+ }
674
+ encodeString(object) {
675
+ const maxHeaderSize = 1 + 4;
676
+ const byteLength = utf8Count(object);
677
+ this.ensureBufferSizeToWrite(maxHeaderSize + byteLength);
678
+ this.writeStringHeader(byteLength);
679
+ utf8Encode(object, this.bytes, this.pos);
680
+ this.pos += byteLength;
681
+ }
682
+ encodeObject(object, depth) {
683
+ // try to encode objects with custom codec first of non-primitives
684
+ const ext = this.extensionCodec.tryToEncode(object, this.context);
685
+ if (ext != null) {
686
+ this.encodeExtension(ext);
687
+ }
688
+ else if (Array.isArray(object)) {
689
+ this.encodeArray(object, depth);
690
+ }
691
+ else if (ArrayBuffer.isView(object)) {
692
+ this.encodeBinary(object);
693
+ }
694
+ else if (typeof object === "object") {
695
+ this.encodeMap(object, depth);
696
+ }
697
+ else {
698
+ // symbol, function and other special object come here unless extensionCodec handles them.
699
+ throw new Error(`Unrecognized object: ${Object.prototype.toString.apply(object)}`);
700
+ }
701
+ }
702
+ encodeBinary(object) {
703
+ const size = object.byteLength;
704
+ if (size < 0x100) {
705
+ // bin 8
706
+ this.writeU8(0xc4);
707
+ this.writeU8(size);
708
+ }
709
+ else if (size < 0x10000) {
710
+ // bin 16
711
+ this.writeU8(0xc5);
712
+ this.writeU16(size);
713
+ }
714
+ else if (size < 0x100000000) {
715
+ // bin 32
716
+ this.writeU8(0xc6);
717
+ this.writeU32(size);
718
+ }
719
+ else {
720
+ throw new Error(`Too large binary: ${size}`);
721
+ }
722
+ const bytes = ensureUint8Array(object);
723
+ this.writeU8a(bytes);
724
+ }
725
+ encodeArray(object, depth) {
726
+ const size = object.length;
727
+ if (size < 16) {
728
+ // fixarray
729
+ this.writeU8(0x90 + size);
730
+ }
731
+ else if (size < 0x10000) {
732
+ // array 16
733
+ this.writeU8(0xdc);
734
+ this.writeU16(size);
735
+ }
736
+ else if (size < 0x100000000) {
737
+ // array 32
738
+ this.writeU8(0xdd);
739
+ this.writeU32(size);
740
+ }
741
+ else {
742
+ throw new Error(`Too large array: ${size}`);
743
+ }
744
+ for (const item of object) {
745
+ this.doEncode(item, depth + 1);
746
+ }
747
+ }
748
+ countWithoutUndefined(object, keys) {
749
+ let count = 0;
750
+ for (const key of keys) {
751
+ if (object[key] !== undefined) {
752
+ count++;
753
+ }
754
+ }
755
+ return count;
756
+ }
757
+ encodeMap(object, depth) {
758
+ const keys = Object.keys(object);
759
+ if (this.sortKeys) {
760
+ keys.sort();
761
+ }
762
+ const size = this.ignoreUndefined ? this.countWithoutUndefined(object, keys) : keys.length;
763
+ if (size < 16) {
764
+ // fixmap
765
+ this.writeU8(0x80 + size);
766
+ }
767
+ else if (size < 0x10000) {
768
+ // map 16
769
+ this.writeU8(0xde);
770
+ this.writeU16(size);
771
+ }
772
+ else if (size < 0x100000000) {
773
+ // map 32
774
+ this.writeU8(0xdf);
775
+ this.writeU32(size);
776
+ }
777
+ else {
778
+ throw new Error(`Too large map object: ${size}`);
779
+ }
780
+ for (const key of keys) {
781
+ const value = object[key];
782
+ if (!(this.ignoreUndefined && value === undefined)) {
783
+ this.encodeString(key);
784
+ this.doEncode(value, depth + 1);
785
+ }
786
+ }
787
+ }
788
+ encodeExtension(ext) {
789
+ if (typeof ext.data === "function") {
790
+ const data = ext.data(this.pos + 6);
791
+ const size = data.length;
792
+ if (size >= 0x100000000) {
793
+ throw new Error(`Too large extension object: ${size}`);
794
+ }
795
+ this.writeU8(0xc9);
796
+ this.writeU32(size);
797
+ this.writeI8(ext.type);
798
+ this.writeU8a(data);
799
+ return;
800
+ }
801
+ const size = ext.data.length;
802
+ if (size === 1) {
803
+ // fixext 1
804
+ this.writeU8(0xd4);
805
+ }
806
+ else if (size === 2) {
807
+ // fixext 2
808
+ this.writeU8(0xd5);
809
+ }
810
+ else if (size === 4) {
811
+ // fixext 4
812
+ this.writeU8(0xd6);
813
+ }
814
+ else if (size === 8) {
815
+ // fixext 8
816
+ this.writeU8(0xd7);
817
+ }
818
+ else if (size === 16) {
819
+ // fixext 16
820
+ this.writeU8(0xd8);
821
+ }
822
+ else if (size < 0x100) {
823
+ // ext 8
824
+ this.writeU8(0xc7);
825
+ this.writeU8(size);
826
+ }
827
+ else if (size < 0x10000) {
828
+ // ext 16
829
+ this.writeU8(0xc8);
830
+ this.writeU16(size);
831
+ }
832
+ else if (size < 0x100000000) {
833
+ // ext 32
834
+ this.writeU8(0xc9);
835
+ this.writeU32(size);
836
+ }
837
+ else {
838
+ throw new Error(`Too large extension object: ${size}`);
839
+ }
840
+ this.writeI8(ext.type);
841
+ this.writeU8a(ext.data);
842
+ }
843
+ writeU8(value) {
844
+ this.ensureBufferSizeToWrite(1);
845
+ this.view.setUint8(this.pos, value);
846
+ this.pos++;
847
+ }
848
+ writeU8a(values) {
849
+ const size = values.length;
850
+ this.ensureBufferSizeToWrite(size);
851
+ this.bytes.set(values, this.pos);
852
+ this.pos += size;
853
+ }
854
+ writeI8(value) {
855
+ this.ensureBufferSizeToWrite(1);
856
+ this.view.setInt8(this.pos, value);
857
+ this.pos++;
858
+ }
859
+ writeU16(value) {
860
+ this.ensureBufferSizeToWrite(2);
861
+ this.view.setUint16(this.pos, value);
862
+ this.pos += 2;
863
+ }
864
+ writeI16(value) {
865
+ this.ensureBufferSizeToWrite(2);
866
+ this.view.setInt16(this.pos, value);
867
+ this.pos += 2;
868
+ }
869
+ writeU32(value) {
870
+ this.ensureBufferSizeToWrite(4);
871
+ this.view.setUint32(this.pos, value);
872
+ this.pos += 4;
873
+ }
874
+ writeI32(value) {
875
+ this.ensureBufferSizeToWrite(4);
876
+ this.view.setInt32(this.pos, value);
877
+ this.pos += 4;
878
+ }
879
+ writeF32(value) {
880
+ this.ensureBufferSizeToWrite(4);
881
+ this.view.setFloat32(this.pos, value);
882
+ this.pos += 4;
883
+ }
884
+ writeF64(value) {
885
+ this.ensureBufferSizeToWrite(8);
886
+ this.view.setFloat64(this.pos, value);
887
+ this.pos += 8;
888
+ }
889
+ writeU64(value) {
890
+ this.ensureBufferSizeToWrite(8);
891
+ setUint64(this.view, this.pos, value);
892
+ this.pos += 8;
893
+ }
894
+ writeI64(value) {
895
+ this.ensureBufferSizeToWrite(8);
896
+ setInt64(this.view, this.pos, value);
897
+ this.pos += 8;
898
+ }
899
+ writeBigUint64(value) {
900
+ this.ensureBufferSizeToWrite(8);
901
+ this.view.setBigUint64(this.pos, value);
902
+ this.pos += 8;
903
+ }
904
+ writeBigInt64(value) {
905
+ this.ensureBufferSizeToWrite(8);
906
+ this.view.setBigInt64(this.pos, value);
907
+ this.pos += 8;
908
+ }
909
+ }
910
+
911
+ /**
912
+ * It encodes `value` in the MessagePack format and
913
+ * returns a byte buffer.
914
+ *
915
+ * The returned buffer is a slice of a larger `ArrayBuffer`, so you have to use its `#byteOffset` and `#byteLength` in order to convert it to another typed arrays including NodeJS `Buffer`.
916
+ */
917
+ function encode(value, options) {
918
+ const encoder = new Encoder(options);
919
+ return encoder.encodeSharedRef(value);
920
+ }
921
+
922
+ function prettyByte(byte) {
923
+ return `${byte < 0 ? "-" : ""}0x${Math.abs(byte).toString(16).padStart(2, "0")}`;
924
+ }
925
+
926
+ const DEFAULT_MAX_KEY_LENGTH = 16;
927
+ const DEFAULT_MAX_LENGTH_PER_KEY = 16;
928
+ class CachedKeyDecoder {
929
+ constructor(maxKeyLength = DEFAULT_MAX_KEY_LENGTH, maxLengthPerKey = DEFAULT_MAX_LENGTH_PER_KEY) {
930
+ this.hit = 0;
931
+ this.miss = 0;
932
+ this.maxKeyLength = maxKeyLength;
933
+ this.maxLengthPerKey = maxLengthPerKey;
934
+ // avoid `new Array(N)`, which makes a sparse array,
935
+ // because a sparse array is typically slower than a non-sparse array.
936
+ this.caches = [];
937
+ for (let i = 0; i < this.maxKeyLength; i++) {
938
+ this.caches.push([]);
939
+ }
940
+ }
941
+ canBeCached(byteLength) {
942
+ return byteLength > 0 && byteLength <= this.maxKeyLength;
943
+ }
944
+ find(bytes, inputOffset, byteLength) {
945
+ const records = this.caches[byteLength - 1];
946
+ FIND_CHUNK: for (const record of records) {
947
+ const recordBytes = record.bytes;
948
+ for (let j = 0; j < byteLength; j++) {
949
+ if (recordBytes[j] !== bytes[inputOffset + j]) {
950
+ continue FIND_CHUNK;
951
+ }
952
+ }
953
+ return record.str;
954
+ }
955
+ return null;
956
+ }
957
+ store(bytes, value) {
958
+ const records = this.caches[bytes.length - 1];
959
+ const record = { bytes, str: value };
960
+ if (records.length >= this.maxLengthPerKey) {
961
+ // `records` are full!
962
+ // Set `record` to an arbitrary position.
963
+ records[(Math.random() * records.length) | 0] = record;
964
+ }
965
+ else {
966
+ records.push(record);
967
+ }
968
+ }
969
+ decode(bytes, inputOffset, byteLength) {
970
+ const cachedValue = this.find(bytes, inputOffset, byteLength);
971
+ if (cachedValue != null) {
972
+ this.hit++;
973
+ return cachedValue;
974
+ }
975
+ this.miss++;
976
+ const str = utf8DecodeJs(bytes, inputOffset, byteLength);
977
+ // Ensure to copy a slice of bytes because the bytes may be a NodeJS Buffer and Buffer#slice() returns a reference to its internal ArrayBuffer.
978
+ const slicedCopyOfBytes = Uint8Array.prototype.slice.call(bytes, inputOffset, inputOffset + byteLength);
979
+ this.store(slicedCopyOfBytes, str);
980
+ return str;
981
+ }
982
+ }
983
+
984
+ const STATE_ARRAY = "array";
985
+ const STATE_MAP_KEY = "map_key";
986
+ const STATE_MAP_VALUE = "map_value";
987
+ const mapKeyConverter = (key) => {
988
+ if (typeof key === "string" || typeof key === "number") {
989
+ return key;
990
+ }
991
+ throw new DecodeError("The type of key must be string or number but " + typeof key);
992
+ };
993
+ class StackPool {
994
+ constructor() {
995
+ this.stack = [];
996
+ this.stackHeadPosition = -1;
997
+ }
998
+ get length() {
999
+ return this.stackHeadPosition + 1;
1000
+ }
1001
+ top() {
1002
+ return this.stack[this.stackHeadPosition];
1003
+ }
1004
+ pushArrayState(size) {
1005
+ const state = this.getUninitializedStateFromPool();
1006
+ state.type = STATE_ARRAY;
1007
+ state.position = 0;
1008
+ state.size = size;
1009
+ state.array = new Array(size);
1010
+ }
1011
+ pushMapState(size) {
1012
+ const state = this.getUninitializedStateFromPool();
1013
+ state.type = STATE_MAP_KEY;
1014
+ state.readCount = 0;
1015
+ state.size = size;
1016
+ state.map = {};
1017
+ }
1018
+ getUninitializedStateFromPool() {
1019
+ this.stackHeadPosition++;
1020
+ if (this.stackHeadPosition === this.stack.length) {
1021
+ const partialState = {
1022
+ type: undefined,
1023
+ size: 0,
1024
+ array: undefined,
1025
+ position: 0,
1026
+ readCount: 0,
1027
+ map: undefined,
1028
+ key: null,
1029
+ };
1030
+ this.stack.push(partialState);
1031
+ }
1032
+ return this.stack[this.stackHeadPosition];
1033
+ }
1034
+ release(state) {
1035
+ const topStackState = this.stack[this.stackHeadPosition];
1036
+ if (topStackState !== state) {
1037
+ throw new Error("Invalid stack state. Released state is not on top of the stack.");
1038
+ }
1039
+ if (state.type === STATE_ARRAY) {
1040
+ const partialState = state;
1041
+ partialState.size = 0;
1042
+ partialState.array = undefined;
1043
+ partialState.position = 0;
1044
+ partialState.type = undefined;
1045
+ }
1046
+ if (state.type === STATE_MAP_KEY || state.type === STATE_MAP_VALUE) {
1047
+ const partialState = state;
1048
+ partialState.size = 0;
1049
+ partialState.map = undefined;
1050
+ partialState.readCount = 0;
1051
+ partialState.type = undefined;
1052
+ }
1053
+ this.stackHeadPosition--;
1054
+ }
1055
+ reset() {
1056
+ this.stack.length = 0;
1057
+ this.stackHeadPosition = -1;
1058
+ }
1059
+ }
1060
+ const HEAD_BYTE_REQUIRED = -1;
1061
+ const EMPTY_VIEW = new DataView(new ArrayBuffer(0));
1062
+ const EMPTY_BYTES = new Uint8Array(EMPTY_VIEW.buffer);
1063
+ try {
1064
+ // IE11: The spec says it should throw RangeError,
1065
+ // IE11: but in IE11 it throws TypeError.
1066
+ EMPTY_VIEW.getInt8(0);
1067
+ }
1068
+ catch (e) {
1069
+ if (!(e instanceof RangeError)) {
1070
+ throw new Error("This module is not supported in the current JavaScript engine because DataView does not throw RangeError on out-of-bounds access");
1071
+ }
1072
+ }
1073
+ const MORE_DATA = new RangeError("Insufficient data");
1074
+ const sharedCachedKeyDecoder = new CachedKeyDecoder();
1075
+ class Decoder {
1076
+ constructor(options) {
1077
+ this.totalPos = 0;
1078
+ this.pos = 0;
1079
+ this.view = EMPTY_VIEW;
1080
+ this.bytes = EMPTY_BYTES;
1081
+ this.headByte = HEAD_BYTE_REQUIRED;
1082
+ this.stack = new StackPool();
1083
+ this.entered = false;
1084
+ this.extensionCodec = options?.extensionCodec ?? ExtensionCodec.defaultCodec;
1085
+ this.context = options?.context; // needs a type assertion because EncoderOptions has no context property when ContextType is undefined
1086
+ this.useBigInt64 = options?.useBigInt64 ?? false;
1087
+ this.rawStrings = options?.rawStrings ?? false;
1088
+ this.maxStrLength = options?.maxStrLength ?? UINT32_MAX;
1089
+ this.maxBinLength = options?.maxBinLength ?? UINT32_MAX;
1090
+ this.maxArrayLength = options?.maxArrayLength ?? UINT32_MAX;
1091
+ this.maxMapLength = options?.maxMapLength ?? UINT32_MAX;
1092
+ this.maxExtLength = options?.maxExtLength ?? UINT32_MAX;
1093
+ this.keyDecoder = options?.keyDecoder !== undefined ? options.keyDecoder : sharedCachedKeyDecoder;
1094
+ this.mapKeyConverter = options?.mapKeyConverter ?? mapKeyConverter;
1095
+ }
1096
+ clone() {
1097
+ // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
1098
+ return new Decoder({
1099
+ extensionCodec: this.extensionCodec,
1100
+ context: this.context,
1101
+ useBigInt64: this.useBigInt64,
1102
+ rawStrings: this.rawStrings,
1103
+ maxStrLength: this.maxStrLength,
1104
+ maxBinLength: this.maxBinLength,
1105
+ maxArrayLength: this.maxArrayLength,
1106
+ maxMapLength: this.maxMapLength,
1107
+ maxExtLength: this.maxExtLength,
1108
+ keyDecoder: this.keyDecoder,
1109
+ });
1110
+ }
1111
+ reinitializeState() {
1112
+ this.totalPos = 0;
1113
+ this.headByte = HEAD_BYTE_REQUIRED;
1114
+ this.stack.reset();
1115
+ // view, bytes, and pos will be re-initialized in setBuffer()
1116
+ }
1117
+ setBuffer(buffer) {
1118
+ const bytes = ensureUint8Array(buffer);
1119
+ this.bytes = bytes;
1120
+ this.view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
1121
+ this.pos = 0;
1122
+ }
1123
+ appendBuffer(buffer) {
1124
+ if (this.headByte === HEAD_BYTE_REQUIRED && !this.hasRemaining(1)) {
1125
+ this.setBuffer(buffer);
1126
+ }
1127
+ else {
1128
+ const remainingData = this.bytes.subarray(this.pos);
1129
+ const newData = ensureUint8Array(buffer);
1130
+ // concat remainingData + newData
1131
+ const newBuffer = new Uint8Array(remainingData.length + newData.length);
1132
+ newBuffer.set(remainingData);
1133
+ newBuffer.set(newData, remainingData.length);
1134
+ this.setBuffer(newBuffer);
1135
+ }
1136
+ }
1137
+ hasRemaining(size) {
1138
+ return this.view.byteLength - this.pos >= size;
1139
+ }
1140
+ createExtraByteError(posToShow) {
1141
+ const { view, pos } = this;
1142
+ return new RangeError(`Extra ${view.byteLength - pos} of ${view.byteLength} byte(s) found at buffer[${posToShow}]`);
1143
+ }
1144
+ /**
1145
+ * @throws {@link DecodeError}
1146
+ * @throws {@link RangeError}
1147
+ */
1148
+ decode(buffer) {
1149
+ if (this.entered) {
1150
+ const instance = this.clone();
1151
+ return instance.decode(buffer);
1152
+ }
1153
+ try {
1154
+ this.entered = true;
1155
+ this.reinitializeState();
1156
+ this.setBuffer(buffer);
1157
+ const object = this.doDecodeSync();
1158
+ if (this.hasRemaining(1)) {
1159
+ throw this.createExtraByteError(this.pos);
1160
+ }
1161
+ return object;
1162
+ }
1163
+ finally {
1164
+ this.entered = false;
1165
+ }
1166
+ }
1167
+ *decodeMulti(buffer) {
1168
+ if (this.entered) {
1169
+ const instance = this.clone();
1170
+ yield* instance.decodeMulti(buffer);
1171
+ return;
1172
+ }
1173
+ try {
1174
+ this.entered = true;
1175
+ this.reinitializeState();
1176
+ this.setBuffer(buffer);
1177
+ while (this.hasRemaining(1)) {
1178
+ yield this.doDecodeSync();
1179
+ }
1180
+ }
1181
+ finally {
1182
+ this.entered = false;
1183
+ }
1184
+ }
1185
+ async decodeAsync(stream) {
1186
+ if (this.entered) {
1187
+ const instance = this.clone();
1188
+ return instance.decodeAsync(stream);
1189
+ }
1190
+ try {
1191
+ this.entered = true;
1192
+ let decoded = false;
1193
+ let object;
1194
+ for await (const buffer of stream) {
1195
+ if (decoded) {
1196
+ this.entered = false;
1197
+ throw this.createExtraByteError(this.totalPos);
1198
+ }
1199
+ this.appendBuffer(buffer);
1200
+ try {
1201
+ object = this.doDecodeSync();
1202
+ decoded = true;
1203
+ }
1204
+ catch (e) {
1205
+ if (!(e instanceof RangeError)) {
1206
+ throw e; // rethrow
1207
+ }
1208
+ // fallthrough
1209
+ }
1210
+ this.totalPos += this.pos;
1211
+ }
1212
+ if (decoded) {
1213
+ if (this.hasRemaining(1)) {
1214
+ throw this.createExtraByteError(this.totalPos);
1215
+ }
1216
+ return object;
1217
+ }
1218
+ const { headByte, pos, totalPos } = this;
1219
+ throw new RangeError(`Insufficient data in parsing ${prettyByte(headByte)} at ${totalPos} (${pos} in the current buffer)`);
1220
+ }
1221
+ finally {
1222
+ this.entered = false;
1223
+ }
1224
+ }
1225
+ decodeArrayStream(stream) {
1226
+ return this.decodeMultiAsync(stream, true);
1227
+ }
1228
+ decodeStream(stream) {
1229
+ return this.decodeMultiAsync(stream, false);
1230
+ }
1231
+ async *decodeMultiAsync(stream, isArray) {
1232
+ if (this.entered) {
1233
+ const instance = this.clone();
1234
+ yield* instance.decodeMultiAsync(stream, isArray);
1235
+ return;
1236
+ }
1237
+ try {
1238
+ this.entered = true;
1239
+ let isArrayHeaderRequired = isArray;
1240
+ let arrayItemsLeft = -1;
1241
+ for await (const buffer of stream) {
1242
+ if (isArray && arrayItemsLeft === 0) {
1243
+ throw this.createExtraByteError(this.totalPos);
1244
+ }
1245
+ this.appendBuffer(buffer);
1246
+ if (isArrayHeaderRequired) {
1247
+ arrayItemsLeft = this.readArraySize();
1248
+ isArrayHeaderRequired = false;
1249
+ this.complete();
1250
+ }
1251
+ try {
1252
+ while (true) {
1253
+ yield this.doDecodeSync();
1254
+ if (--arrayItemsLeft === 0) {
1255
+ break;
1256
+ }
1257
+ }
1258
+ }
1259
+ catch (e) {
1260
+ if (!(e instanceof RangeError)) {
1261
+ throw e; // rethrow
1262
+ }
1263
+ // fallthrough
1264
+ }
1265
+ this.totalPos += this.pos;
1266
+ }
1267
+ }
1268
+ finally {
1269
+ this.entered = false;
1270
+ }
1271
+ }
1272
+ doDecodeSync() {
1273
+ DECODE: while (true) {
1274
+ const headByte = this.readHeadByte();
1275
+ let object;
1276
+ if (headByte >= 0xe0) {
1277
+ // negative fixint (111x xxxx) 0xe0 - 0xff
1278
+ object = headByte - 0x100;
1279
+ }
1280
+ else if (headByte < 0xc0) {
1281
+ if (headByte < 0x80) {
1282
+ // positive fixint (0xxx xxxx) 0x00 - 0x7f
1283
+ object = headByte;
1284
+ }
1285
+ else if (headByte < 0x90) {
1286
+ // fixmap (1000 xxxx) 0x80 - 0x8f
1287
+ const size = headByte - 0x80;
1288
+ if (size !== 0) {
1289
+ this.pushMapState(size);
1290
+ this.complete();
1291
+ continue DECODE;
1292
+ }
1293
+ else {
1294
+ object = {};
1295
+ }
1296
+ }
1297
+ else if (headByte < 0xa0) {
1298
+ // fixarray (1001 xxxx) 0x90 - 0x9f
1299
+ const size = headByte - 0x90;
1300
+ if (size !== 0) {
1301
+ this.pushArrayState(size);
1302
+ this.complete();
1303
+ continue DECODE;
1304
+ }
1305
+ else {
1306
+ object = [];
1307
+ }
1308
+ }
1309
+ else {
1310
+ // fixstr (101x xxxx) 0xa0 - 0xbf
1311
+ const byteLength = headByte - 0xa0;
1312
+ object = this.decodeString(byteLength, 0);
1313
+ }
1314
+ }
1315
+ else if (headByte === 0xc0) {
1316
+ // nil
1317
+ object = null;
1318
+ }
1319
+ else if (headByte === 0xc2) {
1320
+ // false
1321
+ object = false;
1322
+ }
1323
+ else if (headByte === 0xc3) {
1324
+ // true
1325
+ object = true;
1326
+ }
1327
+ else if (headByte === 0xca) {
1328
+ // float 32
1329
+ object = this.readF32();
1330
+ }
1331
+ else if (headByte === 0xcb) {
1332
+ // float 64
1333
+ object = this.readF64();
1334
+ }
1335
+ else if (headByte === 0xcc) {
1336
+ // uint 8
1337
+ object = this.readU8();
1338
+ }
1339
+ else if (headByte === 0xcd) {
1340
+ // uint 16
1341
+ object = this.readU16();
1342
+ }
1343
+ else if (headByte === 0xce) {
1344
+ // uint 32
1345
+ object = this.readU32();
1346
+ }
1347
+ else if (headByte === 0xcf) {
1348
+ // uint 64
1349
+ if (this.useBigInt64) {
1350
+ object = this.readU64AsBigInt();
1351
+ }
1352
+ else {
1353
+ object = this.readU64();
1354
+ }
1355
+ }
1356
+ else if (headByte === 0xd0) {
1357
+ // int 8
1358
+ object = this.readI8();
1359
+ }
1360
+ else if (headByte === 0xd1) {
1361
+ // int 16
1362
+ object = this.readI16();
1363
+ }
1364
+ else if (headByte === 0xd2) {
1365
+ // int 32
1366
+ object = this.readI32();
1367
+ }
1368
+ else if (headByte === 0xd3) {
1369
+ // int 64
1370
+ if (this.useBigInt64) {
1371
+ object = this.readI64AsBigInt();
1372
+ }
1373
+ else {
1374
+ object = this.readI64();
1375
+ }
1376
+ }
1377
+ else if (headByte === 0xd9) {
1378
+ // str 8
1379
+ const byteLength = this.lookU8();
1380
+ object = this.decodeString(byteLength, 1);
1381
+ }
1382
+ else if (headByte === 0xda) {
1383
+ // str 16
1384
+ const byteLength = this.lookU16();
1385
+ object = this.decodeString(byteLength, 2);
1386
+ }
1387
+ else if (headByte === 0xdb) {
1388
+ // str 32
1389
+ const byteLength = this.lookU32();
1390
+ object = this.decodeString(byteLength, 4);
1391
+ }
1392
+ else if (headByte === 0xdc) {
1393
+ // array 16
1394
+ const size = this.readU16();
1395
+ if (size !== 0) {
1396
+ this.pushArrayState(size);
1397
+ this.complete();
1398
+ continue DECODE;
1399
+ }
1400
+ else {
1401
+ object = [];
1402
+ }
1403
+ }
1404
+ else if (headByte === 0xdd) {
1405
+ // array 32
1406
+ const size = this.readU32();
1407
+ if (size !== 0) {
1408
+ this.pushArrayState(size);
1409
+ this.complete();
1410
+ continue DECODE;
1411
+ }
1412
+ else {
1413
+ object = [];
1414
+ }
1415
+ }
1416
+ else if (headByte === 0xde) {
1417
+ // map 16
1418
+ const size = this.readU16();
1419
+ if (size !== 0) {
1420
+ this.pushMapState(size);
1421
+ this.complete();
1422
+ continue DECODE;
1423
+ }
1424
+ else {
1425
+ object = {};
1426
+ }
1427
+ }
1428
+ else if (headByte === 0xdf) {
1429
+ // map 32
1430
+ const size = this.readU32();
1431
+ if (size !== 0) {
1432
+ this.pushMapState(size);
1433
+ this.complete();
1434
+ continue DECODE;
1435
+ }
1436
+ else {
1437
+ object = {};
1438
+ }
1439
+ }
1440
+ else if (headByte === 0xc4) {
1441
+ // bin 8
1442
+ const size = this.lookU8();
1443
+ object = this.decodeBinary(size, 1);
1444
+ }
1445
+ else if (headByte === 0xc5) {
1446
+ // bin 16
1447
+ const size = this.lookU16();
1448
+ object = this.decodeBinary(size, 2);
1449
+ }
1450
+ else if (headByte === 0xc6) {
1451
+ // bin 32
1452
+ const size = this.lookU32();
1453
+ object = this.decodeBinary(size, 4);
1454
+ }
1455
+ else if (headByte === 0xd4) {
1456
+ // fixext 1
1457
+ object = this.decodeExtension(1, 0);
1458
+ }
1459
+ else if (headByte === 0xd5) {
1460
+ // fixext 2
1461
+ object = this.decodeExtension(2, 0);
1462
+ }
1463
+ else if (headByte === 0xd6) {
1464
+ // fixext 4
1465
+ object = this.decodeExtension(4, 0);
1466
+ }
1467
+ else if (headByte === 0xd7) {
1468
+ // fixext 8
1469
+ object = this.decodeExtension(8, 0);
1470
+ }
1471
+ else if (headByte === 0xd8) {
1472
+ // fixext 16
1473
+ object = this.decodeExtension(16, 0);
1474
+ }
1475
+ else if (headByte === 0xc7) {
1476
+ // ext 8
1477
+ const size = this.lookU8();
1478
+ object = this.decodeExtension(size, 1);
1479
+ }
1480
+ else if (headByte === 0xc8) {
1481
+ // ext 16
1482
+ const size = this.lookU16();
1483
+ object = this.decodeExtension(size, 2);
1484
+ }
1485
+ else if (headByte === 0xc9) {
1486
+ // ext 32
1487
+ const size = this.lookU32();
1488
+ object = this.decodeExtension(size, 4);
1489
+ }
1490
+ else {
1491
+ throw new DecodeError(`Unrecognized type byte: ${prettyByte(headByte)}`);
1492
+ }
1493
+ this.complete();
1494
+ const stack = this.stack;
1495
+ while (stack.length > 0) {
1496
+ // arrays and maps
1497
+ const state = stack.top();
1498
+ if (state.type === STATE_ARRAY) {
1499
+ state.array[state.position] = object;
1500
+ state.position++;
1501
+ if (state.position === state.size) {
1502
+ object = state.array;
1503
+ stack.release(state);
1504
+ }
1505
+ else {
1506
+ continue DECODE;
1507
+ }
1508
+ }
1509
+ else if (state.type === STATE_MAP_KEY) {
1510
+ if (object === "__proto__") {
1511
+ throw new DecodeError("The key __proto__ is not allowed");
1512
+ }
1513
+ state.key = this.mapKeyConverter(object);
1514
+ state.type = STATE_MAP_VALUE;
1515
+ continue DECODE;
1516
+ }
1517
+ else {
1518
+ // it must be `state.type === State.MAP_VALUE` here
1519
+ state.map[state.key] = object;
1520
+ state.readCount++;
1521
+ if (state.readCount === state.size) {
1522
+ object = state.map;
1523
+ stack.release(state);
1524
+ }
1525
+ else {
1526
+ state.key = null;
1527
+ state.type = STATE_MAP_KEY;
1528
+ continue DECODE;
1529
+ }
1530
+ }
1531
+ }
1532
+ return object;
1533
+ }
1534
+ }
1535
+ readHeadByte() {
1536
+ if (this.headByte === HEAD_BYTE_REQUIRED) {
1537
+ this.headByte = this.readU8();
1538
+ // console.log("headByte", prettyByte(this.headByte));
1539
+ }
1540
+ return this.headByte;
1541
+ }
1542
+ complete() {
1543
+ this.headByte = HEAD_BYTE_REQUIRED;
1544
+ }
1545
+ readArraySize() {
1546
+ const headByte = this.readHeadByte();
1547
+ switch (headByte) {
1548
+ case 0xdc:
1549
+ return this.readU16();
1550
+ case 0xdd:
1551
+ return this.readU32();
1552
+ default: {
1553
+ if (headByte < 0xa0) {
1554
+ return headByte - 0x90;
1555
+ }
1556
+ else {
1557
+ throw new DecodeError(`Unrecognized array type byte: ${prettyByte(headByte)}`);
1558
+ }
1559
+ }
1560
+ }
1561
+ }
1562
+ pushMapState(size) {
1563
+ if (size > this.maxMapLength) {
1564
+ throw new DecodeError(`Max length exceeded: map length (${size}) > maxMapLengthLength (${this.maxMapLength})`);
1565
+ }
1566
+ this.stack.pushMapState(size);
1567
+ }
1568
+ pushArrayState(size) {
1569
+ if (size > this.maxArrayLength) {
1570
+ throw new DecodeError(`Max length exceeded: array length (${size}) > maxArrayLength (${this.maxArrayLength})`);
1571
+ }
1572
+ this.stack.pushArrayState(size);
1573
+ }
1574
+ decodeString(byteLength, headerOffset) {
1575
+ if (!this.rawStrings || this.stateIsMapKey()) {
1576
+ return this.decodeUtf8String(byteLength, headerOffset);
1577
+ }
1578
+ return this.decodeBinary(byteLength, headerOffset);
1579
+ }
1580
+ /**
1581
+ * @throws {@link RangeError}
1582
+ */
1583
+ decodeUtf8String(byteLength, headerOffset) {
1584
+ if (byteLength > this.maxStrLength) {
1585
+ throw new DecodeError(`Max length exceeded: UTF-8 byte length (${byteLength}) > maxStrLength (${this.maxStrLength})`);
1586
+ }
1587
+ if (this.bytes.byteLength < this.pos + headerOffset + byteLength) {
1588
+ throw MORE_DATA;
1589
+ }
1590
+ const offset = this.pos + headerOffset;
1591
+ let object;
1592
+ if (this.stateIsMapKey() && this.keyDecoder?.canBeCached(byteLength)) {
1593
+ object = this.keyDecoder.decode(this.bytes, offset, byteLength);
1594
+ }
1595
+ else {
1596
+ object = utf8Decode(this.bytes, offset, byteLength);
1597
+ }
1598
+ this.pos += headerOffset + byteLength;
1599
+ return object;
1600
+ }
1601
+ stateIsMapKey() {
1602
+ if (this.stack.length > 0) {
1603
+ const state = this.stack.top();
1604
+ return state.type === STATE_MAP_KEY;
1605
+ }
1606
+ return false;
1607
+ }
1608
+ /**
1609
+ * @throws {@link RangeError}
1610
+ */
1611
+ decodeBinary(byteLength, headOffset) {
1612
+ if (byteLength > this.maxBinLength) {
1613
+ throw new DecodeError(`Max length exceeded: bin length (${byteLength}) > maxBinLength (${this.maxBinLength})`);
1614
+ }
1615
+ if (!this.hasRemaining(byteLength + headOffset)) {
1616
+ throw MORE_DATA;
1617
+ }
1618
+ const offset = this.pos + headOffset;
1619
+ const object = this.bytes.subarray(offset, offset + byteLength);
1620
+ this.pos += headOffset + byteLength;
1621
+ return object;
1622
+ }
1623
+ decodeExtension(size, headOffset) {
1624
+ if (size > this.maxExtLength) {
1625
+ throw new DecodeError(`Max length exceeded: ext length (${size}) > maxExtLength (${this.maxExtLength})`);
1626
+ }
1627
+ const extType = this.view.getInt8(this.pos + headOffset);
1628
+ const data = this.decodeBinary(size, headOffset + 1 /* extType */);
1629
+ return this.extensionCodec.decode(data, extType, this.context);
1630
+ }
1631
+ lookU8() {
1632
+ return this.view.getUint8(this.pos);
1633
+ }
1634
+ lookU16() {
1635
+ return this.view.getUint16(this.pos);
1636
+ }
1637
+ lookU32() {
1638
+ return this.view.getUint32(this.pos);
1639
+ }
1640
+ readU8() {
1641
+ const value = this.view.getUint8(this.pos);
1642
+ this.pos++;
1643
+ return value;
1644
+ }
1645
+ readI8() {
1646
+ const value = this.view.getInt8(this.pos);
1647
+ this.pos++;
1648
+ return value;
1649
+ }
1650
+ readU16() {
1651
+ const value = this.view.getUint16(this.pos);
1652
+ this.pos += 2;
1653
+ return value;
1654
+ }
1655
+ readI16() {
1656
+ const value = this.view.getInt16(this.pos);
1657
+ this.pos += 2;
1658
+ return value;
1659
+ }
1660
+ readU32() {
1661
+ const value = this.view.getUint32(this.pos);
1662
+ this.pos += 4;
1663
+ return value;
1664
+ }
1665
+ readI32() {
1666
+ const value = this.view.getInt32(this.pos);
1667
+ this.pos += 4;
1668
+ return value;
1669
+ }
1670
+ readU64() {
1671
+ const value = getUint64(this.view, this.pos);
1672
+ this.pos += 8;
1673
+ return value;
1674
+ }
1675
+ readI64() {
1676
+ const value = getInt64(this.view, this.pos);
1677
+ this.pos += 8;
1678
+ return value;
1679
+ }
1680
+ readU64AsBigInt() {
1681
+ const value = this.view.getBigUint64(this.pos);
1682
+ this.pos += 8;
1683
+ return value;
1684
+ }
1685
+ readI64AsBigInt() {
1686
+ const value = this.view.getBigInt64(this.pos);
1687
+ this.pos += 8;
1688
+ return value;
1689
+ }
1690
+ readF32() {
1691
+ const value = this.view.getFloat32(this.pos);
1692
+ this.pos += 4;
1693
+ return value;
1694
+ }
1695
+ readF64() {
1696
+ const value = this.view.getFloat64(this.pos);
1697
+ this.pos += 8;
1698
+ return value;
1699
+ }
1700
+ }
1701
+
1702
+ /**
1703
+ * It decodes a single MessagePack object in a buffer.
1704
+ *
1705
+ * This is a synchronous decoding function.
1706
+ * See other variants for asynchronous decoding: {@link decodeAsync}, {@link decodeStream}, or {@link decodeArrayStream}.
1707
+ *
1708
+ * @throws {@link RangeError} if the buffer is incomplete, including the case where the buffer is empty.
1709
+ * @throws {@link DecodeError} if the buffer contains invalid data.
1710
+ */
1711
+ function decode(buffer, options) {
1712
+ const decoder = new Decoder(options);
1713
+ return decoder.decode(buffer);
1714
+ }
1715
+ /**
1716
+ * It decodes multiple MessagePack objects in a buffer.
1717
+ * This is corresponding to {@link decodeMultiStream}.
1718
+ *
1719
+ * @throws {@link RangeError} if the buffer is incomplete, including the case where the buffer is empty.
1720
+ * @throws {@link DecodeError} if the buffer contains invalid data.
1721
+ */
1722
+ function decodeMulti(buffer, options) {
1723
+ const decoder = new Decoder(options);
1724
+ return decoder.decodeMulti(buffer);
1725
+ }
1726
+
1727
+ // utility for whatwg streams
1728
+ function isAsyncIterable(object) {
1729
+ return object[Symbol.asyncIterator] != null;
1730
+ }
1731
+ async function* asyncIterableFromStream(stream) {
1732
+ const reader = stream.getReader();
1733
+ try {
1734
+ while (true) {
1735
+ const { done, value } = await reader.read();
1736
+ if (done) {
1737
+ return;
1738
+ }
1739
+ yield value;
1740
+ }
1741
+ }
1742
+ finally {
1743
+ reader.releaseLock();
1744
+ }
1745
+ }
1746
+ function ensureAsyncIterable(streamLike) {
1747
+ if (isAsyncIterable(streamLike)) {
1748
+ return streamLike;
1749
+ }
1750
+ else {
1751
+ return asyncIterableFromStream(streamLike);
1752
+ }
1753
+ }
1754
+
1755
+ /**
1756
+ * @throws {@link RangeError} if the buffer is incomplete, including the case where the buffer is empty.
1757
+ * @throws {@link DecodeError} if the buffer contains invalid data.
1758
+ */
1759
+ async function decodeAsync(streamLike, options) {
1760
+ const stream = ensureAsyncIterable(streamLike);
1761
+ const decoder = new Decoder(options);
1762
+ return decoder.decodeAsync(stream);
1763
+ }
1764
+ /**
1765
+ * @throws {@link RangeError} if the buffer is incomplete, including the case where the buffer is empty.
1766
+ * @throws {@link DecodeError} if the buffer contains invalid data.
1767
+ */
1768
+ function decodeArrayStream(streamLike, options) {
1769
+ const stream = ensureAsyncIterable(streamLike);
1770
+ const decoder = new Decoder(options);
1771
+ return decoder.decodeArrayStream(stream);
1772
+ }
1773
+ /**
1774
+ * @throws {@link RangeError} if the buffer is incomplete, including the case where the buffer is empty.
1775
+ * @throws {@link DecodeError} if the buffer contains invalid data.
1776
+ */
1777
+ function decodeMultiStream(streamLike, options) {
1778
+ const stream = ensureAsyncIterable(streamLike);
1779
+ const decoder = new Decoder(options);
1780
+ return decoder.decodeStream(stream);
1781
+ }
1782
+
1783
+ // Main Functions:
1784
+
1785
+ var dist_esm = /*#__PURE__*/Object.freeze({
1786
+ __proto__: null,
1787
+ DecodeError: DecodeError,
1788
+ Decoder: Decoder,
1789
+ EXT_TIMESTAMP: EXT_TIMESTAMP,
1790
+ Encoder: Encoder,
1791
+ ExtData: ExtData,
1792
+ ExtensionCodec: ExtensionCodec,
1793
+ decode: decode,
1794
+ decodeArrayStream: decodeArrayStream,
1795
+ decodeAsync: decodeAsync,
1796
+ decodeMulti: decodeMulti,
1797
+ decodeMultiStream: decodeMultiStream,
1798
+ decodeTimestampExtension: decodeTimestampExtension,
1799
+ decodeTimestampToTimeSpec: decodeTimestampToTimeSpec,
1800
+ encode: encode,
1801
+ encodeDateToTimeSpec: encodeDateToTimeSpec,
1802
+ encodeTimeSpecToTimestamp: encodeTimeSpecToTimestamp,
1803
+ encodeTimestampExtension: encodeTimestampExtension
1804
+ });
1805
+
1806
+ var require$$2 = /*@__PURE__*/getAugmentedNamespace(dist_esm);
1807
+
1808
+ var crdtManager;
1809
+ var hasRequiredCrdtManager;
1810
+
1811
+ function requireCrdtManager () {
1812
+ if (hasRequiredCrdtManager) return crdtManager;
1813
+ hasRequiredCrdtManager = 1;
1814
+ // Custom conflict-free replicated data type system with vector clocks
1815
+
1816
+ const CONSOLE_PREFIX = "CRDT Manager: ";
1817
+
1818
+ class CRDTManager {
1819
+ // Storage
1820
+ #replicaId;
1821
+ #keyOperations = new Map();
1822
+
1823
+ // Vector clock
1824
+ #vectorClock = new Map();
1825
+
1826
+ // Local only
1827
+ #propertyStore = {}; // Current local values per key, as object
1828
+ #lastPropertyStore = {}; // Last property store to compare against
1829
+
1830
+ // Local Garbage Collection
1831
+ #lastGCCheck = 0;
1832
+ #opUuuidTimestamp = new Map(); // Map every operation to a timestamp for garbage collection
1833
+
1834
+ /**
1835
+ * Create a new instance
1836
+ * @param {string} [replicaId] - Choose a uuid (falls back to random uuid)
1837
+ */
1838
+ constructor(replicaId) {
1839
+ this.#replicaId = replicaId || crypto.randomUUID();
1840
+ this.#vectorClock.set(this.#replicaId, 0);
1841
+ }
1842
+
1843
+ /**
1844
+ * Import the entire state of the CRDT manager (this overwrites the old state)
1845
+ * @param {Object} state
1846
+ */
1847
+ importState(state) {
1848
+ try {
1849
+ const { keyOperations, vectorClock } = state;
1850
+
1851
+ this.#opUuuidTimestamp.clear(); // Reset the uuid timestamps since it might contain uuid's that no longer exist in the new state
1852
+ this.#keyOperations = new Map(keyOperations); // Rebuild the map
1853
+ this.#vectorClock = new Map(vectorClock); // Also rebuild the map here
1854
+ if (!this.#vectorClock.has(this.#replicaId)) this.#vectorClock.set(this.#replicaId, 0); // Reset own vector clock if it wasn't present in the imported state
1855
+
1856
+ // Map operation uuids to timestamp
1857
+ this.#keyOperations.forEach((value, key) => {
1858
+ value?.forEach((operation) => {
1859
+ this.#opUuuidTimestamp.set(operation?.uuid, Date.now());
1860
+ });
1861
+ });
1862
+
1863
+ // Process each key to update local values
1864
+ for (const key of this.#keyOperations.keys()) this.#processLocalProperty(key);
1865
+
1866
+ } catch (error) {
1867
+ console.error(CONSOLE_PREFIX + "Failed to import state:", error);
1868
+ }
1869
+ }
1870
+
1871
+ /**
1872
+ * Export only the last operation of a property for a single key
1873
+ * This can still be imported using importProperty
1874
+ * @param {string} key
1875
+ * @returns {Object} - Data export
1876
+ */
1877
+ exportPropertyLastOpOnly(key) {
1878
+ const lastOp = this.#keyOperations.get(key)?.[this.#keyOperations.get(key)?.length - 1];
1879
+ return {
1880
+ key,
1881
+ operations: lastOp ? [lastOp] : [],
1882
+ vectorClock: Array.from(this.#vectorClock.entries())
1883
+ };
1884
+ }
1885
+
1886
+ /**
1887
+ * Export property for a single key
1888
+ * @param {string} key
1889
+ * @returns {Object} - Data export
1890
+ */
1891
+ exportProperty(key) {
1892
+ return {
1893
+ key,
1894
+ operations: [...(this.#keyOperations.get(key) || [])],
1895
+ vectorClock: Array.from(this.#vectorClock.entries())
1896
+ };
1897
+ }
1898
+
1899
+ /**
1900
+ * Import property for a single key and merge changes
1901
+ * @param {Object} data - Data to import
1902
+ */
1903
+ importProperty(data) {
1904
+ try {
1905
+ const { key, operations, vectorClock } = data;
1906
+
1907
+ // Get COPY of current ops (or empty array if none yet)
1908
+ const currentOps = [...(this.#keyOperations.get(key) || [])];
1909
+
1910
+ // Merge vector clocks (always take max value)
1911
+ if (vectorClock) {
1912
+ for (const [id, counter] of vectorClock) {
1913
+ if (!this.#vectorClock.has(id) || this.#vectorClock.get(id) < counter) {
1914
+ this.#vectorClock.set(id, counter);
1915
+ }
1916
+ }
1917
+ }
1918
+
1919
+ // Safeguard against attack where new clients would rapidly connect and disconnect to fill up the vectorClock
1920
+ if (this.#vectorClock.size > 1000) this.#vectorClock = new Map([...this.#vectorClock].slice(-100));
1921
+
1922
+ // Add new operations (diff) in correct order
1923
+ const existingUuids = new Set(currentOps.map(op => op.uuid));
1924
+ if (operations?.length) {
1925
+ for (const op of operations) {
1926
+ if (op?.uuid && !existingUuids.has(op.uuid)) {
1927
+ currentOps.push({ ...op }); // Add operation
1928
+ this.#opUuuidTimestamp.set(op?.uuid, Date.now()); // Add timestamp for gc
1929
+ }
1930
+ }
1931
+ }
1932
+
1933
+ // Sort, update operations & local value
1934
+ this.#keyOperations.set(key, this.#sortByVectorClock(currentOps));
1935
+ this.#processLocalProperty(key);
1936
+
1937
+ this.#checkGarbageCollection(); // Check if GC should run
1938
+
1939
+ } catch (error) {
1940
+ console.error(CONSOLE_PREFIX + "Failed to import property:", error);
1941
+ }
1942
+ }
1943
+
1944
+ /**
1945
+ * Update a property
1946
+ * @param {string} key
1947
+ * @param {string} operation
1948
+ * @param {*} value
1949
+ * @param {*} updateValue
1950
+ */
1951
+ updateProperty(key, operation, value, updateValue) {
1952
+ try {
1953
+ // Increment vector clock
1954
+ const counter = this.#vectorClock.get(this.#replicaId) || 0;
1955
+ this.#vectorClock.set(this.#replicaId, counter + 1);
1956
+
1957
+ // Assign shallow COPY of currennt ops or fall back to empty array
1958
+ const currentOps = [...(this.#keyOperations.get(key) || [])];
1959
+
1960
+ // Add operation
1961
+ const newOp = this.#createOperation({ operation, value, updateValue }, Array.from(this.#vectorClock.entries()));
1962
+ currentOps.push(newOp);
1963
+
1964
+ // Sort and process
1965
+ this.#keyOperations.set(key, this.#sortByVectorClock(currentOps));
1966
+ this.#opUuuidTimestamp.set(newOp.uuid, Date.now());
1967
+ this.#processLocalProperty(key);
1968
+
1969
+ this.#checkGarbageCollection(); // Check if GC should run
1970
+
1971
+ } catch (error) {
1972
+ console.error(CONSOLE_PREFIX + `Failed to add operation for key "${key}":`, error);
1973
+ }
1974
+ }
1975
+
1976
+ #checkGarbageCollection() {
1977
+ const MIN_GC_DELAY = 1000; // Minimum 1s delay between garbage collection runs
1978
+ const MIN_AGE_FOR_GC = 5000; // Garbage collect ops that are older than 5s
1979
+
1980
+ if (Date.now() - this.#lastGCCheck < MIN_GC_DELAY) return;
1981
+ this.#lastGCCheck = Date.now();
1982
+
1983
+ for (const [key, operations] of this.#keyOperations.entries()) {
1984
+ if (operations?.length < 5) continue; // Min op amount per key for garbage collection to run (otherwise not worth it)
1985
+
1986
+ let retainCount = operations.length;
1987
+ operations.forEach((op, index) => {
1988
+ // Count how many ops, from last to latest, are >10s old in a row
1989
+ if (op.uuid && this.#opUuuidTimestamp.has(op.uuid) && (Date.now() - this.#opUuuidTimestamp.get(op.uuid)) > MIN_AGE_FOR_GC) {
1990
+ const removeCount = index + 1;
1991
+ retainCount = operations.length - removeCount;
1992
+ this.#opUuuidTimestamp.delete(op.uuid); // Remove from timestamps if set to be deleted
1993
+ }
1994
+ });
1995
+
1996
+ if (retainCount < operations.length) {
1997
+ const retainOps = operations.slice(-retainCount); // newest ops
1998
+ const removeOps = operations.slice(0, -retainCount); // oldest ops (start = idx 0, end = retainCount counted from right side)
1999
+ const baselineVectorClock = removeOps[removeOps.length - 1]?.vectorClock || []; // Use the vector clock from the last operation that we remove/overwrite
2000
+
2001
+ // Calculate the value at the point where retained operations start
2002
+ let baselineValue = null;
2003
+ for (const op of removeOps) {
2004
+ if (!op.data) continue;
2005
+ if (op.data.operation.startsWith('array') && !Array.isArray(baselineValue)) baselineValue = []; // Initialize array if required
2006
+ baselineValue = this.#handleOperation(
2007
+ baselineValue,
2008
+ op.data.operation,
2009
+ op.data.value,
2010
+ op.data.updateValue
2011
+ );
2012
+ }
2013
+
2014
+ // Create a compact operation with baseline value and appropriate vector clock
2015
+ const compactOp = this.#createOperation({ operation: "set", value: baselineValue }, baselineVectorClock);
2016
+
2017
+ // Combine compact op with retained operations
2018
+ this.#keyOperations.set(key, [compactOp, ...retainOps]);
2019
+ }
2020
+ }
2021
+ }
2022
+
2023
+ /**
2024
+ * Create an operation object
2025
+ * @param {Object} data
2026
+ * @param {Array} vectorClock
2027
+ * @returns {Object} - Operation object
2028
+ */
2029
+ #createOperation(data, vectorClock) {
2030
+ const newOperation = {
2031
+ data,
2032
+ vectorClock,
2033
+ source: this.#replicaId,
2034
+ uuid: crypto.randomUUID()
2035
+ };
2036
+ this.#opUuuidTimestamp.set(newOperation.uuid, Date.now());
2037
+ return newOperation;
2038
+ }
2039
+
2040
+ /**
2041
+ * Process a property's value by applying all operations and set it in the property store
2042
+ * @param {string} key
2043
+ */
2044
+ #processLocalProperty(key) {
2045
+ try {
2046
+ const ops = this.#keyOperations.get(key);
2047
+ if (!ops?.length) return;
2048
+
2049
+ // Apply all operations in order
2050
+ let value = null;
2051
+
2052
+ for (const op of ops) {
2053
+ if (!op.data) continue;
2054
+ if (op.data.operation.startsWith('array') && !Array.isArray(value)) value = []; // Initialize array if required
2055
+ value = this.#handleOperation(
2056
+ value,
2057
+ op.data.operation,
2058
+ op.data.value,
2059
+ op.data.updateValue
2060
+ );
2061
+ }
2062
+
2063
+ this.#propertyStore[key] = value; // Save locally
2064
+ } catch (error) {
2065
+ console.error(CONSOLE_PREFIX + `Failed to process property for "${key}":`, error);
2066
+ }
2067
+ }
2068
+
2069
+ // Sort by vector clock (causal order)
2070
+ #sortByVectorClock(operations) {
2071
+ return [...operations].sort((a, b) => {
2072
+ const clockA = new Map(a.vectorClock || []);
2073
+ const clockB = new Map(b.vectorClock || []);
2074
+
2075
+ // First sort by causal relationship
2076
+ let aGreater = false, bGreater = false;
2077
+
2078
+ const allIds = new Set([...clockA.keys(), ...clockB.keys()]);
2079
+ for (const id of allIds) {
2080
+ const countA = clockA.get(id) || 0;
2081
+ const countB = clockB.get(id) || 0;
2082
+
2083
+ if (countA > countB) aGreater = true;
2084
+ if (countA < countB) bGreater = true;
2085
+ }
2086
+
2087
+ // Determine causal relationship (if one is greater, and the other is smaller, it's clear)
2088
+ if (aGreater && !bGreater) return 1; // a happens after b
2089
+ if (!aGreater && bGreater) return -1; // a happens before b
2090
+
2091
+ // Concurrent (unclear): Compare highest counter in each (sort by which one is ahead)
2092
+ const maxA = Math.max(...Array.from(clockA.values()), 0);
2093
+ const maxB = Math.max(...Array.from(clockB.values()), 0);
2094
+ if (maxA !== maxB) return maxA - maxB;
2095
+
2096
+ // Final tiebreak: Sort by ID of Replica that actually generated the operation
2097
+ return a.source.localeCompare(b.source);
2098
+ });
2099
+ }
2100
+
2101
+ // Handle an operation
2102
+ #handleOperation(curValue, operation, value, updateValue) {
2103
+ try {
2104
+ // Clone to avoid reference issues
2105
+ curValue = JSON.parse(JSON.stringify(curValue || null));
2106
+
2107
+ // Set operation
2108
+ if (operation === "set") return value;
2109
+
2110
+ // Array operations
2111
+ if (operation.startsWith('array')) {
2112
+ if (!Array.isArray(curValue)) curValue = []; // Auto-convert to array if current value isn't one
2113
+
2114
+ // Comparison function
2115
+ const isObject = typeof value === 'object' && value !== null;
2116
+ const compare = (item) => {
2117
+ if (isObject && typeof item === 'object' && item !== null) {
2118
+ return JSON.stringify(item) === JSON.stringify(value); // Deep comparison
2119
+ }
2120
+ return item === value; // Value comparison
2121
+ };
2122
+
2123
+ switch (operation) {
2124
+ case 'array-add':
2125
+ curValue.push(value);
2126
+ break;
2127
+ case 'array-add-unique':
2128
+ if (!curValue.some(compare)) curValue.push(value);
2129
+ break;
2130
+ case 'array-remove-matching':
2131
+ curValue = curValue.filter(item => !compare(item));
2132
+ break;
2133
+ case 'array-update-matching':
2134
+ const index = curValue.findIndex(compare);
2135
+ if (index !== -1) curValue[index] = updateValue;
2136
+ break;
2137
+ }
2138
+ }
2139
+
2140
+ return curValue;
2141
+
2142
+ } catch (error) {
2143
+ console.error(CONSOLE_PREFIX + `Failed to process operation with curValue ${curValue}:`, error);
2144
+ return curValue;
2145
+ }
2146
+ }
2147
+
2148
+ // Get property store
2149
+ get getPropertyStore() {
2150
+ try {
2151
+ return JSON.parse(JSON.stringify(this.#propertyStore)); // Return full copy
2152
+ } catch {
2153
+ console.error(CONSOLE_PREFIX + "Failed to parse property store");
2154
+ return {};
2155
+ }
2156
+ }
2157
+
2158
+ // Check for changes in the local property store
2159
+ get didPropertiesChange() {
2160
+ try {
2161
+ if (JSON.stringify(this.#propertyStore) !== JSON.stringify(this.#lastPropertyStore)) {
2162
+ this.#lastPropertyStore = JSON.parse(JSON.stringify(this.#propertyStore));
2163
+ return true;
2164
+ }
2165
+ } catch { }
2166
+ return false;
2167
+ }
2168
+
2169
+ // Get state (can be imported using importState, converts the maps to arrays for serialization)
2170
+ get getState() {
2171
+ return {
2172
+ keyOperations: [...this.#keyOperations.entries()],
2173
+ vectorClock: [...this.#vectorClock.entries()]
2174
+ };
2175
+ }
2176
+ }
2177
+
2178
+ crdtManager = { CRDTManager };
2179
+ return crdtManager;
2180
+ }
2181
+
10
2182
  var server$1;
11
2183
  var hasRequiredServer;
12
2184
 
@@ -15,6 +2187,8 @@ function requireServer () {
15
2187
  hasRequiredServer = 1;
16
2188
  const WebSocket = require$$0;
17
2189
  const http = require$$1;
2190
+ const { encode, decode } = require$$2;
2191
+ const { CRDTManager } = requireCrdtManager();
18
2192
 
19
2193
  /**
20
2194
  * PlaySocketServer - WebSocket server for PlaySocket multiplayer library
@@ -83,7 +2257,7 @@ function requireServer () {
83
2257
  */
84
2258
  #handleMessage(ws, message) {
85
2259
  try {
86
- const data = JSON.parse(message);
2260
+ const data = decode(message);
87
2261
 
88
2262
  // Apply rate limiting after client is registered
89
2263
  if (ws.clientId && !this.#checkRateLimit(ws.clientId, data.type)) {
@@ -95,14 +2269,14 @@ function requireServer () {
95
2269
  // Register client ID
96
2270
  if (!data.id) return;
97
2271
  if (this.#clients.get(data.id)) {
98
- ws.send(JSON.stringify({ type: 'id_taken' }));
2272
+ ws.send(encode({ type: 'id_taken' }), { binary: true });
99
2273
  return;
100
2274
  }
101
2275
  ws.clientId = data.id; // Adds the provided id to the ws object as clientId
102
2276
  this.#clients.set(data.id, ws);
103
2277
  const sessionToken = this.#generateSessionToken();
104
2278
  this.#clientTokens.set(data.id, sessionToken); // Token is used when reconnecting to prevent impersonation attacks
105
- ws.send(JSON.stringify({ type: 'registered', sessionToken }));
2279
+ ws.send(encode({ type: 'registered', sessionToken }), { binary: true });
106
2280
  this.#triggerEvent("clientRegistered", data.id, data.customData);
107
2281
  break;
108
2282
 
@@ -111,7 +2285,10 @@ function requireServer () {
111
2285
  const pd = this.#pendingDisconnects.get(data.id);
112
2286
  if (pd && data.sessionToken) {
113
2287
  if (data.sessionToken !== this.#clientTokens.get(data.id)) {
114
- ws.send(JSON.stringify({ type: 'reconnection_failed', reason: "Session token does not match" }));
2288
+ ws.send(encode({
2289
+ type: 'reconnection_failed',
2290
+ reason: "Session token does not match"
2291
+ }), { binary: true });
115
2292
  return;
116
2293
  }
117
2294
  clearTimeout(pd.timeout);
@@ -126,15 +2303,15 @@ function requireServer () {
126
2303
  const formerRoom = this.#rooms[this.#clientRooms.get(data.id)];
127
2304
  if (formerRoom) {
128
2305
  roomData = {
129
- storage: formerRoom.storage,
2306
+ state: formerRoom.crdtManager.getState,
130
2307
  participantCount: formerRoom.participants.length,
131
2308
  host: formerRoom.participants[0]
132
2309
  };
133
2310
  }
134
2311
 
135
- ws.send(JSON.stringify({ type: 'reconnected', roomData }));
2312
+ ws.send(encode({ type: 'reconnected', roomData }), { binary: true });
136
2313
  } else {
137
- ws.send(JSON.stringify({ type: 'reconnection_failed', reason: "Client unknown to server" }));
2314
+ ws.send(encode({ type: 'reconnection_failed', reason: "Client unknown to server" }), { binary: true });
138
2315
  }
139
2316
  break;
140
2317
 
@@ -142,21 +2319,25 @@ function requireServer () {
142
2319
  if (!ws.clientId) return;
143
2320
  const newRoomId = ws.clientId;
144
2321
  if (this.#clientRooms.get(ws.clientId) || this.#rooms[newRoomId]) {
145
- ws.send(JSON.stringify({
2322
+ ws.send(encode({
146
2323
  type: 'room_creation_failed',
147
2324
  reason: this.#clientRooms.get(ws.clientId) ? 'Already in a room' : 'Room id is taken'
148
- }));
2325
+ }), { binary: true });
149
2326
  return;
150
2327
  }
151
2328
 
2329
+ // Create room object
152
2330
  this.#rooms[newRoomId] = {
153
2331
  participants: [ws.clientId],
154
2332
  maxSize: data.size || null,
155
- storage: data.storage || {}
2333
+ crdtManager: new CRDTManager()
156
2334
  };
157
2335
 
158
- this.#clientRooms.set(ws.clientId, newRoomId);
159
- ws.send(JSON.stringify({ type: 'room_created' }));
2336
+ // Load state if provided
2337
+ if (data.state) this.#rooms[newRoomId].crdtManager.importState(data.state);
2338
+
2339
+ this.#clientRooms.set(ws.clientId, newRoomId); // Add client to their room
2340
+ ws.send(encode({ type: 'room_created' }), { binary: true });
160
2341
  this.#triggerEvent("roomCreated", ws.clientId); // Client id = room id
161
2342
  break;
162
2343
 
@@ -168,12 +2349,12 @@ function requireServer () {
168
2349
  if (!room ||
169
2350
  (room.maxSize && room.participants.length >= room.maxSize) ||
170
2351
  this.#clientRooms.get(ws.clientId)) {
171
- ws.send(JSON.stringify({
2352
+ ws.send(encode({
172
2353
  type: 'join_rejected',
173
2354
  reason: !room ? 'Room not found' :
174
2355
  room.maxSize && room.participants.length >= room.maxSize ? 'Room full' :
175
2356
  'Already in a room'
176
- }));
2357
+ }), { binary: true });
177
2358
  return;
178
2359
  }
179
2360
 
@@ -181,48 +2362,43 @@ function requireServer () {
181
2362
  this.#clientRooms.set(ws.clientId, roomId);
182
2363
 
183
2364
  // Notify joiner with initial storage
184
- ws.send(JSON.stringify({
2365
+ ws.send(encode({
185
2366
  type: 'join_accepted',
186
- storage: room.storage,
2367
+ state: room.crdtManager.getState,
187
2368
  participantCount: room.participants.length,
188
2369
  host: room.participants[0]
189
- }));
2370
+ }), { binary: true });
190
2371
 
191
2372
  // Notify existing participants
192
2373
  room.participants.forEach(p => {
193
2374
  if (p === ws.clientId) return;
194
2375
  const client = this.#clients.get(p);
195
2376
  if (client) {
196
- client.send(JSON.stringify({
2377
+ client.send(encode({
197
2378
  type: 'client_connected',
198
2379
  client: ws.clientId,
199
2380
  participantCount: room.participants.length
200
- }));
2381
+ }), { binary: true });
201
2382
  }
202
2383
  });
203
2384
  this.#triggerEvent("roomJoined", ws.clientId, roomId);
204
2385
  break;
205
2386
 
206
- case 'room_storage_update':
2387
+ case 'property_update':
207
2388
  const updateRoomId = this.#clientRooms.get(ws.clientId);
208
2389
  const updateRoom = updateRoomId ? this.#rooms[updateRoomId] : null;
209
- if (updateRoom && data.key) {
210
- if (JSON.stringify(updateRoom.storage[data.key]) !== JSON.stringify(data.value)) {
211
- updateRoom.storage[data.key] = data.value;
212
- this.#syncRoomStorageKey(updateRoom, data.key, ws.clientId);
213
- }
214
- }
215
- break;
216
-
217
- case 'room_storage_array_update':
218
- const arrayRoomId = this.#clientRooms.get(ws.clientId);
219
- const arrayRoom = arrayRoomId ? this.#rooms[arrayRoomId] : null;
220
- if (arrayRoom && data.key) {
221
- const updatedArray = this.#arrayUpdate(arrayRoom.storage, data.key, data.operation, data.value, data.updateValue);
222
- if (JSON.stringify(arrayRoom.storage[data.key]) !== JSON.stringify(updatedArray)) {
223
- arrayRoom.storage[data.key] = updatedArray;
224
- this.#syncRoomStorageKey(arrayRoom, data.key, ws.clientId);
225
- }
2390
+
2391
+ if (updateRoom && data.key && data.property) {
2392
+ updateRoom.crdtManager.importProperty(data.property);
2393
+ updateRoom.participants?.forEach(p => {
2394
+ const client = this.#clients.get(p);
2395
+ if (client) {
2396
+ client.send(encode({
2397
+ type: 'property_sync',
2398
+ property: updateRoom.crdtManager.exportPropertyLastOpOnly(data.key)
2399
+ }), { binary: true });
2400
+ }
2401
+ });
226
2402
  }
227
2403
  break;
228
2404
 
@@ -274,58 +2450,6 @@ function requireServer () {
274
2450
  return true;
275
2451
  }
276
2452
 
277
- /**
278
- * Sync storage key with all clients in room
279
- * @private
280
- * @param {Object} room
281
- * @param {string} key
282
- * @param {string} exclude
283
- */
284
- #syncRoomStorageKey(room, key, exclude) {
285
- room?.participants?.forEach(p => {
286
- if (p === exclude) return;
287
- const client = this.#clients.get(p);
288
- if (client) {
289
- client.send(JSON.stringify({
290
- type: 'storage_sync',
291
- key,
292
- value: room?.storage?.[key]
293
- }));
294
- }
295
- });
296
- }
297
-
298
- /**
299
- * Handle array operations
300
- * @private
301
- */
302
- #arrayUpdate(storage, key, operation, value, updateValue) {
303
- let array = (!storage[key] || !Array.isArray(storage[key])) ? [] : [...storage[key]];
304
- const isObject = typeof value === 'object' && value !== null;
305
- const compare = (item) => isObject ? JSON.stringify(item) === JSON.stringify(value) : item === value;
306
-
307
- switch (operation) {
308
- case 'add':
309
- array.push(value);
310
- break;
311
-
312
- case 'add-unique':
313
- if (!array.some(compare)) array.push(value);
314
- break;
315
-
316
- case 'remove-matching':
317
- array = array.filter(item => !compare(item));
318
- break;
319
-
320
- case 'update-matching':
321
- const index = array.findIndex(compare);
322
- if (index !== -1) array[index] = updateValue;
323
- break;
324
- }
325
-
326
- return array;
327
- }
328
-
329
2453
  /**
330
2454
  * Handle client disconnection
331
2455
  * @private
@@ -368,12 +2492,12 @@ function requireServer () {
368
2492
  // Notify remaining participants
369
2493
  room.participants.forEach(p => {
370
2494
  const client = this.#clients.get(p);
371
- if (client) client.send(JSON.stringify({
2495
+ if (client) client.send(encode({
372
2496
  type: 'client_disconnected',
373
2497
  client: ws.clientId,
374
2498
  host: room.participants[0],
375
2499
  participantCount: room.participants.length
376
- }));
2500
+ }), { binary: true });
377
2501
  });
378
2502
  }
379
2503
  }