@bloopjs/bloop 0.0.80 → 0.0.81

package/dist/sim.d.ts

@@ -1,5 +1,4 @@
-import { type EnginePointer, type Key, type MouseButton, TimeContext, type WasmEngine } from "@bloopjs/engine";
-import { Net } from "./net";
+import { type EnginePointer, type Key, type MouseButton, NetContext, type NetEvent, type NetEventType, TimeContext, type WasmEngine } from "@bloopjs/engine";
 export type EngineHooks = {
     /**
      * Hook to serialize some data when snapshotting
@@ -46,11 +45,6 @@ export declare class Sim {
     #private;
     wasm: WasmEngine;
     id: string;
-    /**
-     * Network API for packet management in multiplayer sessions.
-     * Use this to send/receive packets and query peer network state.
-     */
-    readonly net: Net;
     /**
      * Callback fired when tape buffer fills up and recording stops.
      * The tape data is passed so you can save it before clearing.
@@ -59,6 +53,14 @@ export declare class Sim {
     constructor(wasm: WasmEngine, memory: WebAssembly.Memory, opts?: {
         serialize?: SerializeFn;
     });
+    /**
+     * Step simulation forward by a given number of milliseconds.
+     * If ms is not provided, defaults to 16ms (60fps).
+     *
+     * Note: this will not advance time if the sim is paused.
+     *
+     * @returns Number of frames actually advanced
+     */
     step(ms?: number): number;
     /**
      * Run a single simulation frame. step wraps this in an accumulator.
@@ -73,13 +75,28 @@ export declare class Sim {
      * @param source
      */
     cloneSession(source: Sim): void;
+    /**
+     * Pause the simulation entirely
+     */
     pause(): void;
+    /**
+     * Unpause the simulation
+     */
     unpause(): void;
+    /**
+     * Whether the simulation is currently paused
+     */
     get isPaused(): boolean;
+    /**
+     * Step back one frame
+     */
     stepBack(): void;
     /**
-     * Seek to the start of a given frame
-     * @param frame - frame number to replay to
+     * Seek to the start of a given frame.
+     *
+     * Note that this will mute console output during the seek if rewinding.
+     *
+     * @param frame - frame number to replay up to
      */
     seek(frame: number, inclusive?: boolean): void;
     /**
@@ -113,6 +130,7 @@ export declare class Sim {
      */
     unmount(): void;
     get time(): TimeContext;
+    get net(): NetContext;
     get buffer(): ArrayBuffer;
     get isRecording(): boolean;
     get isReplaying(): boolean;
@@ -124,17 +142,27 @@ export declare class Sim {
         mousedown: (button: MouseButton, peerId?: number) => void;
         mouseup: (button: MouseButton, peerId?: number) => void;
         mousewheel: (x: number, y: number, peerId?: number) => void;
+        /**
+         * Emit a network event (join:ok, peer:join, etc.)
+         * Events are queued in the engine and processed during the next tick's systemsCallback.
+         */
+        network: <T extends NetEventType>(type: T, data: Extract<NetEvent, {
+            type: T;
+        }>["data"]) => void;
+        /**
+         * Receive a packet from a peer
+         */
+        packet: (data: Uint8Array) => void;
     };
     /**
-     * Initialize a multiplayer session with rollback support.
-     * Captures current frame as session start frame.
+     * Get an outbound packet to send to a target peer.
+     * Returns a copy of the packet data (caller owns the returned buffer).
      *
-     * @param peerCount Number of peers in the session
-     */
-    sessionInit(peerCount: number): void;
-    /**
-     * End the current session and clean up rollback state.
+     * The packet contains all unacked inputs encoded in wire format.
+     *
+     * @param targetPeer - Peer ID to send the packet to
+     * @returns Packet data to send, or null if no packet available
      */
-    sessionEnd(): void;
+    getOutboundPacket(targetPeer: number): Uint8Array<ArrayBuffer> | null;
 }
 //# sourceMappingURL=sim.d.ts.map

