@livestore/cli 0.0.0-snapshot-2ac5fd340c97c9e07fe4c5dc6d31d5132aa6557c.0

package/dist/mcp-content/overview.js

@@ -0,0 +1,120 @@
+export const overviewContent = `# LiveStore: Local-First Data Platform
+
+LiveStore 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.
+
+## Core Philosophy
+
+**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.
+
+**Collaborative by Design**: Real-time collaboration isn't an afterthought – it's built into the foundation. Multiple users can work together seamlessly with automatic conflict resolution and eventual consistency guarantees.
+
+**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.
+
+## What Makes LiveStore Different
+
+### 💾 Local SQLite Performance
+- **Sub-millisecond queries** from local SQLite database
+- **Complex joins and aggregations** with full SQL expressiveness
+- **Reactive queries** that automatically update your UI
+- **ACID transactions** for data integrity
+
+### 🌐 Distributed Systems Reliability
+- **Conflict-free synchronization** using CRDT-inspired merge strategies
+- **Causal consistency** with vector clocks and event ordering
+- **Network partition tolerance** – works offline, syncs when online
+- **Eventually consistent** convergence across all replicas
+
+### 🔐 End-to-End Type Safety
+- **Schema-first development** with Effect-based validation
+- **Compile-time query validation** prevents runtime errors  
+- **Automatic TypeScript generation** from schema definitions
+- **Runtime safety** with comprehensive input validation
+
+### 🏗️ Framework Agnostic
+- **React, Vue, Solid, Svelte** – use with any frontend framework
+- **Web, Node.js, React Native** – deploy anywhere JavaScript runs
+- **Consistent API** across all platforms and frameworks
+
+## Real-World Use Cases
+
+### 📝 Collaborative Applications
+- **Document editors** with real-time collaboration (Google Docs-style)
+- **Project management** tools with team coordination
+- **Design tools** with multiplayer editing capabilities
+- **Chat applications** with offline message queuing
+
+### 📱 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
+- **Financial apps** requiring immediate transaction feedback
+
+### 🏮 Enterprise Applications
+- **CRM systems** with offline sales capability
+- **Inventory management** with real-time stock updates
+- **Customer service** tools with offline case management
+- **Analytics dashboards** with local data caching
+
+## Architecture at a Glance
+
+\`\`\`mermaid
+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
+\`\`\`
+
+1. **UI Layer**: Framework-specific bindings (React, Vue, etc.)
+2. **Query Layer**: Reactive SQL queries with automatic UI updates
+3. **Event Layer**: Immutable event log with schema validation
+4. **Materialization**: Events applied to SQLite tables via materializers
+5. **Synchronization**: Conflict-free replication across devices/users
+6. **Storage**: Local SQLite database for immediate data access
+
+## Key Technical Innovations
+
+### Event-Driven State Management
+Unlike traditional ORMs that hide change tracking, LiveStore makes all state changes explicit through events. This provides:
+- **Deterministic state updates** that can be tested and debugged
+- **Conflict resolution** through event reordering and semantic merging
+- **Time travel** capabilities for debugging and feature development
+- **Audit trails** for compliance and data governance
+
+### Sophisticated Conflict Resolution
+LiveStore handles conflicts intelligently using multiple strategies:
+- **Last-Write-Wins**: Simple timestamp-based resolution
+- **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
+
+### Performance Optimization
+- **Query compilation caching** for repeated queries
+- **Reactive dependency tracking** to minimize unnecessary updates
+- **Incremental synchronization** to reduce network overhead
+- **Background processing** to keep the UI thread responsive
+
+## Production Ready
+
+LiveStore is designed for production applications with enterprise-grade requirements:
+
+- **Security**: End-to-end encryption, event signatures, access control
+- **Observability**: Distributed tracing, performance monitoring, health checks
+- **Scalability**: Horizontal scaling, connection pooling, data partitioning
+- **Reliability**: Automatic retries, circuit breakers, graceful degradation
+
+Whether you're building a simple todo app or a complex collaborative platform, LiveStore provides the foundation for applications that users love – fast, reliable, and always available.
+
+**Ready to get started?** Check out our [Getting Started Guide](./getting-started) or explore our [Example Applications](https://github.com/livestorejs/examples).`;
+//# sourceMappingURL=overview.js.map

package/dist/mcp-content/overview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overview.js","sourceRoot":"","sources":["../../src/mcp-content/overview.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mKAsHoI,CAAA"}

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

