@webgamekit/multiplayer-server 0.0.0-stage → 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export type { PlayerPosition, PlayerRotation, PlayerState, MultiplayerServerConfig, MultiplayerServerHandle } from './types';
+export { multiplayerServerCreate, multiplayerServerAttach } from './server';

package/dist/index.js

@@ -0,0 +1,5 @@
+import { a, m as t } from "./server-O9Ueo7hO.js";
+export {
+  a as multiplayerServerAttach,
+  t as multiplayerServerCreate
+};

package/dist/main.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/main.js

@@ -0,0 +1,11 @@
+import { m as s } from "./server-O9Ueo7hO.js";
+const t = 3e3, e = Number(process.env.PORT ?? t), { httpServer: o, cleanup: n } = s();
+o.listen(e, () => {
+  process.stdout.write(`multiplayer-server listening on port ${e}
+`);
+});
+const r = () => {
+  n(), process.exit(0);
+};
+process.on("SIGTERM", r);
+process.on("SIGINT", r);

package/dist/server-O9Ueo7hO.js

@@ -0,0 +1,58 @@
+import { createServer as u } from "node:http";
+import { Server as d } from "socket.io";
+const s = (n, e) => {
+  n.emit("user:list", Object.values(e));
+}, l = (n, e, t, o, a) => {
+  const c = {
+    id: n.id,
+    name: n.id,
+    position: { x: 0, y: 0, z: 0 },
+    rotation: { x: 0, y: 0, z: 0 }
+  };
+  if (o({ ...t(), [n.id]: c }), a.onConnect) {
+    const r = a.onConnect(n.id);
+    Object.entries(r).forEach(([i, m]) => {
+      n.emit(i, m);
+    });
+  }
+  s(e, t()), n.on("user:updated", (r) => {
+    const i = t()[n.id] ?? c;
+    o({
+      ...t(),
+      [n.id]: {
+        ...i,
+        name: r.name ?? i.name,
+        position: r.position,
+        rotation: r.rotation
+      }
+    }), e.emit("user:list", Object.values(t()));
+  }), n.on("disconnect", () => {
+    const { [n.id]: r, ...i } = t();
+    o(i), s(e, t());
+  });
+}, p = (n, e = {}) => {
+  let t = {};
+  const o = () => t, a = (r) => {
+    t = r;
+  }, c = (r) => {
+    l(r, n, o, a, e);
+  };
+  return n.on("connection", c), {
+    cleanup: () => {
+      n.off("connection", c), t = {};
+    }
+  };
+}, b = (n = {}) => {
+  const e = u(), t = new d(e, { cors: n.cors ?? { origin: "*" } }), { cleanup: o } = p(t, n);
+  return {
+    server: t,
+    httpServer: e,
+    cleanup: () => {
+      o(), t.close(), e.close();
+    }
+  };
+};
+export {
+  p as a,
+  b as m
+};

package/dist/server.d.ts

@@ -0,0 +1,19 @@
+import { Server } from 'socket.io';
+import type { MultiplayerServerConfig, MultiplayerServerHandle } from './types';
+/**
+ * Attach multiplayer session handling to a Socket.IO server the caller already owns.
+ * Use this when the application has its own HTTP server; otherwise use multiplayerServerCreate.
+ * @param io - A Socket.IO Server instance
+ * @param config - Optional server configuration
+ * @returns cleanup function that removes the connection listener
+ */
+export declare const multiplayerServerAttach: (io: Server, config?: MultiplayerServerConfig) => {
+    cleanup: () => void;
+};
+/**
+ * Create a Socket.IO server together with the HTTP server it rides on, with multiplayer
+ * session handling already attached. The caller chooses the port via httpServer.listen().
+ * @param config - Optional server configuration
+ * @returns The Socket.IO server, its HTTP server, and a cleanup function
+ */
+export declare const multiplayerServerCreate: (config?: MultiplayerServerConfig) => MultiplayerServerHandle;

package/dist/types.d.ts

@@ -0,0 +1,33 @@
+/// <reference types="node" />
+import type { Server, ServerOptions } from 'socket.io';
+import type { Server as HttpServer } from 'node:http';
+export interface PlayerPosition {
+    x: number;
+    y: number;
+    z: number;
+}
+export interface PlayerRotation {
+    x: number;
+    y: number;
+    z: number;
+}
+export interface PlayerState {
+    id: string;
+    name: string;
+    position: PlayerPosition;
+    rotation: PlayerRotation;
+}
+export interface MultiplayerServerConfig {
+    /** Called when a player connects, returns initial data to send them */
+    onConnect?: (socketId: string) => Record<string, unknown>;
+    /** CORS policy handed to Socket.IO, default: `{ origin: '*' }` */
+    cors?: ServerOptions['cors'];
+}
+export interface MultiplayerServerHandle {
+    /** The Socket.IO server */
+    server: Server;
+    /** The HTTP server it rides on — call `listen()` on this to start accepting players */
+    httpServer: HttpServer;
+    /** Stop listening, drop every handler, and empty the registry */
+    cleanup: () => void;
+}

package/package.json

@@ -1,6 +1,37 @@
 {
   "name": "@webgamekit/multiplayer-server",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cnotv/generative-art.git",
+    "directory": "packages/multiplayer-server"
+  },
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "socket.io": "^4.8.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.0.0",
+    "vite": "^5.0.0",
+    "vitest": "^4.0.18"
+  },
+  "scripts": {
+    "build": "vite build && tsc",
+    "start": "node dist/main.js"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.