@livestore/cli 0.4.0-dev.8 → 0.4.0

package/dist/mcp-runtime/runtime.d.ts

@@ -0,0 +1,48 @@
+import { UnknownError } from '@livestore/common';
+import type { Store } from '@livestore/livestore';
+import { Effect, Option, Schema } from '@livestore/utils/effect';
+/**
+ * Dynamically imports a module that exports a `makeStore({ storeId }): Promise<Store>` function,
+ * calls it with the provided storeId, and caches the Store instance for subsequent tool calls.
+ */
+export declare const init: ({ configPath, storeId, clientId, sessionId, }: {
+    configPath: string;
+    storeId: string;
+    clientId?: string;
+    sessionId?: string;
+}) => Effect.Effect<Store<any>, UnknownError>;
+export declare const getStore: Effect.Effect<Option.Option<Store<any, {}>>, never, never>;
+export declare const status: Effect.Effect<{
+    _tag: "disconnected";
+    storeId?: never;
+    clientId?: never;
+    sessionId?: never;
+    tableCounts?: never;
+} | {
+    _tag: "connected";
+    storeId: string;
+    clientId: string;
+    sessionId: string;
+    tableCounts: Record<string, number>;
+}, never, never>;
+export declare const query: (args_0: {
+    sql: string;
+    bindValues?: readonly any[] | Record<string, unknown>;
+}) => Effect.Effect<{
+    rows: {
+        [k: string]: Schema.JsonValue;
+    }[];
+    rowCount: number;
+}, never, never>;
+export declare const commit: (args_0: {
+    events: ReadonlyArray<{
+        name: string;
+        args: Schema.JsonValue;
+    }>;
+}) => Effect.Effect<{
+    committed: number;
+}, never, never>;
+export declare const disconnect: Effect.Effect<{
+    _tag: "disconnected";
+}, never, never>;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/mcp-runtime/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/mcp-runtime/runtime.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAEhD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AAEjD,OAAO,EAAE,MAAM,EAA0B,MAAM,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAWxF;;;GAGG;AACH,eAAO,MAAM,IAAI,GAAI,+CAKlB;IACD,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,KAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,YAAY,CA2CuC,CAAA;AAEjF,eAAO,MAAM,QAAQ,4DAAgD,CAAA;AAErE,eAAO,MAAM,MAAM;;;;;;;;;;;;gBAyB2B,CAAA;AAE9C,eAAO,MAAM,KAAK;SAIX,MAAM;iBACE,SAAS,GAAG,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;gBAWrD,CAAA;AAEF,eAAO,MAAM,MAAM;YAGT,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,SAAS,CAAA;KAAE,CAAC;;;gBAW/D,CAAA;AAEF,eAAO,MAAM,UAAU;;gBAQ2B,CAAA"}

package/dist/mcp-runtime/runtime.js

