@signe/room 1.1.0 → 1.1.1

package/dist/index.d.ts

@@ -1,44 +1,5 @@
 import { Request as Request$1, WebSocket, DurableObjectState, AnalyticsEngineDataset, DurableObjectStorage, VectorizeIndex, R2Bucket, KVNamespace } from '@cloudflare/workers-types';
 
-declare function Action(name: string, bodyValidation?: any): (target: any, propertyKey: string) => void;
-interface RoomOptions {
-    path: string;
-    maxUsers?: number;
-    throttleStorage?: number;
-    throttleSync?: number;
-    hibernate?: boolean;
-}
-declare function Room$1(options: RoomOptions): (target: any) => void;
-
-declare class MockPartySocket {
-    private events;
-    id: string;
-    addEventListener(event: any, cb: any): void;
-    removeEventListener(event: any, cb: any): void;
-    _trigger(event: any, data: any): void;
-}
-declare class MockStorage {
-    private storage;
-    get(key: string): Promise<any>;
-    put(key: string, value: any): Promise<void>;
-    list(): Promise<Map<string, any>>;
-}
-declare class MockPartyRoom {
-    id?: string;
-    private clients;
-    storage: MockStorage;
-    constructor(id?: string);
-    connection(client: any): void;
-    broadcast(data: any): void;
-    clear(): void;
-}
-declare class MockConnection {
-    state: any;
-    setState(value: any): void;
-}
-declare const ServerIo: typeof MockPartyRoom;
-declare const ClientIo: typeof MockPartySocket;
-
 type AssetFetcher = {
     fetch(path: string): Promise<Response | null>;
 };
@@ -118,7 +79,7 @@ type CustomBindings = {
     kv: Record<string, KVNamespace>;
 };
 /** Room represents a single, self-contained, long-lived session. */