@@ -0,0 +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// )";
+//# sourceMappingURL=blog.d.ts.map

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

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

package/dist/mcp-content/schemas/blog.js

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

package/dist/mcp-content/schemas/blog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog.js","sourceRoot":"","sources":["../../../src/mcp-content/schemas/blog.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA6N5B,CAAA"}

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

@@ -0,0 +1,2 @@
+export declare const ecommerceSchemaContent = "import { Events, makeSchema, Schema, SessionIdSymbol, State } from '@livestore/livestore'\n\n// E-commerce with inventory management and order processing\nexport const tables = {\n  products: State.SQLite.table({\n    name: 'products',\n    columns: {\n      id: State.SQLite.text({ primaryKey: true }),\n      sku: State.SQLite.text(),\n      name: State.SQLite.text(),\n      description: State.SQLite.text(),\n      price: State.SQLite.integer(), // Store as cents to avoid floating point issues\n      currency: State.SQLite.text({ default: 'USD' }),\n      stock: State.SQLite.integer({ default: 0 }),\n      reservedStock: State.SQLite.integer({ default: 0 }), // For pending orders\n      isActive: State.SQLite.boolean({ default: true }),\n      weight: State.SQLite.real({ nullable: true }), // For shipping calculations\n      dimensions: State.SQLite.text({ nullable: true }), // JSON: {width, height, depth}\n      imageUrls: State.SQLite.text({ nullable: true }), // JSON array\n      createdAt: State.SQLite.integer({ schema: Schema.DateFromNumber }),\n      updatedAt: State.SQLite.integer({ schema: Schema.DateFromNumber }),\n      deletedAt: State.SQLite.integer({ nullable: true, schema: Schema.DateFromNumber }),\n    },\n  }),\n  \n  categories: State.SQLite.table({\n    name: 'categories',\n    columns: {\n      id: State.SQLite.text({ primaryKey: true }),\n      name: State.SQLite.text(),\n      slug: State.SQLite.text(),\n      parentId: State.SQLite.text({ nullable: true }), // For hierarchical categories\n      description: State.SQLite.text({ nullable: true }),\n      imageUrl: State.SQLite.text({ nullable: true }),\n      sortOrder: State.SQLite.integer({ default: 0 }),\n      isActive: State.SQLite.boolean({ default: true }),\n      createdAt: State.SQLite.integer({ schema: Schema.DateFromNumber }),\n    },\n  }),\n  \n  productCategories: State.SQLite.table({\n    name: 'product_categories',\n    columns: {\n      productId: State.SQLite.text(),\n      categoryId: State.SQLite.text(),\n      createdAt: State.SQLite.integer({ schema: Schema.DateFromNumber }),\n    },\n  }),\n  \n  customers: State.SQLite.table({\n    name: 'customers',\n    columns: {\n      id: State.SQLite.text({ primaryKey: true }),\n      email: State.SQLite.text(),\n      firstName: State.SQLite.text({ nullable: true }),\n      lastName: State.SQLite.text({ nullable: true }),\n      phone: State.SQLite.text({ nullable: true }),\n      createdAt: State.SQLite.integer({ schema: Schema.DateFromNumber }),\n      lastOrderAt: State.SQLite.integer({ nullable: true, schema: Schema.DateFromNumber }),\n    },\n  }),\n  \n  addresses: State.SQLite.table({\n    name: 'addresses',\n    columns: {\n      id: State.SQLite.text({ primaryKey: true }),\n      customerId: State.SQLite.text(),\n      type: State.SQLite.text({ default: 'shipping' }), // shipping, billing\n      firstName: State.SQLite.text(),\n      lastName: State.SQLite.text(),\n      company: State.SQLite.text({ nullable: true }),\n      address1: State.SQLite.text(),\n      address2: State.SQLite.text({ nullable: true }),\n      city: State.SQLite.text(),\n      state: State.SQLite.text(),\n      country: State.SQLite.text(),\n      postalCode: State.SQLite.text(),\n      isDefault: State.SQLite.boolean({ default: false }),\n    },\n  }),\n  \n  orders: State.SQLite.table({\n    name: 'orders',\n    columns: {\n      id: State.SQLite.text({ primaryKey: true }),\n      orderNumber: State.SQLite.text(), // Human-readable order number\n      customerId: State.SQLite.text(),\n      status: State.SQLite.text({ default: 'draft' }), // draft, pending, paid, processing, shipped, delivered, cancelled\n      paymentStatus: State.SQLite.text({ default: 'pending' }), // pending, paid, failed, refunded\n      fulfillmentStatus: State.SQLite.text({ default: 'unfulfilled' }), // unfulfilled, partial, fulfilled\n      \n      subtotal: State.SQLite.integer(), // In cents\n      taxAmount: State.SQLite.integer({ default: 0 }),\n      shippingAmount: State.SQLite.integer({ default: 0 }),\n      discountAmount: State.SQLite.integer({ default: 0 }),\n      total: State.SQLite.integer(),\n      currency: State.SQLite.text({ default: 'USD' }),\n      \n      shippingAddress: State.SQLite.text(), // JSON\n      billingAddress: State.SQLite.text(), // JSON\n      \n      notes: State.SQLite.text({ nullable: true }),\n      \n      createdAt: State.SQLite.integer({ schema: Schema.DateFromNumber }),\n      updatedAt: State.SQLite.integer({ schema: Schema.DateFromNumber }),\n      cancelledAt: State.SQLite.integer({ nullable: true, schema: Schema.DateFromNumber }),\n      shippedAt: State.SQLite.integer({ nullable: true, schema: Schema.DateFromNumber }),\n      deliveredAt: State.SQLite.integer({ nullable: true, schema: Schema.DateFromNumber }),\n    },\n  }),\n  \n  orderItems: State.SQLite.table({\n    name: 'order_items',\n    columns: {\n      id: State.SQLite.text({ primaryKey: true }),\n      orderId: State.SQLite.text(),\n      productId: State.SQLite.text(),\n      variantId: State.SQLite.text({ nullable: true }),\n      sku: State.SQLite.text(), // Snapshot at time of order\n      name: State.SQLite.text(), // Product name at time of order\n      quantity: State.SQLite.integer(),\n      unitPrice: State.SQLite.integer(), // Price per unit in cents\n      totalPrice: State.SQLite.integer(), // quantity * unitPrice\n      fulfillmentStatus: State.SQLite.text({ default: 'unfulfilled' }),\n    },\n  }),\n  \n  // Inventory tracking with event sourcing\n  inventoryEvents: State.SQLite.table({\n    name: 'inventory_events',\n    columns: {\n      id: State.SQLite.text({ primaryKey: true }),\n      productId: State.SQLite.text(),\n      type: State.SQLite.text(), // 'adjustment', 'sale', 'return', 'damage', 'restock'\n      quantity: State.SQLite.integer(), // Can be positive or negative\n      reason: State.SQLite.text({ nullable: true }),\n      referenceId: State.SQLite.text({ nullable: true }), // Order ID, adjustment ID, etc.\n      createdAt: State.SQLite.integer({ schema: Schema.DateFromNumber }),\n    },\n  }),\n  \n  // Shopping cart (client-side state)\n  cart: State.SQLite.clientDocument({\n    name: 'cart',\n    schema: Schema.Struct({\n      items: Schema.Array(Schema.Struct({\n        productId: Schema.String,\n        quantity: Schema.Number,\n        addedAt: Schema.Date,\n      })),\n      discountCode: Schema.NullOr(Schema.String),\n      notes: Schema.String,\n    }),\n    default: { \n      id: SessionIdSymbol, \n      value: { items: [], discountCode: null, notes: '' }\n    },\n  }),\n}\n\nexport const events = {\n  // Product management\n  productCreated: Events.synced({\n    name: 'v1.ProductCreated',\n    schema: Schema.Struct({\n      id: Schema.String,\n      sku: Schema.String,\n      name: Schema.String,\n      description: Schema.String,\n      price: Schema.Number, // In cents\n      currency: Schema.String,\n      createdAt: Schema.Date,\n    }),\n  }),\n  \n  productUpdated: Events.synced({\n    name: 'v1.ProductUpdated',\n    schema: Schema.Struct({\n      id: Schema.String,\n      name: Schema.NullOr(Schema.String),\n      description: Schema.NullOr(Schema.String),\n      price: Schema.NullOr(Schema.Number),\n      updatedAt: Schema.Date,\n    }),\n  }),\n  \n  productStockAdjusted: Events.synced({\n    name: 'v1.ProductStockAdjusted',\n    schema: Schema.Struct({\n      productId: Schema.String,\n      adjustment: Schema.Number, // Can be positive or negative\n      reason: Schema.String,\n      referenceId: Schema.NullOr(Schema.String),\n      createdAt: Schema.Date,\n    }),\n  }),\n  \n  productDeactivated: Events.synced({\n    name: 'v1.ProductDeactivated',\n    schema: Schema.Struct({ id: Schema.String }),\n  }),\n  \n  // Customer management\n  customerCreated: Events.synced({\n    name: 'v1.CustomerCreated',\n    schema: Schema.Struct({\n      id: Schema.String,\n      email: Schema.String,\n      firstName: Schema.NullOr(Schema.String),\n      lastName: Schema.NullOr(Schema.String),\n      createdAt: Schema.Date,\n    }),\n  }),\n  \n  // Order lifecycle with state machine\n  orderCreated: Events.synced({\n    name: 'v1.OrderCreated',\n    schema: Schema.Struct({\n      id: Schema.String,\n      orderNumber: Schema.String,\n      customerId: Schema.String,\n      items: Schema.Array(Schema.Struct({\n        productId: Schema.String,\n        sku: Schema.String,\n        name: Schema.String,\n        quantity: Schema.Number,\n        unitPrice: Schema.Number,\n      })),\n      subtotal: Schema.Number,\n      total: Schema.Number,\n      shippingAddress: Schema.Object,\n      billingAddress: Schema.Object,\n      createdAt: Schema.Date,\n    }),\n  }),\n  \n  orderPaymentReceived: Events.synced({\n    name: 'v1.OrderPaymentReceived',\n    schema: Schema.Struct({\n      orderId: Schema.String,\n      amount: Schema.Number,\n      paymentMethod: Schema.String,\n      transactionId: Schema.String,\n      paidAt: Schema.Date,\n    }),\n  }),\n  \n  orderShipped: Events.synced({\n    name: 'v1.OrderShipped',\n    schema: Schema.Struct({\n      orderId: Schema.String,\n      trackingNumber: Schema.NullOr(Schema.String),\n      carrier: Schema.NullOr(Schema.String),\n      shippedAt: Schema.Date,\n    }),\n  }),\n  \n  orderDelivered: Events.synced({\n    name: 'v1.OrderDelivered',\n    schema: Schema.Struct({\n      orderId: Schema.String,\n      deliveredAt: Schema.Date,\n    }),\n  }),\n  \n  orderCancelled: Events.synced({\n    name: 'v1.OrderCancelled',\n    schema: Schema.Struct({\n      orderId: Schema.String,\n      reason: Schema.String,\n      cancelledAt: Schema.Date,\n    }),\n  }),\n  \n  // Cart management (local)\n  cartUpdated: tables.cart.set,\n}\n\n// Materializers with business logic and constraints\nconst materializers = State.SQLite.materializers(events, {\n  // Product materializers\n  'v1.ProductCreated': ({ id, sku, name, description, price, currency, createdAt }) =>\n    tables.products.insert({ id, sku, name, description, price, currency, createdAt, updatedAt: createdAt }),\n    \n  'v1.ProductUpdated': ({ id, name, description, price, updatedAt }) =>\n    tables.products.update({ \n      name: name ?? undefined,\n      description: description ?? undefined, \n      price: price ?? undefined,\n      updatedAt \n    }).where({ id }),\n    \n  'v1.ProductStockAdjusted': ({ productId, adjustment, reason, referenceId, createdAt }) => [\n    // Record the inventory event\n    tables.inventoryEvents.insert({ \n      id: crypto.randomUUID(),\n      productId, \n      type: 'adjustment',\n      quantity: adjustment, \n      reason, \n      referenceId, \n      createdAt \n    }),\n    // Update product stock (eventually consistent)\n    tables.products.update({ \n      stock: Math.max(0, tables.products.select('stock').where({ id: productId }).scalar() + adjustment),\n      updatedAt: createdAt\n    }).where({ id: productId }),\n  ],\n    \n  'v1.ProductDeactivated': ({ id }) =>\n    tables.products.update({ isActive: false }).where({ id }),\n    \n  // Customer materializers\n  'v1.CustomerCreated': ({ id, email, firstName, lastName, createdAt }) =>\n    tables.customers.insert({ id, email, firstName, lastName, createdAt }),\n    \n  // Order materializers with inventory reservation\n  'v1.OrderCreated': ({ id, orderNumber, customerId, items, subtotal, total, shippingAddress, billingAddress, createdAt }) => [\n    // Create the order\n    tables.orders.insert({ \n      id, \n      orderNumber, \n      customerId, \n      status: 'pending',\n      subtotal, \n      total, \n      shippingAddress: JSON.stringify(shippingAddress),\n      billingAddress: JSON.stringify(billingAddress),\n      createdAt, \n      updatedAt: createdAt \n    }),\n    // Create order items and reserve inventory\n    ...items.flatMap(item => [\n      tables.orderItems.insert({ \n        id: crypto.randomUUID(),\n        orderId: id,\n        productId: item.productId,\n        sku: item.sku,\n        name: item.name,\n        quantity: item.quantity,\n        unitPrice: item.unitPrice,\n        totalPrice: item.quantity * item.unitPrice,\n      }),\n      // Reserve stock\n      tables.products.update({ \n        reservedStock: tables.products.select('reservedStock').where({ id: item.productId }).scalar() + item.quantity\n      }).where({ id: item.productId }),\n    ]),\n  ],\n    \n  'v1.OrderPaymentReceived': ({ orderId, amount, paymentMethod, transactionId, paidAt }) =>\n    tables.orders.update({ \n      status: 'paid', \n      paymentStatus: 'paid',\n      updatedAt: paidAt \n    }).where({ id: orderId }),\n    \n  'v1.OrderShipped': ({ orderId, trackingNumber, carrier, shippedAt }) => [\n    tables.orders.update({ \n      status: 'shipped',\n      fulfillmentStatus: 'fulfilled',\n      shippedAt,\n      updatedAt: shippedAt \n    }).where({ id: orderId }),\n    // Convert reserved stock to actual stock reduction\n    ...tables.orderItems.select().where({ orderId }).map(item => \n      tables.products.update({ \n        stock: tables.products.select('stock').where({ id: item.productId }).scalar() - item.quantity,\n        reservedStock: tables.products.select('reservedStock').where({ id: item.productId }).scalar() - item.quantity\n      }).where({ id: item.productId })\n    ),\n  ],\n    \n  'v1.OrderDelivered': ({ orderId, deliveredAt }) =>\n    tables.orders.update({ \n      status: 'delivered',\n      deliveredAt,\n      updatedAt: deliveredAt \n    }).where({ id: orderId }),\n    \n  'v1.OrderCancelled': ({ orderId, reason, cancelledAt }) => [\n    tables.orders.update({ \n      status: 'cancelled',\n      cancelledAt,\n      notes: reason,\n      updatedAt: cancelledAt \n    }).where({ id: orderId }),\n    // Release reserved inventory\n    ...tables.orderItems.select().where({ orderId }).map(item => \n      tables.products.update({ \n        reservedStock: Math.max(0, tables.products.select('reservedStock').where({ id: item.productId }).scalar() - item.quantity)\n      }).where({ id: item.productId })\n    ),\n  ],\n})\n\nconst state = State.SQLite.makeState({ tables, materializers })\n\nexport const schema = makeSchema({ events, state })\n\n// Example queries for business intelligence:\n//\n// // Available products with real-time stock\n// const availableProducts$ = queryDb(\n//   tables.products\n//     .select()\n//     .where({ isActive: true, deletedAt: null })\n//     .having(tables.products.column('stock').minus(tables.products.column('reservedStock')).gt(0))\n//     .orderBy('name'),\n//   { label: 'availableProducts' }\n// )\n//\n// // Orders requiring fulfillment\n// const pendingOrders$ = queryDb(\n//   tables.orders\n//     .select()\n//     .join(tables.customers, 'customerId', 'id')\n//     .where({ \n//       'orders.status': 'paid',\n//       'orders.fulfillmentStatus': 'unfulfilled'\n//     })\n//     .orderBy('orders.createdAt'),\n//   { label: 'pendingOrders' }\n// )\n//\n// // Low stock alerts\n// const lowStockProducts$ = queryDb(\n//   tables.products\n//     .select()\n//     .where({ isActive: true })\n//     .having(tables.products.column('stock').minus(tables.products.column('reservedStock')).lt(10))\n//     .orderBy('stock'),\n//   { label: 'lowStockProducts' }\n// )";
+//# sourceMappingURL=ecommerce.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ecommerce.d.ts","sourceRoot":"","sources":["../../../src/mcp-content/schemas/ecommerce.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,y+dAkb9B,CAAA"}