@livestore/common 0.0.0-snapshot-909cdd1ac2fd591945c2be2b0f53e14d87f3c9d4

package/dist/sync/next/test/mutation-fixtures.d.ts

@@ -0,0 +1,73 @@
+import type { MutationDef } from '../../../schema/mutations.js';
+import type { HistoryDagNode } from '../history-dag.js';
+/** Used for conflict detection and event history compaction */
+export declare const facts: {
+    todoExists: (id: string) => string;
+    todoIsWriteable: (id: string, writeable: boolean) => [string, boolean];
+    todoCompleted: (id: string, completed: boolean) => [string, boolean];
+    todoTextUpdated: (id: string) => string;
+    inputValue: (id: string) => string;
+};
+export declare const mutations: {
+    createTodo: MutationDef<"createTodo", {
+        readonly text: string;
+        readonly id: string;
+    }, {
+        readonly text: string;
+        readonly id: string;
+    }>;
+    upsertTodo: MutationDef<"upsertTodo", {
+        readonly id: string;
+        readonly text?: string | undefined;
+    }, {
+        readonly text?: string | undefined;
+        readonly id: string;
+    }>;
+    completeTodo: MutationDef<"completeTodo", {
+        readonly id: string;
+    }, {
+        readonly id: string;
+    }>;
+    uncompleteTodo: MutationDef<"uncompleteTodo", {
+        readonly id: string;
+    }, {
+        readonly id: string;
+    }>;
+    completeTodos: MutationDef<"completeTodos", {
+        readonly ids: readonly string[];
+    }, {
+        readonly ids: readonly string[];
+    }>;
+    toggleTodo: MutationDef<"toggleTodo", {
+        readonly id: string;
+    }, {
+        readonly id: string;
+    }>;
+    setReadonlyTodo: MutationDef<"setReadonlyTodo", {
+        readonly id: string;
+        readonly readonly: boolean;
+    }, {
+        readonly id: string;
+        readonly readonly: boolean;
+    }>;
+    setTextTodo: MutationDef<"setTextTodo", {
+        readonly text: string;
+        readonly id: string;
+    }, {
+        readonly text: string;
+        readonly id: string;
+    }>;
+    setInputValue: MutationDef<"setInputValue", {
+        readonly text: string;
+        readonly id: string;
+    }, {
+        readonly text: string;
+        readonly id: string;
+    }>;
+};
+export type PartialEvent = {
+    mutation: string;
+    args: any;
+};
+export declare const toEventNodes: (partialEvents: PartialEvent[], mutationDefs: Record<string, MutationDef.Any>) => HistoryDagNode[];
+//# sourceMappingURL=mutation-fixtures.d.ts.map

package/dist/sync/next/test/mutation-fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation-fixtures.d.ts","sourceRoot":"","sources":["../../../../src/sync/next/test/mutation-fixtures.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAG/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAGvD,+DAA+D;AAC/D,eAAO,MAAM,KAAK;qBACC,MAAM;0BACD,MAAM,aAAa,OAAO;wBAC5B,MAAM,aAAa,OAAO;0BACxB,MAAM;qBACX,MAAM;CACvB,CAAA;AAEF,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+GrB,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,GAAG,CAAA;CAAE,CAAA;AAE1D,eAAO,MAAM,YAAY,kBACR,YAAY,EAAE,gBACf,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC,KAC5C,cAAc,EAkFhB,CAAA"}

package/dist/sync/next/test/mutation-fixtures.js

