@evolu/common 5.4.7 → 6.0.0

package/dist/src/Evolu/Owner.d.ts.map

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

package/dist/src/Evolu/Owner.js

@@ -0,0 +1,126 @@
+import { assert } from "../Assert.js";
+import { createEncryptionKey, createSlip21, createSlip21Id, mnemonicToMnemonicSeed, } from "../Crypto.js";
+import { brand, DateIso, Id, length, Uint8Array, } from "../Type.js";
+import { createInitialTimestamp, timestampToTimestampString, } from "./Timestamp.js";
+/**
+ * The unique identifier of {@link Owner} derived from the {@link Mnemonic}.
+ *
+ * This branded {@link Id} type, generated by {@link createSlip21Id}, is a
+ * 21-character {@link Base64Url} string (126 bits of entropy), providing a
+ * compact, shareable, and secure identifier for UI use, tied to the owner's
+ * mnemonic and derivation path.
+ */
+export const OwnerId = brand("OwnerId", Id);
+export const writeKeyLength = 16;
+/**
+ * A secure token proving the initiator can write changes. Derived from a
+ * mnemonic or randomly generated. It's rotatable.
+ */
+export const WriteKey = brand("WriteKey", length(writeKeyLength)(Uint8Array));
+/**
+ * Creates an {@link AppOwner}, optionally from an existing mnemonic to restore
+ * it on another device; otherwise, generates a new mnemonic.
+ */
+export const createAppOwner = (deps) => (mnemonic = deps.createMnemonic()) => {
+    const owner = createOwner(deps)(mnemonic);
+    return { type: "AppOwner", ...owner };
+};
+/**
+ * Creates a {@link ShardOwner} for sharding app data with a freshly generated
+ * mnemonic. Unlike {@link createAppOwner}, it doesn’t accept an existing
+ * mnemonic because ShardOwner mnemonics are always generated and restored
+ * automatically via database sync.
+ */
+export const createShardOwner = (deps) => {
+    const owner = createOwner(deps)();
+    return {
+        type: "ShardOwner",
+        mnemonic: owner.mnemonic,
+        writeKey: owner.writeKey,
+    };
+};
+/**
+ * Creates a fresh {@link SharedOwner} for sharing data with write access. Takes
+ * no arguments as both `mnemonic` and rotatable `writeKey` are newly generated;
+ * when shared, recipients use the provided `mnemonic` and `writeKey` directly
+ * as a {@link SharedOwner} without needing to recreate it.
+ */
+export const createSharedOwner = (deps) => {
+    const mnemonic = deps.createMnemonic();
+    const writeKey = createWriteKey(deps)(); // Random, no seed
+    return {
+        type: "SharedOwner",
+        mnemonic,
+        writeKey,
+    };
+};
+/**
+ * Creates a {@link SharedReadonlyOwner} from a {@link SharedOwner} for read-only
+ * data sharing. Extracts the `mnemonic` from the provided {@link SharedOwner},
+ * omitting its `writeKey` to ensure read-only access.
+ */
+export const createSharedReadonlyOwner = (sharedOwner) => {
+    return {
+        type: "SharedReadonlyOwner",
+        mnemonic: sharedOwner.mnemonic,
+    };
+};
+/** Creates an {@link Owner} with optional `mnemonic` and `writeKey`. */
+export const createOwner = (deps) => (mnemonic = deps.createMnemonic(), writeKey) => {
+    const seed = mnemonicToMnemonicSeed(mnemonic);
+    const id = createSlip21Id(seed, ["Evolu", "Owner Id"]);
+    const encryptionKey = createEncryptionKey(seed);
+    const createdAt = DateIso.fromParent(new Date(deps.time.now()));
+    assert(createdAt.ok, "Invalid DateIso: bad system clock");
+    return {
+        mnemonic,
+        createdAt: createdAt.value,
+        id,
+        encryptionKey,
+        writeKey: writeKey ?? createWriteKey(deps)(seed),
+    };
+};
+export const createWriteKey = (deps) => (seed) => {
+    const key = seed
+        ? createSlip21(seed, ["Evolu", "Write Key"]).slice(0, 16)
+        : deps.createRandomBytes(16);
+    const writeKey = WriteKey.from(key);
+    assert(writeKey.ok, "Ensure valid WriteKey");
+    return writeKey.value;
+};
+/**
+ * Creates an {@link OwnerRow} from any {@link Owner} variant for the
+ * `evolu_owner` table, adding a `timestamp` ({@link TimestampString}) for CRDT
+ * sync.
+ */
+export const createOwnerRow = (deps) => (owner) => {
+    const timestamp = timestampToTimestampString(createInitialTimestamp(deps));
+    switch (owner.type) {
+        case "AppOwner": {
+            const { type, ...rest } = owner;
+            return { ...rest, timestamp };
+        }
+        case "ShardOwner":
+        case "SharedOwner":
+            return {
+                ...createOwner(deps)(owner.mnemonic, owner.writeKey),
+                timestamp,
+            };
+        case "SharedReadonlyOwner":
+            return {
+                ...createOwner(deps)(owner.mnemonic),
+                writeKey: null,
+                timestamp,
+            };
+    }
+};
+/**
+ * Rotates the {@link WriteKey} for an {@link AppOwner}, {@link ShardOwner}, or
+ * {@link SharedOwner}, returning a new instance with the updated key.
+ */
+export const rotateWriteKey = (owner, newWriteKey) => {
+    return {
+        ...owner,
+        writeKey: newWriteKey,
+    };
+};

