@korajs/server 0.6.0 → 1.0.0-beta.0

package/LICENSE

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

package/dist/index.cjs

@@ -250,10 +250,11 @@ function createDefaultLogger() {
 
 // src/store/memory-server-store.ts
 init_cjs_shims();
-var import_core = require("@korajs/core");
+var import_core2 = require("@korajs/core");
 
 // src/store/materialization.ts
 init_cjs_shims();
+var import_core = require("@korajs/core");
 function fieldTypeToSql(descriptor, dialect) {
   switch (descriptor.kind) {
     case "string":
@@ -349,6 +350,52 @@ function replayOperationsForRecord(ops) {
   }
   return deleted ? null : record;
 }
+var BASE64_ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+var BASE64_REVERSE = new Map(
+  Array.from(BASE64_ALPHABET, (char, index3) => [char, index3])
+);
+function base64ToBytes(base64) {
+  const cleaned = base64.replace(/=+$/, "");
+  const out = new Uint8Array(Math.floor(cleaned.length * 6 / 8));
+  let buffer = 0;
+  let bits = 0;
+  let index3 = 0;
+  for (const char of cleaned) {
+    const value = BASE64_REVERSE.get(char);
+    if (value === void 0) {
+      throw new import_core.StorageError(`Invalid base64 character "${char}" in tagged richtext value`, {
+        char
+      });
+    }
+    buffer = buffer << 6 | value;
+    bits += 6;
+    if (bits >= 8) {
+      bits -= 8;
+      out[index3] = buffer >> bits & 255;
+      index3 += 1;
+    }
+  }
+  return out;
+}
+function decodeRichtextColumnValue(value) {
+  if (typeof value !== "object" || value === null || ArrayBuffer.isView(value)) {
+    return value;
+  }
+  const record = value;
+  if (Object.keys(record).length === 1 && typeof record.$koraBytes === "string") {
+    return base64ToBytes(record.$koraBytes);
+  }
+  const keys = Object.keys(record);
+  if (keys.length > 0 && keys.every((k, i) => k === String(i) && typeof record[k] === "number")) {
+    const bytes = new Uint8Array(keys.length);
+    for (let i = 0; i < keys.length; i++) {
+      const byte = record[String(i)];
+      bytes[i] = typeof byte === "number" ? byte & 255 : 0;
+    }
+    return bytes;
+  }
+  return value;
+}
 function serializeFieldValue(value, descriptor) {
   if (value === null || value === void 0) return null;
   switch (descriptor.kind) {
@@ -356,6 +403,8 @@ function serializeFieldValue(value, descriptor) {
       return typeof value === "string" ? value : JSON.stringify(value);
     case "boolean":
       return value ? 1 : 0;
+    case "richtext":
+      return decodeRichtextColumnValue(value);
     default:
       return value;
   }
@@ -401,7 +450,7 @@ var MemoryServerStore = class {
   materializedRecords = /* @__PURE__ */ new Map();
   closed = false;
   constructor(nodeId) {
-    this.nodeId = nodeId ?? (0, import_core.generateUUIDv7)();
+    this.nodeId = nodeId ?? (0, import_core2.generateUUIDv7)();
   }
   getVersionVector() {
     return new Map(this.versionVector);
@@ -738,7 +787,7 @@ var MemoryServerStore = class {
 
 // src/store/postgres-server-store.ts
 init_cjs_shims();
-var import_core2 = require("@korajs/core");
+var import_core3 = require("@korajs/core");
 var import_drizzle_orm = require("drizzle-orm");
 
 // src/store/drizzle-pg-schema.ts
@@ -787,7 +836,7 @@ var PostgresServerStore = class {
   closed = false;
   constructor(db, nodeId) {
     this.db = db;
-    this.nodeId = nodeId ?? (0, import_core2.generateUUIDv7)();
+    this.nodeId = nodeId ?? (0, import_core3.generateUUIDv7)();
     this.ready = this.initialize();
   }
   getVersionVector() {
@@ -1323,7 +1372,7 @@ async function loadPostgresDeps() {
 // src/store/sqlite-server-store.ts
 init_cjs_shims();
 var import_node_module = require("module");
-var import_core3 = require("@korajs/core");
+var import_core4 = require("@korajs/core");
 var import_drizzle_orm2 = require("drizzle-orm");
 
 // src/store/drizzle-schema.ts
@@ -1371,7 +1420,7 @@ var SqliteServerStore = class {
   closed = false;
   constructor(db, nodeId) {
     this.db = db;
-    this.nodeId = nodeId ?? (0, import_core3.generateUUIDv7)();
+    this.nodeId = nodeId ?? (0, import_core4.generateUUIDv7)();
     this.ensureTables();
   }
   getVersionVector() {
@@ -1869,7 +1918,7 @@ function createSqliteServerStore(options) {
 
 // src/transport/http-server-transport.ts
 init_cjs_shims();
-var import_core4 = require("@korajs/core");
+var import_core5 = require("@korajs/core");
 var HttpServerTransport = class {
   serializer;
   messageHandler = null;
@@ -1911,7 +1960,7 @@ var HttpServerTransport = class {
   }
   receive(payload) {
     if (!this.connected) {
-      throw new import_core4.SyncError("HTTP server transport is closed");
+      throw new import_core5.SyncError("HTTP server transport is closed");
     }
     try {
       const message = this.serializer.decode(payload);
@@ -1951,7 +2000,7 @@ var HttpServerTransport = class {
 
 // src/transport/ws-server-transport.ts
 init_cjs_shims();
-var import_core5 = require("@korajs/core");
+var import_core6 = require("@korajs/core");
 var import_sync = require("@korajs/sync");
 var WS_OPEN = 1;
 var WsServerTransport = class {
@@ -1967,7 +2016,7 @@ var WsServerTransport = class {
   }
   send(message) {
     if (this.ws.readyState !== WS_OPEN) {
-      throw new import_core5.SyncError("Cannot send message: WebSocket is not open", {
+      throw new import_core6.SyncError("Cannot send message: WebSocket is not open", {
         readyState: this.ws.readyState,
         messageType: message.type
       });
@@ -1994,7 +2043,7 @@ var WsServerTransport = class {
     this.ws.on("message", (data) => {
       try {
         if (typeof data !== "string" && !(data instanceof Uint8Array) && !(data instanceof ArrayBuffer)) {
-          throw new import_core5.SyncError("Unsupported WebSocket payload type", {
+          throw new import_core6.SyncError("Unsupported WebSocket payload type", {
             payloadType: typeof data
           });
         }
@@ -2015,7 +2064,7 @@ var WsServerTransport = class {
 
 // src/session/client-session.ts
 init_cjs_shims();
-var import_core8 = require("@korajs/core");
+var import_core10 = require("@korajs/core");
 var import_internal = require("@korajs/core/internal");
 var import_sync2 = require("@korajs/sync");
 
@@ -2107,12 +2156,12 @@ function createServerReferentialContext(store) {
 
 // src/apply/server-side-effect-operation.ts
 init_cjs_shims();
-var import_core6 = require("@korajs/core");
+var import_core7 = require("@korajs/core");
 async function createServerSideEffectOperation(store, parentOp, effect, schemaVersion, sequenceNumber) {
   const nodeId = store.getNodeId();
-  const clock = new import_core6.HybridLogicalClock(nodeId);
+  const clock = new import_core7.HybridLogicalClock(nodeId);
   clock.receive(parentOp.timestamp);
-  return (0, import_core6.createOperation)(
+  return (0, import_core7.createOperation)(
     {
       nodeId,
       type: effect.type === "delete" ? "delete" : "update",
@@ -2192,19 +2241,19 @@ async function applyServerOperation(store, op, relationLookup) {
 
 // src/scopes/resolve-session-scopes.ts
 init_cjs_shims();
-var import_core7 = require("@korajs/core");
+var import_core8 = require("@korajs/core");
 function resolveSessionScopes(schema, options) {
   const { handshakeScope, authScopes, scopeValues } = options;
   let resolved;
   if (schema && scopeValues && Object.keys(scopeValues).length > 0) {
-    resolved = (0, import_core7.buildScopeMap)(schema, scopeValues);
+    resolved = (0, import_core8.buildScopeMap)(schema, scopeValues);
   } else if (handshakeScope) {
     resolved = { ...handshakeScope };
   } else if (authScopes) {
     resolved = { ...authScopes };
   }
   if (schema && !resolved && scopeValues) {
-    resolved = (0, import_core7.buildScopeMap)(schema, scopeValues);
+    resolved = (0, import_core8.buildScopeMap)(schema, scopeValues);
   }
   if (authScopes) {
     resolved = mergeScopeMaps(resolved, authScopes, "auth");
@@ -2259,9 +2308,17 @@ function asRecord(value) {
 
 // src/session/operation-validation.ts
 init_cjs_shims();
+var import_core9 = require("@korajs/core");
 var SERVER_MAX_TIMESTAMP_FUTURE_MS = 6e4;
 function isOperationTimestampValid(op, now = Date.now()) {
-  return op.timestamp.wallTime <= now + SERVER_MAX_TIMESTAMP_FUTURE_MS;
+  const { wallTime, logical } = op.timestamp;
+  if (!Number.isInteger(wallTime) || wallTime < 0) {
+    return false;
+  }
+  if (!Number.isInteger(logical) || logical < 0 || logical > import_core9.MAX_LOGICAL) {
+    return false;
+  }
+  return wallTime <= now + SERVER_MAX_TIMESTAMP_FUTURE_MS;
 }
 
 // src/session/session-operation-limits.ts
@@ -2379,7 +2436,7 @@ var ClientSession = class {
     const serializedOps = visibleOperations.map((op) => this.serializer.encodeOperation(op));
     const msg = {
       type: "operation-batch",
-      messageId: (0, import_core8.generateUUIDv7)(),
+      messageId: (0, import_core10.generateUUIDv7)(),
       operations: serializedOps,
       isFinal: true,
       batchIndex: 0
@@ -2503,14 +2560,15 @@ var ClientSession = class {
       const { min, max } = this.supportedSchemaVersions;
       const response2 = {
         type: "handshake-response",
-        messageId: (0, import_core8.generateUUIDv7)(),
+        messageId: (0, import_core10.generateUUIDv7)(),
         nodeId: this.store.getNodeId(),
         versionVector: (0, import_sync2.versionVectorToWire)(serverVector),
         schemaVersion: this.schemaVersion,
         accepted: false,
         rejectReason: `${import_sync2.SCHEMA_MISMATCH_PREFIX}: client schema version ${msg.schemaVersion} not in supported range [${min}, ${max}]`,
         supportedSchemaMin: min,
-        supportedSchemaMax: max
+        supportedSchemaMax: max,
+        serverTime: Date.now()
       };
       this.sendToClient(response2);
       this.close("schema version mismatch");
@@ -2518,12 +2576,13 @@ var ClientSession = class {
     }
     const response = {
       type: "handshake-response",
-      messageId: (0, import_core8.generateUUIDv7)(),
+      messageId: (0, import_core10.generateUUIDv7)(),
       nodeId: this.store.getNodeId(),
       versionVector: (0, import_sync2.versionVectorToWire)(serverVector),
       schemaVersion: this.schemaVersion,
       accepted: true,
       selectedWireFormat,
+      serverTime: Date.now(),
       // 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 } : {}
@@ -2600,7 +2659,7 @@ var ClientSession = class {
     const lastOp = operations2[operations2.length - 1];
     const ack = {
       type: "acknowledgment",
-      messageId: (0, import_core8.generateUUIDv7)(),
+      messageId: (0, import_core10.generateUUIDv7)(),
       acknowledgedMessageId: msg.messageId,
       lastSequenceNumber: lastOp ? lastOp.sequenceNumber : 0
     };
@@ -2623,7 +2682,7 @@ var ClientSession = class {
     if (missing.length === 0) {
       const emptyBatch = {
         type: "operation-batch",
-        messageId: (0, import_core8.generateUUIDv7)(),
+        messageId: (0, import_core10.generateUUIDv7)(),
         operations: [],
         isFinal: true,
         batchIndex: 0,
@@ -2638,7 +2697,7 @@ var ClientSession = class {
     if (afterCursor.length === 0) {
       const emptyBatch = {
         type: "operation-batch",
-        messageId: (0, import_core8.generateUUIDv7)(),
+        messageId: (0, import_core10.generateUUIDv7)(),
         operations: [],
         isFinal: true,
         batchIndex: this.resumeDeltaCursor?.batchIndex ?? 0,
@@ -2654,7 +2713,7 @@ var ClientSession = class {
       const batchCursor = (0, import_sync2.createDeltaCursorFromBatch)(batchOps, i);
       const batchMsg = {
         type: "operation-batch",
-        messageId: (0, import_core8.generateUUIDv7)(),
+        messageId: (0, import_core10.generateUUIDv7)(),
         operations: serializedOps,
         isFinal: i === totalBatches - 1,
         batchIndex: i,
@@ -2684,7 +2743,7 @@ var ClientSession = class {
   sendError(code, message, retriable) {
     const errorMsg = {
       type: "error",
-      messageId: (0, import_core8.generateUUIDv7)(),
+      messageId: (0, import_core10.generateUUIDv7)(),
       code,
       message,
       retriable
@@ -2712,13 +2771,13 @@ function selectWireFormat(supportedWireFormats) {
 
 // src/server/kora-sync-server.ts
 init_cjs_shims();
-var import_core10 = require("@korajs/core");
+var import_core12 = require("@korajs/core");
 var import_internal2 = require("@korajs/core/internal");
 var import_sync3 = require("@korajs/sync");
 
 // src/awareness/awareness-relay.ts
 init_cjs_shims();
-var import_core9 = require("@korajs/core");
+var import_core11 = require("@korajs/core");
 var AwarenessRelay = class {
   clients = /* @__PURE__ */ new Map();
   /**
@@ -2747,7 +2806,7 @@ var AwarenessRelay = class {
     if (hasStates) {
       const catchUpMsg = {
         type: "awareness-update",
-        messageId: (0, import_core9.generateUUIDv7)(),
+        messageId: (0, import_core11.generateUUIDv7)(),
         clientId: 0,
         // Server-sourced
         states: existingStates
@@ -2770,7 +2829,7 @@ var AwarenessRelay = class {
     };
     const msg = {
       type: "awareness-update",
-      messageId: (0, import_core9.generateUUIDv7)(),
+      messageId: (0, import_core11.generateUUIDv7)(),
       clientId: client.clientId,
       states: removalStates
     };
@@ -3084,10 +3143,10 @@ var KoraSyncServer = class {
    */
   async start(wsServerImpl) {
     if (this.running) {
-      throw new import_core10.SyncError("Server is already running", { port: this.port });
+      throw new import_core12.SyncError("Server is already running", { port: this.port });
     }
     if (!wsServerImpl && this.port === void 0) {
-      throw new import_core10.SyncError(
+      throw new import_core12.SyncError(
         "Port is required for standalone mode. Provide port in config or use handleConnection() for attach mode.",
         {}
       );
@@ -3196,7 +3255,7 @@ var KoraSyncServer = class {
     if (this.maxConnections > 0 && this.sessions.size >= this.maxConnections) {
       transport.send({
         type: "error",
-        messageId: (0, import_core10.generateUUIDv7)(),
+        messageId: (0, import_core12.generateUUIDv7)(),
         code: "MAX_CONNECTIONS",
         message: `Server has reached maximum connections (${this.maxConnections})`,
         retriable: true
@@ -3209,12 +3268,12 @@ var KoraSyncServer = class {
         event: "connection.rejected",
         details: { reason: "max_connections", max: this.maxConnections }
       });
-      throw new import_core10.SyncError("Maximum connections reached", {
+      throw new import_core12.SyncError("Maximum connections reached", {
         current: this.sessions.size,
         max: this.maxConnections
       });
     }
-    const sessionId = (0, import_core10.generateUUIDv7)();
+    const sessionId = (0, import_core12.generateUUIDv7)();
     this.metrics.recordConnection(sessionId);
     const sessionEmitter = new import_internal2.SimpleEventEmitter();
     sessionEmitter.on("sync:connected", (event) => {