@@ -0,0 +1,161 @@
+import { Schema } from '@livestore/utils/effect';
+import { ROOT_ID } from '../../../adapter-types.js';
+import { defineFacts, defineMutation } from '../../../schema/mutations.js';
+import { factsSnapshotForDag, getFactsGroupForMutationArgs } from '../facts.js';
+import { historyDagFromNodes, rootEventNode } from '../history-dag.js';
+/** Used for conflict detection and event history compaction */
+export const facts = defineFacts({
+    todoExists: (id) => `todo-exists-${id}`,
+    todoIsWriteable: (id, writeable) => [`todo-is-writeable-${id}`, writeable],
+    todoCompleted: (id, completed) => [`todo-completed-${id}`, completed],
+    todoTextUpdated: (id) => `todo-text-updated-${id}`,
+    inputValue: (id) => `input-value-${id}`,
+});
+export const mutations = {
+    createTodo: defineMutation('createTodo', Schema.Struct({ id: Schema.String, text: Schema.String }), 'INSERT INTO todos (id, text) VALUES ($id, $text)', {
+        facts: ({ id }) => ({
+            modify: {
+                set: [facts.todoExists(id), facts.todoIsWriteable(id, true), facts.todoCompleted(id, false)],
+            },
+        }),
+    }),
+    upsertTodo: defineMutation('upsertTodo', Schema.Struct({ id: Schema.String, text: Schema.optional(Schema.String) }), 'INSERT INTO todos (id, text) VALUES ($id, $text) ON CONFLICT (id) DO UPDATE SET text = $text', {
+        facts: ({ id }, currentFacts) => 
+        // TODO enable an API along the lines of `map.has(key, value)`
+        currentFacts.has(facts.todoExists(id)) && currentFacts.get(facts.todoIsWriteable(id, true)[0]) === false
+            ? { require: [facts.todoExists(id), facts.todoIsWriteable(id, true)] }
+            : { modify: { set: [facts.todoExists(id), facts.todoIsWriteable(id, true), facts.todoTextUpdated(id)] } },
+    }),
+    completeTodo: defineMutation('completeTodo', Schema.Struct({ id: Schema.String }), 
+    // consider `RETURNING` to validate before applying facts
+    'UPDATE todos SET completed = true WHERE id = $id', {
+        // prewrite assertions from DB
+        // enables more concurrency
+        // turning database inside out
+        // similar to upsert semantics
+        facts: ({ id }) => ({
+            require: [facts.todoExists(id), facts.todoIsWriteable(id, true)],
+            modify: { set: [facts.todoCompleted(id, true)] },
+        }),
+    }),
+    uncompleteTodo: defineMutation('uncompleteTodo', Schema.Struct({ id: Schema.String }), 'UPDATE todos SET completed = false WHERE id = $id', {
+        facts: ({ id }) => ({
+            require: [facts.todoExists(id), facts.todoIsWriteable(id, true)],
+            modify: { set: [facts.todoCompleted(id, false)] },
+        }),
+    }),
+    completeTodos: defineMutation('completeTodos', Schema.Struct({ ids: Schema.Array(Schema.String) }), 'UPDATE todos SET completed = true WHERE id IN ($ids:csv)', {
+        facts: ({ ids }) => ({
+            require: ids.flatMap((id) => [facts.todoExists(id), facts.todoIsWriteable(id, true)]),
+            modify: { set: ids.map((id) => facts.todoCompleted(id, true)) },
+        }),
+    }),
+    toggleTodo: defineMutation('toggleTodo', Schema.Struct({ id: Schema.String }), 'UPDATE todos SET completed = NOT completed WHERE id = $id', {
+        facts: ({ id }, currentFacts) => {
+            const currentIsCompleted = currentFacts.get(facts.todoCompleted(id, true)[0]) === true;
+            return {
+                require: [facts.todoExists(id), facts.todoIsWriteable(id, true)],
+                modify: {
+                    // remove: [facts.todoCompleted(id, currentIsCompleted)],
+                    set: [facts.todoCompleted(id, !currentIsCompleted)],
+                },
+            };
+        },
+    }),
+    setReadonlyTodo: defineMutation('setReadonlyTodo', Schema.Struct({ id: Schema.String, readonly: Schema.Boolean }), 'UPDATE todos SET readonly = $readonly WHERE id = $id', {
+        facts: ({ id, readonly }) => ({
+            require: [facts.todoExists(id)],
+            modify: { set: [facts.todoIsWriteable(id, !readonly)] },
+        }),
+    }),
+    setTextTodo: defineMutation('setTextTodo', Schema.Struct({ id: Schema.String, text: Schema.String }), 'UPDATE todos SET text = $text WHERE id = $id', {
+        facts: ({ id }) => ({
+            require: [facts.todoExists(id), facts.todoIsWriteable(id, true)],
+            modify: { set: [facts.todoTextUpdated(id)] },
+        }),
+    }),
+    setInputValue: defineMutation('setInputValue', Schema.Struct({ id: Schema.String, text: Schema.String }), 'UPDATE todos SET text = $text WHERE id = $id', {
+        localOnly: true,
+        facts: ({ id }) => ({ modify: { set: [facts.inputValue(id)] } }),
+    }),
+};
+export const toEventNodes = (partialEvents, mutationDefs) => {
+    const nodesAcc = [rootEventNode];
+    let currentEventId = ROOT_ID;
+    const getNextEventId = (mutationDef) => {
+        if (mutationDef.options.localOnly) {
+            return { global: currentEventId.global, local: currentEventId.local + 1 };
+        }
+        return { global: currentEventId.global + 1, local: 0 };
+    };
+    const eventNodes = partialEvents.map((partialEvent) => {
+        const mutationDef = mutationDefs[partialEvent.mutation];
+        const eventId = getNextEventId(mutationDef);
+        currentEventId = eventId;
+        const factsSnapshot = factsSnapshotForDag(historyDagFromNodes(nodesAcc, { skipFactsCheck: true }), undefined);
+        // console.log('factsSnapshot', eventId, factsSnapshot)
+        // const depRead: MutationEventFactsSnapshot = new Map<string, any>()
+        // const factsSnapshotProxy = new Proxy(factsSnapshot, {
+        //   get: (target, prop) => {
+        //     if (prop === 'has') {
+        //       return (key: string) => {
+        //         depRead.set(key, EMPTY_FACT_VALUE)
+        //         return target.has(key)
+        //       }
+        //     } else if (prop === 'get') {
+        //       return (key: string) => {
+        //         depRead.set(key, EMPTY_FACT_VALUE)
+        //         return target.get(key)
+        //       }
+        //     }
+        //     notYetImplemented(`toEventNodes: ${prop.toString()} is not yet implemented`)
+        //   },
+        // })
+        // const factsRes = mutationDef.options.facts?.(partialEvent.args, factsSnapshotProxy)
+        // console.log('factsRes', factsRes?.modify, factsRes?.require)
+        // const iterableToMap = (iterable: Iterable<MutationEventFactInput>) => {
+        //   const map = new Map()
+        //   for (const item of iterable) {
+        //     if (typeof item === 'string') {
+        //       map.set(item, EMPTY_FACT_VALUE)
+        //     } else {
+        //       map.set(item[0], item[1])
+        //     }
+        //   }
+        //   return map
+        // }
+        // const facts = {
+        //   modifyAdd: factsRes?.modify.add ? iterableToMap(factsRes.modify.add) : new Map(),
+        //   modifyRemove: factsRes?.modify.remove ? iterableToMap(factsRes.modify.remove) : new Map(),
+        //   depRequire: factsRes?.require ? iterableToMap(factsRes.require) : new Map(),
+        //   depRead,
+        // } satisfies MutationEventFactsGroup
+        // applyFactGroup(facts, factsSnapshot)
+        const facts = getFactsGroupForMutationArgs({
+            factsCallback: mutationDef.options.facts,
+            args: partialEvent.args,
+            currentFacts: factsSnapshot,
+        });
+        const node = {
+            id: eventId,
+            parentId: getParentId(eventId),
+            mutation: partialEvent.mutation,
+            args: partialEvent.args,
+            factsGroup: facts,
+        };
+        nodesAcc.push(node);
+        return node;
+    });
+    eventNodes.unshift(rootEventNode);
+    // console.log('eventNodes', eventNodes)
+    return eventNodes;
+};
+const getParentId = (eventId) => {
+    const globalParentId = eventId.global;
+    const localParentId = eventId.local - 1;
+    if (localParentId < 0) {
+        return { global: globalParentId - 1, local: 0 };
+    }
+    return { global: globalParentId, local: localParentId };
+};
+//# sourceMappingURL=mutation-fixtures.js.map

