@evolu/common 8.16.0 → 8.18.0

package/dist/src/local-first/Protocol.d.ts

@@ -43,14 +43,24 @@
  * | - {@link NonNegativeInt}       | Number of ranges.         |
  * | - {@link Range}                |                           |
  *
+ * Range upper bounds must not decrease. The last range always has
+ * {@link InfiniteUpperBound}, which is not encoded. A message with decreasing
+ * bounds, or with a hasWriteKey or subscriptionFlag value not listed above, is
+ * rejected as {@link ProtocolInvalidDataError}. So is a request with a change
+ * shorter than 41 bytes, the smallest {@link EncryptedDbChange}. A client passes
+ * such a change to storage, which skips a change it cannot read.
+ *
  * ## WriteKey validation
  *
  * The initiator sends a hasWriteKey flag and optionally a WriteKey. The
  * WriteKey is required when sending messages as a secure token proving the
  * initiator can write changes. It's ok to not send a WriteKey if the initiator
  * is only syncing (read-only) and not sending messages. The non-initiator
- * validates the WriteKey immediately after parsing the initiator header, before
- * processing any messages or ranges.
+ * decodes the whole request first and then validates the WriteKey, before
+ * storing any messages or reconciling ranges. Only the subscriptionFlag takes
+ * effect before that, because subscribing needs no WriteKey: broadcasts carry
+ * only encrypted changes. So a request rejected with
+ * {@link ProtocolWriteKeyError} still changes its subscription.
  *
  * ## Synchronization
  *
@@ -64,9 +74,14 @@
  * if further sync is needed or possible, continuing until both sides are
  * synchronized.
  *
- * The **non-initiator always responds** to provide sync completion feedback,
- * even with empty messages containing only the header and no error. This allows
- * the initiator to detect when synchronization is complete.
+ * The **non-initiator answers every request it can decode** to provide sync
+ * completion feedback, even with empty messages containing only the header and
+ * no error. This allows the initiator to detect when synchronization is
+ * complete. A request it cannot decode, or one larger than the relay's
+ * `totalMaxSize`, gets no answer and has no effect.
+ *
+ * Ranges are compared by their {@link Fingerprint}, which anyone who can write
+ * for an owner can make collide. Its documentation describes the consequences.
  *
  * Both **Messages** and **Ranges** are optional, allowing each side to send,
  * sync, or only subscribe data as needed.
@@ -81,18 +96,35 @@
  *
  * ## Protocol errors
  *
- * The protocol uses error codes in the header to signal issues:
+ * A Response carries a {@link ProtocolErrorCode} in its header. The initiator
+ * reports every code except `NoError` as an error with the `OwnerId`:
  *
- * - {@link ProtocolWriteKeyError}: The provided WriteKey is invalid or missing.
- * - {@link ProtocolWriteError}: A serious relay-side write failure occurred.
+ * - {@link ProtocolWriteKeyError}: The WriteKey is invalid, or missing from a
+ *   request with messages.
+ * - {@link ProtocolWriteError}: The relay failed to store the messages or to
+ *   validate the WriteKey.
  * - {@link ProtocolQuotaError}: Storage or billing quota exceeded.
- * - {@link ProtocolSyncError}: A serious relay-side synchronization failure
- *   occurred.
- * - {@link ProtocolVersionError}: Protocol version mismatch.
- * - {@link ProtocolInvalidDataError}: The message is malformed or corrupted.
- *
- * All protocol errors except `ProtocolInvalidDataError` include the `OwnerId`
- * to allow clients to associate errors with the correct owner.
+ * - {@link ProtocolSyncError}: The relay's storage failed while it reconciled the
+ *   ranges.
+ *
+ * The initiator also reports {@link ProtocolVersionError}, with the `OwnerId`,
+ * for a reply of another version, and {@link ProtocolInvalidDataError}, without
+ * it, for a message it cannot decode, including one with an unknown code.
+ *
+ * A relay answers every request it can decode within its `totalMaxSize`. It
+ * decodes a whole request before acting on it, so for a malformed one it
+ * returns `ProtocolInvalidDataError` without subscribing, storing, or
+ * broadcasting anything, and sends no reply. When its storage throws while
+ * validating the WriteKey, for example because SQLite cannot store a new
+ * owner's key on a full disk, the relay logs the error and answers with
+ * `ProtocolWriteError`, like a failed write. Likewise, a client applies nothing
+ * from a message it cannot decode.
+ *
+ * {@link decryptAndDecodeDbChange} returns `ProtocolInvalidDataError`,
+ * {@link ProtocolTimestampMismatchError}, or
+ * {@link DecryptWithXChaCha20Poly1305Error} for a change it cannot read. These
+ * describe a change rather than a protocol message, and client storage skips
+ * such a change.
  *
  * ## Message size limit
  *
