@korajs/server 1.0.0-beta.0 → 1.0.0-beta.2

package/dist/index.cjs

@@ -176,6 +176,7 @@ __export(index_exports, {
   MixedAuthProvider: () => MixedAuthProvider,
   NoAuthProvider: () => NoAuthProvider,
   PostgresServerStore: () => PostgresServerStore,
+  RETRIABLE_REJECTION_CODES: () => RETRIABLE_REJECTION_CODES,
   SqliteServerStore: () => SqliteServerStore,
   TokenAuthProvider: () => TokenAuthProvider,
   WsServerTransport: () => WsServerTransport,
@@ -186,7 +187,8 @@ __export(index_exports, {
   createPrettyLogger: () => createPrettyLogger,
   createProductionServer: () => createProductionServer,
   createSilentLogger: () => createSilentLogger,
-  createSqliteServerStore: () => createSqliteServerStore
+  createSqliteServerStore: () => createSqliteServerStore,
+  isRetriableRejection: () => isRetriableRejection
 });
 module.exports = __toCommonJS(index_exports);
 init_cjs_shims();
@@ -248,6 +250,13 @@ function createDefaultLogger() {
   }
 }
 
+// src/apply/rejection-taxonomy.ts
+init_cjs_shims();
+var RETRIABLE_REJECTION_CODES = /* @__PURE__ */ new Set(["RATE_LIMIT"]);
+function isRetriableRejection(code) {
+  return RETRIABLE_REJECTION_CODES.has(code);
+}
+
 // src/store/memory-server-store.ts
 init_cjs_shims();
 var import_core2 = require("@korajs/core");
@@ -269,6 +278,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";
   }
@@ -285,13 +302,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 = `${(0, import_core.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 (${(0, import_core.quoteIdent)(fieldName)} IN (${values}))`;
     }
     columns.push(colDef);
   }