package/dist/src/Evolu/Platform.d.ts

@@ -0,0 +1,23 @@
+import { Config } from "./Config.js";
+/**
+ * FlushSync is for libraries like React to flush updates synchronously inside
+ * the provided callback to ensure the DOM is updated immediately.
+ *
+ * For example, with React, when we want to focus on an element rendered as a
+ * result of a mutation, Evolu ensures all DOM changes are flushed synchronously
+ * if an onComplete callback is used.
+ *
+ * https://react.dev/reference/react-dom/flushSync
+ */
+export type FlushSync = (callback: () => void) => void;
+export interface FlushSyncDep {
+    readonly flushSync: FlushSync;
+}
+export interface AppState {
+    readonly reset: () => void;
+}
+export type CreateAppState = (config: Config) => AppState;
+export interface CreateAppStateDep {
+    readonly createAppState: CreateAppState;
+}
+//# sourceMappingURL=Platform.d.ts.map

package/dist/src/Evolu/Platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Platform.d.ts","sourceRoot":"","sources":["../../../src/Evolu/Platform.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC;;;;;;;;;GASG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;AAEvD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;CAC5B;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,QAAQ,CAAC;AAE1D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;CACzC"}

package/dist/src/Evolu/Platform.js

@@ -0,0 +1 @@
+export {};

package/dist/src/Evolu/Protocol.d.ts

