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

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { S as SyncScopeMap, D as DeltaCursor, a as SyncMessage, b as SerializedOperation, W as WireFormat, c as SyncTransport, T as TransportOptions, d as TransportMessageHandler, e as TransportCloseHandler, f as TransportErrorHandler, g as SyncEncryptionConfig, V as VersionedKey, Y as YjsDocUpdateMessage, Q as QueueStorage, h as SyncState, i as SyncStatusInfo, j as SyncConfig, k as SyncStatePersistence, l as SyncQuerySubset } from './transport-BMesMB6s.cjs';
-export { A as AcknowledgmentMessage, m as AwarenessStateWire, n as AwarenessUpdateMessage, E as EncryptedPayload, o as ErrorMessage, H as HandshakeMessage, p as HandshakeResponseMessage, I as InvalidScopeError, O as OperationBatchMessage, q as SYNC_STATES, r as SYNC_STATUSES, s as ScopeViolationError, t as SyncEncryptionAlgorithm, u as SyncScopeContext, v as SyncStatus, w as dedupeQuerySubsets, x as isAcknowledgmentMessage, y as isAwarenessUpdateMessage, z as isErrorMessage, B as isHandshakeMessage, C as isHandshakeResponseMessage, F as isOperationBatchMessage, G as isSyncMessage, J as isYjsDocUpdateMessage, K as operationMatchesQuerySubsets } from './transport-BMesMB6s.cjs';
+import { S as SyncScopeMap, D as DeltaCursor, a as SyncMessage, b as SerializedOperation, W as WireFormat, c as SyncTransport, T as TransportOptions, d as TransportMessageHandler, e as TransportCloseHandler, f as TransportErrorHandler, B as BlobChunkRequestMessage, g as BlobChunkResponseMessage, h as BlobChunkPushMessage, i as SyncEncryptionConfig, V as VersionedKey, Y as YjsDocUpdateMessage, Q as QueueStorage, j as SyncState, k as SyncStatusInfo, l as SyncConfig, R as RejectedOperationStorage, m as SyncStatePersistence, n as SyncQuerySubset, o as RejectedOperation } from './transport-BGr-_eH8.cjs';
+export { A as AcknowledgmentMessage, p as AwarenessStateWire, q as AwarenessUpdateMessage, E as EncryptedPayload, r as ErrorMessage, H as HandshakeMessage, s as HandshakeResponseMessage, I as InvalidScopeError, M as MemoryRejectedOperationStorage, O as OperationBatchMessage, t as OperationRejectedMessage, u as SYNC_STATES, v as SYNC_STATUSES, w as ScopeViolationError, x as SyncEncryptionAlgorithm, y as SyncScopeContext, z as SyncStatus, C as dedupeQuerySubsets, F as isAcknowledgmentMessage, G as isAwarenessUpdateMessage, J as isBlobChunkPushMessage, K as isBlobChunkRequestMessage, L as isBlobChunkResponseMessage, N as isErrorMessage, P as isHandshakeMessage, U as isHandshakeResponseMessage, X as isOperationBatchMessage, Z as isOperationRejectedMessage, _ as isSyncMessage, $ as isYjsDocUpdateMessage, a0 as operationMatchesQuerySubsets } from './transport-BGr-_eH8.cjs';
 import * as _korajs_core from '@korajs/core';
 import { Operation, VersionVector, ApplyResult, KoraEventEmitter, TimeSource, SyncError, ConnectionQuality } from '@korajs/core';
 export { ApplyFailureReason, ApplyResult } from '@korajs/core';
@@ -470,6 +470,71 @@ declare class AwarenessManager {
     private emitAwarenessEvent;
 }
 