package/dist/sim.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sim.d.ts","sourceRoot":"","sources":["../src/sim.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sim.d.ts","sourceRoot":"","sources":["../src/sim.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,GAAG,EAER,KAAK,WAAW,EAEhB,UAAU,EACV,KAAK,QAAQ,EACb,KAAK,YAAY,EAGjB,WAAW,EACX,KAAK,UAAU,EAChB,MAAM,iBAAiB,CAAC;AAmBzB,MAAM,MAAM,WAAW,GAAG;IACxB;;OAEG;IACH,SAAS,EAAE,WAAW,CAAC;IACvB;;OAEG;IACH,WAAW,EAAE,aAAa,CAAC;IAC3B;;OAEG;IACH,eAAe,EAAE,eAAe,CAAC;IACjC;;;;OAIG;IACH,SAAS,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;IACzC;;OAEG;IACH,UAAU,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,CAAC;IACzC;;OAEG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,CAC5B,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,aAAa,KACf,IAAI,CAAC;AAEV,MAAM,MAAM,WAAW,GAAG,MAAM;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI,CAAC;CAC1D,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,CAC1B,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,aAAa,EAClB,IAAI,EAAE,MAAM,KACT,IAAI,CAAC;AAEV;;;;;;;GAOG;AACH,qBAAa,GAAG;;IACd,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IAYX;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;gBAGtC,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,WAAW,CAAC,MAAM,EAC1B,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,WAAW,CAAA;KAAE;IAcpC;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM;IAOzB;;;;OAIG;IACH,IAAI,CAAC,cAAc,CAAC,EAAE,OAAO,GAAG,IAAI;IAIpC;;;;;OAKG;IACH,YAAY,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI;IAO/B;;OAEG;IACH,KAAK;IAIL;;OAEG;IACH,OAAO;IAIP;;OAEG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;OAEG;IACH,QAAQ;IAQR;;;;;;OAMG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,OAAO;IAkBvC;;OAEG;IACH,QAAQ,IAAI,UAAU,CAAC,WAAW,CAAC;IAqBnC;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,wBAAwB,SAAmB;IAE3D;;;;OAIG;IACH,MAAM,CACJ,SAAS,GAAE,MAAa,EACxB,cAAc,GAAE,MAAqC;IAUvD;;OAEG;IACH,QAAQ,IAAI,UAAU,CAAC,WAAW,CAAC;IAWnC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,UAAU;IA0BzB;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,UAAU;IAsB5B;;OAEG;IACH,OAAO;IAIP,IAAI,IAAI,IAAI,WAAW,CAYtB;IAED,IAAI,GAAG,IAAI,UAAU,CAYpB;IAED,IAAI,MAAM,IAAI,WAAW,CAExB;IAED,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,IAAI;uBACa,GAAG,WAAU,MAAM,KAAO,IAAI;qBAGhC,GAAG,WAAU,MAAM,KAAO,IAAI;uBAG5B,MAAM,KAAK,MAAM,WAAU,MAAM,KAAO,IAAI;4BAGvC,WAAW,WAAU,MAAM,KAAO,IAAI;0BAGxC,WAAW,WAAU,MAAM,KAAO,IAAI;wBAGxC,MAAM,KAAK,MAAM,WAAU,MAAM,KAAO,IAAI;QAG5D;;;WAGG;kBACO,CAAC,SAAS,YAAY,QACxB,CAAC,QACD,OAAO,CAAC,QAAQ,EAAE;YAAE,IAAI,EAAE,CAAC,CAAA;SAAE,CAAC,CAAC,MAAM,CAAC,KAC3C,IAAI;QAsCP;;WAEG;uBACY,UAAU,KAAG,IAAI;MAsChC;IAEF;;;;;;;;OAQG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CAAC,WAAW,CAAC,GAAG,IAAI;CAmBtE"}

package/dist/system.d.ts

@@ -1,3 +1,4 @@
+import type { NetEvent } from "@bloopjs/engine";
 import type { Context } from "./context";
 import type { BloopSchema } from "./data/schema";
 import type { KeyEvent, MouseButtonEvent, MouseMoveEvent, MouseWheelEvent } from "./events";
@@ -22,5 +23,9 @@ export type System<GS extends BloopSchema = BloopSchema> = {
     mousewheel?: (context: Context<GS> & {
         event: MouseWheelEvent;
     }) => void;
+    /** Handle network events (join:ok, peer:join, etc.) */
+    netcode?: (context: Context<GS> & {
+        event: NetEvent;
+    }) => void;
 };
 //# sourceMappingURL=system.d.ts.map

