@bloopjs/web 0.0.44 → 0.0.45

package/dist/netcode/broker.d.ts

@@ -0,0 +1,12 @@
+import type { BrokerMessage } from "./protocol.ts";
+export type RoomEvents = {
+    onBrokerMessage: (message: BrokerMessage) => void;
+    onPeerIdAssign: (peerId: string) => void;
+    onPeerConnected: (peerId: string) => void;
+    onPeerDisconnected: (peerId: string) => void;
+    onDataChannelOpen: (peerId: string, reliable: boolean, channel: RTCDataChannel) => void;
+    onMessage: (peerId: string, data: Uint8Array, reliable: boolean) => void;
+    onDataChannelClose: (peerId: string, reliable: boolean) => void;
+};
+export declare function joinRoom(brokerUrl: string, _roomId: string, cbs: RoomEvents): void;
+//# sourceMappingURL=broker.d.ts.map

package/dist/netcode/broker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broker.d.ts","sourceRoot":"","sources":["../../src/netcode/broker.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AASnD,MAAM,MAAM,UAAU,GAAG;IACvB,eAAe,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,CAAC;IAClD,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,kBAAkB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAE7C,iBAAiB,EAAE,CACjB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,cAAc,KACpB,IAAI,CAAC;IACV,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IACzE,kBAAkB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;CACjE,CAAC;AAEF,wBAAgB,QAAQ,CACtB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,UAAU,QA0GhB"}

package/dist/netcode/logs.d.ts

@@ -0,0 +1,37 @@
+import type { PeerId } from "./protocol.ts";
+export type Log = {
+    source: "webrtc" | "ws" | "local" | "rollback";
+    /** absolute frame number since the start of the sim */
+    frame_number: number;
+    /** relative frame number since the start of the current session */
+    match_frame: number | null;
+    /** unix timestamp */
+    timestamp: number;
+    severity: LogSeverity;
+    label?: string;
+    json?: any;
+    direction?: LogDirection;
+    from?: PeerId;
+    to?: PeerId;
+    reliable?: boolean;
+    packet?: {
+        size: number;
+        bytes: Uint8Array;
+    };
+};
+export type LogOpts = Partial<Log> & {
+    source: Log["source"];
+};
+export type LogDirection = "inbound" | "outbound";
+export type LogSeverity = "debug" | "log" | "warn" | "error";
+export type OnLogCallback = (log: Log) => void;
+export type Logger = {
+    onLog: OnLogCallback | null;
+    matchFrame: number;
+    frameNumber: number;
+    log(opts: LogOpts): void;
+    warn(opts: LogOpts): void;
+    error(opts: LogOpts): void;
+};
+export declare const logger: Logger;
+//# sourceMappingURL=logs.d.ts.map

package/dist/netcode/logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../../src/netcode/logs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,MAAM,MAAM,GAAG,GAAG;IAChB,MAAM,EAAE,QAAQ,GAAG,IAAI,GAAG,OAAO,GAAG,UAAU,CAAC;IAC/C,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,WAAW,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,GAAG,CAAC;IAEX,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,UAAU,CAAC;KACnB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG;IACnC,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,UAAU,CAAC;AAElD,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;AAE7D,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC;AAE/C,MAAM,MAAM,MAAM,GAAG;IACnB,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IAE5B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IAEpB,GAAG,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,KAAK,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;CAC5B,CAAA;AAED,eAAO,MAAM,MAAM,EAAE,MAmCpB,CAAC"}

package/dist/netcode/mod.d.ts

@@ -0,0 +1,7 @@
+export type { PeerId, BrokerMessage, PeerMessage } from "./protocol.ts";
+export type { Log, LogOpts, LogDirection, LogSeverity, OnLogCallback, } from "./logs.ts";
+export type { WebRtcPipe } from "./transport.ts";
+export type { RoomEvents } from "./broker.ts";
+export { PacketType } from "./protocol.ts";
+export { logger } from "./logs.ts";
+//# sourceMappingURL=mod.d.ts.map

package/dist/netcode/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/netcode/mod.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACxE,YAAY,EACV,GAAG,EACH,OAAO,EACP,YAAY,EACZ,WAAW,EACX,aAAa,GACd,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC"}

package/dist/netcode/protocol.d.ts