@@ -105,7 +137,10 @@
  *
  * Each mutation is limited to {@link maxMutationSize}, so every change fits one
  * message of {@link defaultProtocolMessageMaxSize} next to the largest ranges
- * section.
+ * section. Changes saved before that limit existed, and crafted changes a relay
+ * stores, can be larger. Sync skips a stored change that cannot fit an empty
+ * message after a pending Skip range, which is the message a later round is
+ * guaranteed to reach, and reports it as a {@link ProtocolChangeTooLargeError}.
  *
  * ## Why Binary?
  *
@@ -129,24 +164,18 @@
  *
  * ## Versioning
  *
- * Evolu Protocol uses explicit versioning to ensure compatibility between
- * clients and relays (or peers). Each protocol message begins with a version
- * number and an `ownerId` in its header.
- *
- * **How version negotiation works:**
+ * Every message of every protocol version begins with the version and the
+ * `OwnerId`, so a peer can route and report a message of any version. Nothing
+ * negotiates a version, and no side falls back to the other's.
  *
- * - The initiator (usually a client) sends a `ProtocolMessage` that includes its
- *   protocol version and the `ownerId`.
- * - The non-initiator (usually a relay or peer) checks the version.
- *
- *   - If the versions match, synchronization proceeds as normal.
- *   - If the versions do not match, the non-initiator responds with a message
- *       containing **its own protocol version and the same `ownerId`**.
- * - The initiator can then detect the version mismatch for that specific owner
- *   and handle it appropriately (e.g., prompt for an update or halt sync).
- *
- * Version negotiation is per-owner, allowing Evolu Protocol to evolve safely
- * over time and provide clear feedback about version mismatches.
+ * A non-initiator answers a request of another version with only its own
+ * version and that `OwnerId`. The initiator reports it as
+ * {@link ProtocolVersionError} for that owner, whose `isInitiator` tells which
+ * side is older, and stops syncing the owner through that relay. Clients from
+ * `@evolu/common` 8.0.0 before 8.11.0 drop that reply and stop syncing the
+ * owner through that relay without reporting anything, while 7.x clients report
+ * it as a `ProtocolVersionError`. So a relay that moves to another version must
+ * keep answering version 1 while such clients remain.
  *
  * ## Credible exit
  *
