@livestore/cli 0.4.0 → 0.5.0-dev.0

package/src/commands/new-project.ts

@@ -3,7 +3,8 @@ import * as nodePath from 'node:path'
 
 import { sluggify } from '@livestore/utils'
 import {
-  Command,
+  ChildProcess,
+  ChildProcessSpawner,
   Console,
   Effect,
   FileSystem,
@@ -19,7 +20,7 @@ import { detectPackageManager, pmCommands } from '../package-manager.ts'
 // Schema for GitHub API response
 const GitHubContentSchema = Schema.Struct({
   name: Schema.String,
-  type: Schema.Literal('dir', 'file'),
+  type: Schema.Literals(['dir', 'file']),
   path: Schema.String,
   download_url: Schema.NullOr(Schema.String),
 })
@@ -34,11 +35,13 @@ const githubRequest = (url: string) => {
 
 /** Schema for parsing package.json scripts (dev or start) */
 const PackageJsonScriptsSchema = Schema.Struct({
-  scripts: Schema.Union(Schema.Struct({ dev: Schema.String }), Schema.Struct({ start: Schema.String })),
+  scripts: Schema.Union([Schema.Struct({ dev: Schema.String }), Schema.Struct({ start: Schema.String })]),
 })
 
 // Error types
-export class ExampleNotFoundError extends Schema.TaggedError<ExampleNotFoundError>('~@livestore/cli/ExampleNotFoundError')('ExampleNotFoundError', {
+export class ExampleNotFoundError extends Schema.TaggedError<ExampleNotFoundError>(
+  '~@livestore/cli/ExampleNotFoundError',
+)('ExampleNotFoundError', {
   exampleName: Schema.String,
   availableExamples: Schema.Array(Schema.String),
   message: Schema.String,
@@ -49,14 +52,19 @@ export class NetworkError extends Schema.TaggedError<NetworkError>('~@livestore/
   message: Schema.String,
 }) {}
 
-export class DirectoryExistsError extends Schema.TaggedError<DirectoryExistsError>('~@livestore/cli/DirectoryExistsError')('DirectoryExistsError', {
+export class DirectoryExistsError extends Schema.TaggedError<DirectoryExistsError>(
+  '~@livestore/cli/DirectoryExistsError',
+)('DirectoryExistsError', {
   path: Schema.String,
   message: Schema.String,
 }) {}
 
-export class NoExamplesError extends Schema.TaggedError<NoExamplesError>('~@livestore/cli/NoExamplesError')('NoExamplesError', {
-  message: Schema.String,
-}) {}
+export class NoExamplesError extends Schema.TaggedError<NoExamplesError>('~@livestore/cli/NoExamplesError')(
+  'NoExamplesError',
+  {
+    message: Schema.String,
+  },
+) {}
 
 // Fetch available examples from GitHub
 const fetchExamples = (ref: string) =>
@@ -68,7 +76,7 @@ const fetchExamples = (ref: string) =>
     const request = githubRequest(url)
     const response = yield* HttpClient.execute(request).pipe(
       Effect.scoped,
-      Effect.catchAll(
+      Effect.catch(
         (error) =>
           new NetworkError({
             cause: error,
@@ -79,8 +87,10 @@ const fetchExamples = (ref: string) =>
 
     const responseText = yield* response.text
 
-    const examples = yield* Schema.decodeUnknown(Schema.parseJson(GitHubContentsResponseSchema))(responseText).pipe(
-      Effect.catchAll(
+    const examples = yield* Schema.decodeUnknownEffect(Schema.fromJsonString(GitHubContentsResponseSchema))(
+      responseText,
+    ).pipe(
+      Effect.catch(
         (error) =>
           new NetworkError({
             cause: error,
@@ -123,6 +133,8 @@ const downloadExample = (exampleName: string, ref: string, destinationPath: stri
   Effect.gen(function* () {
     yield* Console.log(`📥 Downloading example "${exampleName}" from ref "${ref}"...`)
 
+    const spawner = yield* ChildProcessSpawner.ChildProcessSpawner
+
     const tempDir = yield* Effect.sync(() => os.tmpdir())
     const tarballPath = nodePath.join(tempDir, `livestore-${sluggify(ref)}-${Date.now()}.tar.gz`)
     const tarballUrl = `https://api.github.com/repos/livestorejs/livestore/tarball/${ref}`
@@ -132,7 +144,7 @@ const downloadExample = (exampleName: string, ref: string, destinationPath: stri
 
     const response = yield* HttpClient.execute(request).pipe(
       Effect.scoped,
-      Effect.catchAll(
+      Effect.catch(
         (error) =>
           new NetworkError({
             cause: error,
@@ -154,10 +166,9 @@ const downloadExample = (exampleName: string, ref: string, destinationPath: stri
     const extractDir = nodePath.join(tempDir, `extract-${Date.now()}`)
     yield* fs.makeDirectory(extractDir, { recursive: true })
 
-    // Extract tarball using Effect Command
-    yield* Command.make('tar', '-xzf', tarballPath, '-C', extractDir).pipe(
-      Command.exitCode,
-      Effect.catchAll(
+    // Extract tarball using a child process
+    yield* spawner.exitCode(ChildProcess.make('tar', ['-xzf', tarballPath, '-C', extractDir])).pipe(
+      Effect.catch(
         (error) =>
           new NetworkError({
             cause: error,
@@ -190,10 +201,9 @@ const downloadExample = (exampleName: string, ref: string, destinationPath: stri
       })
     }
 
-    // Copy the example directory contents to the destination using Effect Command
-    yield* Command.make('cp', '-r', `${exampleSourcePath}/.`, destinationPath).pipe(
-      Command.exitCode,
-      Effect.catchAll(
+    // Copy the example directory contents to the destination using a child process
+    yield* spawner.exitCode(ChildProcess.make('cp', ['-r', `${exampleSourcePath}/.`, destinationPath])).pipe(
+      Effect.catch(
         (error) =>
           new NetworkError({
             cause: error,
@@ -203,10 +213,10 @@ const downloadExample = (exampleName: string, ref: string, destinationPath: stri
     )
 
     // Clean up extract directory
-    yield* fs.remove(extractDir, { recursive: true }).pipe(Effect.catchAll(() => Effect.void))
+    yield* fs.remove(extractDir, { recursive: true }).pipe(Effect.catch(() => Effect.void))
 
     // Clean up tarball
-    yield* fs.remove(tarballPath).pipe(Effect.catchAll(() => Effect.void))
+    yield* fs.remove(tarballPath).pipe(Effect.catch(() => Effect.void))
 
     yield* Console.log(`✅ Example "${exampleName}" created successfully at: ${destinationPath}`)
   })
@@ -214,22 +224,22 @@ const downloadExample = (exampleName: string, ref: string, destinationPath: stri
 export const createCommand = Cli.Command.make(
   'create',
   {
-    example: Cli.Options.text('example').pipe(
-      Cli.Options.optional,
-      Cli.Options.withDescription('Example name to create (bypasses interactive selection)'),
+    example: Cli.Flag.string('example').pipe(
+      Cli.Flag.optional,
+      Cli.Flag.withDescription('Example name to create (bypasses interactive selection)'),
     ),
-    ref: Cli.Options.text('ref').pipe(
-      Cli.Options.withAlias('commit'),
-      Cli.Options.withAlias('branch'),
-      Cli.Options.withAlias('tag'),
-      Cli.Options.withDefault('main'),
-      Cli.Options.withDescription(
+    ref: Cli.Flag.string('ref').pipe(
+      Cli.Flag.withAlias('commit'),
+      Cli.Flag.withAlias('branch'),
+      Cli.Flag.withAlias('tag'),
+      Cli.Flag.withDefault('main'),
+      Cli.Flag.withDescription(
         'The name of the commit/branch/tag to fetch examples from. Pull requests refs must be fully-formed (e.g., `refs/pull/123/merge`).',
       ),
     ),
-    path: Cli.Args.text({ name: 'path' }).pipe(
-      Cli.Args.optional,
-      Cli.Args.withDescription('Destination path for the new project'),
+    path: Cli.Argument.string('path').pipe(
+      Cli.Argument.optional,
+      Cli.Argument.withDescription('Destination path for the new project'),
     ),
   },
   Effect.fn(function* ({
@@ -270,7 +280,8 @@ export const createCommand = Cli.Command.make(
     }
 
     // Determine destination path
-    const destinationPath = Option.isSome(path) === true ? nodePath.resolve(path.value) : nodePath.resolve(selectedExample)
+    const destinationPath =
+      Option.isSome(path) === true ? nodePath.resolve(path.value) : nodePath.resolve(selectedExample)
 
     // Download and extract the example
     yield* downloadExample(selectedExample, ref, destinationPath)
@@ -281,7 +292,9 @@ export const createCommand = Cli.Command.make(
     const fs = yield* FileSystem.FileSystem
     const packageJsonPath = nodePath.join(destinationPath, 'package.json')
     const packageJsonContent = yield* fs.readFileString(packageJsonPath)
-    const runScript = yield* Schema.decodeUnknown(Schema.parseJson(PackageJsonScriptsSchema))(packageJsonContent).pipe(
+    const runScript = yield* Schema.decodeUnknownEffect(Schema.fromJsonString(PackageJsonScriptsSchema))(
+      packageJsonContent,
+    ).pipe(
       Effect.map((pkg) => ('dev' in pkg.scripts ? ('dev' as const) : ('start' as const))),
       Effect.orElseSucceed(() => undefined),
     )

package/src/mcp-content/architecture.ts

@@ -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/src/mcp-content/features.ts

@@ -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/src/mcp-content/getting-started.ts

@@ -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/src/mcp-content/overview.ts

@@ -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/src/mcp-content/schemas/blog.ts

@@ -17,7 +17,7 @@ export const tables = {
       version: State.SQLite.integer({ default: 1 }), // For optimistic concurrency
     },
   }),
-  
+
   comments: State.SQLite.table({
     name: 'comments',
     columns: {
@@ -31,7 +31,7 @@ export const tables = {
       deletedAt: State.SQLite.integer({ nullable: true, schema: Schema.DateFromNumber }),
     },
   }),
-  
+
   authors: State.SQLite.table({
     name: 'authors',
     columns: {
@@ -43,7 +43,7 @@ export const tables = {
       createdAt: State.SQLite.integer({ schema: Schema.DateFromNumber }),
     },
   }),
-  
+
   // Track collaborative editing sessions
   editingSessions: State.SQLite.clientDocument({
     name: 'editingSessions',
@@ -53,8 +53,8 @@ export const tables = {
       lastActivity: Schema.Date,
       cursorPosition: Schema.Number,
     }),
-    default: { 
-      id: SessionIdSymbol, 
+    default: {
+      id: SessionIdSymbol,
       value: { postId: '', authorId: '', lastActivity: new Date(), cursorPosition: 0 }
     },
   }),
@@ -72,7 +72,7 @@ export const events = {
       createdAt: Schema.Date,
     }),
   }),
-  
+
   postTitleChanged: Events.synced({
     name: 'v1.PostTitleChanged',
     schema: Schema.Struct({
@@ -81,7 +81,7 @@ export const events = {
       version: Schema.Number, // Optimistic concurrency control
     }),
   }),
-  
+
   postContentChanged: Events.synced({
     name: 'v1.PostContentChanged',
     schema: Schema.Struct({
@@ -91,7 +91,7 @@ export const events = {
       authorId: Schema.String,
     }),
   }),
-  
+
   postPublished: Events.synced({
     name: 'v1.PostPublished',
     schema: Schema.Struct({
@@ -99,12 +99,12 @@ export const events = {
       publishedAt: Schema.Date,
     }),
   }),
-  
+
   postUnpublished: Events.synced({
     name: 'v1.PostUnpublished',
     schema: Schema.Struct({ id: Schema.String }),
   }),
-  
+
   postDeleted: Events.synced({
     name: 'v1.PostDeleted',
     schema: Schema.Struct({
@@ -112,7 +112,7 @@ export const events = {
       deletedAt: Schema.Date,
     }),
   }),
-  
+
   // Comment events
   commentCreated: Events.synced({
     name: 'v1.CommentCreated',
@@ -125,7 +125,7 @@ export const events = {
       createdAt: Schema.Date,
     }),
   }),
-  
+
   commentEdited: Events.synced({
     name: 'v1.CommentEdited',
     schema: Schema.Struct({
@@ -134,7 +134,7 @@ export const events = {
       editedAt: Schema.Date,
     }),
   }),
-  
+
   commentDeleted: Events.synced({
     name: 'v1.CommentDeleted',
     schema: Schema.Struct({
@@ -142,7 +142,7 @@ export const events = {
       deletedAt: Schema.Date,
     }),
   }),
-  
+
   // Author events
   authorCreated: Events.synced({
     name: 'v1.AuthorCreated',
@@ -153,7 +153,7 @@ export const events = {
       createdAt: Schema.Date,
     }),
   }),
-  
+
   // Local editing session tracking
   editingSessionUpdated: tables.editingSessions.set,
 }
@@ -163,33 +163,33 @@ 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 }),
@@ -215,7 +215,7 @@ export const schema = makeSchema({ events, state })
 // const postComments$ = (postId: string) => queryDb(
 //   tables.comments
 //     .select()
-//     .join(tables.authors, 'authorId', 'id') 
+//     .join(tables.authors, 'authorId', 'id')
 //     .where({ postId, deletedAt: null })
 //     .orderBy('createdAt'),
 //   { label: \`postComments-\${postId}\` }