@affectively/aeon 1.2.0 → 1.3.1

package/dist/core/index.d.cts

@@ -1,211 +1,216 @@
-/**
- * Aeon Core Types
- *
- * Shared type definitions for the Aeon synchronization and versioning system.
- */
-/**
- * Operation type - what action is being performed
- */
-type OperationType = 'create' | 'update' | 'delete' | 'sync' | 'batch';
-/**
- * Operation priority for sync ordering
- */
-type OperationPriority = 'high' | 'normal' | 'low';
-/**
- * Operation sync status
- */
-type OperationStatus = 'pending' | 'syncing' | 'synced' | 'failed';
-/**
- * Queued operation for offline-first synchronization
- */
-interface Operation {
-    id: string;
-    type: OperationType;
-    sessionId: string;
-    status: OperationStatus;
-    data: Record<string, unknown>;
-    priority?: OperationPriority;
-    createdAt?: number;
-    syncedAt?: number;
-    retryCount?: number;
-    maxRetries?: number;
-}
-/**
- * Conflict detection result
- */
-interface ConflictDetectionResult {
-    hasConflict: boolean;
-    type?: 'update_update' | 'delete_update' | 'update_delete' | 'concurrent';
-    severity?: 'low' | 'medium' | 'high';
-    similarity?: number;
-}
-/**
- * Conflict resolution strategy
- */
-type ResolutionStrategy = 'local_wins' | 'remote_wins' | 'last_modified' | 'merge' | 'manual';
-/**
- * Sync batch for uploading multiple operations
- */
-interface SyncBatch {
-    batchId: string;
-    operations: Operation[];
-    totalSize: number;
-    createdAt: number;
-    priority: OperationPriority;
-}
-/**
- * Sync result from server
- */
-interface SyncResult {
-    success: boolean;
-    synced: string[];
-    failed: Array<{
-        operationId: string;
-        error: string;
-    }>;
-    conflicts: Array<{
-        operationId: string;
-        remoteVersion: Record<string, unknown>;
-        strategy: ResolutionStrategy;
-    }>;
-}
-/**
- * Network state for adaptive sync
- */
-type NetworkState = 'online' | 'offline' | 'poor' | 'unknown';
-/**
- * Bandwidth profile for sync adaptation
- */
-interface BandwidthProfile {
-    bandwidth: number;
-    latency: number;
-    timestamp: number;
-    reliability: number;
-}
-/**
- * Sync coordinator configuration
- */
-interface SyncCoordinatorConfig {
-    maxBatchSize: number;
-    maxBatchBytes: number;
-    maxRetries: number;
-    retryDelayMs: number;
-    enableCompression: boolean;
-    enableDeltaSync: boolean;
-    adaptateBatchSize: boolean;
-}
-/**
- * Vector clock for causality tracking
- */
-interface VectorClock {
-    [nodeId: string]: number;
-}
-/**
- * CRDT operation for conflict-free updates
- */
-interface CRDTOperation {
-    id: string;
-    type: 'insert' | 'delete' | 'update';
-    path: string[];
-    value?: unknown;
-    timestamp: number;
-    nodeId: string;
-    vectorClock: VectorClock;
-}
-/**
- * Presence selection range
- */
-interface PresenceSelection {
-    start: number;
-    end: number;
-    direction?: 'forward' | 'backward' | 'none';
-    path?: string;
-}
-/**
- * Presence typing signal
- */
-interface PresenceTyping {
-    isTyping: boolean;
-    field?: string;
-    isComposing?: boolean;
-    startedAt?: number;
-    stoppedAt?: number;
-}
-/**
- * Presence scroll signal
- */
-interface PresenceScroll {
-    depth: number;
-    y?: number;
-    viewportHeight?: number;
-    documentHeight?: number;
-    path?: string;
-}
-/**
- * Presence viewport signal
- */
-interface PresenceViewport {
-    width: number;
-    height: number;
-}
-/**
- * Presence input signal
- */
-interface PresenceInputState {
-    field: string;
-    hasFocus: boolean;
-    valueLength?: number;
-    selectionStart?: number;
-    selectionEnd?: number;
-    isComposing?: boolean;
-    inputMode?: string;
-}
-/**
- * Presence emotional state signal
- */
-interface PresenceEmotion {
-    primary?: string;
-    secondary?: string;
-    confidence?: number;
-    intensity?: number;
-    valence?: number;
-    arousal?: number;
-    dominance?: number;
-    source?: 'self-report' | 'inferred' | 'sensor' | 'hybrid';
-    updatedAt?: number;
-}
-/**
- * Presence information for real-time collaboration
- */
-interface PresenceInfo {
-    userId: string;
-    nodeId: string;
-    cursor?: {
-        x: number;
-        y: number;
-    };
-    focusNode?: string;
-    selection?: PresenceSelection;
-    typing?: PresenceTyping;
-    scroll?: PresenceScroll;
-    viewport?: PresenceViewport;
-    inputState?: PresenceInputState;
-    emotion?: PresenceEmotion;
-    metadata?: Record<string, unknown>;
-    lastActivity: number;
-}
-/**
- * Event emitter types
- */
-type EventCallback<T = unknown> = (data: T) => void;
-type EventUnsubscribe = () => void;
-/**
- * Generic event emitter interface
- */
-interface IEventEmitter {
-    on<T = unknown>(event: string, callback: EventCallback<T>): EventUnsubscribe;
-    off(event: string, callback: EventCallback): void;
-    emit<T = unknown>(event: string, data?: T): void;
+/**
+ * Aeon Core Types
+ *
+ * Shared type definitions for the Aeon synchronization and versioning system.
+ */
+/**
+ * Operation type - what action is being performed
+ */
+type OperationType = 'create' | 'update' | 'delete' | 'sync' | 'batch';
+/**
+ * Operation priority for sync ordering
+ */
+type OperationPriority = 'high' | 'normal' | 'low';
+/**
+ * Operation sync status
+ */
+type OperationStatus = 'pending' | 'syncing' | 'synced' | 'failed';
+/**
+ * Queued operation for offline-first synchronization
+ */
+interface Operation {
+  id: string;
+  type: OperationType;
+  sessionId: string;
+  status: OperationStatus;
+  data: Record<string, unknown>;
+  priority?: OperationPriority;
+  createdAt?: number;
+  syncedAt?: number;
+  retryCount?: number;
+  maxRetries?: number;
+}
+/**
+ * Conflict detection result
+ */
+interface ConflictDetectionResult {
+  hasConflict: boolean;
+  type?: 'update_update' | 'delete_update' | 'update_delete' | 'concurrent';
+  severity?: 'low' | 'medium' | 'high';
+  similarity?: number;
+}
+/**
+ * Conflict resolution strategy
+ */
+type ResolutionStrategy =
+  | 'local_wins'
+  | 'remote_wins'
+  | 'last_modified'
+  | 'merge'
+  | 'manual';
+/**
+ * Sync batch for uploading multiple operations
+ */
+interface SyncBatch {
+  batchId: string;
+  operations: Operation[];
+  totalSize: number;
+  createdAt: number;
+  priority: OperationPriority;
+}
+/**
+ * Sync result from server
+ */
+interface SyncResult {
+  success: boolean;
+  synced: string[];
+  failed: Array<{
+    operationId: string;
+    error: string;
+  }>;
+  conflicts: Array<{
+    operationId: string;
+    remoteVersion: Record<string, unknown>;
+    strategy: ResolutionStrategy;
+  }>;
+}
+/**
+ * Network state for adaptive sync
+ */
+type NetworkState = 'online' | 'offline' | 'poor' | 'unknown';
+/**
+ * Bandwidth profile for sync adaptation
+ */
+interface BandwidthProfile {
+  bandwidth: number;
+  latency: number;
+  timestamp: number;
+  reliability: number;
+}
+/**
+ * Sync coordinator configuration
+ */
+interface SyncCoordinatorConfig {
+  maxBatchSize: number;
+  maxBatchBytes: number;
+  maxRetries: number;
+  retryDelayMs: number;
+  enableCompression: boolean;
+  enableDeltaSync: boolean;
+  adaptateBatchSize: boolean;
+}
+/**
+ * Vector clock for causality tracking
+ */
+interface VectorClock {
+  [nodeId: string]: number;
+}
+/**
+ * CRDT operation for conflict-free updates
+ */
+interface CRDTOperation {
+  id: string;
+  type: 'insert' | 'delete' | 'update';
+  path: string[];
+  value?: unknown;
+  timestamp: number;
+  nodeId: string;
+  vectorClock: VectorClock;
+}
+/**
+ * Presence selection range
+ */
+interface PresenceSelection {
+  start: number;
+  end: number;
+  direction?: 'forward' | 'backward' | 'none';
+  path?: string;
+}
+/**
+ * Presence typing signal
+ */
+interface PresenceTyping {
+  isTyping: boolean;
+  field?: string;
+  isComposing?: boolean;
+  startedAt?: number;
+  stoppedAt?: number;
+}
+/**
+ * Presence scroll signal
+ */
+interface PresenceScroll {
+  depth: number;
+  y?: number;
+  viewportHeight?: number;
+  documentHeight?: number;
+  path?: string;
+}
+/**
+ * Presence viewport signal
+ */
+interface PresenceViewport {
+  width: number;
+  height: number;
+}
+/**
+ * Presence input signal
+ */
+interface PresenceInputState {
+  field: string;
+  hasFocus: boolean;
+  valueLength?: number;
+  selectionStart?: number;
+  selectionEnd?: number;
+  isComposing?: boolean;
+  inputMode?: string;
+}
+/**
+ * Presence emotional state signal
+ */
+interface PresenceEmotion {
+  primary?: string;
+  secondary?: string;
+  confidence?: number;
+  intensity?: number;
+  valence?: number;
+  arousal?: number;
+  dominance?: number;
+  source?: 'self-report' | 'inferred' | 'sensor' | 'hybrid';
+  updatedAt?: number;
+}
+/**
+ * Presence information for real-time collaboration
+ */
+interface PresenceInfo {
+  userId: string;
+  nodeId: string;
+  cursor?: {
+    x: number;
+    y: number;
+  };
+  focusNode?: string;
+  selection?: PresenceSelection;
+  typing?: PresenceTyping;
+  scroll?: PresenceScroll;
+  viewport?: PresenceViewport;
+  inputState?: PresenceInputState;
+  emotion?: PresenceEmotion;
+  metadata?: Record<string, unknown>;
+  lastActivity: number;
+}
+/**
+ * Event emitter types
+ */
+type EventCallback<T = unknown> = (data: T) => void;
+type EventUnsubscribe = () => void;
+/**
+ * Generic event emitter interface
+ */
+interface IEventEmitter {
+  on<T = unknown>(event: string, callback: EventCallback<T>): EventUnsubscribe;
+  off(event: string, callback: EventCallback): void;
+  emit<T = unknown>(event: string, data?: T): void;
 }
 
 export type { BandwidthProfile, CRDTOperation, ConflictDetectionResult, EventCallback, EventUnsubscribe, IEventEmitter, NetworkState, Operation, OperationPriority, OperationStatus, OperationType, PresenceEmotion, PresenceInfo, PresenceInputState, PresenceScroll, PresenceSelection, PresenceTyping, PresenceViewport, ResolutionStrategy, SyncBatch, SyncCoordinatorConfig, SyncResult, VectorClock };