@korajs/server 0.3.2 → 0.4.0

package/dist/index.js

@@ -63,9 +63,7 @@ ALTER TABLE ${name} ADD COLUMN ${colDef}`);
       `CREATE INDEX IF NOT EXISTS idx_${name}_${indexField} ON ${name} (${indexField})`
     );
   }
-  statements.push(
-    `CREATE INDEX IF NOT EXISTS idx_${name}__deleted ON ${name} (_deleted)`
-  );
+  statements.push(`CREATE INDEX IF NOT EXISTS idx_${name}__deleted ON ${name} (_deleted)`);
   return statements;
 }
 function generateAllCollectionDDL(schema, dialect) {
@@ -180,7 +178,7 @@ var MemoryServerStore = class {
     if (op.sequenceNumber > currentSeq) {
       this.versionVector.set(op.nodeId, op.sequenceNumber);
     }
-    if (this.schema && this.schema.collections[op.collection]) {
+    if (this.schema?.collections[op.collection]) {
       this.rebuildMaterializedRecord(op.collection, op.recordId);
     }
     return "applied";
@@ -197,7 +195,7 @@ var MemoryServerStore = class {
   }
   async materializeCollection(collection) {
     this.assertOpen();
-    if (this.schema && this.schema.collections[collection]) {
+    if (this.schema?.collections[collection]) {
       return this.queryCollection(collection);
     }
     return this.materializeFromOps(collection);
@@ -206,13 +204,14 @@ var MemoryServerStore = class {
     this.assertOpen();
     this.assertSchema();
     this.assertCollection(collection);
+    const schema = this.schema;
     if (options?.where) {
       for (const key of Object.keys(options.where)) {
-        validateFieldName(collection, key, this.schema);
+        validateFieldName(collection, key, schema);
       }
     }
     if (options?.orderBy) {
-      validateFieldName(collection, options.orderBy, this.schema);
+      validateFieldName(collection, options.orderBy, schema);
     }
     const collectionMap = this.materializedRecords.get(collection);
     if (!collectionMap) return [];
@@ -279,9 +278,10 @@ var MemoryServerStore = class {
     this.assertOpen();
     this.assertSchema();
     this.assertCollection(collection);
+    const schema = this.schema;
     if (where) {
       for (const key of Object.keys(where)) {
-        validateFieldName(collection, key, this.schema);
+        validateFieldName(collection, key, schema);
       }
     }
     const collectionMap = this.materializedRecords.get(collection);
@@ -317,7 +317,7 @@ var MemoryServerStore = class {
   // Materialization internals
   // ---------------------------------------------------------------------------
   rebuildMaterializedRecord(collection, recordId) {
-    const collectionDef = this.schema.collections[collection];
+    const collectionDef = this.schema?.collections[collection];
     if (!collectionDef) return;
     let collectionMap = this.materializedRecords.get(collection);
     if (!collectionMap) {
@@ -325,8 +325,10 @@ var MemoryServerStore = class {
       this.materializedRecords.set(collection, collectionMap);
     }
     const recordOps = this.operations.filter((op) => op.collection === collection && op.recordId === recordId).sort((a, b) => {
-      if (a.timestamp.wallTime !== b.timestamp.wallTime) return a.timestamp.wallTime - b.timestamp.wallTime;
-      if (a.timestamp.logical !== b.timestamp.logical) return a.timestamp.logical - b.timestamp.logical;
+      if (a.timestamp.wallTime !== b.timestamp.wallTime)
+        return a.timestamp.wallTime - b.timestamp.wallTime;
+      if (a.timestamp.logical !== b.timestamp.logical)
+        return a.timestamp.logical - b.timestamp.logical;
       return a.sequenceNumber - b.sequenceNumber;
     });
     const parsedOps = recordOps.map((op) => ({
@@ -378,8 +380,10 @@ var MemoryServerStore = class {
   // ---------------------------------------------------------------------------
   materializeFromOps(collection) {
     const collectionOps = this.operations.filter((op) => op.collection === collection).sort((a, b) => {
-      if (a.timestamp.wallTime !== b.timestamp.wallTime) return a.timestamp.wallTime - b.timestamp.wallTime;
-      if (a.timestamp.logical !== b.timestamp.logical) return a.timestamp.logical - b.timestamp.logical;
+      if (a.timestamp.wallTime !== b.timestamp.wallTime)
+        return a.timestamp.wallTime - b.timestamp.wallTime;
+      if (a.timestamp.logical !== b.timestamp.logical)
+        return a.timestamp.logical - b.timestamp.logical;
       return a.sequenceNumber - b.sequenceNumber;
     });
     const records = /* @__PURE__ */ new Map();
@@ -425,9 +429,10 @@ var MemoryServerStore = class {
     }
   }
   assertCollection(collection) {
-    if (!this.schema.collections[collection]) {
+    const schema = this.schema;
+    if (!schema.collections[collection]) {
       throw new Error(
-        `Unknown collection "${collection}". Available: ${Object.keys(this.schema.collections).join(", ")}`
+        `Unknown collection "${collection}". Available: ${Object.keys(schema.collections).join(", ")}`
       );
     }
   }
@@ -503,7 +508,9 @@ var PostgresServerStore = class {
         try {
           await this.db.execute(sql.raw(alterSql));
         } catch (e) {
-          if (!(e instanceof Error && (e.message.includes("already exists") || e.message.includes("duplicate column")))) {
+          const msg = e instanceof Error ? e.message : "";
+          const causeMsg = e instanceof Error && e.cause instanceof Error ? e.cause.message : "";
+          if (!msg.includes("already exists") && !msg.includes("duplicate column") && !causeMsg.includes("already exists") && !causeMsg.includes("duplicate column")) {
             throw e;
           }
         }
@@ -535,7 +542,7 @@ var PostgresServerStore = class {
           lastSeenAt: sql`${now}`
         }
       });
-      if (this.schema && this.schema.collections[op.collection]) {
+      if (this.schema?.collections[op.collection]) {
         await this.rebuildMaterializedRecord(tx, op.collection, op.recordId);
       }
     });
@@ -549,10 +556,7 @@ var PostgresServerStore = class {
     this.assertOpen();
     await this.ready;
     const rows = await this.db.select().from(pgOperations).where(
-      and(
-        eq(pgOperations.nodeId, nodeId),
-        between(pgOperations.sequenceNumber, fromSeq, toSeq)
-      )
+      and(eq(pgOperations.nodeId, nodeId), between(pgOperations.sequenceNumber, fromSeq, toSeq))
     ).orderBy(asc(pgOperations.sequenceNumber));
     return rows.map((row) => this.deserializeOperation(row));
   }
@@ -565,7 +569,7 @@ var PostgresServerStore = class {
   async materializeCollection(collection) {
     this.assertOpen();
     await this.ready;
-    if (this.schema && this.schema.collections[collection]) {
+    if (this.schema?.collections[collection]) {
       return this.queryCollection(collection);
     }
     return this.materializeFromOpsLog(collection);
@@ -575,14 +579,15 @@ var PostgresServerStore = class {
     await this.ready;
     this.assertSchema();
     this.assertCollection(collection);
-    const collectionDef = this.schema.collections[collection];
+    const schema = this.schema;
+    const collectionDef = schema.collections[collection];
     if (options?.where) {
       for (const key of Object.keys(options.where)) {
-        validateFieldName(collection, key, this.schema);
+        validateFieldName(collection, key, schema);
       }
     }
     if (options?.orderBy) {
-      validateFieldName(collection, options.orderBy, this.schema);
+      validateFieldName(collection, options.orderBy, schema);
     }
     const query = this.buildSelectQuery(collection, options);
     const rows = await this.db.execute(query);
@@ -593,7 +598,8 @@ var PostgresServerStore = class {
     await this.ready;
     this.assertSchema();
     this.assertCollection(collection);
-    const collectionDef = this.schema.collections[collection];
+    const schema = this.schema;
+    const collectionDef = schema.collections[collection];
     const query = sql`SELECT * FROM ${sql.raw(collection)} WHERE id = ${id} AND _deleted = 0`;
     const rows = await this.db.execute(query);
     if (rows.length === 0) return null;
@@ -604,9 +610,10 @@ var PostgresServerStore = class {
     await this.ready;
     this.assertSchema();
     this.assertCollection(collection);
+    const schema = this.schema;
     if (where) {
       for (const key of Object.keys(where)) {
-        validateFieldName(collection, key, this.schema);
+        validateFieldName(collection, key, schema);
       }
     }
     const whereClause = this.buildWhereClause(where ?? {}, false);
@@ -626,18 +633,13 @@ var PostgresServerStore = class {
    * all operations for that record.
    */
   async rebuildMaterializedRecord(txOrDb, collection, recordId) {
-    const collectionDef = this.schema.collections[collection];
+    const collectionDef = this.schema?.collections[collection];
     if (!collectionDef) return;
     const ops = await txOrDb.select({
       type: pgOperations.type,
       data: pgOperations.data,
       wallTime: pgOperations.wallTime
-    }).from(pgOperations).where(
-      and(
-        eq(pgOperations.collection, collection),
-        eq(pgOperations.recordId, recordId)
-      )
-    ).orderBy(
+    }).from(pgOperations).where(and(eq(pgOperations.collection, collection), eq(pgOperations.recordId, recordId))).orderBy(
       asc(pgOperations.wallTime),
       asc(pgOperations.logical),
       asc(pgOperations.sequenceNumber)
@@ -707,7 +709,7 @@ var PostgresServerStore = class {
    * Backfill a single collection's materialized table from operations.
    */
   async backfillCollection(collectionName) {
-    const collectionDef = this.schema.collections[collectionName];
+    const collectionDef = this.schema?.collections[collectionName];
     if (!collectionDef) return;
     const allOps = await this.db.select({
       recordId: pgOperations.recordId,
@@ -764,9 +766,7 @@ var PostgresServerStore = class {
       options?.where ?? {},
       options?.includeDeleted ?? false
     );
-    const parts = [
-      sql`SELECT * FROM ${sql.raw(collection)} WHERE ${whereClause}`
-    ];
+    const parts = [sql`SELECT * FROM ${sql.raw(collection)} WHERE ${whereClause}`];
     if (options?.orderBy) {
       const dir = options.orderDirection === "desc" ? "DESC" : "ASC";
       parts.push(sql.raw(` ORDER BY ${options.orderBy} ${dir}`));
@@ -879,12 +879,8 @@ var PostgresServerStore = class {
     await this.db.execute(
       sql`CREATE INDEX IF NOT EXISTS idx_node_seq ON operations (node_id, sequence_number)`
     );
-    await this.db.execute(
-      sql`CREATE INDEX IF NOT EXISTS idx_collection ON operations (collection)`
-    );
-    await this.db.execute(
-      sql`CREATE INDEX IF NOT EXISTS idx_received ON operations (received_at)`
-    );
+    await this.db.execute(sql`CREATE INDEX IF NOT EXISTS idx_collection ON operations (collection)`);
+    await this.db.execute(sql`CREATE INDEX IF NOT EXISTS idx_received ON operations (received_at)`);
     await this.db.execute(
       sql`CREATE INDEX IF NOT EXISTS idx_collection_record ON operations (collection, record_id)`
     );
@@ -952,9 +948,10 @@ var PostgresServerStore = class {
     }
   }
   assertCollection(collection) {
-    if (!this.schema.collections[collection]) {
+    const schema = this.schema;
+    if (!schema.collections[collection]) {
       throw new Error(
-        `Unknown collection "${collection}". Available: ${Object.keys(this.schema.collections).join(", ")}`
+        `Unknown collection "${collection}". Available: ${Object.keys(schema.collections).join(", ")}`
       );
     }
   }
@@ -1087,7 +1084,7 @@ var SqliteServerStore = class {
           lastSeenAt: sql2`${now}`
         }
       }).run();
-      if (this.schema && this.schema.collections[op.collection]) {
+      if (this.schema?.collections[op.collection]) {
         this.rebuildMaterializedRecord(tx, op.collection, op.recordId);
       }
       return "applied";
@@ -1106,7 +1103,7 @@ var SqliteServerStore = class {
   }
   async materializeCollection(collection) {
     this.assertOpen();
-    if (this.schema && this.schema.collections[collection]) {
+    if (this.schema?.collections[collection]) {
       return this.queryCollection(collection);
     }
     return this.materializeFromOpsLog(collection);
@@ -1115,14 +1112,15 @@ var SqliteServerStore = class {
     this.assertOpen();
     this.assertSchema();
     this.assertCollection(collection);
-    const collectionDef = this.schema.collections[collection];
+    const schema = this.schema;
+    const collectionDef = schema.collections[collection];
     if (options?.where) {
       for (const key of Object.keys(options.where)) {
-        validateFieldName(collection, key, this.schema);
+        validateFieldName(collection, key, schema);
       }
     }
     if (options?.orderBy) {
-      validateFieldName(collection, options.orderBy, this.schema);
+      validateFieldName(collection, options.orderBy, schema);
     }
     const query = this.buildSelectQuery(collection, options);
     const rows = this.db.all(query);
@@ -1132,7 +1130,8 @@ var SqliteServerStore = class {
     this.assertOpen();
     this.assertSchema();
     this.assertCollection(collection);
-    const collectionDef = this.schema.collections[collection];
+    const schema = this.schema;
+    const collectionDef = schema.collections[collection];
     const query = sql2`SELECT * FROM ${sql2.raw(collection)} WHERE id = ${id} AND _deleted = 0`;
     const rows = this.db.all(query);
     if (rows.length === 0) return null;
@@ -1142,9 +1141,10 @@ var SqliteServerStore = class {
     this.assertOpen();
     this.assertSchema();
     this.assertCollection(collection);
+    const schema = this.schema;
     if (where) {
       for (const key of Object.keys(where)) {
-        validateFieldName(collection, key, this.schema);
+        validateFieldName(collection, key, schema);
       }
     }
     const whereClause = this.buildWhereClause(where ?? {}, false);
@@ -1164,18 +1164,13 @@ var SqliteServerStore = class {
    * transaction for atomic dual-write.
    */
   rebuildMaterializedRecord(txOrDb, collection, recordId) {
-    const collectionDef = this.schema.collections[collection];
+    const collectionDef = this.schema?.collections[collection];
     if (!collectionDef) return;
     const ops = txOrDb.select({
       type: operations.type,
       data: operations.data,
       wallTime: operations.wallTime
-    }).from(operations).where(
-      and2(
-        eq2(operations.collection, collection),
-        eq2(operations.recordId, recordId)
-      )
-    ).orderBy(asc2(operations.wallTime), asc2(operations.logical), asc2(operations.sequenceNumber)).all();
+    }).from(operations).where(and2(eq2(operations.collection, collection), eq2(operations.recordId, recordId))).orderBy(asc2(operations.wallTime), asc2(operations.logical), asc2(operations.sequenceNumber)).all();
     const parsedOps = ops.map((op) => ({
       type: op.type,
       data: op.data !== null ? JSON.parse(op.data) : null
@@ -1244,7 +1239,7 @@ var SqliteServerStore = class {
    * Backfill a single collection's materialized table from operations.
    */
   backfillCollection(collectionName) {
-    const collectionDef = this.schema.collections[collectionName];
+    const collectionDef = this.schema?.collections[collectionName];
     if (!collectionDef) return;
     const allOps = this.db.select({
       recordId: operations.recordId,
@@ -1299,9 +1294,7 @@ var SqliteServerStore = class {
       options?.where ?? {},
       options?.includeDeleted ?? false
     );
-    const parts = [
-      sql2`SELECT * FROM ${sql2.raw(collection)} WHERE ${whereClause}`
-    ];
+    const parts = [sql2`SELECT * FROM ${sql2.raw(collection)} WHERE ${whereClause}`];
     if (options?.orderBy) {
       const dir = options.orderDirection === "desc" ? "DESC" : "ASC";
       parts.push(sql2.raw(` ORDER BY ${options.orderBy} ${dir}`));
@@ -1476,9 +1469,10 @@ var SqliteServerStore = class {
     }
   }
   assertCollection(collection) {
-    if (!this.schema.collections[collection]) {
+    const schema = this.schema;
+    if (!schema.collections[collection]) {
       throw new Error(
-        `Unknown collection "${collection}". Available: ${Object.keys(this.schema.collections).join(", ")}`
+        `Unknown collection "${collection}". Available: ${Object.keys(schema.collections).join(", ")}`
       );
     }
   }
@@ -1640,11 +1634,7 @@ var WsServerTransport = class {
 // src/session/client-session.ts
 import { generateUUIDv7 as generateUUIDv74 } from "@korajs/core";
 import { topologicalSort } from "@korajs/core/internal";
-import {
-  NegotiatedMessageSerializer,
-  versionVectorToWire,
-  wireToVersionVector
-} from "@korajs/sync";
+import { NegotiatedMessageSerializer, versionVectorToWire, wireToVersionVector } from "@korajs/sync";
 
 // src/scopes/server-scope-filter.ts
 function operationMatchesScopes(op, scopes) {
@@ -1692,6 +1682,7 @@ var ClientSession = class {
   batchSize;
   schemaVersion;
   onRelay;
+  onAwarenessUpdate;
   onClose;
   constructor(options) {
     this.sessionId = options.sessionId;
@@ -1703,6 +1694,7 @@ var ClientSession = class {
     this.batchSize = options.batchSize ?? DEFAULT_BATCH_SIZE;
     this.schemaVersion = options.schemaVersion ?? DEFAULT_SCHEMA_VERSION;
     this.onRelay = options.onRelay ?? null;
+    this.onAwarenessUpdate = options.onAwarenessUpdate ?? null;
     this.onClose = options.onClose ?? null;
   }
   /**
@@ -1765,6 +1757,13 @@ var ClientSession = class {
   isStreaming() {
     return this.state === "streaming";
   }
+  /**
+   * Get the transport for this session.
+   * Used by the awareness relay to send messages to this client.
+   */
+  getTransport() {
+    return this.transport;
+  }
   // --- Private protocol handlers ---
   handleMessage(message) {
     switch (message.type) {
@@ -1779,6 +1778,9 @@ var ClientSession = class {
         break;
       case "error":
         break;
+      case "awareness-update":
+        this.handleAwarenessUpdate(message);
+        break;
     }
   }
   async handleHandshake(msg) {
@@ -1798,6 +1800,19 @@ var ClientSession = class {
       this.authContext = context;
       this.state = "authenticated";
     }
+    if (msg.syncScope) {
+      const mergedScopes = { ...msg.syncScope };
+      if (this.authContext?.scopes) {
+        for (const [collection, authScope] of Object.entries(this.authContext.scopes)) {
+          mergedScopes[collection] = { ...mergedScopes[collection] ?? {}, ...authScope };
+        }
+      }
+      if (this.authContext) {
+        this.authContext = { ...this.authContext, scopes: mergedScopes };
+      } else {
+        this.authContext = { userId: msg.nodeId, scopes: mergedScopes };
+      }
+    }
     const serverVector = this.store.getVersionVector();
     const selectedWireFormat = selectWireFormat(msg.supportedWireFormats);
     this.setSerializerWireFormat(selectedWireFormat);
@@ -1808,7 +1823,10 @@ var ClientSession = class {
       versionVector: versionVectorToWire(serverVector),
       schemaVersion: this.schemaVersion,
       accepted: true,
-      selectedWireFormat
+      selectedWireFormat,
+      // Confirm the accepted scope so the client knows what data will be synced.
+      // This may differ from what the client requested if auth scopes are narrower.
+      ...this.authContext?.scopes ? { acceptedScope: this.authContext.scopes } : {}
     };
     this.transport.send(response);
     this.emitter?.emit({ type: "sync:connected", nodeId: msg.nodeId });
@@ -1820,8 +1838,10 @@ var ClientSession = class {
   async handleOperationBatch(msg) {
     const operations2 = msg.operations.map((s) => this.serializer.decodeOperation(s));
     const applied = [];
+    const rejected = [];
     for (const op of operations2) {
       if (!operationMatchesScopes(op, this.authContext?.scopes)) {
+        rejected.push(op);
         continue;
       }
       const result = await this.store.applyRemoteOperation(op);
@@ -1829,6 +1849,15 @@ var ClientSession = class {
         applied.push(op);
       }
     }
+    if (rejected.length > 0) {
+      for (const op of rejected) {
+        this.sendError(
+          "SCOPE_VIOLATION",
+          `Operation "${op.id}" in collection "${op.collection}" is outside the client's sync scope`,
+          false
+        );
+      }
+    }
     if (operations2.length > 0) {
       this.emitter?.emit({
         type: "sync:received",
@@ -1891,6 +1920,9 @@ var ClientSession = class {
       });
     }
   }