+/**
+ * A blob-chunk message in decoded form (chunk bytes as a `Uint8Array` rather
+ * than the base64 wire string). This is the shape callers of the channel work
+ * with; the channel handles base64 encode/decode at the wire boundary.
+ *
+ * The shape mirrors `@korajs/store`'s `ChunkMessage` so an app-layer adapter can
+ * bridge the two with no field translation.
+ */
+type BlobChunkChannelMessage = {
+    type: 'blob-chunk-request';
+    requestId: string;
+    hash: string;
+} | {
+    type: 'blob-chunk-response';
+    requestId: string;
+    bytes: Uint8Array | null;
+} | {
+    type: 'blob-chunk-push';
+    hash: string;
+    bytes: Uint8Array;
+};
+/** Encode chunk bytes to a base64 string for the JSON wire. */
+declare function encodeBlobChunkBytes(bytes: Uint8Array): string;
+/** Decode base64 chunk bytes from the wire back to a `Uint8Array`. */
+declare function decodeBlobChunkBytes(encoded: string): Uint8Array;
+interface BlobChunkChannelOptions {
+    /**
+     * Called when a local blob-chunk message should go out on the wire. The
+     * caller (the sync engine) decides whether the connection is ready to send.
+     */
+    onSend?: (message: BlobChunkRequestMessage | BlobChunkResponseMessage | BlobChunkPushMessage) => void;
+}
+/**
+ * Ephemeral side channel for out-of-band blob chunk transfer over the sync
+ * connection. Symmetric: a peer can both request chunks it needs and answer
+ * requests for chunks it holds. Never persisted in the operation log — durable
+ * state is the `BlobRef` inside a record's fields; this channel only moves the
+ * referenced bytes.
+ *
+ * The channel owns the base64 wire encoding so callers work purely in
+ * `Uint8Array`, and its {@link BlobChunkChannelMessage} shape mirrors
+ * `@korajs/store`'s `ChunkMessage` so the app layer can expose it as a
+ * `ChunkMessagePort` without translating fields.
+ */
+declare class BlobChunkChannel {
+    private readonly onSend;
+    private readonly handlers;
+    constructor(options?: BlobChunkChannelOptions);
+    /**
+     * Send a blob-chunk message to the peer. Response bytes are base64-encoded
+     * onto the wire here; callers pass a `Uint8Array`.
+     */
+    send(message: BlobChunkChannelMessage): void;
+    /**
+     * Register a handler for inbound blob-chunk messages. Multiple handlers are
+     * allowed; each receives every delivered message.
+     */
+    onMessage(handler: (message: BlobChunkChannelMessage) => void): () => void;
+    /**
+     * Deliver an inbound wire message to registered handlers, decoding response
+     * bytes from base64 back to a `Uint8Array` first.
+     */
+    deliver(message: BlobChunkRequestMessage | BlobChunkResponseMessage | BlobChunkPushMessage): void;
+}
+
 /**
  * Configuration for the SyncMetricsCollector.
  */
