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

package/dist/internal.d.cts

@@ -1,4 +1,4 @@
-import { c as SyncTransport, T as TransportOptions, a as SyncMessage, d as TransportMessageHandler, e as TransportCloseHandler, f as TransportErrorHandler, Q as QueueStorage } from './transport-CZLMdZ0k.cjs';
+import { c as SyncTransport, T as TransportOptions, a as SyncMessage, d as TransportMessageHandler, e as TransportCloseHandler, f as TransportErrorHandler, Q as QueueStorage } from './transport-BGr-_eH8.cjs';
 import { Operation } from '@korajs/core';
 
 /**

package/dist/internal.d.ts

@@ -1,4 +1,4 @@
-import { c as SyncTransport, T as TransportOptions, a as SyncMessage, d as TransportMessageHandler, e as TransportCloseHandler, f as TransportErrorHandler, Q as QueueStorage } from './transport-CZLMdZ0k.js';
+import { c as SyncTransport, T as TransportOptions, a as SyncMessage, d as TransportMessageHandler, e as TransportCloseHandler, f as TransportErrorHandler, Q as QueueStorage } from './transport-BGr-_eH8.js';
 import { Operation } from '@korajs/core';
 
 /**

package/dist/{transport-CZLMdZ0k.d.cts → transport-BGr-_eH8.d.cts}

@@ -208,6 +208,48 @@ interface QueueStorage {
     /** Return number of operations in storage */
     count(): Promise<number>;
 }
+/**
+ * A record of one outbound operation the server permanently refused. Preserved so
+ * a rejected op is explainable and reconcilable rather than silently lost.
+ */
+interface RejectedOperation {
+    /** Content-addressed id of the rejected operation. */
+    operationId: string;
+    /** Collection the operation targeted. */
+    collection: string;
+    /** Record the operation targeted. */
+    recordId: string;
+    /** Stable, machine-readable reason code from the server. */
+    code: string;
+    /** Human-readable explanation. */
+    message: string;
+    /** Whether resubmitting the identical operation may later succeed. */
+    retriable: boolean;
+    /** Wall-clock time (ms since epoch) the rejection was recorded. Display only. */
+    rejectedAt: number;
+}
+/**
+ * Interface for durably persisting operations the server rejected, so the record
+ * survives a page refresh. Keyed by operation id (idempotent on re-rejection).
+ */
+interface RejectedOperationStorage {
+    /** Record (or overwrite) a rejected operation. */
+    record(rejected: RejectedOperation): Promise<void>;
+    /** List all recorded rejected operations. */
+    list(): Promise<RejectedOperation[]>;
+    /** Remove rejected operations by their operation ids (after the app reconciles them). */
+    remove(operationIds: string[]): Promise<void>;
+}
+/**
+ * In-memory {@link RejectedOperationStorage}. The default when no durable store is
+ * provided; suitable for tests and ephemeral sessions.
+ */
+declare class MemoryRejectedOperationStorage implements RejectedOperationStorage {
+    private readonly rejected;
+    record(rejected: RejectedOperation): Promise<void>;
+    list(): Promise<RejectedOperation[]>;
+    remove(operationIds: string[]): Promise<void>;
+}
 /**
  * Thrown when an operation violates sync scope constraints.
  * This can happen when:
@@ -349,6 +391,33 @@ interface ErrorMessage {
     message: string;
     retriable: boolean;
 }
+/**
+ * Server-to-client rejection of ONE specific operation the client submitted.
+ *
+ * Unlike {@link ErrorMessage}, which is connection-level, this is tied to an
+ * `operationId` so the client can divert exactly that operation out of its
+ * pending outbound queue and into a durable rejected-operations store — kept and
+ * explainable rather than silently retried forever or lost on the batch ack. The
+ * operation never entered the server's authoritative log, so no other replica
+ * ever sees it; the submitter is told so its optimistic local copy can be
+ * reconciled (rolled back or resubmitted) by the app.
+ */
+interface OperationRejectedMessage {
+    type: 'operation-rejected';
+    messageId: string;
+    /** Content-addressed id of the rejected operation. */
+    operationId: string;
+    /** Collection the rejected operation targeted (for app routing / display). */
+    collection: string;
+    /** Record the rejected operation targeted. */
+    recordId: string;
+    /** Stable, machine-readable reason code. */
+    code: string;
+    /** Human-readable explanation. */
+    message: string;
+    /** Whether resubmitting the identical operation may later succeed. */
+    retriable: boolean;
+}
 /**
  * Awareness state for a single client (cursor position, user info).
  * Wire-format representation for JSON transport.
@@ -441,7 +510,7 @@ interface BlobChunkPushMessage {
 /**
  * Union of all sync protocol messages.
  */
