@livestore/cli 0.4.0 → 0.5.0-dev.1

package/dist/mcp-content/architecture.d.ts

@@ -1,2 +1,2 @@
-export declare const architectureContent = "# LiveStore Architecture: Local-First Data Management\n\nLiveStore implements distributed systems principles from Martin Kleppmann's research on local-first software, ensuring data consistency, availability, and partition tolerance in collaborative applications.\n\n## Core Architectural Principles\n\n### 1. Local-First Data Storage\n- **Immediate Response**: All operations execute against local SQLite database first\n- **Offline Capability**: Full application functionality without network connectivity\n- **Data Ownership**: Users maintain complete control over their data\n- **Performance**: Sub-millisecond query responses from local storage\n\n### 2. Event Sourcing & CRDT-Inspired Conflict Resolution\n- **Immutable Event Log**: All changes recorded as immutable events\n- **Deterministic Replay**: State reconstruction from event sequence\n- **Conflict-Free Operations**: Events designed for commutative application\n- **Causal Ordering**: Lamport timestamps ensure causally consistent ordering\n\n### 3. Eventually Consistent Synchronization\n- **Asynchronous Replication**: Events sync when network available\n- **Convergence Guarantee**: All replicas converge to same state\n- **Conflict Resolution**: Last-write-wins with semantic merging strategies\n- **Incremental Sync**: Only transmit events since last synchronization\n\n## System Components\n\n### \uD83D\uDDC4\uFE0F State Layer (SQLite + Materializers)\n```typescript\n// Materialized views from event log\nconst materializers = State.SQLite.materializers(events, {\n  'TodoCreated': ({ id, text, createdAt }) => \n    tables.todos.insert({ id, text, completed: false, createdAt }),\n  'TodoCompleted': ({ id }) => \n    tables.todos.update({ completed: true }).where({ id })\n})\n```\n\n**Responsibilities:**\n- Maintain denormalized query-optimized state\n- Apply events to update materialized views\n- Support efficient reactive queries\n- Handle schema migrations\n\n### \uD83D\uDCDD Event System (Append-Only Log)\n```typescript\nconst events = {\n  todoCompleted: Events.synced({\n    name: 'v1.TodoCompleted',\n    schema: Schema.Struct({ \n      id: Schema.String,\n      completedAt: Schema.Date // For conflict resolution\n    })\n  })\n}\n```\n\n**Characteristics:**\n- Immutable event log (append-only)\n- Cryptographically signed events for integrity\n- Causal dependencies tracked via vector clocks\n- Schema versioning for backward compatibility\n\n### \uD83D\uDD04 Synchronization Engine\n```typescript\n// Conflict resolution during sync\nconst mergeResult = SyncState.merge({\n  syncState: currentState,\n  payload: incomingEvents,\n  isEqualEvent: (a, b) => a.id === b.id && a.type === b.type\n})\n```\n\n**Merge Strategies:**\n- **Advance**: New events extend current state\n- **Rebase**: Rollback conflicting events, apply remote, replay local\n- **Reject**: Ignore events that violate invariants\n\n### \uD83C\uDF10 Network Layer & Adapters\n```typescript\n// Platform-specific sync adapters\nexport const WebAdapter = {\n  storage: OPFSSQLiteStorage, // Origin Private File System\n  transport: WebSocketSync,\n  worker: SharedWorker        // Cross-tab synchronization\n}\n```\n\n**Adapter Implementations:**\n- **Web**: OPFS storage, SharedWorker coordination, WebSocket sync\n- **Node**: File system storage, cluster coordination, HTTP/WebSocket\n- **Mobile**: Native SQLite, background sync, push notifications\n\n## Distributed Systems Properties\n\n### CAP Theorem Considerations\n- **Consistency**: Eventually consistent (not strongly consistent)\n- **Availability**: Always available for reads/writes (local-first)\n- **Partition Tolerance**: Continues operation during network partitions\n\n*Trade-off: Chooses Availability + Partition Tolerance over strong Consistency*\n\n### ACID Properties (Local Transactions)\n- **Atomicity**: Event application is atomic within SQLite transaction\n- **Consistency**: Materializers maintain data integrity constraints\n- **Isolation**: Concurrent operations isolated via SQLite WAL mode\n- **Durability**: Events persisted to disk before acknowledgment\n\n### Conflict Resolution Strategies\n\n1. **Semantic Conflict Resolution**\n   - Application-specific merge logic\n   - E.g., text editing uses operational transforms\n\n2. **Last-Write-Wins (LWW)**\n   - Timestamps determine winner\n   - Simple but can lose data\n\n3. **Multi-Value Registers**\n   - Preserve all conflicting values\n   - User or application resolves\n\n4. **Commutative Operations**\n   - Operations designed to commute\n   - E.g., increment/decrement counters\n\n## Performance & Scalability\n\n### Query Performance\n- **Reactive Queries**: Automatically update UI on data changes\n- **Indexed Access**: SQLite B-tree indexes for fast lookups\n- **Prepared Statements**: Query compilation cached for reuse\n- **Batch Operations**: Multiple events applied in single transaction\n\n### Memory Management\n- **Incremental Loading**: Large datasets loaded on-demand\n- **Query Result Caching**: Expensive query results cached\n- **Event Log Compaction**: Periodic snapshotting and log truncation\n- **Connection Pooling**: Database connections reused across operations\n\n### Network Optimization\n- **Delta Synchronization**: Only sync events since last checkpoint\n- **Compression**: Event payloads compressed for network transfer\n- **Batching**: Multiple events transmitted in single round-trip\n- **Exponential Backoff**: Retry failed sync with increasing delays\n\n## Security Model\n\n### Data Integrity\n- **Event Signatures**: Cryptographic signatures prevent tampering\n- **Merkle Trees**: Efficient verification of event log integrity\n- **Schema Validation**: All events validated against defined schemas\n\n### Access Control\n- **Client-Side Authorization**: Fine-grained permissions in local database\n- **Sync Filtering**: Server filters events based on user permissions\n- **Encryption**: End-to-end encryption for sensitive data\n\n## Observability\n\n### Distributed Tracing\n- **Event Causality**: Trace event propagation across replicas\n- **Sync Performance**: Monitor replication lag and throughput\n- **Conflict Metrics**: Track merge conflicts and resolution strategies\n\n### Health Monitoring\n- **Storage Usage**: Local database size and growth rate\n- **Network Health**: Connection quality and sync success rates\n- **Error Tracking**: Failed operations and their root causes\n\nThis architecture enables applications that work seamlessly offline, sync reliably when online, and provide immediate feedback to users while maintaining data consistency across all replicas.";
+export declare const architectureContent = "# LiveStore Architecture: Local-First Data Management\n\nLiveStore implements distributed systems principles from Martin Kleppmann's research on local-first software, ensuring data consistency, availability, and partition tolerance in collaborative applications.\n\n## Core Architectural Principles\n\n### 1. Local-First Data Storage\n- **Immediate Response**: All operations execute against local SQLite database first\n- **Offline Capability**: Full application functionality without network connectivity\n- **Data Ownership**: Users maintain complete control over their data\n- **Performance**: Sub-millisecond query responses from local storage\n\n### 2. Event Sourcing & CRDT-Inspired Conflict Resolution\n- **Immutable Event Log**: All changes recorded as immutable events\n- **Deterministic Replay**: State reconstruction from event sequence\n- **Conflict-Free Operations**: Events designed for commutative application\n- **Causal Ordering**: Lamport timestamps ensure causally consistent ordering\n\n### 3. Eventually Consistent Synchronization\n- **Asynchronous Replication**: Events sync when network available\n- **Convergence Guarantee**: All replicas converge to same state\n- **Conflict Resolution**: Last-write-wins with semantic merging strategies\n- **Incremental Sync**: Only transmit events since last synchronization\n\n## System Components\n\n### \uD83D\uDDC4\uFE0F State Layer (SQLite + Materializers)\n```typescript\n// Materialized views from event log\nconst materializers = State.SQLite.materializers(events, {\n  'TodoCreated': ({ id, text, createdAt }) =>\n    tables.todos.insert({ id, text, completed: false, createdAt }),\n  'TodoCompleted': ({ id }) =>\n    tables.todos.update({ completed: true }).where({ id })\n})\n```\n\n**Responsibilities:**\n- Maintain denormalized query-optimized state\n- Apply events to update materialized views\n- Support efficient reactive queries\n- Handle schema migrations\n\n### \uD83D\uDCDD Event System (Append-Only Log)\n```typescript\nconst events = {\n  todoCompleted: Events.synced({\n    name: 'v1.TodoCompleted',\n    schema: Schema.Struct({\n      id: Schema.String,\n      completedAt: Schema.Date // For conflict resolution\n    })\n  })\n}\n```\n\n**Characteristics:**\n- Immutable event log (append-only)\n- Cryptographically signed events for integrity\n- Causal dependencies tracked via vector clocks\n- Schema versioning for backward compatibility\n\n### \uD83D\uDD04 Synchronization Engine\n```typescript\n// Conflict resolution during sync\nconst mergeResult = SyncState.merge({\n  syncState: currentState,\n  payload: incomingEvents,\n  isEqualEvent: (a, b) => a.id === b.id && a.type === b.type\n})\n```\n\n**Merge Strategies:**\n- **Advance**: New events extend current state\n- **Rebase**: Rollback conflicting events, apply remote, replay local\n- **Reject**: Ignore events that violate invariants\n\n### \uD83C\uDF10 Network Layer & Adapters\n```typescript\n// Platform-specific sync adapters\nexport const WebAdapter = {\n  storage: OPFSSQLiteStorage, // Origin Private File System\n  transport: WebSocketSync,\n  worker: SharedWorker        // Cross-tab synchronization\n}\n```\n\n**Adapter Implementations:**\n- **Web**: OPFS storage, SharedWorker coordination, WebSocket sync\n- **Node**: File system storage, cluster coordination, HTTP/WebSocket\n- **Mobile**: Native SQLite, background sync, push notifications\n\n## Distributed Systems Properties\n\n### CAP Theorem Considerations\n- **Consistency**: Eventually consistent (not strongly consistent)\n- **Availability**: Always available for reads/writes (local-first)\n- **Partition Tolerance**: Continues operation during network partitions\n\n*Trade-off: Chooses Availability + Partition Tolerance over strong Consistency*\n\n### ACID Properties (Local Transactions)\n- **Atomicity**: Event application is atomic within SQLite transaction\n- **Consistency**: Materializers maintain data integrity constraints\n- **Isolation**: Concurrent operations isolated via SQLite WAL mode\n- **Durability**: Events persisted to disk before acknowledgment\n\n### Conflict Resolution Strategies\n\n1. **Semantic Conflict Resolution**\n   - Application-specific merge logic\n   - E.g., text editing uses operational transforms\n\n2. **Last-Write-Wins (LWW)**\n   - Timestamps determine winner\n   - Simple but can lose data\n\n3. **Multi-Value Registers**\n   - Preserve all conflicting values\n   - User or application resolves\n\n4. **Commutative Operations**\n   - Operations designed to commute\n   - E.g., increment/decrement counters\n\n## Performance & Scalability\n\n### Query Performance\n- **Reactive Queries**: Automatically update UI on data changes\n- **Indexed Access**: SQLite B-tree indexes for fast lookups\n- **Prepared Statements**: Query compilation cached for reuse\n- **Batch Operations**: Multiple events applied in single transaction\n\n### Memory Management\n- **Incremental Loading**: Large datasets loaded on-demand\n- **Query Result Caching**: Expensive query results cached\n- **Event Log Compaction**: Periodic snapshotting and log truncation\n- **Connection Pooling**: Database connections reused across operations\n\n### Network Optimization\n- **Delta Synchronization**: Only sync events since last checkpoint\n- **Compression**: Event payloads compressed for network transfer\n- **Batching**: Multiple events transmitted in single round-trip\n- **Exponential Backoff**: Retry failed sync with increasing delays\n\n## Security Model\n\n### Data Integrity\n- **Event Signatures**: Cryptographic signatures prevent tampering\n- **Merkle Trees**: Efficient verification of event log integrity\n- **Schema Validation**: All events validated against defined schemas\n\n### Access Control\n- **Client-Side Authorization**: Fine-grained permissions in local database\n- **Sync Filtering**: Server filters events based on user permissions\n- **Encryption**: End-to-end encryption for sensitive data\n\n## Observability\n\n### Distributed Tracing\n- **Event Causality**: Trace event propagation across replicas\n- **Sync Performance**: Monitor replication lag and throughput\n- **Conflict Metrics**: Track merge conflicts and resolution strategies\n\n### Health Monitoring\n- **Storage Usage**: Local database size and growth rate\n- **Network Health**: Connection quality and sync success rates\n- **Error Tracking**: Failed operations and their root causes\n\nThis architecture enables applications that work seamlessly offline, sync reliably when online, and provide immediate feedback to users while maintaining data consistency across all replicas.";
 //# sourceMappingURL=architecture.d.ts.map