@@ -0,0 +1,107 @@
+import { makeAdapter as makeNodeAdapter } from '@livestore/adapter-node';
+import { UnknownError } from '@livestore/common';
+import { LiveStoreEvent, SystemTables } from '@livestore/common/schema';
+import { createStorePromise } from '@livestore/livestore';
+import { Effect, FetchHttpClient, Layer, Option, Schema } from '@livestore/utils/effect';
+import { PlatformNode } from '@livestore/utils/node';
+import { loadModuleConfig } from "../module-loader.js";
+/** Currently connected store */
+let store;
+/** Layer providing FileSystem and HttpClient for module loading */
+const ModuleLoaderLayer = Layer.mergeAll(PlatformNode.NodeFileSystem.layer, FetchHttpClient.layer);
+/**
+ * Dynamically imports a module that exports a `makeStore({ storeId }): Promise<Store>` function,
+ * calls it with the provided storeId, and caches the Store instance for subsequent tool calls.
+ */
+export const init = ({ configPath, storeId, clientId, sessionId, }) => Effect.gen(function* () {
+    if (storeId === '' || typeof storeId !== 'string') {
+        return yield* UnknownError.make({ cause: new Error('Invalid storeId: expected a non-empty string') });
+    }
+    const { schema, syncBackendConstructor, syncPayloadSchema, syncPayload } = yield* loadModuleConfig({ configPath });
+    // Build Node adapter internally
+    const adapter = makeNodeAdapter({
+        storage: { type: 'in-memory' },
+        ...(clientId !== undefined && clientId !== '' ? { clientId } : {}),
+        ...(sessionId !== undefined && sessionId !== '' ? { sessionId } : {}),
+        sync: {
+            backend: syncBackendConstructor,
+            initialSyncOptions: { _tag: 'Blocking', timeout: 5000 },
+            onSyncError: 'shutdown',
+        },
+    });
+    // Create the store
+    const s = yield* Effect.promise(() => createStorePromise({
+        schema,
+        storeId,
+        adapter,
+        disableDevtools: true,
+        syncPayload,
+        syncPayloadSchema,
+    }));
+    // Replace existing store if any
+    if (store !== undefined) {
+        yield* Effect.promise(async () => {
+            try {
+                await store.shutdownPromise();
+            }
+            catch { }
+        });
+    }
+    store = s;
+    return store;
+}).pipe(Effect.provide(ModuleLoaderLayer), Effect.withSpan('mcp-runtime:init'));
+export const getStore = Effect.sync(() => Option.fromNullable(store));
+export const status = Effect.gen(function* () {
+    const opt = yield* getStore;
+    if (opt._tag === 'None') {
+        return {
+            _tag: 'disconnected',
+        };
+    }
+    const s = opt.value;
+    const tableCounts = Array.from(s.schema.state.sqlite.tables.keys())
+        .filter((name) => !SystemTables.isStateSystemTable(name))
+        .reduce((acc, name) => {
+        acc[name] = s.query(s.schema.state.sqlite.tables.get(name).count());
+        return acc;
+    }, {});
+    return {
+        _tag: 'connected',
+        storeId: s.storeId,
+        clientId: s.clientId,
+        sessionId: s.sessionId,
+        tableCounts,
+    };
+}).pipe(Effect.withSpan('mcp-runtime:status'));
+export const query = Effect.fn('mcp-runtime:query')(function* ({ sql, bindValues, }) {
+    const opt = yield* getStore;
+    if (opt._tag === 'None') {
+        return yield* Effect.dieMessage('LiveStore not connected. Call livestore_instance_connect first.');
+    }
+    const s = opt.value;
+    const rows = s.query({ query: sql, bindValues: bindValues ?? [] });
+    const jsonRows = rows.map((r) => Object.fromEntries(Object.entries(r).map(([k, v]) => [k, v])));
+    return { rows: jsonRows, rowCount: jsonRows.length };
+});
+export const commit = Effect.fn('mcp-runtime:commit')(function* ({ events, }) {
+    const opt = yield* getStore;
+    if (opt._tag === 'None') {
+        return yield* Effect.dieMessage('LiveStore not connected. Call livestore_instance_connect first.');
+    }
+    const s = opt.value;
+    const InputEventSchema = LiveStoreEvent.Input.makeSchema(s.schema);
+    const decoded = events.map((e) => Schema.decodeSync(InputEventSchema)(e));
+    s.commit(...decoded);
+    return { committed: decoded.length };
+});
+export const disconnect = Effect.promise(async () => {
+    if (store !== undefined) {
+        try {
+            await store.shutdownPromise();
+        }
+        catch { }
+        store = undefined;
+    }
+    return { _tag: 'disconnected' };
+}).pipe(Effect.withSpan('mcp-runtime:disconnect'));
+//# sourceMappingURL=runtime.js.map

package/dist/mcp-runtime/runtime.js.map

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

package/dist/module-loader.d.ts

@@ -0,0 +1,22 @@
+import type { SyncBackend } from '@livestore/common';
+import { UnknownError } from '@livestore/common';
+import { type LiveStoreSchema } from '@livestore/common/schema';
+import { Effect, FileSystem, Schema } from '@livestore/utils/effect';
+export interface ModuleConfig {
+    schema: LiveStoreSchema;
+    syncBackendConstructor: SyncBackend.SyncBackendConstructor;
+    syncPayloadSchema: Schema.Schema<any>;
+    syncPayload: unknown;
+}
+/**
+ * Loads and validates a user config module.
+ * The module must export:
+ * - `schema`: A valid LiveStore schema
+ * - `syncBackend`: A sync backend constructor function
+ * - `syncPayloadSchema` (optional): Schema for validating syncPayload
+ * - `syncPayload` (optional): Payload data for the sync backend
+ */
+export declare const loadModuleConfig: ({ configPath, }: {
+    configPath: string;
+}) => Effect.Effect<ModuleConfig, UnknownError, FileSystem.FileSystem>;
+//# sourceMappingURL=module-loader.d.ts.map

