agentic-qe 2.7.3 → 2.8.0

package/dist/edge/p2p/coordination/types.js

@@ -0,0 +1,366 @@
+"use strict";
+/**
+ * Two-Machine Coordination Types
+ *
+ * Type definitions for P2-007: Two-Machine Coordination Proof.
+ * Provides interfaces for managing coordination between two or more
+ * browser agents in a P2P network.
+ *
+ * @module edge/p2p/coordination/types
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CoordinationError = exports.CoordinationErrorCode = exports.CoordinationMessageType = exports.CoordinationEventType = exports.DEFAULT_COORDINATION_CONFIG = exports.HealthLevel = exports.CoordinationRole = exports.CoordinationState = exports.HEALTH_PACKET_LOSS_CRITICAL = exports.HEALTH_PACKET_LOSS_WARNING = exports.HEALTH_RTT_CRITICAL_THRESHOLD = exports.HEALTH_RTT_WARNING_THRESHOLD = exports.DEFAULT_SYNC_BATCH_SIZE = exports.MAX_RECONNECT_ATTEMPTS = exports.DEFAULT_RECONNECT_TIMEOUT = exports.DEFAULT_HEALTH_CHECK_INTERVAL = exports.DEFAULT_PING_INTERVAL = exports.COORDINATION_VERSION = void 0;
+exports.createDefaultCapabilities = createDefaultCapabilities;
+exports.createDefaultSyncStatus = createDefaultSyncStatus;
+exports.createDefaultMetrics = createDefaultMetrics;
+exports.createDefaultHealthStatus = createDefaultHealthStatus;
+exports.generateMessageId = generateMessageId;
+exports.generateChallenge = generateChallenge;
+// ============================================
+// Constants
+// ============================================
+/**
+ * Coordination protocol version
+ */
+exports.COORDINATION_VERSION = '1.0.0';
+/**
+ * Default ping interval in milliseconds
+ */
+exports.DEFAULT_PING_INTERVAL = 5000;
+/**
+ * Default health check interval in milliseconds
+ */
+exports.DEFAULT_HEALTH_CHECK_INTERVAL = 10000;
+/**
+ * Default reconnection timeout in milliseconds
+ */
+exports.DEFAULT_RECONNECT_TIMEOUT = 30000;
+/**
+ * Maximum reconnection attempts before giving up
+ */
+exports.MAX_RECONNECT_ATTEMPTS = 5;
+/**
+ * Default sync batch size
+ */
+exports.DEFAULT_SYNC_BATCH_SIZE = 50;
+/**
+ * Connection health threshold (RTT in ms)
+ */
+exports.HEALTH_RTT_WARNING_THRESHOLD = 500;
+/**
+ * Connection health threshold (RTT in ms)
+ */
+exports.HEALTH_RTT_CRITICAL_THRESHOLD = 2000;
+/**
+ * Packet loss warning threshold (percentage)
+ */
+exports.HEALTH_PACKET_LOSS_WARNING = 5;
+/**
+ * Packet loss critical threshold (percentage)
+ */
+exports.HEALTH_PACKET_LOSS_CRITICAL = 20;
+// ============================================
+// Coordination State
+// ============================================
+/**
+ * Coordination state enumeration
+ */
+var CoordinationState;
+(function (CoordinationState) {
+    /** Not connected to any peer */
+    CoordinationState["DISCONNECTED"] = "disconnected";
+    /** Attempting to connect to peer */
+    CoordinationState["CONNECTING"] = "connecting";
+    /** Connected, performing authentication */
+    CoordinationState["AUTHENTICATING"] = "authenticating";
+    /** Authenticated, synchronizing patterns */
+    CoordinationState["SYNCING"] = "syncing";
+    /** Fully synchronized and coordinated */
+    CoordinationState["SYNCHRONIZED"] = "synchronized";
+    /** Connection degraded but functional */
+    CoordinationState["DEGRADED"] = "degraded";
+    /** Attempting to reconnect after failure */
+    CoordinationState["RECONNECTING"] = "reconnecting";
+    /** Unrecoverable error state */
+    CoordinationState["ERROR"] = "error";
+})(CoordinationState || (exports.CoordinationState = CoordinationState = {}));
+/**
+ * Coordination role in the network
+ */
+var CoordinationRole;
+(function (CoordinationRole) {
+    /** Initiator of the connection */
+    CoordinationRole["INITIATOR"] = "initiator";
+    /** Responder to connection request */
+    CoordinationRole["RESPONDER"] = "responder";
+    /** Both roles (for bidirectional communication) */
+    CoordinationRole["BIDIRECTIONAL"] = "bidirectional";
+})(CoordinationRole || (exports.CoordinationRole = CoordinationRole = {}));
+/**
+ * Health status levels
+ */
+var HealthLevel;
+(function (HealthLevel) {
+    /** Connection is healthy */
+    HealthLevel["HEALTHY"] = "healthy";
+    /** Connection has minor issues */
+    HealthLevel["WARNING"] = "warning";
+    /** Connection has serious issues */
+    HealthLevel["CRITICAL"] = "critical";
+    /** Connection is unhealthy/failed */
+    HealthLevel["UNHEALTHY"] = "unhealthy";
+})(HealthLevel || (exports.HealthLevel = HealthLevel = {}));
+/**
+ * Default coordination configuration
+ */
+exports.DEFAULT_COORDINATION_CONFIG = {
+    defaultRole: CoordinationRole.BIDIRECTIONAL,
+    autoReconnect: true,
+    maxReconnectAttempts: exports.MAX_RECONNECT_ATTEMPTS,
+    reconnectTimeout: exports.DEFAULT_RECONNECT_TIMEOUT,
+    pingInterval: exports.DEFAULT_PING_INTERVAL,
+    healthCheckInterval: exports.DEFAULT_HEALTH_CHECK_INTERVAL,
+    authTimeout: 30000,
+    enableLogging: true,
+    logLevel: 'info',
+    syncConfig: {
+        autoSyncOnConnect: true,
+        syncInterval: 60000,
+        batchSize: exports.DEFAULT_SYNC_BATCH_SIZE,
+        conflictStrategy: 'latest_wins',
+        incrementalSync: true,
+        maxPatternsPerSync: 1000,
+        validatePatterns: true,
+        syncTimeout: 120000,
+    },
+};
+// ============================================
+// Events
+// ============================================
+/**
+ * Coordination event types
+ */
+var CoordinationEventType;
+(function (CoordinationEventType) {
+    /** State changed */
+    CoordinationEventType["STATE_CHANGED"] = "state_changed";
+    /** Peer connected */
+    CoordinationEventType["PEER_CONNECTED"] = "peer_connected";
+    /** Peer disconnected */
+    CoordinationEventType["PEER_DISCONNECTED"] = "peer_disconnected";
+    /** Peer authenticated */
+    CoordinationEventType["PEER_AUTHENTICATED"] = "peer_authenticated";
+    /** Authentication failed */
+    CoordinationEventType["AUTH_FAILED"] = "auth_failed";
+    /** Sync started */
+    CoordinationEventType["SYNC_STARTED"] = "sync_started";
+    /** Sync progress */
+    CoordinationEventType["SYNC_PROGRESS"] = "sync_progress";
+    /** Sync completed */
+    CoordinationEventType["SYNC_COMPLETED"] = "sync_completed";
+    /** Sync failed */
+    CoordinationEventType["SYNC_FAILED"] = "sync_failed";
+    /** Conflict detected */
+    CoordinationEventType["CONFLICT_DETECTED"] = "conflict_detected";
+    /** Conflict resolved */
+    CoordinationEventType["CONFLICT_RESOLVED"] = "conflict_resolved";
+    /** Health warning */
+    CoordinationEventType["HEALTH_WARNING"] = "health_warning";
+    /** Health critical */
+    CoordinationEventType["HEALTH_CRITICAL"] = "health_critical";
+    /** Health recovered */
+    CoordinationEventType["HEALTH_RECOVERED"] = "health_recovered";
+    /** Reconnecting */
+    CoordinationEventType["RECONNECTING"] = "reconnecting";
+    /** Reconnection failed */
+    CoordinationEventType["RECONNECT_FAILED"] = "reconnect_failed";
+    /** Pattern received */
+    CoordinationEventType["PATTERN_RECEIVED"] = "pattern_received";
+    /** Pattern sent */
+    CoordinationEventType["PATTERN_SENT"] = "pattern_sent";
+    /** Error occurred */
+    CoordinationEventType["ERROR"] = "error";
+})(CoordinationEventType || (exports.CoordinationEventType = CoordinationEventType = {}));
+// ============================================
+// Messages
+// ============================================
+/**
+ * Coordination message types
+ */
+var CoordinationMessageType;
+(function (CoordinationMessageType) {
+    /** Authentication challenge */
+    CoordinationMessageType["AUTH_CHALLENGE"] = "auth_challenge";
+    /** Authentication response */
+    CoordinationMessageType["AUTH_RESPONSE"] = "auth_response";
+    /** Authentication result */
+    CoordinationMessageType["AUTH_RESULT"] = "auth_result";
+    /** Capability exchange */
+    CoordinationMessageType["CAPABILITIES"] = "capabilities";
+    /** Ping request */
+    CoordinationMessageType["PING"] = "ping";
+    /** Pong response */
+    CoordinationMessageType["PONG"] = "pong";
+    /** Sync request */
+    CoordinationMessageType["SYNC_REQUEST"] = "sync_request";
+    /** Sync response */
+    CoordinationMessageType["SYNC_RESPONSE"] = "sync_response";
+    /** Sync complete */
+    CoordinationMessageType["SYNC_COMPLETE"] = "sync_complete";
+    /** Pattern batch */
+    CoordinationMessageType["PATTERN_BATCH"] = "pattern_batch";
+    /** Conflict notification */
+    CoordinationMessageType["CONFLICT"] = "conflict";
+    /** Error notification */
+    CoordinationMessageType["ERROR"] = "error";
+    /** Disconnect notification */
+    CoordinationMessageType["DISCONNECT"] = "disconnect";
+})(CoordinationMessageType || (exports.CoordinationMessageType = CoordinationMessageType = {}));
+// ============================================
+// Errors
+// ============================================
+/**
+ * Coordination error codes
+ */
+var CoordinationErrorCode;
+(function (CoordinationErrorCode) {
+    /** Connection failed */
+    CoordinationErrorCode["CONNECTION_FAILED"] = "CONNECTION_FAILED";
+    /** Authentication failed */
+    CoordinationErrorCode["AUTH_FAILED"] = "AUTH_FAILED";
+    /** Authentication timeout */
+    CoordinationErrorCode["AUTH_TIMEOUT"] = "AUTH_TIMEOUT";
+    /** Invalid signature */
+    CoordinationErrorCode["INVALID_SIGNATURE"] = "INVALID_SIGNATURE";
+    /** Peer not found */
+    CoordinationErrorCode["PEER_NOT_FOUND"] = "PEER_NOT_FOUND";
+    /** Peer not authenticated */
+    CoordinationErrorCode["PEER_NOT_AUTHENTICATED"] = "PEER_NOT_AUTHENTICATED";
+    /** Sync failed */
+    CoordinationErrorCode["SYNC_FAILED"] = "SYNC_FAILED";
+    /** Sync timeout */
+    CoordinationErrorCode["SYNC_TIMEOUT"] = "SYNC_TIMEOUT";
+    /** Conflict resolution failed */
+    CoordinationErrorCode["CONFLICT_RESOLUTION_FAILED"] = "CONFLICT_RESOLUTION_FAILED";
+    /** Protocol version mismatch */
+    CoordinationErrorCode["VERSION_MISMATCH"] = "VERSION_MISMATCH";
+    /** Invalid message */
+    CoordinationErrorCode["INVALID_MESSAGE"] = "INVALID_MESSAGE";
+    /** Rate limited */
+    CoordinationErrorCode["RATE_LIMITED"] = "RATE_LIMITED";
+    /** Connection closed */
+    CoordinationErrorCode["CONNECTION_CLOSED"] = "CONNECTION_CLOSED";
+    /** Max reconnection attempts exceeded */
+    CoordinationErrorCode["MAX_RECONNECTS_EXCEEDED"] = "MAX_RECONNECTS_EXCEEDED";
+    /** Unknown error */
+    CoordinationErrorCode["UNKNOWN"] = "UNKNOWN";
+})(CoordinationErrorCode || (exports.CoordinationErrorCode = CoordinationErrorCode = {}));
+/**
+ * Coordination error class
+ */
+class CoordinationError extends Error {
+    constructor(message, code, peerId, details) {
+        super(message);
+        this.code = code;
+        this.peerId = peerId;
+        this.details = details;
+        this.name = 'CoordinationError';
+    }
+}
+exports.CoordinationError = CoordinationError;
+// ============================================
+// Utility Types
+// ============================================
+/**
+ * Create default peer capabilities
+ */
+function createDefaultCapabilities() {
+    return {
+        version: exports.COORDINATION_VERSION,
+        patternSharing: true,
+        crdtSync: true,
+        differentialPrivacy: false,
+        maxBatchSize: exports.DEFAULT_SYNC_BATCH_SIZE,
+        categories: ['test', 'code', 'refactor', 'bugfix'],
+    };
+}
+/**
+ * Create default sync status
+ */
+function createDefaultSyncStatus() {
+    return {
+        state: 'idle',
+        totalPatterns: 0,
+        syncedPatterns: 0,
+        pendingPatterns: 0,
+        conflicts: 0,
+        conflictsResolved: 0,
+        progressPercent: 0,
+        direction: 'bidirectional',
+        bytesTransferred: 0,
+        patternsPerSecond: 0,
+    };
+}
+/**
+ * Create default coordination metrics
+ */
+function createDefaultMetrics() {
+    return {
+        latencyMs: 0,
+        avgLatencyMs: 0,
+        minLatencyMs: Infinity,
+        maxLatencyMs: 0,
+        jitterMs: 0,
+        messagesSent: 0,
+        messagesReceived: 0,
+        messagesPerSecond: 0,
+        bytesSent: 0,
+        bytesReceived: 0,
+        conflictsDetected: 0,
+        conflictsResolved: 0,
+        reconnectionAttempts: 0,
+        successfulSyncs: 0,
+        failedSyncs: 0,
+        uptimeMs: 0,
+        lastActivityAt: Date.now(),
+        collectedAt: Date.now(),
+    };
+}
+/**
+ * Create default health status
+ */
+function createDefaultHealthStatus() {
+    return {
+        level: HealthLevel.HEALTHY,
+        score: 100,
+        isResponsive: true,
+        failedPings: 0,
+        currentRttMs: 0,
+        packetLossPercent: 0,
+        issues: [],
+        recommendations: [],
+        checkedAt: Date.now(),
+    };
+}
+/**
+ * Generate unique message ID using cryptographically secure random
+ */
+function generateMessageId() {
+    const timestamp = Date.now().toString(36);
+    const randomBytes = new Uint8Array(5);
+    crypto.getRandomValues(randomBytes);
+    const random = Array.from(randomBytes).map(b => b.toString(36)).join('').substring(0, 8);
+    return `coord-${timestamp}-${random}`;
+}
+/**
+ * Generate authentication challenge
+ */
+function generateChallenge() {
+    const bytes = new Uint8Array(32);
+    crypto.getRandomValues(bytes);
+    return Array.from(bytes)
+        .map((b) => b.toString(16).padStart(2, '0'))
+        .join('');
+}
+//# sourceMappingURL=types.js.map

