spacetimedb 2.5.0 → 2.6.0

package/src/lib/binary_writer.ts

@@ -1,213 +1,213 @@
-import { fromByteArray } from 'base64-js';
-
-const ArrayBufferPrototypeTransfer =
-  ArrayBuffer.prototype.transfer ??
-  function (this: ArrayBuffer, newByteLength) {
-    if (newByteLength === undefined) {
-      return this.slice();
-    } else if (newByteLength <= this.byteLength) {
-      return this.slice(0, newByteLength);
-    } else {
-      const copy = new Uint8Array(newByteLength);
-      copy.set(new Uint8Array(this));
-      return copy.buffer;
-    }
-  };
-
-export class ResizableBuffer {
-  buffer: ArrayBuffer;
-  view: DataView;
-
-  constructor(init: number | ArrayBuffer) {
-    this.buffer = typeof init === 'number' ? new ArrayBuffer(init) : init;
-    this.view = new DataView(this.buffer);
-  }
-
-  get capacity(): number {
-    return this.buffer.byteLength;
-  }
-
-  grow(newSize: number) {
-    if (newSize <= this.buffer.byteLength) return;
-    this.buffer = ArrayBufferPrototypeTransfer.call(this.buffer, newSize);
-    this.view = new DataView(this.buffer);
-  }
-}
-
-export default class BinaryWriter {
-  buffer: ResizableBuffer;
-  offset: number = 0;
-
-  constructor(init: number | ResizableBuffer) {
-    this.buffer = typeof init === 'number' ? new ResizableBuffer(init) : init;
-  }
-
-  clear() {
-    this.offset = 0;
-  }
-
-  reset(buffer: ResizableBuffer) {
-    this.buffer = buffer;
-    this.offset = 0;
-  }
-
-  expandBuffer(additionalCapacity: number): void {
-    const minCapacity = this.offset + additionalCapacity + 1;
-    if (minCapacity <= this.buffer.capacity) return;
-    let newCapacity = this.buffer.capacity * 2;
-    if (newCapacity < minCapacity) newCapacity = minCapacity;
-    this.buffer.grow(newCapacity);
-  }
-
-  toBase64(): string {
-    return fromByteArray(this.getBuffer());
-  }
-
-  getBuffer(): Uint8Array<ArrayBuffer> {
-    return new Uint8Array(this.buffer.buffer, 0, this.offset);
-  }
-
-  get view() {
-    return this.buffer.view;
-  }
-
-  writeUInt8Array(value: Uint8Array): void {
-    const length = value.length;
-
-    this.expandBuffer(4 + length);
-
-    this.writeU32(length);
-    new Uint8Array(this.buffer.buffer, this.offset).set(value);
-    this.offset += length;
-  }
-
-  writeBool(value: boolean): void {
-    this.expandBuffer(1);
-    this.view.setUint8(this.offset, value ? 1 : 0);
-    this.offset += 1;
-  }
-
-  writeByte(value: number): void {
-    this.expandBuffer(1);
-    this.view.setUint8(this.offset, value);
-    this.offset += 1;
-  }
-
-  writeBytes(value: Uint8Array): void {
-    this.expandBuffer(value.length);
-    new Uint8Array(this.buffer.buffer, this.offset, value.length).set(value);
-    this.offset += value.length;
-  }
-
-  writeI8(value: number): void {
-    this.expandBuffer(1);
-    this.view.setInt8(this.offset, value);
-    this.offset += 1;
-  }
-
-  writeU8(value: number): void {
-    this.expandBuffer(1);
-    this.view.setUint8(this.offset, value);
-    this.offset += 1;
-  }
-
-  writeI16(value: number): void {
-    this.expandBuffer(2);
-    this.view.setInt16(this.offset, value, true);
-    this.offset += 2;
-  }
-
-  writeU16(value: number): void {
-    this.expandBuffer(2);
-    this.view.setUint16(this.offset, value, true);
-    this.offset += 2;
-  }
-
-  writeI32(value: number): void {
-    this.expandBuffer(4);
-    this.view.setInt32(this.offset, value, true);
-    this.offset += 4;
-  }
-
-  writeU32(value: number): void {
-    this.expandBuffer(4);
-    this.view.setUint32(this.offset, value, true);
-    this.offset += 4;
-  }
-
-  writeI64(value: bigint): void {
-    this.expandBuffer(8);
-    this.view.setBigInt64(this.offset, value, true);
-    this.offset += 8;
-  }
-
-  writeU64(value: bigint): void {
-    this.expandBuffer(8);
-    this.view.setBigUint64(this.offset, value, true);
-    this.offset += 8;
-  }
-
-  writeU128(value: bigint): void {
-    this.expandBuffer(16);
-    const lowerPart = value & BigInt('0xFFFFFFFFFFFFFFFF');
-    const upperPart = value >> BigInt(64);
-    this.view.setBigUint64(this.offset, lowerPart, true);
-    this.view.setBigUint64(this.offset + 8, upperPart, true);
-    this.offset += 16;
-  }
-
-  writeI128(value: bigint): void {
-    this.expandBuffer(16);
-    const lowerPart = value & BigInt('0xFFFFFFFFFFFFFFFF');
-    const upperPart = value >> BigInt(64);
-    this.view.setBigInt64(this.offset, lowerPart, true);
-    this.view.setBigInt64(this.offset + 8, upperPart, true);
-    this.offset += 16;
-  }
-
-  writeU256(value: bigint): void {
-    this.expandBuffer(32);
-    const low_64_mask = BigInt('0xFFFFFFFFFFFFFFFF');
-    const p0 = value & low_64_mask;
-    const p1 = (value >> BigInt(64 * 1)) & low_64_mask;
-    const p2 = (value >> BigInt(64 * 2)) & low_64_mask;
-    const p3 = value >> BigInt(64 * 3);
-    this.view.setBigUint64(this.offset + 8 * 0, p0, true);
-    this.view.setBigUint64(this.offset + 8 * 1, p1, true);
-    this.view.setBigUint64(this.offset + 8 * 2, p2, true);
-    this.view.setBigUint64(this.offset + 8 * 3, p3, true);
-    this.offset += 32;
-  }
-
-  writeI256(value: bigint): void {
-    this.expandBuffer(32);
-    const low_64_mask = BigInt('0xFFFFFFFFFFFFFFFF');
-    const p0 = value & low_64_mask;
-    const p1 = (value >> BigInt(64 * 1)) & low_64_mask;
-    const p2 = (value >> BigInt(64 * 2)) & low_64_mask;
-    const p3 = value >> BigInt(64 * 3);
-    this.view.setBigUint64(this.offset + 8 * 0, p0, true);
-    this.view.setBigUint64(this.offset + 8 * 1, p1, true);
-    this.view.setBigUint64(this.offset + 8 * 2, p2, true);
-    this.view.setBigInt64(this.offset + 8 * 3, p3, true);
-    this.offset += 32;
-  }
-
-  writeF32(value: number): void {
-    this.expandBuffer(4);
-    this.view.setFloat32(this.offset, value, true);
-    this.offset += 4;
-  }
-
-  writeF64(value: number): void {
-    this.expandBuffer(8);
-    this.view.setFloat64(this.offset, value, true);
-    this.offset += 8;
-  }
-
-  writeString(value: string): void {
-    const encoder = new TextEncoder();
-    const encodedString = encoder.encode(value);
-    this.writeUInt8Array(encodedString);
-  }
-}
+import { fromByteArray } from 'base64-js';
+
+const ArrayBufferPrototypeTransfer =
+  ArrayBuffer.prototype.transfer ??
+  function (this: ArrayBuffer, newByteLength) {
+    if (newByteLength === undefined) {
+      return this.slice();
+    } else if (newByteLength <= this.byteLength) {
+      return this.slice(0, newByteLength);
+    } else {
+      const copy = new Uint8Array(newByteLength);
+      copy.set(new Uint8Array(this));
+      return copy.buffer;
+    }
+  };
+
+export class ResizableBuffer {
+  buffer: ArrayBuffer;
+  view: DataView;
+
+  constructor(init: number | ArrayBuffer) {
+    this.buffer = typeof init === 'number' ? new ArrayBuffer(init) : init;
+    this.view = new DataView(this.buffer);
+  }
+
+  get capacity(): number {
+    return this.buffer.byteLength;
+  }
+
+  grow(newSize: number) {
+    if (newSize <= this.buffer.byteLength) return;
+    this.buffer = ArrayBufferPrototypeTransfer.call(this.buffer, newSize);
+    this.view = new DataView(this.buffer);
+  }
+}
+
+export default class BinaryWriter {
+  buffer: ResizableBuffer;
+  offset: number = 0;
+
+  constructor(init: number | ResizableBuffer) {
+    this.buffer = typeof init === 'number' ? new ResizableBuffer(init) : init;
+  }
+
+  clear() {
+    this.offset = 0;
+  }
+
+  reset(buffer: ResizableBuffer) {
+    this.buffer = buffer;
+    this.offset = 0;
+  }
+
+  expandBuffer(additionalCapacity: number): void {
+    const minCapacity = this.offset + additionalCapacity + 1;
+    if (minCapacity <= this.buffer.capacity) return;
+    let newCapacity = this.buffer.capacity * 2;
+    if (newCapacity < minCapacity) newCapacity = minCapacity;
+    this.buffer.grow(newCapacity);
+  }
+
+  toBase64(): string {
+    return fromByteArray(this.getBuffer());
+  }
+
+  getBuffer(): Uint8Array<ArrayBuffer> {
+    return new Uint8Array(this.buffer.buffer, 0, this.offset);
+  }
+
+  get view() {
+    return this.buffer.view;
+  }
+
+  writeUInt8Array(value: Uint8Array): void {
+    const length = value.length;
+
+    this.expandBuffer(4 + length);
+
+    this.writeU32(length);
+    new Uint8Array(this.buffer.buffer, this.offset).set(value);
+    this.offset += length;
+  }
+
+  writeBool(value: boolean): void {
+    this.expandBuffer(1);
+    this.view.setUint8(this.offset, value ? 1 : 0);
+    this.offset += 1;
+  }
+
+  writeByte(value: number): void {
+    this.expandBuffer(1);
+    this.view.setUint8(this.offset, value);
+    this.offset += 1;
+  }
+
+  writeBytes(value: Uint8Array): void {
+    this.expandBuffer(value.length);
+    new Uint8Array(this.buffer.buffer, this.offset, value.length).set(value);
+    this.offset += value.length;
+  }
+
+  writeI8(value: number): void {
+    this.expandBuffer(1);
+    this.view.setInt8(this.offset, value);
+    this.offset += 1;
+  }
+
+  writeU8(value: number): void {
+    this.expandBuffer(1);
+    this.view.setUint8(this.offset, value);
+    this.offset += 1;
+  }
+
+  writeI16(value: number): void {
+    this.expandBuffer(2);
+    this.view.setInt16(this.offset, value, true);
+    this.offset += 2;
+  }
+
+  writeU16(value: number): void {
+    this.expandBuffer(2);
+    this.view.setUint16(this.offset, value, true);
+    this.offset += 2;
+  }
+
+  writeI32(value: number): void {
+    this.expandBuffer(4);
+    this.view.setInt32(this.offset, value, true);
+    this.offset += 4;
+  }
+
+  writeU32(value: number): void {
+    this.expandBuffer(4);
+    this.view.setUint32(this.offset, value, true);
+    this.offset += 4;
+  }
+
+  writeI64(value: bigint): void {
+    this.expandBuffer(8);
+    this.view.setBigInt64(this.offset, value, true);
+    this.offset += 8;
+  }
+
+  writeU64(value: bigint): void {
+    this.expandBuffer(8);
+    this.view.setBigUint64(this.offset, value, true);
+    this.offset += 8;
+  }
+
+  writeU128(value: bigint): void {
+    this.expandBuffer(16);
+    const lowerPart = value & BigInt('0xFFFFFFFFFFFFFFFF');
+    const upperPart = value >> BigInt(64);
+    this.view.setBigUint64(this.offset, lowerPart, true);
+    this.view.setBigUint64(this.offset + 8, upperPart, true);
+    this.offset += 16;
+  }
+
+  writeI128(value: bigint): void {
+    this.expandBuffer(16);
+    const lowerPart = value & BigInt('0xFFFFFFFFFFFFFFFF');
+    const upperPart = value >> BigInt(64);
+    this.view.setBigInt64(this.offset, lowerPart, true);
+    this.view.setBigInt64(this.offset + 8, upperPart, true);
+    this.offset += 16;
+  }
+
+  writeU256(value: bigint): void {
+    this.expandBuffer(32);
+    const low_64_mask = BigInt('0xFFFFFFFFFFFFFFFF');
+    const p0 = value & low_64_mask;
+    const p1 = (value >> BigInt(64 * 1)) & low_64_mask;
+    const p2 = (value >> BigInt(64 * 2)) & low_64_mask;
+    const p3 = value >> BigInt(64 * 3);
+    this.view.setBigUint64(this.offset + 8 * 0, p0, true);
+    this.view.setBigUint64(this.offset + 8 * 1, p1, true);
+    this.view.setBigUint64(this.offset + 8 * 2, p2, true);
+    this.view.setBigUint64(this.offset + 8 * 3, p3, true);
+    this.offset += 32;
+  }
+
+  writeI256(value: bigint): void {
+    this.expandBuffer(32);
+    const low_64_mask = BigInt('0xFFFFFFFFFFFFFFFF');
+    const p0 = value & low_64_mask;
+    const p1 = (value >> BigInt(64 * 1)) & low_64_mask;
+    const p2 = (value >> BigInt(64 * 2)) & low_64_mask;
+    const p3 = value >> BigInt(64 * 3);
+    this.view.setBigUint64(this.offset + 8 * 0, p0, true);
+    this.view.setBigUint64(this.offset + 8 * 1, p1, true);
+    this.view.setBigUint64(this.offset + 8 * 2, p2, true);
+    this.view.setBigInt64(this.offset + 8 * 3, p3, true);
+    this.offset += 32;
+  }
+
+  writeF32(value: number): void {
+    this.expandBuffer(4);
+    this.view.setFloat32(this.offset, value, true);
+    this.offset += 4;
+  }
+
+  writeF64(value: number): void {
+    this.expandBuffer(8);
+    this.view.setFloat64(this.offset, value, true);
+    this.offset += 8;
+  }
+
+  writeString(value: string): void {
+    const encoder = new TextEncoder();
+    const encodedString = encoder.encode(value);
+    this.writeUInt8Array(encodedString);
+  }
+}