package/dist/system.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../src/system.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EACV,QAAQ,EACR,gBAAgB,EAChB,cAAc,EACd,eAAe,EAChB,MAAM,UAAU,CAAC;AAElB,MAAM,MAAM,MAAM,CAAC,EAAE,SAAS,WAAW,GAAG,WAAW,IAAI;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;IAExC,OAAO,CAAC,EAAE,CACR,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG;QACrB,KAAK,EAAE,QAAQ,CAAC;KACjB,KACE,IAAI,CAAC;IAEV,KAAK,CAAC,EAAE,CACN,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG;QACrB,KAAK,EAAE,QAAQ,CAAC;KACjB,KACE,IAAI,CAAC;IAEV,SAAS,CAAC,EAAE,CACV,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG;QACrB,KAAK,EAAE,gBAAgB,CAAC;KACzB,KACE,IAAI,CAAC;IAEV,OAAO,CAAC,EAAE,CACR,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG;QACrB,KAAK,EAAE,gBAAgB,CAAC;KACzB,KACE,IAAI,CAAC;IAEV,SAAS,CAAC,EAAE,CACV,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG;QACrB,KAAK,EAAE,cAAc,CAAC;KACvB,KACE,IAAI,CAAC;IAEV,UAAU,CAAC,EAAE,CACX,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG;QACrB,KAAK,EAAE,eAAe,CAAC;KACxB,KACE,IAAI,CAAC;CACX,CAAC"}
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../src/system.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EACV,QAAQ,EACR,gBAAgB,EAChB,cAAc,EACd,eAAe,EAChB,MAAM,UAAU,CAAC;AAElB,MAAM,MAAM,MAAM,CAAC,EAAE,SAAS,WAAW,GAAG,WAAW,IAAI;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;IAExC,OAAO,CAAC,EAAE,CACR,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG;QACrB,KAAK,EAAE,QAAQ,CAAC;KACjB,KACE,IAAI,CAAC;IAEV,KAAK,CAAC,EAAE,CACN,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG;QACrB,KAAK,EAAE,QAAQ,CAAC;KACjB,KACE,IAAI,CAAC;IAEV,SAAS,CAAC,EAAE,CACV,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG;QACrB,KAAK,EAAE,gBAAgB,CAAC;KACzB,KACE,IAAI,CAAC;IAEV,OAAO,CAAC,EAAE,CACR,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG;QACrB,KAAK,EAAE,gBAAgB,CAAC;KACzB,KACE,IAAI,CAAC;IAEV,SAAS,CAAC,EAAE,CACV,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG;QACrB,KAAK,EAAE,cAAc,CAAC;KACvB,KACE,IAAI,CAAC;IAEV,UAAU,CAAC,EAAE,CACX,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG;QACrB,KAAK,EAAE,eAAe,CAAC;KACxB,KACE,IAAI,CAAC;IAEV,uDAAuD;IACvD,OAAO,CAAC,EAAE,CACR,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG;QACrB,KAAK,EAAE,QAAQ,CAAC;KACjB,KACE,IAAI,CAAC;CACX,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bloopjs/bloop",
-  "version": "0.0.80",
+  "version": "0.0.81",
   "author": "Neil Sarkar",
   "type": "module",
   "repository": {
@@ -35,7 +35,7 @@
     "@types/bun": "latest"
   },
   "dependencies": {
-    "@bloopjs/engine": "0.0.80"
+    "@bloopjs/engine": "0.0.81"
   },
   "peerDependencies": {
     "typescript": "^5"

package/src/bloop.ts

@@ -1,8 +1,6 @@
 import {
   type EnginePointer,
   Enums,
-  EVENT_PAYLOAD_ALIGN,
-  EVENT_PAYLOAD_SIZE,
   EVENTS_OFFSET,
   INPUT_CTX_OFFSET,
   InputContext,
@@ -10,6 +8,7 @@ import {
   mouseButtonCodeToMouseButton,
   NET_CTX_OFFSET,
   NetContext,
+  type NetEvent,
   TIME_CTX_OFFSET,
   TimeContext,
 } from "@bloopjs/engine";
@@ -254,8 +253,70 @@ export class Bloop<GS extends BloopSchema> {
                 }),
               );
               break;
