@livestore/cli 0.4.0-dev.8 → 0.4.0

package/dist/sync-operations.js

@@ -0,0 +1,180 @@
+import { UnknownError } from '@livestore/common';
+import { LiveStoreEvent } from '@livestore/common/schema';
+import { Cause, Chunk, Effect, KeyValueStore, Option, Schema, Stream, SubscriptionRef, } from '@livestore/utils/effect';
+import { loadModuleConfig } from "./module-loader.js";
+/** Connection timeout for sync backend ping (5 seconds) */
+const CONNECTION_TIMEOUT_MS = 5000;
+/**
+ * Schema for the export file format.
+ * Contains metadata about the export and an array of events in global encoded format.
+ */
+export const ExportFileSchema = Schema.Struct({
+    /** Format version for future compatibility */
+    version: Schema.Literal(1),
+    /** Store identifier */
+    storeId: Schema.String,
+    /** ISO timestamp of when the export was created */
+    exportedAt: Schema.String,
+    /** Total number of events in the export */
+    eventCount: Schema.Number,
+    /** Array of events in global encoded format */
+    events: Schema.Array(LiveStoreEvent.Global.Encoded),
+});
+export class ConnectionError extends Schema.TaggedError('~@livestore/cli/ConnectionError')('ConnectionError', {
+    cause: Schema.Defect,
+    note: Schema.String,
+}) {
+}
+export class ExportError extends Schema.TaggedError('~@livestore/cli/ExportError')('ExportError', {
+    cause: Schema.Defect,
+    note: Schema.String,
+}) {
+}
+export class ImportError extends Schema.TaggedError('~@livestore/cli/ImportError')('ImportError', {
+    cause: Schema.Defect,
+    note: Schema.String,
+}) {
+}
+/**
+ * Creates a sync backend connection from a user module and verifies connectivity.
+ * This is a simplified version of the MCP runtime that only creates the sync backend.
+ */
+export const makeSyncBackend = ({ configPath, storeId, clientId, }) => Effect.gen(function* () {
+    const { syncBackendConstructor, syncPayload } = yield* loadModuleConfig({ configPath });
+    const syncBackend = yield* syncBackendConstructor({
+        storeId,
+        clientId,
+        /** syncPayload is validated against syncPayloadSchema by loadModuleConfig */
+        payload: syncPayload,
+    }).pipe(Effect.provide(KeyValueStore.layerMemory), UnknownError.mapToUnknownError);
+    /** Connect to the sync backend */
+    yield* syncBackend.connect.pipe(Effect.mapError((cause) => new ConnectionError({
+        cause,
+        note: `Failed to connect to sync backend: ${cause._tag === 'IsOfflineError' ? 'Backend is offline or unreachable' : String(cause)}`,
+    })));
+    /** Verify connectivity with a ping (with timeout) */
+    yield* syncBackend.ping.pipe(Effect.timeout(CONNECTION_TIMEOUT_MS), Effect.catchAll((cause) => {
+        if (Cause.isTimeoutException(cause) === true) {
+            return Effect.fail(new ConnectionError({
+                cause,
+                note: `Connection timeout: Sync backend did not respond within ${CONNECTION_TIMEOUT_MS}ms`,
+            }));
+        }
+        return Effect.fail(new ConnectionError({
+            cause,
+            note: `Failed to ping sync backend: ${cause._tag === 'IsOfflineError' ? 'Backend is offline or unreachable' : String(cause)}`,
+        }));
+    }));
+    return syncBackend;
+});
+const releaseSyncBackend = (syncBackend) => {
+    const maybeDisconnect = syncBackend.disconnect;
+    const releaseEffect = maybeDisconnect ?? SubscriptionRef.set(syncBackend.isConnected, false);
+    return releaseEffect.pipe(Effect.orElse(() => Effect.void));
+};
+/**
+ * Core export operation - pulls all events from sync backend.
+ * Returns the export data structure without writing to file.
+ */
+export const pullEventsFromSyncBackend = ({ configPath, storeId, clientId, }) => Effect.acquireUseRelease(makeSyncBackend({ configPath, storeId, clientId }), (syncBackend) => Effect.gen(function* () {
+    const backendName = syncBackend.metadata.name;
+    const batchesChunk = yield* syncBackend.pull(Option.none(), { live: false }).pipe(Stream.takeUntil((item) => item.pageInfo._tag === 'NoMore'), Stream.runCollect, Effect.mapError((cause) => new ExportError({
+        cause,
+        note: `Failed to pull events from sync backend: ${String(cause)}`,
+    })));
+    const events = Chunk.toReadonlyArray(batchesChunk)
+        .flatMap((item) => item.batch)
+        .map((item) => item.eventEncoded);
+    const exportedAt = new Date().toISOString();
+    const exportData = {
+        version: 1,
+        storeId,
+        exportedAt,
+        eventCount: events.length,
+        events,
+    };
+    return {
+        storeId,
+        eventCount: events.length,
+        exportedAt,
+        backendName,
+        data: exportData,
+    };
+}), releaseSyncBackend).pipe(Effect.withSpan('sync:pullEvents'));
+/**
+ * Validates an export file for import.
+ * Returns validation info without actually importing.
+ */
+export const validateExportData = ({ data, targetStoreId, }) => Effect.gen(function* () {
+    const exportData = yield* Schema.decodeUnknown(ExportFileSchema)(data).pipe(Effect.mapError((cause) => new ImportError({
+        cause: new Error(`Invalid export file format: ${String(cause)}`),
+        note: `Invalid export file format: ${String(cause)}`,
+    })));
+    return {
+        storeId: targetStoreId,
+        eventCount: exportData.events.length,
+        sourceStoreId: exportData.storeId,
+        storeIdMismatch: exportData.storeId !== targetStoreId,
+    };
+});
+/**
+ * Core import operation - pushes events to sync backend.
+ * Validates that the backend is empty before importing.
+ */
+export const pushEventsToSyncBackend = ({ configPath, storeId, clientId, data, force, dryRun, onProgress, }) => Effect.acquireUseRelease(makeSyncBackend({ configPath, storeId, clientId }), (syncBackend) => Effect.gen(function* () {
+    const exportData = yield* Schema.decodeUnknown(ExportFileSchema)(data).pipe(Effect.mapError((cause) => new ImportError({
+        cause: new Error(`Invalid export file format: ${String(cause)}`),
+        note: `Invalid export file format: ${String(cause)}`,
+    })));
+    if (exportData.storeId !== storeId && force === false) {
+        return yield* new ImportError({
+            cause: new Error(`Store ID mismatch: file has '${exportData.storeId}', expected '${storeId}'`),
+            note: `The export file was created for a different store. Use force option to import anyway.`,
+        });
+    }
+    if (dryRun === true) {
+        return {
+            storeId,
+            eventCount: exportData.events.length,
+            dryRun: true,
+        };
+    }
+    const backendName = syncBackend.metadata.name;
+    /** Check if events already exist by pulling from the backend first (short-circuit on first non-empty batch) */
+    const existingBatchOption = yield* syncBackend.pull(Option.none(), { live: false }).pipe(Stream.filter((item) => item.batch.length > 0), Stream.runHead, Effect.mapError((cause) => new ImportError({
+        cause,
+        note: `Failed to check existing events: ${String(cause)}`,
+    })));
+    if (Option.isSome(existingBatchOption) === true) {
+        const existingBatch = existingBatchOption.value;
+        const estimatedCount = existingBatch.pageInfo._tag === 'MoreKnown'
+            ? existingBatch.batch.length + existingBatch.pageInfo.remaining
+            : existingBatch.batch.length;
+        return yield* new ImportError({
+            cause: new Error(`Sync backend already contains at least ${estimatedCount} events`),
+            note: `Cannot import into a non-empty sync backend. The sync backend must be empty.`,
+        });
+    }
+    /** Push events in batches of 100 (sync backend constraint) */
+    const batchSize = 100;
+    const total = exportData.events.length;
+    let pushed = 0;
+    for (let i = 0; i < exportData.events.length; i += batchSize) {
+        const batch = exportData.events.slice(i, i + batchSize);
+        yield* syncBackend.push(batch).pipe(Effect.mapError((cause) => new ImportError({
+            cause,
+            note: `Failed to push events at position ${i}: ${String(cause)}`,
+        })));
+        pushed += batch.length;
+        if (onProgress !== undefined) {
+            yield* onProgress(pushed, total);
+        }
+    }
+    return {
+        storeId,
+        eventCount: exportData.events.length,
+        dryRun: false,
+        backendName,
+    };
+}), releaseSyncBackend).pipe(Effect.withSpan('sync:pushEvents'));
+//# sourceMappingURL=sync-operations.js.map