+  handleAwarenessUpdate(msg) {
+    this.onAwarenessUpdate?.(this.sessionId, msg);
+  }
   sendError(code, message, retriable) {
     const errorMsg = {
       type: "error",
@@ -1921,8 +1953,107 @@ function selectWireFormat(supportedWireFormats) {
 }
 
 // src/server/kora-sync-server.ts
-import { SyncError as SyncError4, generateUUIDv7 as generateUUIDv75 } from "@korajs/core";
+import { SyncError as SyncError4, generateUUIDv7 as generateUUIDv76 } from "@korajs/core";
 import { JsonMessageSerializer as JsonMessageSerializer2 } from "@korajs/sync";
+
+// src/awareness/awareness-relay.ts
+import { generateUUIDv7 as generateUUIDv75 } from "@korajs/core";
+var AwarenessRelay = class {
+  clients = /* @__PURE__ */ new Map();
+  /**
+   * Register a client for awareness broadcasting.
+   *
+   * @param sessionId - Unique session identifier
+   * @param clientId - Client-assigned awareness ID
+   * @param transport - Transport for sending messages to this client
+   */
+  addClient(sessionId, clientId, transport) {
+    this.clients.set(sessionId, {
+      sessionId,
+      clientId,
+      transport,
+      state: null
+    });
+    const existingStates = {};
+    let hasStates = false;
+    for (const [, client] of this.clients) {
+      if (client.sessionId === sessionId) continue;
+      if (client.state) {
+        existingStates[String(client.clientId)] = client.state;
+        hasStates = true;
+      }
+    }
+    if (hasStates) {
+      const catchUpMsg = {
+        type: "awareness-update",
+        messageId: generateUUIDv75(),
+        clientId: 0,
+        // Server-sourced
+        states: existingStates
+      };
+      transport.send(catchUpMsg);
+    }
+  }
+  /**
+   * Remove a client and broadcast its removal to all remaining clients.
+   *
+   * @param sessionId - Session ID of the disconnecting client
+   */
+  removeClient(sessionId) {
+    const client = this.clients.get(sessionId);
+    if (!client) return;
+    this.clients.delete(sessionId);
+    if (client.state === null) return;
+    const removalStates = {
+      [String(client.clientId)]: null
+    };
+    const msg = {
+      type: "awareness-update",
+      messageId: generateUUIDv75(),
+      clientId: client.clientId,
+      states: removalStates
+    };
+    this.broadcastExcept(sessionId, msg);
+  }
+  /**
+   * Handle an incoming awareness update from a client.
+   * Stores the state and relays to all other connected clients.
+   *
+   * @param sessionId - Session ID of the sending client
+   * @param message - The awareness update message
+   */
+  handleUpdate(sessionId, message) {
+    const sender = this.clients.get(sessionId);
+    if (!sender) return;
+    const senderState = message.states[String(message.clientId)];
+    if (senderState !== void 0) {
+      sender.state = senderState;
+    }
+    this.broadcastExcept(sessionId, message);
+  }
+  /**
+   * Get the number of registered awareness clients.
+   */
+  getClientCount() {
+    return this.clients.size;
+  }
+  /**
+   * Remove all clients and clear all state.
+   */
+  clear() {
+    this.clients.clear();
+  }
+  // --- Private ---
+  broadcastExcept(excludeSessionId, message) {
+    for (const [, client] of this.clients) {
+      if (client.sessionId === excludeSessionId) continue;
+      if (!client.transport.isConnected()) continue;
+      client.transport.send(message);
+    }
+  }
+};
+
+// src/server/kora-sync-server.ts
 var DEFAULT_MAX_CONNECTIONS = 0;
 var DEFAULT_BATCH_SIZE2 = 100;
 var DEFAULT_SCHEMA_VERSION2 = 1;
@@ -1939,6 +2070,7 @@ var KoraSyncServer = class {
   port;
   host;
   path;
+  awarenessRelay = new AwarenessRelay();
   sessions = /* @__PURE__ */ new Map();
   httpClients = /* @__PURE__ */ new Map();
   httpSessionToClient = /* @__PURE__ */ new Map();
@@ -2000,6 +2132,7 @@ var KoraSyncServer = class {
    * Stop the server. Closes all sessions and the WebSocket server.
    */
   async stop() {
+    this.awarenessRelay.clear();
     for (const session of this.sessions.values()) {
       session.close("server shutting down");
     }
@@ -2056,7 +2189,7 @@ var KoraSyncServer = class {
     if (this.maxConnections > 0 && this.sessions.size >= this.maxConnections) {
       transport.send({
         type: "error",
-        messageId: generateUUIDv75(),
+        messageId: generateUUIDv76(),
         code: "MAX_CONNECTIONS",
         message: `Server has reached maximum connections (${this.maxConnections})`,
         retriable: true
@@ -2067,7 +2200,7 @@ var KoraSyncServer = class {
         max: this.maxConnections
       });
     }
-    const sessionId = generateUUIDv75();
+    const sessionId = generateUUIDv76();
     const session = new ClientSession({
       sessionId,
       transport,
@@ -2080,6 +2213,9 @@ var KoraSyncServer = class {
       onRelay: (sourceSessionId, operations2) => {
         this.handleRelay(sourceSessionId, operations2);
       },
+      onAwarenessUpdate: (sourceSessionId, message) => {
+        this.handleAwarenessRelay(sourceSessionId, message);
+      },
       onClose: (sid) => {
         this.handleSessionClose(sid);
       }
@@ -2113,6 +2249,7 @@ var KoraSyncServer = class {
     }
   }
   handleSessionClose(sessionId) {
+    this.awarenessRelay.removeClient(sessionId);
     this.sessions.delete(sessionId);
     const clientId = this.httpSessionToClient.get(sessionId);
     if (clientId) {
@@ -2120,6 +2257,15 @@ var KoraSyncServer = class {
       this.httpClients.delete(clientId);
     }
   }
+  handleAwarenessRelay(sourceSessionId, message) {
+    const session = this.sessions.get(sourceSessionId);
+    if (!session) return;
+    const transport = session.getTransport();
+    if (!this.awarenessRelay.getClientCount() || !transport) {
+    }
+    this.awarenessRelay.addClient(sourceSessionId, message.clientId, transport);
+    this.awarenessRelay.handleUpdate(sourceSessionId, message);
+  }
   getOrCreateHttpClient(clientId) {
     const existing = this.httpClients.get(clientId);
     if (existing) {
@@ -2201,6 +2347,30 @@ var KoraAuthProvider = class {
   }
 };
 
+// src/auth/mixed-auth-provider.ts
+var MixedAuthProvider = class {
+  primary;
+  anonymousScopes;
+  anonymousPrefix;
+  anonymousCounter = 0;
+  constructor(options) {
+    this.primary = options.primary;
+    this.anonymousScopes = options.anonymousScopes;
+    this.anonymousPrefix = options.anonymousPrefix ?? "anon";
+  }
+  async authenticate(token) {
+    if (token) {
+      const ctx = await this.primary.authenticate(token);
+      if (ctx) return ctx;
+    }
+    this.anonymousCounter++;
+    return {
+      userId: `${this.anonymousPrefix}-${Date.now()}-${this.anonymousCounter}`,
+      scopes: this.anonymousScopes
+    };
+  }
+};
+
 // src/server/create-server.ts
 function createKoraServer(config) {
   return new KoraSyncServer(config);
@@ -2289,7 +2459,7 @@ function createProductionServer(config) {
         }
       });
       return new Promise((resolve2) => {
-        httpServer.listen(port, "0.0.0.0", () => {
+        httpServer?.listen(port, "0.0.0.0", () => {
           resolve2(`http://localhost:${port}`);
         });
       });
@@ -2298,7 +2468,7 @@ function createProductionServer(config) {
       await syncServer.stop();
       if (httpServer) {
         await new Promise((resolve) => {
-          httpServer.close(() => resolve());
+          httpServer?.close(() => resolve());
         });
         httpServer = null;
       }
@@ -2306,11 +2476,13 @@ function createProductionServer(config) {
   };
 }
 export {
+  AwarenessRelay,
   ClientSession,
   HttpServerTransport,
   KoraAuthProvider,
   KoraSyncServer,
   MemoryServerStore,
+  MixedAuthProvider,
   NoAuthProvider,
   PostgresServerStore,
   SqliteServerStore,