package/dist/sync/next/test/mutation-fixtures.js.map

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

package/dist/sync/sync.d.ts

@@ -0,0 +1,45 @@
+import type { Effect, HttpClient, Option, Stream, SubscriptionRef } from '@livestore/utils/effect';
+import { Schema } from '@livestore/utils/effect';
+import type { EventId } from '../adapter-types.js';
+import type { MutationEvent } from '../schema/mutations.js';
+export interface SyncBackendOptionsBase {
+    type: string;
+    [key: string]: Schema.JsonValue;
+}
+export type SyncBackend<TSyncMetadata = Schema.JsonValue> = {
+    pull: (args: Option.Option<{
+        cursor: EventId;
+        metadata: Option.Option<TSyncMetadata>;
+    }>, options: {
+        listenForNew: boolean;
+    }) => Stream.Stream<{
+        mutationEventEncoded: MutationEvent.AnyEncoded;
+        metadata: Option.Option<TSyncMetadata>;
+        persisted: boolean;
+    }, IsOfflineError | InvalidPullError, HttpClient.HttpClient>;
+    push: (mutationEventEncoded: MutationEvent.AnyEncoded, persisted: boolean) => Effect.Effect<{
+        metadata: Option.Option<TSyncMetadata>;
+    }, IsOfflineError | InvalidPushError, HttpClient.HttpClient>;
+    isConnected: SubscriptionRef.SubscriptionRef<boolean>;
+};
+declare const IsOfflineError_base: Schema.TaggedErrorClass<IsOfflineError, "IsOfflineError", {
+    readonly _tag: Schema.tag<"IsOfflineError">;
+}>;
+export declare class IsOfflineError extends IsOfflineError_base {
+}
+declare const InvalidPushError_base: Schema.TaggedErrorClass<InvalidPushError, "InvalidPushError", {
+    readonly _tag: Schema.tag<"InvalidPushError">;
+} & {
+    message: typeof Schema.String;
+}>;
+export declare class InvalidPushError extends InvalidPushError_base {
+}
+declare const InvalidPullError_base: Schema.TaggedErrorClass<InvalidPullError, "InvalidPullError", {
+    readonly _tag: Schema.tag<"InvalidPullError">;
+} & {
+    message: typeof Schema.String;
+}>;
+export declare class InvalidPullError extends InvalidPullError_base {
+}
+export {};
+//# sourceMappingURL=sync.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/sync/sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAClG,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAEhD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAE3D,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAA;IACZ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,SAAS,CAAA;CAChC;AAED,MAAM,MAAM,WAAW,CAAC,aAAa,GAAG,MAAM,CAAC,SAAS,IAAI;IAC1D,IAAI,EAAE,CACJ,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC;QAClB,MAAM,EAAE,OAAO,CAAA;QACf,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAA;KACvC,CAAC,EACF,OAAO,EAAE;QAAE,YAAY,EAAE,OAAO,CAAA;KAAE,KAC/B,MAAM,CAAC,MAAM,CAChB;QACE,oBAAoB,EAAE,aAAa,CAAC,UAAU,CAAA;QAC9C,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAA;QACtC,SAAS,EAAE,OAAO,CAAA;KACnB,EACD,cAAc,GAAG,gBAAgB,EACjC,UAAU,CAAC,UAAU,CACtB,CAAA;IAED,IAAI,EAAE,CACJ,oBAAoB,EAAE,aAAa,CAAC,UAAU,EAC9C,SAAS,EAAE,OAAO,KACf,MAAM,CAAC,MAAM,CAChB;QAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAA;KAAE,EAC1C,cAAc,GAAG,gBAAgB,EACjC,UAAU,CAAC,UAAU,CACtB,CAAA;IACD,WAAW,EAAE,eAAe,CAAC,eAAe,CAAC,OAAO,CAAC,CAAA;CACtD,CAAA;;;;AAED,qBAAa,cAAe,SAAQ,mBAA0D;CAAG;;;;;;AACjG,qBAAa,gBAAiB,SAAQ,qBAEpC;CAAG;;;;;;AACL,qBAAa,gBAAiB,SAAQ,qBAEpC;CAAG"}