package/dist/sync-operations.js.map

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

package/package.json

@@ -1,30 +1,86 @@
 {
   "name": "@livestore/cli",
-  "version": "0.4.0-dev.8",
+  "version": "0.4.0",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/livestorejs/livestore.git"
+  },
+  "bin": {
+    "livestore": "./dist/bin.js"
+  },
+  "files": [
+    "dist",
+    "package.json",
+    "src"
+  ],
   "type": "module",
   "sideEffects": false,
   "exports": {
     ".": "./dist/mod.js"
   },
-  "bin": {
-    "livestore": "./dist/bin.js"
+  "publishConfig": {
+    "access": "public"
   },
   "dependencies": {
-    "@effect/ai-openai": "0.30.1",
-    "@livestore/common": "0.4.0-dev.8",
-    "@livestore/utils": "0.4.0-dev.8"
+    "@effect/ai": "0.35.0",
+    "@effect/ai-openai": "0.39.0",
+    "@effect/experimental": "0.60.0",
+    "@effect/opentelemetry": "0.63.0",
+    "@effect/platform": "0.96.1",
+    "@effect/rpc": "0.75.1",
+    "effect": "3.21.2",
+    "@livestore/common": "^0.4.0",
+    "@livestore/adapter-node": "^0.4.0",
+    "@livestore/peer-deps": "^0.4.0",
+    "@livestore/utils": "^0.4.0",
+    "@livestore/livestore": "^0.4.0"
   },
   "devDependencies": {
-    "@types/node": "24.2.0",
-    "typescript": "5.9.2"
+    "@types/node": "25.3.3",
+    "typescript": "5.9.3",
+    "vitest": "3.2.4",
+    "@livestore/utils-dev": "^0.4.0"
   },
-  "files": [
-    "package.json",
-    "src",
-    "dist"
-  ],
-  "publishConfig": {
-    "access": "public"
+  "peerDependencies": {
+    "@effect/ai": "^0.35.0",
+    "@effect/cli": "^0.75.1",
+    "@effect/cluster": "^0.58.2",
+    "@effect/experimental": "^0.60.0",
+    "@effect/opentelemetry": "^0.63.0",
+    "@effect/platform": "^0.96.1",
+    "@effect/platform-browser": "^0.76.0",
+    "@effect/platform-bun": "^0.89.0",
+    "@effect/platform-node": "^0.106.0",
+    "@effect/printer": "^0.49.0",
+    "@effect/printer-ansi": "^0.49.0",
+    "@effect/rpc": "^0.75.1",
+    "@effect/sql": "^0.51.1",
+    "@effect/typeclass": "^0.40.0",
+    "@effect/vitest": "^0.29.0",
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/resources": "^2.2.0",
+    "@standard-schema/spec": "^1.1.0",
+    "effect": "^3.21.2"
+  },
+  "$genie": {
+    "source": "package.json.genie.ts",
+    "warning": "DO NOT EDIT - changes will be overwritten",
+    "workspaceClosureDirs": [
+      "packages/@livestore/adapter-node",
+      "packages/@livestore/adapter-web",
+      "packages/@livestore/cli",
+      "packages/@livestore/common",
+      "packages/@livestore/common-cf",
+      "packages/@livestore/devtools-web-common",
+      "packages/@livestore/livestore",
+      "packages/@livestore/peer-deps",
+      "packages/@livestore/sqlite-wasm",
+      "packages/@livestore/utils",
+      "packages/@livestore/utils-dev",
+      "packages/@livestore/wa-sqlite",
+      "packages/@livestore/webmesh"
+    ]
   },
   "scripts": {
     "build": "tsc",

package/src/__tests__/fixtures/mock-config.ts

@@ -0,0 +1,112 @@
+import path from 'node:path'
+import { fileURLToPath, pathToFileURL } from 'node:url'
+
+import { Events, makeSchema, State } from '@livestore/common/schema'
+import type { MockSyncBackend } from '@livestore/common/sync'
+import { EventFactory } from '@livestore/common/testing'
+import { Effect, FileSystem, type Mailbox, Schema } from '@livestore/utils/effect'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+
+class DynamicImportError extends Schema.TaggedError<DynamicImportError>()('DynamicImportError', {
+  cause: Schema.Defect,
+  path: Schema.String,
+}) {}
+
+// Use package-local temp directory for test config files to ensure proper module resolution
+const tmpDir = path.join(__dirname, '.tmp-test-configs')
+
+const items = State.SQLite.table({
+  name: 'items',
+  columns: {
+    id: State.SQLite.text({ primaryKey: true }),
+    title: State.SQLite.text({ default: '', nullable: false }),
+  },
+})
+
+export const events = {
+  itemAdded: Events.synced({
+    name: 'itemAdded',
+    schema: Schema.Struct({ id: Schema.String, title: Schema.String }),
+  }),
+}
+
+const materializers = State.SQLite.materializers(events, {
+  itemAdded: ({ id, title }) => items.insert({ id, title }),
+})
+
+const state = State.SQLite.makeState({
+  tables: { items },
+  materializers,
+})
+
+export const schema = makeSchema({ state, events })
+
+const schemaModuleUrl = pathToFileURL(path.join(__dirname, 'mock-config.ts')).href
+
+/** Generates a per-test config module exporting schema, a mock backend, and connection event taps. */
+const makeTempConfig = () => {
+  const moduleSource = `
+import { schema } from ${JSON.stringify(schemaModuleUrl)}
+import { makeMockSyncBackend } from '@livestore/common/sync'
+import { Effect, Mailbox } from '@livestore/utils/effect'
+
+export const mockBackend = await Effect.runPromise(Effect.scoped(makeMockSyncBackend({ startConnected: true })))
+export const connectionEvents = await Effect.runPromise(Mailbox.make<'connect' | 'disconnect'>())
+
+export { schema }
+
+export const syncBackend = (_args) =>
+  mockBackend.makeSyncBackend.pipe(
+    Effect.tap(() => connectionEvents.offer('connect')),
+    Effect.map((backend) => {
+      const disconnect = backend.disconnect ?? Effect.void
+      return {
+        ...backend,
+        disconnect: disconnect.pipe(Effect.tap(() => connectionEvents.offer('disconnect'))),
+      }
+    }),
+  )
+`
+
+  return moduleSource
+}
+
+/**
+ * Creates a temporary config module (schema + mock backend) and cleans it up afterwards.
+ * Returns the module path plus handles to the backend and connection event mailbox, keeping lifecycle assertions local to each test.
+ */
+export const useMockConfig = Effect.acquireRelease(
+  Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem
+
+    yield* fs.makeDirectory(tmpDir, { recursive: true })
+
+    const tempPath = path.join(tmpDir, `mock-config-${Date.now()}-${Math.random().toString(16).slice(2)}.ts`)
+    const moduleSource = makeTempConfig()
+
+    yield* fs.writeFileString(tempPath, moduleSource)
+
+    const mod = (yield* Effect.tryPromise({
+      try: () => import(pathToFileURL(tempPath).href),
+      catch: (cause) => new DynamicImportError({ cause, path: tempPath }),
+    })) as {
+      mockBackend: MockSyncBackend
+      connectionEvents: Mailbox.Mailbox<'connect' | 'disconnect'>
+    }
+
+    return { configPath: tempPath, mockBackend: mod.mockBackend, connectionEvents: mod.connectionEvents }
+  }),
+  ({ configPath }) =>
+    Effect.gen(function* () {
+      const fs = yield* FileSystem.FileSystem
+      yield* fs.remove(configPath, { recursive: false }).pipe(Effect.catchAll(() => Effect.void))
+    }),
+)
+
+export const makeEventFactory = () =>
+  EventFactory.makeFactory(events)({
+    client: EventFactory.clientIdentity('cli-test-client'),
+    startSeq: 1,
+    initialParent: 'root',
+  })

package/src/__tests__/sync-operations.test.ts

@@ -0,0 +1,232 @@
+import { expect } from 'vitest'
+
+import type { LiveStoreEvent } from '@livestore/common/schema'
+import { Vitest } from '@livestore/utils-dev/node-vitest'
+import { Chunk, Effect, FetchHttpClient, Layer, Mailbox, Stream } from '@livestore/utils/effect'
+import { PlatformNode } from '@livestore/utils/node'
+
+import { pullEventsFromSyncBackend, pushEventsToSyncBackend } from '../sync-operations.ts'
+import { makeEventFactory, useMockConfig } from './fixtures/mock-config.ts'
+
+const baseLayer = Layer.mergeAll(PlatformNode.NodeFileSystem.layer, FetchHttpClient.layer)
+const withTestCtx = Vitest.makeWithTestCtx({ makeLayer: () => baseLayer })
+
+/** Each test acquires its own temporary config module via useMockConfig, avoiding shared state. */
+Vitest.describe('sync-operations', { timeout: 10_000 }, () => {
+  const storeId = 'test-store'
+  const clientId = 'test-client'
+
+  /** Collects the connect + disconnect lifecycle emitted by the mock sync backend. */
+  const expectConnectLifecycle = (
+    mailbox: Mailbox.Mailbox<'connect' | 'disconnect'>,
+  ): Effect.Effect<ReadonlyArray<'connect' | 'disconnect'>> =>
+    Mailbox.toStream(mailbox).pipe(
+      Stream.take(2),
+      Stream.runCollect,
+      Effect.map((chunk) => Chunk.toReadonlyArray(chunk)),
+    )
+
+  Vitest.scopedLive('exports events and releases the backend connection', (test: Vitest.TestContext) =>
+    Effect.gen(function* () {
+      const { mockBackend, connectionEvents, configPath } = yield* useMockConfig
+      const factory = makeEventFactory()
+
+      const batch = [
+        factory.itemAdded.next({ id: 'e1', title: 'First' }),
+        factory.itemAdded.next({ id: 'e2', title: 'Second' }),
+      ]
+
+      yield* mockBackend.advance(...batch)
+
+      const result = yield* pullEventsFromSyncBackend({
+        configPath,
+        storeId,
+        clientId,
+      })
+
+      expect(result.eventCount).toBe(2)
+      expect(result.data.events).toHaveLength(2)
+
+      const lifecycle = yield* expectConnectLifecycle(connectionEvents)
+      expect(lifecycle).toEqual(['connect', 'disconnect'])
+    }).pipe(withTestCtx(test)),
+  )
+
+  Vitest.scopedLive('fails import when backend is not empty', (test: Vitest.TestContext) =>
+    Effect.gen(function* () {
+      const { mockBackend, connectionEvents, configPath } = yield* useMockConfig
+      const factory = makeEventFactory()
+
+      yield* mockBackend.advance(factory.itemAdded.next({ id: 'existing', title: 'Present' }))
+
+      const importBatch = [
+        factory.itemAdded.next({ id: 'incoming-1', title: 'Incoming' }),
+        factory.itemAdded.next({ id: 'incoming-2', title: 'Incoming 2' }),
+      ]
+
+      const result = yield* pushEventsToSyncBackend({
+        configPath,
+        storeId,
+        clientId,
+        data: {
+          version: 1,
+          storeId,
+          exportedAt: new Date().toISOString(),
+          eventCount: importBatch.length,
+          events: importBatch,
+        },
+        force: false,
+        dryRun: false,
+      }).pipe(Effect.either)
+
+      expect(result._tag).toBe('Left')
+      if (result._tag === 'Left') {
+        expect(result.left._tag).toBe('ImportError')
+      }
+
+      const lifecycle = yield* expectConnectLifecycle(connectionEvents)
+      expect(lifecycle).toEqual(['connect', 'disconnect'])
+    }).pipe(withTestCtx(test)),
+  )
+
+  Vitest.scopedLive('supports dry-run import and releases backend', (test: Vitest.TestContext) =>
+    Effect.gen(function* () {
+      const { configPath, connectionEvents } = yield* useMockConfig
+      const factory = makeEventFactory()
+      const importBatch = [factory.itemAdded.next({ id: 'dry-run', title: 'Simulated' })]
+
+      const result = yield* pushEventsToSyncBackend({
+        configPath,
+        storeId,
+        clientId,
+        data: {
+          version: 1,
+          storeId,
+          exportedAt: new Date().toISOString(),
+          eventCount: importBatch.length,
+          events: importBatch,
+        },
+        force: false,
+        dryRun: true,
+      })
+
+      expect(result.dryRun).toBe(true)
+      expect(result.eventCount).toBe(importBatch.length)
+
+      const lifecycle = yield* expectConnectLifecycle(connectionEvents)
+      expect(lifecycle).toEqual(['connect', 'disconnect'])
+    }).pipe(withTestCtx(test)),
+  )
+
+  Vitest.scopedLive('imports events into empty backend with progress and batching', (test: Vitest.TestContext) =>
+    Effect.gen(function* () {
+      const { mockBackend, configPath, connectionEvents } = yield* useMockConfig
+      const factory = makeEventFactory()
+      const importBatch = Array.from({ length: 120 }, (_, idx) =>
+        factory.itemAdded.next({ id: `id-${idx + 1}`, title: `Item ${idx + 1}` }),
+      )
+
+      const progress: Array<{ pushed: number; total: number }> = []
+
+      const result = yield* pushEventsToSyncBackend({
+        configPath,
+        storeId,
+        clientId,
+        data: {
+          version: 1,
+          storeId,
+          exportedAt: new Date().toISOString(),
+          eventCount: importBatch.length,
+          events: importBatch,
+        },
+        force: false,
+        dryRun: false,
+        onProgress: (pushed, total) => Effect.sync(() => progress.push({ pushed, total })),
+      })
+
+      expect(result.dryRun).toBe(false)
+      expect(result.eventCount).toBe(importBatch.length)
+      expect(progress).toEqual([
+        { pushed: 100, total: 120 },
+        { pushed: 120, total: 120 },
+      ])
+
+      const pushedEvents = yield* mockBackend.pushedEvents.pipe(
+        Stream.take(importBatch.length),
+        Stream.runCollect,
+        Effect.map((chunk: Chunk.Chunk<LiveStoreEvent.Global.Encoded>) => Chunk.toReadonlyArray(chunk)),
+      )
+      expect(pushedEvents.map((event) => event.seqNum)).toHaveLength(importBatch.length)
+
+      const lifecycle = yield* expectConnectLifecycle(connectionEvents)
+      expect(lifecycle).toEqual(['connect', 'disconnect'])
+    }).pipe(withTestCtx(test)),
+  )
+
+  Vitest.scopedLive('allows force import on store ID mismatch', (test: Vitest.TestContext) =>
+    Effect.gen(function* () {
+      const { mockBackend, configPath, connectionEvents } = yield* useMockConfig
+      const factory = makeEventFactory()
+      const importBatch = [factory.itemAdded.next({ id: 'force-1', title: 'Force' })]
+
+      const result = yield* pushEventsToSyncBackend({
+        configPath,
+        storeId,
+        clientId,
+        data: {
+          version: 1,
+          storeId: 'different-store',
+          exportedAt: new Date().toISOString(),
+          eventCount: importBatch.length,
+          events: importBatch,
+        },
+        force: true,
+        dryRun: false,
+      })
+
+      expect(result.dryRun).toBe(false)
+      expect(result.eventCount).toBe(importBatch.length)
+
+      const pushedEvents = yield* mockBackend.pushedEvents.pipe(
+        Stream.take(1),
+        Stream.runCollect,
+        Effect.map((chunk: Chunk.Chunk<LiveStoreEvent.Global.Encoded>) => Chunk.toReadonlyArray(chunk)),
+      )
+      expect(pushedEvents).toHaveLength(1)
+
+      const lifecycle = yield* expectConnectLifecycle(connectionEvents)
+      expect(lifecycle).toEqual(['connect', 'disconnect'])
+    }).pipe(withTestCtx(test)),
+  )
+
+  Vitest.scopedLive('rejects store ID mismatch without force', (test: Vitest.TestContext) =>
+    Effect.gen(function* () {
+      const { configPath, connectionEvents } = yield* useMockConfig
+      const factory = makeEventFactory()
+      const importBatch = [factory.itemAdded.next({ id: 'mismatch', title: 'Mismatch' })]
+
+      const result = yield* pushEventsToSyncBackend({
+        configPath,
+        storeId,
+        clientId,
+        data: {
+          version: 1,
+          storeId: 'other-store',
+          exportedAt: new Date().toISOString(),
+          eventCount: importBatch.length,
+          events: importBatch,
+        },
+        force: false,
+        dryRun: false,
+      }).pipe(Effect.either)
+
+      expect(result._tag).toBe('Left')
+      if (result._tag === 'Left') {
+        expect(result.left._tag).toBe('ImportError')
+      }
+
+      const lifecycle = yield* expectConnectLifecycle(connectionEvents)
+      expect(lifecycle).toEqual(['connect', 'disconnect'])
+    }).pipe(withTestCtx(test)),
+  )
+})

package/src/bin.ts

@@ -3,6 +3,7 @@
 import { liveStoreVersion } from '@livestore/common'
 import { Console, Effect, FetchHttpClient, Layer, Logger, LogLevel } from '@livestore/utils/effect'
 import { Cli, PlatformNode } from '@livestore/utils/node'
+
 import { command } from './cli.ts'
 
 const cli = Cli.Command.run(command, {

package/src/cli.ts

@@ -1,10 +1,9 @@
 import { Cli } from '@livestore/utils/node'
+
+import { syncCommand } from './commands/import-export.ts'
 import { mcpCommand } from './commands/mcp.ts'
-import { newProjectCommand } from './commands/new-project.ts'
+import { createCommand } from './commands/new-project.ts'
 
 export const command = Cli.Command.make('livestore', {
   verbose: Cli.Options.boolean('verbose').pipe(Cli.Options.withDefault(false)),
-}).pipe(Cli.Command.withSubcommands([mcpCommand, newProjectCommand]))
-
-if (import.meta.main) {
-}
+}).pipe(Cli.Command.withSubcommands([mcpCommand, createCommand, syncCommand]))