-type SyncMessage = HandshakeMessage | HandshakeResponseMessage | OperationBatchMessage | AcknowledgmentMessage | ErrorMessage | AwarenessUpdateMessage | YjsDocUpdateMessage | BlobChunkRequestMessage | BlobChunkResponseMessage | BlobChunkPushMessage;
+type SyncMessage = HandshakeMessage | HandshakeResponseMessage | OperationBatchMessage | AcknowledgmentMessage | ErrorMessage | OperationRejectedMessage | AwarenessUpdateMessage | YjsDocUpdateMessage | BlobChunkRequestMessage | BlobChunkResponseMessage | BlobChunkPushMessage;
 /**
  * Check if an unknown value is a valid SyncMessage.
  */
@@ -466,6 +535,10 @@ declare function isAcknowledgmentMessage(value: unknown): value is Acknowledgmen
  * Check if a value is an ErrorMessage.
  */
 declare function isErrorMessage(value: unknown): value is ErrorMessage;
+/**
+ * Check if a value is an OperationRejectedMessage.
+ */
+declare function isOperationRejectedMessage(value: unknown): value is OperationRejectedMessage;
 /**
  * Check if a value is an AwarenessUpdateMessage.
  */
@@ -529,4 +602,4 @@ interface SyncTransport {
     isConnected(): boolean;
 }
 
-export { type AcknowledgmentMessage as A, type BlobChunkRequestMessage as B, isAwarenessUpdateMessage as C, type DeltaCursor as D, type EncryptedPayload as E, isBlobChunkPushMessage as F, isBlobChunkRequestMessage as G, type HandshakeMessage as H, InvalidScopeError as I, isBlobChunkResponseMessage as J, isErrorMessage as K, isHandshakeMessage as L, isHandshakeResponseMessage as M, isOperationBatchMessage as N, type OperationBatchMessage as O, isSyncMessage as P, type QueueStorage as Q, isYjsDocUpdateMessage as R, type SyncScopeMap as S, type TransportOptions as T, operationMatchesQuerySubsets as U, type VersionedKey as V, type WireFormat as W, type YjsDocUpdateMessage as Y, type SyncMessage as a, type SerializedOperation as b, type SyncTransport as c, type TransportMessageHandler as d, type TransportCloseHandler as e, type TransportErrorHandler as f, type BlobChunkResponseMessage as g, type BlobChunkPushMessage as h, type SyncEncryptionConfig as i, type SyncState as j, type SyncStatusInfo as k, type SyncConfig as l, type SyncStatePersistence as m, type SyncQuerySubset as n, type AwarenessStateWire as o, type AwarenessUpdateMessage as p, type ErrorMessage as q, type HandshakeResponseMessage as r, SYNC_STATES as s, SYNC_STATUSES as t, ScopeViolationError as u, type SyncEncryptionAlgorithm as v, type SyncScopeContext as w, type SyncStatus as x, dedupeQuerySubsets as y, isAcknowledgmentMessage as z };
+export { isYjsDocUpdateMessage as $, type AcknowledgmentMessage as A, type BlobChunkRequestMessage as B, dedupeQuerySubsets as C, type DeltaCursor as D, type EncryptedPayload as E, isAcknowledgmentMessage as F, isAwarenessUpdateMessage as G, type HandshakeMessage as H, InvalidScopeError as I, isBlobChunkPushMessage as J, isBlobChunkRequestMessage as K, isBlobChunkResponseMessage as L, MemoryRejectedOperationStorage as M, isErrorMessage as N, type OperationBatchMessage as O, isHandshakeMessage as P, type QueueStorage as Q, type RejectedOperationStorage as R, type SyncScopeMap as S, type TransportOptions as T, isHandshakeResponseMessage as U, type VersionedKey as V, type WireFormat as W, isOperationBatchMessage as X, type YjsDocUpdateMessage as Y, isOperationRejectedMessage as Z, isSyncMessage as _, type SyncMessage as a, operationMatchesQuerySubsets as a0, type SerializedOperation as b, type SyncTransport as c, type TransportMessageHandler as d, type TransportCloseHandler as e, type TransportErrorHandler as f, type BlobChunkResponseMessage as g, type BlobChunkPushMessage as h, type SyncEncryptionConfig as i, type SyncState as j, type SyncStatusInfo as k, type SyncConfig as l, type SyncStatePersistence as m, type SyncQuerySubset as n, type RejectedOperation as o, type AwarenessStateWire as p, type AwarenessUpdateMessage as q, type ErrorMessage as r, type HandshakeResponseMessage as s, type OperationRejectedMessage as t, SYNC_STATES as u, SYNC_STATUSES as v, ScopeViolationError as w, type SyncEncryptionAlgorithm as x, type SyncScopeContext as y, type SyncStatus as z };