@@ -0,0 +1,42 @@
+export type PeerId = string;
+export declare enum PacketType {
+    None = 0,
+    Inputs = 1
+}
+export type BrokerMessage = {
+    type: "welcome";
+    yourId: PeerId;
+    peerIds: PeerId[];
+    serverId: string;
+} | {
+    type: "message:json";
+    peerId: PeerId;
+    message: PeerMessage;
+} | {
+    type: "message:string";
+    peerId: PeerId;
+    message: string;
+} | {
+    type: "message:buffer";
+    peerId: PeerId;
+    message: ArrayBuffer;
+} | {
+    type: "peer:connect";
+    peerId: PeerId;
+} | {
+    type: "peer:disconnect";
+    peerId: PeerId;
+};
+export type PeerMessage = {
+    type: "offer";
+    target: string;
+    payload: string;
+} | {
+    type: "answer";
+    target: string;
+    payload: string;
+} | {
+    type: "message";
+    payload: any;
+};
+//# sourceMappingURL=protocol.d.ts.map

package/dist/netcode/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/netcode/protocol.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC;AAK5B,oBAAY,UAAU;IACpB,IAAI,IAAI;IACR,MAAM,IAAI;CACX;AAED,MAAM,MAAM,aAAa,GACrB;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB,GACD;IACE,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,WAAW,CAAC;CACtB,GACD;IACE,IAAI,EAAE,gBAAgB,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB,GACD;IACE,IAAI,EAAE,gBAAgB,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,WAAW,CAAC;CACtB,GACD;IACE,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB,GACD;IACE,IAAI,EAAE,iBAAiB,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEN,MAAM,MAAM,WAAW,GACnB;IACE,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB,GACD;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB,GACD;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,GAAG,CAAC;CACd,CAAC"}

package/dist/netcode/transport.d.ts

@@ -0,0 +1,16 @@
+import type { WebSocket } from "partysocket";
+export type WebRtcPipe = {
+    peerConnection: RTCPeerConnection;
+    reliable: RTCDataChannel;
+    unreliable: RTCDataChannel;
+    peerId: string;
+};
+export declare function connect(ws: WebSocket, peerId: string, 
+/** defaults to 10s */
+timeoutMs?: number): Promise<WebRtcPipe>;
+export declare function logErrors(dc: RTCDataChannel): Promise<void>;
+export declare function logPeerConnection(pc: RTCPeerConnection, peerId: string): Promise<void>;
+export declare function gatherIce(pc: RTCPeerConnection, timeoutMs: number): Promise<boolean | Error>;
+export declare function waitForAnswer(ws: WebSocket, pc: RTCPeerConnection, timeoutMs: number): Promise<void>;
+export declare function listenForOffers(ws: WebSocket, cb: (pipe: WebRtcPipe) => void): void;
+//# sourceMappingURL=transport.d.ts.map

package/dist/netcode/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/netcode/transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAQ7C,MAAM,MAAM,UAAU,GAAG;IACvB,cAAc,EAAE,iBAAiB,CAAC;IAClC,QAAQ,EAAE,cAAc,CAAC;IACzB,UAAU,EAAE,cAAc,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAsB,OAAO,CAC3B,EAAE,EAAE,SAAS,EACb,MAAM,EAAE,MAAM;AACd,sBAAsB;AACtB,SAAS,GAAE,MAAc,GACxB,OAAO,CAAC,UAAU,CAAC,CAiCrB;AAED,wBAAsB,SAAS,CAAC,EAAE,EAAE,cAAc,iBA6BjD;AAED,wBAAsB,iBAAiB,CAAC,EAAE,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,iBAc5E;AAED,wBAAsB,SAAS,CAC7B,EAAE,EAAE,iBAAiB,EACrB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,GAAG,KAAK,CAAC,CAkB1B;AAED,wBAAsB,aAAa,CACjC,EAAE,EAAE,SAAS,EACb,EAAE,EAAE,iBAAiB,EACrB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CA4Bf;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,QAwE5E"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bloopjs/web",
-  "version": "0.0.44",
+  "version": "0.0.45",
   "author": "Neil Sarkar",
   "type": "module",
   "repository": {
@@ -33,7 +33,8 @@
     "typescript": "^5"
   },
   "dependencies": {
-    "@bloopjs/bloop": "0.0.44",
-    "@bloopjs/engine": "0.0.44"
+    "@bloopjs/bloop": "0.0.45",
+    "@bloopjs/engine": "0.0.45",
+    "partysocket": "^1.1.6"
   }
 }