+            case Enums.EventType.NetJoinOk: {
+              // Room code is 8 bytes starting at payload offset
+              const roomCodeBytes: number[] = [];
+              for (let j = 0; j < 8; j++) {
+                const byte = eventsDataView.getUint8(payloadOffset + j);
+                if (byte === 0) break;
+                roomCodeBytes.push(byte);
+              }
+              const roomCode = String.fromCharCode(...roomCodeBytes);
+              (this.#context as any).event = {
+                type: "join:ok",
+                data: { roomCode },
+              };
+              system.netcode?.(
+                this.#context as Context<GS> & { event: NetEvent },
+              );
+              break;
+            }
+            case Enums.EventType.NetJoinFail: {
+              // Reason is stored at payload offset as u8
+              const reasonCode = eventsDataView.getUint8(payloadOffset);
+              const reasons = [
+                "unknown",
+                "timeout",
+                "room_full",
+                "room_not_found",
+                "already_in_room",
+              ];
+              const reason = reasons[reasonCode] ?? "unknown";
+              (this.#context as any).event = {
+                type: "join:fail",
+                data: { reason },
+              };
+              system.netcode?.(
+                this.#context as Context<GS> & { event: NetEvent },
+              );
+              break;
+            }
+            case Enums.EventType.NetPeerJoin: {
+              const peerId = eventsDataView.getUint8(payloadOffset);
+              (this.#context as any).event = {
+                type: "peer:join",
+                data: { peerId },
+              };
+              system.netcode?.(
+                this.#context as Context<GS> & { event: NetEvent },
+              );
+              break;
+            }
+            case Enums.EventType.NetPeerLeave: {
+              const peerId = eventsDataView.getUint8(payloadOffset);
+              (this.#context as any).event = {
+                type: "peer:leave",
+                data: { peerId },
+              };
+              system.netcode?.(
+                this.#context as Context<GS> & { event: NetEvent },
+              );
+              break;
+            }
             default:
-              throw new Error(`Unknown event type: ${eventType}`);
+              // Session lifecycle and other internal events are handled by engine
+              // They don't need to be dispatched to game systems
+              break;
           }
           // Event is 12 bytes: kind (1) + source (1) + padding (2) + payload (8)
           offset += 12;

package/src/sim.ts

@@ -4,12 +4,14 @@ import {
   keyToKeyCode,
   type MouseButton,
   mouseButtonToMouseButtonCode,
+  NetContext,
+  type NetEvent,
+  type NetEventType,
   SNAPSHOT_HEADER_ENGINE_LEN_OFFSET,
   SNAPSHOT_HEADER_USER_LEN_OFFSET,
   TimeContext,
   type WasmEngine,
 } from "@bloopjs/engine";
-import { Net } from "./net";
 import { assert } from "./util";
 
 const originalConsole = (globalThis as any).console;