package/dist/sync/sync.js

@@ -0,0 +1,12 @@
+import { Schema } from '@livestore/utils/effect';
+export class IsOfflineError extends Schema.TaggedError()('IsOfflineError', {}) {
+}
+export class InvalidPushError extends Schema.TaggedError()('InvalidPushError', {
+    message: Schema.String,
+}) {
+}
+export class InvalidPullError extends Schema.TaggedError()('InvalidPullError', {
+    message: Schema.String,
+}) {
+}
+//# sourceMappingURL=sync.js.map

package/dist/sync/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../src/sync/sync.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAsChD,MAAM,OAAO,cAAe,SAAQ,MAAM,CAAC,WAAW,EAAkB,CAAC,gBAAgB,EAAE,EAAE,CAAC;CAAG;AACjG,MAAM,OAAO,gBAAiB,SAAQ,MAAM,CAAC,WAAW,EAAoB,CAAC,kBAAkB,EAAE;IAC/F,OAAO,EAAE,MAAM,CAAC,MAAM;CACvB,CAAC;CAAG;AACL,MAAM,OAAO,gBAAiB,SAAQ,MAAM,CAAC,WAAW,EAAoB,CAAC,kBAAkB,EAAE;IAC/F,OAAO,EAAE,MAAM,CAAC,MAAM;CACvB,CAAC;CAAG"}