package/dist/module-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-loader.d.ts","sourceRoot":"","sources":["../src/module-loader.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAqB,KAAK,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAElF,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAEpE,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,eAAe,CAAA;IACvB,sBAAsB,EAAE,WAAW,CAAC,sBAAsB,CAAA;IAC1D,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IACrC,WAAW,EAAE,OAAO,CAAA;CACrB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,GAAI,iBAE9B;IACD,UAAU,EAAE,MAAM,CAAA;CACnB,KAAG,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,YAAY,EAAE,UAAU,CAAC,UAAU,CA6DP,CAAA"}

package/dist/module-loader.js

@@ -0,0 +1,75 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+/**
+ * Shared module loading utility for CLI and MCP.
+ * Loads and validates user config modules that export schema, syncBackend, and optional syncPayload.
+ */
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { UnknownError } from '@livestore/common';
+import { isLiveStoreSchema } from '@livestore/common/schema';
+import { shouldNeverHappen } from '@livestore/utils';
+import { Effect, FileSystem, Schema } from '@livestore/utils/effect';
+/**
+ * Loads and validates a user config module.
+ * The module must export:
+ * - `schema`: A valid LiveStore schema
+ * - `syncBackend`: A sync backend constructor function
+ * - `syncPayloadSchema` (optional): Schema for validating syncPayload
+ * - `syncPayload` (optional): Payload data for the sync backend
+ */
+export const loadModuleConfig = ({ configPath, }) => Effect.gen(function* () {
+    const abs = path.isAbsolute(configPath) === true ? configPath : path.resolve(process.cwd(), configPath);
+    const fs = yield* FileSystem.FileSystem;
+    const exists = yield* fs.exists(abs).pipe(UnknownError.mapToUnknownError);
+    if (exists === false) {
+        return yield* UnknownError.make({
+            cause: `Store module not found at ${abs}`,
+            note: 'Make sure the path points to a valid LiveStore module',
+        });
+    }
+    const mod = yield* Effect.tryPromise({
+        try: () => import(__rewriteRelativeImportExtension(pathToFileURL(abs).href)),
+        catch: (cause) => UnknownError.make({
+            cause,
+            note: `Failed to import module at ${abs}`,
+        }),
+    });
+    const schema = (mod)?.schema;
+    if (isLiveStoreSchema(schema) === false) {
+        return yield* UnknownError.make({
+            cause: `Module at ${abs} must export a valid LiveStore 'schema'`,
+            note: `Ex: export { schema } from './src/livestore/schema.ts'`,
+        });
+    }
+    const syncBackendConstructor = (mod)?.syncBackend;
+    if (typeof syncBackendConstructor !== 'function') {
+        return yield* UnknownError.make({
+            cause: `Module at ${abs} must export a 'syncBackend' constructor`,
+            note: `Ex: export const syncBackend = makeWsSync({ url })`,
+        });
+    }
+    const syncPayloadSchemaExport = (mod)?.syncPayloadSchema;
+    const syncPayloadSchema = syncPayloadSchemaExport === undefined
+        ? Schema.JsonValue
+        : Schema.isSchema(syncPayloadSchemaExport) === true
+            ? syncPayloadSchemaExport
+            : shouldNeverHappen(`Exported 'syncPayloadSchema' from ${abs} must be an Effect Schema (received ${typeof syncPayloadSchemaExport}).`);
+    const syncPayloadExport = (mod)?.syncPayload;
+    const syncPayload = yield* (syncPayloadExport === undefined
+        ? Effect.succeed(undefined)
+        : Schema.decodeUnknown(syncPayloadSchema)(syncPayloadExport)).pipe(UnknownError.mapToUnknownError);
+    return {
+        schema,
+        syncBackendConstructor,
+        syncPayloadSchema,
+        syncPayload,
+    };
+}).pipe(Effect.withSpan('module-loader:loadModuleConfig'));
+//# sourceMappingURL=module-loader.js.map

package/dist/module-loader.js.map

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