@@ -180,33 +209,38 @@ import { type DecryptWithXChaCha20Poly1305Error, EncryptionKey, type RandomBytes
 import { type Result } from "../Result.ts";
 import type { SqliteValue } from "../Sqlite.ts";
 import { type Task } from "../Task.ts";
-import { NonNegativeInt, PositiveInt, type Typed } from "../Type.ts";
+import { NonNegativeInt, type PositiveInt, type Typed } from "../Type.ts";
 import { type Owner, type OwnerError, OwnerId, OwnerWriteKey } from "./Owner.ts";
 import { type BaseRange, type CrdtMessage, DbChange, type EncryptedCrdtMessage, type EncryptedDbChange, type FingerprintRange, RangeType, type SkipRange, type StorageDep, type StorageWriteMessagesError } from "./Storage.ts";
 import { Timestamp } from "./Timestamp.ts";
 /**
- * Protocol message maximum size.
- *
- * Defines the upper limit for how large a single protocol message can be.
- * Implementations must enforce a maximum size between 1MB and 100MB to ensure
- * compatibility across all Evolu implementations (the maximum size of mutation
- * change is hardcoded and enforced hence the maximum size can't be smaller).
- *
- * Larger maximum sizes can be configured by relays to reduce roundtrips. For
- * example, a dedicated relay with ample resources could configure a 100MB
- * maximum to minimize roundtrips for large syncs.
- *
- * Only relays can safely configure larger sizes, as clients will handle them.
- * Increasing this value on the client side would break compatibility with
- * relays that enforce smaller limits.
+ * Protocol message maximum size, from 1MB to 100MB.
+ *
+ * A message never exceeds its maximum size, inclusive. Builders measure each
+ * write exactly and keep room to close the message (see
+ * {@link ProtocolMessageBuffer.tryWrite}), and sync sends what does not fit in
+ * later rounds.
+ *
+ * Clients send at most {@link defaultProtocolMessageMaxSize} and enforce no
+ * receive limit. A relay can answer with larger messages, configured with the
+ * `totalMaxSize` option of {@link applyProtocolMessageAsRelay}, to reduce
+ * roundtrips for large syncs. Clients must not send larger messages, because
+ * relays accept at most the default: the Node.js relay closes the connection on
+ * a larger one, and relays up to `@evolu/nodejs` 4.0.0 crash on it.
+ *
+ * The default cannot be smaller either. Deployed clients send messages of that
+ * size, a change within {@link maxMutationSize} fits one message next to the
+ * largest ranges section, and changes saved before that limit existed, which
+ * can be nearly as large as a message, must stay servable.
  */
 export declare const ProtocolMessageMaxSize: import("../Type.ts").BrandType<import("../Type.ts").BrandType<import("../Type.ts").BrandType<import("../Type.ts").BrandType<import("../Type.ts").Type<"Number", number, number, import("../Type.ts").TypeOfError<"Number">, null, import("../Type.ts").TypeOfError<"Number">, never, number, true>, "NonNaN", import("../Type.ts").NonNaNError>, "Finite", import("../Type.ts").FiniteError>, "Int", import("../Type.ts").IntError>, "Between1000000-100000000", import("../Type.ts").BetweenError<1000000, 100000000>>;
 export type ProtocolMessageMaxSize = typeof ProtocolMessageMaxSize.Output;
 /**
  * Default {@link ProtocolMessageMaxSize} (1MB).
  *
- * The standard size used across Evolu implementations. Relays with more
- * resources can configure larger sizes to reduce roundtrips.
+ * The standard size used across Evolu implementations. Clients send at most
+ * this size, and relays accept it. Relays with more resources can answer with
+ * larger messages to reduce roundtrips.
  */
 export declare const defaultProtocolMessageMaxSize: ProtocolMessageMaxSize;
 /**
@@ -218,7 +252,8 @@ export declare const defaultProtocolMessageMaxSize: ProtocolMessageMaxSize;
  *
  * The upper bound is set to ensure ranges fit within the default 1MB
  * {@link defaultProtocolMessageMaxSize}, maintaining compatibility between all
- * clients and relays.
+ * clients and relays. A received message whose ranges section exceeds twice the
+ * upper bound is rejected as {@link ProtocolInvalidDataError}.
  */
 export declare const ProtocolMessageRangesMaxSize: import("../Type.ts").BrandType<import("../Type.ts").BrandType<import("../Type.ts").BrandType<import("../Type.ts").BrandType<import("../Type.ts").Type<"Number", number, number, import("../Type.ts").TypeOfError<"Number">, null, import("../Type.ts").TypeOfError<"Number">, never, number, true>, "NonNaN", import("../Type.ts").NonNaNError>, "Finite", import("../Type.ts").FiniteError>, "Int", import("../Type.ts").IntError>, "Between3000-100000", import("../Type.ts").BetweenError<3000, 100000>>;
 export type ProtocolMessageRangesMaxSize = typeof ProtocolMessageRangesMaxSize.Output;
@@ -273,6 +308,14 @@ export declare const SubscriptionFlags: {
     readonly Unsubscribe: 2;
 };
 export type SubscriptionFlag = (typeof SubscriptionFlags)[keyof typeof SubscriptionFlags];
+/**
+ * The error code in the header of a Response.
+ *
+ * A client reports a code it does not know as {@link ProtocolInvalidDataError},
+ * which carries no `OwnerId`, and that relay's round for the owner ends. Every
+ * released client does this, so a relay can add a code under the same
+ * {@link protocolVersion} only where that outcome is acceptable.
+ */
 export declare const ProtocolErrorCode: {
     readonly NoError: 0;
     /** A code for {@link ProtocolWriteKeyError}. */
@@ -284,7 +327,7 @@ export declare const ProtocolErrorCode: {
     /** A code for {@link ProtocolSyncError}. */
     readonly SyncError: 4;
 };
-type ProtocolErrorCode = (typeof ProtocolErrorCode)[keyof typeof ProtocolErrorCode];
+export type ProtocolErrorCode = (typeof ProtocolErrorCode)[keyof typeof ProtocolErrorCode];
 export type ProtocolError = ProtocolVersionError | ProtocolInvalidDataError | ProtocolWriteKeyError | ProtocolWriteError | ProtocolSyncError | ProtocolQuotaError | ProtocolTimestampMismatchError;
 /**
  * Represents a version mismatch in the Evolu Protocol. Occurs when the
@@ -295,7 +338,16 @@ export interface ProtocolVersionError extends OwnerError, Typed<"ProtocolVersion
     /** Indicates which side is obsolete and should update. */
     readonly isInitiator: boolean;
 }
-/** Error for invalid or corrupted protocol message data. */
+/**
+ * Error for a malformed {@link ProtocolMessage} or {@link EncryptedDbChange},
+ * with its bytes as `data` and the decoding error as `error`.
+ *
+ * A protocol message is decoded whole before any of it is applied, so a
+ * malformed one has no effect, and a relay does not reply to it. A message of a
+ * type its receiver does not accept, such as a Request sent to a client, is
+ * malformed too. A throw while applying a decoded message is a defect, not this
+ * error.
+ */
 export interface ProtocolInvalidDataError extends Typed<"ProtocolInvalidDataError"> {
     readonly data: Uint8Array;
     readonly error: unknown;
@@ -342,12 +394,39 @@ export interface ProtocolTimestampMismatchError extends Typed<"ProtocolTimestamp
     readonly expected: Timestamp;
     readonly timestamp: Timestamp;
 }
+/**
+ * Error for a stored change that sync skipped because it cannot fit an empty
+ * {@link ProtocolMessage} after a pending Skip range, which is the message a
+ * later round is guaranteed to reach.
+ *
+ * Every change within {@link maxMutationSize} fits. Larger ones are changes
+ * saved before that limit existed and crafted changes a relay stores. A change
+ * up to 22 bytes too large for that message can still fit one without a pending
+ * skip, so sync may send it, sometimes after reporting it, but usually reports
+ * it in every sync like a larger one. With
+ * {@link defaultProtocolMessageMaxSize}, PADMÉ padding leaves no honest change
+ * size in that 22-byte window.
+ *
+ * An answer to a Timestamps range neither sends nor lists a skipped change, so
+ * range fingerprints keep disagreeing about it. A request or a split still
+ * lists its timestamp, so a peer that lacks it may ask for it once per sync and
+ * gets an answer without it. Every sync narrows the fingerprints to it, skips
+ * it again, and ends.
+ */
+export interface ProtocolChangeTooLargeError extends Typed<"ProtocolChangeTooLargeError"> {
+    readonly timestamp: Timestamp;
+    /** The length of the encrypted change in bytes. */
+    readonly size: PositiveInt;
+}
 /**
  * Creates a {@link ProtocolMessage} from CRDT messages.
  *
- * If the message size would exceed {@link defaultProtocolMessageMaxSize}, the
- * protocol ensures all messages will be sent in the next round(s) even over
- * unidirectional and stateless transports.
+ * The message holds the leading CRDT messages that fit `maxSize`, by default
+ * {@link defaultProtocolMessageMaxSize}, measured exactly. When one does not
+ * fit, it and the rest are left out, and the message ends with a range that
+ * makes the non-initiator answer with ranges. Sync then sends them in later
+ * rounds, even over unidirectional and stateless transports, because every
+ * change within {@link maxMutationSize} fits an empty message.
  */
 export declare const createProtocolMessageFromCrdtMessages: (deps: RandomBytesDep) => (owner: Owner, messages: NonEmptyReadonlyArray<CrdtMessage>, maxSize?: ProtocolMessageMaxSize) => ProtocolMessage;
 /**
@@ -396,14 +475,37 @@ export declare const createProtocolMessageForUnsubscribe: (ownerId: OwnerId) =>
 /**
  * Mutable builder for constructing {@link ProtocolMessage} respecting size
  * limits.
+ *
+ * A frame never exceeds `totalMaxSize`. Make ordinary writes inside `tryWrite`,
+ * which keeps them only if the frame can still be closed. A write outside a
+ * trial is a closing write: `addMessage` and `addRange` assert that the frame
+ * fits `totalMaxSize`.
+ *
+ * The builder references each change, which `unwrap` copies into the frame it
+ * returns, so a change must not be modified while the builder is in use.
+ * `unwrap` leaves the builder unchanged, so it can be called again.
  */
 export interface ProtocolMessageBuffer {
-    readonly canAddMessage: (message: EncryptedCrdtMessage) => boolean;
     readonly addMessage: (message: EncryptedCrdtMessage) => void;
-    readonly canSplitRange: () => boolean;
-    readonly canAddTimestampsRangeAndMessage: (timestamps: TimestampsBuffer, message: EncryptedCrdtMessage | null) => boolean;
     readonly addRange: (range: SkipRange | FingerprintRange | TimestampsRangeWithTimestampsBuffer) => void;
+    /**
+     * Runs `write` and keeps what it wrote only if the frame can still be closed,
+     * returning whether it was kept.
+     *
+     * The frame can be closed when its exact size plus the bytes needed to append
+     * one Fingerprint range with {@link InfiniteUpperBound} plus `reserve` is at
+     * most `totalMaxSize`, and its ranges section plus the same bytes is at most
+     * `rangesMaxSize`. Nothing is needed to close a broadcast, which holds no
+     * ranges, or a frame whose last range has InfiniteUpperBound. Use `reserve`
+     * for bytes the caller adds later, such as a range it is still collecting.
+     *
+     * When the frame cannot be closed, or `write` throws, everything `write`
+     * wrote is undone, so the frame is as if `write` never ran. Inside `write`,
+     * `addMessage` and `addRange` do not assert the size limit.
+     */
+    readonly tryWrite: (write: () => void, reserve?: NonNegativeInt) => boolean;
     readonly unwrap: () => ProtocolMessage;
+    /** Returns the exact encoded size of the frame. */
     readonly getSize: () => PositiveInt;
 }
 export declare const createProtocolMessageBuffer: (ownerId: OwnerId, options: {
@@ -430,13 +532,28 @@ export interface TimestampsBuffer {
     readonly getCount: () => NonNegativeInt;
     readonly getLength: () => number;
     readonly append: (buffer: Buffer) => void;
+    /**
+     * Returns a function that restores the buffer, in constant time, to the state
+     * it had when this was called, discarding every timestamp added since.
+     *
+     * A restore function can be called repeatedly. It is valid until the buffer
+     * is restored to an earlier checkpoint.
+     */
+    readonly checkpoint: () => () => void;
 }
 export declare const createTimestampsBuffer: () => TimestampsBuffer;
 export interface ApplyProtocolMessageAsClientOptions {
-    writeKey?: OwnerWriteKey;
-    rangesMaxSize?: ProtocolMessageRangesMaxSize;
+    readonly writeKey?: OwnerWriteKey;
+    readonly rangesMaxSize?: ProtocolMessageRangesMaxSize;
+    /**
+     * Called for each stored change that sync skipped as a
+     * {@link ProtocolChangeTooLargeError}. Without it, the error is logged with
+     * `console.warn`. It must not throw, because a throw is a defect that aborts
+     * the Run.
+     */
+    readonly onChangeTooLarge?: (error: ProtocolChangeTooLargeError) => void;
     /** For tests only. */
-    version?: NonNegativeInt;
+    readonly version?: NonNegativeInt;
 }
 /**
  * Result of {@link applyProtocolMessageAsClient}: a continuation for the
@@ -469,34 +586,48 @@ export interface ApplyProtocolMessageAsClientReadonly extends Typed<"Readonly">
  * Result of {@link applyProtocolMessageAsClient}: the protocol logged an
  * exception thrown by calling the storage's `writeMessages` (`Write`) or a
  * failed range reconciliation (`Sync`) to the console. An exception while the
- * returned Task runs, as the built-in storages throw, is a defect that aborts
- * the Run instead. Expected write rejections return the original
- * {@link StorageWriteMessagesError} through {@link Result}. Reconciliation can
- * fail after messages have been committed; that failure does not roll back the
- * write.
+ * returned Task runs is a defect that aborts the Run instead. A rejected or
+ * failed write, which the built-in storages return when SQLite fails it, gives
+ * the original {@link StorageWriteMessagesError} through {@link Result}.
+ * Reconciliation can fail after messages have been committed; that failure does
+ * not roll back the write.
  */
 export interface ApplyProtocolMessageAsClientFailed extends Typed<"Failed"> {
     readonly cause: "Write" | "Sync";
 }
 export type ApplyProtocolMessageAsClientResult = ApplyProtocolMessageAsClientResponse | ApplyProtocolMessageAsClientConverged | ApplyProtocolMessageAsClientBroadcast | ApplyProtocolMessageAsClientReadonly | ApplyProtocolMessageAsClientFailed;
 export declare const applyProtocolMessageAsClient: (inputMessage: Uint8Array, options?: ApplyProtocolMessageAsClientOptions) => Task<ApplyProtocolMessageAsClientResult, ProtocolError | StorageWriteMessagesError, StorageDep>;
+/**
+ * Options for {@link applyProtocolMessageAsRelay}. The callbacks must not throw,
+ * because a throw is a defect that aborts the Run.
+ */
 export interface ApplyProtocolMessageAsRelayOptions {
     /** To subscribe an owner for broadcasting. */
-    subscribe?: (ownerId: OwnerId) => void;
+    readonly subscribe?: (ownerId: OwnerId) => void;
     /** To unsubscribe an owner from broadcasting. */
-    unsubscribe?: (ownerId: OwnerId) => void;
+    readonly unsubscribe?: (ownerId: OwnerId) => void;
     /** To broadcast a protocol message to all subscribers. */
-    broadcast?: (ownerId: OwnerId, message: ProtocolMessage) => void;
-    totalMaxSize?: ProtocolMessageMaxSize;
-    rangesMaxSize?: ProtocolMessageRangesMaxSize;
+    readonly broadcast?: (ownerId: OwnerId, message: ProtocolMessage) => void;
+    /**
+     * The maximum size of the relay's responses and broadcasts, and of the
+     * requests it accepts. A larger request is a
+     * {@link ProtocolInvalidDataError}.
+     */
+    readonly totalMaxSize?: ProtocolMessageMaxSize;
+    readonly rangesMaxSize?: ProtocolMessageRangesMaxSize;
 }
 /**
  * Result type for {@link applyProtocolMessageAsRelay}.
  *
- * Unlike {@link ApplyProtocolMessageAsClientResult}, relays always respond with
- * a message to provide sync completion feedback. This ensures the initiator can
- * reliably detect when synchronization is complete, even when there's nothing
- * to sync. Clients may choose not to respond in certain cases (like when they
+ * Unlike {@link ApplyProtocolMessageAsClientResult}, a relay answers every
+ * request it can decode within its `totalMaxSize` to provide sync completion
+ * feedback. This ensures the initiator can reliably detect when synchronization
+ * is complete, even when there's nothing to sync. A storage that throws while
+ * validating the write key is answered with a `WriteError` code, like a failed
+ * write. For a larger request or one it cannot decode,
+ * {@link applyProtocolMessageAsRelay} returns {@link ProtocolInvalidDataError}
+ * before subscribing, storing, or broadcasting anything, and the relay sends
+ * nothing. Clients may choose not to respond in certain cases (like when they
  * receive broadcast messages or when they lack a write key for syncing).
  */
 export interface ApplyProtocolMessageAsRelayResult extends Typed<"Response"> {
@@ -509,9 +640,11 @@ version?: NonNegativeInt) => Task<ApplyProtocolMessageAsRelayResult, ProtocolInv
  * Encodes and encrypts a {@link DbChange} using the provided owner's encryption
  * key. Returns an encrypted binary representation as {@link EncryptedDbChange}.
  *
- * The format includes the protocol version for backward compatibility and the
- * timestamp for tamper-proof verification that the timestamp matches the change
- * data.
+ * The plaintext starts with the format version of the change, which is
+ * independent of {@link protocolVersion}, and the timestamp, which proves that
+ * the change belongs to the timestamp it is sent with.
+ * {@link decryptAndDecodeDbChange} rejects a newer format version and accepts
+ * older ones.
  */
 export declare const encodeAndEncryptDbChange: (deps: RandomBytesDep) => (message: CrdtMessage, key: EncryptionKey) => EncryptedDbChange;
 /**
@@ -527,21 +660,11 @@ export declare const encodeDbChange: (buffer: Buffer, message: CrdtMessage) => v
  * Decrypts and decodes an {@link EncryptedCrdtMessage} using the provided
  * owner's encryption key. Verifies that the embedded timestamp matches the
  * expected timestamp to ensure message integrity.
- */
-export declare const decryptAndDecodeDbChange: (message: EncryptedCrdtMessage, key: EncryptionKey) => Result<DbChange, DecryptWithXChaCha20Poly1305Error | ProtocolInvalidDataError | ProtocolTimestampMismatchError>;
-/**
- * Decodes a ProtocolMessage into a readable JSON object for debugging.
- *
- * Note: This is a stub for future implementation. It should use:
  *
- * - DecodeVersionAndOwner
- * - DecodeError or decodeWriteKeys (depending on context)
- * - DecodeMessages
- * - DecodeRanges
- *
- * If you want to help, please contribute to this function.
+ * A change with a newer format version than {@link encodeAndEncryptDbChange}
+ * writes is a {@link ProtocolInvalidDataError}.
  */
-export declare const decodeProtocolMessageToJson: (_protocolMessage: ProtocolMessage, _isInitiator: boolean) => unknown;
+export declare const decryptAndDecodeDbChange: (message: EncryptedCrdtMessage, key: EncryptionKey) => Result<DbChange, DecryptWithXChaCha20Poly1305Error | ProtocolInvalidDataError | ProtocolTimestampMismatchError>;
 export declare const ProtocolValueType: {
     readonly String: number & Brand<"NonNaN"> & Brand<"Finite"> & Brand<"Int"> & Brand<"NonNegative">;
     readonly Number: number & Brand<"NonNaN"> & Brand<"Finite"> & Brand<"Int"> & Brand<"NonNegative">;
@@ -557,5 +680,4 @@ export declare const ProtocolValueType: {
 };
 export declare const encodeSqliteValue: (buffer: Buffer, value: SqliteValue) => void;
 export declare const decodeSqliteValue: (buffer: Buffer) => SqliteValue;
-export {};
 //# sourceMappingURL=Protocol.d.ts.map

package/dist/src/local-first/Protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Protocol.d.ts","sourceRoot":"","sources":["../../../src/local-first/Protocol.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Protocol.d.ts","sourceRoot":"","sources":["../../../src/local-first/Protocol.ts"],"names":[],"mappings":"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"}