package/dist/util.d.ts

@@ -0,0 +1,25 @@
+import type { Brand } from '@livestore/utils/effect';
+import { Schema } from '@livestore/utils/effect';
+export type ParamsObject = Record<string, SqlValue>;
+export type SqlValue = string | number | Uint8Array | null;
+export type Bindable = ReadonlyArray<SqlValue> | ParamsObject;
+export declare const SqlValueSchema: Schema.Union<[typeof Schema.String, typeof Schema.Number, Schema.Schema<Uint8Array, readonly number[], never>, typeof Schema.Null]>;
+export declare const PreparedBindValues: Schema.brand<Schema.Union<[Schema.Array$<Schema.Union<[typeof Schema.String, typeof Schema.Number, Schema.Schema<Uint8Array, readonly number[], never>, typeof Schema.Null]>>, Schema.Record$<typeof Schema.String, Schema.Union<[typeof Schema.String, typeof Schema.Number, Schema.Schema<Uint8Array, readonly number[], never>, typeof Schema.Null]>>]>, "PreparedBindValues">;
+export type PreparedBindValues = Brand.Branded<Bindable, 'PreparedBindValues'>;
+/**
+ * This is a tag function for tagged literals.
+ * it lets us get syntax highlighting on SQL queries in VSCode, but
+ * doesn't do anything at runtime.
+ * Code copied from: https://esdiscuss.org/topic/string-identity-template-tag
+ */
+export declare const sql: (template: TemplateStringsArray, ...args: unknown[]) => string;
+/**
+ * Prepare bind values to send to SQLite
+ * Add $ to the beginning of keys; which we use as our interpolation syntax
+ * We also strip out any params that aren't used in the statement,
+ * because rusqlite doesn't allow unused named params
+ * TODO: Search for unused params via proper parsing, not string search
+ * TODO: Also make sure that the SQLite binding limit of 1000 is respected
+ */
+export declare const prepareBindValues: (values: Bindable, statement: string) => PreparedBindValues;
+//# sourceMappingURL=util.d.ts.map

