@korajs/server 1.0.0-beta.6 → 1.0.0-beta.9

package/dist/index.cjs

@@ -2397,6 +2397,7 @@ var WsServerTransport = class {
 // src/session/client-session.ts
 init_cjs_shims();
 var import_core10 = require("@korajs/core");
+var import_core11 = require("@korajs/core");
 var import_internal = require("@korajs/core/internal");
 var import_sync2 = require("@korajs/sync");
 var import_sync3 = require("@korajs/sync");
@@ -2522,6 +2523,18 @@ function nextServerSequenceNumber(store) {
 async function applyServerOperation(store, op, relationLookup) {
   const schema = store.getSchema();
   const lookup = relationLookup ?? (schema ? (0, import_merge2.buildMergeRelationLookup)(schema) : /* @__PURE__ */ new Map());
+  const shapeCheck = validateOperationShape(op, schema);
+  if (!shapeCheck.valid) {
+    return {
+      result: "skipped",
+      appliedOperations: [],
+      rejection: {
+        code: shapeCheck.code ?? "SCHEMA_VALIDATION_ERROR",
+        message: shapeCheck.message ?? `Operation "${op.id}" does not match the server schema`,
+        retriable: false
+      }
+    };
+  }
   const constraintCheck = await validateIncomingOperationConstraints(store, op, schema);
   if (!constraintCheck.valid) {
     const code = constraintCheck.code ?? "CONSTRAINT_VIOLATION";
@@ -2575,6 +2588,67 @@ async function applyServerOperation(store, op, relationLookup) {
     appliedOperations: result === "applied" ? [op] : []
   };
 }
+function validateOperationShape(op, schema) {
+  if (!schema) {
+    return { valid: true };
+  }
+  const collection = schema.collections[op.collection];
+  if (!collection) {
+    return {
+      valid: false,
+      code: "UNKNOWN_COLLECTION",
+      message: `Operation "${op.id}" targets unknown collection "${op.collection}".`
+    };
+  }
+  const declaredFields = new Set(Object.keys(collection.fields));
+  const systemPreviousFields = /* @__PURE__ */ new Set(["id", "_created_at", "_updated_at", "_deleted"]);
+  const invalidDataField = firstInvalidField(op.data, declaredFields);
+  if (invalidDataField) {
+    return {
+      valid: false,
+      code: "SCHEMA_VALIDATION_ERROR",
+      message: `Operation "${op.id}" contains undeclared field "${invalidDataField}" in data for collection "${op.collection}".`
+    };
+  }
+  const invalidPreviousField = firstInvalidField(
+    op.previousData,
+    declaredFields,
+    systemPreviousFields
+  );
+  if (invalidPreviousField) {
+    return {
+      valid: false,
+      code: "SCHEMA_VALIDATION_ERROR",
+      message: `Operation "${op.id}" contains undeclared field "${invalidPreviousField}" in previousData for collection "${op.collection}".`
+    };
+  }
+  if (op.atomicOps) {
+    for (const field of Object.keys(op.atomicOps)) {
+      if (!declaredFields.has(field)) {
+        return {
+          valid: false,
+          code: "SCHEMA_VALIDATION_ERROR",
+          message: `Operation "${op.id}" contains undeclared atomic field "${field}" for collection "${op.collection}".`
+        };
+      }
+    }
+  }
+  return { valid: true };
+}
+function firstInvalidField(value, declaredFields, extraAllowedFields) {
+  if (value === null || value === void 0) {
+    return null;
+  }
+  if (typeof value !== "object" || Array.isArray(value)) {
+    return null;
+  }
+  for (const field of Object.keys(value)) {
+    if (!declaredFields.has(field) && !extraAllowedFields?.has(field)) {
+      return field;
+    }
+  }
+  return null;
+}
 
 // src/auth/no-auth.ts
 init_cjs_shims();
@@ -2626,6 +2700,7 @@ function operationMatchesScopes(op, scopes, fullRecord) {
   if (!scopes) return true;
   const collectionScope = scopes[op.collection];
   if (!collectionScope) return false;
+  if (Object.keys(collectionScope).length === 0) return true;
   const snapshot = buildSnapshot(op, fullRecord);
   if (!snapshot) return false;
   for (const [field, expected] of Object.entries(collectionScope)) {
@@ -2639,6 +2714,7 @@ function missingScopeFields(op, scopes) {
   if (!scopes) return [];
   const collectionScope = scopes[op.collection];
   if (!collectionScope) return [];
+  if (Object.keys(collectionScope).length === 0) return [];
   const snapshot = buildSnapshot(op);
   return Object.keys(collectionScope).filter((field) => !snapshot || !(field in snapshot));
 }
@@ -2740,6 +2816,20 @@ function warnIfMultiTenantWithoutScopes(auth, resolvedScopes, schema) {
     "[kora] An authenticated session resolved to no sync scopes, so every user will sync every other user's data. Return per-user sync scopes from your auth provider (for example KoraAuthProvider's resolveScopes) to isolate tenants. Note: declaring sync rules in your schema is not enough on its own \u2014 the per-user values come from the auth provider. (This warning is expected for single-tenant apps where all authenticated users are meant to share the same data.)"
   );
 }
+function stableStringify(value) {
+  if (Array.isArray(value)) {
+    return `[${value.map((item) => stableStringify(item)).join(",")}]`;
+  }
+  if (value && typeof value === "object") {
+    const record = value;
+    const entries = Object.keys(record).sort().map((key) => `${JSON.stringify(key)}:${stableStringify(record[key])}`);
+    return `{${entries.join(",")}}`;
+  }
+  return JSON.stringify(value);
+}
+function sameScopeMap(a, b) {
+  return stableStringify(a ?? null) === stableStringify(b ?? null);
+}
 var ClientSession = class _ClientSession {
   state = "connected";
   clientNodeId = null;
@@ -2763,6 +2853,13 @@ var ClientSession = class _ClientSession {
    * client's reported watermark at handshake.
    */
   lastAckedDeliverySeq = 0;
+  /**
+   * Timestamp of the last delivery-stream send attempt. Periodic retransmission uses
+   * this as its stale window so a slow client does not receive duplicate full-stream
+   * batches every server tick while the first batch is still being applied.
+   */
+  lastDeliveryPushAttemptAtMs = 0;
+  deliveryStallRepeatCount = 0;
   /** Serializes incremental delivery pushes so their batches never interleave. */
   deliveryPushChain = Promise.resolve();
   /**
@@ -2785,6 +2882,7 @@ var ClientSession = class _ClientSession {
   batchSize;
   schemaVersion;
   supportedSchemaVersions;
+  operationTransforms;
   onRelay;
   onAwarenessUpdate;
   onYjsDocUpdate;
@@ -2814,6 +2912,7 @@ var ClientSession = class _ClientSession {
       min: this.schemaVersion,
       max: this.schemaVersion
     };
+    this.operationTransforms = options.operationTransforms ?? [];
     this.onRelay = options.onRelay ?? null;
     this.onAwarenessUpdate = options.onAwarenessUpdate ?? null;
     this.onYjsDocUpdate = options.onYjsDocUpdate ?? null;
@@ -2863,6 +2962,7 @@ var ClientSession = class _ClientSession {
     this.deliveryPushChain = this.deliveryPushChain.then(async () => {
       if (this.state !== "streaming" || !this.transport.isConnected()) return;
       try {
+        this.lastDeliveryPushAttemptAtMs = Date.now();
         await this.sendDeliveryStream(
           this.lastAckedDeliverySeq,
           false,
@@ -2884,7 +2984,7 @@ var ClientSession = class _ClientSession {
     const serializedOps = visibleOperations.map((op) => this.serializer.encodeOperation(op));
     const msg = {
       type: "operation-batch",
-      messageId: (0, import_core10.generateUUIDv7)(),
+      messageId: (0, import_core11.generateUUIDv7)(),
       operations: serializedOps,
       isFinal: true,
       batchIndex: 0
@@ -2910,6 +3010,18 @@ var ClientSession = class _ClientSession {
   retransmitPendingRelays(staleMs = 0) {
     if (this.state !== "streaming" || !this.transport.isConnected()) return;
     if (this.clientDeliveryWatermark !== null) {
+      if (staleMs > 0 && Date.now() - this.lastDeliveryPushAttemptAtMs < staleMs) {
+        return;
+      }
+      this.deliveryStallRepeatCount += 1;
+      if (this.deliveryStallRepeatCount >= 3) {
+        this.emitter?.emit({
+          type: "sync:delivery-stalled",
+          sessionId: this.sessionId,
+          watermark: this.lastAckedDeliverySeq,
+          repeatCount: this.deliveryStallRepeatCount
+        });
+      }
       this.pushDeliveryStream();
       return;
     }
@@ -3002,6 +3114,7 @@ var ClientSession = class _ClientSession {
         this.pendingRelays.delete(message.acknowledgedMessageId);
         if (message.deliverySequence !== void 0) {
           this.lastAckedDeliverySeq = Math.max(this.lastAckedDeliverySeq, message.deliverySequence);
+          this.deliveryStallRepeatCount = 0;
         }
         break;
       case "error":
@@ -3033,7 +3146,7 @@ var ClientSession = class _ClientSession {
       return;
     }
     const bytes = (0, import_sync2.decodeBlobChunkBytes)(message.bytes);
-    const actual = await (0, import_core10.hashBlob)(bytes);
+    const actual = await (0, import_core11.hashBlob)(bytes);
     if (actual !== message.hash) {
       return;
     }
@@ -3092,6 +3205,9 @@ var ClientSession = class _ClientSession {
     }
     this.resumeDeltaCursor = msg.deltaCursor ? (0, import_sync3.decodeDeltaCursor)(msg.deltaCursor) : null;
     this.clientDeliveryWatermark = msg.lastDeliverySequence ?? null;
+    if (this.clientDeliveryWatermark !== null && !sameScopeMap(msg.syncScope, this.authContext?.scopes)) {
+      this.clientDeliveryWatermark = 0;
+    }
     const clientUsesWatermark = this.clientDeliveryWatermark !== null;
     let serverMaxDelivery = 0;
     if (clientUsesWatermark) {
@@ -3105,9 +3221,17 @@ var ClientSession = class _ClientSession {
     this.setSerializerWireFormat(selectedWireFormat);
     if (!(0, import_sync3.isClientSchemaVersionSupported)(msg.schemaVersion, this.supportedSchemaVersions)) {
       const { min, max } = this.supportedSchemaVersions;
+      this.emitter?.emit({
+        type: "sync:schema-mismatch",
+        clientSchemaVersion: msg.schemaVersion,
+        serverSchemaVersion: this.schemaVersion,
+        supportedMin: min,
+        supportedMax: max,
+        reason: `${import_sync3.SCHEMA_MISMATCH_PREFIX}: client schema version ${msg.schemaVersion} not in supported range [${min}, ${max}]`
+      });
       const response2 = {
         type: "handshake-response",
-        messageId: (0, import_core10.generateUUIDv7)(),
+        messageId: (0, import_core11.generateUUIDv7)(),
         nodeId: this.store.getNodeId(),
         versionVector: (0, import_sync3.versionVectorToWire)(serverVector),
         schemaVersion: this.schemaVersion,
@@ -3123,7 +3247,7 @@ var ClientSession = class _ClientSession {
     }
     const response = {
       type: "handshake-response",
-      messageId: (0, import_core10.generateUUIDv7)(),
+      messageId: (0, import_core11.generateUUIDv7)(),
       nodeId: this.store.getNodeId(),
       versionVector: (0, import_sync3.versionVectorToWire)(serverVector),
       schemaVersion: this.schemaVersion,
@@ -3147,6 +3271,7 @@ var ClientSession = class _ClientSession {
     if (this.clientDeliveryWatermark !== null) {
       this.lastAckedDeliverySeq = this.clientDeliveryWatermark;
       const excludeOwn = this.clientDeliveryWatermark > 0 ? this.clientNodeId ?? void 0 : void 0;
+      this.lastDeliveryPushAttemptAtMs = Date.now();
       await this.sendDeliveryStream(this.clientDeliveryWatermark, true, excludeOwn);
     } else {
       const clientVector = (0, import_sync3.wireToVersionVector)(msg.versionVector);
@@ -3163,10 +3288,20 @@ var ClientSession = class _ClientSession {
   async handleOperationBatch(msg) {
     const operations2 = msg.operations.map((s) => this.serializer.decodeOperation(s));
     const applied = [];
-    const rejected = [];
+    let acknowledgedThrough = 0;
+    let canAdvanceAck = true;
     for (const op of operations2) {
+      if (!canAdvanceAck) {
+        continue;
+      }
       if (!await this.operationVisibleToClient(op)) {
-        rejected.push(op);
+        this.sendOperationRejected(
+          op,
+          "SCOPE_VIOLATION",
+          `Operation "${op.id}" in collection "${op.collection}" is outside the client's sync scope. Refresh sync scopes and retry.`,
+          true
+        );
+        canAdvanceAck = false;
         continue;
       }
       if (!isOperationTimestampValid(op)) {
@@ -3175,6 +3310,7 @@ var ClientSession = class _ClientSession {
           `Operation "${op.id}" timestamp is too far in the future`,
           false
         );
+        canAdvanceAck = false;
         continue;
       }
       if (!this.rateLimiter.allow(1)) {
@@ -3183,6 +3319,7 @@ var ClientSession = class _ClientSession {
           `Session exceeded operation rate limit (${String(this.maxOpsPerMinute)} ops/min)`,
           true
         );
+        canAdvanceAck = false;
         continue;
       }
       const sizeCheck = validateOperationSize(op, this.maxOperationBytes);
@@ -3192,53 +3329,73 @@ var ClientSession = class _ClientSession {
           sizeCheck.message ?? `Operation "${op.id}" is too large`,
           false
         );
+        canAdvanceAck = false;
+        continue;
+      }
+      const serverOp = this.transformForServerSchema(op);
+      if (serverOp === null) {
+        this.sendOperationRejected(
+          op,
+          "SCHEMA_TRANSFORM_UNAVAILABLE",
+          `Operation "${op.id}" cannot be transformed from schema v${op.schemaVersion} to server schema v${this.schemaVersion}.`,
+          false
+        );
+        acknowledgedThrough = op.sequenceNumber;
         continue;
       }
       if (this.validateOperation && this.koraContext) {
         let decision;
         try {
-          decision = await this.validateOperation(op, {
+          decision = await this.validateOperation(serverOp, {
             auth: this.authContext,
             kora: this.koraContext
           });
         } catch (error) {
           const message = error instanceof Error ? error.message : "validator error";
-          this.sendOperationRejected(op, "VALIDATION_ERROR", `Validator threw: ${message}`, true);
+          this.sendOperationRejected(
+            serverOp,
+            "VALIDATION_ERROR",
+            `Validator threw: ${message}`,
+            true
+          );
+          canAdvanceAck = false;
           continue;
         }
         if (decision.action === "reject") {
-          this.sendOperationRejected(
-            op,
-            decision.code,
-            decision.message,
-            decision.retriable ?? isRetriableRejection(decision.code)
-          );
+          const retriable = decision.retriable ?? isRetriableRejection(decision.code);
+          this.sendOperationRejected(serverOp, decision.code, decision.message, retriable);
+          if (retriable) {
+            canAdvanceAck = false;
+          } else {
+            acknowledgedThrough = op.sequenceNumber;
+          }
           continue;
         }
         if (decision.action === "ignore") {
+          acknowledgedThrough = op.sequenceNumber;
           continue;
         }
       }
-      const applyResult = await applyServerOperation(this.store, op);
+      const applyResult = await applyServerOperation(this.store, serverOp);
       if (applyResult.rejection) {
-        this.sendError(
+        this.sendOperationRejected(
+          serverOp,
           applyResult.rejection.code,
           applyResult.rejection.message,
           applyResult.rejection.retriable
         );
+        if (applyResult.rejection.retriable) {
+          canAdvanceAck = false;
+        } else {
+          acknowledgedThrough = op.sequenceNumber;
+        }
         continue;
       }
       if (applyResult.result === "applied") {
         applied.push(...applyResult.appliedOperations);
-      }
-    }
-    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
-        );
+        acknowledgedThrough = op.sequenceNumber;
+      } else {
+        acknowledgedThrough = op.sequenceNumber;
       }
     }
     if (operations2.length > 0) {
@@ -3251,15 +3408,21 @@ var ClientSession = class _ClientSession {
     const lastOp = operations2[operations2.length - 1];
     const ack = {
       type: "acknowledgment",
-      messageId: (0, import_core10.generateUUIDv7)(),
+      messageId: (0, import_core11.generateUUIDv7)(),
       acknowledgedMessageId: msg.messageId,
-      lastSequenceNumber: lastOp ? lastOp.sequenceNumber : 0
+      lastSequenceNumber: lastOp ? Math.min(acknowledgedThrough, lastOp.sequenceNumber) : 0
     };
     this.sendToClient(ack);
     if (applied.length > 0) {
       this.onRelay?.(this.sessionId, applied);
     }
   }
+  transformForServerSchema(op) {
+    if (op.schemaVersion === this.schemaVersion) {
+      return op;
+    }
+    return (0, import_core10.applyOperationTransforms)(op, this.schemaVersion, this.operationTransforms);
+  }
   async sendDelta(clientVector) {
     const serverVector = this.store.getVersionVector();
     const missing = [];
@@ -3277,7 +3440,7 @@ var ClientSession = class _ClientSession {
     if (missing.length === 0) {
       const emptyBatch = {
         type: "operation-batch",
-        messageId: (0, import_core10.generateUUIDv7)(),
+        messageId: (0, import_core11.generateUUIDv7)(),
         operations: [],
         isFinal: true,
         batchIndex: 0,
@@ -3292,7 +3455,7 @@ var ClientSession = class _ClientSession {
     if (afterCursor.length === 0) {
       const emptyBatch = {
         type: "operation-batch",
-        messageId: (0, import_core10.generateUUIDv7)(),
+        messageId: (0, import_core11.generateUUIDv7)(),
         operations: [],
         isFinal: true,
         batchIndex: this.resumeDeltaCursor?.batchIndex ?? 0,
@@ -3308,7 +3471,7 @@ var ClientSession = class _ClientSession {
       const batchCursor = (0, import_sync3.createDeltaCursorFromBatch)(batchOps, i);
       const batchMsg = {
         type: "operation-batch",
-        messageId: (0, import_core10.generateUUIDv7)(),
+        messageId: (0, import_core11.generateUUIDv7)(),
         operations: serializedOps,
         isFinal: i === totalBatches - 1,
         batchIndex: i,
@@ -3385,7 +3548,7 @@ var ClientSession = class _ClientSession {
   sendDeliveryBatch(slice, base, max, batchIndex, isFinal) {
     const batchMsg = {
       type: "operation-batch",
-      messageId: (0, import_core10.generateUUIDv7)(),
+      messageId: (0, import_core11.generateUUIDv7)(),
       operations: slice.map((delivered) => this.serializer.encodeOperation(delivered.operation)),
       isFinal,
       batchIndex,
@@ -3438,7 +3601,7 @@ var ClientSession = class _ClientSession {
   sendError(code, message, retriable) {
     const errorMsg = {
       type: "error",
-      messageId: (0, import_core10.generateUUIDv7)(),
+      messageId: (0, import_core11.generateUUIDv7)(),
       code,
       message,
       retriable
@@ -3454,7 +3617,7 @@ var ClientSession = class _ClientSession {
   sendOperationRejected(op, code, message, retriable) {
     const rejectedMsg = {
       type: "operation-rejected",
-      messageId: (0, import_core10.generateUUIDv7)(),
+      messageId: (0, import_core11.generateUUIDv7)(),
       operationId: op.id,
       collection: op.collection,
       recordId: op.recordId,
@@ -3486,13 +3649,13 @@ function selectWireFormat(supportedWireFormats) {
 
 // src/server/kora-sync-server.ts
 init_cjs_shims();
-var import_core13 = require("@korajs/core");
+var import_core14 = require("@korajs/core");
 var import_internal2 = require("@korajs/core/internal");
 var import_sync5 = require("@korajs/sync");
 
 // src/awareness/awareness-relay.ts
 init_cjs_shims();
-var import_core11 = require("@korajs/core");
+var import_core12 = require("@korajs/core");
 var AwarenessRelay = class {
   clients = /* @__PURE__ */ new Map();
   /**
@@ -3521,7 +3684,7 @@ var AwarenessRelay = class {
     if (hasStates) {
       const catchUpMsg = {
         type: "awareness-update",
-        messageId: (0, import_core11.generateUUIDv7)(),
+        messageId: (0, import_core12.generateUUIDv7)(),
         clientId: 0,
         // Server-sourced
         states: existingStates
@@ -3544,7 +3707,7 @@ var AwarenessRelay = class {
     };
     const msg = {
       type: "awareness-update",
-      messageId: (0, import_core11.generateUUIDv7)(),
+      messageId: (0, import_core12.generateUUIDv7)(),
       clientId: client.clientId,
       states: removalStates
     };
@@ -3850,7 +4013,7 @@ var YjsDocRelay = class {
 
 // src/server/route-context.ts
 init_cjs_shims();
-var import_core12 = require("@korajs/core");
+var import_core13 = require("@korajs/core");
 
 // src/apply/route-predicate.ts
 init_cjs_shims();
@@ -3925,16 +4088,16 @@ function pickFields(record, keys) {
 }
 async function buildRouteOperation(store, mutation, currentOverride, clockOverride) {
   const nodeId = store.getNodeId();
-  const clock = clockOverride ?? new import_core12.HybridLogicalClock(nodeId);
+  const clock = clockOverride ?? new import_core13.HybridLogicalClock(nodeId);
   const schemaVersion = store.getSchema()?.version ?? 1;
   const sequenceNumber = nextServerSequenceNumber(store);
   if (mutation.type === "insert") {
-    return (0, import_core12.createOperation)(
+    return (0, import_core13.createOperation)(
       {
         nodeId,
         type: "insert",
         collection: mutation.collection,
-        recordId: mutation.recordId ?? (0, import_core12.generateUUIDv7)(),
+        recordId: mutation.recordId ?? (0, import_core13.generateUUIDv7)(),
         data: mutation.data ?? {},
         previousData: null,
         sequenceNumber,
@@ -3957,14 +4120,14 @@ async function buildRouteOperation(store, mutation, currentOverride, clockOverri
     const atomicOps = {};
     for (const key of Object.keys(rawData)) {
       const value = rawData[key];
-      if ((0, import_core12.isAtomicOp)(value)) {
-        data[key] = (0, import_core12.resolveAtomicOp)(current ? current[key] : void 0, value);
-        atomicOps[key] = (0, import_core12.toAtomicOp)(value);
+      if ((0, import_core13.isAtomicOp)(value)) {
+        data[key] = (0, import_core13.resolveAtomicOp)(current ? current[key] : void 0, value);
+        atomicOps[key] = (0, import_core13.toAtomicOp)(value);
       } else {
         data[key] = value;
       }
     }
-    return (0, import_core12.createOperation)(
+    return (0, import_core13.createOperation)(
       {
         nodeId,
         type: "update",
@@ -3980,7 +4143,7 @@ async function buildRouteOperation(store, mutation, currentOverride, clockOverri
       clock
     );
   }
-  return (0, import_core12.createOperation)(
+  return (0, import_core13.createOperation)(
     {
       nodeId,
       type: "delete",
@@ -4246,6 +4409,7 @@ var KoraSyncServer = class _KoraSyncServer {
   batchSize;
   schemaVersion;
   supportedSchemaVersions;
+  operationTransforms;
   port;
   host;
   path;
@@ -4283,16 +4447,24 @@ var KoraSyncServer = class _KoraSyncServer {
   static ORPHANED_RELAY_TTL_MS = 5 * 6e4;
   constructor(config) {
     this.store = config.store;
+    const storeSchemaVersion = this.store.getSchema()?.version;
+    if (config.schemaVersion !== void 0 && storeSchemaVersion !== void 0 && config.schemaVersion !== storeSchemaVersion) {
+      throw new import_core14.SyncError("Sync schema version does not match the configured store schema.", {
+        syncSchemaVersion: config.schemaVersion,
+        storeSchemaVersion
+      });
+    }
     this.auth = config.auth ?? null;
     this.serializer = config.serializer ?? new import_sync5.JsonMessageSerializer();
     this.emitter = config.emitter ?? null;
     this.maxConnections = config.maxConnections ?? DEFAULT_MAX_CONNECTIONS;
     this.batchSize = config.batchSize ?? DEFAULT_BATCH_SIZE2;
-    this.schemaVersion = config.schemaVersion ?? DEFAULT_SCHEMA_VERSION2;
+    this.schemaVersion = config.schemaVersion ?? storeSchemaVersion ?? DEFAULT_SCHEMA_VERSION2;
     this.supportedSchemaVersions = config.supportedSchemaVersions ?? {
       min: this.schemaVersion,
       max: this.schemaVersion
     };
+    this.operationTransforms = config.operationTransforms ?? [];
     this.port = config.port;
     this.host = config.host ?? DEFAULT_HOST;
     this.path = config.path ?? DEFAULT_PATH;
@@ -4416,6 +4588,21 @@ var KoraSyncServer = class _KoraSyncServer {
         details: { reason: event.reason }
       });
     });
+    sessionEmitter.on("sync:schema-mismatch", (event) => {
+      this.logger.log({
+        timestamp: Date.now(),
+        level: "warn",
+        event: "session.schema_mismatch",
+        sessionId,
+        details: {
+          clientSchemaVersion: event.clientSchemaVersion,
+          serverSchemaVersion: event.serverSchemaVersion,
+          supportedMin: event.supportedMin,
+          supportedMax: event.supportedMax,
+          reason: event.reason
+        }
+      });
+    });
   }
   /**
    * Get the metrics collector for external access (e.g., HTTP endpoints).
@@ -4436,10 +4623,10 @@ var KoraSyncServer = class _KoraSyncServer {
    */
   async start(wsServerImpl) {
     if (this.running) {
-      throw new import_core13.SyncError("Server is already running", { port: this.port });
+      throw new import_core14.SyncError("Server is already running", { port: this.port });
     }
     if (!wsServerImpl && this.port === void 0) {
-      throw new import_core13.SyncError(
+      throw new import_core14.SyncError(
         "Port is required for standalone mode. Provide port in config or use handleConnection() for attach mode.",
         {}
       );
@@ -4554,7 +4741,7 @@ var KoraSyncServer = class _KoraSyncServer {
     if (this.maxConnections > 0 && this.sessions.size >= this.maxConnections) {
       transport.send({
         type: "error",
-        messageId: (0, import_core13.generateUUIDv7)(),
+        messageId: (0, import_core14.generateUUIDv7)(),
         code: "MAX_CONNECTIONS",
         message: `Server has reached maximum connections (${this.maxConnections})`,
         retriable: true
@@ -4567,12 +4754,12 @@ var KoraSyncServer = class _KoraSyncServer {
         event: "connection.rejected",
         details: { reason: "max_connections", max: this.maxConnections }
       });
-      throw new import_core13.SyncError("Maximum connections reached", {
+      throw new import_core14.SyncError("Maximum connections reached", {
         current: this.sessions.size,
         max: this.maxConnections
       });
     }
-    const sessionId = (0, import_core13.generateUUIDv7)();
+    const sessionId = (0, import_core14.generateUUIDv7)();
     this.metrics.recordConnection(sessionId);
     const sessionEmitter = new import_internal2.SimpleEventEmitter();
     sessionEmitter.on("sync:connected", (event) => {
@@ -4618,6 +4805,33 @@ var KoraSyncServer = class _KoraSyncServer {
         sessionId
       });
     });
+    sessionEmitter.on("sync:schema-mismatch", (event) => {
+      this.logger.log({
+        timestamp: Date.now(),
+        level: "warn",
+        event: "session.schema_mismatch",
+        sessionId,
+        details: {
+          clientSchemaVersion: event.clientSchemaVersion,
+          serverSchemaVersion: event.serverSchemaVersion,
+          supportedMin: event.supportedMin,
+          supportedMax: event.supportedMax,
+          reason: event.reason
+        }
+      });
+    });
+    sessionEmitter.on("sync:delivery-stalled", (event) => {
+      this.logger.log({
+        timestamp: Date.now(),
+        level: "warn",
+        event: "session.delivery_stalled",
+        sessionId,
+        details: {
+          watermark: event.watermark,
+          repeatCount: event.repeatCount
+        }
+      });
+    });
     const session = new ClientSession({
       sessionId,
       transport,
@@ -4629,6 +4843,7 @@ var KoraSyncServer = class _KoraSyncServer {
       batchSize: this.batchSize,
       schemaVersion: this.schemaVersion,
       supportedSchemaVersions: this.supportedSchemaVersions,
+      operationTransforms: this.operationTransforms,
       onRelay: (sourceSessionId, operations2) => {
         this.handleRelay(sourceSessionId, operations2);
       },
@@ -4756,7 +4971,7 @@ var KoraSyncServer = class _KoraSyncServer {
       const records = await this.store.materializeCollection(name);
       for (const record of records) {
         for (const value of Object.values(record)) {
-          if ((0, import_core13.isBlobRef)(value)) {
+          if ((0, import_core14.isBlobRef)(value)) {
             refs.push(value);
           }
         }