@korajs/server 1.0.0-beta.1 → 1.0.0-beta.4

package/dist/index.js

@@ -54,11 +54,17 @@ function createDefaultLogger() {
   }
 }
 
+// src/apply/rejection-taxonomy.ts
+var RETRIABLE_REJECTION_CODES = /* @__PURE__ */ new Set(["RATE_LIMIT"]);
+function isRetriableRejection(code) {
+  return RETRIABLE_REJECTION_CODES.has(code);
+}
+
 // src/store/memory-server-store.ts
 import { generateUUIDv7 } from "@korajs/core";
 
 // src/store/materialization.ts
-import { StorageError } from "@korajs/core";
+import { StorageError, quoteIdent } from "@korajs/core";
 function fieldTypeToSql(descriptor, dialect) {
   switch (descriptor.kind) {
     case "string":
@@ -73,6 +79,14 @@ function fieldTypeToSql(descriptor, dialect) {
       return dialect === "postgres" ? "BIGINT" : "INTEGER";
     case "array":
       return dialect === "postgres" ? "JSONB" : "TEXT";
+    case "object":
+      return dialect === "postgres" ? "JSONB" : "TEXT";
+    case "json":
+      return dialect === "postgres" ? "JSONB" : "TEXT";
+    case "blob":
+      return "TEXT";
+    case "secret":
+      return "TEXT";
     case "richtext":
       return dialect === "postgres" ? "BYTEA" : "BLOB";
   }
@@ -89,13 +103,13 @@ function generateCollectionDDL(name, collection, dialect) {
   const columns = ["id TEXT PRIMARY KEY NOT NULL"];
   for (const [fieldName, descriptor] of Object.entries(collection.fields)) {
     const sqlType = fieldTypeToSql(descriptor, dialect);
-    let colDef = `${fieldName} ${sqlType}`;
+    let colDef = `${quoteIdent(fieldName)} ${sqlType}`;
     if (descriptor.defaultValue !== void 0) {
       colDef += ` DEFAULT ${sqlDefaultLiteral(descriptor.defaultValue)}`;
     }
     if (descriptor.kind === "enum" && descriptor.enumValues) {
       const values = descriptor.enumValues.map((v) => `'${v}'`).join(", ");
-      colDef += ` CHECK (${fieldName} IN (${values}))`;
+      colDef += ` CHECK (${quoteIdent(fieldName)} IN (${values}))`;
     }
     columns.push(colDef);
   }
@@ -103,24 +117,26 @@ function generateCollectionDDL(name, collection, dialect) {
   columns.push(`_created_at ${tsType} NOT NULL DEFAULT 0`);
   columns.push(`_updated_at ${tsType} NOT NULL DEFAULT 0`);
   columns.push("_deleted INTEGER NOT NULL DEFAULT 0");
-  statements.push(`CREATE TABLE IF NOT EXISTS ${name} (
+  statements.push(`CREATE TABLE IF NOT EXISTS ${quoteIdent(name)} (
   ${columns.join(",\n  ")}
 )`);
   for (const [fieldName, descriptor] of Object.entries(collection.fields)) {
     const sqlType = fieldTypeToSql(descriptor, dialect);
-    let colDef = `${fieldName} ${sqlType}`;
+    let colDef = `${quoteIdent(fieldName)} ${sqlType}`;
     if (descriptor.defaultValue !== void 0) {
       colDef += ` DEFAULT ${sqlDefaultLiteral(descriptor.defaultValue)}`;
     }
     statements.push(`--kora:safe-alter
-ALTER TABLE ${name} ADD COLUMN ${colDef}`);
+ALTER TABLE ${quoteIdent(name)} ADD COLUMN ${colDef}`);
   }
   for (const indexField of collection.indexes) {
     statements.push(
-      `CREATE INDEX IF NOT EXISTS idx_${name}_${indexField} ON ${name} (${indexField})`
+      `CREATE INDEX IF NOT EXISTS idx_${name}_${indexField} ON ${quoteIdent(name)} (${quoteIdent(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 ${quoteIdent(name)} (_deleted)`
+  );
   return statements;
 }
 function generateAllCollectionDDL(schema, dialect) {
@@ -590,7 +606,7 @@ var MemoryServerStore = class {
 };
 
 // src/store/postgres-server-store.ts
-import { generateUUIDv7 as generateUUIDv72 } from "@korajs/core";
+import { generateUUIDv7 as generateUUIDv72, quoteIdent as quoteIdent2 } from "@korajs/core";
 import { and, asc, between, count, eq, sql } from "drizzle-orm";
 
 // src/store/drizzle-pg-schema.ts
@@ -754,7 +770,7 @@ var PostgresServerStore = class {
     this.assertCollection(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 query = sql`SELECT * FROM ${sql.raw(quoteIdent2(collection))} WHERE id = ${id} AND _deleted = 0`;
     const rows = await this.db.execute(query);
     if (rows.length === 0) return null;
     return this.deserializeRow(rows[0], collectionDef);
@@ -771,7 +787,7 @@ var PostgresServerStore = class {
       }
     }
     const whereClause = this.buildWhereClause(where ?? {}, false);
-    const query = sql`SELECT COUNT(*) as cnt FROM ${sql.raw(collection)} WHERE ${whereClause}`;
+    const query = sql`SELECT COUNT(*) as cnt FROM ${sql.raw(quoteIdent2(collection))} WHERE ${whereClause}`;
     const rows = await this.db.execute(query);
     const cnt = rows[0]?.cnt;
     return typeof cnt === "string" ? Number.parseInt(cnt, 10) : cnt ?? 0;
@@ -858,7 +874,7 @@ var PostgresServerStore = class {
       );
     } else {
       await txOrDb.execute(
-        sql`UPDATE ${sql.raw(collection)} SET _deleted = 1, _updated_at = ${Date.now()} WHERE id = ${recordId}`
+        sql`UPDATE ${sql.raw(quoteIdent2(collection))} SET _deleted = 1, _updated_at = ${Date.now()} WHERE id = ${recordId}`
       );
     }
   }
@@ -877,16 +893,16 @@ var PostgresServerStore = class {
       updatedAt,
       0
     ];
-    const columnsSql = sql.raw(allColumns.join(", "));
+    const columnsSql = sql.raw(allColumns.map((c) => quoteIdent2(c)).join(", "));
     const valuesSql = sql.join(
       values.map((v) => sql`${v}`),
       sql.raw(", ")
     );
     const updateSet = sql.raw(
-      allColumns.slice(1).map((c) => `${c} = excluded.${c}`).join(", ")
+      allColumns.slice(1).map((c) => `${quoteIdent2(c)} = excluded.${quoteIdent2(c)}`).join(", ")
     );
     await txOrDb.execute(
-      sql`INSERT INTO ${sql.raw(tableName)} (${columnsSql}) VALUES (${valuesSql}) ON CONFLICT (id) DO UPDATE SET ${updateSet}`
+      sql`INSERT INTO ${sql.raw(quoteIdent2(tableName))} (${columnsSql}) VALUES (${valuesSql}) ON CONFLICT (id) DO UPDATE SET ${updateSet}`
     );
   }
   /**
@@ -946,7 +962,7 @@ var PostgresServerStore = class {
         );
       } else {
         await this.db.execute(
-          sql`INSERT INTO ${sql.raw(collectionName)} (id, _deleted, _created_at, _updated_at) VALUES (${recordId}, 1, ${Date.now()}, ${Date.now()}) ON CONFLICT (id) DO UPDATE SET _deleted = 1, _updated_at = ${Date.now()}`
+          sql`INSERT INTO ${sql.raw(quoteIdent2(collectionName))} (id, _deleted, _created_at, _updated_at) VALUES (${recordId}, 1, ${Date.now()}, ${Date.now()}) ON CONFLICT (id) DO UPDATE SET _deleted = 1, _updated_at = ${Date.now()}`
         );
       }
     }
@@ -959,10 +975,12 @@ 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(quoteIdent2(collection))} WHERE ${whereClause}`
+    ];
     if (options?.orderBy) {
       const dir = options.orderDirection === "desc" ? "DESC" : "ASC";
-      parts.push(sql.raw(` ORDER BY ${options.orderBy} ${dir}`));
+      parts.push(sql.raw(` ORDER BY ${quoteIdent2(options.orderBy)} ${dir}`));
     }
     if (options?.limit !== void 0) {
       parts.push(sql` LIMIT ${options.limit}`);
@@ -978,7 +996,7 @@ var PostgresServerStore = class {
       conditions.push(sql.raw("_deleted = 0"));
     }
     for (const [key, value] of Object.entries(where)) {
-      conditions.push(sql`${sql.raw(key)} = ${value}`);
+      conditions.push(sql`${sql.raw(quoteIdent2(key))} = ${value}`);
     }
     if (conditions.length === 0) {
       return sql.raw("1 = 1");
@@ -1173,7 +1191,7 @@ async function loadPostgresDeps() {
 
 // src/store/sqlite-server-store.ts
 import { createRequire } from "module";
-import { generateUUIDv7 as generateUUIDv73 } from "@korajs/core";
+import { generateUUIDv7 as generateUUIDv73, quoteIdent as quoteIdent3 } from "@korajs/core";
 import { and as and2, asc as asc2, between as between2, count as count2, eq as eq2, sql as sql2 } from "drizzle-orm";
 
 // src/store/drizzle-schema.ts
@@ -1328,7 +1346,7 @@ var SqliteServerStore = class {
     this.assertCollection(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 query = sql2`SELECT * FROM ${sql2.raw(quoteIdent3(collection))} WHERE id = ${id} AND _deleted = 0`;
     const rows = this.db.all(query);
     if (rows.length === 0) return null;
     return this.deserializeRow(rows[0], collectionDef);
@@ -1344,7 +1362,7 @@ var SqliteServerStore = class {
       }
     }
     const whereClause = this.buildWhereClause(where ?? {}, false);
-    const query = sql2`SELECT COUNT(*) as cnt FROM ${sql2.raw(collection)} WHERE ${whereClause}`;
+    const query = sql2`SELECT COUNT(*) as cnt FROM ${sql2.raw(quoteIdent3(collection))} WHERE ${whereClause}`;
     const rows = this.db.all(query);
     return rows[0]?.cnt ?? 0;
   }
@@ -1421,7 +1439,7 @@ var SqliteServerStore = class {
       );
     } else {
       txOrDb.run(
-        sql2`UPDATE ${sql2.raw(collection)} SET _deleted = 1, _updated_at = ${Date.now()} WHERE id = ${recordId}`
+        sql2`UPDATE ${sql2.raw(quoteIdent3(collection))} SET _deleted = 1, _updated_at = ${Date.now()} WHERE id = ${recordId}`
       );
     }
   }
@@ -1442,16 +1460,16 @@ var SqliteServerStore = class {
       0
       // _deleted = false
     ];
-    const columnsSql = sql2.raw(allColumns.join(", "));
+    const columnsSql = sql2.raw(allColumns.map((c) => quoteIdent3(c)).join(", "));
     const valuesSql = sql2.join(
       values.map((v) => sql2`${v}`),
       sql2.raw(", ")
     );
     const updateSet = sql2.raw(
-      allColumns.slice(1).map((c) => `${c} = excluded.${c}`).join(", ")
+      allColumns.slice(1).map((c) => `${quoteIdent3(c)} = excluded.${quoteIdent3(c)}`).join(", ")
     );
     txOrDb.run(
-      sql2`INSERT INTO ${sql2.raw(tableName)} (${columnsSql}) VALUES (${valuesSql}) ON CONFLICT (id) DO UPDATE SET ${updateSet}`
+      sql2`INSERT INTO ${sql2.raw(quoteIdent3(tableName))} (${columnsSql}) VALUES (${valuesSql}) ON CONFLICT (id) DO UPDATE SET ${updateSet}`
     );
   }
   /**
@@ -1509,7 +1527,7 @@ var SqliteServerStore = class {
           );
         } else {
           tx.run(
-            sql2`INSERT INTO ${sql2.raw(collectionName)} (id, _deleted, _created_at, _updated_at) VALUES (${recordId}, 1, ${Date.now()}, ${Date.now()}) ON CONFLICT (id) DO UPDATE SET _deleted = 1, _updated_at = ${Date.now()}`
+            sql2`INSERT INTO ${sql2.raw(quoteIdent3(collectionName))} (id, _deleted, _created_at, _updated_at) VALUES (${recordId}, 1, ${Date.now()}, ${Date.now()}) ON CONFLICT (id) DO UPDATE SET _deleted = 1, _updated_at = ${Date.now()}`
           );
         }
       }
@@ -1523,10 +1541,12 @@ 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(quoteIdent3(collection))} WHERE ${whereClause}`
+    ];
     if (options?.orderBy) {
       const dir = options.orderDirection === "desc" ? "DESC" : "ASC";
-      parts.push(sql2.raw(` ORDER BY ${options.orderBy} ${dir}`));
+      parts.push(sql2.raw(` ORDER BY ${quoteIdent3(options.orderBy)} ${dir}`));
     }
     if (options?.limit !== void 0) {
       parts.push(sql2` LIMIT ${options.limit}`);
@@ -1542,7 +1562,7 @@ var SqliteServerStore = class {
       conditions.push(sql2.raw("_deleted = 0"));
     }
     for (const [key, value] of Object.entries(where)) {
-      conditions.push(sql2`${sql2.raw(key)} = ${value}`);
+      conditions.push(sql2`${sql2.raw(quoteIdent3(key))} = ${value}`);
     }
     if (conditions.length === 0) {
       return sql2.raw("1 = 1");
@@ -1993,12 +2013,14 @@ async function applyServerOperation(store, op, relationLookup) {
   const lookup = relationLookup ?? (schema ? buildMergeRelationLookup(schema) : /* @__PURE__ */ new Map());
   const constraintCheck = await validateIncomingOperationConstraints(store, op, schema);
   if (!constraintCheck.valid) {
+    const code = constraintCheck.code ?? "CONSTRAINT_VIOLATION";
     return {
       result: "skipped",
       appliedOperations: [],
       rejection: {
-        code: constraintCheck.code ?? "CONSTRAINT_VIOLATION",
-        message: constraintCheck.message ?? `Operation "${op.id}" violates a schema constraint`
+        code,
+        message: constraintCheck.message ?? `Operation "${op.id}" violates a schema constraint`,
+        retriable: isRetriableRejection(code)
       }
     };
   }
@@ -2011,7 +2033,8 @@ async function applyServerOperation(store, op, relationLookup) {
         appliedOperations: [],
         rejection: {
           code: "REFERENTIAL_INTEGRITY",
-          message: `Operation "${op.id}" violates referential integrity on "${op.collection}"`
+          message: `Operation "${op.id}" violates referential integrity on "${op.collection}"`,
+          retriable: isRetriableRejection("REFERENTIAL_INTEGRITY")
         }
       };
     }
