@korajs/sync 1.0.0-beta.12 → 1.0.0-beta.14

package/dist/transport-CJvRO5ix.d.ts

@@ -1,745 +0,0 @@
-import * as _korajs_core from '@korajs/core';
-import { KoraError, Operation, VersionVector, OperationType, HLCTimestamp, AtomicOp } from '@korajs/core';
-
-/**
- * Encryption types for the Kora.js sync layer.
- *
- * These types define the configuration and wire format for end-to-end
- * encryption of operation data during sync. Only `data` and `previousData`
- * fields are encrypted — metadata stays in cleartext for routing and ordering.
- */
-/**
- * Supported encryption algorithms. Currently only AES-256-GCM is supported,
- * but the type is extensible for future algorithms.
- */
-type SyncEncryptionAlgorithm = 'aes-256-gcm';
-/**
- * Configuration for sync-layer encryption.
- *
- * When enabled, the sync engine encrypts `data` and `previousData` fields
- * of every operation before sending over the wire. The server never sees
- * plaintext user data.
- *
- * @example
- * ```typescript
- * const app = createApp({
- *   schema,
- *   sync: {
- *     url: 'wss://my-server.com/kora',
- *     encryption: {
- *       enabled: true,
- *       key: 'my-secure-passphrase'
- *     }
- *   }
- * })
- * ```
- */
-interface SyncEncryptionConfig {
-    /** Whether encryption is enabled. When false, all other fields are ignored. */
-    enabled: boolean;
-    /**
-     * Passphrase or async key provider function.
-     *
-     * - If a string, used as a passphrase for PBKDF2 key derivation.
-     * - If a function, called to retrieve the passphrase (e.g., from a vault or user prompt).
-     */
-    key: string | (() => Promise<string>);
-    /**
-     * Encryption algorithm. Defaults to 'aes-256-gcm'.
-     * Currently only AES-256-GCM is supported.
-     */
-    algorithm?: SyncEncryptionAlgorithm;
-}
-/**
- * Encrypted payload structure embedded in operation `data` and `previousData`
- * fields when encryption is enabled.
- *
- * This structure replaces the original field values on the wire. The server
- * stores and relays these opaque payloads without being able to read the
- * plaintext contents.
- */
-interface EncryptedPayload {
-    /** Encryption key version. Supports key rotation: older operations may use older key versions. */
-    v: number;
-    /** Base64-encoded initialization vector (12 bytes for AES-GCM). Unique per operation field. */
-    iv: string;
-    /** Base64-encoded ciphertext (AES-256-GCM output including authentication tag). */
-    ct: string;
-    /** Encryption algorithm identifier. */
-    alg: SyncEncryptionAlgorithm;
-}
-/**
- * A versioned encryption key with its associated salt for key derivation.
- *
- * Key versions enable rotation: when the passphrase changes, a new key version
- * is created. Operations encrypted with older key versions include their version
- * number in the {@link EncryptedPayload}, allowing the decryptor to select the
- * correct key.
- */
-interface VersionedKey {
-    /** Key version number (monotonically increasing, starting at 1). */
-    version: number;
-    /** The derived CryptoKey for AES-256-GCM operations. */
-    key: CryptoKey;
-    /** The salt used during PBKDF2 key derivation. Required to re-derive the same key. */
-    salt: Uint8Array;
-}
-
-/**
- * Internal sync engine states. Used for state machine transitions.
- */
-declare const SYNC_STATES: readonly ["disconnected", "connecting", "handshaking", "syncing", "streaming", "error"];
-type SyncState = (typeof SYNC_STATES)[number];
-/**
- * Developer-facing sync status. Simplified view of the internal state.
- */
-declare const SYNC_STATUSES: readonly ["connected", "reconnecting", "syncing", "synced", "offline", "clock-error", "error", "schema-mismatch", "auth-required"];
-type SyncStatus = (typeof SYNC_STATUSES)[number];
-type SyncPhase = 'suspended' | 'offline' | 'connecting' | 'authenticating' | 'handshaking' | 'uploading' | 'receiving' | 'applying' | 'streaming' | 'blocked';
-interface ActiveApplyFailure {
-    operationId: string;
-    collection: string;
-    recordId: string;
-    code: string;
-    message: string;
-    retriable: boolean;
-    firstSeenAt: number;
-    retryCount: number;
-}
-/**
- * Sync status information exposed to developers.
- */
-interface SyncStatusInfo {
-    /** Current developer-facing status */
-    status: SyncStatus;
-    phase?: SyncPhase;
-    reason?: string;
-    /** True when the engine is actively trying to re-establish a transport session. */
-    reconnecting: boolean;
-    /** Number of operations waiting to be sent */
-    pendingOperations: number;
-    /** Timestamp of last successful sync (null if never synced) */
-    lastSyncedAt: number | null;
-    /** Timestamp of last successful push to the server (null if never pushed) */
-    lastSuccessfulPush: number | null;
-    /** Timestamp of last successful pull from the server (null if never pulled) */
-    lastSuccessfulPull: number | null;
-    /** Number of merge conflicts encountered during this session */
-    conflicts: number;
-    /** serverTime - localTime in ms measured at the last handshake, or null before first connect. Negative = this device's clock is fast. */
-    clockSkewMs: number | null;
-    inFlightUploadOperations?: number;
-    hasInFlightDeliveryBatch?: boolean;
-    activeViewId?: string;
-    activeViewComplete?: boolean;
-    initialSync?: {
-        complete: boolean;
-        receivedBatches: number;
-        totalBatches: number | null;
-        progress: number | null;
-    };
-    deliveryWatermark?: number;
-    serverFrontier?: number | null;
-    blockedFailure?: ActiveApplyFailure | null;
-}
-interface SyncSettlementOptions {
-    upload?: boolean;
-    download?: 'active-view' | false;
-    timeoutMs?: number;
-    signal?: AbortSignal;
-}
-type SyncSettlementResult = {
-    outcome: 'settled';
-    status: SyncStatusInfo;
-} | {
-    outcome: 'offline';
-    status: SyncStatusInfo;
-} | {
-    outcome: 'suspended';
-    reason: string;
-    status: SyncStatusInfo;
-} | {
-    outcome: 'blocked';
-    failure: ActiveApplyFailure;
-    status: SyncStatusInfo;
-} | {
-    outcome: 'timeout';
-    status: SyncStatusInfo;
-} | {
-    outcome: 'aborted';
-    status: SyncStatusInfo;
-};
-/**
- * Per-collection sync scope map. Maps collection names to field-value filters.
- * Empty filter `{}` means no restriction (all records visible).
- * Missing collection means hidden (no records visible for that collection).
- */
-type SyncScopeMap = Record<string, Record<string, unknown>>;
-/**
- * Sync configuration provided by the developer.
- */
-interface SyncConfig {
-    /** WebSocket or HTTP URL for the sync server */
-    url: string;
-    /** Transport type to use. Defaults to 'websocket'. */
-    transport?: 'websocket' | 'http';
-    /** Auth provider function. Called before each connection attempt. */
-    auth?: () => Promise<{
-        token: string;
-    }>;
-    /** Auth readiness gate. A suspended result prevents transport creation and retries. */
-    authState?: () => Promise<{
-        state: 'loading' | 'signed-out' | 'anonymous' | 'authenticated';
-        mayConnectAnonymously?: boolean;
-    }>;
-    querySubsets?: {
-        mode?: 'reactive' | 'static' | 'disabled';
-    };
-    /** Client-local behavior for records leaving the accepted downlink scope. Defaults to `retain`. */
-    scopeExit?: 'retain' | 'retract';
-    /** Sync scopes per collection. Limits which records sync to this client. */
-    scopes?: Record<string, (ctx: SyncScopeContext) => Record<string, unknown>>;
-    /**
-     * Pre-computed per-collection sync scope map. Sent to the server in the handshake.
-     * Built automatically by createApp from schema scope declarations + flat scope values.
-     */
-    scopeMap?: SyncScopeMap;
-    /** Number of operations per batch. Defaults to 100. */
-    batchSize?: number;
-    /**
-     * Maximum time to wait for the server to acknowledge an outbound batch before
-     * treating the connection as stalled. The batch is returned to the durable
-     * outbound queue before disconnecting so it can be retried on reconnect.
-     * Defaults to 30000ms. Set to 0 to disable the watchdog.
-     */
-    outboundAckTimeoutMs?: number;
-    /** Initial delay before resending a transiently rejected outbound operation. Defaults to 250ms. */
-    outboundRetryBaseDelayMs?: number;
-    /** Maximum transient-operation retry delay. Defaults to 30000ms. */
-    outboundRetryMaxDelayMs?: number;
-    /** Initial reconnection delay in ms. Defaults to 1000. */
-    reconnectInterval?: number;
-    /** Maximum reconnection delay in ms. Defaults to 30000. */
-    maxReconnectInterval?: number;
-    /** Schema version of this client. */
-    schemaVersion?: number;
-    /** Start sync automatically when the engine is created. Defaults to false. */
-    autoConnect?: boolean;
-    /**
-     * When true, wait for server ACKs on all outbound handshake delta batches before
-     * entering streaming. Improves backpressure for large initial syncs.
-     */
-    strictHandshake?: boolean;
-    /** Optional operation transforms for cross-schema-version sync. */
-    operationTransforms?: _korajs_core.OperationTransform[];
-    /**
-     * Richtext snapshot size (bytes) at which the optional Yjs doc channel is used.
-     * Defaults to 4096.
-     */
-    richtextDocChannelThreshold?: number;
-    /**
-     * End-to-end encryption configuration.
-     * When enabled, `data` and `previousData` fields are encrypted before sending
-     * over the wire. The server never sees plaintext user data.
-     */
-    encryption?: SyncEncryptionConfig;
-}
-/**
- * Context passed to sync scope functions.
- */
-interface SyncScopeContext {
-    userId?: string;
-    [key: string]: unknown;
-}
-/**
- * Persists last-acked server version vector and computes unsynced operations from the op log.
- */
-interface DeltaCursor {
-    /** ID of the last fully applied operation in the previous delta stream */
-    lastOperationId: string;
-    /** Zero-based batch index where the cursor was recorded */
-    batchIndex: number;
-}
-interface SyncStatePersistence {
-    loadLastAckedServerVector(): Promise<VersionVector>;
-    saveLastAckedServerVector(vector: VersionVector): Promise<void>;
-    mergeServerVectors(a: VersionVector, b: VersionVector): VersionVector;
-    countUnsyncedOperations(serverVector: VersionVector): Promise<number>;
-    getUnsyncedOperations(serverVector: VersionVector): Promise<Operation[]>;
-    /** Resume position for paginated initial sync (optional). */
-    loadDeltaCursor?(): Promise<DeltaCursor | null>;
-    saveDeltaCursor?(cursor: DeltaCursor | null): Promise<void>;
-    /**
-     * The delivery watermark for a sync view, keyed by an opaque view signature (the auth
-     * scope plus active query subscriptions). Persisted per view so a restarted client
-     * resumes each view's gap-free stream from the right point, and switching views does not
-     * re-sync a view already synced. The empty-string signature is the default, unfiltered
-     * view. Optional: a persistence layer that omits these falls back to re-sync on restart.
-     */
-    loadDeliveryWatermark?(signature: string): Promise<number>;
-    saveDeliveryWatermark?(signature: string, watermark: number): Promise<void>;
-    /** Load every persisted view watermark, keyed by signature. */
-    loadAllDeliveryWatermarks?(): Promise<Record<string, number>>;
-    /**
-     * Delete a persisted view watermark. Used to bound the number of stored view watermarks
-     * (a cold view is evicted from the client's cache and its persisted row removed). Safe:
-     * an evicted view back-fills from 0 (deduplicated) when next visited.
-     */
-    deleteDeliveryWatermark?(signature: string): Promise<void>;
-}
-/**
- * Interface for persisting the outbound operation queue.
- * Operations must survive page refreshes and be sent when connection is re-established.
- */
-interface QueueStorage {
-    /** Load all queued operations from persistent storage */
-    load(): Promise<Operation[]>;
-    /** Persist an operation to the queue */
-    enqueue(op: Operation): Promise<void>;
-    /** Remove acknowledged operations by their IDs */
-    dequeue(ids: string[]): Promise<void>;
-    /** 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:
- * - A client tries to push an operation outside its configured scope
- * - The server rejects an operation because it falls outside the client's scope
- */
-declare class ScopeViolationError extends KoraError {
-    readonly operationId: string;
-    readonly collection: string;
-    readonly scope: Record<string, unknown>;
-    constructor(operationId: string, collection: string, scope: Record<string, unknown>, message?: string);
-}
-/**
- * Thrown when a sync scope configuration is invalid.
- */
-declare class InvalidScopeError extends KoraError {
-    constructor(message: string, context?: Record<string, unknown>);
-}
-
-/**
- * A live query filter that narrows which operations sync for a collection.
- */
-interface SyncQuerySubset {
-    collection: string;
-    where: Record<string, unknown>;
-}
-/**
- * Returns true when an operation matches at least one active query subset
- * for its collection. Collections without query subsets pass through.
- */
-declare function operationMatchesQuerySubsets(op: Operation, subsets: SyncQuerySubset[] | undefined, fullRecord?: Record<string, unknown> | null): boolean;
-/** Canonicalize equality subsets and remove subsets already covered by a broader one. */
-declare function dedupeQuerySubsets(subsets: SyncQuerySubset[]): SyncQuerySubset[];
-/** True when every record selected by `narrow` is also selected by `broad`. */
-declare function querySubsetContains(broad: SyncQuerySubset[], narrow: SyncQuerySubset[]): boolean;
-
-type WireFormat = 'json' | 'protobuf';
-/**
- * Wire-format operation. Plain object (no Map) for JSON serialization.
- * Maps 1:1 with Operation, but uses Record instead of Map for version vectors.
- */
-interface SerializedOperation {
-    id: string;
-    nodeId: string;
-    type: OperationType;
-    collection: string;
-    recordId: string;
-    data: Record<string, unknown> | null;
-    previousData: Record<string, unknown> | null;
-    timestamp: HLCTimestamp;
-    sequenceNumber: number;
-    causalDeps: string[];
-    schemaVersion: number;
-    /** Atomic operation intents, present only when atomic ops were used. */
-    atomicOps?: Record<string, AtomicOp>;
-    /** Groups this operation with others in an atomic transaction. */
-    transactionId?: string;
-    /** Human-readable name for the mutation group. For DevTools display. */
-    mutationName?: string;
-}
-/**
- * Handshake message sent by client to initiate sync.
- */
-interface HandshakeMessage {
-    type: 'handshake';
-    messageId: string;
-    nodeId: string;
-    /** Version vector as plain object (nodeId -> sequence number) */
-    versionVector: Record<string, number>;
-    schemaVersion: number;
-    authToken?: string;
-    supportedWireFormats?: WireFormat[];
-    /** Per-collection sync scope filters. Limits which records are synced to this client. */
-    syncScope?: Record<string, Record<string, unknown>>;
-    /** Base64url-encoded delta cursor for resuming paginated initial sync */
-    deltaCursor?: string;
-    /** Live query filters that further narrow synced data within auth/schema scope */
-    syncQueries?: SyncQuerySubset[];
-    /**
-     * The client's persisted delivery watermark: the highest server delivery sequence
-     * up to which it has contiguously applied every in-scope operation. Omitted (or 0)
-     * on first sync. When present, the server resumes the gap-free server->client
-     * stream from just after it, superseding the version-vector delta and the resume
-     * cursor for the server->client direction. Optional, so old servers ignore it.
-     */
-    lastDeliverySequence?: number;
-    /** Opt in to client-local removal when records leave the accepted downlink view. */
-    scopeExitPolicy?: 'retain' | 'retract';
-}
-/**
- * Server response to a handshake.
- */
-interface HandshakeResponseMessage {
-    type: 'handshake-response';
-    messageId: string;
-    nodeId: string;
-    versionVector: Record<string, number>;
-    schemaVersion: number;
-    accepted: boolean;
-    rejectReason?: string;
-    /** Inclusive minimum schema version the server accepts (present when rejected for schema mismatch). */
-    supportedSchemaMin?: number;
-    /** Inclusive maximum schema version the server accepts (present when rejected for schema mismatch). */
-    supportedSchemaMax?: number;
-    selectedWireFormat?: WireFormat;
-    /** The server-accepted per-collection sync scope. Confirms what data will be synced. */
-    acceptedScope?: Record<string, Record<string, unknown>>;
-    /** Server-authoritative scope for records delivered to this client. */
-    acceptedDownlinkScopes?: Record<string, Record<string, unknown>>;
-    /** Server-authoritative scope for operations uploaded by this client. */
-    acceptedUplinkScopes?: Record<string, Record<string, unknown>>;
-    /** Server wall-clock time (ms since epoch) at response creation. Lets clients measure their own clock skew. */
-    serverTime?: number;
-    /**
-     * Whether the server persists blob bytes centrally. When true, a client
-     * automatically uploads the bytes behind its `blob` fields so they remain
-     * available to other devices even after the authoring device goes offline.
-     */
-    blobStorageEnabled?: boolean;
-    /**
-     * The server's highest delivery sequence at handshake time. A client whose
-     * persisted delivery watermark exceeds this (the server's operation log was rolled
-     * back, for example by a backup restore) resets its watermark to 0 so it resyncs
-     * from the beginning instead of sitting above a frontier that no longer exists.
-     */
-    serverMaxDeliverySequence?: number;
-}
-/**
- * Batch of operations sent during delta exchange or streaming.
- */
-interface OperationBatchMessage {
-    type: 'operation-batch';
-    messageId: string;
-    operations: SerializedOperation[];
-    /** Client-local authorization removals; these are never domain delete operations. */
-    retractions?: ScopeRetraction[];
-    /** True if this is the last batch in the delta exchange phase */
-    isFinal: boolean;
-    /** Index of this batch (0-based) for ordering */
-    batchIndex: number;
-    /** Base64url-encoded cursor marking the last operation in this batch */
-    cursor?: string;
-    /** Total batches in this delta exchange (for progress reporting) */
-    totalBatches?: number;
-    /**
-     * Delivery-watermark chaining (server->client). `baseDeliverySequence` is the
-     * delivery sequence the client must already hold for this batch to apply in order
-     * (it equals the previous batch's `maxDeliverySequence`, or the client's reported
-     * watermark for the first batch after a handshake). `maxDeliverySequence` is the
-     * highest delivery sequence carried by this batch. The client applies the batch
-     * only when its watermark equals `baseDeliverySequence`, then advances the
-     * watermark to `maxDeliverySequence`. A dropped batch breaks the chain and stalls
-     * the watermark, so the reconnect resend recovers it. Present only on batches the
-     * server sends as part of the delivery stream; absent on legacy version-vector
-     * batches.
-     */
-    baseDeliverySequence?: number;
-    maxDeliverySequence?: number;
-}
-interface ScopeRetraction {
-    collection: string;
-    recordId: string;
-}
-/**
- * Acknowledgment of a received message.
- */
-interface AcknowledgmentMessage {
-    type: 'acknowledgment';
-    messageId: string;
-    acknowledgedMessageId: string;
-    lastSequenceNumber: number;
-    /**
-     * The acknowledged batch's `maxDeliverySequence`, echoed so the server can advance
-     * this client's durable delivery watermark. Present only when acking a delivery-
-     * stream batch. `lastSequenceNumber` stays for existing per-node behavior.
-     */
-    deliverySequence?: number;
-}
-/**
- * Error message from the server or client.
- */
-interface ErrorMessage {
-    type: 'error';
-    messageId: string;
-    code: string;
-    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.
- * Ephemeral -- not persisted, only shared with connected peers.
- */
-interface AwarenessStateWire {
-    user: {
-        name: string;
-        color: string;
-        avatar?: string;
-    };
-    cursor?: {
-        collection: string;
-        recordId: string;
-        field: string;
-        anchor: number;
-        head: number;
-    };
-}
-/**
- * Awareness update message. Carries ephemeral presence data (cursors, user info).
- * Processed separately from operation sync -- never persisted.
- */
-interface AwarenessUpdateMessage {
-    type: 'awareness-update';
-    messageId: string;
-    /** Client ID of the sender */
-    clientId: number;
-    /** Map of clientId -> state (null means removal) */
-    states: Record<string, AwarenessStateWire | null>;
-}
-/**
- * Incremental Yjs update for a richtext field. Ephemeral side channel for large documents.
- * JSON transport only; not persisted on the server operation log.
- */
-interface YjsDocUpdateMessage {
-    type: 'yjs-doc-update';
-    messageId: string;
-    collection: string;
-    recordId: string;
-    field: string;
-    /** Base64-encoded Yjs update binary */
-    update: string;
-}
-/**
- * Request for a single blob chunk by content hash. Ephemeral side channel for
- * out-of-band blob transfer over the sync connection; never persisted in the
- * operation log (durable state is the BlobRef inside a record's fields).
- *
- * Possession of a chunk hash is itself the capability to request it: hashes are
- * only learned from BlobRefs inside records the peer already received through
- * its (scope-filtered) sync, and SHA-256 preimage resistance makes guessing a
- * hash infeasible. The server therefore relays chunk requests among peers
- * without a separate ACL.
- */
-interface BlobChunkRequestMessage {
-    type: 'blob-chunk-request';
-    messageId: string;
-    /** Correlates the response to this request. */
-    requestId: string;
-    /** SHA-256 hash of the requested chunk. */
-    hash: string;
-}
-/**
- * Response to a {@link BlobChunkRequestMessage}. Carries the chunk bytes, or
- * null when the responder does not hold that hash.
- */
-interface BlobChunkResponseMessage {
-    type: 'blob-chunk-response';
-    messageId: string;
-    /** Echoes the request's `requestId` for correlation. */
-    requestId: string;
-    /** Base64-encoded chunk bytes, or null when the responder does not hold the hash. */
-    bytes: string | null;
-}
-/**
- * Unsolicited upload of a blob chunk (or a blob manifest) from a client to the
- * server, so the server can persist it centrally and serve it to other devices
- * even after the authoring device disconnects. Content-addressed: the receiver
- * verifies the bytes hash to `hash`.
- */
-interface BlobChunkPushMessage {
-    type: 'blob-chunk-push';
-    messageId: string;
-    /** SHA-256 hash of the pushed bytes (a chunk hash or a manifest hash). */
-    hash: string;
-    /** Base64-encoded bytes. */
-    bytes: string;
-}
-/**
- * Union of all sync protocol messages.
- */
-type SyncMessage = HandshakeMessage | HandshakeResponseMessage | OperationBatchMessage | AcknowledgmentMessage | ErrorMessage | OperationRejectedMessage | AwarenessUpdateMessage | YjsDocUpdateMessage | BlobChunkRequestMessage | BlobChunkResponseMessage | BlobChunkPushMessage;
-/**
- * Check if an unknown value is a valid SyncMessage.
- */
-declare function isSyncMessage(value: unknown): value is SyncMessage;
-/**
- * Check if a value is a HandshakeMessage.
- */
-declare function isHandshakeMessage(value: unknown): value is HandshakeMessage;
-/**
- * Check if a value is a HandshakeResponseMessage.
- */
-declare function isHandshakeResponseMessage(value: unknown): value is HandshakeResponseMessage;
-/**
- * Check if a value is an OperationBatchMessage.
- */
-declare function isOperationBatchMessage(value: unknown): value is OperationBatchMessage;
-/**
- * Check if a value is an AcknowledgmentMessage.
- */
-declare function isAcknowledgmentMessage(value: unknown): value is AcknowledgmentMessage;
-/**
- * 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.
- */
-declare function isAwarenessUpdateMessage(value: unknown): value is AwarenessUpdateMessage;
-/**
- * Check if a value is a YjsDocUpdateMessage.
- */
-declare function isYjsDocUpdateMessage(value: unknown): value is YjsDocUpdateMessage;
-/**
- * Check if a value is a BlobChunkRequestMessage.
- */
-declare function isBlobChunkRequestMessage(value: unknown): value is BlobChunkRequestMessage;
-/**
- * Check if a value is a BlobChunkResponseMessage.
- */
-declare function isBlobChunkResponseMessage(value: unknown): value is BlobChunkResponseMessage;
-/**
- * Check if a value is a BlobChunkPushMessage.
- */
-declare function isBlobChunkPushMessage(value: unknown): value is BlobChunkPushMessage;
-
-/**
- * Options for transport connection.
- */
-interface TransportOptions {
-    /** Authentication token sent during connection */
-    authToken?: string;
-    /** Additional headers (for HTTP-based transports) */
-    headers?: Record<string, string>;
-}
-/**
- * Transport-level error handler.
- */
-type TransportErrorHandler = (error: Error) => void;
-/**
- * Transport-level close handler.
- */
-type TransportCloseHandler = (reason: string) => void;
-/**
- * Transport-level message handler.
- */
-type TransportMessageHandler = (message: SyncMessage) => void;
-/**
- * Abstract transport interface for sync communication.
- * Implementations can use WebSocket, HTTP, Bluetooth, or any other transport.
- */
-interface SyncTransport {
-    /** Connect to the sync server at the given URL */
-    connect(url: string, options?: TransportOptions): Promise<void>;
-    /** Disconnect from the server */
-    disconnect(): Promise<void>;
-    /** Send a sync message */
-    send(message: SyncMessage): void;
-    /** Register a handler for incoming messages */
-    onMessage(handler: TransportMessageHandler): void;
-    /** Register a handler for connection close events */
-    onClose(handler: TransportCloseHandler): void;
-    /** Register a handler for transport errors */
-    onError(handler: TransportErrorHandler): void;
-    /** Returns true if the transport is currently connected */
-    isConnected(): boolean;
-}
-
-export { isHandshakeResponseMessage as $, type AcknowledgmentMessage as A, type BlobChunkRequestMessage as B, type SyncScopeContext as C, type DeltaCursor as D, type EncryptedPayload as E, type SyncSettlementOptions as F, type SyncSettlementResult as G, type HandshakeMessage as H, InvalidScopeError as I, type SyncStatus as J, dedupeQuerySubsets as K, isAcknowledgmentMessage as L, MemoryRejectedOperationStorage as M, isAwarenessUpdateMessage as N, type OperationBatchMessage as O, isBlobChunkPushMessage as P, type QueueStorage as Q, type RejectedOperationStorage as R, type SyncScopeMap as S, type TransportOptions as T, isBlobChunkRequestMessage as U, type VersionedKey as V, type WireFormat as W, isBlobChunkResponseMessage as X, type YjsDocUpdateMessage as Y, isErrorMessage as Z, isHandshakeMessage as _, type SyncMessage as a, isOperationBatchMessage as a0, isOperationRejectedMessage as a1, isSyncMessage as a2, isYjsDocUpdateMessage as a3, operationMatchesQuerySubsets as a4, querySubsetContains as a5, 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 ActiveApplyFailure as p, type AwarenessStateWire as q, type AwarenessUpdateMessage as r, type ErrorMessage as s, type HandshakeResponseMessage as t, type OperationRejectedMessage as u, SYNC_STATES as v, SYNC_STATUSES as w, ScopeViolationError as x, type SyncEncryptionAlgorithm as y, type SyncPhase as z };