package/dist/package-manager.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Supported package managers for LiveStore projects.
+ * Yarn is explicitly not supported due to compatibility issues.
+ */
+export type PackageManager = 'npm' | 'pnpm' | 'bun';
+/**
+ * Result of package manager detection.
+ * Returns 'unsupported' for yarn to allow the CLI to show a warning message.
+ */
+export type DetectPackageManagerResult = {
+    _tag: 'supported';
+    pm: PackageManager;
+} | {
+    _tag: 'unsupported';
+    pm: 'yarn';
+};
+/**
+ * Detects the package manager used to invoke the CLI based on the `npm_config_user_agent`
+ * environment variable. This env var is set by npm, pnpm, yarn, and bun when running scripts.
+ *
+ * - Returns 'unsupported' for yarn so the CLI can show a recommendation to use bun instead
+ * - Falls back to 'bun' when detection fails (e.g., when run directly without a package manager)
+ */
+export declare const detectPackageManager: (userAgent?: string) => DetectPackageManagerResult;
+/** Package manager command templates */
+export declare const pmCommands: {
+    readonly install: {
+        readonly npm: "npm install";
+        readonly pnpm: "pnpm install";
+        readonly bun: "bun install";
+    };
+    readonly run: {
+        readonly npm: (script: string) => string;
+        readonly pnpm: (script: string) => string;
+        readonly bun: (script: string) => string;
+    };
+};
+//# sourceMappingURL=package-manager.d.ts.map

package/dist/package-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-manager.d.ts","sourceRoot":"","sources":["../src/package-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAAA;AAEnD;;;GAGG;AACH,MAAM,MAAM,0BAA0B,GAAG;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,EAAE,EAAE,cAAc,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAA;AAExH;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAC/B,kBAAmD,KAClD,0BAQF,CAAA;AAED,wCAAwC;AACxC,eAAO,MAAM,UAAU;;;;;;;+BAOL,MAAM;gCACL,MAAM;+BACP,MAAM;;CAEd,CAAA"}

package/dist/package-manager.js

@@ -0,0 +1,33 @@
+/**
+ * Detects the package manager used to invoke the CLI based on the `npm_config_user_agent`
+ * environment variable. This env var is set by npm, pnpm, yarn, and bun when running scripts.
+ *
+ * - Returns 'unsupported' for yarn so the CLI can show a recommendation to use bun instead
+ * - Falls back to 'bun' when detection fails (e.g., when run directly without a package manager)
+ */
+export const detectPackageManager = (userAgent = process.env.npm_config_user_agent ?? '') => {
+    if (userAgent.startsWith('bun/') === true)
+        return { _tag: 'supported', pm: 'bun' };
+    if (userAgent.startsWith('pnpm/') === true)
+        return { _tag: 'supported', pm: 'pnpm' };
+    if (userAgent.startsWith('npm/') === true)
+        return { _tag: 'supported', pm: 'npm' };
+    if (userAgent.startsWith('yarn/') === true)
+        return { _tag: 'unsupported', pm: 'yarn' };
+    // Default to bun when the package manager can't be detected
+    return { _tag: 'supported', pm: 'bun' };
+};
+/** Package manager command templates */
+export const pmCommands = {
+    install: {
+        npm: 'npm install',
+        pnpm: 'pnpm install',
+        bun: 'bun install',
+    },
+    run: {
+        npm: (script) => `npm run ${script}`,
+        pnpm: (script) => `pnpm ${script}`,
+        bun: (script) => `bun ${script}`,
+    },
+};
+//# sourceMappingURL=package-manager.js.map

package/dist/package-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-manager.js","sourceRoot":"","sources":["../src/package-manager.ts"],"names":[],"mappings":"AAYA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,EAAE,EACvB,EAAE;IAC9B,IAAI,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,IAAI;QAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,KAAK,EAAE,CAAA;IAClF,IAAI,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,IAAI;QAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,CAAA;IACpF,IAAI,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,IAAI;QAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,KAAK,EAAE,CAAA;IAClF,IAAI,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,IAAI;QAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,EAAE,CAAA;IAEtF,4DAA4D;IAC5D,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,KAAK,EAAE,CAAA;AACzC,CAAC,CAAA;AAED,wCAAwC;AACxC,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,OAAO,EAAE;QACP,GAAG,EAAE,aAAa;QAClB,IAAI,EAAE,cAAc;QACpB,GAAG,EAAE,aAAa;KACnB;IACD,GAAG,EAAE;QACH,GAAG,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,WAAW,MAAM,EAAE;QAC5C,IAAI,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,QAAQ,MAAM,EAAE;QAC1C,GAAG,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,OAAO,MAAM,EAAE;KACzC;CACO,CAAA"}