package/dist/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAA;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAEhD,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;AACnD,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,IAAI,CAAA;AAE1D,MAAM,MAAM,QAAQ,GAAG,aAAa,CAAC,QAAQ,CAAC,GAAG,YAAY,CAAA;AAE7D,eAAO,MAAM,cAAc,qIAA6E,CAAA;AAExG,eAAO,MAAM,kBAAkB,mXAGW,CAAA;AAE1C,MAAM,MAAM,kBAAkB,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,oBAAoB,CAAC,CAAA;AAE9E;;;;;GAKG;AACH,eAAO,MAAM,GAAG,aAAc,oBAAoB,WAAW,OAAO,EAAE,KAAG,MASxE,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,WAAY,QAAQ,aAAa,MAAM,KAAG,kBAWvE,CAAA"}

package/dist/util.js

@@ -0,0 +1,38 @@
+/// <reference lib="es2022" />
+import { Schema } from '@livestore/utils/effect';
+export const SqlValueSchema = Schema.Union(Schema.String, Schema.Number, Schema.Uint8Array, Schema.Null);
+export const PreparedBindValues = Schema.Union(Schema.Array(SqlValueSchema), Schema.Record({ key: Schema.String, value: SqlValueSchema })).pipe(Schema.brand('PreparedBindValues'));
+/**
+ * This is a tag function for tagged literals.
+ * it lets us get syntax highlighting on SQL queries in VSCode, but
+ * doesn't do anything at runtime.
+ * Code copied from: https://esdiscuss.org/topic/string-identity-template-tag
+ */
+export const sql = (template, ...args) => {
+    let str = '';
+    for (const [i, arg] of args.entries()) {
+        str += template[i] + String(arg);
+    }
+    // eslint-disable-next-line unicorn/prefer-at
+    return str + template[template.length - 1];
+};
+/**
+ * Prepare bind values to send to SQLite
+ * Add $ to the beginning of keys; which we use as our interpolation syntax
+ * We also strip out any params that aren't used in the statement,
+ * because rusqlite doesn't allow unused named params
+ * TODO: Search for unused params via proper parsing, not string search
+ * TODO: Also make sure that the SQLite binding limit of 1000 is respected
+ */
+export const prepareBindValues = (values, statement) => {
+    if (Array.isArray(values))
+        return values;
+    const result = {};
+    for (const [key, value] of Object.entries(values)) {
+        if (statement.includes(key)) {
+            result[`$${key}`] = value;
+        }
+    }
+    return result;
+};
+//# sourceMappingURL=util.js.map

package/dist/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAG9B,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAOhD,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;AAExG,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,KAAK,CAC5C,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,EAC5B,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAC7D,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAA;AAI1C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,QAA8B,EAAE,GAAG,IAAe,EAAU,EAAE;IAChF,IAAI,GAAG,GAAG,EAAE,CAAA;IAEZ,KAAK,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;QACtC,GAAG,IAAI,QAAQ,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;IAClC,CAAC;IAED,6CAA6C;IAC7C,OAAO,GAAG,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;AAC5C,CAAC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAgB,EAAE,SAAiB,EAAsB,EAAE;IAC3F,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,MAAmC,CAAA;IAErE,MAAM,MAAM,GAAiB,EAAE,CAAA;IAC/B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC,GAAG,KAAK,CAAA;QAC3B,CAAC;IACH,CAAC;IAED,OAAO,MAA4B,CAAA;AACrC,CAAC,CAAA"}

package/dist/version.d.ts