package/src/lib/connection_id.ts

@@ -1,102 +1,102 @@
-import { AlgebraicType } from './algebraic_type';
-import { hexStringToU128, u128ToHexString, u128ToUint8Array } from './util';
-
-export type ConnectionIdAlgebraicType = {
-  tag: 'Product';
-  value: {
-    elements: [{ name: '__connection_id__'; algebraicType: { tag: 'U128' } }];
-  };
-};
-
-/**
- * A unique identifier for a client connected to a database.
- */
-export class ConnectionId {
-  __connection_id__: bigint;
-
-  /**
-   * Creates a new `ConnectionId`.
-   */
-  constructor(data: bigint) {
-    this.__connection_id__ = data;
-  }
-
-  /**
-   * Get the algebraic type representation of the {@link ConnectionId} type.
-   * @returns The algebraic type representation of the type.
-   */
-  static getAlgebraicType(): ConnectionIdAlgebraicType {
-    return AlgebraicType.Product({
-      elements: [
-        { name: '__connection_id__', algebraicType: AlgebraicType.U128 },
-      ],
-    });
-  }
-
-  isZero(): boolean {
-    return this.__connection_id__ === BigInt(0);
-  }
-
-  static nullIfZero(addr: ConnectionId): ConnectionId | null {
-    if (addr.isZero()) {
-      return null;
-    } else {
-      return addr;
-    }
-  }
-
-  static random(): ConnectionId {
-    function randomU8(): number {
-      return Math.floor(Math.random() * 0xff);
-    }
-    let result = BigInt(0);
-    for (let i = 0; i < 16; i++) {
-      result = (result << BigInt(8)) | BigInt(randomU8());
-    }
-    return new ConnectionId(result);
-  }
-
-  /**
-   * Compare two connection IDs for equality.
-   */
-  isEqual(other: ConnectionId): boolean {
-    return this.__connection_id__ == other.__connection_id__;
-  }
-
-  /**
-   * Check if two connection IDs are equal.
-   */
-  equals(other: ConnectionId): boolean {
-    return this.isEqual(other);
-  }
-
-  /**
-   * Print the connection ID as a hexadecimal string.
-   */
-  toHexString(): string {
-    return u128ToHexString(this.__connection_id__);
-  }
-
-  /**
-   * Convert the connection ID to a Uint8Array.
-   */
-  toUint8Array(): Uint8Array {
-    return u128ToUint8Array(this.__connection_id__);
-  }
-
-  /**
-   * Parse a connection ID from a hexadecimal string.
-   */
-  static fromString(str: string): ConnectionId {
-    return new ConnectionId(hexStringToU128(str));
-  }
-
-  static fromStringOrNull(str: string): ConnectionId | null {
-    const addr = ConnectionId.fromString(str);
-    if (addr.isZero()) {
-      return null;
-    } else {
-      return addr;
-    }
-  }
-}
+import { AlgebraicType } from './algebraic_type';
+import { hexStringToU128, u128ToHexString, u128ToUint8Array } from './util';
+
+export type ConnectionIdAlgebraicType = {
+  tag: 'Product';
+  value: {
+    elements: [{ name: '__connection_id__'; algebraicType: { tag: 'U128' } }];
+  };
+};
+
+/**
+ * A unique identifier for a client connected to a database.
+ */
+export class ConnectionId {
+  __connection_id__: bigint;
+
+  /**
+   * Creates a new `ConnectionId`.
+   */
+  constructor(data: bigint) {
+    this.__connection_id__ = data;
+  }
+
+  /**
+   * Get the algebraic type representation of the {@link ConnectionId} type.
+   * @returns The algebraic type representation of the type.
+   */
+  static getAlgebraicType(): ConnectionIdAlgebraicType {
+    return AlgebraicType.Product({
+      elements: [
+        { name: '__connection_id__', algebraicType: AlgebraicType.U128 },
+      ],
+    });
+  }
+
+  isZero(): boolean {
+    return this.__connection_id__ === BigInt(0);
+  }
+
+  static nullIfZero(addr: ConnectionId): ConnectionId | null {
+    if (addr.isZero()) {
+      return null;
+    } else {
+      return addr;
+    }
+  }
+
+  static random(): ConnectionId {
+    function randomU8(): number {
+      return Math.floor(Math.random() * 0xff);
+    }
+    let result = BigInt(0);
+    for (let i = 0; i < 16; i++) {
+      result = (result << BigInt(8)) | BigInt(randomU8());
+    }
+    return new ConnectionId(result);
+  }
+
+  /**
+   * Compare two connection IDs for equality.
+   */
+  isEqual(other: ConnectionId): boolean {
+    return this.__connection_id__ == other.__connection_id__;
+  }
+
+  /**
+   * Check if two connection IDs are equal.
+   */
+  equals(other: ConnectionId): boolean {
+    return this.isEqual(other);
+  }
+
+  /**
+   * Print the connection ID as a hexadecimal string.
+   */
+  toHexString(): string {
+    return u128ToHexString(this.__connection_id__);
+  }
+
+  /**
+   * Convert the connection ID to a Uint8Array.
+   */
+  toUint8Array(): Uint8Array {
+    return u128ToUint8Array(this.__connection_id__);
+  }
+
+  /**
+   * Parse a connection ID from a hexadecimal string.
+   */
+  static fromString(str: string): ConnectionId {
+    return new ConnectionId(hexStringToU128(str));
+  }
+
+  static fromStringOrNull(str: string): ConnectionId | null {
+    const addr = ConnectionId.fromString(str);
+    if (addr.isZero()) {
+      return null;
+    } else {
+      return addr;
+    }
+  }
+}