package/dist/package-manager.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=package-manager.test.d.ts.map

package/dist/package-manager.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-manager.test.d.ts","sourceRoot":"","sources":["../src/package-manager.test.ts"],"names":[],"mappings":""}

package/dist/package-manager.test.js

@@ -0,0 +1,57 @@
+import { Vitest } from '@livestore/utils-dev/node-vitest';
+import { detectPackageManager, pmCommands } from "./package-manager.js";
+Vitest.describe('detectPackageManager', () => {
+    Vitest.it('detects npm from user agent', () => {
+        const result = detectPackageManager('npm/10.2.4 node/v20.11.0 darwin arm64 workspaces/false');
+        Vitest.expect(result).toEqual({ _tag: 'supported', pm: 'npm' });
+    });
+    Vitest.it('detects pnpm from user agent', () => {
+        const result = detectPackageManager('pnpm/9.0.6 npm/? node/v22.0.0 darwin arm64');
+        Vitest.expect(result).toEqual({ _tag: 'supported', pm: 'pnpm' });
+    });
+    Vitest.it('detects yarn as unsupported', () => {
+        const result = detectPackageManager('yarn/1.22.19 npm/? node/v20.11.0 darwin arm64');
+        Vitest.expect(result).toEqual({ _tag: 'unsupported', pm: 'yarn' });
+    });
+    Vitest.it('detects bun from user agent', () => {
+        const result = detectPackageManager('bun/1.1.7');
+        Vitest.expect(result).toEqual({ _tag: 'supported', pm: 'bun' });
+    });
+    Vitest.it('falls back to bun for empty user agent', () => {
+        const result = detectPackageManager('');
+        Vitest.expect(result).toEqual({ _tag: 'supported', pm: 'bun' });
+    });
+    Vitest.it('uses process.env.npm_config_user_agent when no argument provided', () => {
+        const originalEnv = process.env.npm_config_user_agent;
+        try {
+            process.env.npm_config_user_agent = 'pnpm/9.0.6';
+            const result = detectPackageManager();
+            Vitest.expect(result).toEqual({ _tag: 'supported', pm: 'pnpm' });
+        }
+        finally {
+            process.env.npm_config_user_agent = originalEnv;
+        }
+    });
+    Vitest.it('falls back to bun for unknown user agent', () => {
+        const result = detectPackageManager('some-unknown-tool/1.0.0');
+        Vitest.expect(result).toEqual({ _tag: 'supported', pm: 'bun' });
+    });
+});
+Vitest.describe('pmCommands', () => {
+    Vitest.it('provides correct install commands for each package manager', () => {
+        Vitest.expect(pmCommands.install.npm).toBe('npm install');
+        Vitest.expect(pmCommands.install.pnpm).toBe('pnpm install');
+        Vitest.expect(pmCommands.install.bun).toBe('bun install');
+    });
+    Vitest.it('provides correct run commands for dev script', () => {
+        Vitest.expect(pmCommands.run.npm('dev')).toBe('npm run dev');
+        Vitest.expect(pmCommands.run.pnpm('dev')).toBe('pnpm dev');
+        Vitest.expect(pmCommands.run.bun('dev')).toBe('bun dev');
+    });
+    Vitest.it('provides correct run commands for start script', () => {
+        Vitest.expect(pmCommands.run.npm('start')).toBe('npm run start');
+        Vitest.expect(pmCommands.run.pnpm('start')).toBe('pnpm start');
+        Vitest.expect(pmCommands.run.bun('start')).toBe('bun start');
+    });
+});
+//# sourceMappingURL=package-manager.test.js.map

package/dist/package-manager.test.js.map

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