package/dist/{transport-CZLMdZ0k.d.ts → transport-BGr-_eH8.d.ts}

@@ -208,6 +208,48 @@ interface QueueStorage {
     /** Return number of operations in storage */
     count(): Promise<number>;
 }
+/**
+ * A record of one outbound operation the server permanently refused. Preserved so
+ * a rejected op is explainable and reconcilable rather than silently lost.
+ */
+interface RejectedOperation {
+    /** Content-addressed id of the rejected operation. */
+    operationId: string;
+    /** Collection the operation targeted. */
+    collection: string;
+    /** Record the operation targeted. */
+    recordId: string;
+    /** Stable, machine-readable reason code from the server. */
+    code: string;
+    /** Human-readable explanation. */
+    message: string;
+    /** Whether resubmitting the identical operation may later succeed. */
+    retriable: boolean;
+    /** Wall-clock time (ms since epoch) the rejection was recorded. Display only. */
+    rejectedAt: number;
+}
+/**
+ * Interface for durably persisting operations the server rejected, so the record
+ * survives a page refresh. Keyed by operation id (idempotent on re-rejection).
+ */
+interface RejectedOperationStorage {
+    /** Record (or overwrite) a rejected operation. */
+    record(rejected: RejectedOperation): Promise<void>;
+    /** List all recorded rejected operations. */
+    list(): Promise<RejectedOperation[]>;
+    /** Remove rejected operations by their operation ids (after the app reconciles them). */
+    remove(operationIds: string[]): Promise<void>;
+}
+/**
+ * In-memory {@link RejectedOperationStorage}. The default when no durable store is
+ * provided; suitable for tests and ephemeral sessions.
+ */
+declare class MemoryRejectedOperationStorage implements RejectedOperationStorage {
+    private readonly rejected;
+    record(rejected: RejectedOperation): Promise<void>;
+    list(): Promise<RejectedOperation[]>;
+    remove(operationIds: string[]): Promise<void>;
+}
 /**
  * Thrown when an operation violates sync scope constraints.
  * This can happen when:
@@ -349,6 +391,33 @@ interface ErrorMessage {
     message: string;
     retriable: boolean;
 }
+/**
+ * Server-to-client rejection of ONE specific operation the client submitted.
+ *
+ * Unlike {@link ErrorMessage}, which is connection-level, this is tied to an
+ * `operationId` so the client can divert exactly that operation out of its
+ * pending outbound queue and into a durable rejected-operations store — kept and
+ * explainable rather than silently retried forever or lost on the batch ack. The
+ * operation never entered the server's authoritative log, so no other replica
+ * ever sees it; the submitter is told so its optimistic local copy can be
+ * reconciled (rolled back or resubmitted) by the app.
+ */
+interface OperationRejectedMessage {
+    type: 'operation-rejected';
+    messageId: string;
+    /** Content-addressed id of the rejected operation. */
+    operationId: string;
+    /** Collection the rejected operation targeted (for app routing / display). */
+    collection: string;
+    /** Record the rejected operation targeted. */
+    recordId: string;
+    /** Stable, machine-readable reason code. */
+    code: string;
+    /** Human-readable explanation. */
+    message: string;
+    /** Whether resubmitting the identical operation may later succeed. */
+    retriable: boolean;
+}
 /**
  * Awareness state for a single client (cursor position, user info).
  * Wire-format representation for JSON transport.
@@ -441,7 +510,7 @@ interface BlobChunkPushMessage {
 /**
  * Union of all sync protocol messages.
  */
-type SyncMessage = HandshakeMessage | HandshakeResponseMessage | OperationBatchMessage | AcknowledgmentMessage | ErrorMessage | AwarenessUpdateMessage | YjsDocUpdateMessage | BlobChunkRequestMessage | BlobChunkResponseMessage | BlobChunkPushMessage;
+type SyncMessage = HandshakeMessage | HandshakeResponseMessage | OperationBatchMessage | AcknowledgmentMessage | ErrorMessage | OperationRejectedMessage | AwarenessUpdateMessage | YjsDocUpdateMessage | BlobChunkRequestMessage | BlobChunkResponseMessage | BlobChunkPushMessage;
 /**
  * Check if an unknown value is a valid SyncMessage.
  */