@@ -0,0 +1,401 @@
+/**
+ * Evolu Protocol
+ *
+ * Evolu Protocol is a local-first, end-to-end encrypted binary synchronization
+ * protocol optimized for minimal size and maximum speed. It enables data sync
+ * between a client and a relay, clients in a peer-to-peer (P2P) setup, or
+ * relays with each other.
+ *
+ * Evolu Protocol is designed for SQLite but can be extended to any database. It
+ * implements [Range-Based Set Reconciliation](https://arxiv.org/abs/2212.13567)
+ * by Aljoscha Meyer.
+ *
+ * To learn how RBSR works, check
+ * [Negentropy](https://logperiodic.com/rbsr.html). Evolu Protocol is similar to
+ * Negentropy but uses different encoding and also provides data transfer and
+ * ownership.
+ *
+ * ### Message Structure
+ *
+ * | Field                          | Notes                      |
+ * | :----------------------------- | :------------------------- |
+ * | **Header**                     |                            |
+ * | - {@link protocolVersion}      |                            |
+ * | - {@link OwnerId}              |                            |
+ * | - {@link ProtocolErrorCode}    | In non-initiator response. |
+ * | **Messages**                   |                            |
+ * | - {@link NonNegativeInt}       | A number of messages.      |
+ * | - {@link EncryptedCrdtMessage} |                            |
+ * | - {@link WriteKey}             | In initiator request.      |
+ * | **Ranges**                     |                            |
+ * | - {@link NonNegativeInt}       | Number of ranges.          |
+ * | - {@link Range}                |                            |
+ *
+ * Every protocol message belongs to an owner.
+ *
+ * ### Synchronization
+ *
+ * - **Messages**: Sends {@link EncryptedCrdtMessage}s in either direction.
+ * - **Ranges**: Determines messages to sync. Usage varies by transport—e.g., sent
+ *   only on WebSocket connection open or with every fetch request.
+ *
+ * Synchronization involves an initiator and a non-initiator. The **initiator**
+ * is typically a client, and the **non-initiator** is typically a relay. Each
+ * side processes the received message and responds with a new `ProtocolMessage`
+ * if further sync is needed or possible, continuing until both sides are
+ * synchronized.
+ *
+ * Both **Messages** and **Ranges** are optional, allowing each side to send,
+ * sync, or only subscribe data as needed.
+ *
+ * When the initiator sends data, the {@link WriteKey} is **required** in
+ * **Messages** as a secure token proving the initiator can write changes. The
+ * non-initiator responds without a {@link WriteKey}, since the initiator’s
+ * request already signals it wants data. If the non-initiator detects an issue
+ * (e.g., an invalid {@link WriteKey} causing a {@link ProtocolWriteKeyError}, or
+ * a write failure causing a {@link ProtocolWriteError}), it sends an error code
+ * via the `Error` field in the header back to the initiator. In relay-to-relay
+ * or P2P sync, both sides may require the {@link WriteKey} depending on who is
+ * the initiator.
+ *
+ * ### Message Size Limit
+ *
+ * The protocol enforces a strict maximum size for all messages, defined by
+ * {@link maxProtocolMessageSize}. This ensures every `ProtocolMessage` is less
+ * than or equal to this limit, eliminating the need for applications to
+ * fragment and reconstruct messages during transmission.
+ *
+ * ### Why Binary?
+ *
+ * The protocol avoids JSON because:
+ *
+ * - Encrypted data doesn’t compress well, unlike plain JSON.
+ * - Message size must be controlled during creation.
+ * - Sequential byte reading is faster than parsing and can avoid conversions.
+ *
+ * It uses structure-aware encoding, significantly outperforming generic binary
+ * serialization formats with the following optimizations:
+ *
+ * - **NonNegativeInt:** Up to 33% smaller than MessagePack.
+ * - **Base64Url Strings:** Up to 25% size reduction.
+ * - **DateIso:** Up to 75% smaller.
+ * - **Timestamp Encoding:** Delta encoding for milliseconds and run-length
+ *   encoding (RLE) for counters and NodeIds.
+ * - **Small Integers (0 to 19):** Reduces size by 1 byte per integer.
+ *
+ * To avoid reinventing serialization where it’s unnecessary—like for JSON and
+ * certain numbers—the Evolu Protocol relies on MessagePack.
+ *
+ * ### Versioning
+ *
+ * The initiator sends a versioned `ProtocolMessage`. If the non-initiator uses
+ * a different version, it responds with a message containing only its protocol
+ * version—**without an `ownerId`**. This allows the initiator to check protocol
+ * compatibility, for example, by sending version-only messages to multiple
+ * relays before starting synchronization.
+ *
+ * @module
+ */
+import { NonEmptyReadonlyArray } from "../Array.js";
+import { Buffer } from "../Buffer.js";
+import { CreateRandomBytesDep, EncryptionKey, SymmetricCryptoDecryptError, SymmetricCryptoDep } from "../Crypto.js";
+import { ReadonlyRecord } from "../Object.js";
+import { Result } from "../Result.js";
+import { SqliteValue } from "../Sqlite.js";
+import { Id, NanoId, NonNegativeInt, PositiveInt } from "../Type.js";
+import { Brand } from "../Types.js";
+import { OwnerId, OwnerWithWriteAccess, WriteKey } from "./Owner.js";
+import { BinaryTimestamp, NodeId, Timestamp } from "./Timestamp.js";
+/** Maximum size of the entire protocol message in bytes. */
+export declare const maxProtocolMessageSize: PositiveInt;
+/** Maximum size of the ranges in bytes. */
+export declare const maxProtocolMessageRangesSize: PositiveInt;
+/** Evolu Protocol Message. */
+export type ProtocolMessage = Uint8Array & Brand<"ProtocolMessage">;
+/** Evolu Protocol version. */
+export declare const protocolVersion: NonNegativeInt;
+export declare const ProtocolErrorCode: {
+    readonly NoError: 0;
+    /** A code for {@link ProtocolWriteKeyError}. */
+    readonly WriteKeyError: 1;
+    /** A code for {@link ProtocolWriteError}. */
+    readonly WriteError: 2;
+    /** A code for {@link ProtocolSyncError}. */
+    readonly SyncError: 3;
+};
+type ProtocolErrorCode = (typeof ProtocolErrorCode)[keyof typeof ProtocolErrorCode];
+/**
+ * Evolu Protocol Storage
+ *
+ * The protocol is agnostic to storage implementation details—any storage can be
+ * plugged in, as long as it implements this interface. Implementations must
+ * handle their own errors; return values only indicates overall success or
+ * failure.
+ */
+export interface Storage {
+    readonly getSize: (ownerId: BinaryOwnerId) => NonNegativeInt | null;
+    readonly fingerprint: (ownerId: BinaryOwnerId, begin: NonNegativeInt, end: NonNegativeInt) => Fingerprint | null;
+    /**
+     * Computes fingerprints with their upper bounds in one call.
+     *
+     * This function can be replaced with many fingerprint/findLowerBound calls,
+     * but implementations can leverage it for batching and more efficient
+     * fingerprint computation.
+     */
+    readonly fingerprintRanges: (ownerId: BinaryOwnerId, buckets: ReadonlyArray<NonNegativeInt>, upperBound?: RangeUpperBound) => ReadonlyArray<FingerprintRange> | null;
+    readonly findLowerBound: (ownerId: BinaryOwnerId, begin: NonNegativeInt, end: NonNegativeInt, upperBound: RangeUpperBound) => NonNegativeInt | null;
+    readonly iterate: (ownerId: BinaryOwnerId, begin: NonNegativeInt, end: NonNegativeInt, callback: (timestamp: BinaryTimestamp, index: NonNegativeInt) => boolean) => void;
+    /**
+     * Authorizes the initiator's {@link WriteKey} for the given
+     * {@link BinaryOwnerId}.
+     *
+     * For a client that does not expect foreign writes, return `false`.
+     */
+    readonly validateWriteKey: (ownerId: BinaryOwnerId, writeKey: WriteKey) => boolean;
+    /** Write encrypted {@link CrdtMessage}s to storage. */
+    readonly writeMessages: (ownerId: BinaryOwnerId, messages: NonEmptyReadonlyArray<EncryptedCrdtMessage>) => boolean;
+    /** Read encrypted {@link DbChange}s from storage. */
+    readonly readDbChange: (ownerId: BinaryOwnerId, timestamp: BinaryTimestamp) => EncryptedDbChange | null;
+}
+export interface StorageDep {
+    readonly storage: Storage;
+}
+/** An encrypted {@link CrdtMessage}. */
+export interface EncryptedCrdtMessage {
+    readonly timestamp: Timestamp;
+    readonly change: EncryptedDbChange;
+}
+/** Encrypted DbChange */
+export type EncryptedDbChange = Uint8Array & Brand<"EncryptedDbChange">;
+/**
+ * A CRDT message that combines a unique {@link Timestamp} with a
+ * {@link DbChange}.
+ */
+export interface CrdtMessage {
+    readonly timestamp: Timestamp;
+    readonly change: DbChange;
+}
+/**
+ * A DbChange is a change to a table row. Together with a unique
+ * {@link Timestamp}, it forms a {@link CrdtMessage}.
+ */
+export interface DbChange {
+    readonly table: Base64Url256;
+    readonly id: Id;
+    readonly values: ReadonlyRecord<Base64Url256, SqliteValue>;
+}
+export declare const RangeType: {
+    readonly Fingerprint: 1;
+    readonly Skip: 0;
+    readonly Timestamps: 2;
+};
+export type RangeType = (typeof RangeType)[keyof typeof RangeType];
+export declare const InfiniteUpperBound: unique symbol;
+export type InfiniteUpperBound = typeof InfiniteUpperBound;
+/**
+ * Union type for Range's upperBound: either a {@link BinaryTimestamp} or
+ * {@link InfiniteUpperBound}.
+ */
+export type RangeUpperBound = BinaryTimestamp | InfiniteUpperBound;
+interface BaseRange {
+    readonly upperBound: RangeUpperBound;
+}
+export interface SkipRange extends BaseRange {
+    readonly type: typeof RangeType.Skip;
+}
+export interface FingerprintRange extends BaseRange {
+    readonly type: typeof RangeType.Fingerprint;
+    readonly fingerprint: Fingerprint;
+}
+/**
+ * A cryptographic hash used for efficiently comparing collections of
+ * {@link BinaryTimestamp}s.
+ *
+ * It consists of the first {@link fingerprintSize} bytes of the SHA-256 hash of
+ * one or more timestamps.
+ */
+export type Fingerprint = Uint8Array & Brand<"Fingerprint">;
+export declare const fingerprintSize: NonNegativeInt;
+/** A fingerprint of an empty range. */
+export declare const zeroFingerprint: Fingerprint;
+export interface TimestampsRange extends BaseRange {
+    readonly type: typeof RangeType.Timestamps;
+    readonly timestamps: ReadonlyArray<BinaryTimestamp>;
+}
+export interface TimestampsRangeWithTimestampsBuffer extends BaseRange {
+    readonly type: typeof RangeType.Timestamps;
+    readonly timestamps: TimestampsBuffer;
+}
+export type Range = SkipRange | FingerprintRange | TimestampsRange;
+export type ProtocolError = ProtocolUnsupportedVersionError | ProtocolInvalidDataError | ProtocolWriteKeyError | ProtocolWriteError | ProtocolSyncError;
+/**
+ * Represents a version mismatch in the Evolu Protocol. Occurs when the
+ * initiator and non-initiator are using incompatible protocol versions.
+ */
+export interface ProtocolUnsupportedVersionError {
+    readonly type: "ProtocolUnsupportedVersionError";
+    readonly unsupportedVersion: NonNegativeInt;
+    /** Indicates which side is obsolete and should update. */
+    readonly isInitiator: boolean;
+}
+/** Error for invalid or corrupted protocol message data. */
+export interface ProtocolInvalidDataError {
+    readonly type: "ProtocolInvalidDataError";
+    readonly data: globalThis.Uint8Array;
+    readonly error: unknown;
+}
+/** Error when a {@link WriteKey} is invalid, missing, or fails validation. */
+export interface ProtocolWriteKeyError {
+    readonly type: "ProtocolWriteKeyError";
+}
+/**
+ * Error when a write fails due to storage limits or billing requirements.
+ * Indicates the need to expand capacity or resolve payment issues.
+ */
+export interface ProtocolWriteError {
+    readonly type: "ProtocolWriteError";
+}
+/**
+ * Error indicating a synchronization failure during the protocol exchange. Used
+ * for unexpected or generic sync errors not covered by other error types.
+ */
+export interface ProtocolSyncError {
+    readonly type: "ProtocolSyncError";
+}
+/**
+ * Creates a {@link ProtocolMessage} from CRDT messages.
+ *
+ * If the message size would exceed {@link maxProtocolMessageSize}, the protocol
+ * ensures all messages will be sent in the next round(s) even over
+ * unidirectional and stateless transports.
+ */
+export declare const createProtocolMessageFromCrdtMessages: (deps: SymmetricCryptoDep & CreateRandomBytesDep) => (owner: OwnerWithWriteAccess, messages: NonEmptyReadonlyArray<CrdtMessage>, maxSize?: PositiveInt) => ProtocolMessage;
+/** Creates a {@link ProtocolMessage} for sync. */
+export declare const createProtocolMessageForSync: (deps: StorageDep) => (ownerId: OwnerId) => ProtocolMessage | null;
+/**
+ * Mutable builder for constructing {@link ProtocolMessage} respecting size
+ * limits.
+ */
+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;
+    readonly unwrap: () => ProtocolMessage;
+    readonly getSize: () => PositiveInt;
+}
+export declare const createProtocolMessageBuffer: (ownerId: OwnerId, options?: {
+    readonly errorCode?: ProtocolErrorCode;
+    readonly writeKey?: WriteKey;
+    readonly totalMaxSize?: PositiveInt | undefined;
+    readonly rangesMaxSize?: PositiveInt | undefined;
+    readonly version?: NonNegativeInt;
+}) => ProtocolMessageBuffer;
+export interface TimestampsBuffer {
+    readonly add: (timestamp: Timestamp) => void;
+    readonly addInfinite: () => void;
+    readonly getCount: () => NonNegativeInt;
+    readonly getLength: () => number;
+    readonly append: (buffer: Buffer) => void;
+}
+export declare const createTimestampsBuffer: () => TimestampsBuffer;
+export interface ApplyProtocolMessageAsClientOptions {
+    getWriteKey?: (ownerId: OwnerId) => WriteKey | null;
+    /** For testing purposes only; should not be used in production. */
+    version?: NonNegativeInt;
+    totalMaxSize?: PositiveInt;
+    rangesMaxSize?: PositiveInt;
+}
+export declare const applyProtocolMessageAsClient: (deps: StorageDep) => (inputMessage: Uint8Array, { getWriteKey, version, totalMaxSize, rangesMaxSize, }?: ApplyProtocolMessageAsClientOptions) => Result<ProtocolMessage | null, ProtocolError>;
+export interface ApplyProtocolMessageAsRelayOptions {
+    /** To subscribe an owner for broadcasting. */
+    subscribe?: (ownerId: OwnerId) => void;
+    /** To broadcast a protocol message to all subscribers. */
+    broadcast?: (ownerId: OwnerId, message: ProtocolMessage) => void;
+    totalMaxSize?: PositiveInt;
+    rangesMaxSize?: PositiveInt;
+}
+export declare const applyProtocolMessageAsRelay: (deps: StorageDep) => (inputMessage: Uint8Array, { subscribe, broadcast, totalMaxSize, rangesMaxSize, }?: ApplyProtocolMessageAsRelayOptions, 
+/** For testing purposes only; should not be used in production. */
+version?: number & Brand<"Int"> & Brand<"NonNegative">) => Result<ProtocolMessage | null, ProtocolInvalidDataError>;
+/** Binary representation of {@link Id}. */
+export type BinaryId = Uint8Array & Brand<"BinaryId">;
+export declare const binaryIdLength: NonNegativeInt;
+export declare const idToBinaryId: (id: Id) => BinaryId;
+export declare const binaryIdToId: (binaryId: BinaryId) => Id;
+/** Binary representation of {@link OwnerId}. */
+export type BinaryOwnerId = Uint8Array & Brand<"BinaryOwnerId">;
+export declare const ownerIdToBinaryOwnerId: (ownerId: OwnerId) => BinaryOwnerId;
+export declare const binaryOwnerIdToOwnerId: (binaryOwnerId: BinaryOwnerId) => OwnerId;
+/**
+ * Base64Url string with maximum length of 256 characters. Encoding strings as
+ * Base64UrlString saves up to 25% in size compared to regular strings.
+ */
+export declare const Base64Url256: import("../Type.js").BrandType<import("../Type.js").Type<"Brand", string & Brand<"Base64Url">, string, import("../Type.js").RegexError<"Base64Url">, string, import("../Type.js").StringError>, "MaxLength256", import("../Type.js").MaxLengthError<256>, import("../Type.js").StringError | import("../Type.js").RegexError<"Base64Url">>;
+export type Base64Url256 = typeof Base64Url256.Type;
+/**
+ * Union type for all variants of Base64Url strings with limited length. All
+ * these types use Base64Url alphabet and are < 256 characters.
+ */
+export type Base64Url256Variant = Base64Url256 | Id | NanoId | OwnerId;
+/**
+ * Converts a Base64Url string to a Uint8Array for binary storage. This encoding
+ * is more space-efficient than UTF-8 for Base64Url strings.
+ */
+export declare const base64Url256ToBytes: (string: Base64Url256Variant) => globalThis.Uint8Array;
+export declare const decodeBase64Url256: (buffer: Buffer, stringLength: number) => Base64Url256Variant;
+/**
+ * Evolu uses MessagePack to handle all number variants except for
+ * NonNegativeInt. For NonNegativeInt, Evolu provides more efficient encoding.
+ */
+export declare const encodeNumber: (buffer: Buffer, number: number) => void;
+export declare const decodeNumber: (buffer: Buffer) => number;
+export declare const binaryTimestampToFingerprint: (timestamp: BinaryTimestamp) => Fingerprint;
+/**
+ * Encodes and encrypts a {@link DbChange} using the provided owner's encryption
+ * key. Returns an encrypted binary representation as {@link EncryptedDbChange}.
+ */
+export declare const encodeAndEncryptDbChange: (deps: SymmetricCryptoDep) => (change: DbChange, key: EncryptionKey) => EncryptedDbChange;
+/**
+ * Decrypts and decodes an {@link EncryptedDbChange} using the provided owner's
+ * encryption key.
+ */
+export declare const decryptAndDecodeDbChange: (deps: SymmetricCryptoDep) => (change: EncryptedDbChange, key: EncryptionKey) => Result<DbChange, SymmetricCryptoDecryptError | ProtocolInvalidDataError>;
+/**
+ * Encodes a non-negative integer into a variable-length integer format. It's
+ * more efficient than encoding via {@link encodeNumber}.
+ *
+ * https://en.wikipedia.org/wiki/Variable-length_quantity
+ */
+export declare const encodeNonNegativeInt: (buffer: Buffer, int: NonNegativeInt) => void;
+/**
+ * Decodes a non-negative integer from a variable-length integer format.
+ *
+ * https://en.wikipedia.org/wiki/Variable-length_quantity
+ */
+export declare const decodeNonNegativeInt: (buffer: Buffer) => NonNegativeInt;
+export declare const encodeLength: (buffer: Buffer, value: ArrayLike<any>) => void;
+export declare const decodeLength: (buffer: Buffer) => NonNegativeInt;
+export declare const encodeString: (buffer: Buffer, value: string) => void;
+export declare const decodeString: (buffer: Buffer) => string;
+export declare const encodeNodeId: (buffer: Buffer, nodeId: NodeId) => void;
+export declare const decodeNodeId: (buffer: Buffer) => NodeId;
+export declare const encodeBase64Url256: (buffer: Buffer, string: Base64Url256Variant) => void;
+export declare const decodeBase64Url256WithLength: (buffer: Buffer) => Base64Url256;
+export declare const ProtocolValueType: {
+    readonly String: NonNegativeInt;
+    readonly Number: NonNegativeInt;
+    readonly Null: NonNegativeInt;
+    readonly Binary: NonNegativeInt;
+    readonly Id: NonNegativeInt;
+    readonly Base64Url256: NonNegativeInt;
+    readonly NonNegativeInt: NonNegativeInt;
+    readonly Json: NonNegativeInt;
+    readonly DateIsoWithNonNegativeTime: NonNegativeInt;
+    readonly DateIsoWithNegativeTime: NonNegativeInt;
+};
+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/Evolu/Protocol.d.ts.map

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