-type Room = {
+type Room$1 = {
     /** Room ID defined in the Party URL, e.g. /parties/:name/:id */
     id: string;
     /** Internal ID assigned by the platform. Use Party.id instead. */
@@ -209,6 +170,58 @@ type ServerOptions = {
     hibernate?: boolean;
 };
 
+type GuardFn = (sender: Connection, value: any) => boolean | Promise<boolean>;
+type RoomGuardFn = (conn: Connection, ctx: ConnectionContext) => boolean | Promise<boolean>;
+declare function Action(name: string, bodyValidation?: any): (target: any, propertyKey: string) => void;
+interface RoomOptions {
+    path: string;
+    maxUsers?: number;
+    throttleStorage?: number;
+    throttleSync?: number;
+    hibernate?: boolean;
+    guards?: RoomGuardFn[];
+}
+declare function Room(options: RoomOptions): (target: any) => void;
+/**
+ * Room guard decorator
+ * @param guards Array of guard functions to check on connection
+ */
+declare function RoomGuard(guards: RoomGuardFn[]): (target: any) => void;
+/**
+ * Action guard decorator
+ * @param guards Array of guard functions to check before action execution
+ */
+declare function Guard(guards: GuardFn[]): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => void;
+
+declare class MockPartySocket {
+    private events;
+    id: string;
+    addEventListener(event: any, cb: any): void;
+    removeEventListener(event: any, cb: any): void;
+    _trigger(event: any, data: any): void;
+}
+declare class MockStorage {
+    private storage;
+    get(key: string): Promise<any>;
+    put(key: string, value: any): Promise<void>;
+    list(): Promise<Map<string, any>>;
+}
+declare class MockPartyRoom {
+    id?: string;
+    private clients;
+    storage: MockStorage;
+    constructor(id?: string);
+    connection(client: any): void;
+    broadcast(data: any): void;
+    clear(): void;
+}
+declare class MockConnection {
+    state: any;
+    setState(value: any): void;
+}
+declare const ServerIo: typeof MockPartyRoom;
+declare const ClientIo: typeof MockPartySocket;
+
 /**
  * @class Server
  * @implements {Party.Server}
@@ -232,7 +245,7 @@ type ServerOptions = {
  * ```
  */
 declare class Server implements Server$1 {
-    readonly room: Room;
+    readonly room: Room$1;
     subRoom: any;
     rooms: any[];
     /**
@@ -244,7 +257,7 @@ declare class Server implements Server$1 {
      * const server = new MyServer(new ServerIo("game"));
      * ```
      */
-    constructor(room: Room);
+    constructor(room: Room$1);
     /**
       * @readonly
       * @property {boolean} isHibernate - Indicates whether the server is in hibernate mode.
@@ -375,4 +388,4 @@ declare class Server implements Server$1 {
     onClose(conn: Connection): Promise<void>;
 }
 
-export { Action, ClientIo, MockConnection, Room$1 as Room, type RoomOptions, Server, ServerIo };
+export { Action, ClientIo, Guard, MockConnection, Room, RoomGuard, type RoomOptions, Server, ServerIo };

package/dist/index.js

@@ -20,9 +20,27 @@ function Room(options) {
     target.maxUsers = options.maxUsers;
     target.throttleStorage = options.throttleStorage;
     target.throttleSync = options.throttleSync;
+    if (options.guards) {
+      target["_roomGuards"] = options.guards;
+    }
   };
 }
 __name(Room, "Room");
+function RoomGuard(guards) {
+  return function(target) {
+    target["_roomGuards"] = guards;
+  };
+}
+__name(RoomGuard, "RoomGuard");
+function Guard(guards) {
+  return function(target, propertyKey, descriptor) {
+    if (!target.constructor["_actionGuards"]) {
+      target.constructor["_actionGuards"] = /* @__PURE__ */ new Map();
+    }
+    target.constructor["_actionGuards"].set(propertyKey, guards);
+  };
+}
+__name(Guard, "Guard");
 
 // ../sync/src/utils.ts
 function isClass(obj) {
@@ -563,6 +581,14 @@ var Server = class {
     const subRoom = await this.getSubRoom({
       getMemoryAll: true
     });
+    const roomGuards = subRoom.constructor["_roomGuards"] || [];
+    for (const guard of roomGuards) {
+      const isAuthorized = await guard(conn, ctx);
+      if (!isAuthorized) {
+        conn.close();
+        return;
+      }
+    }
     const publicId = generateShortUUID();
     let user = null;
     const signal = this.getUsersProperty(subRoom);
@@ -611,6 +637,13 @@ var Server = class {
       return;
     }
     const subRoom = await this.getSubRoom();
+    const roomGuards = subRoom.constructor["_roomGuards"] || [];
+    for (const guard of roomGuards) {
+      const isAuthorized = await guard(sender, result.data.value);
+      if (!isAuthorized) {
+        return;
+      }
+    }
     const actions = subRoom.constructor["_actionMetadata"];
     if (actions) {
       const signal = this.getUsersProperty(subRoom);
@@ -618,6 +651,13 @@ var Server = class {
       const user = signal?.()[publicId];
       const actionName = actions.get(result.data.action);
       if (actionName) {
+        const guards = subRoom.$actionGuards?.get(actionName.key) || [];
+        for (const guard of guards) {
+          const isAuthorized = await guard(sender, result.data.value);
+          if (!isAuthorized) {
+            return;
+          }
+        }
         if (actionName.bodyValidation) {
           const bodyResult = actionName.bodyValidation.safeParse(result.data.value);
           if (!bodyResult.success) {
@@ -657,8 +697,10 @@ var Server = class {
 export {
   Action,
   ClientIo,
+  Guard,
   MockConnection,
   Room,
+  RoomGuard,
   Server,
   ServerIo
 };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/decorators.ts","../../sync/src/utils.ts","../src/mock.ts","../src/server.ts","../../sync/src/core.ts","../../sync/src/load.ts","../src/utils.ts"],"sourcesContent":["export function Action(name: string, bodyValidation?) {\n  return function (target: any, propertyKey: string) {\n    if (!target.constructor._actionMetadata) {\n      target.constructor._actionMetadata = new Map();\n    }\n    target.constructor._actionMetadata.set(name, {\n      key: propertyKey,\n      bodyValidation,\n    });\n  };\n}\n\nexport interface RoomOptions {\n  path: string;\n  maxUsers?: number;\n  throttleStorage?: number;\n  throttleSync?: number;\n  hibernate?: boolean;\n}\n\nexport function Room(options: RoomOptions) {\n  return function (target: any) {\n    target.path = options.path;\n    target.maxUsers = options.maxUsers;\n    target.throttleStorage = options.throttleStorage;\n    target.throttleSync = options.throttleSync;\n  };\n}\n","/**\n * Checks if the given value is a function.\n *\n * @param {unknown} val - The value to check.\n * @returns {boolean} - True if the value is a function, false otherwise.\n * @example\n * isFunction(function() {}); // true\n * isFunction(() => {}); // true\n * isFunction(123); // false\n */\nexport function isFunction(val: unknown): boolean {\n  return {}.toString.call(val) === \"[object Function]\";\n}\n\n/**\n * Checks if the given object is a class.\n *\n * @param {any} obj - The object to check.\n * @returns {boolean} - True if the object is a class, false otherwise.\n * @example\n * class MyClass {}\n * isClass(MyClass); // true\n * isClass(() => {}); // false\n */\nexport function isClass(obj: any): boolean {\n  return (\n    typeof obj === \"function\" &&\n    obj.prototype &&\n    obj.prototype.constructor === obj\n  );\n}\n\n/**\n * Checks if the given item is an object.\n *\n * @param {any} item - The item to check.\n * @returns {boolean} - True if the item is an object, false otherwise.\n * @example\n * isObject({}); // true\n * isObject(null); // false\n * isObject([]); // false\n */\nexport const isObject = (item: any): boolean =>\n  item && typeof item === \"object\" && !Array.isArray(item) && item !== null;\n\n/**\n * Checks if the given value is an instance of a class.\n *\n * @param {unknown} value - The value to check.\n * @returns {boolean} - True if the value is an instance of a class, false otherwise.\n * @example\n * class MyClass {}\n * const instance = new MyClass();\n * isInstanceOfClass(instance); // true\n * isInstanceOfClass({}); // false\n */\nexport function isInstanceOfClass(value: unknown): boolean {\n  if (\n    value === null ||\n    typeof value !== \"object\" ||\n    value === undefined ||\n    Array.isArray(value)\n  ) {\n    return false;\n  }\n  return Object.getPrototypeOf(value) !== Object.prototype;\n}\n\nexport function generateShortUUID(): string {\n  const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';\n  let uuid = '';\n  for (let i = 0; i < 8; i++) {\n      const randomIndex = Math.floor(Math.random() * chars.length);\n      uuid += chars[randomIndex];\n  }\n  return uuid;\n}","import { generateShortUUID } from \"../../sync/src/utils\";\n\nclass MockPartySocket {\n    private events: Map<string, Function> = new Map();\n    id = generateShortUUID()\n    \n    addEventListener(event, cb) {\n        this.events.set(event, cb);\n    }\n\n    removeEventListener(event, cb) {\n        this.events.delete(event);\n    }\n\n    _trigger(event, data) {\n        this.events.get(event)?.(data);\n    }\n}\n\nclass MockStorage {\n    private storage: Map<string, any> = new Map();\n    \n    async get(key: string) {\n        return this.storage.get(key);\n    }\n    \n    async put(key: string, value: any) {\n        this.storage.set(key, value);\n    }\n    \n    async list() {\n        return this.storage\n    }\n}\n\nclass MockPartyRoom {\n  private clients: Map<string, MockPartySocket> = new Map();\n  storage = new MockStorage();\n\n  constructor(public id?: string) {\n    this.id = id || generateShortUUID()\n  }\n\n  connection(client) {\n    const socket = new MockPartySocket();\n    this.clients.set(socket.id, client);\n    client.id = socket.id;\n  }\n\n  broadcast(data: any) {\n    this.clients.forEach((client) => {\n      client._trigger('message', data);\n    });\n  }\n\n  clear() {\n    this.clients.clear();\n  }\n}\n\nexport class MockConnection {\n  state: any = {};\n\n  setState(value: any) {\n    this.state = value;\n  }\n}\n\nexport const ServerIo = MockPartyRoom;\nexport const ClientIo = MockPartySocket;\n","import { dset } from \"dset\";\nimport z from \"zod\";\nimport {\n  createStatesSnapshot,\n  getByPath,\n  load,\n  syncClass,\n} from \"../../sync/src\";\nimport { generateShortUUID } from \"../../sync/src/utils\";\nimport type * as Party from \"./types/party\";\nimport {\n  awaitReturn,\n  buildObject,\n  extractParams,\n  isClass,\n  throttle,\n} from \"./utils\";\n\nconst Message = z.object({\n  action: z.string(),\n  value: z.any(),\n});\n\ntype CreateRoomOptions = {\n  getMemoryAll?: boolean;\n};\n\n/**\n * @class Server\n * @implements {Party.Server}\n * @description Represents a server that manages rooms and connections for a multiplayer game or application.\n * \n * @example\n * ```typescript\n * import { Room, Server, ServerIo } from \"@yourpackage/room\";\n * \n * @Room({ path: \"game\" })\n * class GameRoom {\n *   // Room implementation\n * }\n * \n * class MyServer extends Server {\n *   rooms = [GameRoom];\n * }\n * \n * const server = new MyServer(new ServerIo(\"game\"));\n * server.onStart();\n * ```\n */\nexport class Server implements Party.Server {\n  subRoom = null;\n  rooms: any[] = [];\n\n  /**\n   * @constructor\n   * @param {Party.Room} room - The room object representing the current game or application instance.\n   * \n   * @example\n   * ```typescript\n   * const server = new MyServer(new ServerIo(\"game\"));\n   * ```\n   */\n  constructor(readonly room: Party.Room) {}\n\n /**\n   * @readonly\n   * @property {boolean} isHibernate - Indicates whether the server is in hibernate mode.\n   * \n   * @example\n   * ```typescript\n   * if (!server.isHibernate) {\n   *   console.log(\"Server is active\");\n   * }\n   * ```\n   */\n  get isHibernate(): boolean {\n    return !!this[\"options\"]?.hibernate;\n  }\n\n  /**\n   * @method onStart\n   * @async\n   * @description Initializes the server and creates the initial room if not in hibernate mode.\n   * @returns {Promise<void>}\n   * \n   * @example\n   * ```typescript\n   * async function initServer() {\n   *   await server.onStart();\n   *   console.log(\"Server started\");\n   * }\n   * ```\n   */\n\n  async onStart() {\n    // Only create a room if not in hibernate mode\n    // This prevents unnecessary resource allocation for inactive rooms\n    if (!this.isHibernate) {\n      this.subRoom = await this.createRoom();\n    }\n  }\n\n  /**\n   * @method createRoom\n   * @private\n   * @async\n   * @param {CreateRoomOptions} [options={}] - Options for creating the room.\n   * @returns {Promise<Object>} The created room instance.\n   * @throws {Error} If no matching room is found.\n   * \n   * @example\n   * ```typescript\n   * // This method is private and called internally\n   * async function internalCreateRoom() {\n   *   const room = await this.createRoom({ getMemoryAll: true });\n   *   console.log(\"Room created:\", room);\n   * }\n   * ```\n   */\n  private async createRoom(options: CreateRoomOptions = {}) {\n    let instance\n    let init = true\n\n    // Find the appropriate room based on the current room ID\n    for (let room of this.rooms) {\n      const params = extractParams(room.path, this.room.id);\n      if (params) {\n        instance = new room(this.room, params);\n        break;\n      }\n    }\n\n    if (!instance) {\n      throw new Error(\"Room not found\");\n    }\n\n    // Load the room's memory from storage\n    // This ensures persistence across server restarts\n    const loadMemory = async () => {\n      const root = await this.room.storage.get(\".\");\n      const memory = await this.room.storage.list();\n      const tmpObject: any = root || {};\n      for (let [key, value] of memory) {\n        if (key == \".\") {\n          continue;\n        }\n        dset(tmpObject, key, value);\n      }\n      load(instance, tmpObject);\n    };\n\n    await loadMemory();\n\n    instance.$memoryAll = {}\n\n    // Sync callback: Broadcast changes to all clients\n    const syncCb = (values) => {\n      if (options.getMemoryAll) {\n        buildObject(values, instance.$memoryAll);\n      }\n      if (init && this.isHibernate) {\n        init = false;\n        return;\n      }\n      const packet = buildObject(values, instance.$memoryAll);\n      this.room.broadcast(\n        JSON.stringify({\n          type: \"sync\",\n          value: packet,\n        })\n      );\n      values.clear();\n    }\n\n    // Persist callback: Save changes to storage\n    const persistCb = async (values) => {\n      for (let path of values) {\n        const _instance =\n          path == \".\" ? instance : getByPath(instance, path);\n        const itemValue = createStatesSnapshot(_instance);\n        await this.room.storage.put(path, itemValue);\n      }\n      values.clear();\n    }\n\n    // Set up syncing and persistence with throttling to optimize performance\n    syncClass(instance, {\n      onSync: throttle(syncCb, instance[\"throttleSync\"] ?? 500),\n      onPersist: throttle(persistCb, instance[\"throttleStorage\"] ?? 2000),\n    });\n\n    return instance\n  }\n\n  /**\n   * @method getSubRoom\n   * @private\n   * @async\n   * @param {Object} [options={}] - Options for getting the sub-room.\n   * @returns {Promise<Object>} The sub-room instance.\n   * \n   * @example\n   * ```typescript\n   * // This method is private and called internally\n   * async function internalGetSubRoom() {\n   *   const subRoom = await this.getSubRoom();\n   *   console.log(\"Sub-room retrieved:\", subRoom);\n   * }\n   * ```\n   */\n  private async getSubRoom(options = {}) {\n    let subRoom\n    if (this.isHibernate) {\n      subRoom = await this.createRoom(options)\n    }\n    else {\n      subRoom = this.subRoom\n    }\n    return subRoom\n  }\n\n  /**\n   * @method getUsersProperty\n   * @private\n   * @param {Object} subRoom - The sub-room instance.\n   * @returns {Object|null} The users property of the sub-room, or null if not found.\n   * \n   * @example\n   * ```typescript\n   * // This method is private and called internally\n   * function internalGetUsers(subRoom) {\n   *   const users = this.getUsersProperty(subRoom);\n   *   console.log(\"Users:\", users);\n   * }\n   * ```\n   */\n\n  private getUsersProperty(subRoom) {\n    const meta = subRoom.constructor[\"_propertyMetadata\"];\n    const propId = meta?.get(\"users\");\n    if (propId) {\n      return subRoom[propId];\n    }\n    return null;\n  }\n\n  /**\n   * @method onConnect\n   * @async\n   * @param {Party.Connection} conn - The connection object for the new user.\n   * @param {Party.ConnectionContext} ctx - The context of the connection.\n   * @description Handles a new user connection, creates a user object, and sends initial sync data.\n   * @returns {Promise<void>}\n   * \n   * @example\n   * ```typescript\n   * server.onConnect = async (conn, ctx) => {\n   *   await server.onConnect(conn, ctx);\n   *   console.log(\"New user connected:\", conn.id);\n   * };\n   * ```\n   */\n  async onConnect(conn: Party.Connection, ctx: Party.ConnectionContext) {\n    const subRoom = await this.getSubRoom({\n      getMemoryAll: true,\n    })\n    // Generate a unique public ID for the user\n    const publicId = generateShortUUID()\n    let user = null;\n    const signal = this.getUsersProperty(subRoom);\n    if (signal) {\n      const { classType } = signal.options;\n      // Create a new user instance based on the defined class type\n      user = isClass(classType) ? new classType() : classType(conn, ctx);\n      signal()[publicId] = user;\n    }\n    // Call the room's onJoin method if it exists\n    await awaitReturn(subRoom[\"onJoin\"]?.(user, conn, ctx));\n    conn.setState({ publicId });\n    // Send initial sync data to the new connection\n    conn.send(\n      JSON.stringify({\n        type: \"sync\",\n        value: {\n          pId: publicId,\n          ...subRoom.$memoryAll,\n        },\n      })\n    );\n  }\n\n  /**\n   * @method onMessage\n   * @async\n   * @param {string} message - The message received from a user.\n   * @param {Party.Connection} sender - The connection object of the sender.\n   * @description Processes incoming messages and triggers corresponding actions in the sub-room.\n   * @returns {Promise<void>}\n   * \n   * @example\n   * ```typescript\n   * server.onMessage = async (message, sender) => {\n   *   await server.onMessage(message, sender);\n   *   console.log(\"Message processed from:\", sender.id);\n   * };\n   * ```\n   */\n\n  async onMessage(message: string, sender: Party.Connection) {\n    let json\n    try {\n      json = JSON.parse(message)\n    }\n    catch (e) {\n      return;\n    }\n     // Validate incoming messages\n    const result = Message.safeParse(json);\n    if (!result.success) {\n      return;\n    }\n    const subRoom = await this.getSubRoom()\n    const actions = subRoom.constructor[\"_actionMetadata\"];\n    if (actions) {\n      const signal = this.getUsersProperty(subRoom);\n      const { publicId } = sender.state as any;\n      const user = signal?.()[publicId];\n      const actionName = actions.get(result.data.action);\n      if (actionName) {\n        // Validate action body if a validation schema is defined\n        if (actionName.bodyValidation) {\n          const bodyResult = actionName.bodyValidation.safeParse(\n            result.data.value\n          );\n          if (!bodyResult.success) {\n            return;\n          }\n        }\n        // Execute the action\n        await awaitReturn(\n          subRoom[actionName.key](user, result.data.value, sender)\n        );\n      }\n    }\n  }\n\n  /**\n   * @method onClose\n   * @async\n   * @param {Party.Connection} conn - The connection object of the disconnecting user.\n   * @description Handles user disconnection, removing them from the room and triggering the onLeave event.\n   * @returns {Promise<void>}\n   * \n   * @example\n   * ```typescript\n   * server.onClose = async (conn) => {\n   *   await server.onClose(conn);\n   *   console.log(\"User disconnected:\", conn.id);\n   * };\n   * ```\n   */\n  async onClose(conn: Party.Connection) {\n    const subRoom = await this.getSubRoom()\n    const signal = this.getUsersProperty(subRoom);\n    const { publicId } = conn.state as any;\n    const user = signal?.()[publicId];\n    // Call the room's onLeave method if it exists\n    await awaitReturn(subRoom[\"onLeave\"]?.(user, conn));\n    if (signal) {\n      // Remove the user from the room\n      delete signal()[publicId];\n    }\n  }\n}\n","import {\n  ArraySubject,\n  ObjectSubject,\n  isSignal,\n  type WritableSignal,\n} from \"@signe/reactive\";\nimport { isInstanceOfClass, isObject } from \"./utils\";\n\ninterface SyncOptions {\n  onSync?: (value: Map<string, any>) => void;\n  onPersist?: (value: Set<string>) => void;\n}\n\ninterface TypeOptions {\n  syncToClient?: boolean;\n  persist?: boolean;\n  classType?: any;\n}\n\n/**\n * Synchronizes an instance by adding `$valuesChanges` methods for state management.\n *\n * This function initializes a cache for syncing and persisting values. It adds methods to the instance\n * to set values, mark values for persistence, and check and retrieve values from the cache.\n * Optionally, callbacks can be provided to handle synchronization and persistence events.\n *\n * @param {Record<string, any>} instance - The instance to be synchronized.\n * @param {SyncOptions} [options={}] - Optional synchronization options.\n * @param {Function} [options.onSync] - Callback function to be called on value sync with the current cache.\n * @param {Function} [options.onPersist] - Callback function to be called on value persistence with the current cache.\n *\n * @example\n * class TestClass {\n *   @sync() count = signal(0);\n *   @sync() text = signal('hello');\n * }\n * const instance = new TestClass();\n * syncClass(instance, {\n *   onSync: (cache) => console.log('Sync cache:', cache),\n *   onPersist: (cache) => console.log('Persist cache:', cache),\n * });\n */\nexport const syncClass = (instance: any, options: SyncOptions = {}) => {\n  const cacheSync = new Map();\n  const cachePersist = new Set<string>();\n  instance.$valuesChanges = {\n    set: (path: string, value: any) => {\n      cacheSync.set(path, value);\n      options.onSync?.(cacheSync);\n    },\n    setPersist: (path: string) => {\n      if (path == \"\") path = \".\";\n      cachePersist.add(path);\n      options.onPersist?.(cachePersist);\n    },\n    has: (path: string) => {\n      return cacheSync.has(path);\n    },\n    get: (path: string) => {\n      return cacheSync.get(path);\n    },\n  };\n  createSyncClass(instance);\n};\n\n/**\n * Creates a snapshot of the current state of an instance's signals.\n *\n * This function iterates over the signals stored in the instance's $snapshot property.\n * If a signal's value is not an object or array and the signal's persist option is true or undefined,\n * it adds the signal's value to the returned snapshot object.\n *\n * @param {Record<string, any>} instance - The instance containing the $snapshot map of signals.\n * @returns {Record<string, any>} - An object representing the persisted snapshot of the instance's state.\n *\n * @example\n * ```typescript\n * class TestClass {\n *   @sync() count = signal(0);\n *   @sync() text = signal('hello');\n * }\n * const instance = new TestClass();\n * syncClass(instance);\n * const snapshot = createStatesSnapshot(instance);\n * console.log(snapshot); // { count: 0, text: 'hello' }\n * ```\n */\nexport function createStatesSnapshot(instance: Record<string, any>): Record<string, any> {\n  let persistObject: any = {};\n  if (instance.$snapshot) {\n    for (const key of instance.$snapshot.keys()) {\n      const signal = instance.$snapshot.get(key);\n      const persist = signal.options.persist ?? true;\n      let value = signal();\n      if (isObject(value) || Array.isArray(value)) {\n        break;\n      }\n      if (persist) {\n        persistObject[key] = value;\n      }\n    }\n  }\n  return persistObject;\n}\n\nexport function setMetadata(target: any, key: string, value: any) {\n  const meta = target.constructor._propertyMetadata;\n  const propId = meta?.get(key);\n  if (propId) {\n    if (isSignal(target[propId])) {\n      target[propId].set(value);\n    } else {\n      target[propId] = value;\n    }\n  }\n}\n\nexport const createSyncClass = (\n  currentClass: any,\n  parentKey: any = null,\n  parentClass = null,\n  path = \"\"\n) => {\n  currentClass.$path = path;\n  if (parentClass) {\n    currentClass.$valuesChanges = parentClass.$valuesChanges;\n  }\n  if (parentKey) {\n    setMetadata(currentClass, \"id\", parentKey);\n  }\n  if (currentClass.$snapshot) {\n    for (const key of currentClass.$snapshot.keys()) {\n      const signal = currentClass.$snapshot.get(key);\n      const syncToClient = signal.options.syncToClient ?? true;\n      const persist = signal.options.persist ?? true;\n      let value = signal();\n      if (isObject(value) || Array.isArray(value)) {\n        value = { ...value };\n      }\n      const newPath = (path ? path + \".\" : \"\") + key;\n      if (syncToClient) {\n        currentClass.$valuesChanges.set(newPath, value);\n      }\n      if (persist) {\n        if (parentClass) currentClass.$valuesChanges.setPersist(path);\n      }\n    }\n  }\n};\n\nexport const type = (\n  _signal: any,\n  path: string,\n  options: TypeOptions = {},\n  currentInstance: any\n): WritableSignal<any> => {\n  const syncToClient = options.syncToClient ?? true;\n  const persist = options.persist ?? true;\n  let init = true;\n  _signal.options = options;\n  _signal.observable.subscribe((value) => {\n    const check = currentInstance.$valuesChanges;\n\n    function savePath(propPath, value) {\n      if (syncToClient) check.set(propPath, value);\n      if (persist) {\n        check.setPersist(currentInstance.$path);\n      }\n    }\n\n    if (init) {\n      init = false;\n      return;\n    }\n    if (currentInstance.$path !== undefined) {\n      const propPath =\n        (currentInstance.$path ? currentInstance.$path + \".\" : \"\") + path;\n      if (_signal._subject instanceof ObjectSubject) {\n        const newPath =\n          (currentInstance.$path ? currentInstance.$path + \".\" : \"\") +\n          path +\n          \".\" +\n          value.key;\n\n        if (value.type == \"add\") {\n          if (isInstanceOfClass(value.value)) {\n            createSyncClass(value.value, value.key, currentInstance, newPath);\n          } else {\n            savePath(newPath, value.value);\n          }\n        } else if (value.type == \"update\") {\n          if (isObject(value.value) || Array.isArray(value.value)) {\n            createSyncClass(value.value, value.key, currentInstance, newPath);\n          } else {\n            savePath(newPath, value.value);\n          }\n        } else if (value.type == \"remove\") {\n          savePath(newPath, \"$delete\");\n        }\n      } else if (_signal._subject instanceof ArraySubject) {\n        const newPath = propPath + \".\" + value.index;\n        const firstItem = value.items[0];\n        if (value.type == \"add\") {\n          if (isInstanceOfClass(firstItem)) {\n            createSyncClass(firstItem, value.key, currentInstance, newPath);\n          } else {\n            savePath(newPath, firstItem);\n          }\n        } else if (value.type == \"update\") {\n          if (isObject(firstItem) || Array.isArray(firstItem)) {\n            createSyncClass(firstItem, value.key, currentInstance, newPath);\n          } else {\n            savePath(newPath, firstItem);\n          }\n        } else if (value.type == \"remove\") {\n          savePath(newPath, \"$delete\");\n        }\n      } else {\n        savePath(propPath, value);\n      }\n    }\n  });\n\n  if (!currentInstance.$snapshot) {\n    currentInstance.$snapshot = new Map();\n  }\n\n  currentInstance.$snapshot.set(path, _signal);\n\n  return _signal;\n};\n","import { isSignal } from \"@signe/reactive\";\nimport { setMetadata } from \"./core\";\nimport { isClass } from \"./utils\";\n\n/**\n * Loads values into the root instance by paths or from an object.\n * \n * @param {object} rootInstance - The instance into which values will be loaded.\n * @param {object} values - The values to load, either as paths or an object.\n * @param {boolean} [valueIsObject=false] - If true, `values` is treated as an object.\n * @example\n * // Using paths:\n * load(instance, { 'position.x': 10, 'position.y': 20 });\n * \n * // Using an object:\n * load(instance, { position: { x: 10, y: 20 } }, true);\n */\nexport function load(rootInstance: any, values: { [path: string]: any }): void;\nexport function load(\n  rootInstance: any,\n  values: object,\n  valueIsObject: true\n): void;\nexport function load(\n  rootInstance: any,\n  values: { [path: string]: any } | object,\n  valueIsObject?: boolean\n) {\n  if (valueIsObject) {\n    loadFromObject(rootInstance, values);\n  } else {\n    loadFromPaths(rootInstance, values);\n  }\n}\n\n/**\n * Loads values into the root instance using paths.\n * \n * @param {object} rootInstance - The instance into which values will be loaded.\n * @param {object} values - The values to load, with keys as paths.\n * @example\n * loadFromPaths(instance, { 'position.x': 10, 'position.y': 20 });\n */\nfunction loadFromPaths(rootInstance: any, values: { [path: string]: any }) {\n  for (const [path, value] of Object.entries(values)) {\n    const parts = path.split(\".\");\n    loadValue(rootInstance, parts, value);\n  }\n}\n\n/**\n * Recursively loads values from an object into the root instance.\n * \n * @param {object} rootInstance - The instance into which values will be loaded.\n * @param {object} values - The values to load.\n * @param {string} [currentPath=\"\"] - The current path in the recursion.\n * @example\n * loadFromObject(instance, { position: { x: 10, y: 20 } });\n */\nfunction loadFromObject(\n  rootInstance: any,\n  values: object,\n  currentPath: string = \"\"\n) {\n  for (let key in values) {\n    const value = values[key];\n    const newPath = currentPath ? `${currentPath}.${key}` : key;\n    if (typeof value === \"object\" && !Array.isArray(value) && value !== null) {\n      loadFromObject(rootInstance, value, newPath);\n    } else {\n      const parts = newPath.split(\".\");\n      loadValue(rootInstance, parts, value);\n    }\n  }\n}\n\n/**\n * Sets a value in the root instance by navigating through the path parts.\n * \n * @param {object} rootInstance - The instance into which the value will be set.\n * @param {string[]} parts - The parts of the path.\n * @param {any} value - The value to set.\n * @example\n * loadValue(instance, ['position', 'x'], 10);\n */\nfunction loadValue(rootInstance: any, parts: string[], value: any) {\n  let current: any = rootInstance;\n\n  for (let i = 0; i < parts.length; i++) {\n    const part = parts[i];\n\n    if (i === parts.length - 1) {\n      if (value == '$delete') {\n        if (isSignal(current)) {\n          current = current();\n        }\n        Reflect.deleteProperty(current, part);\n      }\n      else if (current[part]?._subject) {\n        current[part].set(value);\n      }\n      else {\n        current[part] = value;\n      }\n    } else {\n      if (isSignal(current)) {\n        current = current();\n      }\n      const currentValue = current[part];\n      if (currentValue === undefined) {\n        const parentInstance = getByPath(\n          rootInstance,\n          parts.slice(0, i).join(\".\")\n        );\n        const classType = parentInstance?.options?.classType;\n        if (classType) {\n          current[part] = !isClass(classType) ? classType(part) : new classType();\n          setMetadata(current[part], 'id', part)\n        } else {\n          current[part] = {};\n        }\n      }\n      current = current[part];\n    }\n  }\n}\n\n/**\n * Retrieves a value from the root instance by a path.\n * \n * @param {object} root - The root instance.\n * @param {string} path - The path to the value.\n * @returns {any} - The value at the specified path.\n * @example\n * const value = getByPath(instance, 'position.x');\n */\nexport function getByPath(root: any, path: string) {\n  const parts = path.split(\".\");\n  let current = root;\n  for (const part of parts) {\n    if (isSignal(current)) {\n      current = current();\n    }\n    if (current[part]) {\n      current = current[part];\n    } else {\n      return undefined;\n    }\n  }\n  return current;\n}\n","import { dset } from \"dset\";\n\n/**\n * Checks if a value is a Promise.\n *\n * @param {unknown} value - The value to check.\n * @returns {boolean} - Returns true if the value is a Promise, otherwise false.\n *\n * @example\n * isPromise(Promise.resolve()); // true\n * isPromise(42); // false\n */\nexport function isPromise(value: unknown): value is Promise<any> {\n  return value instanceof Promise;\n}\n\n/**\n * Awaits the given value if it is a Promise, otherwise returns the value directly.\n *\n * @param {unknown} val - The value to await or return.\n * @returns {Promise<any>} - Returns a Promise that resolves to the value.\n *\n * @example\n * awaitReturn(Promise.resolve(42)); // 42\n * awaitReturn(42); // 42\n */\nexport async function awaitReturn(val: unknown): Promise<any> {\n  return isPromise(val) ? await val : val;\n}\n\n/**\n * Checks if a value is a class.\n *\n * @param {unknown} obj - The value to check.\n * @returns {boolean} - Returns true if the value is a class, otherwise false.\n *\n * @example\n * class MyClass {}\n * isClass(MyClass); // true\n * isClass(() => {}); // false\n */\nexport function isClass(obj: unknown): boolean {\n  return (\n    typeof obj === \"function\" &&\n    obj.prototype &&\n    obj.prototype.constructor === obj\n  );\n}\n\n\n/**\n * Creates a throttled function that only invokes the provided function at most once per every wait milliseconds.\n *\n * The throttled function comes with a cancel method to cancel delayed invocations.\n * If the throttled function is invoked more than once during the wait timeout,\n * it will call the provided function with the latest arguments.\n *\n * @template F - The type of the function to throttle.\n * @param {F} func - The function to throttle.\n * @param {number} wait - The number of milliseconds to throttle invocations to.\n * @returns {(...args: Parameters<F>) => void} - Returns the new throttled function.\n *\n * @example\n * const log = throttle((message) => console.log(message), 1000);\n * log(\"Hello\"); // Will log \"Hello\" immediately\n * log(\"World\"); // Will log \"World\" after 1 second, if no other calls to log() are made within the 1 second.\n */\nexport function throttle<F extends (...args: any[]) => any>(\n  func: F,\n  wait: number\n): (...args: Parameters<F>) => void {\n  let timeout: ReturnType<typeof setTimeout> | null = null;\n  let lastArgs: Parameters<F> | null = null;\n\n  return function (...args: Parameters<F>) {\n    if (!timeout) {\n      func(...args);\n      timeout = setTimeout(() => {\n        if (lastArgs) {\n          func(...lastArgs);\n          lastArgs = null;\n        }\n        timeout = null;\n      }, wait);\n    } else {\n      lastArgs = args;\n    }\n  };\n}\n\n/**\n * Extracts parameters from a given string based on a specified pattern.\n *\n * The pattern can include placeholders in the form of {paramName}, which will be\n * extracted from the input string if they match.\n *\n * @param {string} pattern - The pattern containing placeholders.\n * @param {string} str - The string to extract parameters from.\n * @returns {{ [key: string]: string } | null} - An object containing the extracted parameters,\n *                                               or null if the string does not match the pattern.\n *\n * @example\n * // returns { id: '123' }\n * extractParams('game-{id}', 'game-123');\n *\n * @example\n * // returns { foo: 'abc', bar: 'xyz' }\n * extractParams('test-{foo}-{bar}', 'test-abc-xyz');\n *\n */\nexport function extractParams(\n  pattern: string,\n  str: string\n): { [key: string]: string } | null {\n  // Replace placeholders in the pattern with named capture groups\n  const regexPattern = pattern.replace(/{(\\w+)}/g, \"(?<$1>[\\\\w-]+)\");\n\n  // Create a strict regular expression from the pattern\n  const regex = new RegExp(`^${regexPattern}$`);\n  const match = regex.exec(str);\n\n  // If a match is found and groups are present, return the captured groups\n  if (match && match.groups) {\n    return match.groups;\n  } else if (pattern === str) {\n    // If the pattern exactly matches the string, return an empty object\n    return {};\n  } else {\n    // Otherwise, return null\n    return null;\n  }\n}\n\n/**\n * Removes a property from an object based on a dot-separated key string or an array of keys.\n *\n * The function modifies the original object by deleting the specified property.\n * It safely handles dangerous keys like __proto__, constructor, and prototype.\n *\n * @param {Record<string, any>} obj - The object from which to remove the property.\n * @param {string | string[]} keys - The key(s) specifying the property to remove. Can be a dot-separated string or an array of strings.\n *\n * @example\n * const obj = { a: { b: { c: 3 } } };\n * dremove(obj, 'a.b.c');\n * // obj is now { a: { b: {} } }\n *\n * @example\n * const obj = { a: 1, b: 2 };\n * dremove(obj, 'a');\n * // obj is now { b: 2 }\n *\n * @example\n * const obj = { a: { b: { c: 3 } } };\n * dremove(obj, ['a', 'b', 'c']);\n * // obj is now { a: { b: {} } }\n */\nexport function dremove(\n  obj: Record<string, any>,\n  keys: string | string[]\n): void {\n  // If keys is a string, convert it to an array using the \".\" separator\n  if (typeof keys === \"string\") {\n    keys = keys.split(\".\");\n  }\n\n  let i = 0;\n  const l = keys.length;\n  let t = obj;\n  let k;\n\n  while (i < l - 1) {\n    k = keys[i++];\n    if (k === \"__proto__\" || k === \"constructor\" || k === \"prototype\") return; // Avoid dangerous keys\n    if (typeof t[k] !== \"object\" || t[k] === null) return; // If the object doesn't exist, stop\n    t = t[k];\n  }\n\n  k = keys[i];\n  if (\n    t &&\n    typeof t === \"object\" &&\n    !(k === \"__proto__\" || k === \"constructor\" || k === \"prototype\")\n  ) {\n    delete t[k];\n  }\n}\n\n/**\n * Builds an object from a map of values and updates the provided memory object.\n *\n * For each key-value pair in the map, this function sets the value at the given path in the `memoryObj`.\n * If the value is \"$delete\", it removes the corresponding path from `allMemory`.\n *\n * @param {Map<string, any>} valuesMap - A map where the keys are paths and the values are the values to set at those paths.\n * @param {Record<string, any>} allMemory - The object to update based on the values in the map.\n * @returns {Record<string, any>} - The built memory object with the applied values from the map.\n *\n * @example\n * const valuesMap = new Map();\n * valuesMap.set('a.b.c', 1);\n * valuesMap.set('x.y.z', '$delete');\n * const allMemory = { x: { y: { z: 2 } } };\n * const result = buildObject(valuesMap, allMemory);\n * // result is { a: { b: { c: 1 } }, x: { y: { z: '$delete' } } }\n * // allMemory is { a: { b: { c: 1 } }, x: { y: {} } }\n */\nexport function buildObject(valuesMap: Map<string, any>, allMemory: Record<string, any>): Record<string, any> {\n  let memoryObj = {};\n  for (let path of valuesMap.keys()) {\n    const value = valuesMap.get(path);\n    dset(memoryObj, path, value);\n    if (value === \"$delete\") {\n      dremove(allMemory, path);\n    } else {\n      dset(allMemory, path, value);\n    }\n  }\n  return memoryObj;\n}"],"mappings":"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","names":["Action","name","bodyValidation","target","propertyKey","constructor","_actionMetadata","Map","set","key","Room","options","path","maxUsers","throttleStorage","throttleSync","isClass","obj","prototype","constructor","isObject","item","Array","isArray","generateShortUUID","chars","uuid","i","randomIndex","Math","floor","random","length","MockPartySocket","events","Map","id","generateShortUUID","addEventListener","event","cb","set","removeEventListener","delete","_trigger","data","get","MockStorage","storage","key","put","value","list","MockPartyRoom","clients","constructor","connection","client","socket","broadcast","forEach","clear","MockConnection","state","setState","ServerIo","ClientIo","dset","z","ArraySubject","ObjectSubject","isSignal","syncClass","instance","options","cacheSync","Map","cachePersist","Set","$valuesChanges","set","path","value","onSync","setPersist","add","onPersist","has","get","createSyncClass","createStatesSnapshot","persistObject","$snapshot","key","keys","signal","persist","isObject","Array","isArray","setMetadata","target","meta","constructor","_propertyMetadata","propId","isSignal","currentClass","parentKey","parentClass","$path","syncToClient","newPath","isSignal","load","rootInstance","values","valueIsObject","loadFromObject","loadFromPaths","path","value","Object","entries","parts","split","loadValue","currentPath","key","newPath","Array","isArray","current","i","length","part","isSignal","Reflect","deleteProperty","_subject","set","currentValue","undefined","parentInstance","getByPath","slice","join","classType","options","isClass","setMetadata","root","dset","isPromise","value","Promise","awaitReturn","val","isClass","obj","prototype","constructor","throttle","func","wait","timeout","lastArgs","args","setTimeout","extractParams","pattern","str","regexPattern","replace","regex","RegExp","match","exec","groups","dremove","keys","split","i","l","length","t","k","buildObject","valuesMap","allMemory","memoryObj","path","get","dset","Message","z","object","action","string","value","any","Server","subRoom","rooms","constructor","room","isHibernate","hibernate","onStart","createRoom","options","instance","init","params","extractParams","path","id","Error","loadMemory","root","storage","get","memory","list","tmpObject","key","dset","load","$memoryAll","syncCb","values","getMemoryAll","buildObject","packet","broadcast","JSON","stringify","type","clear","persistCb","_instance","getByPath","itemValue","createStatesSnapshot","put","syncClass","onSync","throttle","onPersist","getSubRoom","getUsersProperty","meta","propId","onConnect","conn","ctx","publicId","generateShortUUID","user","signal","classType","isClass","awaitReturn","setState","send","pId","onMessage","message","sender","json","parse","e","result","safeParse","success","actions","state","actionName","data","bodyValidation","bodyResult","onClose"]}
+{"version":3,"sources":["../src/decorators.ts","../../sync/src/utils.ts","../src/mock.ts","../src/server.ts","../../sync/src/core.ts","../../sync/src/load.ts","../src/utils.ts"],"sourcesContent":["import type * as Party from \"./types/party\"\n\ntype GuardFn = (sender: Party.Connection, value: any) => boolean | Promise<boolean>;\ntype RoomGuardFn = (conn: Party.Connection, ctx: Party.ConnectionContext) => boolean | Promise<boolean>;\n\nexport function Action(name: string, bodyValidation?) {\n  return function (target: any, propertyKey: string) {\n    if (!target.constructor._actionMetadata) {\n      target.constructor._actionMetadata = new Map();\n    }\n    target.constructor._actionMetadata.set(name, {\n      key: propertyKey,\n      bodyValidation,\n    });\n  };\n}\n\nexport interface RoomOptions {\n  path: string;\n  maxUsers?: number;\n  throttleStorage?: number;\n  throttleSync?: number;\n  hibernate?: boolean;\n  guards?: RoomGuardFn[];\n}\n\nexport function Room(options: RoomOptions) {\n  return function (target: any) {\n    target.path = options.path;\n    target.maxUsers = options.maxUsers;\n    target.throttleStorage = options.throttleStorage;\n    target.throttleSync = options.throttleSync;\n    if (options.guards) {\n      target['_roomGuards'] = options.guards;\n    }\n  };\n}\n\n/**\n * Room guard decorator\n * @param guards Array of guard functions to check on connection\n */\nexport function RoomGuard(guards: RoomGuardFn[]) {\n  return function (target: any) {\n    target['_roomGuards'] = guards;\n  };\n}\n\n/**\n * Action guard decorator\n * @param guards Array of guard functions to check before action execution\n */\nexport function Guard(guards: GuardFn[]) {\n  return function (\n    target: any,\n    propertyKey: string,\n    descriptor: PropertyDescriptor\n  ) {\n    if (!target.constructor['_actionGuards']) {\n      target.constructor['_actionGuards'] = new Map();\n    }\n    target.constructor['_actionGuards'].set(propertyKey, guards);\n  };\n}","/**\n * Checks if the given value is a function.\n *\n * @param {unknown} val - The value to check.\n * @returns {boolean} - True if the value is a function, false otherwise.\n * @example\n * isFunction(function() {}); // true\n * isFunction(() => {}); // true\n * isFunction(123); // false\n */\nexport function isFunction(val: unknown): boolean {\n  return {}.toString.call(val) === \"[object Function]\";\n}\n\n/**\n * Checks if the given object is a class.\n *\n * @param {any} obj - The object to check.\n * @returns {boolean} - True if the object is a class, false otherwise.\n * @example\n * class MyClass {}\n * isClass(MyClass); // true\n * isClass(() => {}); // false\n */\nexport function isClass(obj: any): boolean {\n  return (\n    typeof obj === \"function\" &&\n    obj.prototype &&\n    obj.prototype.constructor === obj\n  );\n}\n\n/**\n * Checks if the given item is an object.\n *\n * @param {any} item - The item to check.\n * @returns {boolean} - True if the item is an object, false otherwise.\n * @example\n * isObject({}); // true\n * isObject(null); // false\n * isObject([]); // false\n */\nexport const isObject = (item: any): boolean =>\n  item && typeof item === \"object\" && !Array.isArray(item) && item !== null;\n\n/**\n * Checks if the given value is an instance of a class.\n *\n * @param {unknown} value - The value to check.\n * @returns {boolean} - True if the value is an instance of a class, false otherwise.\n * @example\n * class MyClass {}\n * const instance = new MyClass();\n * isInstanceOfClass(instance); // true\n * isInstanceOfClass({}); // false\n */\nexport function isInstanceOfClass(value: unknown): boolean {\n  if (\n    value === null ||\n    typeof value !== \"object\" ||\n    value === undefined ||\n    Array.isArray(value)\n  ) {\n    return false;\n  }\n  return Object.getPrototypeOf(value) !== Object.prototype;\n}\n\nexport function generateShortUUID(): string {\n  const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';\n  let uuid = '';\n  for (let i = 0; i < 8; i++) {\n      const randomIndex = Math.floor(Math.random() * chars.length);\n      uuid += chars[randomIndex];\n  }\n  return uuid;\n}","import { generateShortUUID } from \"../../sync/src/utils\";\n\nclass MockPartySocket {\n    private events: Map<string, Function> = new Map();\n    id = generateShortUUID()\n    \n    addEventListener(event, cb) {\n        this.events.set(event, cb);\n    }\n\n    removeEventListener(event, cb) {\n        this.events.delete(event);\n    }\n\n    _trigger(event, data) {\n        this.events.get(event)?.(data);\n    }\n}\n\nclass MockStorage {\n    private storage: Map<string, any> = new Map();\n    \n    async get(key: string) {\n        return this.storage.get(key);\n    }\n    \n    async put(key: string, value: any) {\n        this.storage.set(key, value);\n    }\n    \n    async list() {\n        return this.storage\n    }\n}\n\nclass MockPartyRoom {\n  private clients: Map<string, MockPartySocket> = new Map();\n  storage = new MockStorage();\n\n  constructor(public id?: string) {\n    this.id = id || generateShortUUID()\n  }\n\n  connection(client) {\n    const socket = new MockPartySocket();\n    this.clients.set(socket.id, client);\n    client.id = socket.id;\n  }\n\n  broadcast(data: any) {\n    this.clients.forEach((client) => {\n      client._trigger('message', data);\n    });\n  }\n\n  clear() {\n    this.clients.clear();\n  }\n}\n\nexport class MockConnection {\n  state: any = {};\n\n  setState(value: any) {\n    this.state = value;\n  }\n}\n\nexport const ServerIo = MockPartyRoom;\nexport const ClientIo = MockPartySocket;\n","import { dset } from \"dset\";\nimport z from \"zod\";\nimport {\n  createStatesSnapshot,\n  getByPath,\n  load,\n  syncClass,\n} from \"../../sync/src\";\nimport { generateShortUUID } from \"../../sync/src/utils\";\nimport type * as Party from \"./types/party\";\nimport {\n  awaitReturn,\n  buildObject,\n  extractParams,\n  isClass,\n  throttle,\n} from \"./utils\";\n\nconst Message = z.object({\n  action: z.string(),\n  value: z.any(),\n});\n\ntype CreateRoomOptions = {\n  getMemoryAll?: boolean;\n};\n\n/**\n * @class Server\n * @implements {Party.Server}\n * @description Represents a server that manages rooms and connections for a multiplayer game or application.\n * \n * @example\n * ```typescript\n * import { Room, Server, ServerIo } from \"@yourpackage/room\";\n * \n * @Room({ path: \"game\" })\n * class GameRoom {\n *   // Room implementation\n * }\n * \n * class MyServer extends Server {\n *   rooms = [GameRoom];\n * }\n * \n * const server = new MyServer(new ServerIo(\"game\"));\n * server.onStart();\n * ```\n */\nexport class Server implements Party.Server {\n  subRoom = null;\n  rooms: any[] = [];\n\n  /**\n   * @constructor\n   * @param {Party.Room} room - The room object representing the current game or application instance.\n   * \n   * @example\n   * ```typescript\n   * const server = new MyServer(new ServerIo(\"game\"));\n   * ```\n   */\n  constructor(readonly room: Party.Room) {}\n\n /**\n   * @readonly\n   * @property {boolean} isHibernate - Indicates whether the server is in hibernate mode.\n   * \n   * @example\n   * ```typescript\n   * if (!server.isHibernate) {\n   *   console.log(\"Server is active\");\n   * }\n   * ```\n   */\n  get isHibernate(): boolean {\n    return !!this[\"options\"]?.hibernate;\n  }\n\n  /**\n   * @method onStart\n   * @async\n   * @description Initializes the server and creates the initial room if not in hibernate mode.\n   * @returns {Promise<void>}\n   * \n   * @example\n   * ```typescript\n   * async function initServer() {\n   *   await server.onStart();\n   *   console.log(\"Server started\");\n   * }\n   * ```\n   */\n\n  async onStart() {\n    // Only create a room if not in hibernate mode\n    // This prevents unnecessary resource allocation for inactive rooms\n    if (!this.isHibernate) {\n      this.subRoom = await this.createRoom();\n    }\n  }\n\n  /**\n   * @method createRoom\n   * @private\n   * @async\n   * @param {CreateRoomOptions} [options={}] - Options for creating the room.\n   * @returns {Promise<Object>} The created room instance.\n   * @throws {Error} If no matching room is found.\n   * \n   * @example\n   * ```typescript\n   * // This method is private and called internally\n   * async function internalCreateRoom() {\n   *   const room = await this.createRoom({ getMemoryAll: true });\n   *   console.log(\"Room created:\", room);\n   * }\n   * ```\n   */\n  private async createRoom(options: CreateRoomOptions = {}) {\n    let instance\n    let init = true\n\n    // Find the appropriate room based on the current room ID\n    for (let room of this.rooms) {\n      const params = extractParams(room.path, this.room.id);\n      if (params) {\n        instance = new room(this.room, params);\n        break;\n      }\n    }\n\n    if (!instance) {\n      throw new Error(\"Room not found\");\n    }\n\n    // Load the room's memory from storage\n    // This ensures persistence across server restarts\n    const loadMemory = async () => {\n      const root = await this.room.storage.get(\".\");\n      const memory = await this.room.storage.list();\n      const tmpObject: any = root || {};\n      for (let [key, value] of memory) {\n        if (key == \".\") {\n          continue;\n        }\n        dset(tmpObject, key, value);\n      }\n      load(instance, tmpObject);\n    };\n\n    await loadMemory();\n\n    instance.$memoryAll = {}\n\n    // Sync callback: Broadcast changes to all clients\n    const syncCb = (values) => {\n      if (options.getMemoryAll) {\n        buildObject(values, instance.$memoryAll);\n      }\n      if (init && this.isHibernate) {\n        init = false;\n        return;\n      }\n      const packet = buildObject(values, instance.$memoryAll);\n      this.room.broadcast(\n        JSON.stringify({\n          type: \"sync\",\n          value: packet,\n        })\n      );\n      values.clear();\n    }\n\n    // Persist callback: Save changes to storage\n    const persistCb = async (values) => {\n      for (let path of values) {\n        const _instance =\n          path == \".\" ? instance : getByPath(instance, path);\n        const itemValue = createStatesSnapshot(_instance);\n        await this.room.storage.put(path, itemValue);\n      }\n      values.clear();\n    }\n\n    // Set up syncing and persistence with throttling to optimize performance\n    syncClass(instance, {\n      onSync: throttle(syncCb, instance[\"throttleSync\"] ?? 500),\n      onPersist: throttle(persistCb, instance[\"throttleStorage\"] ?? 2000),\n    });\n\n    return instance\n  }\n\n  /**\n   * @method getSubRoom\n   * @private\n   * @async\n   * @param {Object} [options={}] - Options for getting the sub-room.\n   * @returns {Promise<Object>} The sub-room instance.\n   * \n   * @example\n   * ```typescript\n   * // This method is private and called internally\n   * async function internalGetSubRoom() {\n   *   const subRoom = await this.getSubRoom();\n   *   console.log(\"Sub-room retrieved:\", subRoom);\n   * }\n   * ```\n   */\n  private async getSubRoom(options = {}) {\n    let subRoom\n    if (this.isHibernate) {\n      subRoom = await this.createRoom(options)\n    }\n    else {\n      subRoom = this.subRoom\n    }\n    return subRoom\n  }\n\n  /**\n   * @method getUsersProperty\n   * @private\n   * @param {Object} subRoom - The sub-room instance.\n   * @returns {Object|null} The users property of the sub-room, or null if not found.\n   * \n   * @example\n   * ```typescript\n   * // This method is private and called internally\n   * function internalGetUsers(subRoom) {\n   *   const users = this.getUsersProperty(subRoom);\n   *   console.log(\"Users:\", users);\n   * }\n   * ```\n   */\n\n  private getUsersProperty(subRoom) {\n    const meta = subRoom.constructor[\"_propertyMetadata\"];\n    const propId = meta?.get(\"users\");\n    if (propId) {\n      return subRoom[propId];\n    }\n    return null;\n  }\n\n  /**\n   * @method onConnect\n   * @async\n   * @param {Party.Connection} conn - The connection object for the new user.\n   * @param {Party.ConnectionContext} ctx - The context of the connection.\n   * @description Handles a new user connection, creates a user object, and sends initial sync data.\n   * @returns {Promise<void>}\n   * \n   * @example\n   * ```typescript\n   * server.onConnect = async (conn, ctx) => {\n   *   await server.onConnect(conn, ctx);\n   *   console.log(\"New user connected:\", conn.id);\n   * };\n   * ```\n   */\n  async onConnect(conn: Party.Connection, ctx: Party.ConnectionContext) {\n    const subRoom = await this.getSubRoom({\n      getMemoryAll: true,\n    })\n\n    // Check room guards\n    const roomGuards = subRoom.constructor['_roomGuards'] || [];\n    for (const guard of roomGuards) {\n      const isAuthorized = await guard(conn, ctx);\n      if (!isAuthorized) {\n        conn.close();\n        return;\n      }\n    }\n\n    // Generate a unique public ID for the user\n    const publicId = generateShortUUID()\n    let user = null;\n    const signal = this.getUsersProperty(subRoom);\n    if (signal) {\n      const { classType } = signal.options;\n      // Create a new user instance based on the defined class type\n      user = isClass(classType) ? new classType() : classType(conn, ctx);\n      signal()[publicId] = user;\n    }\n    // Call the room's onJoin method if it exists\n    await awaitReturn(subRoom[\"onJoin\"]?.(user, conn, ctx));\n    conn.setState({ publicId });\n    // Send initial sync data to the new connection\n    conn.send(\n      JSON.stringify({\n        type: \"sync\",\n        value: {\n          pId: publicId,\n          ...subRoom.$memoryAll,\n        },\n      })\n    );\n  }\n\n  /**\n   * @method onMessage\n   * @async\n   * @param {string} message - The message received from a user.\n   * @param {Party.Connection} sender - The connection object of the sender.\n   * @description Processes incoming messages and triggers corresponding actions in the sub-room.\n   * @returns {Promise<void>}\n   * \n   * @example\n   * ```typescript\n   * server.onMessage = async (message, sender) => {\n   *   await server.onMessage(message, sender);\n   *   console.log(\"Message processed from:\", sender.id);\n   * };\n   * ```\n   */\n\n  async onMessage(message: string, sender: Party.Connection) {\n    let json\n    try {\n      json = JSON.parse(message)\n    }\n    catch (e) {\n      return;\n    }\n     // Validate incoming messages\n    const result = Message.safeParse(json);\n    if (!result.success) {\n      return;\n    }\n    const subRoom = await this.getSubRoom()\n\n    // Check room guards\n    const roomGuards = subRoom.constructor['_roomGuards'] || [];\n    for (const guard of roomGuards) {\n      const isAuthorized = await guard(sender, result.data.value);\n      if (!isAuthorized) {\n        return;\n      }\n    }\n\n    const actions = subRoom.constructor[\"_actionMetadata\"];\n    if (actions) {\n      const signal = this.getUsersProperty(subRoom);\n      const { publicId } = sender.state as any;\n      const user = signal?.()[publicId];\n      const actionName = actions.get(result.data.action);\n      if (actionName) {\n\n        // Check all guards if they exist\n        const guards = subRoom.$actionGuards?.get(actionName.key) || [];\n        for (const guard of guards) {\n          const isAuthorized = await guard(sender, result.data.value);\n          if (!isAuthorized) {\n            return;\n          }\n        }\n\n        // Validate action body if a validation schema is defined\n        if (actionName.bodyValidation) {\n          const bodyResult = actionName.bodyValidation.safeParse(\n            result.data.value\n          );\n          if (!bodyResult.success) {\n            return;\n          }\n        }\n        // Execute the action\n        await awaitReturn(\n          subRoom[actionName.key](user, result.data.value, sender)\n        );\n      }\n    }\n  }\n\n  /**\n   * @method onClose\n   * @async\n   * @param {Party.Connection} conn - The connection object of the disconnecting user.\n   * @description Handles user disconnection, removing them from the room and triggering the onLeave event.\n   * @returns {Promise<void>}\n   * \n   * @example\n   * ```typescript\n   * server.onClose = async (conn) => {\n   *   await server.onClose(conn);\n   *   console.log(\"User disconnected:\", conn.id);\n   * };\n   * ```\n   */\n  async onClose(conn: Party.Connection) {\n    const subRoom = await this.getSubRoom()\n    const signal = this.getUsersProperty(subRoom);\n    const { publicId } = conn.state as any;\n    const user = signal?.()[publicId];\n    // Call the room's onLeave method if it exists\n    await awaitReturn(subRoom[\"onLeave\"]?.(user, conn));\n    if (signal) {\n      // Remove the user from the room\n      delete signal()[publicId];\n    }\n  }\n}\n","import {\n  ArraySubject,\n  ObjectSubject,\n  isSignal,\n  type WritableSignal,\n} from \"@signe/reactive\";\nimport { isInstanceOfClass, isObject } from \"./utils\";\n\ninterface SyncOptions {\n  onSync?: (value: Map<string, any>) => void;\n  onPersist?: (value: Set<string>) => void;\n}\n\ninterface TypeOptions {\n  syncToClient?: boolean;\n  persist?: boolean;\n  classType?: any;\n}\n\n/**\n * Synchronizes an instance by adding `$valuesChanges` methods for state management.\n *\n * This function initializes a cache for syncing and persisting values. It adds methods to the instance\n * to set values, mark values for persistence, and check and retrieve values from the cache.\n * Optionally, callbacks can be provided to handle synchronization and persistence events.\n *\n * @param {Record<string, any>} instance - The instance to be synchronized.\n * @param {SyncOptions} [options={}] - Optional synchronization options.\n * @param {Function} [options.onSync] - Callback function to be called on value sync with the current cache.\n * @param {Function} [options.onPersist] - Callback function to be called on value persistence with the current cache.\n *\n * @example\n * class TestClass {\n *   @sync() count = signal(0);\n *   @sync() text = signal('hello');\n * }\n * const instance = new TestClass();\n * syncClass(instance, {\n *   onSync: (cache) => console.log('Sync cache:', cache),\n *   onPersist: (cache) => console.log('Persist cache:', cache),\n * });\n */\nexport const syncClass = (instance: any, options: SyncOptions = {}) => {\n  const cacheSync = new Map();\n  const cachePersist = new Set<string>();\n  instance.$valuesChanges = {\n    set: (path: string, value: any) => {\n      cacheSync.set(path, value);\n      options.onSync?.(cacheSync);\n    },\n    setPersist: (path: string) => {\n      if (path == \"\") path = \".\";\n      cachePersist.add(path);\n      options.onPersist?.(cachePersist);\n    },\n    has: (path: string) => {\n      return cacheSync.has(path);\n    },\n    get: (path: string) => {\n      return cacheSync.get(path);\n    },\n  };\n  createSyncClass(instance);\n};\n\n/**\n * Creates a snapshot of the current state of an instance's signals.\n *\n * This function iterates over the signals stored in the instance's $snapshot property.\n * If a signal's value is not an object or array and the signal's persist option is true or undefined,\n * it adds the signal's value to the returned snapshot object.\n *\n * @param {Record<string, any>} instance - The instance containing the $snapshot map of signals.\n * @returns {Record<string, any>} - An object representing the persisted snapshot of the instance's state.\n *\n * @example\n * ```typescript\n * class TestClass {\n *   @sync() count = signal(0);\n *   @sync() text = signal('hello');\n * }\n * const instance = new TestClass();\n * syncClass(instance);\n * const snapshot = createStatesSnapshot(instance);\n * console.log(snapshot); // { count: 0, text: 'hello' }\n * ```\n */\nexport function createStatesSnapshot(instance: Record<string, any>): Record<string, any> {\n  let persistObject: any = {};\n  if (instance.$snapshot) {\n    for (const key of instance.$snapshot.keys()) {\n      const signal = instance.$snapshot.get(key);\n      const persist = signal.options.persist ?? true;\n      let value = signal();\n      if (isObject(value) || Array.isArray(value)) {\n        break;\n      }\n      if (persist) {\n        persistObject[key] = value;\n      }\n    }\n  }\n  return persistObject;\n}\n\nexport function setMetadata(target: any, key: string, value: any) {\n  const meta = target.constructor._propertyMetadata;\n  const propId = meta?.get(key);\n  if (propId) {\n    if (isSignal(target[propId])) {\n      target[propId].set(value);\n    } else {\n      target[propId] = value;\n    }\n  }\n}\n\nexport const createSyncClass = (\n  currentClass: any,\n  parentKey: any = null,\n  parentClass = null,\n  path = \"\"\n) => {\n  currentClass.$path = path;\n  if (parentClass) {\n    currentClass.$valuesChanges = parentClass.$valuesChanges;\n  }\n  if (parentKey) {\n    setMetadata(currentClass, \"id\", parentKey);\n  }\n  if (currentClass.$snapshot) {\n    for (const key of currentClass.$snapshot.keys()) {\n      const signal = currentClass.$snapshot.get(key);\n      const syncToClient = signal.options.syncToClient ?? true;\n      const persist = signal.options.persist ?? true;\n      let value = signal();\n      if (isObject(value) || Array.isArray(value)) {\n        value = { ...value };\n      }\n      const newPath = (path ? path + \".\" : \"\") + key;\n      if (syncToClient) {\n        currentClass.$valuesChanges.set(newPath, value);\n      }\n      if (persist) {\n        if (parentClass) currentClass.$valuesChanges.setPersist(path);\n      }\n    }\n  }\n};\n\nexport const type = (\n  _signal: any,\n  path: string,\n  options: TypeOptions = {},\n  currentInstance: any\n): WritableSignal<any> => {\n  const syncToClient = options.syncToClient ?? true;\n  const persist = options.persist ?? true;\n  let init = true;\n  _signal.options = options;\n  _signal.observable.subscribe((value) => {\n    const check = currentInstance.$valuesChanges;\n\n    function savePath(propPath, value) {\n      if (syncToClient) check.set(propPath, value);\n      if (persist) {\n        check.setPersist(currentInstance.$path);\n      }\n    }\n\n    if (init) {\n      init = false;\n      return;\n    }\n    if (currentInstance.$path !== undefined) {\n      const propPath =\n        (currentInstance.$path ? currentInstance.$path + \".\" : \"\") + path;\n      if (_signal._subject instanceof ObjectSubject) {\n        const newPath =\n          (currentInstance.$path ? currentInstance.$path + \".\" : \"\") +\n          path +\n          \".\" +\n          value.key;\n\n        if (value.type == \"add\") {\n          if (isInstanceOfClass(value.value)) {\n            createSyncClass(value.value, value.key, currentInstance, newPath);\n          } else {\n            savePath(newPath, value.value);\n          }\n        } else if (value.type == \"update\") {\n          if (isObject(value.value) || Array.isArray(value.value)) {\n            createSyncClass(value.value, value.key, currentInstance, newPath);\n          } else {\n            savePath(newPath, value.value);\n          }\n        } else if (value.type == \"remove\") {\n          savePath(newPath, \"$delete\");\n        }\n      } else if (_signal._subject instanceof ArraySubject) {\n        const newPath = propPath + \".\" + value.index;\n        const firstItem = value.items[0];\n        if (value.type == \"add\") {\n          if (isInstanceOfClass(firstItem)) {\n            createSyncClass(firstItem, value.key, currentInstance, newPath);\n          } else {\n            savePath(newPath, firstItem);\n          }\n        } else if (value.type == \"update\") {\n          if (isObject(firstItem) || Array.isArray(firstItem)) {\n            createSyncClass(firstItem, value.key, currentInstance, newPath);\n          } else {\n            savePath(newPath, firstItem);\n          }\n        } else if (value.type == \"remove\") {\n          savePath(newPath, \"$delete\");\n        }\n      } else {\n        savePath(propPath, value);\n      }\n    }\n  });\n\n  if (!currentInstance.$snapshot) {\n    currentInstance.$snapshot = new Map();\n  }\n\n  currentInstance.$snapshot.set(path, _signal);\n\n  return _signal;\n};\n","import { isSignal } from \"@signe/reactive\";\nimport { setMetadata } from \"./core\";\nimport { isClass } from \"./utils\";\n\n/**\n * Loads values into the root instance by paths or from an object.\n * \n * @param {object} rootInstance - The instance into which values will be loaded.\n * @param {object} values - The values to load, either as paths or an object.\n * @param {boolean} [valueIsObject=false] - If true, `values` is treated as an object.\n * @example\n * // Using paths:\n * load(instance, { 'position.x': 10, 'position.y': 20 });\n * \n * // Using an object:\n * load(instance, { position: { x: 10, y: 20 } }, true);\n */\nexport function load(rootInstance: any, values: { [path: string]: any }): void;\nexport function load(\n  rootInstance: any,\n  values: object,\n  valueIsObject: true\n): void;\nexport function load(\n  rootInstance: any,\n  values: { [path: string]: any } | object,\n  valueIsObject?: boolean\n) {\n  if (valueIsObject) {\n    loadFromObject(rootInstance, values);\n  } else {\n    loadFromPaths(rootInstance, values);\n  }\n}\n\n/**\n * Loads values into the root instance using paths.\n * \n * @param {object} rootInstance - The instance into which values will be loaded.\n * @param {object} values - The values to load, with keys as paths.\n * @example\n * loadFromPaths(instance, { 'position.x': 10, 'position.y': 20 });\n */\nfunction loadFromPaths(rootInstance: any, values: { [path: string]: any }) {\n  for (const [path, value] of Object.entries(values)) {\n    const parts = path.split(\".\");\n    loadValue(rootInstance, parts, value);\n  }\n}\n\n/**\n * Recursively loads values from an object into the root instance.\n * \n * @param {object} rootInstance - The instance into which values will be loaded.\n * @param {object} values - The values to load.\n * @param {string} [currentPath=\"\"] - The current path in the recursion.\n * @example\n * loadFromObject(instance, { position: { x: 10, y: 20 } });\n */\nfunction loadFromObject(\n  rootInstance: any,\n  values: object,\n  currentPath: string = \"\"\n) {\n  for (let key in values) {\n    const value = values[key];\n    const newPath = currentPath ? `${currentPath}.${key}` : key;\n    if (typeof value === \"object\" && !Array.isArray(value) && value !== null) {\n      loadFromObject(rootInstance, value, newPath);\n    } else {\n      const parts = newPath.split(\".\");\n      loadValue(rootInstance, parts, value);\n    }\n  }\n}\n\n/**\n * Sets a value in the root instance by navigating through the path parts.\n * \n * @param {object} rootInstance - The instance into which the value will be set.\n * @param {string[]} parts - The parts of the path.\n * @param {any} value - The value to set.\n * @example\n * loadValue(instance, ['position', 'x'], 10);\n */\nfunction loadValue(rootInstance: any, parts: string[], value: any) {\n  let current: any = rootInstance;\n\n  for (let i = 0; i < parts.length; i++) {\n    const part = parts[i];\n\n    if (i === parts.length - 1) {\n      if (value == '$delete') {\n        if (isSignal(current)) {\n          current = current();\n        }\n        Reflect.deleteProperty(current, part);\n      }\n      else if (current[part]?._subject) {\n        current[part].set(value);\n      }\n      else {\n        current[part] = value;\n      }\n    } else {\n      if (isSignal(current)) {\n        current = current();\n      }\n      const currentValue = current[part];\n      if (currentValue === undefined) {\n        const parentInstance = getByPath(\n          rootInstance,\n          parts.slice(0, i).join(\".\")\n        );\n        const classType = parentInstance?.options?.classType;\n        if (classType) {\n          current[part] = !isClass(classType) ? classType(part) : new classType();\n          setMetadata(current[part], 'id', part)\n        } else {\n          current[part] = {};\n        }\n      }\n      current = current[part];\n    }\n  }\n}\n\n/**\n * Retrieves a value from the root instance by a path.\n * \n * @param {object} root - The root instance.\n * @param {string} path - The path to the value.\n * @returns {any} - The value at the specified path.\n * @example\n * const value = getByPath(instance, 'position.x');\n */\nexport function getByPath(root: any, path: string) {\n  const parts = path.split(\".\");\n  let current = root;\n  for (const part of parts) {\n    if (isSignal(current)) {\n      current = current();\n    }\n    if (current[part]) {\n      current = current[part];\n    } else {\n      return undefined;\n    }\n  }\n  return current;\n}\n","import { dset } from \"dset\";\n\n/**\n * Checks if a value is a Promise.\n *\n * @param {unknown} value - The value to check.\n * @returns {boolean} - Returns true if the value is a Promise, otherwise false.\n *\n * @example\n * isPromise(Promise.resolve()); // true\n * isPromise(42); // false\n */\nexport function isPromise(value: unknown): value is Promise<any> {\n  return value instanceof Promise;\n}\n\n/**\n * Awaits the given value if it is a Promise, otherwise returns the value directly.\n *\n * @param {unknown} val - The value to await or return.\n * @returns {Promise<any>} - Returns a Promise that resolves to the value.\n *\n * @example\n * awaitReturn(Promise.resolve(42)); // 42\n * awaitReturn(42); // 42\n */\nexport async function awaitReturn(val: unknown): Promise<any> {\n  return isPromise(val) ? await val : val;\n}\n\n/**\n * Checks if a value is a class.\n *\n * @param {unknown} obj - The value to check.\n * @returns {boolean} - Returns true if the value is a class, otherwise false.\n *\n * @example\n * class MyClass {}\n * isClass(MyClass); // true\n * isClass(() => {}); // false\n */\nexport function isClass(obj: unknown): boolean {\n  return (\n    typeof obj === \"function\" &&\n    obj.prototype &&\n    obj.prototype.constructor === obj\n  );\n}\n\n\n/**\n * Creates a throttled function that only invokes the provided function at most once per every wait milliseconds.\n *\n * The throttled function comes with a cancel method to cancel delayed invocations.\n * If the throttled function is invoked more than once during the wait timeout,\n * it will call the provided function with the latest arguments.\n *\n * @template F - The type of the function to throttle.\n * @param {F} func - The function to throttle.\n * @param {number} wait - The number of milliseconds to throttle invocations to.\n * @returns {(...args: Parameters<F>) => void} - Returns the new throttled function.\n *\n * @example\n * const log = throttle((message) => console.log(message), 1000);\n * log(\"Hello\"); // Will log \"Hello\" immediately\n * log(\"World\"); // Will log \"World\" after 1 second, if no other calls to log() are made within the 1 second.\n */\nexport function throttle<F extends (...args: any[]) => any>(\n  func: F,\n  wait: number\n): (...args: Parameters<F>) => void {\n  let timeout: ReturnType<typeof setTimeout> | null = null;\n  let lastArgs: Parameters<F> | null = null;\n\n  return function (...args: Parameters<F>) {\n    if (!timeout) {\n      func(...args);\n      timeout = setTimeout(() => {\n        if (lastArgs) {\n          func(...lastArgs);\n          lastArgs = null;\n        }\n        timeout = null;\n      }, wait);\n    } else {\n      lastArgs = args;\n    }\n  };\n}\n\n/**\n * Extracts parameters from a given string based on a specified pattern.\n *\n * The pattern can include placeholders in the form of {paramName}, which will be\n * extracted from the input string if they match.\n *\n * @param {string} pattern - The pattern containing placeholders.\n * @param {string} str - The string to extract parameters from.\n * @returns {{ [key: string]: string } | null} - An object containing the extracted parameters,\n *                                               or null if the string does not match the pattern.\n *\n * @example\n * // returns { id: '123' }\n * extractParams('game-{id}', 'game-123');\n *\n * @example\n * // returns { foo: 'abc', bar: 'xyz' }\n * extractParams('test-{foo}-{bar}', 'test-abc-xyz');\n *\n */\nexport function extractParams(\n  pattern: string,\n  str: string\n): { [key: string]: string } | null {\n  // Replace placeholders in the pattern with named capture groups\n  const regexPattern = pattern.replace(/{(\\w+)}/g, \"(?<$1>[\\\\w-]+)\");\n\n  // Create a strict regular expression from the pattern\n  const regex = new RegExp(`^${regexPattern}$`);\n  const match = regex.exec(str);\n\n  // If a match is found and groups are present, return the captured groups\n  if (match && match.groups) {\n    return match.groups;\n  } else if (pattern === str) {\n    // If the pattern exactly matches the string, return an empty object\n    return {};\n  } else {\n    // Otherwise, return null\n    return null;\n  }\n}\n\n/**\n * Removes a property from an object based on a dot-separated key string or an array of keys.\n *\n * The function modifies the original object by deleting the specified property.\n * It safely handles dangerous keys like __proto__, constructor, and prototype.\n *\n * @param {Record<string, any>} obj - The object from which to remove the property.\n * @param {string | string[]} keys - The key(s) specifying the property to remove. Can be a dot-separated string or an array of strings.\n *\n * @example\n * const obj = { a: { b: { c: 3 } } };\n * dremove(obj, 'a.b.c');\n * // obj is now { a: { b: {} } }\n *\n * @example\n * const obj = { a: 1, b: 2 };\n * dremove(obj, 'a');\n * // obj is now { b: 2 }\n *\n * @example\n * const obj = { a: { b: { c: 3 } } };\n * dremove(obj, ['a', 'b', 'c']);\n * // obj is now { a: { b: {} } }\n */\nexport function dremove(\n  obj: Record<string, any>,\n  keys: string | string[]\n): void {\n  // If keys is a string, convert it to an array using the \".\" separator\n  if (typeof keys === \"string\") {\n    keys = keys.split(\".\");\n  }\n\n  let i = 0;\n  const l = keys.length;\n  let t = obj;\n  let k;\n\n  while (i < l - 1) {\n    k = keys[i++];\n    if (k === \"__proto__\" || k === \"constructor\" || k === \"prototype\") return; // Avoid dangerous keys\n    if (typeof t[k] !== \"object\" || t[k] === null) return; // If the object doesn't exist, stop\n    t = t[k];\n  }\n\n  k = keys[i];\n  if (\n    t &&\n    typeof t === \"object\" &&\n    !(k === \"__proto__\" || k === \"constructor\" || k === \"prototype\")\n  ) {\n    delete t[k];\n  }\n}\n\n/**\n * Builds an object from a map of values and updates the provided memory object.\n *\n * For each key-value pair in the map, this function sets the value at the given path in the `memoryObj`.\n * If the value is \"$delete\", it removes the corresponding path from `allMemory`.\n *\n * @param {Map<string, any>} valuesMap - A map where the keys are paths and the values are the values to set at those paths.\n * @param {Record<string, any>} allMemory - The object to update based on the values in the map.\n * @returns {Record<string, any>} - The built memory object with the applied values from the map.\n *\n * @example\n * const valuesMap = new Map();\n * valuesMap.set('a.b.c', 1);\n * valuesMap.set('x.y.z', '$delete');\n * const allMemory = { x: { y: { z: 2 } } };\n * const result = buildObject(valuesMap, allMemory);\n * // result is { a: { b: { c: 1 } }, x: { y: { z: '$delete' } } }\n * // allMemory is { a: { b: { c: 1 } }, x: { y: {} } }\n */\nexport function buildObject(valuesMap: Map<string, any>, allMemory: Record<string, any>): Record<string, any> {\n  let memoryObj = {};\n  for (let path of valuesMap.keys()) {\n    const value = valuesMap.get(path);\n    dset(memoryObj, path, value);\n    if (value === \"$delete\") {\n      dremove(allMemory, path);\n    } else {\n      dset(allMemory, path, value);\n    }\n  }\n  return memoryObj;\n}"],"mappings":"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","names":["Action","name","bodyValidation","target","propertyKey","constructor","_actionMetadata","Map","set","key","Room","options","path","maxUsers","throttleStorage","throttleSync","guards","RoomGuard","Guard","descriptor","isClass","obj","prototype","constructor","isObject","item","Array","isArray","generateShortUUID","chars","uuid","i","randomIndex","Math","floor","random","length","MockPartySocket","events","Map","id","generateShortUUID","addEventListener","event","cb","set","removeEventListener","delete","_trigger","data","get","MockStorage","storage","key","put","value","list","MockPartyRoom","clients","constructor","connection","client","socket","broadcast","forEach","clear","MockConnection","state","setState","ServerIo","ClientIo","dset","z","ArraySubject","ObjectSubject","isSignal","syncClass","instance","options","cacheSync","Map","cachePersist","Set","$valuesChanges","set","path","value","onSync","setPersist","add","onPersist","has","get","createSyncClass","createStatesSnapshot","persistObject","$snapshot","key","keys","signal","persist","isObject","Array","isArray","setMetadata","target","meta","constructor","_propertyMetadata","propId","isSignal","currentClass","parentKey","parentClass","$path","syncToClient","newPath","isSignal","load","rootInstance","values","valueIsObject","loadFromObject","loadFromPaths","path","value","Object","entries","parts","split","loadValue","currentPath","key","newPath","Array","isArray","current","i","length","part","isSignal","Reflect","deleteProperty","_subject","set","currentValue","undefined","parentInstance","getByPath","slice","join","classType","options","isClass","setMetadata","root","dset","isPromise","value","Promise","awaitReturn","val","isClass","obj","prototype","constructor","throttle","func","wait","timeout","lastArgs","args","setTimeout","extractParams","pattern","str","regexPattern","replace","regex","RegExp","match","exec","groups","dremove","keys","split","i","l","length","t","k","buildObject","valuesMap","allMemory","memoryObj","path","get","dset","Message","z","object","action","string","value","any","Server","subRoom","rooms","constructor","room","isHibernate","hibernate","onStart","createRoom","options","instance","init","params","extractParams","path","id","Error","loadMemory","root","storage","get","memory","list","tmpObject","key","dset","load","$memoryAll","syncCb","values","getMemoryAll","buildObject","packet","broadcast","JSON","stringify","type","clear","persistCb","_instance","getByPath","itemValue","createStatesSnapshot","put","syncClass","onSync","throttle","onPersist","getSubRoom","getUsersProperty","meta","propId","onConnect","conn","ctx","roomGuards","guard","isAuthorized","close","publicId","generateShortUUID","user","signal","classType","isClass","awaitReturn","setState","send","pId","onMessage","message","sender","json","parse","e","result","safeParse","success","data","actions","state","actionName","guards","$actionGuards","bodyValidation","bodyResult","onClose"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signe/room",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "",
   "main": "./dist/index.js",
   "keywords": [],
@@ -17,7 +17,7 @@
     "dset": "^3.1.3",
     "partysocket": "^1.0.1",
     "zod": "^3.23.8",
-    "@signe/sync": "1.1.0"
+    "@signe/sync": "1.1.1"
   },
   "publishConfig": {
     "access": "public"

package/readme.md

@@ -10,104 +10,199 @@ npm install @signe/room @signe/reactive @signe/sync
 
 ## Features
 
-- 🔄 Automatic state synchronization
-- 👥 Built-in user management
-- 🎮 Action-based message handling
-- 🔐 Authentication support
-- 🎯 TypeScript support
+- 🔄 Automatic state synchronization across clients
+- 👥 Built-in user management with customizable player classes
+- 🎮 Action-based message handling with type safety
+- 🔐 Flexible authentication and authorization system
+- 🛡️ Guard system for room and action-level security
+- 🎯 Full TypeScript support
+- 🔌 WebSocket-based real-time communication
+- 💾 Automatic state persistence
+- 🚀 Optimized for performance with throttling support
 
-## Usage
+## Basic Usage
 
-Here's a complete example of how to create a multiplayer room:
+Here's a simple example of a multiplayer game room:
 
 ```ts
 import { signal } from "@signe/reactive";
-import { Room, Server, action } from "@signe/room";
+import { Room, Server, Action } from "@signe/room";
 import { id, sync, users } from "@signe/sync";
 
-// Define a Player class to represent connected users
-export class Player {
-  @id() id = signal("");
+// Define a Player class
+class Player {
+  @id() id: string;
   @sync() x = signal(0);
   @sync() y = signal(0);
-  @sync() color = signal("#000000");
+  @sync() score = signal(0);
+}
 
-  constructor() {
-    const randomColor = Math.floor(Math.random() * 16777215).toString(16);
-    this.color.set("#" + randomColor);
+// Create your room
+@Room({
+  path: "game",
+})
+class GameRoom {
+  @users(Player) players = signal({});
+  @sync() gameState = signal("waiting");
+
+  @Action("move")
+  move(player: Player, position: { x: number, y: number }) {
+    player.x.set(position.x);
+    player.y.set(position.y);
   }
 }
 
-// Define your room's state schema
-export class RoomSchema {
-  @sync() count = signal(0);
-  @users(Player) players = signal({});
+// Create your server
+export default class GameServer extends Server {
+  rooms = [GameRoom];
 }
+```
 
-// Create your room with custom logic
+## Advanced Features
+
+### Room Configuration
+
+The `@Room` decorator accepts various configuration options:
+
+```ts
 @Room({
-  path: "chess-{id}",  // Dynamic room path with parameters
-  maxUsers: 2,         // Limit number of users per room
+  path: "game-{id}",     // Dynamic path with parameters
+  maxUsers: 4,           // Limit number of users
+  throttleStorage: 1000, // Throttle storage updates (ms)
+  throttleSync: 100,     // Throttle sync updates (ms)
+  hibernate: false,      // Enable/disable hibernation
+  guards: [isAuthenticated], // Room-level guards
 })
-export class MyRoom extends RoomSchema {
-  // Authentication hook
-  static onAuth() {
-    // Add your authentication logic here
-  }
+```
 
-  constructor(readonly room, readonly params: { id: string }) {
-    super();
-  }
+### Authentication & Authorization
+
+You can implement authentication and authorization using guards:
+
+```ts
+// Authentication guard
+function isAuthenticated(conn: Connection, ctx: ConnectionContext) {
+  const token = ctx.request.headers.get("authorization");
+  return validateToken(token); // Returns boolean or Promise<boolean>
+}
+
+// Role-based guard
+function isAdmin(conn: Connection, value: any) {
+  return conn.state.role === "admin";
+}
 
-  // Room lifecycle hooks
-  onCreate() {
-    // Called when the room is created
+@Room({
+  path: "admin-panel",
+  guards: [isAuthenticated], // Applied to all connections and messages
+})
+class AdminRoom {
+  @Action("deleteUser")
+  @Guard([isAdmin]) // Applied only to this action
+  async deleteUser(admin: Player, userId: string) {
+    // Only authenticated admins can execute this
   }
+}
+```
+
+### State Management
 
-  onJoin(player: Player) {
-    console.log(player.id(), "joined");
-    // Handle player joining
+The room system provides several ways to manage state:
+
+```ts
+class GameRoom {
+  // Synchronized signals
+  @sync() score = signal(0);
+  @sync() gameState = signal<"waiting" | "playing" | "ended">("waiting");
+  
+  // User management
+  @users(Player) players = signal({});
+  
+  // Complex state
+  @sync() 
+  gameConfig = signal({
+    maxPlayers: 4,
+    timeLimit: 300,
+    mapSize: { width: 1000, height: 1000 }
+  });
+
+  // Methods to update state
+  @Action("updateConfig")
+  updateConfig(player: Player, config: Partial<GameConfig>) {
+    if (player.isHost) {
+      this.gameConfig.update(current => ({
+        ...current,
+        ...config
+      }));
+    }
   }
+}
+```
+
+### Lifecycle Hooks
+
+Rooms provide several lifecycle hooks:
 
-  onLeave() {
-    // Handle player leaving
+```ts
+class GameRoom {
+  async onCreate() {
   }
 
-  // Custom actions
-  @action("move")
-  move(player: Player, data: any) {
-    player.x.set(data.x);
-    player.y.set(data.y);
+  async onJoin(player: Player, conn: Connection, ctx: ConnectionContext) {
+
+  async onLeave(player: Player, conn: Connection) {
   }
-}
 
-// Create your server with room definitions
-export default class MyServer extends Server {
-  rooms = [MyRoom];
+  async onClose() {
+  }
 }
 ```
 
-## Decorators
+### Message Handling
 
-- `@Room(options)`: Defines a room with configuration options
-- `@sync()`: Marks a property for automatic synchronization
-- `@id()`: Marks a property as the unique identifier
-- `@users(PlayerClass)`: Creates a synchronized collection of users
-- `@action(name)`: Defines a method as a callable action from clients
+Handle client messages using typed actions:
 
-## Lifecycle Hooks
+```ts
+// Define message types
+interface MoveMessage {
+  x: number;
+  y: number;
+  speed: number;
+}
+
+class GameRoom {
+  @Action("move")
+  move(player: Player, data: MoveMessage) {
+    // Validate input
+    if (data.speed > player.maxSpeed) return;
+    
+    // Update player position
+    player.x.set(data.x);
+    player.y.set(data.y);
+  }
+}
+```
 
-- `onAuth()`: Called during authentication
-- `onCreate()`: Called when the room is created
-- `onJoin(player)`: Called when a player joins
-- `onLeave()`: Called when a player leaves
+### Error Handling
 
-## Best Practices
+Implement error handling in your rooms:
 
-1. Always define proper types for your actions' data parameters
-2. Implement proper authentication in the `onAuth` hook
-3. Clean up resources in the `onLeave` hook
-4. Use TypeScript for better type safety and development experience
+```ts
+class GameRoom {
+  @Action("move")
+  async move(player: Player, data: MoveMessage) {
+    try {
+      await this.validateMove(data);
+      // Process move
+    } catch (error) {
+      // Handle error
+      player.send("error", {
+        code: "INVALID_MOVE",
+        message: error.message
+      });
+    }
+  }
+}
+```
 
 ## License
 

package/src/decorators.ts

@@ -1,3 +1,8 @@
+import type * as Party from "./types/party"
+
+type GuardFn = (sender: Party.Connection, value: any) => boolean | Promise<boolean>;
+type RoomGuardFn = (conn: Party.Connection, ctx: Party.ConnectionContext) => boolean | Promise<boolean>;
+
 export function Action(name: string, bodyValidation?) {
   return function (target: any, propertyKey: string) {
     if (!target.constructor._actionMetadata) {
@@ -16,6 +21,7 @@ export interface RoomOptions {
   throttleStorage?: number;
   throttleSync?: number;
   hibernate?: boolean;
+  guards?: RoomGuardFn[];
 }
 
 export function Room(options: RoomOptions) {
@@ -24,5 +30,35 @@ export function Room(options: RoomOptions) {
     target.maxUsers = options.maxUsers;
     target.throttleStorage = options.throttleStorage;
     target.throttleSync = options.throttleSync;
+    if (options.guards) {
+      target['_roomGuards'] = options.guards;
+    }
+  };
+}
+
+/**
+ * Room guard decorator
+ * @param guards Array of guard functions to check on connection
+ */
+export function RoomGuard(guards: RoomGuardFn[]) {
+  return function (target: any) {
+    target['_roomGuards'] = guards;
   };
 }
+
+/**
+ * Action guard decorator
+ * @param guards Array of guard functions to check before action execution
+ */
+export function Guard(guards: GuardFn[]) {
+  return function (
+    target: any,
+    propertyKey: string,
+    descriptor: PropertyDescriptor
+  ) {
+    if (!target.constructor['_actionGuards']) {
+      target.constructor['_actionGuards'] = new Map();
+    }
+    target.constructor['_actionGuards'].set(propertyKey, guards);
+  };
+}

package/src/server.ts

@@ -264,6 +264,17 @@ export class Server implements Party.Server {
     const subRoom = await this.getSubRoom({
       getMemoryAll: true,
     })
+
+    // Check room guards
+    const roomGuards = subRoom.constructor['_roomGuards'] || [];
+    for (const guard of roomGuards) {
+      const isAuthorized = await guard(conn, ctx);
+      if (!isAuthorized) {
+        conn.close();
+        return;
+      }
+    }
+
     // Generate a unique public ID for the user
     const publicId = generateShortUUID()
     let user = null;
@@ -320,6 +331,16 @@ export class Server implements Party.Server {
       return;
     }
     const subRoom = await this.getSubRoom()
+
+    // Check room guards
+    const roomGuards = subRoom.constructor['_roomGuards'] || [];
+    for (const guard of roomGuards) {
+      const isAuthorized = await guard(sender, result.data.value);
+      if (!isAuthorized) {
+        return;
+      }
+    }
+
     const actions = subRoom.constructor["_actionMetadata"];
     if (actions) {
       const signal = this.getUsersProperty(subRoom);
@@ -327,6 +348,16 @@ export class Server implements Party.Server {
       const user = signal?.()[publicId];
       const actionName = actions.get(result.data.action);
       if (actionName) {
+
+        // Check all guards if they exist
+        const guards = subRoom.$actionGuards?.get(actionName.key) || [];
+        for (const guard of guards) {
+          const isAuthorized = await guard(sender, result.data.value);
+          if (!isAuthorized) {
+            return;
+          }
+        }
+
         // Validate action body if a validation schema is defined
         if (actionName.bodyValidation) {
           const bodyResult = actionName.bodyValidation.safeParse(