@@ -90,10 +92,10 @@ export class Sim {
   #isPaused: boolean = false;
 
   /**
-   * Network API for packet management in multiplayer sessions.
-   * Use this to send/receive packets and query peer network state.
+   * Shared network context - reads from same WASM memory as game.context.net.
+   * Provides access to network state (status, peers, roomCode, wantsRoomCode, etc.)
    */
-  readonly net: Net;
+  #net: NetContext;
 
   /**
    * Callback fired when tape buffer fills up and recording stops.
@@ -115,9 +117,17 @@ export class Sim {
     this.id = `${Math.floor(Math.random() * 1_000_000)}`;
 
     this.#serialize = opts?.serialize;
-    this.net = new Net(wasm, memory);
+    this.#net = new NetContext();
   }
 
+  /**
+   * Step simulation forward by a given number of milliseconds.
+   * If ms is not provided, defaults to 16ms (60fps).
+   *
+   * Note: this will not advance time if the sim is paused.
+   *
+   * @returns Number of frames actually advanced
+   */
   step(ms?: number): number {
     if (this.#isPaused) {
       return 0;
@@ -147,18 +157,30 @@ export class Sim {
     this.restore(source.snapshot());
   }
 
+  /**
+   * Pause the simulation entirely
+   */
   pause() {
     this.#isPaused = true;
   }
 
+  /**
+   * Unpause the simulation
+   */
   unpause() {
     this.#isPaused = false;
   }
 
+  /**
+   * Whether the simulation is currently paused
+   */
   get isPaused(): boolean {
     return this.#isPaused;
   }
 
+  /**
+   * Step back one frame
+   */
   stepBack() {
     if (this.time.frame === 0) {
       return;
@@ -168,8 +190,11 @@ export class Sim {
   }
 
   /**
-   * Seek to the start of a given frame
-   * @param frame - frame number to replay to
+   * Seek to the start of a given frame.
+   *
+   * Note that this will mute console output during the seek if rewinding.
+   *
+   * @param frame - frame number to replay up to
    */
   seek(frame: number, inclusive?: boolean) {
     assert(
@@ -268,7 +293,9 @@ export class Sim {
     memoryView.set(tape);
 
     // load the tape
-    this.wasm.stop_recording();
+    if (this.isRecording) {
+      this.wasm.stop_recording();
+    }
     const result = this.wasm.load_tape(tapePtr, tape.byteLength);
     assert(result === 0, `failed to load tape, error code=${result}`);
 
@@ -322,6 +349,20 @@ export class Sim {
     return this.#time;
   }
 
+  get net(): NetContext {
+    if (
+      !this.#net.dataView ||
+      this.#net.dataView.buffer !== this.#memory.buffer
+    ) {
+      // update the data view to the latest memory buffer
+      this.#net.dataView = new DataView(
+        this.#memory.buffer,
+        this.wasm.get_net_ctx(),
+      );
+    }
+    return this.#net;
+  }
+
   get buffer(): ArrayBuffer {
     return this.#memory.buffer;
   }
@@ -357,29 +398,120 @@ export class Sim {
     mousewheel: (x: number, y: number, peerId: number = 0): void => {
       this.wasm.emit_mousewheel(x, y, peerId);
     },
-  };
+    /**
+     * Emit a network event (join:ok, peer:join, etc.)
+     * Events are queued in the engine and processed during the next tick's systemsCallback.
+     */
+    network: <T extends NetEventType>(
+      type: T,
+      data: Extract<NetEvent, { type: T }>["data"],
+    ): void => {
+      switch (type) {
+        case "join:ok": {
+          const roomCode = (data as { roomCode: string }).roomCode;
+          const encoded = new TextEncoder().encode(roomCode);
+          const ptr = this.wasm.alloc(encoded.length);
+          new Uint8Array(this.#memory.buffer, ptr, encoded.length).set(encoded);
+          this.wasm.emit_net_join_ok(ptr, encoded.length);
+          this.wasm.free(ptr, encoded.length);
+          break;
+        }
+        case "join:fail":
+          this.wasm.emit_net_join_fail(0); // reason code: unknown
+          break;
+        case "peer:join": {
+          const peerId = (data as { peerId: number }).peerId;
+          this.wasm.emit_net_peer_join(peerId);
+          break;
+        }
+        case "peer:leave": {
+          const peerId = (data as { peerId: number }).peerId;
+          this.wasm.emit_net_peer_leave(peerId);
+          break;
+        }
+        case "peer:assign_local_id": {
+          const peerId = (data as { peerId: number }).peerId;
+          this.wasm.emit_net_peer_assign_local_id(peerId);
+          break;
+        }
+        case "session:start":
+          this.wasm.emit_net_session_init();
+          break;
+        case "session:end":
+          this.wasm.emit_net_session_end();
+          break;
+      }
+    },
 
-  // ─────────────────────────────────────────────────────────────
-  // Session / Rollback
-  // ─────────────────────────────────────────────────────────────
+    /**
+     * Receive a packet from a peer
+     */
+    packet: (data: Uint8Array): void => {
+      if (data.length === 0) {
+        return;
+      }
+
+      // Allocate memory and copy packet
+      const ptr = this.wasm.alloc(data.byteLength);
+      assert(
+        ptr > 0,
+        `Failed to allocate ${data.byteLength} bytes for received packet`,
+      );
+
+      const memoryView = new Uint8Array(
+        this.#memory.buffer,
+        ptr,
+        data.byteLength,
+      );
+      memoryView.set(data);
+
+      // Process the packet
+      const result = this.wasm.emit_receive_packet(ptr, data.byteLength);
+
+      // Free the allocated memory
+      this.wasm.free(ptr, data.byteLength);
+
+      // Check result
+      if (result !== 0) {
+        const errorMessages: Record<number, string> = {
+          1: "No active session",
+          2: "Buffer too small",
+          3: "Unsupported packet version",
+          4: "Invalid event count",
+        };
+        throw new Error(
+          errorMessages[result] ?? `Unknown packet error: ${result}`,
+        );
+      }
+    },
+  };
 
   /**
-   * Initialize a multiplayer session with rollback support.
-   * Captures current frame as session start frame.
+   * Get an outbound packet to send to a target peer.
+   * Returns a copy of the packet data (caller owns the returned buffer).
    *
-   * @param peerCount Number of peers in the session
+   * The packet contains all unacked inputs encoded in wire format.
+   *
+   * @param targetPeer - Peer ID to send the packet to
+   * @returns Packet data to send, or null if no packet available
    */
-  sessionInit(peerCount: number): void {
-    const serializer = this.#serialize ? this.#serialize() : null;
-    const size = serializer ? serializer.size : 0;
-    const result = this.wasm.session_init(peerCount, size);
-    assert(result === 0, `failed to initialize session, error code=${result}`);
-  }
+  getOutboundPacket(targetPeer: number): Uint8Array<ArrayBuffer> | null {
+    // Build the packet in engine memory
+    this.wasm.build_outbound_packet(targetPeer);
 
-  /**
-   * End the current session and clean up rollback state.
-   */
-  sessionEnd(): void {
-    this.wasm.session_end();
+    const len = this.wasm.get_outbound_packet_len();
+    if (len === 0) {
+      throw new Error(`No outbound packet available for peer ${targetPeer}`);
+    }
+
+    const ptr = this.wasm.get_outbound_packet();
+    assert(ptr > 0, `Invalid outbound packet pointer: ${ptr}`);
+
+    // Copy from WASM memory
+    const memoryView = new Uint8Array(this.#memory.buffer, ptr, len);
+    const copy = new Uint8Array(len);
+    copy.set(memoryView);
+
+    return copy;
   }
 }

package/src/system.ts

@@ -1,3 +1,4 @@
+import type { NetEvent } from "@bloopjs/engine";
 import type { Context } from "./context";
 import type { BloopSchema } from "./data/schema";
 import type {
@@ -47,4 +48,11 @@ export type System<GS extends BloopSchema = BloopSchema> = {
       event: MouseWheelEvent;
     },
   ) => void;
+
+  /** Handle network events (join:ok, peer:join, etc.) */
+  netcode?: (
+    context: Context<GS> & {
+      event: NetEvent;
+    },
+  ) => void;
 };

package/dist/net.d.ts

@@ -1,60 +0,0 @@
-import type { WasmEngine } from "@bloopjs/engine";
-/**
- * Network API for packet management in multiplayer sessions.
- *
- * This class provides methods for:
- * - Building outbound packets to send to peers
- * - Processing received packets
- * - Querying peer network state (seq/ack/unacked)
- * - Managing peer connections
- *
- * Access via `sim.net` after initializing a session.
- */
-export declare class Net {
-    #private;
-    constructor(wasm: WasmEngine, memory: WebAssembly.Memory);
-    /**
-     * Set the local peer ID for packet encoding.
-     * Call this after session init to identify which peer we are.
-     */
-    setLocalPeer(peerId: number): void;
-    /**
-     * Mark a peer as connected for packet management.
-     * Call this when a peer joins the session.
-     */
-    connectPeer(peerId: number): void;
-    /**
-     * Mark a peer as disconnected.
-     * Call this when a peer leaves the session.
-     */
-    disconnectPeer(peerId: number): void;
-    /**
-     * Get an outbound packet to send to a target peer.
-     * Returns a copy of the packet data (caller owns the returned buffer).
-     *
-     * The packet contains all unacked inputs encoded in wire format.
-     *
-     * @param targetPeer - Peer ID to send the packet to
-     * @returns Packet data to send, or null if no packet available
-     */
-    getOutboundPacket(targetPeer: number): Uint8Array<ArrayBuffer> | null;
-    /**
-     * Process a received packet from a peer.
-     * This updates seq/ack state and stores events for rollback.
-     *
-     * @param data - Packet data received from the network
-     * @throws Error if packet is invalid
-     */
-    receivePacket(data: Uint8Array): void;
-    /**
-     * Get network state for a specific peer.
-     *
-     * @param peer - Peer ID to query
-     * @returns Object with seq and ack
-     */
-    getPeerState(peer: number): {
-        seq: number;
-        ack: number;
-    };
-}
-//# sourceMappingURL=net.d.ts.map

package/dist/net.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"net.d.ts","sourceRoot":"","sources":["../src/net.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAGjE;;;;;;;;;;GAUG;AACH,qBAAa,GAAG;;gBAIF,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM;IAKxD;;;OAGG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIlC;;;OAGG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIjC;;;OAGG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIpC;;;;;;;;OAQG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CAAC,WAAW,CAAC,GAAG,IAAI;IAoBrE;;;;;;OAMG;IACH,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAuCrC;;;;;OAKG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG;QAC1B,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;KACb;CAMF"}