@@ -2220,6 +2243,8 @@ var ClientSession = class {
   maxOperationBytes;
   maxOpsPerMinute;
   rateLimiter;
+  validateOperation;
+  koraContext;
   constructor(options) {
     this.sessionId = options.sessionId;
     this.transport = options.transport;
@@ -2244,6 +2269,8 @@ var ClientSession = class {
     this.maxOperationBytes = options.maxOperationBytes ?? DEFAULT_MAX_OPERATION_BYTES;
     this.maxOpsPerMinute = options.maxOpsPerMinute ?? DEFAULT_MAX_OPS_PER_MINUTE;
     this.rateLimiter = new SessionRateLimiter(this.maxOpsPerMinute);
+    this.validateOperation = options.validateOperation ?? null;
+    this.koraContext = options.koraContext ?? null;
   }
   /**
    * Start handling messages from the client transport.
@@ -2490,10 +2517,39 @@ var ClientSession = class {
         );
         continue;
       }
+      if (this.validateOperation && this.koraContext) {
+        let decision;
+        try {
+          decision = await this.validateOperation(op, {
+            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);
+          continue;
+        }
+        if (decision.action === "reject") {
+          this.sendOperationRejected(
+            op,
+            decision.code,
+            decision.message,
+            decision.retriable ?? isRetriableRejection(decision.code)
+          );
+          continue;
+        }
+        if (decision.action === "ignore") {
+          continue;
+        }
+      }
       try {
         const applyResult = await applyServerOperation(this.store, op);
         if (applyResult.rejection) {
-          this.sendError(applyResult.rejection.code, applyResult.rejection.message, false);
+          this.sendError(
+            applyResult.rejection.code,
+            applyResult.rejection.message,
+            applyResult.rejection.retriable
+          );
           continue;
         }
         if (applyResult.result === "applied") {
@@ -2612,6 +2668,25 @@ var ClientSession = class {
     };
     this.sendToClient(errorMsg);
   }
+  /**
+   * Reject one specific client operation, tied to its id, so the submitter can
+   * divert it out of its pending queue into a durable rejected store rather than
+   * losing it or retrying forever. The op is NOT materialized, so no other
+   * replica ever sees it.
+   */
+  sendOperationRejected(op, code, message, retriable) {
+    const rejectedMsg = {
+      type: "operation-rejected",
+      messageId: generateUUIDv74(),
+      operationId: op.id,
+      collection: op.collection,
+      recordId: op.recordId,
+      code,
+      message,
+      retriable
+    };
+    this.sendToClient(rejectedMsg);
+  }
   setSerializerWireFormat(format) {
     if (typeof this.serializer.setWireFormat === "function") {
       this.serializer.setWireFormat(format);
@@ -2632,7 +2707,7 @@ function selectWireFormat(supportedWireFormats) {
 }
 
 // src/server/kora-sync-server.ts
-import { SyncError as SyncError4, generateUUIDv7 as generateUUIDv76, isBlobRef } from "@korajs/core";
+import { SyncError as SyncError4, generateUUIDv7 as generateUUIDv77, isBlobRef } from "@korajs/core";
 import { SimpleEventEmitter } from "@korajs/core/internal";
 import { JsonMessageSerializer as JsonMessageSerializer2 } from "@korajs/sync";
 
@@ -2992,6 +3067,316 @@ var YjsDocRelay = class {
   }
 };
 
+// src/server/route-context.ts
+import {
+  HybridLogicalClock as HybridLogicalClock2,
+  createOperation as createOperation2,
+  generateUUIDv7 as generateUUIDv76,
+  isAtomicOp,
+  resolveAtomicOp,
+  toAtomicOp
+} from "@korajs/core";
+
+// src/apply/route-predicate.ts
+function evaluateField(actual, operators) {
+  if ("$eq" in operators && !Object.is(actual, operators.$eq)) {
+    return false;
+  }
+  if ("$ne" in operators && Object.is(actual, operators.$ne)) {
+    return false;
+  }
+  if (operators.$in !== void 0 && !operators.$in.some((candidate) => Object.is(actual, candidate))) {
+    return false;
+  }
+  const numericChecks = [
+    ["$lt", (a, b) => a < b],
+    ["$lte", (a, b) => a <= b],
+    ["$gt", (a, b) => a > b],
+    ["$gte", (a, b) => a >= b]
+  ];
+  for (const [operator, compare] of numericChecks) {
+    const bound = operators[operator];
+    if (bound === void 0) {
+      continue;
+    }
+    if (typeof actual !== "number" || typeof bound !== "number") {
+      return false;
+    }
+    if (!compare(actual, bound)) {
+      return false;
+    }
+  }
+  return true;
+}
+function evaluateRoutePredicate(record, predicate) {
+  const fields = Object.keys(predicate);
+  if (fields.length === 0) {
+    return true;
+  }
+  if (record === null) {
+    return false;
+  }
+  for (const field of fields) {
+    const operators = predicate[field];
+    if (operators && !evaluateField(record[field], operators)) {
+      return false;
+    }
+  }
+  return true;
+}
+
+// src/server/route-context.ts
+function recordMatchesScope(collection, record, scope) {
+  const collectionScope = scope[collection];
+  if (!collectionScope) {
+    return false;
+  }
+  for (const [field, expected] of Object.entries(collectionScope)) {
+    if (record[field] !== expected) {
+      return false;
+    }
+  }
+  return true;
+}
+function pickFields(record, keys) {
+  const picked = {};
+  for (const key of keys) {
+    if (key in record) {
+      picked[key] = record[key];
+    }
+  }
+  return picked;
+}
+async function buildRouteOperation(store, mutation) {
+  const nodeId = store.getNodeId();
+  const clock = new HybridLogicalClock2(nodeId);
+  const schemaVersion = store.getSchema()?.version ?? 1;
+  const sequenceNumber = nextServerSequenceNumber(store);
+  if (mutation.type === "insert") {
+    return createOperation2(
+      {
+        nodeId,
+        type: "insert",
+        collection: mutation.collection,
+        recordId: mutation.recordId ?? generateUUIDv76(),
+        data: mutation.data ?? {},
+        previousData: null,
+        sequenceNumber,
+        causalDeps: [],
+        schemaVersion
+      },
+      clock
+    );
+  }
+  if (!mutation.recordId) {
+    throw new RouteMutationError(
+      "MISSING_RECORD_ID",
+      `A ${mutation.type} mutation on "${mutation.collection}" requires a recordId.`
+    );
+  }
+  const current = await store.findRecord(mutation.collection, mutation.recordId);
+  if (mutation.type === "update") {
+    const rawData = mutation.data ?? {};
+    const data = {};
+    const atomicOps = {};
+    for (const key of Object.keys(rawData)) {
+      const value = rawData[key];
+      if (isAtomicOp(value)) {
+        data[key] = resolveAtomicOp(current ? current[key] : void 0, value);
+        atomicOps[key] = toAtomicOp(value);
+      } else {
+        data[key] = value;
+      }
+    }
+    return createOperation2(
+      {
+        nodeId,
+        type: "update",
+        collection: mutation.collection,
+        recordId: mutation.recordId,
+        data,
+        previousData: current ? pickFields(current, Object.keys(rawData)) : {},
+        sequenceNumber,
+        causalDeps: [],
+        schemaVersion,
+        ...Object.keys(atomicOps).length > 0 ? { atomicOps } : {}
+      },
+      clock
+    );
+  }
+  return createOperation2(
+    {
+      nodeId,
+      type: "delete",
+      collection: mutation.collection,
+      recordId: mutation.recordId,
+      data: null,
+      previousData: current ? { ...current } : null,
+      sequenceNumber,
+      causalDeps: [],
+      schemaVersion
+    },
+    clock
+  );
+}
+var RouteMutationError = class extends Error {
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+    this.name = "RouteMutationError";
+  }
+  code;
+};
+function createRouteContext(server, store) {
+  let mutationTail = Promise.resolve();
+  function serialize(work) {
+    const run = mutationTail.then(work, work);
+    mutationTail = run.then(
+      () => void 0,
+      () => void 0
+    );
+    return run;
+  }
+  async function prepareMutation(mutation, scope) {
+    let op;
+    try {
+      op = await buildRouteOperation(store, mutation);
+    } catch (error) {
+      if (error instanceof RouteMutationError) {
+        return {
+          ok: false,
+          rejection: {
+            ok: false,
+            code: error.code,
+            message: error.message,
+            retriable: isRetriableRejection(error.code)
+          }
+        };
+      }
+      throw error;
+    }
+    if (scope && !operationMatchesScopes(op, scope)) {
+      return {
+        ok: false,
+        rejection: {
+          ok: false,
+          code: "SCOPE_VIOLATION",
+          message: `Mutation on "${mutation.collection}" is outside the provided scope.`,
+          retriable: isRetriableRejection("SCOPE_VIOLATION")
+        }
+      };
+    }
+    return { ok: true, op };
+  }
+  async function commitOperation(op, collection) {
+    const result = await server.applyLocalOperation(op);
+    if (result.result !== "applied") {
+      const code = result.rejection?.code ?? "NOT_APPLIED";
+      return {
+        ok: false,
+        code,
+        message: result.rejection?.message ?? `Operation on "${collection}" was not applied (${result.result}).`,
+        // Prefer the pipeline's own classification when present; fall back
+        // to classifying the code so this stays correct if new codes appear.
+        retriable: result.rejection?.retriable ?? isRetriableRejection(code)
+      };
+    }
+    const record = await store.findRecord(collection, op.recordId);
+    return { ok: true, operation: op, record };
+  }
+  async function rawApply(mutation, scope) {
+    const prepared = await prepareMutation(mutation, scope);
+    if (!prepared.ok) {
+      return prepared.rejection;
+    }
+    return commitOperation(prepared.op, mutation.collection);
+  }
+  return {
+    apply(mutation, options) {
+      return serialize(() => rawApply(mutation, options?.scope));
+    },
+    applyConditional(spec, options) {
+      return serialize(async () => {
+        if (spec.idempotencyKey) {
+          const existing = await store.findRecord(
+            spec.idempotencyKey.collection,
+            spec.idempotencyKey.id
+          );
+          if (existing) {
+            return { ok: true, idempotent: true, operations: [], records: [existing] };
+          }
+        }
+        if (spec.if && Object.keys(spec.if).length > 0) {
+          const target = await store.findRecord(spec.collection, spec.id);
+          if (!evaluateRoutePredicate(target, spec.if)) {
+            const code = spec.reject?.code ?? "CONDITION_NOT_MET";
+            return {
+              ok: false,
+              code,
+              message: spec.reject?.message ?? `Admission condition not met on "${spec.collection}" record "${spec.id}".`,
+              retriable: false
+            };
+          }
+        }
+        const mutations = [];
+        if (spec.update !== void 0 && spec.update !== null) {
+          mutations.push({
+            collection: spec.collection,
+            type: "update",
+            recordId: spec.id,
+            data: spec.update
+          });
+        }
+        if (spec.also) {
+          mutations.push(...spec.also);
+        }
+        const prepared = [];
+        for (const mutation of mutations) {
+          const p = await prepareMutation(mutation, options?.scope);
+          if (!p.ok) {
+            return p.rejection;
+          }
+          prepared.push({ op: p.op, collection: mutation.collection });
+        }
+        const operations2 = [];
+        const records = [];
+        for (const { op, collection } of prepared) {
+          const result = await commitOperation(op, collection);
+          if (!result.ok) {
+            return {
+              ok: false,
+              code: result.code,
+              message: result.message,
+              retriable: result.retriable
+            };
+          }
+          operations2.push(result.operation);
+          records.push(result.record);
+        }
+        return { ok: true, idempotent: false, operations: operations2, records };
+      });
+    },
+    async query(collection, options) {
+      const { scope, ...queryOptions } = options ?? {};
+      const records = await store.queryCollection(collection, queryOptions);
+      if (!scope) {
+        return records;
+      }
+      return records.filter((record) => recordMatchesScope(collection, record, scope));
+    },
+    async findById(collection, id, options) {
+      const record = await store.findRecord(collection, id);
+      if (!record) {
+        return null;
+      }
+      if (options?.scope && !recordMatchesScope(collection, record, options.scope)) {
+        return null;
+      }
+      return record;
+    }
+  };
+}
+
 // src/server/kora-sync-server.ts
 var DEFAULT_MAX_CONNECTIONS = 0;
 var DEFAULT_BATCH_SIZE2 = 100;
@@ -3016,10 +3401,16 @@ var KoraSyncServer = class {
   yjsDocRelay = new YjsDocRelay();
   blobChunkRelay;
   persistBlobChunk;
+  maxOperationBytes;
+  maxOpsPerMinute;
+  validateOperation;
+  koraContext;
   sessions = /* @__PURE__ */ new Map();
   httpClients = /* @__PURE__ */ new Map();
   httpSessionToClient = /* @__PURE__ */ new Map();
-  serverVersion = "0.4.0";
+  // Informational value reported by getStatus(). Keep in sync with the
+  // @korajs/server package version on release; it is not used for protocol negotiation.
+  serverVersion = "1.0.0-beta.0";
   wsServer = null;
   running = false;
   constructor(config) {
@@ -3042,10 +3433,22 @@ var KoraSyncServer = class {
     this.metrics.setSchemaVersion(this.schemaVersion);
     this.blobChunkRelay = new BlobChunkRelay(config.resolveBlobChunk);
     this.persistBlobChunk = config.persistBlobChunk ?? null;
+    this.maxOperationBytes = config.maxOperationBytes;
+    this.maxOpsPerMinute = config.maxOpsPerMinute;
+    this.validateOperation = config.validateOperation;
+    this.koraContext = createRouteContext(this, this.store);
     if (!this.emitter) {
       this.emitter = new SimpleEventEmitter();
     }
   }
+  /**
+   * The trusted, scoped data-plane context (`apply` / `query` / `findById`).
+   * Shared with the production server so HTTP routes, the operation validator,
+   * and `server.kora` are all the same object over the same pipeline.
+   */
+  getKoraContext() {
+    return this.koraContext;
+  }
   /**
    * Subscribe to session-level events for metrics collection and logging.
    * Called when a new session is created.
@@ -3227,7 +3630,7 @@ var KoraSyncServer = class {
     if (this.maxConnections > 0 && this.sessions.size >= this.maxConnections) {
       transport.send({
         type: "error",
-        messageId: generateUUIDv76(),
+        messageId: generateUUIDv77(),
         code: "MAX_CONNECTIONS",
         message: `Server has reached maximum connections (${this.maxConnections})`,
         retriable: true
@@ -3245,7 +3648,7 @@ var KoraSyncServer = class {
         max: this.maxConnections
       });
     }
-    const sessionId = generateUUIDv76();
+    const sessionId = generateUUIDv77();
     this.metrics.recordConnection(sessionId);
     const sessionEmitter = new SimpleEventEmitter();
     sessionEmitter.on("sync:connected", (event) => {
@@ -3317,6 +3720,11 @@ var KoraSyncServer = class {
         this.blobChunkRelay.handleResponse(sourceSessionId, message);
       },
       ...this.persistBlobChunk ? { persistBlobChunk: this.persistBlobChunk } : {},
+      // Only forward when configured, so an unset server value leaves the
+      // session on its own documented default rather than `undefined`.
+      ...this.maxOperationBytes !== void 0 ? { maxOperationBytes: this.maxOperationBytes } : {},
+      ...this.maxOpsPerMinute !== void 0 ? { maxOpsPerMinute: this.maxOpsPerMinute } : {},
+      ...this.validateOperation ? { validateOperation: this.validateOperation, koraContext: this.koraContext } : {},
       onClose: (sid) => {
         this.handleSessionClose(sid);
       }
@@ -3577,159 +3985,6 @@ function createKoraServer(config) {
   return new KoraSyncServer(config);
 }
 
-// src/server/route-context.ts
-import { HybridLogicalClock as HybridLogicalClock2, createOperation as createOperation2, generateUUIDv7 as generateUUIDv77 } from "@korajs/core";
-function recordMatchesScope(collection, record, scope) {
-  const collectionScope = scope[collection];
-  if (!collectionScope) {
-    return false;
-  }
-  for (const [field, expected] of Object.entries(collectionScope)) {
-    if (record[field] !== expected) {
-      return false;
-    }
-  }
-  return true;
-}
-function pickFields(record, keys) {
-  const picked = {};
-  for (const key of keys) {
-    if (key in record) {
-      picked[key] = record[key];
-    }
-  }
-  return picked;
-}
-async function buildRouteOperation(store, mutation) {
-  const nodeId = store.getNodeId();
-  const clock = new HybridLogicalClock2(nodeId);
-  const schemaVersion = store.getSchema()?.version ?? 1;
-  const sequenceNumber = nextServerSequenceNumber(store);
-  if (mutation.type === "insert") {
-    return createOperation2(
-      {
-        nodeId,
-        type: "insert",
-        collection: mutation.collection,
-        recordId: mutation.recordId ?? generateUUIDv77(),
-        data: mutation.data ?? {},
-        previousData: null,
-        sequenceNumber,
-        causalDeps: [],
-        schemaVersion
-      },
-      clock
-    );
-  }
-  if (!mutation.recordId) {
-    throw new RouteMutationError(
-      "MISSING_RECORD_ID",
-      `A ${mutation.type} mutation on "${mutation.collection}" requires a recordId.`
-    );
-  }
-  const current = await store.findRecord(mutation.collection, mutation.recordId);
-  if (mutation.type === "update") {
-    const data = mutation.data ?? {};
-    return createOperation2(
-      {
-        nodeId,
-        type: "update",
-        collection: mutation.collection,
-        recordId: mutation.recordId,
-        data,
-        previousData: current ? pickFields(current, Object.keys(data)) : {},
-        sequenceNumber,
-        causalDeps: [],
-        schemaVersion
-      },
-      clock
-    );
-  }
-  return createOperation2(
-    {
-      nodeId,
-      type: "delete",
-      collection: mutation.collection,
-      recordId: mutation.recordId,
-      data: null,
-      previousData: current ? { ...current } : null,
-      sequenceNumber,
-      causalDeps: [],
-      schemaVersion
-    },
-    clock
-  );
-}
-var RouteMutationError = class extends Error {
-  constructor(code, message) {
-    super(message);
-    this.code = code;
-    this.name = "RouteMutationError";
-  }
-  code;
-};
-function createRouteContext(server, store) {
-  let mutationTail = Promise.resolve();
-  function serialize(work) {
-    const run = mutationTail.then(work, work);
-    mutationTail = run.then(
-      () => void 0,
-      () => void 0
-    );
-    return run;
-  }
-  return {
-    apply(mutation, options) {
-      return serialize(async () => {
-        let op;
-        try {
-          op = await buildRouteOperation(store, mutation);
-        } catch (error) {
-          if (error instanceof RouteMutationError) {
-            return { ok: false, code: error.code, message: error.message };
-          }
-          throw error;
-        }
-        if (options?.scope && !operationMatchesScopes(op, options.scope)) {
-          return {
-            ok: false,
-            code: "SCOPE_VIOLATION",
-            message: `Mutation on "${mutation.collection}" is outside the provided scope.`
-          };
-        }
-        const result = await server.applyLocalOperation(op);
-        if (result.result !== "applied") {
-          return {
-            ok: false,
-            code: result.rejection?.code ?? "NOT_APPLIED",
-            message: result.rejection?.message ?? `Operation on "${mutation.collection}" was not applied (${result.result}).`
-          };
-        }
-        const record = await store.findRecord(mutation.collection, op.recordId);
-        return { ok: true, operation: op, record };
-      });
-    },
-    async query(collection, options) {
-      const { scope, ...queryOptions } = options ?? {};
-      const records = await store.queryCollection(collection, queryOptions);
-      if (!scope) {
-        return records;
-      }
-      return records.filter((record) => recordMatchesScope(collection, record, scope));
-    },
-    async findById(collection, id, options) {
-      const record = await store.findRecord(collection, id);
-      if (!record) {
-        return null;
-      }
-      if (options?.scope && !recordMatchesScope(collection, record, options.scope)) {
-        return null;
-      }
-      return record;
-    }
-  };
-}
-
 // src/server/production-server.ts
 var MIME_TYPES = {
   ".html": "text/html",
@@ -3754,7 +4009,7 @@ function createProductionServer(config) {
     enableDashboard: true,
     ...config.syncOptions
   });
-  const routeContext = createRouteContext(syncServer, config.store);
+  const routeContext = syncServer.getKoraContext();
   let httpServer = null;
   function getOperationalToken(kind) {
     const auth = config.operationalAuth;
@@ -3894,6 +4149,10 @@ function createProductionServer(config) {
     res.end(JSON.stringify(result.body ?? null));
   }
   return {
+    kora: routeContext,
+    getLiveBlobRefs() {
+      return syncServer.getLiveBlobRefs();
+    },
     async start() {
       const { createServer } = await import("http");
       const { createReadStream, existsSync, statSync } = await import("fs");
@@ -4192,6 +4451,7 @@ export {
   MixedAuthProvider,
   NoAuthProvider,
   PostgresServerStore,
+  RETRIABLE_REJECTION_CODES,
   SqliteServerStore,
   TokenAuthProvider,
   WsServerTransport,
@@ -4202,6 +4462,7 @@ export {
   createPrettyLogger,
   createProductionServer,
   createSilentLogger,
-  createSqliteServerStore
+  createSqliteServerStore,
+  isRetriableRejection
 };
 //# sourceMappingURL=index.js.map