@@ -299,24 +316,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 ${(0, import_core.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 = `${(0, import_core.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 ${(0, import_core.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 ${(0, import_core.quoteIdent)(name)} (${(0, import_core.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 ${(0, import_core.quoteIdent)(name)} (_deleted)`
+  );
   return statements;
 }
 function generateAllCollectionDDL(schema, dialect) {
@@ -952,7 +971,7 @@ var PostgresServerStore = class {
     this.assertCollection(collection);
     const schema = this.schema;
     const collectionDef = schema.collections[collection];
-    const query = import_drizzle_orm.sql`SELECT * FROM ${import_drizzle_orm.sql.raw(collection)} WHERE id = ${id} AND _deleted = 0`;
+    const query = import_drizzle_orm.sql`SELECT * FROM ${import_drizzle_orm.sql.raw((0, import_core3.quoteIdent)(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);
@@ -969,7 +988,7 @@ var PostgresServerStore = class {
       }
     }
     const whereClause = this.buildWhereClause(where ?? {}, false);
-    const query = import_drizzle_orm.sql`SELECT COUNT(*) as cnt FROM ${import_drizzle_orm.sql.raw(collection)} WHERE ${whereClause}`;
+    const query = import_drizzle_orm.sql`SELECT COUNT(*) as cnt FROM ${import_drizzle_orm.sql.raw((0, import_core3.quoteIdent)(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;
@@ -1056,7 +1075,7 @@ var PostgresServerStore = class {
       );
     } else {
       await txOrDb.execute(
-        import_drizzle_orm.sql`UPDATE ${import_drizzle_orm.sql.raw(collection)} SET _deleted = 1, _updated_at = ${Date.now()} WHERE id = ${recordId}`
+        import_drizzle_orm.sql`UPDATE ${import_drizzle_orm.sql.raw((0, import_core3.quoteIdent)(collection))} SET _deleted = 1, _updated_at = ${Date.now()} WHERE id = ${recordId}`
       );
     }
   }
@@ -1075,16 +1094,16 @@ var PostgresServerStore = class {
       updatedAt,
       0
     ];
-    const columnsSql = import_drizzle_orm.sql.raw(allColumns.join(", "));
+    const columnsSql = import_drizzle_orm.sql.raw(allColumns.map((c) => (0, import_core3.quoteIdent)(c)).join(", "));
     const valuesSql = import_drizzle_orm.sql.join(
       values.map((v) => import_drizzle_orm.sql`${v}`),
       import_drizzle_orm.sql.raw(", ")
     );
     const updateSet = import_drizzle_orm.sql.raw(
-      allColumns.slice(1).map((c) => `${c} = excluded.${c}`).join(", ")
+      allColumns.slice(1).map((c) => `${(0, import_core3.quoteIdent)(c)} = excluded.${(0, import_core3.quoteIdent)(c)}`).join(", ")
     );
     await txOrDb.execute(
-      import_drizzle_orm.sql`INSERT INTO ${import_drizzle_orm.sql.raw(tableName)} (${columnsSql}) VALUES (${valuesSql}) ON CONFLICT (id) DO UPDATE SET ${updateSet}`
+      import_drizzle_orm.sql`INSERT INTO ${import_drizzle_orm.sql.raw((0, import_core3.quoteIdent)(tableName))} (${columnsSql}) VALUES (${valuesSql}) ON CONFLICT (id) DO UPDATE SET ${updateSet}`
     );
   }
   /**
@@ -1144,7 +1163,7 @@ var PostgresServerStore = class {
         );
       } else {
         await this.db.execute(
-          import_drizzle_orm.sql`INSERT INTO ${import_drizzle_orm.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()}`
+          import_drizzle_orm.sql`INSERT INTO ${import_drizzle_orm.sql.raw((0, import_core3.quoteIdent)(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()}`
         );
       }
     }
@@ -1157,10 +1176,12 @@ var PostgresServerStore = class {
       options?.where ?? {},
       options?.includeDeleted ?? false
     );
-    const parts = [import_drizzle_orm.sql`SELECT * FROM ${import_drizzle_orm.sql.raw(collection)} WHERE ${whereClause}`];
+    const parts = [
+      import_drizzle_orm.sql`SELECT * FROM ${import_drizzle_orm.sql.raw((0, import_core3.quoteIdent)(collection))} WHERE ${whereClause}`
+    ];
     if (options?.orderBy) {
       const dir = options.orderDirection === "desc" ? "DESC" : "ASC";
-      parts.push(import_drizzle_orm.sql.raw(` ORDER BY ${options.orderBy} ${dir}`));
+      parts.push(import_drizzle_orm.sql.raw(` ORDER BY ${(0, import_core3.quoteIdent)(options.orderBy)} ${dir}`));
     }
     if (options?.limit !== void 0) {
       parts.push(import_drizzle_orm.sql` LIMIT ${options.limit}`);
@@ -1176,7 +1197,7 @@ var PostgresServerStore = class {
       conditions.push(import_drizzle_orm.sql.raw("_deleted = 0"));
     }
     for (const [key, value] of Object.entries(where)) {
-      conditions.push(import_drizzle_orm.sql`${import_drizzle_orm.sql.raw(key)} = ${value}`);
+      conditions.push(import_drizzle_orm.sql`${import_drizzle_orm.sql.raw((0, import_core3.quoteIdent)(key))} = ${value}`);
     }
     if (conditions.length === 0) {
       return import_drizzle_orm.sql.raw("1 = 1");
@@ -1528,7 +1549,7 @@ var SqliteServerStore = class {
     this.assertCollection(collection);
     const schema = this.schema;
     const collectionDef = schema.collections[collection];
-    const query = import_drizzle_orm2.sql`SELECT * FROM ${import_drizzle_orm2.sql.raw(collection)} WHERE id = ${id} AND _deleted = 0`;
+    const query = import_drizzle_orm2.sql`SELECT * FROM ${import_drizzle_orm2.sql.raw((0, import_core4.quoteIdent)(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);
@@ -1544,7 +1565,7 @@ var SqliteServerStore = class {
       }
     }
     const whereClause = this.buildWhereClause(where ?? {}, false);
-    const query = import_drizzle_orm2.sql`SELECT COUNT(*) as cnt FROM ${import_drizzle_orm2.sql.raw(collection)} WHERE ${whereClause}`;
+    const query = import_drizzle_orm2.sql`SELECT COUNT(*) as cnt FROM ${import_drizzle_orm2.sql.raw((0, import_core4.quoteIdent)(collection))} WHERE ${whereClause}`;
     const rows = this.db.all(query);
     return rows[0]?.cnt ?? 0;
   }
@@ -1621,7 +1642,7 @@ var SqliteServerStore = class {
       );
     } else {
       txOrDb.run(
-        import_drizzle_orm2.sql`UPDATE ${import_drizzle_orm2.sql.raw(collection)} SET _deleted = 1, _updated_at = ${Date.now()} WHERE id = ${recordId}`
+        import_drizzle_orm2.sql`UPDATE ${import_drizzle_orm2.sql.raw((0, import_core4.quoteIdent)(collection))} SET _deleted = 1, _updated_at = ${Date.now()} WHERE id = ${recordId}`
       );
     }
   }
@@ -1642,16 +1663,16 @@ var SqliteServerStore = class {
       0
       // _deleted = false
     ];
-    const columnsSql = import_drizzle_orm2.sql.raw(allColumns.join(", "));
+    const columnsSql = import_drizzle_orm2.sql.raw(allColumns.map((c) => (0, import_core4.quoteIdent)(c)).join(", "));
     const valuesSql = import_drizzle_orm2.sql.join(
       values.map((v) => import_drizzle_orm2.sql`${v}`),
       import_drizzle_orm2.sql.raw(", ")
     );
     const updateSet = import_drizzle_orm2.sql.raw(
-      allColumns.slice(1).map((c) => `${c} = excluded.${c}`).join(", ")
+      allColumns.slice(1).map((c) => `${(0, import_core4.quoteIdent)(c)} = excluded.${(0, import_core4.quoteIdent)(c)}`).join(", ")
     );
     txOrDb.run(
-      import_drizzle_orm2.sql`INSERT INTO ${import_drizzle_orm2.sql.raw(tableName)} (${columnsSql}) VALUES (${valuesSql}) ON CONFLICT (id) DO UPDATE SET ${updateSet}`
+      import_drizzle_orm2.sql`INSERT INTO ${import_drizzle_orm2.sql.raw((0, import_core4.quoteIdent)(tableName))} (${columnsSql}) VALUES (${valuesSql}) ON CONFLICT (id) DO UPDATE SET ${updateSet}`
     );
   }
   /**
@@ -1709,7 +1730,7 @@ var SqliteServerStore = class {
           );
         } else {
           tx.run(
-            import_drizzle_orm2.sql`INSERT INTO ${import_drizzle_orm2.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()}`
+            import_drizzle_orm2.sql`INSERT INTO ${import_drizzle_orm2.sql.raw((0, import_core4.quoteIdent)(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()}`
           );
         }
       }
@@ -1723,10 +1744,12 @@ var SqliteServerStore = class {
       options?.where ?? {},
       options?.includeDeleted ?? false
     );
-    const parts = [import_drizzle_orm2.sql`SELECT * FROM ${import_drizzle_orm2.sql.raw(collection)} WHERE ${whereClause}`];
+    const parts = [
+      import_drizzle_orm2.sql`SELECT * FROM ${import_drizzle_orm2.sql.raw((0, import_core4.quoteIdent)(collection))} WHERE ${whereClause}`
+    ];
     if (options?.orderBy) {
       const dir = options.orderDirection === "desc" ? "DESC" : "ASC";
-      parts.push(import_drizzle_orm2.sql.raw(` ORDER BY ${options.orderBy} ${dir}`));
+      parts.push(import_drizzle_orm2.sql.raw(` ORDER BY ${(0, import_core4.quoteIdent)(options.orderBy)} ${dir}`));
     }
     if (options?.limit !== void 0) {
       parts.push(import_drizzle_orm2.sql` LIMIT ${options.limit}`);
@@ -1742,7 +1765,7 @@ var SqliteServerStore = class {
       conditions.push(import_drizzle_orm2.sql.raw("_deleted = 0"));
     }
     for (const [key, value] of Object.entries(where)) {
-      conditions.push(import_drizzle_orm2.sql`${import_drizzle_orm2.sql.raw(key)} = ${value}`);
+      conditions.push(import_drizzle_orm2.sql`${import_drizzle_orm2.sql.raw((0, import_core4.quoteIdent)(key))} = ${value}`);
     }
     if (conditions.length === 0) {
       return import_drizzle_orm2.sql.raw("1 = 1");
@@ -2067,6 +2090,7 @@ init_cjs_shims();
 var import_core10 = require("@korajs/core");
 var import_internal = require("@korajs/core/internal");
 var import_sync2 = require("@korajs/sync");
+var import_sync3 = require("@korajs/sync");
 
 // src/apply/apply-server-operation.ts
 init_cjs_shims();
@@ -2188,12 +2212,14 @@ async function applyServerOperation(store, op, relationLookup) {
   const lookup = relationLookup ?? (schema ? (0, import_merge2.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)
       }
     };
   }
@@ -2206,7 +2232,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")
         }
       };
     }
@@ -2239,6 +2266,14 @@ async function applyServerOperation(store, op, relationLookup) {
   };
 }
 
+// src/auth/no-auth.ts
+init_cjs_shims();
+var NoAuthProvider = class {
+  async authenticate(_token) {
+    return { userId: "anonymous" };
+  }
+};
+
 // src/scopes/resolve-session-scopes.ts
 init_cjs_shims();
 var import_core8 = require("@korajs/core");
@@ -2368,6 +2403,25 @@ var SessionRateLimiter = class {
 // src/session/client-session.ts
 var DEFAULT_BATCH_SIZE = 100;
 var DEFAULT_SCHEMA_VERSION = 1;
+var warnedUnscopedProviders = /* @__PURE__ */ new WeakSet();
+function warnIfMultiTenantWithoutScopes(auth, resolvedScopes, schema) {
+  if (!auth || auth instanceof NoAuthProvider) {
+    return;
+  }
+  if (resolvedScopes) {
+    return;
+  }
+  if (!schema || Object.keys(schema.collections).length === 0) {
+    return;
+  }
+  if (warnedUnscopedProviders.has(auth)) {
+    return;
+  }
+  warnedUnscopedProviders.add(auth);
+  console.warn(
+    "[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.)"
+  );
+}
 var ClientSession = class {
   state = "connected";
   clientNodeId = null;
@@ -2386,16 +2440,21 @@ var ClientSession = class {
   onRelay;
   onAwarenessUpdate;
   onYjsDocUpdate;
+  onBlobChunkRequest;
+  onBlobChunkResponse;
+  persistBlobChunk;
   onClose;
   maxOperationBytes;
   maxOpsPerMinute;
   rateLimiter;
+  validateOperation;
+  koraContext;
   constructor(options) {
     this.sessionId = options.sessionId;
     this.transport = options.transport;
     this.store = options.store;
     this.auth = options.auth ?? null;
-    this.serializer = options.serializer ?? new import_sync2.NegotiatedMessageSerializer("json");
+    this.serializer = options.serializer ?? new import_sync3.NegotiatedMessageSerializer("json");
     this.emitter = options.emitter ?? null;
     this.batchSize = options.batchSize ?? DEFAULT_BATCH_SIZE;
     this.schemaVersion = options.schemaVersion ?? DEFAULT_SCHEMA_VERSION;
@@ -2407,10 +2466,15 @@ var ClientSession = class {
     this.onRelay = options.onRelay ?? null;
     this.onAwarenessUpdate = options.onAwarenessUpdate ?? null;
     this.onYjsDocUpdate = options.onYjsDocUpdate ?? null;
+    this.onBlobChunkRequest = options.onBlobChunkRequest ?? null;
+    this.onBlobChunkResponse = options.onBlobChunkResponse ?? null;
+    this.persistBlobChunk = options.persistBlobChunk ?? null;
     this.onClose = options.onClose ?? null;
     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.
@@ -2512,8 +2576,33 @@ var ClientSession = class {
       case "yjs-doc-update":
         this.handleYjsDocUpdate(message);
         break;
+      case "blob-chunk-request":
+        this.onBlobChunkRequest?.(this.sessionId, message);
+        break;
+      case "blob-chunk-response":
+        this.onBlobChunkResponse?.(this.sessionId, message);
+        break;
+      case "blob-chunk-push":
+        await this.handleBlobChunkPush(message);
+        break;
     }
   }
+  /**
+   * Persist a client-uploaded blob chunk (or manifest) centrally. The bytes are
+   * verified to hash to the declared hash before storing, so a corrupt or
+   * mislabeled upload is rejected rather than served later as trusted content.
+   */
+  async handleBlobChunkPush(message) {
+    if (!this.persistBlobChunk) {
+      return;
+    }
+    const bytes = (0, import_sync2.decodeBlobChunkBytes)(message.bytes);
+    const actual = await (0, import_core10.hashBlob)(bytes);
+    if (actual !== message.hash) {
+      return;
+    }
+    await this.persistBlobChunk(message.hash, bytes);
+  }
   handleMessageFailure(error) {
     const reason = error instanceof Error ? error.message : "Message handling failed";
     this.sendError("SYNC_ERROR", reason, true);
@@ -2547,25 +2636,26 @@ var ClientSession = class {
         this.authContext = { userId: msg.nodeId, scopes: resolvedScopes };
       }
     }
+    warnIfMultiTenantWithoutScopes(this.auth, resolvedScopes, this.store.getSchema());
     if (msg.syncQueries && msg.syncQueries.length > 0) {
-      this.syncQuerySubsets = (0, import_sync2.dedupeQuerySubsets)(msg.syncQueries);
+      this.syncQuerySubsets = (0, import_sync3.dedupeQuerySubsets)(msg.syncQueries);
     } else {
       this.syncQuerySubsets = [];
     }
-    this.resumeDeltaCursor = msg.deltaCursor ? (0, import_sync2.decodeDeltaCursor)(msg.deltaCursor) : null;
+    this.resumeDeltaCursor = msg.deltaCursor ? (0, import_sync3.decodeDeltaCursor)(msg.deltaCursor) : null;
     const serverVector = this.store.getVersionVector();
     const selectedWireFormat = selectWireFormat(msg.supportedWireFormats);
     this.setSerializerWireFormat(selectedWireFormat);
-    if (!(0, import_sync2.isClientSchemaVersionSupported)(msg.schemaVersion, this.supportedSchemaVersions)) {
+    if (!(0, import_sync3.isClientSchemaVersionSupported)(msg.schemaVersion, this.supportedSchemaVersions)) {
       const { min, max } = this.supportedSchemaVersions;
       const response2 = {
         type: "handshake-response",
         messageId: (0, import_core10.generateUUIDv7)(),
         nodeId: this.store.getNodeId(),
-        versionVector: (0, import_sync2.versionVectorToWire)(serverVector),
+        versionVector: (0, import_sync3.versionVectorToWire)(serverVector),
         schemaVersion: this.schemaVersion,
         accepted: false,
-        rejectReason: `${import_sync2.SCHEMA_MISMATCH_PREFIX}: client schema version ${msg.schemaVersion} not in supported range [${min}, ${max}]`,
+        rejectReason: `${import_sync3.SCHEMA_MISMATCH_PREFIX}: client schema version ${msg.schemaVersion} not in supported range [${min}, ${max}]`,
         supportedSchemaMin: min,
         supportedSchemaMax: max,
         serverTime: Date.now()
@@ -2578,11 +2668,14 @@ var ClientSession = class {
       type: "handshake-response",
       messageId: (0, import_core10.generateUUIDv7)(),
       nodeId: this.store.getNodeId(),
-      versionVector: (0, import_sync2.versionVectorToWire)(serverVector),
+      versionVector: (0, import_sync3.versionVectorToWire)(serverVector),
       schemaVersion: this.schemaVersion,
       accepted: true,
       selectedWireFormat,
       serverTime: Date.now(),
+      // Advertise central blob storage so the client uploads the bytes behind
+      // its blob fields, keeping them available after the author goes offline.
+      ...this.persistBlobChunk ? { blobStorageEnabled: true } : {},
       // 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 } : {}
@@ -2590,7 +2683,7 @@ var ClientSession = class {
     this.sendToClient(response);
     this.emitter?.emit({ type: "sync:connected", nodeId: msg.nodeId });
     this.state = "syncing";
-    const clientVector = (0, import_sync2.wireToVersionVector)(msg.versionVector);
+    const clientVector = (0, import_sync3.wireToVersionVector)(msg.versionVector);
     await this.sendDelta(clientVector);
     this.state = "streaming";
   }
@@ -2628,10 +2721,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") {
@@ -2692,7 +2814,7 @@ var ClientSession = class {
       return;
     }
     const sorted = (0, import_internal.topologicalSort)(missing);
-    const afterCursor = (0, import_sync2.sliceOperationsAfterCursor)(sorted, this.resumeDeltaCursor);
+    const afterCursor = (0, import_sync3.sliceOperationsAfterCursor)(sorted, this.resumeDeltaCursor);
     const totalBatches = Math.ceil(afterCursor.length / this.batchSize);
     if (afterCursor.length === 0) {
       const emptyBatch = {
@@ -2710,7 +2832,7 @@ var ClientSession = class {
       const start = i * this.batchSize;
       const batchOps = afterCursor.slice(start, start + this.batchSize);
       const serializedOps = batchOps.map((op) => this.serializer.encodeOperation(op));
-      const batchCursor = (0, import_sync2.createDeltaCursorFromBatch)(batchOps, i);
+      const batchCursor = (0, import_sync3.createDeltaCursorFromBatch)(batchOps, i);
       const batchMsg = {
         type: "operation-batch",
         messageId: (0, import_core10.generateUUIDv7)(),
@@ -2718,7 +2840,7 @@ var ClientSession = class {
         isFinal: i === totalBatches - 1,
         batchIndex: i,
         totalBatches,
-        ...batchCursor ? { cursor: (0, import_sync2.encodeDeltaCursor)(batchCursor) } : {}
+        ...batchCursor ? { cursor: (0, import_sync3.encodeDeltaCursor)(batchCursor) } : {}
       };
       this.sendToClient(batchMsg);
       this.emitter?.emit({
@@ -2732,7 +2854,7 @@ var ClientSession = class {
     if (!operationMatchesScopes(op, this.authContext?.scopes)) {
       return false;
     }
-    return (0, import_sync2.operationMatchesQuerySubsets)(op, this.syncQuerySubsets);
+    return (0, import_sync3.operationMatchesQuerySubsets)(op, this.syncQuerySubsets);
   }
   handleAwarenessUpdate(msg) {
     this.onAwarenessUpdate?.(this.sessionId, msg);
@@ -2750,6 +2872,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: (0, import_core10.generateUUIDv7)(),
+      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);
@@ -2771,9 +2912,9 @@ function selectWireFormat(supportedWireFormats) {
 
 // src/server/kora-sync-server.ts
 init_cjs_shims();
-var import_core12 = require("@korajs/core");
+var import_core13 = require("@korajs/core");
 var import_internal2 = require("@korajs/core/internal");
-var import_sync3 = require("@korajs/sync");
+var import_sync5 = require("@korajs/sync");
 
 // src/awareness/awareness-relay.ts
 init_cjs_shims();
@@ -2990,6 +3131,114 @@ var ServerMetricsCollector = class {
   }
 };
 
+// src/richtext/blob-chunk-relay.ts
+init_cjs_shims();
+var import_sync4 = require("@korajs/sync");
+var BlobChunkRelay = class {
+  clients = /* @__PURE__ */ new Map();
+  /** requestId -> the session that originated the request (to route the answer back). */
+  pending = /* @__PURE__ */ new Map();
+  resolveBlobChunk;
+  constructor(resolveBlobChunk) {
+    this.resolveBlobChunk = resolveBlobChunk ?? null;
+  }
+  addClient(sessionId, transport) {
+    this.clients.set(sessionId, { sessionId, transport });
+  }
+  removeClient(sessionId) {
+    this.clients.delete(sessionId);
+    for (const [requestId, originSessionId] of this.pending) {
+      if (originSessionId === sessionId) {
+        this.pending.delete(requestId);
+      }
+    }
+  }
+  getClientCount() {
+    return this.clients.size;
+  }
+  getPendingCount() {
+    return this.pending.size;
+  }
+  clear() {
+    this.clients.clear();
+    this.pending.clear();
+  }
+  /**
+   * Handle an inbound chunk request from a session. Tries the server's own
+   * store first (if configured), otherwise forwards the request to peer
+   * sessions and remembers who to route the answer back to.
+   */
+  handleRequest(sourceSessionId, message) {
+    if (!this.clients.has(sourceSessionId)) {
+      return;
+    }
+    if (this.resolveBlobChunk) {
+      void this.resolveBlobChunk(message.hash).then(
+        (bytes) => {
+          if (bytes !== null) {
+            this.sendResponseTo(sourceSessionId, message.requestId, (0, import_sync4.encodeBlobChunkBytes)(bytes));
+            return;
+          }
+          this.forwardRequestToPeers(sourceSessionId, message);
+        },
+        () => {
+          this.forwardRequestToPeers(sourceSessionId, message);
+        }
+      );
+      return;
+    }
+    this.forwardRequestToPeers(sourceSessionId, message);
+  }
+  /**
+   * Handle an inbound chunk response from a peer. Routes it back to the session
+   * that originally requested it. A "not held" answer (bytes === null) is
+   * ignored so a peer without the chunk does not preempt one that has it; the
+   * requester's own per-request timeout bounds the wait.
+   */
+  handleResponse(sourceSessionId, message) {
+    if (!this.clients.has(sourceSessionId)) {
+      return;
+    }
+    if (message.bytes === null) {
+      return;
+    }
+    const originSessionId = this.pending.get(message.requestId);
+    if (!originSessionId) {
+      return;
+    }
+    this.pending.delete(message.requestId);
+    this.sendResponseTo(originSessionId, message.requestId, message.bytes);
+  }
+  forwardRequestToPeers(sourceSessionId, message) {
+    this.pending.set(message.requestId, sourceSessionId);
+    for (const [, client] of this.clients) {
+      if (client.sessionId === sourceSessionId) {
+        continue;
+      }
+      if (!client.transport.isConnected()) {
+        continue;
+      }
+      client.transport.send(message);
+    }
+  }
+  sendResponseTo(sessionId, requestId, bytes) {
+    const client = this.clients.get(sessionId);
+    if (!client || !client.transport.isConnected()) {
+      return;
+    }
+    const response = {
+      type: "blob-chunk-response",
+      messageId: generateResponseId(requestId),
+      requestId,
+      bytes
+    };
+    client.transport.send(response);
+  }
+};
+function generateResponseId(requestId) {
+  return `blob-resp-${requestId}`;
+}
+
 // src/richtext/yjs-doc-relay.ts
 init_cjs_shims();
 var YjsDocRelay = class {
@@ -3025,6 +3274,170 @@ var YjsDocRelay = class {
   }
 };
 
+// src/server/route-context.ts
+init_cjs_shims();
+var import_core12 = require("@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 import_core12.HybridLogicalClock(nodeId);
+  const schemaVersion = store.getSchema()?.version ?? 1;
+  const sequenceNumber = nextServerSequenceNumber(store);
+  if (mutation.type === "insert") {
+    return (0, import_core12.createOperation)(
+      {
+        nodeId,
+        type: "insert",
+        collection: mutation.collection,
+        recordId: mutation.recordId ?? (0, import_core12.generateUUIDv7)(),
+        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 (0, import_core12.createOperation)(
+      {
+        nodeId,
+        type: "update",
+        collection: mutation.collection,
+        recordId: mutation.recordId,
+        data,
+        previousData: current ? pickFields(current, Object.keys(data)) : {},
+        sequenceNumber,
+        causalDeps: [],
+        schemaVersion
+      },
+      clock
+    );
+  }
+  return (0, import_core12.createOperation)(
+    {
+      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,
+              retriable: isRetriableRejection(error.code)
+            };
+          }
+          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.`,
+            retriable: isRetriableRejection("SCOPE_VIOLATION")
+          };
+        }
+        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 "${mutation.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(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/kora-sync-server.ts
 var DEFAULT_MAX_CONNECTIONS = 0;
 var DEFAULT_BATCH_SIZE2 = 100;
@@ -3047,16 +3460,24 @@ var KoraSyncServer = class {
   metrics;
   awarenessRelay = new AwarenessRelay();
   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) {
     this.store = config.store;
     this.auth = config.auth ?? null;
-    this.serializer = config.serializer ?? new import_sync3.JsonMessageSerializer();
+    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;
@@ -3071,10 +3492,24 @@ var KoraSyncServer = class {
     this.logger = config.logger ?? createDefaultLogger();
     this.metrics = config.metricsCollector ?? new ServerMetricsCollector();
     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 import_internal2.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.
@@ -3143,10 +3578,10 @@ var KoraSyncServer = class {
    */
   async start(wsServerImpl) {
     if (this.running) {
-      throw new import_core12.SyncError("Server is already running", { port: this.port });
+      throw new import_core13.SyncError("Server is already running", { port: this.port });
     }
     if (!wsServerImpl && this.port === void 0) {
-      throw new import_core12.SyncError(
+      throw new import_core13.SyncError(
         "Port is required for standalone mode. Provide port in config or use handleConnection() for attach mode.",
         {}
       );
@@ -3194,6 +3629,7 @@ var KoraSyncServer = class {
     });
     this.awarenessRelay.clear();
     this.yjsDocRelay.clear();
+    this.blobChunkRelay.clear();
     for (const session of this.sessions.values()) {
       session.close("server shutting down");
     }
@@ -3255,7 +3691,7 @@ var KoraSyncServer = class {
     if (this.maxConnections > 0 && this.sessions.size >= this.maxConnections) {
       transport.send({
         type: "error",
-        messageId: (0, import_core12.generateUUIDv7)(),
+        messageId: (0, import_core13.generateUUIDv7)(),
         code: "MAX_CONNECTIONS",
         message: `Server has reached maximum connections (${this.maxConnections})`,
         retriable: true
@@ -3268,12 +3704,12 @@ var KoraSyncServer = class {
         event: "connection.rejected",
         details: { reason: "max_connections", max: this.maxConnections }
       });
-      throw new import_core12.SyncError("Maximum connections reached", {
+      throw new import_core13.SyncError("Maximum connections reached", {
         current: this.sessions.size,
         max: this.maxConnections
       });
     }
-    const sessionId = (0, import_core12.generateUUIDv7)();
+    const sessionId = (0, import_core13.generateUUIDv7)();
     this.metrics.recordConnection(sessionId);
     const sessionEmitter = new import_internal2.SimpleEventEmitter();
     sessionEmitter.on("sync:connected", (event) => {
@@ -3338,12 +3774,25 @@ var KoraSyncServer = class {
       onYjsDocUpdate: (sourceSessionId, message) => {
         this.handleYjsDocRelay(sourceSessionId, message);
       },
+      onBlobChunkRequest: (sourceSessionId, message) => {
+        this.blobChunkRelay.handleRequest(sourceSessionId, message);
+      },
+      onBlobChunkResponse: (sourceSessionId, message) => {
+        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);
       }
     });
     this.sessions.set(sessionId, session);
     this.yjsDocRelay.addClient(sessionId, transport);
+    this.blobChunkRelay.addClient(sessionId, transport);
     session.start();
     this.logger.log({
       timestamp: Date.now(),
@@ -3376,6 +3825,61 @@ var KoraSyncServer = class {
       errorCount: snapshot.errorCount
     };
   }
+  /**
+   * Apply a server-originated operation (for example one created by a custom
+   * HTTP route) through the same validated pipeline that incoming client
+   * operations use — Tier 2 constraints, referential integrity, and cascade
+   * side effects — then relay every applied operation to connected clients.
+   *
+   * Because the operation did not come from a client session, it is relayed to
+   * ALL sessions (there is no source session to exclude). Each session still
+   * applies its own per-scope visibility filter in `relayOperations`, so a
+   * client only receives the operation if it falls within that client's scope.
+   *
+   * @param op - A fully-formed, server-originated operation to apply
+   * @returns The apply result, including any server-generated side-effect ops
+   */
+  async applyLocalOperation(op) {
+    const result = await applyServerOperation(this.store, op);
+    if (result.result === "applied" && result.appliedOperations.length > 0) {
+      for (const session of this.sessions.values()) {
+        session.relayOperations(result.appliedOperations);
+      }
+    }
+    return result;
+  }
+  /**
+   * Collect every blob reference still reachable from live records on the server.
+   *
+   * This is the live set for garbage-collecting the server's central blob store:
+   * pass the result to `collectBlobGarbage(blobStore, liveRefs)` from
+   * `@korajs/store` to reclaim bytes no record references any more. Only
+   * collections that declare a `blob` field are scanned.
+   *
+   * @returns Every live blob reference across all collections
+   */
+  async getLiveBlobRefs() {
+    const schema = this.store.getSchema();
+    if (!schema) {
+      return [];
+    }
+    const refs = [];
+    for (const [name, collection] of Object.entries(schema.collections)) {
+      const hasBlobField = Object.values(collection.fields).some((field) => field.kind === "blob");
+      if (!hasBlobField) {
+        continue;
+      }
+      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)) {
+            refs.push(value);
+          }
+        }
+      }
+    }
+    return refs;
+  }
   /**
    * Get the number of currently connected clients.
    */
@@ -3409,6 +3913,7 @@ var KoraSyncServer = class {
     this.metrics.recordDisconnection(sessionId);
     this.awarenessRelay.removeClient(sessionId);
     this.yjsDocRelay.removeClient(sessionId);
+    this.blobChunkRelay.removeClient(sessionId);
     this.sessions.delete(sessionId);
     const clientId = this.httpSessionToClient.get(sessionId);
     if (clientId) {
@@ -3461,14 +3966,6 @@ function normalizeHttpBody(body, contentType) {
   return body;
 }
 
-// src/auth/no-auth.ts
-init_cjs_shims();
-var NoAuthProvider = class {
-  async authenticate(_token) {
-    return { userId: "anonymous" };
-  }
-};
-
 // src/auth/token-auth.ts
 init_cjs_shims();
 var TokenAuthProvider = class {
@@ -3578,6 +4075,7 @@ function createProductionServer(config) {
     enableDashboard: true,
     ...config.syncOptions
   });
+  const routeContext = syncServer.getKoraContext();
   let httpServer = null;
   function getOperationalToken(kind) {
     const auth = config.operationalAuth;
@@ -3664,6 +4162,10 @@ function createProductionServer(config) {
       const chunks = [];
       req.on("data", (chunk) => chunks.push(chunk));
       req.on("end", () => resolve(Buffer.concat(chunks)));
+      if (!req.readableFlowing) {
+        req.resume();
+      }
+      req.on("error", () => resolve(Buffer.concat(chunks)));
     });
   }
   async function readJsonBody(req) {
@@ -3713,6 +4215,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");
@@ -3720,6 +4226,19 @@ function createProductionServer(config) {
       const { WebSocketServer } = await import("ws");
       const distDir = resolve(staticDir);
       httpServer = createServer(async (req, res) => {
+        try {
+          await handleRequest(req, res);
+        } catch (error) {
+          console.error("[kora] Unhandled error in HTTP request handler:", error);
+          if (!res.headersSent) {
+            res.writeHead(500, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({ error: "Internal server error" }));
+          } else if (!res.writableEnded) {
+            res.end();
+          }
+        }
+      });
+      async function handleRequest(req, res) {
         res.setHeader("Cross-Origin-Opener-Policy", "same-origin");
         res.setHeader("Cross-Origin-Embedder-Policy", "require-corp");
         const url = new URL(req.url || "/", `http://${req.headers.host}`);
@@ -3847,7 +4366,8 @@ data: ${JSON.stringify(s)}
             body: await readJsonBody(req),
             headers: req.headers,
             query: getQuery(url),
-            ip: getClientIp(req)
+            ip: getClientIp(req),
+            kora: routeContext
           });
           writeJsonResponse(res, result);
           return;
@@ -3881,7 +4401,7 @@ data: ${JSON.stringify(s)}
         const contentType = MIME_TYPES[ext] || "application/octet-stream";
         res.writeHead(200, { "Content-Type": contentType });
         createReadStream(filePath).pipe(res);
-      });
+      }
       const wss = new WebSocketServer({ noServer: true });
       httpServer.on("upgrade", (req, socket, head) => {
         const url = new URL(req.url || "/", `http://${req.headers.host}`);
@@ -3998,6 +4518,7 @@ function formatUptime(ms) {
   MixedAuthProvider,
   NoAuthProvider,
   PostgresServerStore,
+  RETRIABLE_REJECTION_CODES,
   SqliteServerStore,
   TokenAuthProvider,
   WsServerTransport,
@@ -4008,6 +4529,7 @@ function formatUptime(ms) {
   createPrettyLogger,
   createProductionServer,
   createSilentLogger,
-  createSqliteServerStore
+  createSqliteServerStore,
+  isRetriableRejection
 });
 //# sourceMappingURL=index.cjs.map