@colyseus/shared-types 0.17.0

package/LICENSE

@@ -0,0 +1,21 @@
+Copyright (c) 2015-2026 Endel Dreyer
+
+MIT License:
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,114 @@
+<div align="center">
+  <a href="https://github.com/colyseus/colyseus">
+    <img src="media/logo.svg?raw=true" width="60%" height="300" />
+  </a>
+  <br>
+  <br>
+  <a href="https://npmjs.com/package/colyseus">
+    <img src="https://img.shields.io/npm/dm/colyseus.svg?style=for-the-badge&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAQAAAC1+jfqAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAAAmJLR0QAAKqNIzIAAAAJcEhZcwAADsQAAA7EAZUrDhsAAAAHdElNRQfjAgETESWYxR33AAAAtElEQVQoz4WQMQrCQBRE38Z0QoTcwF4Qg1h4BO0sxGOk80iCtViksrIQRRBTewWxMI1mbELYjYu+4rPMDPtn12ChMT3gavb4US5Jym0tcBIta3oDHv4Gwmr7nC4QAxBrCdzM2q6XqUnm9m9r59h7Rc0n2pFv24k4ttGMUXW+sGELTJjSr7QDKuqLS6UKFChVWWuFkZw9Z2AAvAirKT+JTlppIRnd6XgaP4goefI2Shj++OnjB3tBmHYK8z9zAAAAJXRFWHRkYXRlOmNyZWF0ZQAyMDE5LTAyLTAxVDE4OjE3OjM3KzAxOjAwGQQixQAAACV0RVh0ZGF0ZTptb2RpZnkAMjAxOS0wMi0wMVQxODoxNzozNyswMTowMGhZmnkAAAAZdEVYdFNvZnR3YXJlAHd3dy5pbmtzY2FwZS5vcmeb7jwaAAAAAElFTkSuQmCC">
+  </a>
+  <a href="http://chat.colyseus.io">
+    <img src="https://img.shields.io/discord/525739117951320081.svg?style=for-the-badge&colorB=7581dc&logo=discord&logoColor=white">
+  </a>
+  <a href="https://github.com/colyseus/colyseus/discussions" title="Discuss Forum">
+    <img src="https://img.shields.io/badge/discuss-forum-brightgreen.svg?style=for-the-badge&colorB=0069b8&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAQAAAC1+jfqAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAAAmJLR0QAAKqNIzIAAAAJcEhZcwAADsQAAA7EAZUrDhsAAAAHdElNRQfjAgETDROxCNUzAAABB0lEQVQoz4WRvyvEARjGP193CnWRH+dHQmGwKZtFGcSmxHAL400GN95ktIpV2dzlLzDJgsGgGNRdDAzoQueS/PgY3HXHyT3T+/Y87/s89UANBKXBdoZo5J6L4K1K5ZxHfnjnlQUf3bKvkgy57a0r9hS3cXfMO1kWJMza++tj3Ac7/LY343x1NA9cNmYMwnSS/SP8JVFuSJmr44iFqvtmpjhmhBCrOOazCesq6H4P3bPBjFoIBydOk2bUA17I080Es+wSZ51B4DIA2zgjSpYcEe44Js01G0XjRcCU+y4ZMrDeLmfc9EnVd5M/o0VMeu6nJZxWJivLmhyw1WHTvrr2b4+2OFqra+ALwouTMDcqmjMAAAAldEVYdGRhdGU6Y3JlYXRlADIwMTktMDItMDFUMTg6MTM6MTkrMDE6MDAC9f6fAAAAJXRFWHRkYXRlOm1vZGlmeQAyMDE5LTAyLTAxVDE4OjEzOjE5KzAxOjAwc6hGIwAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAAAASUVORK5CYII=" alt="Discussion forum" />
+  </a>
+  <h3>
+    Multiplayer Framework for Node.js. <br /><a href="https://docs.colyseus.io/">View documentation</a>
+  </h3>
+</div>
+
+Colyseus is an Authoritative Multiplayer Framework for Node.js, with SDKs
+available for the Web, Unity, Defold, Haxe, Cocos and Construct3. ([See official SDKs](https://docs.colyseus.io/client/))
+
+The project focuses on providing synchronizable data structures for realtime and
+turn-based games, matchmaking, and ease of usage both on the server-side and
+client-side.
+
+The mission of the framework is to be a standard netcode & matchmaking solution
+for any kind of project you can think of!
+
+## Key features:
+
+- WebSocket-based communication
+- Simple API in the server-side and client-side.
+- Automatic state synchronization from server-to-client (delta compressed)
+- Matchmaking clients into game rooms/sessions
+- Scale vertically or horizontally
+
+See [public roadmap](https://docs.colyseus.io/roadmap) for version 1.0.
+
+# 🚀 Quickstart
+
+Create a bare-bones Colyseus server by using `npm create colyseus-app@latest`:
+
+```
+npm create colyseus-app@latest my-colyseus-server
+cd my-colyseus-server
+npm start
+```
+
+# Sponsors
+
+The sustainability of the project relies on **Colyseus Cloud** subscriptions and sponsorships. If you are not using Colyseus Cloud, please consider [sponsoring the project](https://github.com/sponsors/endel) 💖
+
+<a href="https://cdn.jsdelivr.net/gh/colyseus/.github/sponsorkit/sponsors.svg">
+  <img src="https://cdn.jsdelivr.net/gh/colyseus/.github/sponsorkit/sponsors.svg" width="100%" />
+</a>
+
+# Contributors ✨
+
+Thanks goes to these wonderful people ([emoji key](https://github.com/kentcdodds/all-contributors#emoji-key)):
+
+<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
+<!-- prettier-ignore-start -->
+<!-- markdownlint-disable -->
+<table>
+  <tr>
+    <td align="center"><a href="https://github.com/halftheopposite/"><img src="https://avatars0.githubusercontent.com/u/5473864?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Aymeric Chauvin</b></sub></a><br /><a href="#question-halftheopposite" title="Answering Questions">💬</a> <a href="#example-halftheopposite" title="Examples">💡</a></td>
+    <td align="center"><a href="https://github.com/brian-hay"><img src="https://avatars2.githubusercontent.com/u/1428000?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Brian Hay</b></sub></a><br /><a href="#content-brian-hay" title="Content">🖋</a></td>
+    <td align="center"><a href="https://github.com/damian-pastorini"><img src="https://avatars2.githubusercontent.com/u/1211779?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Damian A. Pastorini</b></sub></a><br /><a href="#question-damian-pastorini" title="Answering Questions">💬</a> <a href="https://github.com/colyseus/colyseus/commits?author=damian-pastorini" title="Documentation">📖</a> <a href="https://github.com/colyseus/colyseus/issues?q=author%3Adamian-pastorini" title="Bug reports">🐛</a></td>
+    <td align="center"><a href="https://github.com/Zielak"><img src="https://avatars0.githubusercontent.com/u/625693?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Darek Greenly</b></sub></a><br /><a href="#question-Zielak" title="Answering Questions">💬</a> <a href="https://github.com/colyseus/colyseus/issues?q=author%3AZielak" title="Bug reports">🐛</a> <a href="https://github.com/colyseus/colyseus/commits?author=Zielak" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/Vidski"><img src="https://avatars.githubusercontent.com/u/36316706?v=4?s=100" width="100px;" alt=""/><br /><sub><b>David Rydwanski</b></sub></a><br /><a href="#question-Vidski" title="Answering Questions">💬</a> <a href="https://github.com/colyseus/colyseus/commits?author=Vidski" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/drburton"><img src="https://avatars0.githubusercontent.com/u/625595?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Dr. Burton</b></sub></a><br /><a href="#mentoring-drburton" title="Mentoring">🧑‍🏫</a></td>
+    <td align="center"><a href="https://twitter.com/endel"><img src="https://avatars3.githubusercontent.com/u/130494?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Endel Dreyer</b></sub></a><br /><a href="https://github.com/colyseus/colyseus/commits?author=endel" title="Code">💻</a> <a href="https://github.com/colyseus/colyseus/commits?author=endel" title="Documentation">📖</a> <a href="#example-endel" title="Examples">💡</a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/enriqueto"><img src="https://avatars2.githubusercontent.com/u/5557196?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Enriqueto</b></sub></a><br /><a href="#business-enriqueto" title="Business development">💼</a></td>
+    <td align="center"><a href="https://github.com/fazriz"><img src="https://avatars0.githubusercontent.com/u/2628698?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Fazri Zubair</b></sub></a><br /><a href="#business-fazriz" title="Business development">💼</a></td>
+    <td align="center"><a href="https://twitter.com/Federkun"><img src="https://avatars2.githubusercontent.com/u/21344385?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Federico</b></sub></a><br /><a href="https://github.com/colyseus/colyseus/issues?q=author%3AFederkun" title="Bug reports">🐛</a> <a href="https://github.com/colyseus/colyseus/commits?author=Federkun" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/mobyjames/"><img src="https://avatars0.githubusercontent.com/u/1327007?v=4?s=100" width="100px;" alt=""/><br /><sub><b>James Jacoby</b></sub></a><br /><a href="#question-mobyjames" title="Answering Questions">💬</a> <a href="#example-mobyjames" title="Examples">💡</a> <a href="#content-mobyjames" title="Content">🖋</a></td>
+    <td align="center"><a href="http://wenish.github.io/portfolio/"><img src="https://avatars0.githubusercontent.com/u/18367963?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Jonas Voland</b></sub></a><br /><a href="#question-Wenish" title="Answering Questions">💬</a> <a href="https://github.com/colyseus/colyseus/issues?q=author%3AWenish" title="Bug reports">🐛</a> <a href="https://github.com/colyseus/colyseus/commits?author=Wenish" title="Code">💻</a> <a href="#ideas-Wenish" title="Ideas, Planning, & Feedback">🤔</a> <a href="#example-Wenish" title="Examples">💡</a></td>
+    <td align="center"><a href="http://seiyria.com"><img src="https://avatars0.githubusercontent.com/u/763609?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Kyle J. Kemp</b></sub></a><br /><a href="#question-seiyria" title="Answering Questions">💬</a> <a href="https://github.com/colyseus/colyseus/issues?q=author%3Aseiyria" title="Bug reports">🐛</a> <a href="https://github.com/colyseus/colyseus/commits?author=seiyria" title="Code">💻</a> <a href="#ideas-seiyria" title="Ideas, Planning, & Feedback">🤔</a></td>
+    <td align="center"><a href="https://github.com/LukeWood/"><img src="https://avatars0.githubusercontent.com/u/12191303?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Luke Wood</b></sub></a><br /><a href="#question-LukeWood" title="Answering Questions">💬</a> <a href="https://github.com/colyseus/colyseus/issues?q=author%3ALukeWood" title="Bug reports">🐛</a> <a href="https://github.com/colyseus/colyseus/commits?author=LukeWood" title="Code">💻</a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/doorbash"><img src="https://avatars2.githubusercontent.com/u/5982526?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Milad Doorbash</b></sub></a><br /><a href="https://github.com/colyseus/colyseus/issues?q=author%3Adoorbash" title="Bug reports">🐛</a> <a href="https://github.com/colyseus/colyseus/commits?author=doorbash" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/TinyDobbins"><img src="https://avatars2.githubusercontent.com/u/20824844?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Nikita Borisov</b></sub></a><br /><a href="https://github.com/colyseus/colyseus/issues?q=author%3ATinyDobbins" title="Bug reports">🐛</a> <a href="https://github.com/colyseus/colyseus/commits?author=TinyDobbins" title="Code">💻</a> <a href="#business-TinyDobbins" title="Business development">💼</a> <a href="#ideas-TinyDobbins" title="Ideas, Planning, & Feedback">🤔</a></td>
+    <td align="center"><a href="https://acemobe.com/"><img src="https://avatars2.githubusercontent.com/u/232101?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Phil Harvey</b></sub></a><br /><a href="https://github.com/colyseus/colyseus/commits?author=filharvey" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://github.com/serjek"><img src="https://avatars2.githubusercontent.com/u/18265157?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Sergey</b></sub></a><br /><a href="https://github.com/colyseus/colyseus/issues?q=author%3Aserjek" title="Bug reports">🐛</a> <a href="https://github.com/colyseus/colyseus/commits?author=serjek" title="Code">💻</a></td>
+    <td align="center"><a href="https://devlsh.com"><img src="https://avatars0.githubusercontent.com/u/853683?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Sophie</b></sub></a><br /><a href="#question-devlsh" title="Answering Questions">💬</a> <a href="https://github.com/colyseus/colyseus/issues?q=author%3Adevlsh" title="Bug reports">🐛</a> <a href="#ideas-devlsh" title="Ideas, Planning, & Feedback">🤔</a></td>
+    <td align="center"><a href="https://github.com/supertommy"><img src="https://avatars0.githubusercontent.com/u/2236153?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Tommy Leung</b></sub></a><br /><a href="#mentoring-supertommy" title="Mentoring">🧑‍🏫</a></td>
+    <td align="center"><a href="https://github.com/digimbyte"><img src="https://avatars2.githubusercontent.com/u/6645396?v=4?s=100" width="100px;" alt=""/><br /><sub><b>digimbyte</b></sub></a><br /><a href="https://github.com/colyseus/colyseus/commits?author=digimbyte" title="Documentation">📖</a></td>
+  </tr>
+</table>
+
+<!-- markdownlint-restore -->
+<!-- prettier-ignore-end -->
+
+<!-- ALL-CONTRIBUTORS-LIST:END -->
+
+This project follows the [all-contributors](https://github.com/kentcdodds/all-contributors) specification.
+Contributions of any kind are welcome!
+
+# Contributing
+
+We encourage you to contribute to Colyseus! Please check out the [Contributing
+guide](.github/CONTRIBUTING.md) for guidelines about how to proceed. Join us!
+
+Everyone interacting in Colyseus and its sub-projects' codebases, issue trackers
+and chat rooms is expected to follow the [code of conduct](CODE_OF_CONDUCT.md).
+
+# License
+
+MIT

package/build/index.cjs

@@ -0,0 +1,18 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// packages/shared-types/src/index.ts
+var index_exports = {};
+module.exports = __toCommonJS(index_exports);

package/build/index.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts"],
+  "sourcesContent": ["import type { StandardSchemaV1 } from '@standard-schema/spec';\n\n// Re-export StandardSchemaV1 for convenience\nexport type { StandardSchemaV1 };\n\n/**\n * Minimal Room-like interface for SDK type inference.\n * Allows typing SDK methods without depending on @colyseus/core.\n */\nexport interface ServerRoomLike<State = any, Options = any> {\n  state: State;\n  onJoin: (client: any, options?: Options, auth?: any) => any;\n  messages?: Record<string, any>;\n  '~client'?: { '~messages'?: Record<string, any> };\n}\n\n/**\n * Seat reservation returned by matchmaking operations.\n */\nexport interface ISeatReservation {\n  name: string;\n  sessionId: string;\n  roomId: string;\n  publicAddress?: string;\n  processId?: string;\n  reconnectionToken?: string;\n  devMode?: boolean;\n}\n\n/**\n * Helper types for flexible Room generics on the client SDK.\n * Allows: Room<State>, Room<ServerRoom>, or Room<ServerRoom, State>\n */\nexport type InferState<T, S> = [S] extends [never]\n    ? (T extends abstract new (...args: any) => { state: infer ST }\n        ? ST  // Constructor type (typeof MyRoom): extract state from instance\n        : T extends { state: infer ST }\n            ? ST  // Instance type (MyRoom): extract state directly\n            : T)  // State type or other: return as-is\n    : S;\n\n/**\n * Extract room messages type from a Room constructor or instance type.\n * Supports both constructor types (typeof MyRoom) and instance types (MyRoom)\n */\nexport type ExtractRoomMessages<T> = T extends abstract new (...args: any) => { messages: infer M }\n    ? M\n    : T extends { messages: infer M }\n        ? M\n        : {};\n\n/**\n * Extract client-side messages type from a Room constructor or instance type.\n * These are messages that the server can send to the client.\n */\nexport type ExtractRoomClientMessages<T> = T extends abstract new (...args: any) => { '~client': { '~messages': infer M } }\n    ? M\n    : T extends { '~client': { '~messages': infer M } }\n        ? M\n        : {};\n\n/**\n * Message handler with automatic type inference from format schema.\n * When a format is provided, the message type is automatically inferred from the schema.\n *\n * @template T - The StandardSchema type for message validation\n * @template Client - The client type (from @colyseus/core Transport)\n * @template This - The Room class context\n */\nexport type MessageHandlerWithFormat<T extends StandardSchemaV1 = any, Client = any, This = any> = {\n  format: T;\n  handler: (this: This, client: Client, message: StandardSchemaV1.InferOutput<T>) => void;\n};\n\n/**\n * Message handler type that can be either a function or a format handler with validation.\n *\n * @template Client - The client type (from @colyseus/core Transport)\n * @template This - The Room class context\n */\nexport type MessageHandler<Client = any, This = any> =\n  | ((this: This, client: Client, message: any) => void)\n  | MessageHandlerWithFormat<any, Client, This>;\n\n/**\n * Extract the message payload type from a message handler.\n * Works with both function handlers and format handlers.\n */\nexport type ExtractMessageType<T> =\n  T extends { format: infer Format extends StandardSchemaV1; handler: any }\n    ? StandardSchemaV1.InferOutput<Format>\n    : T extends (this: any, client: any, message: infer Message) => void\n      ? Message\n      : any;\n\n/**\n * A map of message types to message handlers.\n *\n * @template Room - The Room class type\n * @template Client - The client type\n */\nexport type Messages<Room = any, Client = any> = Record<string, MessageHandler<Client, Room>>;\n\n/**\n * Exposed types for the client-side SDK.\n * Used by defineServer() to expose room and route types to the client.\n *\n * @template RoomTypes - Record of room names to their RegisteredHandler types\n * @template Routes - Router type from @colyseus/better-call\n */\nexport interface SDKTypes<\n  RoomTypes extends Record<string, any> = any,\n  Routes = any\n> {\n  '~rooms': RoomTypes;\n  '~routes': Routes;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;AAAA;AAAA;",
+  "names": []
+}

package/build/index.d.ts

@@ -0,0 +1,102 @@
+import type { StandardSchemaV1 } from '@standard-schema/spec';
+export type { StandardSchemaV1 };
+/**
+ * Minimal Room-like interface for SDK type inference.
+ * Allows typing SDK methods without depending on @colyseus/core.
+ */
+export interface ServerRoomLike<State = any, Options = any> {
+    state: State;
+    onJoin: (client: any, options?: Options, auth?: any) => any;
+    messages?: Record<string, any>;
+    '~client'?: {
+        '~messages'?: Record<string, any>;
+    };
+}
+/**
+ * Seat reservation returned by matchmaking operations.
+ */
+export interface ISeatReservation {
+    name: string;
+    sessionId: string;
+    roomId: string;
+    publicAddress?: string;
+    processId?: string;
+    reconnectionToken?: string;
+    devMode?: boolean;
+}
+/**
+ * Helper types for flexible Room generics on the client SDK.
+ * Allows: Room<State>, Room<ServerRoom>, or Room<ServerRoom, State>
+ */
+export type InferState<T, S> = [S] extends [never] ? (T extends abstract new (...args: any) => {
+    state: infer ST;
+} ? ST : T extends {
+    state: infer ST;
+} ? ST : T) : S;
+/**
+ * Extract room messages type from a Room constructor or instance type.
+ * Supports both constructor types (typeof MyRoom) and instance types (MyRoom)
+ */
+export type ExtractRoomMessages<T> = T extends abstract new (...args: any) => {
+    messages: infer M;
+} ? M : T extends {
+    messages: infer M;
+} ? M : {};
+/**
+ * Extract client-side messages type from a Room constructor or instance type.
+ * These are messages that the server can send to the client.
+ */
+export type ExtractRoomClientMessages<T> = T extends abstract new (...args: any) => {
+    '~client': {
+        '~messages': infer M;
+    };
+} ? M : T extends {
+    '~client': {
+        '~messages': infer M;
+    };
+} ? M : {};
+/**
+ * Message handler with automatic type inference from format schema.
+ * When a format is provided, the message type is automatically inferred from the schema.
+ *
+ * @template T - The StandardSchema type for message validation
+ * @template Client - The client type (from @colyseus/core Transport)
+ * @template This - The Room class context
+ */
+export type MessageHandlerWithFormat<T extends StandardSchemaV1 = any, Client = any, This = any> = {
+    format: T;
+    handler: (this: This, client: Client, message: StandardSchemaV1.InferOutput<T>) => void;
+};
+/**
+ * Message handler type that can be either a function or a format handler with validation.
+ *
+ * @template Client - The client type (from @colyseus/core Transport)
+ * @template This - The Room class context
+ */
+export type MessageHandler<Client = any, This = any> = ((this: This, client: Client, message: any) => void) | MessageHandlerWithFormat<any, Client, This>;
+/**
+ * Extract the message payload type from a message handler.
+ * Works with both function handlers and format handlers.
+ */
+export type ExtractMessageType<T> = T extends {
+    format: infer Format extends StandardSchemaV1;
+    handler: any;
+} ? StandardSchemaV1.InferOutput<Format> : T extends (this: any, client: any, message: infer Message) => void ? Message : any;
+/**
+ * A map of message types to message handlers.
+ *
+ * @template Room - The Room class type
+ * @template Client - The client type
+ */
+export type Messages<Room = any, Client = any> = Record<string, MessageHandler<Client, Room>>;
+/**
+ * Exposed types for the client-side SDK.
+ * Used by defineServer() to expose room and route types to the client.
+ *
+ * @template RoomTypes - Record of room names to their RegisteredHandler types
+ * @template Routes - Router type from @colyseus/better-call
+ */
+export interface SDKTypes<RoomTypes extends Record<string, any> = any, Routes = any> {
+    '~rooms': RoomTypes;
+    '~routes': Routes;
+}

package/build/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"","sourcesContent":["import type { StandardSchemaV1 } from '@standard-schema/spec';\n\n// Re-export StandardSchemaV1 for convenience\nexport type { StandardSchemaV1 };\n\n/**\n * Minimal Room-like interface for SDK type inference.\n * Allows typing SDK methods without depending on @colyseus/core.\n */\nexport interface ServerRoomLike<State = any, Options = any> {\n  state: State;\n  onJoin: (client: any, options?: Options, auth?: any) => any;\n  messages?: Record<string, any>;\n  '~client'?: { '~messages'?: Record<string, any> };\n}\n\n/**\n * Seat reservation returned by matchmaking operations.\n */\nexport interface ISeatReservation {\n  name: string;\n  sessionId: string;\n  roomId: string;\n  publicAddress?: string;\n  processId?: string;\n  reconnectionToken?: string;\n  devMode?: boolean;\n}\n\n/**\n * Helper types for flexible Room generics on the client SDK.\n * Allows: Room<State>, Room<ServerRoom>, or Room<ServerRoom, State>\n */\nexport type InferState<T, S> = [S] extends [never]\n    ? (T extends abstract new (...args: any) => { state: infer ST }\n        ? ST  // Constructor type (typeof MyRoom): extract state from instance\n        : T extends { state: infer ST }\n            ? ST  // Instance type (MyRoom): extract state directly\n            : T)  // State type or other: return as-is\n    : S;\n\n/**\n * Extract room messages type from a Room constructor or instance type.\n * Supports both constructor types (typeof MyRoom) and instance types (MyRoom)\n */\nexport type ExtractRoomMessages<T> = T extends abstract new (...args: any) => { messages: infer M }\n    ? M\n    : T extends { messages: infer M }\n        ? M\n        : {};\n\n/**\n * Extract client-side messages type from a Room constructor or instance type.\n * These are messages that the server can send to the client.\n */\nexport type ExtractRoomClientMessages<T> = T extends abstract new (...args: any) => { '~client': { '~messages': infer M } }\n    ? M\n    : T extends { '~client': { '~messages': infer M } }\n        ? M\n        : {};\n\n/**\n * Message handler with automatic type inference from format schema.\n * When a format is provided, the message type is automatically inferred from the schema.\n *\n * @template T - The StandardSchema type for message validation\n * @template Client - The client type (from @colyseus/core Transport)\n * @template This - The Room class context\n */\nexport type MessageHandlerWithFormat<T extends StandardSchemaV1 = any, Client = any, This = any> = {\n  format: T;\n  handler: (this: This, client: Client, message: StandardSchemaV1.InferOutput<T>) => void;\n};\n\n/**\n * Message handler type that can be either a function or a format handler with validation.\n *\n * @template Client - The client type (from @colyseus/core Transport)\n * @template This - The Room class context\n */\nexport type MessageHandler<Client = any, This = any> =\n  | ((this: This, client: Client, message: any) => void)\n  | MessageHandlerWithFormat<any, Client, This>;\n\n/**\n * Extract the message payload type from a message handler.\n * Works with both function handlers and format handlers.\n */\nexport type ExtractMessageType<T> =\n  T extends { format: infer Format extends StandardSchemaV1; handler: any }\n    ? StandardSchemaV1.InferOutput<Format>\n    : T extends (this: any, client: any, message: infer Message) => void\n      ? Message\n      : any;\n\n/**\n * A map of message types to message handlers.\n *\n * @template Room - The Room class type\n * @template Client - The client type\n */\nexport type Messages<Room = any, Client = any> = Record<string, MessageHandler<Client, Room>>;\n\n/**\n * Exposed types for the client-side SDK.\n * Used by defineServer() to expose room and route types to the client.\n *\n * @template RoomTypes - Record of room names to their RegisteredHandler types\n * @template Routes - Router type from @colyseus/better-call\n */\nexport interface SDKTypes<\n  RoomTypes extends Record<string, any> = any,\n  Routes = any\n> {\n  '~rooms': RoomTypes;\n  '~routes': Routes;\n}\n"]}

package/build/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@colyseus/shared-types",
+  "version": "0.17.0",
+  "description": "Shared TypeScript types for Colyseus server and client SDK",
+  "type": "module",
+  "input": "./src/index.ts",
+  "main": "./build/index.cjs",
+  "module": "./src/index.ts",
+  "typings": "./build/index.d.ts",
+  "exports": {
+    ".": {
+      "@source": "./src/index.ts",
+      "types": "./build/index.d.ts",
+      "import": "./build/index.mjs",
+      "require": "./build/index.cjs"
+    },
+    "./*": {
+      "@source": "./src/*.ts",
+      "types": "./build/*.d.ts",
+      "import": "./build/*.mjs",
+      "require": "./build/*.cjs"
+    }
+  },
+  "funding": "https://github.com/sponsors/endel",
+  "author": "Endel Dreyer",
+  "license": "MIT",
+  "keywords": [
+    "colyseus",
+    "multiplayer",
+    "types",
+    "typescript"
+  ],
+  "files": [
+    "build",
+    "src"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git://github.com/colyseus/colyseus.git"
+  },
+  "homepage": "https://colyseus.io/",
+  "engines": {
+    "node": ">= 22.x"
+  },
+  "dependencies": {
+    "@standard-schema/spec": "^1.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/index.ts

@@ -0,0 +1,117 @@
+import type { StandardSchemaV1 } from '@standard-schema/spec';
+
+// Re-export StandardSchemaV1 for convenience
+export type { StandardSchemaV1 };
+
+/**
+ * Minimal Room-like interface for SDK type inference.
+ * Allows typing SDK methods without depending on @colyseus/core.
+ */
+export interface ServerRoomLike<State = any, Options = any> {
+  state: State;
+  onJoin: (client: any, options?: Options, auth?: any) => any;
+  messages?: Record<string, any>;
+  '~client'?: { '~messages'?: Record<string, any> };
+}
+
+/**
+ * Seat reservation returned by matchmaking operations.
+ */
+export interface ISeatReservation {
+  name: string;
+  sessionId: string;
+  roomId: string;
+  publicAddress?: string;
+  processId?: string;
+  reconnectionToken?: string;
+  devMode?: boolean;
+}
+
+/**
+ * Helper types for flexible Room generics on the client SDK.
+ * Allows: Room<State>, Room<ServerRoom>, or Room<ServerRoom, State>
+ */
+export type InferState<T, S> = [S] extends [never]
+    ? (T extends abstract new (...args: any) => { state: infer ST }
+        ? ST  // Constructor type (typeof MyRoom): extract state from instance
+        : T extends { state: infer ST }
+            ? ST  // Instance type (MyRoom): extract state directly
+            : T)  // State type or other: return as-is
+    : S;
+
+/**
+ * Extract room messages type from a Room constructor or instance type.
+ * Supports both constructor types (typeof MyRoom) and instance types (MyRoom)
+ */
+export type ExtractRoomMessages<T> = T extends abstract new (...args: any) => { messages: infer M }
+    ? M
+    : T extends { messages: infer M }
+        ? M
+        : {};
+
+/**
+ * Extract client-side messages type from a Room constructor or instance type.
+ * These are messages that the server can send to the client.
+ */
+export type ExtractRoomClientMessages<T> = T extends abstract new (...args: any) => { '~client': { '~messages': infer M } }
+    ? M
+    : T extends { '~client': { '~messages': infer M } }
+        ? M
+        : {};
+
+/**
+ * Message handler with automatic type inference from format schema.
+ * When a format is provided, the message type is automatically inferred from the schema.
+ *
+ * @template T - The StandardSchema type for message validation
+ * @template Client - The client type (from @colyseus/core Transport)
+ * @template This - The Room class context
+ */
+export type MessageHandlerWithFormat<T extends StandardSchemaV1 = any, Client = any, This = any> = {
+  format: T;
+  handler: (this: This, client: Client, message: StandardSchemaV1.InferOutput<T>) => void;
+};
+
+/**
+ * Message handler type that can be either a function or a format handler with validation.
+ *
+ * @template Client - The client type (from @colyseus/core Transport)
+ * @template This - The Room class context
+ */
+export type MessageHandler<Client = any, This = any> =
+  | ((this: This, client: Client, message: any) => void)
+  | MessageHandlerWithFormat<any, Client, This>;
+
+/**
+ * Extract the message payload type from a message handler.
+ * Works with both function handlers and format handlers.
+ */
+export type ExtractMessageType<T> =
+  T extends { format: infer Format extends StandardSchemaV1; handler: any }
+    ? StandardSchemaV1.InferOutput<Format>
+    : T extends (this: any, client: any, message: infer Message) => void
+      ? Message
+      : any;
+
+/**
+ * A map of message types to message handlers.
+ *
+ * @template Room - The Room class type
+ * @template Client - The client type
+ */
+export type Messages<Room = any, Client = any> = Record<string, MessageHandler<Client, Room>>;
+
+/**
+ * Exposed types for the client-side SDK.
+ * Used by defineServer() to expose room and route types to the client.
+ *
+ * @template RoomTypes - Record of room names to their RegisteredHandler types
+ * @template Routes - Router type from @colyseus/better-call
+ */
+export interface SDKTypes<
+  RoomTypes extends Record<string, any> = any,
+  Routes = any
+> {
+  '~rooms': RoomTypes;
+  '~routes': Routes;
+}