@@ -779,6 +844,14 @@ declare class OutboundQueue {
      * Whether initialize() has been called.
      */
     get isInitialized(): boolean;
+    /**
+     * Remove a single operation the server permanently rejected — from the queue,
+     * from any in-flight batch, and from durable storage — so a later batch ack or
+     * a reconnect `returnBatch` can never resend or resurrect it. Returns the
+     * removed operation so the caller can record it in a durable rejected store,
+     * or null if it was not present (already acknowledged and removed).
+     */
+    reject(opId: string): Promise<Operation | null>;
     /**
      * Remove operations by id from queue and persistent storage.
      * Used when ops were already sent during handshake delta exchange.
@@ -802,6 +875,11 @@ interface SyncEngineOptions {
     emitter?: KoraEventEmitter;
     /** Queue storage for persistent outbound queue. Defaults to in-memory. */
     queueStorage?: QueueStorage;
+    /**
+     * Durable storage for operations the server rejected. Defaults to in-memory.
+     * Provide a store-backed implementation so rejections survive a page refresh.
+     */
+    rejectedStorage?: RejectedOperationStorage;
     /**
      * Optional encryptor for end-to-end encryption.
      * When provided, `data` and `previousData` fields of operations are encrypted
@@ -846,10 +924,12 @@ declare class SyncEngine {
     private readonly serializer;
     private readonly emitter;
     private readonly outboundQueue;
+    private readonly rejectedStorage;
     private readonly batchSize;
     private readonly encryptor;
     private readonly awarenessManager;
     private readonly richtextDocChannel;
+    private readonly blobChunkChannel;
     private readonly metricsCollector;
     private readonly syncState;
     private remoteVector;
@@ -864,6 +944,7 @@ declare class SyncEngine {
     private schemaBlocked;
     private clockBlocked;
     private clockSkewMs;
+    private blobStorageEnabled;
     private deltaBatchesReceived;
     private deltaReceiveComplete;
     private deltaSendComplete;
@@ -998,6 +1079,22 @@ declare class SyncEngine {
      * Optional side channel for incremental Yjs updates on large richtext fields.
      */
     getRichtextDocChannel(): RichtextDocChannel;
+    /**
+     * Side channel for out-of-band blob chunk transfer over the sync connection.
+     * The app layer bridges this to a `ChunkMessagePort` to pull/serve blob bytes.
+     */
+    getBlobChunkChannel(): BlobChunkChannel;
+    /**
+     * Whether the connected server persists blob bytes centrally (learned from the
+     * handshake response). When true, the app uploads the bytes behind `blob`
+     * fields so they stay available after the authoring device goes offline.
+     */
+    isBlobStorageEnabled(): boolean;
+    /**
+     * Upload a blob chunk (or manifest) to the server for central persistence.
+     * A no-op unless connected and the server advertised blob storage.
+     */
+    uploadBlobChunk(hash: string, bytes: Uint8Array): void;
     private messageChain;
     private enqueueMessage;
     private handleMessageAsync;
@@ -1024,6 +1121,25 @@ declare class SyncEngine {
     private handleOperationBatch;
     private handleAcknowledgment;
     private handleError;
+    /**
+     * Handle a per-operation rejection: divert the op out of the pending outbound
+     * queue (so it is never retried or resurrected on reconnect), record it in the
+     * durable rejected store (so it is kept and explainable), and emit an event so
+     * the app can reconcile. Unlike {@link handleError}, this is a normal per-op
+     * signal, so the connection stays up.
+     */
+    private handleOperationRejected;
+    /**
+     * Every operation the server rejected that has not yet been reconciled. The app
+     * uses this (alongside the `sync:operation-rejected` event) to surface failed
+     * submissions and decide whether to roll back or resubmit.
+     */
+    getRejectedOperations(): Promise<RejectedOperation[]>;
+    /**
+     * Forget rejected operations by id once the app has reconciled them (rolled the
+     * optimistic write back or resubmitted a corrected op).
+     */
+    clearRejectedOperations(operationIds: string[]): Promise<void>;
     private checkDeltaComplete;
     /**
      * Effective server vector: persisted last-ack merged with live handshake remote vector.
@@ -1292,4 +1408,4 @@ declare function getRemoteAwarenessStates(awareness: AwarenessManager): Awarenes
  */
 declare function subscribeRemoteAwarenessStates(awareness: AwarenessManager, listener: (states: AwarenessState[]) => void): () => void;
 
-export { type AwarenessChange, type AwarenessCursor, AwarenessManager, type AwarenessMessage, type AwarenessState, type AwarenessUser, type ChaosConfig, ChaosTransport, ConnectionMonitor, type ConnectionMonitorConfig, type CursorInfo, DEFAULT_RICHTEXT_DOC_CHANNEL_THRESHOLD, DecryptionError, DeltaCursor, EncryptionError, HttpLongPollingTransport, type HttpLongPollingTransportOptions, JsonMessageSerializer, KeyDerivationError, type MessageSerializer, NegotiatedMessageSerializer, OFFLINE_SYNC_STATUS, type OutboundBatch, OutboundQueue, ProtobufMessageSerializer, QueueStorage, type ReconnectionConfig, ReconnectionManager, RichtextDocChannel, type RichtextDocChannelOptions, type RichtextDocListener, SCHEMA_MISMATCH_PREFIX, SerializedOperation, SyncConfig, type SyncDiagnostics, SyncEncryptionConfig, SyncEncryptor, SyncEngine, type SyncEngineOptions, SyncMessage, SyncQuerySubset, SyncScopeMap, SyncState, SyncStatePersistence, type SyncStatusController, type SyncStatusControllerOptions, SyncStatusInfo, type SyncStore, SyncTransport, TransportCloseHandler, TransportErrorHandler, TransportMessageHandler, TransportOptions, VersionedKey, type WebSocketConstructor, type WebSocketLike, WebSocketTransport, type WebSocketTransportOptions, WireFormat, YjsDocUpdateMessage, createDeltaCursorFromBatch, createSyncStatusController, decodeDeltaCursor, decodeYjsUpdate, deriveKey, deriveVersionedKey, encodeDeltaCursor, encodeYjsUpdate, filterOperationsByScope, generateSalt, getRemoteAwarenessStates, isClientSchemaVersionSupported, isEncryptedPayload, isSchemaMismatchReject, operationMatchesScope, richtextDocKey, sliceOperationsAfterCursor, subscribeRemoteAwarenessStates, versionVectorToWire, wireToVersionVector };
+export { type AwarenessChange, type AwarenessCursor, AwarenessManager, type AwarenessMessage, type AwarenessState, type AwarenessUser, BlobChunkChannel, type BlobChunkChannelMessage, type BlobChunkChannelOptions, BlobChunkPushMessage, BlobChunkRequestMessage, BlobChunkResponseMessage, type ChaosConfig, ChaosTransport, ConnectionMonitor, type ConnectionMonitorConfig, type CursorInfo, DEFAULT_RICHTEXT_DOC_CHANNEL_THRESHOLD, DecryptionError, DeltaCursor, EncryptionError, HttpLongPollingTransport, type HttpLongPollingTransportOptions, JsonMessageSerializer, KeyDerivationError, type MessageSerializer, NegotiatedMessageSerializer, OFFLINE_SYNC_STATUS, type OutboundBatch, OutboundQueue, ProtobufMessageSerializer, QueueStorage, type ReconnectionConfig, ReconnectionManager, RejectedOperation, RejectedOperationStorage, RichtextDocChannel, type RichtextDocChannelOptions, type RichtextDocListener, SCHEMA_MISMATCH_PREFIX, SerializedOperation, SyncConfig, type SyncDiagnostics, SyncEncryptionConfig, SyncEncryptor, SyncEngine, type SyncEngineOptions, SyncMessage, SyncQuerySubset, SyncScopeMap, SyncState, SyncStatePersistence, type SyncStatusController, type SyncStatusControllerOptions, SyncStatusInfo, type SyncStore, SyncTransport, TransportCloseHandler, TransportErrorHandler, TransportMessageHandler, TransportOptions, VersionedKey, type WebSocketConstructor, type WebSocketLike, WebSocketTransport, type WebSocketTransportOptions, WireFormat, YjsDocUpdateMessage, createDeltaCursorFromBatch, createSyncStatusController, decodeBlobChunkBytes, decodeDeltaCursor, decodeYjsUpdate, deriveKey, deriveVersionedKey, encodeBlobChunkBytes, encodeDeltaCursor, encodeYjsUpdate, filterOperationsByScope, generateSalt, getRemoteAwarenessStates, isClientSchemaVersionSupported, isEncryptedPayload, isSchemaMismatchReject, operationMatchesScope, richtextDocKey, sliceOperationsAfterCursor, subscribeRemoteAwarenessStates, versionVectorToWire, wireToVersionVector };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { S as SyncScopeMap, D as DeltaCursor, a as SyncMessage, b as SerializedOperation, W as WireFormat, c as SyncTransport, T as TransportOptions, d as TransportMessageHandler, e as TransportCloseHandler, f as TransportErrorHandler, g as SyncEncryptionConfig, V as VersionedKey, Y as YjsDocUpdateMessage, Q as QueueStorage, h as SyncState, i as SyncStatusInfo, j as SyncConfig, k as SyncStatePersistence, l as SyncQuerySubset } from './transport-BMesMB6s.js';
-export { A as AcknowledgmentMessage, m as AwarenessStateWire, n as AwarenessUpdateMessage, E as EncryptedPayload, o as ErrorMessage, H as HandshakeMessage, p as HandshakeResponseMessage, I as InvalidScopeError, O as OperationBatchMessage, q as SYNC_STATES, r as SYNC_STATUSES, s as ScopeViolationError, t as SyncEncryptionAlgorithm, u as SyncScopeContext, v as SyncStatus, w as dedupeQuerySubsets, x as isAcknowledgmentMessage, y as isAwarenessUpdateMessage, z as isErrorMessage, B as isHandshakeMessage, C as isHandshakeResponseMessage, F as isOperationBatchMessage, G as isSyncMessage, J as isYjsDocUpdateMessage, K as operationMatchesQuerySubsets } from './transport-BMesMB6s.js';
+import { S as SyncScopeMap, D as DeltaCursor, a as SyncMessage, b as SerializedOperation, W as WireFormat, c as SyncTransport, T as TransportOptions, d as TransportMessageHandler, e as TransportCloseHandler, f as TransportErrorHandler, B as BlobChunkRequestMessage, g as BlobChunkResponseMessage, h as BlobChunkPushMessage, i as SyncEncryptionConfig, V as VersionedKey, Y as YjsDocUpdateMessage, Q as QueueStorage, j as SyncState, k as SyncStatusInfo, l as SyncConfig, R as RejectedOperationStorage, m as SyncStatePersistence, n as SyncQuerySubset, o as RejectedOperation } from './transport-BGr-_eH8.js';
+export { A as AcknowledgmentMessage, p as AwarenessStateWire, q as AwarenessUpdateMessage, E as EncryptedPayload, r as ErrorMessage, H as HandshakeMessage, s as HandshakeResponseMessage, I as InvalidScopeError, M as MemoryRejectedOperationStorage, O as OperationBatchMessage, t as OperationRejectedMessage, u as SYNC_STATES, v as SYNC_STATUSES, w as ScopeViolationError, x as SyncEncryptionAlgorithm, y as SyncScopeContext, z as SyncStatus, C as dedupeQuerySubsets, F as isAcknowledgmentMessage, G as isAwarenessUpdateMessage, J as isBlobChunkPushMessage, K as isBlobChunkRequestMessage, L as isBlobChunkResponseMessage, N as isErrorMessage, P as isHandshakeMessage, U as isHandshakeResponseMessage, X as isOperationBatchMessage, Z as isOperationRejectedMessage, _ as isSyncMessage, $ as isYjsDocUpdateMessage, a0 as operationMatchesQuerySubsets } from './transport-BGr-_eH8.js';
 import * as _korajs_core from '@korajs/core';
 import { Operation, VersionVector, ApplyResult, KoraEventEmitter, TimeSource, SyncError, ConnectionQuality } from '@korajs/core';
 export { ApplyFailureReason, ApplyResult } from '@korajs/core';
@@ -470,6 +470,71 @@ declare class AwarenessManager {
     private emitAwarenessEvent;
 }
 
+/**
+ * A blob-chunk message in decoded form (chunk bytes as a `Uint8Array` rather
+ * than the base64 wire string). This is the shape callers of the channel work
+ * with; the channel handles base64 encode/decode at the wire boundary.
+ *
+ * The shape mirrors `@korajs/store`'s `ChunkMessage` so an app-layer adapter can
+ * bridge the two with no field translation.
+ */
+type BlobChunkChannelMessage = {
+    type: 'blob-chunk-request';
+    requestId: string;
+    hash: string;
+} | {
+    type: 'blob-chunk-response';
+    requestId: string;
+    bytes: Uint8Array | null;
+} | {
+    type: 'blob-chunk-push';
+    hash: string;
+    bytes: Uint8Array;
+};
+/** Encode chunk bytes to a base64 string for the JSON wire. */
+declare function encodeBlobChunkBytes(bytes: Uint8Array): string;
+/** Decode base64 chunk bytes from the wire back to a `Uint8Array`. */
+declare function decodeBlobChunkBytes(encoded: string): Uint8Array;
+interface BlobChunkChannelOptions {
+    /**
+     * Called when a local blob-chunk message should go out on the wire. The
+     * caller (the sync engine) decides whether the connection is ready to send.
+     */
+    onSend?: (message: BlobChunkRequestMessage | BlobChunkResponseMessage | BlobChunkPushMessage) => void;
+}
+/**
+ * Ephemeral side channel for out-of-band blob chunk transfer over the sync
+ * connection. Symmetric: a peer can both request chunks it needs and answer
+ * requests for chunks it holds. Never persisted in the operation log — durable
+ * state is the `BlobRef` inside a record's fields; this channel only moves the
+ * referenced bytes.
+ *
+ * The channel owns the base64 wire encoding so callers work purely in
+ * `Uint8Array`, and its {@link BlobChunkChannelMessage} shape mirrors
+ * `@korajs/store`'s `ChunkMessage` so the app layer can expose it as a
+ * `ChunkMessagePort` without translating fields.
+ */
+declare class BlobChunkChannel {
+    private readonly onSend;
+    private readonly handlers;
+    constructor(options?: BlobChunkChannelOptions);
+    /**
+     * Send a blob-chunk message to the peer. Response bytes are base64-encoded
+     * onto the wire here; callers pass a `Uint8Array`.
+     */
+    send(message: BlobChunkChannelMessage): void;
+    /**
+     * Register a handler for inbound blob-chunk messages. Multiple handlers are
+     * allowed; each receives every delivered message.
+     */
+    onMessage(handler: (message: BlobChunkChannelMessage) => void): () => void;
+    /**
+     * Deliver an inbound wire message to registered handlers, decoding response
+     * bytes from base64 back to a `Uint8Array` first.
+     */
+    deliver(message: BlobChunkRequestMessage | BlobChunkResponseMessage | BlobChunkPushMessage): void;
+}
+
 /**
  * Configuration for the SyncMetricsCollector.
  */
@@ -779,6 +844,14 @@ declare class OutboundQueue {
      * Whether initialize() has been called.
      */
     get isInitialized(): boolean;
+    /**
+     * Remove a single operation the server permanently rejected — from the queue,
+     * from any in-flight batch, and from durable storage — so a later batch ack or
+     * a reconnect `returnBatch` can never resend or resurrect it. Returns the
+     * removed operation so the caller can record it in a durable rejected store,
+     * or null if it was not present (already acknowledged and removed).
+     */
+    reject(opId: string): Promise<Operation | null>;
     /**
      * Remove operations by id from queue and persistent storage.
      * Used when ops were already sent during handshake delta exchange.
@@ -802,6 +875,11 @@ interface SyncEngineOptions {
     emitter?: KoraEventEmitter;
     /** Queue storage for persistent outbound queue. Defaults to in-memory. */
     queueStorage?: QueueStorage;
+    /**
+     * Durable storage for operations the server rejected. Defaults to in-memory.
+     * Provide a store-backed implementation so rejections survive a page refresh.
+     */
+    rejectedStorage?: RejectedOperationStorage;
     /**
      * Optional encryptor for end-to-end encryption.
      * When provided, `data` and `previousData` fields of operations are encrypted
@@ -846,10 +924,12 @@ declare class SyncEngine {
     private readonly serializer;
     private readonly emitter;
     private readonly outboundQueue;
+    private readonly rejectedStorage;
     private readonly batchSize;
     private readonly encryptor;
     private readonly awarenessManager;
     private readonly richtextDocChannel;
+    private readonly blobChunkChannel;
     private readonly metricsCollector;
     private readonly syncState;
     private remoteVector;
@@ -864,6 +944,7 @@ declare class SyncEngine {
     private schemaBlocked;
     private clockBlocked;
     private clockSkewMs;
+    private blobStorageEnabled;
     private deltaBatchesReceived;
     private deltaReceiveComplete;
     private deltaSendComplete;
@@ -998,6 +1079,22 @@ declare class SyncEngine {
      * Optional side channel for incremental Yjs updates on large richtext fields.
      */
     getRichtextDocChannel(): RichtextDocChannel;
+    /**
+     * Side channel for out-of-band blob chunk transfer over the sync connection.
+     * The app layer bridges this to a `ChunkMessagePort` to pull/serve blob bytes.
+     */
+    getBlobChunkChannel(): BlobChunkChannel;
+    /**
+     * Whether the connected server persists blob bytes centrally (learned from the
+     * handshake response). When true, the app uploads the bytes behind `blob`
+     * fields so they stay available after the authoring device goes offline.
+     */
+    isBlobStorageEnabled(): boolean;
+    /**
+     * Upload a blob chunk (or manifest) to the server for central persistence.
+     * A no-op unless connected and the server advertised blob storage.
+     */
+    uploadBlobChunk(hash: string, bytes: Uint8Array): void;
     private messageChain;
     private enqueueMessage;
     private handleMessageAsync;
@@ -1024,6 +1121,25 @@ declare class SyncEngine {
     private handleOperationBatch;
     private handleAcknowledgment;
     private handleError;
+    /**
+     * Handle a per-operation rejection: divert the op out of the pending outbound
+     * queue (so it is never retried or resurrected on reconnect), record it in the
+     * durable rejected store (so it is kept and explainable), and emit an event so
+     * the app can reconcile. Unlike {@link handleError}, this is a normal per-op
+     * signal, so the connection stays up.
+     */
+    private handleOperationRejected;
+    /**
+     * Every operation the server rejected that has not yet been reconciled. The app
+     * uses this (alongside the `sync:operation-rejected` event) to surface failed
+     * submissions and decide whether to roll back or resubmit.
+     */
+    getRejectedOperations(): Promise<RejectedOperation[]>;
+    /**
+     * Forget rejected operations by id once the app has reconciled them (rolled the
+     * optimistic write back or resubmitted a corrected op).
+     */
+    clearRejectedOperations(operationIds: string[]): Promise<void>;
     private checkDeltaComplete;
     /**
      * Effective server vector: persisted last-ack merged with live handshake remote vector.
@@ -1292,4 +1408,4 @@ declare function getRemoteAwarenessStates(awareness: AwarenessManager): Awarenes
  */
 declare function subscribeRemoteAwarenessStates(awareness: AwarenessManager, listener: (states: AwarenessState[]) => void): () => void;
 
-export { type AwarenessChange, type AwarenessCursor, AwarenessManager, type AwarenessMessage, type AwarenessState, type AwarenessUser, type ChaosConfig, ChaosTransport, ConnectionMonitor, type ConnectionMonitorConfig, type CursorInfo, DEFAULT_RICHTEXT_DOC_CHANNEL_THRESHOLD, DecryptionError, DeltaCursor, EncryptionError, HttpLongPollingTransport, type HttpLongPollingTransportOptions, JsonMessageSerializer, KeyDerivationError, type MessageSerializer, NegotiatedMessageSerializer, OFFLINE_SYNC_STATUS, type OutboundBatch, OutboundQueue, ProtobufMessageSerializer, QueueStorage, type ReconnectionConfig, ReconnectionManager, RichtextDocChannel, type RichtextDocChannelOptions, type RichtextDocListener, SCHEMA_MISMATCH_PREFIX, SerializedOperation, SyncConfig, type SyncDiagnostics, SyncEncryptionConfig, SyncEncryptor, SyncEngine, type SyncEngineOptions, SyncMessage, SyncQuerySubset, SyncScopeMap, SyncState, SyncStatePersistence, type SyncStatusController, type SyncStatusControllerOptions, SyncStatusInfo, type SyncStore, SyncTransport, TransportCloseHandler, TransportErrorHandler, TransportMessageHandler, TransportOptions, VersionedKey, type WebSocketConstructor, type WebSocketLike, WebSocketTransport, type WebSocketTransportOptions, WireFormat, YjsDocUpdateMessage, createDeltaCursorFromBatch, createSyncStatusController, decodeDeltaCursor, decodeYjsUpdate, deriveKey, deriveVersionedKey, encodeDeltaCursor, encodeYjsUpdate, filterOperationsByScope, generateSalt, getRemoteAwarenessStates, isClientSchemaVersionSupported, isEncryptedPayload, isSchemaMismatchReject, operationMatchesScope, richtextDocKey, sliceOperationsAfterCursor, subscribeRemoteAwarenessStates, versionVectorToWire, wireToVersionVector };
+export { type AwarenessChange, type AwarenessCursor, AwarenessManager, type AwarenessMessage, type AwarenessState, type AwarenessUser, BlobChunkChannel, type BlobChunkChannelMessage, type BlobChunkChannelOptions, BlobChunkPushMessage, BlobChunkRequestMessage, BlobChunkResponseMessage, type ChaosConfig, ChaosTransport, ConnectionMonitor, type ConnectionMonitorConfig, type CursorInfo, DEFAULT_RICHTEXT_DOC_CHANNEL_THRESHOLD, DecryptionError, DeltaCursor, EncryptionError, HttpLongPollingTransport, type HttpLongPollingTransportOptions, JsonMessageSerializer, KeyDerivationError, type MessageSerializer, NegotiatedMessageSerializer, OFFLINE_SYNC_STATUS, type OutboundBatch, OutboundQueue, ProtobufMessageSerializer, QueueStorage, type ReconnectionConfig, ReconnectionManager, RejectedOperation, RejectedOperationStorage, RichtextDocChannel, type RichtextDocChannelOptions, type RichtextDocListener, SCHEMA_MISMATCH_PREFIX, SerializedOperation, SyncConfig, type SyncDiagnostics, SyncEncryptionConfig, SyncEncryptor, SyncEngine, type SyncEngineOptions, SyncMessage, SyncQuerySubset, SyncScopeMap, SyncState, SyncStatePersistence, type SyncStatusController, type SyncStatusControllerOptions, SyncStatusInfo, type SyncStore, SyncTransport, TransportCloseHandler, TransportErrorHandler, TransportMessageHandler, TransportOptions, VersionedKey, type WebSocketConstructor, type WebSocketLike, WebSocketTransport, type WebSocketTransportOptions, WireFormat, YjsDocUpdateMessage, createDeltaCursorFromBatch, createSyncStatusController, decodeBlobChunkBytes, decodeDeltaCursor, decodeYjsUpdate, deriveKey, deriveVersionedKey, encodeBlobChunkBytes, encodeDeltaCursor, encodeYjsUpdate, filterOperationsByScope, generateSalt, getRemoteAwarenessStates, isClientSchemaVersionSupported, isEncryptedPayload, isSchemaMismatchReject, operationMatchesScope, richtextDocKey, sliceOperationsAfterCursor, subscribeRemoteAwarenessStates, versionVectorToWire, wireToVersionVector };