package/src/App.ts

@@ -1,6 +1,11 @@
 import { type Bloop, type MountOpts, mount, type Sim } from "@bloopjs/bloop";
 import type { Key } from "@bloopjs/engine";
 import { mouseButtonCodeToMouseButton } from "@bloopjs/engine";
+import {
+  joinRoom as joinRoomInternal,
+  type RoomEvents,
+} from "./netcode/broker";
+import { logger } from "./netcode/logs.ts";
 
 export type StartOptions = {
   /** A bloop game instance */
@@ -13,8 +18,12 @@ export type StartOptions = {
   startPaused?: boolean;
   /** Whether the sim should be recording to tape from initialization, defaults to true */
   startRecording?: boolean;
+  /** URL for the WebRTC signaling broker (e.g. "wss://broker.example.com/ws") */
+  brokerUrl?: string;
 };
 
+const DEFAULT_BROKER_URL = "wss://webrtc-divine-glade-8064.fly.dev/ws";
+
 /** Start a bloop game on the web */
 export async function start(opts: StartOptions): Promise<App> {
   if (!opts.sim) {
@@ -26,29 +35,46 @@ export async function start(opts: StartOptions): Promise<App> {
     opts.sim = sim;
   }
 
-  const app = new App(opts.sim, opts.game);
+  const app = new App(
+    opts.sim,
+    opts.game,
+    opts.brokerUrl ?? DEFAULT_BROKER_URL,
+  );
   return app;
 }
 
+/**
+ * The main application class for running a bloop game in the browser
+ *
+ * This class handles translating browser events and APIs to bloopjs and the wasm engine.
+ *
+ * Usually instantiated with the start() function
+ */
 export class App {
   #sim: Sim;
   game: Bloop<any>;
+  /** URL for the WebRTC signaling broker */
+  readonly brokerUrl: string;
   /** RequestAnimationFrame handle for cancelling */
   #rafHandle: number | null = null;
   #unsubscribe: UnsubscribeFn | null = null;
   #now: number = performance.now();
 
-  constructor(sim: Sim, game: Bloop<any>) {
+  constructor(sim: Sim, game: Bloop<any>, brokerUrl: string) {
     this.#sim = sim;
     this.game = game;
+    this.brokerUrl = brokerUrl;
 
     this.game.hooks.beforeFrame = (frame: number) => {
+      logger.frameNumber = this.#sim.time.frame;
+      logger.matchFrame = this.#sim.wasm.get_match_frame();
       this.beforeFrame.notify(frame);
     };
 
     this.subscribe();
   }
 
+  /** The simulation instance associated with this app */
   get sim(): Sim {
     return this.#sim;
   }
@@ -57,7 +83,14 @@ export class App {
     this.#sim = sim;
   }
 
+  /** Join a multiplayer room via the broker */
+  joinRoom(roomId: string, callbacks: RoomEvents): void {
+    joinRoomInternal(this.brokerUrl, roomId, callbacks);
+  }
+
+  /** Event listeners for before a frame is processed */
   beforeFrame: ReturnType<typeof createListener> = createListener<[number]>();
+  /** Event listeners for after a frame is processed */
   afterFrame: ReturnType<typeof createListener> = createListener<[number]>();
 
   /** Subscribe to the browser events and start the render loop */
@@ -176,11 +209,23 @@ export class App {
     this.afterFrame.unsubscribeAll();
   }
 
+  /**
+   * Accept Hot Module Replacement when running in a vite dev server
+   *
+   * @example
+   *
+   * ```ts
+   * import.meta.hot?.accept("./game", async (newModule) => {
+   *   await app.acceptHmr(newModule?.game, {
+   *   wasmUrl: monorepoWasmUrl,
+   * });
+   * ```
+   */
   async acceptHmr(module: any, opts?: Partial<MountOpts>): Promise<void> {
     const game = (module.game ?? module) as Bloop<any>;
     if (!game.hooks) {
       throw new Error(
-        `HMR: missing game.hooks export on module: ${JSON.stringify(module)}`
+        `HMR: missing game.hooks export on module: ${JSON.stringify(module)}`,
       );
     }
 

package/src/mod.ts

@@ -1 +1,2 @@
 export { App, start } from "./App.ts";
+export * from "./netcode/mod.ts";

package/src/netcode/broker.ts

@@ -0,0 +1,136 @@
+import { WebSocket } from "partysocket";
+import { logger } from "./logs.ts";
+import type { BrokerMessage } from "./protocol.ts";
+import {
+  connect,
+  listenForOffers,
+  logErrors,
+  logPeerConnection,
+  type WebRtcPipe,
+} from "./transport.ts";
+
+export type RoomEvents = {
+  onBrokerMessage: (message: BrokerMessage) => void;
+  onPeerIdAssign: (peerId: string) => void;
+  onPeerConnected: (peerId: string) => void;
+  onPeerDisconnected: (peerId: string) => void;
+
+  onDataChannelOpen: (
+    peerId: string,
+    reliable: boolean,
+    channel: RTCDataChannel
+  ) => void;
+  onMessage: (peerId: string, data: Uint8Array, reliable: boolean) => void;
+  onDataChannelClose: (peerId: string, reliable: boolean) => void;
+};
+
+export function joinRoom(
+  brokerUrl: string,
+  _roomId: string,
+  cbs: RoomEvents
+) {
+  const broker = new WebSocket(brokerUrl);
+
+  broker.addEventListener("open", () => {
+    logger.log({
+      source: "ws",
+      label: "Connection opened",
+    });
+  });
+
+  broker.addEventListener("close", (event) => {
+    logger.warn({
+      source: "ws",
+      label: "Connection closed",
+      json: event,
+    });
+  });
+
+  broker.addEventListener("error", (event) => {
+    logger.error({
+      source: "ws",
+      label: "Connection error",
+      json: event,
+    });
+  });
+
+  const pipes: Map<string, WebRtcPipe> = new Map();
+
+  let ourId = "";
+
+  broker.addEventListener("message", async (event) => {
+    try {
+      const envelope = JSON.parse(event.data) as BrokerMessage;
+      logger.log({
+        source: "ws",
+        direction: "inbound",
+        json: envelope,
+      });
+
+      switch (envelope.type) {
+        case "welcome":
+          ourId = envelope.yourId;
+          cbs.onPeerIdAssign(envelope.yourId);
+          for (const peerId of envelope.peerIds) {
+            if (peerId === ourId) continue;
+            cbs.onPeerConnected(peerId);
+          }
+          break;
+        case "message:json":
+          break;
+        case "peer:connect": {
+          const pipe = await connect(broker, envelope.peerId);
+          registerPipe(pipe, cbs);
+          cbs.onPeerConnected(envelope.peerId);
+          break;
+        }
+        case "peer:disconnect":
+          cbs.onPeerDisconnected(envelope.peerId);
+          break;
+        default:
+          logger.warn({
+            source: "ws",
+            label: `Unknown message type: ${envelope.type}`,
+            json: envelope,
+          });
+      }
+    } catch (e) {
+      logger.error({
+        source: "ws",
+        label: "Failed to parse json",
+        json: {
+          data: event.data,
+          error: e,
+        },
+      });
+    }
+  });
+
+  listenForOffers(broker, (pipe) => {
+    registerPipe(pipe, cbs);
+  });
+
+  function registerPipe(pipe: WebRtcPipe, cbs: RoomEvents) {
+    logErrors(pipe.reliable);
+    logErrors(pipe.unreliable);
+    logPeerConnection(pipe.peerConnection, ourId);
+
+    cbs.onDataChannelOpen(pipe.peerId, true, pipe.reliable);
+    cbs.onDataChannelOpen(pipe.peerId, false, pipe.unreliable);
+
+    pipe.reliable.onmessage = (event) => {
+      cbs.onMessage(pipe.peerId, event.data, true);
+    };
+    pipe.reliable.onclose = () => {
+      cbs.onDataChannelClose(pipe.peerId, true);
+    };
+
+    pipe.unreliable.onmessage = (event) => {
+      cbs.onMessage(pipe.peerId, event.data, false);
+    };
+    pipe.unreliable.onclose = () => {
+      cbs.onDataChannelClose(pipe.peerId, false);
+    };
+    pipes.set(pipe.peerId, pipe);
+  }
+}

package/src/netcode/logs.ts

@@ -0,0 +1,81 @@
+import type { PeerId } from "./protocol.ts";
+
+export type Log = {
+  source: "webrtc" | "ws" | "local" | "rollback";
+  /** absolute frame number since the start of the sim */
+  frame_number: number;
+  /** relative frame number since the start of the current session */
+  match_frame: number | null;
+  /** unix timestamp */
+  timestamp: number;
+  severity: LogSeverity;
+  label?: string;
+  json?: any;
+  // webrtc stuff
+  direction?: LogDirection;
+  from?: PeerId;
+  to?: PeerId;
+  reliable?: boolean;
+  packet?: {
+    size: number;
+    bytes: Uint8Array;
+  };
+};
+
+export type LogOpts = Partial<Log> & {
+  source: Log["source"];
+};
+
+export type LogDirection = "inbound" | "outbound";
+
+export type LogSeverity = "debug" | "log" | "warn" | "error";
+
+export type OnLogCallback = (log: Log) => void;
+
+export type Logger = {
+  onLog: OnLogCallback | null;
+
+  matchFrame: number;
+  frameNumber: number;
+
+  log(opts: LogOpts): void;
+  warn(opts: LogOpts): void;
+  error(opts: LogOpts): void;
+}
+
+export const logger: Logger = {
+  onLog: null as OnLogCallback | null,
+
+  matchFrame: -1,
+  frameNumber: -1,
+
+  log(opts: LogOpts) {
+    this.onLog?.({
+      ...opts,
+      frame_number: this.frameNumber,
+      match_frame: this.matchFrame >= 0 ? this.matchFrame : null,
+      timestamp: Date.now(),
+      severity: "log",
+    });
+  },
+
+  warn(opts: LogOpts) {
+    this.onLog?.({
+      ...opts,
+      frame_number: this.frameNumber,
+      match_frame: this.matchFrame >= 0 ? this.matchFrame : null,
+      timestamp: Date.now(),
+      severity: "warn",
+    });
+  },
+
+  error(opts: LogOpts) {
+    this.onLog?.({
+      ...opts,
+      frame_number: this.frameNumber,
+      match_frame: this.matchFrame >= 0 ? this.matchFrame : null,
+      timestamp: Date.now(),
+      severity: "error",
+    });
+  },
+};

package/src/netcode/mod.ts

@@ -0,0 +1,14 @@
+// biome-ignore assist/source/organizeImports: organized by hand
+export type { PeerId, BrokerMessage, PeerMessage } from "./protocol.ts";
+export type {
+  Log,
+  LogOpts,
+  LogDirection,
+  LogSeverity,
+  OnLogCallback,
+} from "./logs.ts";
+export type { WebRtcPipe } from "./transport.ts";
+export type { RoomEvents } from "./broker.ts";
+
+export { PacketType } from "./protocol.ts";
+export { logger } from "./logs.ts";

package/src/netcode/protocol.ts

@@ -0,0 +1,56 @@
+export type PeerId = string;
+
+// TODO: bring the websocket server from neilsarkar/labs into this repo
+
+// Wire format packet types
+export enum PacketType {
+  None = 0,
+  Inputs = 1,
+}
+
+export type BrokerMessage =
+  | {
+      type: "welcome";
+      yourId: PeerId;
+      peerIds: PeerId[];
+      serverId: string;
+    }
+  | {
+      type: "message:json";
+      peerId: PeerId;
+      message: PeerMessage;
+    }
+  | {
+      type: "message:string";
+      peerId: PeerId;
+      message: string;
+    }
+  | {
+      type: "message:buffer";
+      peerId: PeerId;
+      message: ArrayBuffer;
+    }
+  | {
+      type: "peer:connect";
+      peerId: PeerId;
+    }
+  | {
+      type: "peer:disconnect";
+      peerId: PeerId;
+    };
+
+export type PeerMessage =
+  | {
+      type: "offer";
+      target: string;
+      payload: string;
+    }
+  | {
+      type: "answer";
+      target: string;
+      payload: string;
+    }
+  | {
+      type: "message";
+      payload: any;
+    };