package/dist/mcp-content/architecture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"architecture.d.ts","sourceRoot":"","sources":["../../src/mcp-content/architecture.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,29MAyKgK,CAAA"}
+{"version":3,"file":"architecture.d.ts","sourceRoot":"","sources":["../../src/mcp-content/architecture.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,w9MAyKgK,CAAA"}

package/dist/mcp-content/architecture.js

@@ -28,9 +28,9 @@ LiveStore implements distributed systems principles from Martin Kleppmann's rese
 \`\`\`typescript
 // Materialized views from event log
 const materializers = State.SQLite.materializers(events, {
-  'TodoCreated': ({ id, text, createdAt }) => 
+  'TodoCreated': ({ id, text, createdAt }) =>
     tables.todos.insert({ id, text, completed: false, createdAt }),
-  'TodoCompleted': ({ id }) => 
+  'TodoCompleted': ({ id }) =>
     tables.todos.update({ completed: true }).where({ id })
 })
 \`\`\`
@@ -46,7 +46,7 @@ const materializers = State.SQLite.materializers(events, {
 const events = {
   todoCompleted: Events.synced({
     name: 'v1.TodoCompleted',
-    schema: Schema.Struct({ 
+    schema: Schema.Struct({
       id: Schema.String,
       completedAt: Schema.Date // For conflict resolution
     })

package/dist/mcp-content/features.d.ts

@@ -1,2 +1,2 @@
-export declare const featuresContent = "# LiveStore Features: Production-Ready Local-First Data\n\nLiveStore provides battle-tested primitives for building collaborative, offline-capable applications with the reliability and performance of modern distributed systems.\n\n## \uD83C\uDFE0 Local-First Architecture\n\n### Offline-First Operation\n- **Zero Latency**: All operations execute against local SQLite database\n- **Offline Capable**: Full application functionality without network connectivity\n- **Network Resilient**: Graceful degradation during connectivity issues\n- **Background Sync**: Automatic synchronization when network becomes available\n\n### Immediate Consistency\n- **Optimistic Updates**: UI updates immediately on user action\n- **Rollback on Conflict**: Automatic rollback and retry on merge conflicts\n- **Causal Consistency**: Operations maintain causal ordering across replicas\n\n## \uD83D\uDD04 Event-Driven Synchronization\n\n### Conflict-Free Event Model\n```typescript\n// Events designed for conflict-free merging\nconst events = {\n  todoCreated: Events.synced({\n    name: 'v1.TodoCreated',\n    schema: Schema.Struct({\n      id: Schema.String,      // Deterministic ordering\n      createdAt: Schema.Date, // Timestamp for LWW resolution\n      position: Schema.Number // Fractional indexing for reordering\n    })\n  })\n}\n```\n\n### Sophisticated Merge Strategies\n- **Last-Write-Wins**: Timestamp-based conflict resolution\n- **Semantic Merging**: Application-specific merge logic\n- **Operational Transform**: Real-time collaborative text editing\n- **CRDT Integration**: Conflict-free replicated data types\n\n### Incremental Synchronization\n- **Delta Sync**: Only transmit changes since last synchronization\n- **Vector Clocks**: Efficient causal dependency tracking\n- **Merkle Trees**: Efficient integrity verification\n- **Batch Optimization**: Multiple events in single network round-trip\n\n## \uD83D\uDCCA Reactive Query Engine\n\n### Real-Time Reactivity\n```typescript\n// Queries automatically update when underlying data changes\nconst activeTodos$ = queryDb(\n  tables.todos\n    .select()\n    .where({ completed: false, deletedAt: null })\n    .orderBy('position'),\n  { label: 'activeTodos' }\n)\n```\n\n### Advanced Query Capabilities\n- **Joins & Aggregations**: Full SQL expressiveness\n- **Reactive Subscriptions**: Automatic UI updates on data changes\n- **Query Optimization**: SQLite query planner with B-tree indexes\n- **Prepared Statements**: Cached query compilation for performance\n\n### Framework Integrations\n- **React**: `useLiveQuery()` hook for reactive components\n- **Vue**: Composables for reactive data binding\n- **Solid**: Reactive primitives integration\n- **Svelte**: Store-based reactive updates\n\n## \uD83D\uDD10 End-to-End Type Safety\n\n### Schema-First Development\n```typescript\n// Type safety from database to UI\nconst todoSchema = State.SQLite.table({\n  name: 'todos',\n  columns: {\n    id: State.SQLite.text({ primaryKey: true }),\n    title: State.SQLite.text(),\n    completed: State.SQLite.boolean()\n  }\n})\n\n// Fully typed queries\ntype Todo = typeof todoSchema.select.Type // { id: string, title: string, completed: boolean }\n```\n\n### Runtime Validation\n- **Schema Validation**: All events validated against Effect schemas\n- **Migration Safety**: Type-safe schema evolution\n- **Parse Don't Validate**: Schema types flow through entire application\n\n## \uD83C\uDF10 Multi-Platform Support\n\n### Web Platform\n- **Origin Private File System**: Persistent storage in modern browsers\n- **SharedWorker**: Cross-tab synchronization and resource sharing\n- **IndexedDB Fallback**: Compatibility with older browsers\n- **Service Worker**: Background synchronization\n\n### Node.js Platform\n- **File System Storage**: Native SQLite database files\n- **Cluster Coordination**: Multi-process synchronization\n- **HTTP/WebSocket Sync**: Flexible transport protocols\n- **Background Jobs**: Scheduled synchronization tasks\n\n### Mobile Platforms (Expo/React Native)\n- **Native SQLite**: Platform-optimized database performance\n- **Background Sync**: Synchronization during app backgrounding\n- **Push Notifications**: Real-time update notifications\n- **Secure Storage**: Encrypted local data storage\n\n## \uD83D\uDE80 Performance & Scalability\n\n### Query Performance\n- **Sub-millisecond Queries**: Local SQLite performance\n- **Efficient Indexing**: Automatic index recommendations\n- **Result Set Streaming**: Large datasets loaded incrementally\n- **Query Result Caching**: Expensive computations cached\n\n### Memory Management\n- **Lazy Loading**: Data loaded on-demand\n- **Connection Pooling**: Database connections efficiently reused\n- **Event Log Compaction**: Periodic snapshots prevent unbounded growth\n- **Garbage Collection**: Automatic cleanup of obsolete data\n\n### Network Optimization\n- **Compression**: Event payloads compressed for transmission\n- **Request Batching**: Multiple operations in single request\n- **Connection Pooling**: HTTP/WebSocket connections reused\n- **Exponential Backoff**: Intelligent retry strategies\n\n## \uD83C\uDFD7\uFE0F Developer Experience\n\n### Testing & Debugging\n```typescript\n// Built-in testing utilities\nconst testStore = createTestStore(schema)\n\n// Deterministic event replay for testing\nawait testStore.replay([\n  events.todoCreated({ id: '1', title: 'Test todo' }),\n  events.todoCompleted({ id: '1' })\n])\n```\n\n### Developer Tools\n- **Event Inspector**: Real-time event log visualization\n- **Query Profiler**: Performance analysis for slow queries  \n- **Sync Monitor**: Network synchronization health dashboard\n- **Schema Explorer**: Interactive database schema browsing\n\n### Production Monitoring\n- **Distributed Tracing**: Event propagation across replicas\n- **Performance Metrics**: Query latency and throughput monitoring\n- **Error Tracking**: Comprehensive error reporting and alerting\n- **Health Checks**: Automated system health verification\n\n## \uD83D\uDD12 Security & Privacy\n\n### Data Protection\n- **End-to-End Encryption**: Client-side encryption before transmission\n- **Event Signatures**: Cryptographic integrity verification\n- **Access Control**: Fine-grained permission system\n- **Audit Logging**: Comprehensive security event logging\n\n### Privacy by Design\n- **Local Data Control**: Users maintain complete data ownership\n- **Selective Sync**: Fine-grained control over data sharing\n- **Data Minimization**: Only sync necessary data\n- **GDPR Compliance**: Built-in privacy compliance features\n\nLiveStore combines the reliability of traditional databases with the performance and user experience of local-first applications, enabling you to build applications that users love while maintaining the technical rigor of distributed systems.";
+export declare const featuresContent = "# LiveStore Features: Production-Ready Local-First Data\n\nLiveStore provides battle-tested primitives for building collaborative, offline-capable applications with the reliability and performance of modern distributed systems.\n\n## \uD83C\uDFE0 Local-First Architecture\n\n### Offline-First Operation\n- **Zero Latency**: All operations execute against local SQLite database\n- **Offline Capable**: Full application functionality without network connectivity\n- **Network Resilient**: Graceful degradation during connectivity issues\n- **Background Sync**: Automatic synchronization when network becomes available\n\n### Immediate Consistency\n- **Optimistic Updates**: UI updates immediately on user action\n- **Rollback on Conflict**: Automatic rollback and retry on merge conflicts\n- **Causal Consistency**: Operations maintain causal ordering across replicas\n\n## \uD83D\uDD04 Event-Driven Synchronization\n\n### Conflict-Free Event Model\n```typescript\n// Events designed for conflict-free merging\nconst events = {\n  todoCreated: Events.synced({\n    name: 'v1.TodoCreated',\n    schema: Schema.Struct({\n      id: Schema.String,      // Deterministic ordering\n      createdAt: Schema.Date, // Timestamp for LWW resolution\n      position: Schema.Number // Fractional indexing for reordering\n    })\n  })\n}\n```\n\n### Sophisticated Merge Strategies\n- **Last-Write-Wins**: Timestamp-based conflict resolution\n- **Semantic Merging**: Application-specific merge logic\n- **Operational Transform**: Real-time collaborative text editing\n- **CRDT Integration**: Conflict-free replicated data types\n\n### Incremental Synchronization\n- **Delta Sync**: Only transmit changes since last synchronization\n- **Vector Clocks**: Efficient causal dependency tracking\n- **Merkle Trees**: Efficient integrity verification\n- **Batch Optimization**: Multiple events in single network round-trip\n\n## \uD83D\uDCCA Reactive Query Engine\n\n### Real-Time Reactivity\n```typescript\n// Queries automatically update when underlying data changes\nconst activeTodos$ = queryDb(\n  tables.todos\n    .select()\n    .where({ completed: false, deletedAt: null })\n    .orderBy('position'),\n  { label: 'activeTodos' }\n)\n```\n\n### Advanced Query Capabilities\n- **Joins & Aggregations**: Full SQL expressiveness\n- **Reactive Subscriptions**: Automatic UI updates on data changes\n- **Query Optimization**: SQLite query planner with B-tree indexes\n- **Prepared Statements**: Cached query compilation for performance\n\n### Framework Integrations\n- **React**: `useLiveQuery()` hook for reactive components\n- **Vue**: Composables for reactive data binding\n- **Solid**: Reactive primitives integration\n- **Svelte**: Store-based reactive updates\n\n## \uD83D\uDD10 End-to-End Type Safety\n\n### Schema-First Development\n```typescript\n// Type safety from database to UI\nconst todoSchema = State.SQLite.table({\n  name: 'todos',\n  columns: {\n    id: State.SQLite.text({ primaryKey: true }),\n    title: State.SQLite.text(),\n    completed: State.SQLite.boolean()\n  }\n})\n\n// Fully typed queries\ntype Todo = typeof todoSchema.select.Type // { id: string, title: string, completed: boolean }\n```\n\n### Runtime Validation\n- **Schema Validation**: All events validated against Effect schemas\n- **Migration Safety**: Type-safe schema evolution\n- **Parse Don't Validate**: Schema types flow through entire application\n\n## \uD83C\uDF10 Multi-Platform Support\n\n### Web Platform\n- **Origin Private File System**: Persistent storage in modern browsers\n- **SharedWorker**: Cross-tab synchronization and resource sharing\n- **IndexedDB Fallback**: Compatibility with older browsers\n- **Service Worker**: Background synchronization\n\n### Node.js Platform\n- **File System Storage**: Native SQLite database files\n- **Cluster Coordination**: Multi-process synchronization\n- **HTTP/WebSocket Sync**: Flexible transport protocols\n- **Background Jobs**: Scheduled synchronization tasks\n\n### Mobile Platforms (Expo/React Native)\n- **Native SQLite**: Platform-optimized database performance\n- **Background Sync**: Synchronization during app backgrounding\n- **Push Notifications**: Real-time update notifications\n- **Secure Storage**: Encrypted local data storage\n\n## \uD83D\uDE80 Performance & Scalability\n\n### Query Performance\n- **Sub-millisecond Queries**: Local SQLite performance\n- **Efficient Indexing**: Automatic index recommendations\n- **Result Set Streaming**: Large datasets loaded incrementally\n- **Query Result Caching**: Expensive computations cached\n\n### Memory Management\n- **Lazy Loading**: Data loaded on-demand\n- **Connection Pooling**: Database connections efficiently reused\n- **Event Log Compaction**: Periodic snapshots prevent unbounded growth\n- **Garbage Collection**: Automatic cleanup of obsolete data\n\n### Network Optimization\n- **Compression**: Event payloads compressed for transmission\n- **Request Batching**: Multiple operations in single request\n- **Connection Pooling**: HTTP/WebSocket connections reused\n- **Exponential Backoff**: Intelligent retry strategies\n\n## \uD83C\uDFD7\uFE0F Developer Experience\n\n### Testing & Debugging\n```typescript\n// Built-in testing utilities\nconst testStore = createTestStore(schema)\n\n// Deterministic event replay for testing\nawait testStore.replay([\n  events.todoCreated({ id: '1', title: 'Test todo' }),\n  events.todoCompleted({ id: '1' })\n])\n```\n\n### Developer Tools\n- **Event Inspector**: Real-time event log visualization\n- **Query Profiler**: Performance analysis for slow queries\n- **Sync Monitor**: Network synchronization health dashboard\n- **Schema Explorer**: Interactive database schema browsing\n\n### Production Monitoring\n- **Distributed Tracing**: Event propagation across replicas\n- **Performance Metrics**: Query latency and throughput monitoring\n- **Error Tracking**: Comprehensive error reporting and alerting\n- **Health Checks**: Automated system health verification\n\n## \uD83D\uDD12 Security & Privacy\n\n### Data Protection\n- **End-to-End Encryption**: Client-side encryption before transmission\n- **Event Signatures**: Cryptographic integrity verification\n- **Access Control**: Fine-grained permission system\n- **Audit Logging**: Comprehensive security event logging\n\n### Privacy by Design\n- **Local Data Control**: Users maintain complete data ownership\n- **Selective Sync**: Fine-grained control over data sharing\n- **Data Minimization**: Only sync necessary data\n- **GDPR Compliance**: Built-in privacy compliance features\n\nLiveStore combines the reliability of traditional databases with the performance and user experience of local-first applications, enabling you to build applications that users love while maintaining the technical rigor of distributed systems.";
 //# sourceMappingURL=features.d.ts.map

package/dist/mcp-content/features.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"features.d.ts","sourceRoot":"","sources":["../../src/mcp-content/features.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,grNA+KuN,CAAA"}
+{"version":3,"file":"features.d.ts","sourceRoot":"","sources":["../../src/mcp-content/features.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,8qNA+KuN,CAAA"}

package/dist/mcp-content/features.js

@@ -149,7 +149,7 @@ await testStore.replay([
 
 ### Developer Tools
 - **Event Inspector**: Real-time event log visualization
-- **Query Profiler**: Performance analysis for slow queries  
+- **Query Profiler**: Performance analysis for slow queries
 - **Sync Monitor**: Network synchronization health dashboard
 - **Schema Explorer**: Interactive database schema browsing
 

package/dist/mcp-content/getting-started.d.ts

@@ -1,2 +1,2 @@
-export declare const gettingStartedContent = "# Getting Started with LiveStore\n\nBuild your first local-first application with LiveStore in minutes. This guide walks through creating a real-time collaborative todo app that works offline and syncs when online.\n\n## Quick Start\n\n### 1. Installation\n\n```bash\n# Install LiveStore core\nnpm install @livestore/livestore\n\n# Choose your platform adapter\nnpm install @livestore/adapter-web      # For web applications\nnpm install @livestore/adapter-node     # For Node.js applications\nnpm install @livestore/adapter-expo     # For React Native/Expo apps\n```\n\n### 2. Define Your Schema\n\nLiveStore uses an event-driven architecture where all changes are recorded as immutable events and applied to materialized SQLite tables.\n\n```typescript\n// schema.ts\nimport { Events, makeSchema, Schema, SessionIdSymbol, State } from '@livestore/livestore'\n\n// Define your state as SQLite tables\nexport const tables = {\n  todos: State.SQLite.table({\n    name: 'todos',\n    columns: {\n      id: State.SQLite.text({ primaryKey: true }),\n      text: State.SQLite.text({ default: '' }),\n      completed: State.SQLite.boolean({ default: false }),\n      deletedAt: State.SQLite.integer({ nullable: true, schema: Schema.DateFromNumber }),\n      createdAt: State.SQLite.integer({ schema: Schema.DateFromNumber }),\n    },\n  }),\n  \n  // Client-only state (not synced)\n  uiState: State.SQLite.clientDocument({\n    name: 'uiState',\n    schema: Schema.Struct({ \n      newTodoText: Schema.String, \n      filter: Schema.Literal('all', 'active', 'completed') \n    }),\n    default: { id: SessionIdSymbol, value: { newTodoText: '', filter: 'all' } },\n  }),\n}\n\n// Define events that represent state changes\nexport const events = {\n  todoCreated: Events.synced({\n    name: 'v1.TodoCreated',\n    schema: Schema.Struct({ \n      id: Schema.String, \n      text: Schema.String,\n      createdAt: Schema.Date \n    }),\n  }),\n  todoCompleted: Events.synced({\n    name: 'v1.TodoCompleted',\n    schema: Schema.Struct({ id: Schema.String }),\n  }),\n  todoUncompleted: Events.synced({\n    name: 'v1.TodoUncompleted',\n    schema: Schema.Struct({ id: Schema.String }),\n  }),\n  todoDeleted: Events.synced({\n    name: 'v1.TodoDeleted',\n    schema: Schema.Struct({ id: Schema.String, deletedAt: Schema.Date }),\n  }),\n  \n  // UI state events (local only)\n  uiStateSet: tables.uiState.set,\n}\n\n// Materializers map events to state changes\nconst materializers = State.SQLite.materializers(events, {\n  'v1.TodoCreated': ({ id, text, createdAt }) => \n    tables.todos.insert({ id, text, completed: false, createdAt }),\n    \n  'v1.TodoCompleted': ({ id }) => \n    tables.todos.update({ completed: true }).where({ id }),\n    \n  'v1.TodoUncompleted': ({ id }) => \n    tables.todos.update({ completed: false }).where({ id }),\n    \n  'v1.TodoDeleted': ({ id, deletedAt }) => \n    tables.todos.update({ deletedAt }).where({ id }),\n})\n\nconst state = State.SQLite.makeState({ tables, materializers })\n\nexport const schema = makeSchema({ events, state })\n```\n\n### 3. Create Reactive Queries\n\nLiveStore queries automatically update your UI when underlying data changes.\n\n```typescript\n// queries.ts\nimport { queryDb } from '@livestore/livestore'\nimport { tables } from './schema.js'\n\n// Reactive query for all active todos\nexport const activeTodos$ = queryDb(\n  tables.todos\n    .select()\n    .where({ deletedAt: null, completed: false })\n    .orderBy('createdAt'),\n  { label: 'activeTodos' }\n)\n\n// Reactive query for completed todos\nexport const completedTodos$ = queryDb(\n  tables.todos\n    .select()\n    .where({ deletedAt: null, completed: true })\n    .orderBy('createdAt'),\n  { label: 'completedTodos' }\n)\n\n// UI state query\nexport const uiState$ = queryDb(\n  tables.uiState.get(),\n  { label: 'uiState' }\n)\n```\n\n### 4. Connect to Your UI Framework\n\n#### React Integration\n\n```typescript\n// TodoApp.tsx\nimport React from 'react'\nimport { useLiveQuery, dispatchEvent } from '@livestore/react'\nimport { activeTodos$, completedTodos$, uiState$ } from './queries.js'\nimport { events } from './schema.js'\n\nconst TodoApp: React.FC = () => {\n  const activeTodos = useLiveQuery(activeTodos$)\n  const completedTodos = useLiveQuery(completedTodos$)\n  const uiState = useLiveQuery(uiState$)\n  \n  const createTodo = (text: string) => {\n    const id = crypto.randomUUID()\n    dispatchEvent(events.todoCreated({ id, text, createdAt: new Date() }))\n  }\n  \n  const toggleTodo = (id: string, completed: boolean) => {\n    dispatchEvent(\n      completed \n        ? events.todoCompleted({ id })\n        : events.todoUncompleted({ id })\n    )\n  }\n  \n  const deleteTodo = (id: string) => {\n    dispatchEvent(events.todoDeleted({ id, deletedAt: new Date() }))\n  }\n  \n  return (\n    <div className=\"todo-app\">\n      <h1>Local-First Todos</h1>\n      \n      {/* Add todo form */}\n      <form onSubmit={(e) => {\n        e.preventDefault()\n        const form = e.target as HTMLFormElement\n        const input = form.elements.namedItem('todo') as HTMLInputElement\n        if (input.value.trim()) {\n          createTodo(input.value.trim())\n          input.value = ''\n        }\n      }}>\n        <input name=\"todo\" placeholder=\"What needs to be done?\" />\n        <button type=\"submit\">Add Todo</button>\n      </form>\n      \n      {/* Active todos */}\n      <div className=\"todo-list\">\n        <h2>Active ({activeTodos.length})</h2>\n        {activeTodos.map(todo => (\n          <div key={todo.id} className=\"todo-item\">\n            <input \n              type=\"checkbox\"\n              checked={false}\n              onChange={() => toggleTodo(todo.id, true)}\n            />\n            <span>{todo.text}</span>\n            <button onClick={() => deleteTodo(todo.id)}>Delete</button>\n          </div>\n        ))}\n      </div>\n      \n      {/* Completed todos */}\n      <div className=\"todo-list\">\n        <h2>Completed ({completedTodos.length})</h2>\n        {completedTodos.map(todo => (\n          <div key={todo.id} className=\"todo-item completed\">\n            <input \n              type=\"checkbox\"\n              checked={true}\n              onChange={() => toggleTodo(todo.id, false)}\n            />\n            <span>{todo.text}</span>\n            <button onClick={() => deleteTodo(todo.id)}>Delete</button>\n          </div>\n        ))}\n      </div>\n    </div>\n  )\n}\n\nexport default TodoApp\n```\n\n#### Vue Integration\n\n```vue\n<!-- TodoApp.vue -->\n<template>\n  <div class=\"todo-app\">\n    <h1>Local-First Todos</h1>\n    \n    <form @submit.prevent=\"createTodo\">\n      <input v-model=\"newTodoText\" placeholder=\"What needs to be done?\" />\n      <button type=\"submit\">Add Todo</button>\n    </form>\n    \n    <div class=\"todo-list\">\n      <h2>Active ({{ activeTodos.length }})</h2>\n      <div v-for=\"todo in activeTodos\" :key=\"todo.id\" class=\"todo-item\">\n        <input \n          type=\"checkbox\"\n          :checked=\"false\"\n          @change=\"toggleTodo(todo.id, true)\"\n        />\n        <span>{{ todo.text }}</span>\n        <button @click=\"deleteTodo(todo.id)\">Delete</button>\n      </div>\n    </div>\n  </div>\n</template>\n\n<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { useLiveQuery, dispatchEvent } from '@livestore/vue'\nimport { activeTodos$ } from './queries.js'\nimport { events } from './schema.js'\n\nconst activeTodos = useLiveQuery(activeTodos$)\nconst newTodoText = ref('')\n\nconst createTodo = () => {\n  if (newTodoText.value.trim()) {\n    const id = crypto.randomUUID()\n    dispatchEvent(events.todoCreated({ \n      id, \n      text: newTodoText.value.trim(), \n      createdAt: new Date() \n    }))\n    newTodoText.value = ''\n  }\n}\n\nconst toggleTodo = (id: string, completed: boolean) => {\n  dispatchEvent(\n    completed \n      ? events.todoCompleted({ id })\n      : events.todoUncompleted({ id })\n  )\n}\n\nconst deleteTodo = (id: string) => {\n  dispatchEvent(events.todoDeleted({ id, deletedAt: new Date() }))\n}\n</script>\n```\n\n### 5. Initialize Your Application\n\n```typescript\n// main.ts\nimport { LiveStore } from '@livestore/livestore'\nimport { WebAdapter } from '@livestore/adapter-web'\nimport { schema } from './schema.js'\n\n// Initialize LiveStore with your schema\nconst liveStore = LiveStore.create({\n  schema,\n  adapter: WebAdapter({\n    databaseName: 'todo-app',\n    // Optional: Add sync configuration\n    sync: {\n      url: 'wss://your-sync-server.com',\n      auth: { token: 'your-auth-token' }\n    }\n  })\n})\n\n// Start your application\nconst app = document.getElementById('app')\nif (app) {\n  // Your framework-specific initialization\n  // React: createRoot(app).render(<TodoApp />)\n  // Vue: createApp(TodoApp).mount(app)\n}\n```\n\n## Advanced Features\n\n### Offline Support\n\nYour app automatically works offline. All operations execute against the local database, and changes sync when connectivity returns.\n\n```typescript\n// Check online status\nconst isOnline$ = queryDb(\n  LiveStore.connectionStatus(),\n  { label: 'connectionStatus' }\n)\n```\n\n### Real-Time Collaboration\n\nMultiple users can collaborate in real-time. Conflicts are automatically resolved using last-write-wins or custom merge strategies.\n\n```typescript\n// Custom conflict resolution\nconst materializers = State.SQLite.materializers(events, {\n  'v1.TodoTextChanged': ({ id, text, editedAt }) => \n    // Use timestamp for conflict resolution\n    tables.todos\n      .update({ text, editedAt })\n      .where({ id })\n      .and(tables.todos.column('editedAt').lt(editedAt))\n})\n```\n\n### Testing\n\n```typescript\n// todo.test.ts\nimport { createTestStore } from '@livestore/testing'\nimport { schema, events } from './schema.js'\n\ntest('creating and completing todos', async () => {\n  const store = createTestStore(schema)\n  \n  // Dispatch events\n  await store.dispatch([\n    events.todoCreated({ id: '1', text: 'Test todo', createdAt: new Date() }),\n    events.todoCompleted({ id: '1' })\n  ])\n  \n  // Query final state\n  const completedTodos = await store.query(\n    tables.todos.select().where({ completed: true })\n  )\n  \n  expect(completedTodos).toHaveLength(1)\n  expect(completedTodos[0].text).toBe('Test todo')\n})\n```\n\n## Next Steps\n\n### Production Deployment\n1. **Set up sync server**: Deploy LiveStore sync server for real-time collaboration\n2. **Configure authentication**: Add user authentication and authorization\n3. **Add monitoring**: Set up distributed tracing and performance monitoring\n4. **Optimize performance**: Add indexes and query optimization\n\n### Advanced Patterns\n- **Multi-user collaboration**: User permissions and access control\n- **Rich text editing**: Operational transforms for collaborative editing\n- **File synchronization**: Binary data and file attachment handling\n- **Schema migrations**: Evolving your data model over time\n\n### Platform-Specific Guides\n- **Web deployment**: Service workers, PWA configuration, OPFS optimization\n- **Mobile apps**: Background sync, push notifications, native storage\n- **Desktop apps**: Electron integration, native file system access\n\n## Examples Repository\n\nExplore complete working examples:\n- **TodoMVC**: Classic todo app with real-time sync\n- **Collaborative Editor**: Rich text editing with operational transforms\n- **Chat Application**: Real-time messaging with presence indicators\n- **E-commerce**: Product catalog with shopping cart and orders\n\n```bash\n# Clone examples repository\ngit clone https://github.com/livestorejs/examples.git\ncd examples/web-todomvc\nnpm install && npm run dev\n```\n\nVisit [docs.livestore.dev](https://docs.livestore.dev) for comprehensive documentation, API reference, and advanced patterns.";
+export declare const gettingStartedContent = "# Getting Started with LiveStore\n\nBuild your first local-first application with LiveStore in minutes. This guide walks through creating a real-time collaborative todo app that works offline and syncs when online.\n\n## Quick Start\n\n### 1. Installation\n\n```bash\n# Install LiveStore core\nnpm install @livestore/livestore\n\n# Choose your platform adapter\nnpm install @livestore/adapter-web      # For web applications\nnpm install @livestore/adapter-node     # For Node.js applications\nnpm install @livestore/adapter-expo     # For React Native/Expo apps\n```\n\n### 2. Define Your Schema\n\nLiveStore uses an event-driven architecture where all changes are recorded as immutable events and applied to materialized SQLite tables.\n\n```typescript\n// schema.ts\nimport { Events, makeSchema, Schema, SessionIdSymbol, State } from '@livestore/livestore'\n\n// Define your state as SQLite tables\nexport const tables = {\n  todos: State.SQLite.table({\n    name: 'todos',\n    columns: {\n      id: State.SQLite.text({ primaryKey: true }),\n      text: State.SQLite.text({ default: '' }),\n      completed: State.SQLite.boolean({ default: false }),\n      deletedAt: State.SQLite.integer({ nullable: true, schema: Schema.DateFromNumber }),\n      createdAt: State.SQLite.integer({ schema: Schema.DateFromNumber }),\n    },\n  }),\n\n  // Client-only state (not synced)\n  uiState: State.SQLite.clientDocument({\n    name: 'uiState',\n    schema: Schema.Struct({\n      newTodoText: Schema.String,\n      filter: Schema.Literal('all', 'active', 'completed')\n    }),\n    default: { id: SessionIdSymbol, value: { newTodoText: '', filter: 'all' } },\n  }),\n}\n\n// Define events that represent state changes\nexport const events = {\n  todoCreated: Events.synced({\n    name: 'v1.TodoCreated',\n    schema: Schema.Struct({\n      id: Schema.String,\n      text: Schema.String,\n      createdAt: Schema.Date\n    }),\n  }),\n  todoCompleted: Events.synced({\n    name: 'v1.TodoCompleted',\n    schema: Schema.Struct({ id: Schema.String }),\n  }),\n  todoUncompleted: Events.synced({\n    name: 'v1.TodoUncompleted',\n    schema: Schema.Struct({ id: Schema.String }),\n  }),\n  todoDeleted: Events.synced({\n    name: 'v1.TodoDeleted',\n    schema: Schema.Struct({ id: Schema.String, deletedAt: Schema.Date }),\n  }),\n\n  // UI state events (local only)\n  uiStateSet: tables.uiState.set,\n}\n\n// Materializers map events to state changes\nconst materializers = State.SQLite.materializers(events, {\n  'v1.TodoCreated': ({ id, text, createdAt }) =>\n    tables.todos.insert({ id, text, completed: false, createdAt }),\n\n  'v1.TodoCompleted': ({ id }) =>\n    tables.todos.update({ completed: true }).where({ id }),\n\n  'v1.TodoUncompleted': ({ id }) =>\n    tables.todos.update({ completed: false }).where({ id }),\n\n  'v1.TodoDeleted': ({ id, deletedAt }) =>\n    tables.todos.update({ deletedAt }).where({ id }),\n})\n\nconst state = State.SQLite.makeState({ tables, materializers })\n\nexport const schema = makeSchema({ events, state })\n```\n\n### 3. Create Reactive Queries\n\nLiveStore queries automatically update your UI when underlying data changes.\n\n```typescript\n// queries.ts\nimport { queryDb } from '@livestore/livestore'\nimport { tables } from './schema.js'\n\n// Reactive query for all active todos\nexport const activeTodos$ = queryDb(\n  tables.todos\n    .select()\n    .where({ deletedAt: null, completed: false })\n    .orderBy('createdAt'),\n  { label: 'activeTodos' }\n)\n\n// Reactive query for completed todos\nexport const completedTodos$ = queryDb(\n  tables.todos\n    .select()\n    .where({ deletedAt: null, completed: true })\n    .orderBy('createdAt'),\n  { label: 'completedTodos' }\n)\n\n// UI state query\nexport const uiState$ = queryDb(\n  tables.uiState.get(),\n  { label: 'uiState' }\n)\n```\n\n### 4. Connect to Your UI Framework\n\n#### React Integration\n\n```typescript\n// TodoApp.tsx\nimport React from 'react'\nimport { useLiveQuery, dispatchEvent } from '@livestore/react'\nimport { activeTodos$, completedTodos$, uiState$ } from './queries.js'\nimport { events } from './schema.js'\n\nconst TodoApp: React.FC = () => {\n  const activeTodos = useLiveQuery(activeTodos$)\n  const completedTodos = useLiveQuery(completedTodos$)\n  const uiState = useLiveQuery(uiState$)\n\n  const createTodo = (text: string) => {\n    const id = crypto.randomUUID()\n    dispatchEvent(events.todoCreated({ id, text, createdAt: new Date() }))\n  }\n\n  const toggleTodo = (id: string, completed: boolean) => {\n    dispatchEvent(\n      completed\n        ? events.todoCompleted({ id })\n        : events.todoUncompleted({ id })\n    )\n  }\n\n  const deleteTodo = (id: string) => {\n    dispatchEvent(events.todoDeleted({ id, deletedAt: new Date() }))\n  }\n\n  return (\n    <div className=\"todo-app\">\n      <h1>Local-First Todos</h1>\n\n      {/* Add todo form */}\n      <form onSubmit={(e) => {\n        e.preventDefault()\n        const form = e.target as HTMLFormElement\n        const input = form.elements.namedItem('todo') as HTMLInputElement\n        if (input.value.trim()) {\n          createTodo(input.value.trim())\n          input.value = ''\n        }\n      }}>\n        <input name=\"todo\" placeholder=\"What needs to be done?\" />\n        <button type=\"submit\">Add Todo</button>\n      </form>\n\n      {/* Active todos */}\n      <div className=\"todo-list\">\n        <h2>Active ({activeTodos.length})</h2>\n        {activeTodos.map(todo => (\n          <div key={todo.id} className=\"todo-item\">\n            <input\n              type=\"checkbox\"\n              checked={false}\n              onChange={() => toggleTodo(todo.id, true)}\n            />\n            <span>{todo.text}</span>\n            <button onClick={() => deleteTodo(todo.id)}>Delete</button>\n          </div>\n        ))}\n      </div>\n\n      {/* Completed todos */}\n      <div className=\"todo-list\">\n        <h2>Completed ({completedTodos.length})</h2>\n        {completedTodos.map(todo => (\n          <div key={todo.id} className=\"todo-item completed\">\n            <input\n              type=\"checkbox\"\n              checked={true}\n              onChange={() => toggleTodo(todo.id, false)}\n            />\n            <span>{todo.text}</span>\n            <button onClick={() => deleteTodo(todo.id)}>Delete</button>\n          </div>\n        ))}\n      </div>\n    </div>\n  )\n}\n\nexport default TodoApp\n```\n\n#### Vue Integration\n\n```vue\n<!-- TodoApp.vue -->\n<template>\n  <div class=\"todo-app\">\n    <h1>Local-First Todos</h1>\n\n    <form @submit.prevent=\"createTodo\">\n      <input v-model=\"newTodoText\" placeholder=\"What needs to be done?\" />\n      <button type=\"submit\">Add Todo</button>\n    </form>\n\n    <div class=\"todo-list\">\n      <h2>Active ({{ activeTodos.length }})</h2>\n      <div v-for=\"todo in activeTodos\" :key=\"todo.id\" class=\"todo-item\">\n        <input\n          type=\"checkbox\"\n          :checked=\"false\"\n          @change=\"toggleTodo(todo.id, true)\"\n        />\n        <span>{{ todo.text }}</span>\n        <button @click=\"deleteTodo(todo.id)\">Delete</button>\n      </div>\n    </div>\n  </div>\n</template>\n\n<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { useLiveQuery, dispatchEvent } from '@livestore/vue'\nimport { activeTodos$ } from './queries.js'\nimport { events } from './schema.js'\n\nconst activeTodos = useLiveQuery(activeTodos$)\nconst newTodoText = ref('')\n\nconst createTodo = () => {\n  if (newTodoText.value.trim()) {\n    const id = crypto.randomUUID()\n    dispatchEvent(events.todoCreated({\n      id,\n      text: newTodoText.value.trim(),\n      createdAt: new Date()\n    }))\n    newTodoText.value = ''\n  }\n}\n\nconst toggleTodo = (id: string, completed: boolean) => {\n  dispatchEvent(\n    completed\n      ? events.todoCompleted({ id })\n      : events.todoUncompleted({ id })\n  )\n}\n\nconst deleteTodo = (id: string) => {\n  dispatchEvent(events.todoDeleted({ id, deletedAt: new Date() }))\n}\n</script>\n```\n\n### 5. Initialize Your Application\n\n```typescript\n// main.ts\nimport { LiveStore } from '@livestore/livestore'\nimport { WebAdapter } from '@livestore/adapter-web'\nimport { schema } from './schema.js'\n\n// Initialize LiveStore with your schema\nconst liveStore = LiveStore.create({\n  schema,\n  adapter: WebAdapter({\n    databaseName: 'todo-app',\n    // Optional: Add sync configuration\n    sync: {\n      url: 'wss://your-sync-server.com',\n      auth: { token: 'your-auth-token' }\n    }\n  })\n})\n\n// Start your application\nconst app = document.getElementById('app')\nif (app) {\n  // Your framework-specific initialization\n  // React: createRoot(app).render(<TodoApp />)\n  // Vue: createApp(TodoApp).mount(app)\n}\n```\n\n## Advanced Features\n\n### Offline Support\n\nYour app automatically works offline. All operations execute against the local database, and changes sync when connectivity returns.\n\n```typescript\n// Check online status\nconst isOnline$ = queryDb(\n  LiveStore.connectionStatus(),\n  { label: 'connectionStatus' }\n)\n```\n\n### Real-Time Collaboration\n\nMultiple users can collaborate in real-time. Conflicts are automatically resolved using last-write-wins or custom merge strategies.\n\n```typescript\n// Custom conflict resolution\nconst materializers = State.SQLite.materializers(events, {\n  'v1.TodoTextChanged': ({ id, text, editedAt }) =>\n    // Use timestamp for conflict resolution\n    tables.todos\n      .update({ text, editedAt })\n      .where({ id })\n      .and(tables.todos.column('editedAt').lt(editedAt))\n})\n```\n\n### Testing\n\n```typescript\n// todo.test.ts\nimport { createTestStore } from '@livestore/testing'\nimport { schema, events } from './schema.js'\n\ntest('creating and completing todos', async () => {\n  const store = createTestStore(schema)\n\n  // Dispatch events\n  await store.dispatch([\n    events.todoCreated({ id: '1', text: 'Test todo', createdAt: new Date() }),\n    events.todoCompleted({ id: '1' })\n  ])\n\n  // Query final state\n  const completedTodos = await store.query(\n    tables.todos.select().where({ completed: true })\n  )\n\n  expect(completedTodos).toHaveLength(1)\n  expect(completedTodos[0].text).toBe('Test todo')\n})\n```\n\n## Next Steps\n\n### Production Deployment\n1. **Set up sync server**: Deploy LiveStore sync server for real-time collaboration\n2. **Configure authentication**: Add user authentication and authorization\n3. **Add monitoring**: Set up distributed tracing and performance monitoring\n4. **Optimize performance**: Add indexes and query optimization\n\n### Advanced Patterns\n- **Multi-user collaboration**: User permissions and access control\n- **Rich text editing**: Operational transforms for collaborative editing\n- **File synchronization**: Binary data and file attachment handling\n- **Schema migrations**: Evolving your data model over time\n\n### Platform-Specific Guides\n- **Web deployment**: Service workers, PWA configuration, OPFS optimization\n- **Mobile apps**: Background sync, push notifications, native storage\n- **Desktop apps**: Electron integration, native file system access\n\n## Examples Repository\n\nExplore complete working examples:\n- **TodoMVC**: Classic todo app with real-time sync\n- **Collaborative Editor**: Rich text editing with operational transforms\n- **Chat Application**: Real-time messaging with presence indicators\n- **E-commerce**: Product catalog with shopping cart and orders\n\n```bash\n# Clone examples repository\ngit clone https://github.com/livestorejs/examples.git\ncd examples/web-todomvc\nnpm install && npm run dev\n```\n\nVisit [docs.livestore.dev](https://docs.livestore.dev) for comprehensive documentation, API reference, and advanced patterns.";
 //# sourceMappingURL=getting-started.d.ts.map

package/dist/mcp-content/getting-started.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getting-started.d.ts","sourceRoot":"","sources":["../../src/mcp-content/getting-started.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,4oXAmZ4F,CAAA"}
+{"version":3,"file":"getting-started.d.ts","sourceRoot":"","sources":["../../src/mcp-content/getting-started.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,gkXAmZ4F,CAAA"}

package/dist/mcp-content/getting-started.js

@@ -36,13 +36,13 @@ export const tables = {
       createdAt: State.SQLite.integer({ schema: Schema.DateFromNumber }),
     },
   }),
-  
+
   // Client-only state (not synced)
   uiState: State.SQLite.clientDocument({
     name: 'uiState',
-    schema: Schema.Struct({ 
-      newTodoText: Schema.String, 
-      filter: Schema.Literal('all', 'active', 'completed') 
+    schema: Schema.Struct({
+      newTodoText: Schema.String,
+      filter: Schema.Literal('all', 'active', 'completed')
     }),
     default: { id: SessionIdSymbol, value: { newTodoText: '', filter: 'all' } },
   }),
@@ -52,10 +52,10 @@ export const tables = {
 export const events = {
   todoCreated: Events.synced({
     name: 'v1.TodoCreated',
-    schema: Schema.Struct({ 
-      id: Schema.String, 
+    schema: Schema.Struct({
+      id: Schema.String,
       text: Schema.String,
-      createdAt: Schema.Date 
+      createdAt: Schema.Date
     }),
   }),
   todoCompleted: Events.synced({
@@ -70,23 +70,23 @@ export const events = {
     name: 'v1.TodoDeleted',
     schema: Schema.Struct({ id: Schema.String, deletedAt: Schema.Date }),
   }),
-  
+
   // UI state events (local only)
   uiStateSet: tables.uiState.set,
 }
 
 // Materializers map events to state changes
 const materializers = State.SQLite.materializers(events, {
-  'v1.TodoCreated': ({ id, text, createdAt }) => 
+  'v1.TodoCreated': ({ id, text, createdAt }) =>
     tables.todos.insert({ id, text, completed: false, createdAt }),
-    
-  'v1.TodoCompleted': ({ id }) => 
+
+  'v1.TodoCompleted': ({ id }) =>
     tables.todos.update({ completed: true }).where({ id }),
-    
-  'v1.TodoUncompleted': ({ id }) => 
+
+  'v1.TodoUncompleted': ({ id }) =>
     tables.todos.update({ completed: false }).where({ id }),
-    
-  'v1.TodoDeleted': ({ id, deletedAt }) => 
+
+  'v1.TodoDeleted': ({ id, deletedAt }) =>
     tables.todos.update({ deletedAt }).where({ id }),
 })
 
@@ -144,28 +144,28 @@ const TodoApp: React.FC = () => {
   const activeTodos = useLiveQuery(activeTodos$)
   const completedTodos = useLiveQuery(completedTodos$)
   const uiState = useLiveQuery(uiState$)
-  
+
   const createTodo = (text: string) => {
     const id = crypto.randomUUID()
     dispatchEvent(events.todoCreated({ id, text, createdAt: new Date() }))
   }
-  
+
   const toggleTodo = (id: string, completed: boolean) => {
     dispatchEvent(
-      completed 
+      completed
         ? events.todoCompleted({ id })
         : events.todoUncompleted({ id })
     )
   }
-  
+
   const deleteTodo = (id: string) => {
     dispatchEvent(events.todoDeleted({ id, deletedAt: new Date() }))
   }
-  
+
   return (
     <div className="todo-app">
       <h1>Local-First Todos</h1>
-      
+
       {/* Add todo form */}
       <form onSubmit={(e) => {
         e.preventDefault()
@@ -179,13 +179,13 @@ const TodoApp: React.FC = () => {
         <input name="todo" placeholder="What needs to be done?" />
         <button type="submit">Add Todo</button>
       </form>
-      
+
       {/* Active todos */}
       <div className="todo-list">
         <h2>Active ({activeTodos.length})</h2>
         {activeTodos.map(todo => (
           <div key={todo.id} className="todo-item">
-            <input 
+            <input
               type="checkbox"
               checked={false}
               onChange={() => toggleTodo(todo.id, true)}
@@ -195,13 +195,13 @@ const TodoApp: React.FC = () => {
           </div>
         ))}
       </div>
-      
+
       {/* Completed todos */}
       <div className="todo-list">
         <h2>Completed ({completedTodos.length})</h2>
         {completedTodos.map(todo => (
           <div key={todo.id} className="todo-item completed">
-            <input 
+            <input
               type="checkbox"
               checked={true}
               onChange={() => toggleTodo(todo.id, false)}
@@ -225,16 +225,16 @@ export default TodoApp
 <template>
   <div class="todo-app">
     <h1>Local-First Todos</h1>
-    
+
     <form @submit.prevent="createTodo">
       <input v-model="newTodoText" placeholder="What needs to be done?" />
       <button type="submit">Add Todo</button>
     </form>
-    
+
     <div class="todo-list">
       <h2>Active ({{ activeTodos.length }})</h2>
       <div v-for="todo in activeTodos" :key="todo.id" class="todo-item">
-        <input 
+        <input
           type="checkbox"
           :checked="false"
           @change="toggleTodo(todo.id, true)"
@@ -258,10 +258,10 @@ const newTodoText = ref('')
 const createTodo = () => {
   if (newTodoText.value.trim()) {
     const id = crypto.randomUUID()
-    dispatchEvent(events.todoCreated({ 
-      id, 
-      text: newTodoText.value.trim(), 
-      createdAt: new Date() 
+    dispatchEvent(events.todoCreated({
+      id,
+      text: newTodoText.value.trim(),
+      createdAt: new Date()
     }))
     newTodoText.value = ''
   }
@@ -269,7 +269,7 @@ const createTodo = () => {
 
 const toggleTodo = (id: string, completed: boolean) => {
   dispatchEvent(
-    completed 
+    completed
       ? events.todoCompleted({ id })
       : events.todoUncompleted({ id })
   )
@@ -332,7 +332,7 @@ Multiple users can collaborate in real-time. Conflicts are automatically resolve
 \`\`\`typescript
 // Custom conflict resolution
 const materializers = State.SQLite.materializers(events, {
-  'v1.TodoTextChanged': ({ id, text, editedAt }) => 
+  'v1.TodoTextChanged': ({ id, text, editedAt }) =>
     // Use timestamp for conflict resolution
     tables.todos
       .update({ text, editedAt })
@@ -350,18 +350,18 @@ import { schema, events } from './schema.js'
 
 test('creating and completing todos', async () => {
   const store = createTestStore(schema)
-  
+
   // Dispatch events
   await store.dispatch([
     events.todoCreated({ id: '1', text: 'Test todo', createdAt: new Date() }),
     events.todoCompleted({ id: '1' })
   ])
-  
+
   // Query final state
   const completedTodos = await store.query(
     tables.todos.select().where({ completed: true })
   )
-  
+
   expect(completedTodos).toHaveLength(1)
   expect(completedTodos[0].text).toBe('Test todo')
 })

package/dist/mcp-content/overview.d.ts

@@ -1,2 +1,2 @@
-export declare const overviewContent = "# LiveStore: Local-First Data Platform\n\nLiveStore is a production-ready local-first data platform that combines the immediate responsiveness of local SQLite databases with the collaborative power of real-time synchronization. Built on distributed systems principles from Martin Kleppmann's research, LiveStore enables applications that work seamlessly offline and sync reliably when online.\n\n## Core Philosophy\n\n**Local-First Principles**: Your data lives primarily on your device, not in the cloud. Applications respond immediately to user actions without network round-trips, providing the smooth experience users expect from native applications.\n\n**Collaborative by Design**: Real-time collaboration isn't an afterthought \u2013 it's built into the foundation. Multiple users can work together seamlessly with automatic conflict resolution and eventual consistency guarantees.\n\n**Reliability Through Event Sourcing**: All changes are captured as immutable events, providing a complete audit trail and enabling powerful features like undo/redo, time travel debugging, and deterministic testing.\n\n## What Makes LiveStore Different\n\n### \uD83D\uDCBE Local SQLite Performance\n- **Sub-millisecond queries** from local SQLite database\n- **Complex joins and aggregations** with full SQL expressiveness\n- **Reactive queries** that automatically update your UI\n- **ACID transactions** for data integrity\n\n### \uD83C\uDF10 Distributed Systems Reliability\n- **Conflict-free synchronization** using CRDT-inspired merge strategies\n- **Causal consistency** with vector clocks and event ordering\n- **Network partition tolerance** \u2013 works offline, syncs when online\n- **Eventually consistent** convergence across all replicas\n\n### \uD83D\uDD10 End-to-End Type Safety\n- **Schema-first development** with Effect-based validation\n- **Compile-time query validation** prevents runtime errors  \n- **Automatic TypeScript generation** from schema definitions\n- **Runtime safety** with comprehensive input validation\n\n### \uD83C\uDFD7\uFE0F Framework Agnostic\n- **React, Vue, Solid, Svelte** \u2013 use with any frontend framework\n- **Web, Node.js, React Native** \u2013 deploy anywhere JavaScript runs\n- **Consistent API** across all platforms and frameworks\n\n## Real-World Use Cases\n\n### \uD83D\uDCDD Collaborative Applications\n- **Document editors** with real-time collaboration (Google Docs-style)\n- **Project management** tools with team coordination\n- **Design tools** with multiplayer editing capabilities\n- **Chat applications** with offline message queuing\n\n### \uD83D\uDCF1 Mobile-First Applications  \n- **Field service apps** that work in areas with poor connectivity\n- **Healthcare applications** with sensitive data that must stay local\n- **Educational apps** for students in low-connectivity environments\n- **Financial apps** requiring immediate transaction feedback\n\n### \uD83C\uDFEE Enterprise Applications\n- **CRM systems** with offline sales capability\n- **Inventory management** with real-time stock updates\n- **Customer service** tools with offline case management\n- **Analytics dashboards** with local data caching\n\n## Architecture at a Glance\n\n```mermaid\ngraph TB\n    UI[UI Framework] --> Queries[Reactive Queries]\n    UI --> Events[Event Dispatch]\n    \n    Events --> EventLog[Event Log]\n    EventLog --> Materializers[Materializers]\n    Materializers --> SQLite[SQLite Database]\n    Queries --> SQLite\n    \n    EventLog --> Sync[Sync Engine]\n    Sync --> Network[Network Layer]\n    Network --> Server[Sync Server]\n    \n    Server --> OtherClients[Other Clients]\n    OtherClients --> Server\n    Server --> Network\n```\n\n1. **UI Layer**: Framework-specific bindings (React, Vue, etc.)\n2. **Query Layer**: Reactive SQL queries with automatic UI updates\n3. **Event Layer**: Immutable event log with schema validation\n4. **Materialization**: Events applied to SQLite tables via materializers\n5. **Synchronization**: Conflict-free replication across devices/users\n6. **Storage**: Local SQLite database for immediate data access\n\n## Key Technical Innovations\n\n### Event-Driven State Management\nUnlike traditional ORMs that hide change tracking, LiveStore makes all state changes explicit through events. This provides:\n- **Deterministic state updates** that can be tested and debugged\n- **Conflict resolution** through event reordering and semantic merging\n- **Time travel** capabilities for debugging and feature development\n- **Audit trails** for compliance and data governance\n\n### Sophisticated Conflict Resolution\nLiveStore handles conflicts intelligently using multiple strategies:\n- **Last-Write-Wins**: Simple timestamp-based resolution\n- **Semantic Merging**: Application-specific conflict resolution logic  \n- **Operational Transforms**: For real-time collaborative text editing\n- **CRDT Integration**: Conflict-free data types for specific use cases\n\n### Performance Optimization\n- **Query compilation caching** for repeated queries\n- **Reactive dependency tracking** to minimize unnecessary updates\n- **Incremental synchronization** to reduce network overhead\n- **Background processing** to keep the UI thread responsive\n\n## Production Ready\n\nLiveStore is designed for production applications with enterprise-grade requirements:\n\n- **Security**: End-to-end encryption, event signatures, access control\n- **Observability**: Distributed tracing, performance monitoring, health checks\n- **Scalability**: Horizontal scaling, connection pooling, data partitioning\n- **Reliability**: Automatic retries, circuit breakers, graceful degradation\n\nWhether you're building a simple todo app or a complex collaborative platform, LiveStore provides the foundation for applications that users love \u2013 fast, reliable, and always available.\n\n**Ready to get started?** Check out our [Getting Started Guide](./getting-started) or explore our [Example Applications](https://github.com/livestorejs/examples).";
+export declare const overviewContent = "# LiveStore: Local-First Data Platform\n\nLiveStore is a production-ready local-first data platform that combines the immediate responsiveness of local SQLite databases with the collaborative power of real-time synchronization. Built on distributed systems principles from Martin Kleppmann's research, LiveStore enables applications that work seamlessly offline and sync reliably when online.\n\n## Core Philosophy\n\n**Local-First Principles**: Your data lives primarily on your device, not in the cloud. Applications respond immediately to user actions without network round-trips, providing the smooth experience users expect from native applications.\n\n**Collaborative by Design**: Real-time collaboration isn't an afterthought \u2013 it's built into the foundation. Multiple users can work together seamlessly with automatic conflict resolution and eventual consistency guarantees.\n\n**Reliability Through Event Sourcing**: All changes are captured as immutable events, providing a complete audit trail and enabling powerful features like undo/redo, time travel debugging, and deterministic testing.\n\n## What Makes LiveStore Different\n\n### \uD83D\uDCBE Local SQLite Performance\n- **Sub-millisecond queries** from local SQLite database\n- **Complex joins and aggregations** with full SQL expressiveness\n- **Reactive queries** that automatically update your UI\n- **ACID transactions** for data integrity\n\n### \uD83C\uDF10 Distributed Systems Reliability\n- **Conflict-free synchronization** using CRDT-inspired merge strategies\n- **Causal consistency** with vector clocks and event ordering\n- **Network partition tolerance** \u2013 works offline, syncs when online\n- **Eventually consistent** convergence across all replicas\n\n### \uD83D\uDD10 End-to-End Type Safety\n- **Schema-first development** with Effect-based validation\n- **Compile-time query validation** prevents runtime errors\n- **Automatic TypeScript generation** from schema definitions\n- **Runtime safety** with comprehensive input validation\n\n### \uD83C\uDFD7\uFE0F Framework Agnostic\n- **React, Vue, Solid, Svelte** \u2013 use with any frontend framework\n- **Web, Node.js, React Native** \u2013 deploy anywhere JavaScript runs\n- **Consistent API** across all platforms and frameworks\n\n## Real-World Use Cases\n\n### \uD83D\uDCDD Collaborative Applications\n- **Document editors** with real-time collaboration (Google Docs-style)\n- **Project management** tools with team coordination\n- **Design tools** with multiplayer editing capabilities\n- **Chat applications** with offline message queuing\n\n### \uD83D\uDCF1 Mobile-First Applications\n- **Field service apps** that work in areas with poor connectivity\n- **Healthcare applications** with sensitive data that must stay local\n- **Educational apps** for students in low-connectivity environments\n- **Financial apps** requiring immediate transaction feedback\n\n### \uD83C\uDFEE Enterprise Applications\n- **CRM systems** with offline sales capability\n- **Inventory management** with real-time stock updates\n- **Customer service** tools with offline case management\n- **Analytics dashboards** with local data caching\n\n## Architecture at a Glance\n\n```mermaid\ngraph TB\n    UI[UI Framework] --> Queries[Reactive Queries]\n    UI --> Events[Event Dispatch]\n\n    Events --> EventLog[Event Log]\n    EventLog --> Materializers[Materializers]\n    Materializers --> SQLite[SQLite Database]\n    Queries --> SQLite\n\n    EventLog --> Sync[Sync Engine]\n    Sync --> Network[Network Layer]\n    Network --> Server[Sync Server]\n\n    Server --> OtherClients[Other Clients]\n    OtherClients --> Server\n    Server --> Network\n```\n\n1. **UI Layer**: Framework-specific bindings (React, Vue, etc.)\n2. **Query Layer**: Reactive SQL queries with automatic UI updates\n3. **Event Layer**: Immutable event log with schema validation\n4. **Materialization**: Events applied to SQLite tables via materializers\n5. **Synchronization**: Conflict-free replication across devices/users\n6. **Storage**: Local SQLite database for immediate data access\n\n## Key Technical Innovations\n\n### Event-Driven State Management\nUnlike traditional ORMs that hide change tracking, LiveStore makes all state changes explicit through events. This provides:\n- **Deterministic state updates** that can be tested and debugged\n- **Conflict resolution** through event reordering and semantic merging\n- **Time travel** capabilities for debugging and feature development\n- **Audit trails** for compliance and data governance\n\n### Sophisticated Conflict Resolution\nLiveStore handles conflicts intelligently using multiple strategies:\n- **Last-Write-Wins**: Simple timestamp-based resolution\n- **Semantic Merging**: Application-specific conflict resolution logic\n- **Operational Transforms**: For real-time collaborative text editing\n- **CRDT Integration**: Conflict-free data types for specific use cases\n\n### Performance Optimization\n- **Query compilation caching** for repeated queries\n- **Reactive dependency tracking** to minimize unnecessary updates\n- **Incremental synchronization** to reduce network overhead\n- **Background processing** to keep the UI thread responsive\n\n## Production Ready\n\nLiveStore is designed for production applications with enterprise-grade requirements:\n\n- **Security**: End-to-end encryption, event signatures, access control\n- **Observability**: Distributed tracing, performance monitoring, health checks\n- **Scalability**: Horizontal scaling, connection pooling, data partitioning\n- **Reliability**: Automatic retries, circuit breakers, graceful degradation\n\nWhether you're building a simple todo app or a complex collaborative platform, LiveStore provides the foundation for applications that users love \u2013 fast, reliable, and always available.\n\n**Ready to get started?** Check out our [Getting Started Guide](./getting-started) or explore our [Example Applications](https://github.com/livestorejs/examples).";
 //# sourceMappingURL=overview.d.ts.map

package/dist/mcp-content/overview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"overview.d.ts","sourceRoot":"","sources":["../../src/mcp-content/overview.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,y4LAsHuI,CAAA"}
+{"version":3,"file":"overview.d.ts","sourceRoot":"","sources":["../../src/mcp-content/overview.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,u3LAsHuI,CAAA"}

package/dist/mcp-content/overview.js

@@ -26,7 +26,7 @@ LiveStore is a production-ready local-first data platform that combines the imme
 
 ### 🔐 End-to-End Type Safety
 - **Schema-first development** with Effect-based validation
-- **Compile-time query validation** prevents runtime errors  
+- **Compile-time query validation** prevents runtime errors
 - **Automatic TypeScript generation** from schema definitions
 - **Runtime safety** with comprehensive input validation
 
@@ -43,7 +43,7 @@ LiveStore is a production-ready local-first data platform that combines the imme
 - **Design tools** with multiplayer editing capabilities
 - **Chat applications** with offline message queuing
 
-### 📱 Mobile-First Applications  
+### 📱 Mobile-First Applications
 - **Field service apps** that work in areas with poor connectivity
 - **Healthcare applications** with sensitive data that must stay local
 - **Educational apps** for students in low-connectivity environments
@@ -61,16 +61,16 @@ LiveStore is a production-ready local-first data platform that combines the imme
 graph TB
     UI[UI Framework] --> Queries[Reactive Queries]
     UI --> Events[Event Dispatch]
-    
+
     Events --> EventLog[Event Log]
     EventLog --> Materializers[Materializers]
     Materializers --> SQLite[SQLite Database]
     Queries --> SQLite
-    
+
     EventLog --> Sync[Sync Engine]
     Sync --> Network[Network Layer]
     Network --> Server[Sync Server]
-    
+
     Server --> OtherClients[Other Clients]
     OtherClients --> Server
     Server --> Network
@@ -95,7 +95,7 @@ Unlike traditional ORMs that hide change tracking, LiveStore makes all state cha
 ### Sophisticated Conflict Resolution
 LiveStore handles conflicts intelligently using multiple strategies:
 - **Last-Write-Wins**: Simple timestamp-based resolution
-- **Semantic Merging**: Application-specific conflict resolution logic  
+- **Semantic Merging**: Application-specific conflict resolution logic
 - **Operational Transforms**: For real-time collaborative text editing
 - **CRDT Integration**: Conflict-free data types for specific use cases
 

package/dist/mcp-content/schemas/blog.d.ts

@@ -1,2 +1,2 @@
-export declare const blogSchemaContent = "import { Events, makeSchema, Schema, SessionIdSymbol, State } from '@livestore/livestore'\n\n// Content management with collaborative editing capabilities\nexport const tables = {\n  posts: State.SQLite.table({\n    name: 'posts',\n    columns: {\n      id: State.SQLite.text({ primaryKey: true }),\n      title: State.SQLite.text(),\n      content: State.SQLite.text(), // Consider using JSON for rich text operations\n      slug: State.SQLite.text(),\n      published: State.SQLite.boolean({ default: false }),\n      authorId: State.SQLite.text(),\n      createdAt: State.SQLite.integer({ schema: Schema.DateFromNumber }),\n      publishedAt: State.SQLite.integer({ nullable: true, schema: Schema.DateFromNumber }),\n      deletedAt: State.SQLite.integer({ nullable: true, schema: Schema.DateFromNumber }),\n      version: State.SQLite.integer({ default: 1 }), // For optimistic concurrency\n    },\n  }),\n  \n  comments: State.SQLite.table({\n    name: 'comments',\n    columns: {\n      id: State.SQLite.text({ primaryKey: true }),\n      postId: State.SQLite.text(),\n      authorId: State.SQLite.text(),\n      content: State.SQLite.text(),\n      parentId: State.SQLite.text({ nullable: true }), // For threaded comments\n      createdAt: State.SQLite.integer({ schema: Schema.DateFromNumber }),\n      editedAt: State.SQLite.integer({ nullable: true, schema: Schema.DateFromNumber }),\n      deletedAt: State.SQLite.integer({ nullable: true, schema: Schema.DateFromNumber }),\n    },\n  }),\n  \n  authors: State.SQLite.table({\n    name: 'authors',\n    columns: {\n      id: State.SQLite.text({ primaryKey: true }),\n      name: State.SQLite.text(),\n      email: State.SQLite.text(),\n      bio: State.SQLite.text({ nullable: true }),\n      avatarUrl: State.SQLite.text({ nullable: true }),\n      createdAt: State.SQLite.integer({ schema: Schema.DateFromNumber }),\n    },\n  }),\n  \n  // Track collaborative editing sessions\n  editingSessions: State.SQLite.clientDocument({\n    name: 'editingSessions',\n    schema: Schema.Struct({\n      postId: Schema.String,\n      authorId: Schema.String,\n      lastActivity: Schema.Date,\n      cursorPosition: Schema.Number,\n    }),\n    default: { \n      id: SessionIdSymbol, \n      value: { postId: '', authorId: '', lastActivity: new Date(), cursorPosition: 0 }\n    },\n  }),\n}\n\nexport const events = {\n  // Post lifecycle events\n  postCreated: Events.synced({\n    name: 'v1.PostCreated',\n    schema: Schema.Struct({\n      id: Schema.String,\n      title: Schema.String,\n      slug: Schema.String,\n      authorId: Schema.String,\n      createdAt: Schema.Date,\n    }),\n  }),\n  \n  postTitleChanged: Events.synced({\n    name: 'v1.PostTitleChanged',\n    schema: Schema.Struct({\n      id: Schema.String,\n      title: Schema.String,\n      version: Schema.Number, // Optimistic concurrency control\n    }),\n  }),\n  \n  postContentChanged: Events.synced({\n    name: 'v1.PostContentChanged',\n    schema: Schema.Struct({\n      id: Schema.String,\n      content: Schema.String,\n      version: Schema.Number,\n      authorId: Schema.String,\n    }),\n  }),\n  \n  postPublished: Events.synced({\n    name: 'v1.PostPublished',\n    schema: Schema.Struct({\n      id: Schema.String,\n      publishedAt: Schema.Date,\n    }),\n  }),\n  \n  postUnpublished: Events.synced({\n    name: 'v1.PostUnpublished',\n    schema: Schema.Struct({ id: Schema.String }),\n  }),\n  \n  postDeleted: Events.synced({\n    name: 'v1.PostDeleted',\n    schema: Schema.Struct({\n      id: Schema.String,\n      deletedAt: Schema.Date,\n    }),\n  }),\n  \n  // Comment events\n  commentCreated: Events.synced({\n    name: 'v1.CommentCreated',\n    schema: Schema.Struct({\n      id: Schema.String,\n      postId: Schema.String,\n      authorId: Schema.String,\n      content: Schema.String,\n      parentId: Schema.NullOr(Schema.String),\n      createdAt: Schema.Date,\n    }),\n  }),\n  \n  commentEdited: Events.synced({\n    name: 'v1.CommentEdited',\n    schema: Schema.Struct({\n      id: Schema.String,\n      content: Schema.String,\n      editedAt: Schema.Date,\n    }),\n  }),\n  \n  commentDeleted: Events.synced({\n    name: 'v1.CommentDeleted',\n    schema: Schema.Struct({\n      id: Schema.String,\n      deletedAt: Schema.Date,\n    }),\n  }),\n  \n  // Author events\n  authorCreated: Events.synced({\n    name: 'v1.AuthorCreated',\n    schema: Schema.Struct({\n      id: Schema.String,\n      name: Schema.String,\n      email: Schema.String,\n      createdAt: Schema.Date,\n    }),\n  }),\n  \n  // Local editing session tracking\n  editingSessionUpdated: tables.editingSessions.set,\n}\n\n// Materializers with conflict resolution strategies\nconst materializers = State.SQLite.materializers(events, {\n  // Post materializers\n  'v1.PostCreated': ({ id, title, slug, authorId, createdAt }) =>\n    tables.posts.insert({ id, title, content: '', slug, authorId, createdAt, version: 1 }),\n    \n  'v1.PostTitleChanged': ({ id, title, version }) =>\n    // Last-write-wins with version check for optimistic concurrency\n    tables.posts.update({ title, version }).where({ id }),\n    \n  'v1.PostContentChanged': ({ id, content, version, authorId }) =>\n    tables.posts.update({ content, version }).where({ id }),\n    \n  'v1.PostPublished': ({ id, publishedAt }) =>\n    tables.posts.update({ published: true, publishedAt }).where({ id }),\n    \n  'v1.PostUnpublished': ({ id }) =>\n    tables.posts.update({ published: false, publishedAt: null }).where({ id }),\n    \n  'v1.PostDeleted': ({ id, deletedAt }) =>\n    tables.posts.update({ deletedAt }).where({ id }),\n    \n  // Comment materializers\n  'v1.CommentCreated': ({ id, postId, authorId, content, parentId, createdAt }) =>\n    tables.comments.insert({ id, postId, authorId, content, parentId, createdAt }),\n    \n  'v1.CommentEdited': ({ id, content, editedAt }) =>\n    tables.comments.update({ content, editedAt }).where({ id }),\n    \n  'v1.CommentDeleted': ({ id, deletedAt }) =>\n    tables.comments.update({ deletedAt }).where({ id }),\n    \n  // Author materializers\n  'v1.AuthorCreated': ({ id, name, email, createdAt }) =>\n    tables.authors.insert({ id, name, email, createdAt }),\n})\n\nconst state = State.SQLite.makeState({ tables, materializers })\n\nexport const schema = makeSchema({ events, state })\n\n// Example queries:\n//\n// // Published posts with author info\n// const publishedPosts$ = queryDb(\n//   tables.posts\n//     .select()\n//     .join(tables.authors, 'authorId', 'id')\n//     .where({ published: true, deletedAt: null })\n//     .orderBy('publishedAt', 'desc'),\n//   { label: 'publishedPosts' }\n// )\n//\n// // Comments for a post (threaded)\n// const postComments$ = (postId: string) => queryDb(\n//   tables.comments\n//     .select()\n//     .join(tables.authors, 'authorId', 'id') \n//     .where({ postId, deletedAt: null })\n//     .orderBy('createdAt'),\n//   { label: `postComments-${postId}` }\n// )";
+export declare const blogSchemaContent = "import { Events, makeSchema, Schema, SessionIdSymbol, State } from '@livestore/livestore'\n\n// Content management with collaborative editing capabilities\nexport const tables = {\n  posts: State.SQLite.table({\n    name: 'posts',\n    columns: {\n      id: State.SQLite.text({ primaryKey: true }),\n      title: State.SQLite.text(),\n      content: State.SQLite.text(), // Consider using JSON for rich text operations\n      slug: State.SQLite.text(),\n      published: State.SQLite.boolean({ default: false }),\n      authorId: State.SQLite.text(),\n      createdAt: State.SQLite.integer({ schema: Schema.DateFromNumber }),\n      publishedAt: State.SQLite.integer({ nullable: true, schema: Schema.DateFromNumber }),\n      deletedAt: State.SQLite.integer({ nullable: true, schema: Schema.DateFromNumber }),\n      version: State.SQLite.integer({ default: 1 }), // For optimistic concurrency\n    },\n  }),\n\n  comments: State.SQLite.table({\n    name: 'comments',\n    columns: {\n      id: State.SQLite.text({ primaryKey: true }),\n      postId: State.SQLite.text(),\n      authorId: State.SQLite.text(),\n      content: State.SQLite.text(),\n      parentId: State.SQLite.text({ nullable: true }), // For threaded comments\n      createdAt: State.SQLite.integer({ schema: Schema.DateFromNumber }),\n      editedAt: State.SQLite.integer({ nullable: true, schema: Schema.DateFromNumber }),\n      deletedAt: State.SQLite.integer({ nullable: true, schema: Schema.DateFromNumber }),\n    },\n  }),\n\n  authors: State.SQLite.table({\n    name: 'authors',\n    columns: {\n      id: State.SQLite.text({ primaryKey: true }),\n      name: State.SQLite.text(),\n      email: State.SQLite.text(),\n      bio: State.SQLite.text({ nullable: true }),\n      avatarUrl: State.SQLite.text({ nullable: true }),\n      createdAt: State.SQLite.integer({ schema: Schema.DateFromNumber }),\n    },\n  }),\n\n  // Track collaborative editing sessions\n  editingSessions: State.SQLite.clientDocument({\n    name: 'editingSessions',\n    schema: Schema.Struct({\n      postId: Schema.String,\n      authorId: Schema.String,\n      lastActivity: Schema.Date,\n      cursorPosition: Schema.Number,\n    }),\n    default: {\n      id: SessionIdSymbol,\n      value: { postId: '', authorId: '', lastActivity: new Date(), cursorPosition: 0 }\n    },\n  }),\n}\n\nexport const events = {\n  // Post lifecycle events\n  postCreated: Events.synced({\n    name: 'v1.PostCreated',\n    schema: Schema.Struct({\n      id: Schema.String,\n      title: Schema.String,\n      slug: Schema.String,\n      authorId: Schema.String,\n      createdAt: Schema.Date,\n    }),\n  }),\n\n  postTitleChanged: Events.synced({\n    name: 'v1.PostTitleChanged',\n    schema: Schema.Struct({\n      id: Schema.String,\n      title: Schema.String,\n      version: Schema.Number, // Optimistic concurrency control\n    }),\n  }),\n\n  postContentChanged: Events.synced({\n    name: 'v1.PostContentChanged',\n    schema: Schema.Struct({\n      id: Schema.String,\n      content: Schema.String,\n      version: Schema.Number,\n      authorId: Schema.String,\n    }),\n  }),\n\n  postPublished: Events.synced({\n    name: 'v1.PostPublished',\n    schema: Schema.Struct({\n      id: Schema.String,\n      publishedAt: Schema.Date,\n    }),\n  }),\n\n  postUnpublished: Events.synced({\n    name: 'v1.PostUnpublished',\n    schema: Schema.Struct({ id: Schema.String }),\n  }),\n\n  postDeleted: Events.synced({\n    name: 'v1.PostDeleted',\n    schema: Schema.Struct({\n      id: Schema.String,\n      deletedAt: Schema.Date,\n    }),\n  }),\n\n  // Comment events\n  commentCreated: Events.synced({\n    name: 'v1.CommentCreated',\n    schema: Schema.Struct({\n      id: Schema.String,\n      postId: Schema.String,\n      authorId: Schema.String,\n      content: Schema.String,\n      parentId: Schema.NullOr(Schema.String),\n      createdAt: Schema.Date,\n    }),\n  }),\n\n  commentEdited: Events.synced({\n    name: 'v1.CommentEdited',\n    schema: Schema.Struct({\n      id: Schema.String,\n      content: Schema.String,\n      editedAt: Schema.Date,\n    }),\n  }),\n\n  commentDeleted: Events.synced({\n    name: 'v1.CommentDeleted',\n    schema: Schema.Struct({\n      id: Schema.String,\n      deletedAt: Schema.Date,\n    }),\n  }),\n\n  // Author events\n  authorCreated: Events.synced({\n    name: 'v1.AuthorCreated',\n    schema: Schema.Struct({\n      id: Schema.String,\n      name: Schema.String,\n      email: Schema.String,\n      createdAt: Schema.Date,\n    }),\n  }),\n\n  // Local editing session tracking\n  editingSessionUpdated: tables.editingSessions.set,\n}\n\n// Materializers with conflict resolution strategies\nconst materializers = State.SQLite.materializers(events, {\n  // Post materializers\n  'v1.PostCreated': ({ id, title, slug, authorId, createdAt }) =>\n    tables.posts.insert({ id, title, content: '', slug, authorId, createdAt, version: 1 }),\n\n  'v1.PostTitleChanged': ({ id, title, version }) =>\n    // Last-write-wins with version check for optimistic concurrency\n    tables.posts.update({ title, version }).where({ id }),\n\n  'v1.PostContentChanged': ({ id, content, version, authorId }) =>\n    tables.posts.update({ content, version }).where({ id }),\n\n  'v1.PostPublished': ({ id, publishedAt }) =>\n    tables.posts.update({ published: true, publishedAt }).where({ id }),\n\n  'v1.PostUnpublished': ({ id }) =>\n    tables.posts.update({ published: false, publishedAt: null }).where({ id }),\n\n  'v1.PostDeleted': ({ id, deletedAt }) =>\n    tables.posts.update({ deletedAt }).where({ id }),\n\n  // Comment materializers\n  'v1.CommentCreated': ({ id, postId, authorId, content, parentId, createdAt }) =>\n    tables.comments.insert({ id, postId, authorId, content, parentId, createdAt }),\n\n  'v1.CommentEdited': ({ id, content, editedAt }) =>\n    tables.comments.update({ content, editedAt }).where({ id }),\n\n  'v1.CommentDeleted': ({ id, deletedAt }) =>\n    tables.comments.update({ deletedAt }).where({ id }),\n\n  // Author materializers\n  'v1.AuthorCreated': ({ id, name, email, createdAt }) =>\n    tables.authors.insert({ id, name, email, createdAt }),\n})\n\nconst state = State.SQLite.makeState({ tables, materializers })\n\nexport const schema = makeSchema({ events, state })\n\n// Example queries:\n//\n// // Published posts with author info\n// const publishedPosts$ = queryDb(\n//   tables.posts\n//     .select()\n//     .join(tables.authors, 'authorId', 'id')\n//     .where({ published: true, deletedAt: null })\n//     .orderBy('publishedAt', 'desc'),\n//   { label: 'publishedPosts' }\n// )\n//\n// // Comments for a post (threaded)\n// const postComments$ = (postId: string) => queryDb(\n//   tables.comments\n//     .select()\n//     .join(tables.authors, 'authorId', 'id')\n//     .where({ postId, deletedAt: null })\n//     .orderBy('createdAt'),\n//   { label: `postComments-${postId}` }\n// )";
 //# sourceMappingURL=blog.d.ts.map

package/dist/mcp-content/schemas/blog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"blog.d.ts","sourceRoot":"","sources":["../../../src/mcp-content/schemas/blog.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,w1NA6NzB,CAAA"}
+{"version":3,"file":"blog.d.ts","sourceRoot":"","sources":["../../../src/mcp-content/schemas/blog.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,uxNA6NzB,CAAA"}