@@ -466,6 +535,10 @@ declare function isAcknowledgmentMessage(value: unknown): value is Acknowledgmen
  * Check if a value is an ErrorMessage.
  */
 declare function isErrorMessage(value: unknown): value is ErrorMessage;
+/**
+ * Check if a value is an OperationRejectedMessage.
+ */
+declare function isOperationRejectedMessage(value: unknown): value is OperationRejectedMessage;
 /**
  * Check if a value is an AwarenessUpdateMessage.
  */
@@ -529,4 +602,4 @@ interface SyncTransport {
     isConnected(): boolean;
 }
 
-export { type AcknowledgmentMessage as A, type BlobChunkRequestMessage as B, isAwarenessUpdateMessage as C, type DeltaCursor as D, type EncryptedPayload as E, isBlobChunkPushMessage as F, isBlobChunkRequestMessage as G, type HandshakeMessage as H, InvalidScopeError as I, isBlobChunkResponseMessage as J, isErrorMessage as K, isHandshakeMessage as L, isHandshakeResponseMessage as M, isOperationBatchMessage as N, type OperationBatchMessage as O, isSyncMessage as P, type QueueStorage as Q, isYjsDocUpdateMessage as R, type SyncScopeMap as S, type TransportOptions as T, operationMatchesQuerySubsets as U, type VersionedKey as V, type WireFormat as W, type YjsDocUpdateMessage as Y, type SyncMessage as a, type SerializedOperation as b, type SyncTransport as c, type TransportMessageHandler as d, type TransportCloseHandler as e, type TransportErrorHandler as f, type BlobChunkResponseMessage as g, type BlobChunkPushMessage as h, type SyncEncryptionConfig as i, type SyncState as j, type SyncStatusInfo as k, type SyncConfig as l, type SyncStatePersistence as m, type SyncQuerySubset as n, type AwarenessStateWire as o, type AwarenessUpdateMessage as p, type ErrorMessage as q, type HandshakeResponseMessage as r, SYNC_STATES as s, SYNC_STATUSES as t, ScopeViolationError as u, type SyncEncryptionAlgorithm as v, type SyncScopeContext as w, type SyncStatus as x, dedupeQuerySubsets as y, isAcknowledgmentMessage as z };
+export { isYjsDocUpdateMessage as $, type AcknowledgmentMessage as A, type BlobChunkRequestMessage as B, dedupeQuerySubsets as C, type DeltaCursor as D, type EncryptedPayload as E, isAcknowledgmentMessage as F, isAwarenessUpdateMessage as G, type HandshakeMessage as H, InvalidScopeError as I, isBlobChunkPushMessage as J, isBlobChunkRequestMessage as K, isBlobChunkResponseMessage as L, MemoryRejectedOperationStorage as M, isErrorMessage as N, type OperationBatchMessage as O, isHandshakeMessage as P, type QueueStorage as Q, type RejectedOperationStorage as R, type SyncScopeMap as S, type TransportOptions as T, isHandshakeResponseMessage as U, type VersionedKey as V, type WireFormat as W, isOperationBatchMessage as X, type YjsDocUpdateMessage as Y, isOperationRejectedMessage as Z, isSyncMessage as _, type SyncMessage as a, operationMatchesQuerySubsets as a0, type SerializedOperation as b, type SyncTransport as c, type TransportMessageHandler as d, type TransportCloseHandler as e, type TransportErrorHandler as f, type BlobChunkResponseMessage as g, type BlobChunkPushMessage as h, type SyncEncryptionConfig as i, type SyncState as j, type SyncStatusInfo as k, type SyncConfig as l, type SyncStatePersistence as m, type SyncQuerySubset as n, type RejectedOperation as o, type AwarenessStateWire as p, type AwarenessUpdateMessage as q, type ErrorMessage as r, type HandshakeResponseMessage as s, type OperationRejectedMessage as t, SYNC_STATES as u, SYNC_STATUSES as v, ScopeViolationError as w, type SyncEncryptionAlgorithm as x, type SyncScopeContext as y, type SyncStatus as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@korajs/sync",
-  "version": "1.0.0-beta.1",
+  "version": "1.0.0-beta.2",
   "description": "Sync protocol and transports for Kora.js with delta sync, causal ordering, and automatic reconnection",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -34,8 +34,8 @@
   ],
   "dependencies": {
     "protobufjs": "^8.0.1",
-    "@korajs/core": "1.0.0-beta.1",
-    "@korajs/merge": "1.0.0-beta.1"
+    "@korajs/core": "1.0.0-beta.2",
+    "@korajs/merge": "1.0.0-beta.2"
   },
   "devDependencies": {
     "@fast-check/vitest": "0.2.0",