package/dist/sync-operations.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Shared sync operations for CLI and MCP.
+ * Contains the core logic for exporting and importing events from sync backends.
+ */
+import type { SyncBackend } from '@livestore/common';
+import { UnknownError } from '@livestore/common';
+import { Effect, type FileSystem, type HttpClient, Schema, type Scope } from '@livestore/utils/effect';
+/**
+ * Schema for the export file format.
+ * Contains metadata about the export and an array of events in global encoded format.
+ */
+export declare const ExportFileSchema: Schema.Struct<{
+    /** Format version for future compatibility */
+    version: Schema.Literal<[1]>;
+    /** Store identifier */
+    storeId: typeof Schema.String;
+    /** ISO timestamp of when the export was created */
+    exportedAt: typeof Schema.String;
+    /** Total number of events in the export */
+    eventCount: typeof Schema.Number;
+    /** Array of events in global encoded format */
+    events: Schema.Array$<Schema.Struct<{
+        name: typeof Schema.String;
+        args: typeof Schema.Any;
+        seqNum: Schema.BrandSchema<number & import("effect/Brand").Brand<"GlobalEventSequenceNumber">, number, never>;
+        parentSeqNum: Schema.BrandSchema<number & import("effect/Brand").Brand<"GlobalEventSequenceNumber">, number, never>;
+        clientId: typeof Schema.String;
+        sessionId: typeof Schema.String;
+    }>>;
+}>;
+export type ExportFile = typeof ExportFileSchema.Type;
+declare const ConnectionError_base: Schema.TaggedErrorClass<ConnectionError, "ConnectionError", {
+    readonly _tag: Schema.tag<"ConnectionError">;
+} & {
+    cause: typeof Schema.Defect;
+    note: typeof Schema.String;
+}>;
+export declare class ConnectionError extends ConnectionError_base {
+}
+declare const ExportError_base: Schema.TaggedErrorClass<ExportError, "ExportError", {
+    readonly _tag: Schema.tag<"ExportError">;
+} & {
+    cause: typeof Schema.Defect;
+    note: typeof Schema.String;
+}>;
+export declare class ExportError extends ExportError_base {
+}
+declare const ImportError_base: Schema.TaggedErrorClass<ImportError, "ImportError", {
+    readonly _tag: Schema.tag<"ImportError">;
+} & {
+    cause: typeof Schema.Defect;
+    note: typeof Schema.String;
+}>;
+export declare class ImportError extends ImportError_base {
+}
+/**
+ * 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 declare const makeSyncBackend: ({ configPath, storeId, clientId, }: {
+    /** Absolute or cwd-relative path to a module exporting `schema` and `syncBackend`. */
+    configPath: string;
+    /** Identifier to scope the backend connection. */
+    storeId: string;
+    /** Client identifier used when establishing the sync connection. */
+    clientId: string;
+}) => Effect.Effect<SyncBackend.SyncBackend, UnknownError | ConnectionError, FileSystem.FileSystem | HttpClient.HttpClient | Scope.Scope>;
+export interface ExportResult {
+    storeId: string;
+    eventCount: number;
+    exportedAt: string;
+    backendName: string;
+    /** The export data as JSON string (for MCP) or written to file (for CLI) */
+    data: ExportFile;
+}
+/**
+ * Core export operation - pulls all events from sync backend.
+ * Returns the export data structure without writing to file.
+ */
+export declare const pullEventsFromSyncBackend: ({ configPath, storeId, clientId, }: {
+    configPath: string;
+    storeId: string;
+    clientId: string;
+}) => Effect.Effect<ExportResult, ExportError | UnknownError | ConnectionError, FileSystem.FileSystem | HttpClient.HttpClient | Scope.Scope>;
+export interface ImportResult {
+    storeId: string;
+    eventCount: number;
+    /** Whether this was a dry run */
+    dryRun: boolean;
+    backendName?: string;
+}
+export interface ImportValidationResult {
+    storeId: string;
+    eventCount: number;
+    sourceStoreId: string;
+    storeIdMismatch: boolean;
+}
+/**
+ * Validates an export file for import.
+ * Returns validation info without actually importing.
+ */
+export declare const validateExportData: ({ data, targetStoreId, }: {
+    data: unknown;
+    targetStoreId: string;
+}) => Effect.Effect<ImportValidationResult, ImportError>;
+/**
+ * Core import operation - pushes events to sync backend.
+ * Validates that the backend is empty before importing.
+ */
+export declare const pushEventsToSyncBackend: ({ configPath, storeId, clientId, data, force, dryRun, onProgress, }: {
+    configPath: string;
+    storeId: string;
+    clientId: string;
+    /** The export data to import (already parsed) */
+    data: unknown;
+    force: boolean;
+    dryRun: boolean;
+    onProgress?: (pushed: number, total: number) => Effect.Effect<void>;
+}) => Effect.Effect<ImportResult, ImportError | UnknownError | ConnectionError, FileSystem.FileSystem | HttpClient.HttpClient | Scope.Scope>;
+export {};
+//# sourceMappingURL=sync-operations.d.ts.map

package/dist/sync-operations.d.ts.map

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