package/dist/edge/p2p/coordination/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/edge/p2p/coordination/types.ts"],"names":[],"mappings":"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"}

package/dist/edge/p2p/crdt/CRDTStore.d.ts

@@ -0,0 +1,324 @@
+/**
+ * CRDT Store - Storage and Management for Multiple CRDTs
+ *
+ * Provides a centralized store for managing multiple CRDT instances,
+ * applying remote updates, generating deltas for synchronization,
+ * and garbage collecting tombstones.
+ *
+ * @module edge/p2p/crdt/CRDTStore
+ * @version 1.0.0
+ */
+import { ReplicaId, CRDTType, CRDTState, CRDTStoreConfig, CRDTStoreStats, CRDTDelta, SerializedVectorClock, MergeResult, GCResult, ConflictInfo, CRDTEventHandler, SerializedGCounterState, SerializedLWWRegisterState, SerializedORSetState, SerializedPatternCRDTState } from './types';
+import { VectorClock } from './VectorClock';
+import { GCounter } from './GCounter';
+import { LWWRegister } from './LWWRegister';
+import { ORSet } from './ORSet';
+import { PatternCRDT, PatternInput } from './PatternCRDT';
+/**
+ * Union type for all CRDT instances
+ */
+type CRDTInstance = GCounter | LWWRegister<unknown> | ORSet<unknown> | PatternCRDT;
+/**
+ * Union type for all CRDT states
+ */
+type CRDTStateUnion = CRDTState<SerializedGCounterState> | CRDTState<SerializedLWWRegisterState<unknown>> | CRDTState<SerializedORSetState<unknown>> | CRDTState<SerializedPatternCRDTState>;
+/**
+ * Store for managing multiple CRDT instances.
+ *
+ * Features:
+ * - Create and retrieve CRDTs by ID
+ * - Apply remote updates and merge states
+ * - Generate delta updates for synchronization
+ * - Automatic garbage collection of tombstones
+ * - Event emission for monitoring
+ * - Conflict tracking
+ *
+ * @example
+ * ```typescript
+ * const store = new CRDTStore({
+ *   replicaId: 'replica-1',
+ *   autoGC: true,
+ * });
+ *
+ * // Create CRDTs
+ * const counter = store.createGCounter('page-views');
+ * const tags = store.createORSet<string>('user-tags');
+ * const pattern = store.createPattern({
+ *   id: 'pattern-1',
+ *   content: '...',
+ *   type: 'test',
+ *   category: 'unit',
+ *   domain: 'api',
+ * });
+ *
+ * // Apply remote state
+ * store.applyState(remoteState);
+ *
+ * // Generate deltas for sync
+ * const deltas = store.generateDeltas(lastSyncClock);
+ *
+ * // Get stats
+ * const stats = store.getStats();
+ * ```
+ */
+export declare class CRDTStore {
+    /** Store configuration */
+    private readonly config;
+    /** CRDT instances by ID */
+    private instances;
+    /** CRDT types by ID */
+    private types;
+    /** Global vector clock for store */
+    private vectorClock;
+    /** Delta buffer for pending sync */
+    private deltaBuffer;
+    /** Conflict history */
+    private conflicts;
+    /** Event handlers */
+    private eventHandlers;
+    /** GC interval handle */
+    private gcIntervalHandle?;
+    /** Last GC timestamp */
+    private lastGC?;
+    /** Last sync timestamp */
+    private lastSync?;
+    /**
+     * Create a new CRDT store
+     *
+     * @param config - Store configuration
+     */
+    constructor(config?: Partial<CRDTStoreConfig>);
+    /**
+     * Create a new G-Counter
+     *
+     * @param id - Counter identifier
+     * @param initialValue - Initial value
+     * @returns Created counter
+     */
+    createGCounter(id: string, initialValue?: number): GCounter;
+    /**
+     * Create a new LWW-Register
+     *
+     * @param id - Register identifier
+     * @param initialValue - Initial value
+     * @returns Created register
+     */
+    createLWWRegister<T>(id: string, initialValue?: T): LWWRegister<T>;
+    /**
+     * Create a new OR-Set
+     *
+     * @param id - Set identifier
+     * @returns Created set
+     */
+    createORSet<T>(id: string): ORSet<T>;
+    /**
+     * Create a new Pattern CRDT
+     *
+     * @param input - Pattern input data
+     * @returns Created PatternCRDT
+     */
+    createPattern(input: PatternInput): PatternCRDT;
+    /**
+     * Get a CRDT by ID
+     *
+     * @param id - CRDT identifier
+     * @returns CRDT instance or undefined
+     */
+    get(id: string): CRDTInstance | undefined;
+    /**
+     * Get a G-Counter by ID
+     *
+     * @param id - Counter identifier
+     * @returns Counter or undefined
+     */
+    getGCounter(id: string): GCounter | undefined;
+    /**
+     * Get an LWW-Register by ID
+     *
+     * @param id - Register identifier
+     * @returns Register or undefined
+     */
+    getLWWRegister<T>(id: string): LWWRegister<T> | undefined;
+    /**
+     * Get an OR-Set by ID
+     *
+     * @param id - Set identifier
+     * @returns Set or undefined
+     */
+    getORSet<T>(id: string): ORSet<T> | undefined;
+    /**
+     * Get a PatternCRDT by ID
+     *
+     * @param id - Pattern identifier
+     * @returns Pattern or undefined
+     */
+    getPattern(id: string): PatternCRDT | undefined;
+    /**
+     * Check if a CRDT exists
+     *
+     * @param id - CRDT identifier
+     * @returns True if exists
+     */
+    has(id: string): boolean;
+    /**
+     * Get all CRDT IDs
+     *
+     * @returns Array of IDs
+     */
+    getIds(): string[];
+    /**
+     * Get IDs by type
+     *
+     * @param type - CRDT type to filter by
+     * @returns Array of matching IDs
+     */
+    getIdsByType(type: CRDTType): string[];
+    /**
+     * Get the type of a CRDT
+     *
+     * @param id - CRDT identifier
+     * @returns CRDT type or undefined
+     */
+    getType(id: string): CRDTType | undefined;
+    /**
+     * Apply a remote CRDT state
+     *
+     * If the CRDT doesn't exist locally, it will be created.
+     * If it exists, the states will be merged.
+     *
+     * @param state - Remote CRDT state
+     * @returns Merge result
+     */
+    applyState(state: CRDTStateUnion): MergeResult<unknown>;
+    /**
+     * Merge state with existing CRDT
+     */
+    private mergeExisting;
+    /**
+     * Create a new CRDT from remote state
+     */
+    private createFromState;
+    /**
+     * Apply a delta update
+     *
+     * @param delta - Delta to apply
+     * @returns True if applied successfully
+     */
+    applyDelta(delta: CRDTDelta<unknown>): boolean;
+    /**
+     * Generate deltas for all CRDTs since a given clock
+     *
+     * @param since - Vector clock of last sync
+     * @returns Array of deltas
+     */
+    generateDeltas(since?: SerializedVectorClock): CRDTDelta<unknown>[];
+    /**
+     * Get all states for full sync
+     *
+     * @returns Array of all CRDT states
+     */
+    getAllStates(): CRDTStateUnion[];
+    /**
+     * Buffer a delta for later application
+     */
+    private bufferDelta;
+    /**
+     * Apply buffered deltas for a CRDT
+     *
+     * @param id - CRDT identifier
+     * @returns Number of deltas applied
+     */
+    applyBufferedDeltas(id: string): number;
+    /**
+     * Run garbage collection on all ORSets
+     *
+     * @returns GC result
+     */
+    gc(): GCResult;
+    /**
+     * Start automatic garbage collection
+     */
+    private startAutoGC;
+    /**
+     * Stop automatic garbage collection
+     */
+    stopAutoGC(): void;
+    /**
+     * Add conflicts to history
+     */
+    private addConflicts;
+    /**
+     * Get recent conflicts
+     *
+     * @param limit - Maximum conflicts to return
+     * @returns Array of conflicts
+     */
+    getConflicts(limit?: number): ConflictInfo[];
+    /**
+     * Clear conflict history
+     */
+    clearConflicts(): void;
+    /**
+     * Delete a CRDT from the store
+     *
+     * @param id - CRDT identifier
+     * @returns True if deleted
+     */
+    delete(id: string): boolean;
+    /**
+     * Clear all CRDTs from the store
+     */
+    clear(): void;
+    /**
+     * Add an event handler
+     *
+     * @param handler - Event handler function
+     */
+    on(handler: CRDTEventHandler): void;
+    /**
+     * Remove an event handler
+     *
+     * @param handler - Handler to remove
+     */
+    off(handler: CRDTEventHandler): void;
+    /**
+     * Emit an event
+     */
+    private emit;
+    /**
+     * Check if store has capacity for new CRDT
+     */
+    private checkCapacity;
+    /**
+     * Check if ID is available
+     */
+    private checkIdAvailable;
+    /**
+     * Get store statistics
+     *
+     * @returns Store stats
+     */
+    getStats(): CRDTStoreStats;
+    /**
+     * Estimate memory usage in bytes
+     */
+    private estimateMemoryUsage;
+    /**
+     * Get the replica ID
+     *
+     * @returns Replica ID
+     */
+    getReplicaId(): ReplicaId;
+    /**
+     * Get the vector clock
+     *
+     * @returns Vector clock copy
+     */
+    getVectorClock(): VectorClock;
+    /**
+     * Dispose the store
+     */
+    dispose(): void;
+}
+export {};
+//# sourceMappingURL=CRDTStore.d.ts.map