@@ -0,0 +1,10 @@
+export declare const liveStoreVersion: string;
+/**
+ * This version number is incremented whenever the internal storage format changes in a breaking way.
+ * Whenever this version changes, LiveStore will start with fresh database files. Old database files are not deleted.
+ *
+ * While LiveStore is in alpha, this might happen more frequently.
+ * In the future, LiveStore will provide a migration path for older database files to avoid the impression of data loss.
+ */
+export declare const liveStoreStorageFormatVersion = 2;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,gBAAgB,QAAsB,CAAA;AAEnD;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,IAAI,CAAA"}

package/dist/version.js

@@ -0,0 +1,12 @@
+import packageJson from '../package.json' with { type: 'json' };
+// import packageJson from '../package.json' assert { type: 'json' }
+export const liveStoreVersion = packageJson.version;
+/**
+ * This version number is incremented whenever the internal storage format changes in a breaking way.
+ * Whenever this version changes, LiveStore will start with fresh database files. Old database files are not deleted.
+ *
+ * While LiveStore is in alpha, this might happen more frequently.
+ * In the future, LiveStore will provide a migration path for older database files to avoid the impression of data loss.
+ */
+export const liveStoreStorageFormatVersion = 2;
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,iBAAiB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AAC/D,oEAAoE;AAEpE,MAAM,CAAC,MAAM,gBAAgB,GAAG,WAAW,CAAC,OAAO,CAAA;AAEnD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAA"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@livestore/common",
+  "version": "0.0.0-snapshot-909cdd1ac2fd591945c2be2b0f53e14d87f3c9d4",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./sql-queries": {
+      "types": "./dist/sql-queries/index.d.ts",
+      "default": "./dist/sql-queries/index.js"
+    },
+    "./schema": {
+      "types": "./dist/schema/index.d.ts",
+      "default": "./dist/schema/index.js"
+    },
+    "./sync/next": {
+      "types": "./dist/sync/next/mod.d.ts",
+      "default": "./dist/sync/next/mod.js"
+    },
+    "./sync/next/test": {
+      "types": "./dist/sync/next/test/mod.d.ts",
+      "default": "./dist/sync/next/test/mod.js"
+    }
+  },
+  "types": "./dist/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "schema": [
+        "./dist/schema/index.d.ts"
+      ],
+      "sql-queries": [
+        "./dist/sql-queries/index.d.ts"
+      ],
+      "sync/next": [
+        "./dist/sync/next/mod.d.ts"
+      ],
+      "sync/next/test": [
+        "./dist/sync/next/test/mod.d.ts"
+      ]
+    }
+  },
+  "dependencies": {
+    "@opentelemetry/api": "^1.9.0",
+    "graphology": "0.26.0-alpha1",
+    "graphology-dag": "0.4.1",
+    "graphology-types": "0.24.7",
+    "@livestore/utils": "0.0.0-snapshot-909cdd1ac2fd591945c2be2b0f53e14d87f3c9d4",
+    "@livestore/db-schema": "0.0.0-snapshot-909cdd1ac2fd591945c2be2b0f53e14d87f3c9d4"
+  },
+  "devDependencies": {
+    "vitest": "^2.1.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "test": "vitest"
+  }
+}

package/src/__tests__/fixture.ts

@@ -0,0 +1,23 @@
+import { Schema } from '@livestore/utils/effect'
+
+import { DbSchema } from '../schema/index.js'
+
+export const todos = DbSchema.table(
+  'todos',
+  {
+    id: DbSchema.text({ primaryKey: true }),
+    text: DbSchema.text({ default: '', nullable: false }),
+    completed: DbSchema.boolean({ default: false, nullable: false }),
+  },
+  { deriveMutations: true },
+)
+
+const Config = Schema.Struct({
+  fontSize: Schema.Number,
+  theme: Schema.Literal('light', 'dark'),
+})
+
+export const appConfig = DbSchema.table('app_config', DbSchema.json({ schema: Config, nullable: true }), {
+  isSingleton: true,
+  deriveMutations: true,
+})