@livestore/common 0.4.0-dev.8 → 0.4.0

package/dist/schema/LiveStoreEvent/client.js

@@ -0,0 +1,176 @@
+import { deepEqual, memoizeByRef } from '@livestore/utils';
+import { Option, Schema } from '@livestore/utils/effect';
+import * as EventSequenceNumber from "../EventSequenceNumber/mod.js";
+/** Effect Schema for client events with decoded args. */
+export const Decoded = Schema.Struct({
+    name: Schema.String,
+    args: Schema.Any,
+    seqNum: EventSequenceNumber.Client.Composite,
+    parentSeqNum: EventSequenceNumber.Client.Composite,
+    clientId: Schema.String,
+    sessionId: Schema.String,
+}).annotations({ title: 'LiveStoreEvent.Client.Decoded' });
+/**
+ * Effect Schema for client events with encoded args.
+ * @example
+ * ```ts
+ * // Confirmed event (client=0)
+ * const event: LiveStoreEvent.Client.Encoded = {
+ *   name: 'todoCreated-v1',
+ *   args: { id: 'abc', text: 'Buy milk' },
+ *   seqNum: { global: 5, client: 0, rebaseGeneration: 0 },
+ *   parentSeqNum: { global: 4, client: 0, rebaseGeneration: 0 },
+ *   clientId: 'client-xyz',
+ *   sessionId: 'session-123'
+ * }
+ *
+ * // Pending local event (client=1, not yet synced)
+ * const pending: LiveStoreEvent.Client.Encoded = {
+ *   ...event,
+ *   seqNum: { global: 5, client: 1, rebaseGeneration: 0 },  // e5.1
+ * }
+ * ```
+ */
+export const Encoded = Schema.Struct({
+    name: Schema.String,
+    args: Schema.Any,
+    seqNum: EventSequenceNumber.Client.Composite,
+    parentSeqNum: EventSequenceNumber.Client.Composite,
+    clientId: Schema.String,
+    sessionId: Schema.String,
+}).annotations({ title: 'LiveStoreEvent.Client.Encoded' });
+/**
+ * Internal event representation with metadata for sync processing.
+ * Includes changeset data and materializer hashes for conflict detection and rebasing.
+ *
+ * Note: This class is exported for internal use. The preferred access is via `LiveStoreEvent.Client.EncodedWithMeta`.
+ */
+export class EncodedWithMeta extends Schema.Class('LiveStoreEvent.Client.EncodedWithMeta')({
+    name: Schema.String,
+    args: Schema.Any,
+    seqNum: EventSequenceNumber.Client.Composite,
+    parentSeqNum: EventSequenceNumber.Client.Composite,
+    clientId: Schema.String,
+    sessionId: Schema.String,
+    // TODO get rid of `meta` again by cleaning up the usage implementations
+    meta: Schema.Struct({
+        sessionChangeset: Schema.Union(Schema.TaggedStruct('sessionChangeset', {
+            data: Schema.Uint8Array,
+            debug: Schema.Any.pipe(Schema.optional),
+        }), Schema.TaggedStruct('no-op', {}), Schema.TaggedStruct('unset', {})),
+        syncMetadata: Schema.Option(Schema.JsonValue),
+        /** Used to detect if the materializer is side effecting (during dev) */
+        materializerHashLeader: Schema.Option(Schema.Number),
+        materializerHashSession: Schema.Option(Schema.Number),
+    }).pipe(Schema.mutable, Schema.optional, Schema.withDefaults({
+        constructor: () => ({
+            sessionChangeset: { _tag: 'unset' },
+            syncMetadata: Option.none(),
+            materializerHashLeader: Option.none(),
+            materializerHashSession: Option.none(),
+        }),
+        decoding: () => ({
+            sessionChangeset: { _tag: 'unset' },
+            syncMetadata: Option.none(),
+            materializerHashLeader: Option.none(),
+            materializerHashSession: Option.none(),
+        }),
+    })),
+}) {
+    toJSON = () => {
+        // Only used for logging/debugging
+        // - More readable way to print the seqNum + parentSeqNum
+        // - not including `meta`, `clientId`, `sessionId`
+        return {
+            seqNum: `${EventSequenceNumber.Client.toString(this.seqNum)} → ${EventSequenceNumber.Client.toString(this.parentSeqNum)} (${this.clientId}, ${this.sessionId})`,
+            name: this.name,
+            args: this.args,
+        };
+    };
+    /**
+     * Example: (global event)
+     * For event e2 → e1 which should be rebased on event e3 → e2
+     * the resulting event num will be e4 → e3
+     *
+     * Example: (client event)
+     * For event e2.1 → e2 which should be rebased on event e3 → e2
+     * the resulting event num will be e3.1 → e3
+     *
+     * Syntax: e2.2 → e2.1
+     *          ^ ^    ^ ^
+     *          | |    | +- client parent number
+     *          | |    +--- global parent number
+     *          | +-- client number
+     *          +---- global number
+     * Client num is omitted for global events
+     */
+    rebase = ({ parentSeqNum, isClient, rebaseGeneration, }) => new EncodedWithMeta({
+        ...this,
+        ...EventSequenceNumber.Client.nextPair({ seqNum: parentSeqNum, isClient, rebaseGeneration }),
+    });
+    static fromGlobal = (event, meta) => new EncodedWithMeta({
+        ...event,
+        seqNum: {
+            global: event.seqNum,
+            client: EventSequenceNumber.Client.DEFAULT,
+            rebaseGeneration: EventSequenceNumber.Client.REBASE_GENERATION_DEFAULT,
+        },
+        parentSeqNum: {
+            global: event.parentSeqNum,
+            client: EventSequenceNumber.Client.DEFAULT,
+            rebaseGeneration: EventSequenceNumber.Client.REBASE_GENERATION_DEFAULT,
+        },
+        meta: {
+            sessionChangeset: { _tag: 'unset' },
+            syncMetadata: meta.syncMetadata,
+            materializerHashLeader: meta.materializerHashLeader,
+            materializerHashSession: meta.materializerHashSession,
+        },
+    });
+    toGlobal = () => ({
+        name: this.name,
+        args: this.args,
+        seqNum: this.seqNum.global,
+        parentSeqNum: this.parentSeqNum.global,
+        clientId: this.clientId,
+        sessionId: this.sessionId,
+    });
+}
+/**
+ * Structural equality check for client events. Compares seqNum (global + client),
+ * name, clientId, sessionId, and args. The `meta` field is ignored.
+ *
+ * Args are compared in their JSON-canonical form: locally-encoded events with
+ * `Schema.UndefinedOr` (or loose `Schema.optional`) fields produce
+ * `{ ..., flag: undefined }`, but JSON wire transport drops the key. Without
+ * canonicalizing, the local pending event compares unequal to its
+ * wire-roundtripped counterpart and the sync merge falsely takes the rebase
+ * path, surfacing as `MaterializerHashMismatchError` for state-dependent
+ * materializers.
+ */
+export const isEqualEncoded = (a, b) => a.seqNum.global === b.seqNum.global &&
+    a.seqNum.client === b.seqNum.client &&
+    a.name === b.name &&
+    a.clientId === b.clientId &&
+    a.sessionId === b.sessionId &&
+    deepEqual(canonicalizeArgs(a.args), canonicalizeArgs(b.args)); // TODO use schema equality here
+const canonicalizeArgs = (args) => args === undefined ? args : JSON.parse(JSON.stringify(args));
+/**
+ * Creates an Effect Schema union for all event types in a schema (with composite sequence numbers).
+ * @example
+ * ```ts
+ * const eventSchema = LiveStoreEvent.Client.makeSchema(schema)
+ * const event = Schema.decodeUnknownSync(eventSchema)(rawEvent)
+ * ```
+ */
+export const makeSchema = (schema) => Schema.Union(...[...schema.eventsDefsMap.values()].map((def) => Schema.Struct({
+    name: Schema.Literal(def.name),
+    args: def.schema,
+    seqNum: EventSequenceNumber.Client.Composite,
+    parentSeqNum: EventSequenceNumber.Client.Composite,
+    clientId: Schema.String,
+    sessionId: Schema.String,
+}))).annotations({ title: 'LiveStoreEvent.Client' });
+/** Memoized `makeSchema` - caches the generated schema by reference. */
+export const makeSchemaMemo = memoizeByRef(makeSchema);
+//# sourceMappingURL=client.js.map

package/dist/schema/LiveStoreEvent/client.js.map

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

package/dist/schema/LiveStoreEvent/client.test.d.ts

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

package/dist/schema/LiveStoreEvent/client.test.d.ts.map

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

package/dist/schema/LiveStoreEvent/client.test.js

@@ -0,0 +1,111 @@
+import { expect } from 'vitest';
+import { Option, Schema } from '@livestore/utils/effect';
+import { Vitest } from '@livestore/utils-dev/node-vitest';
+import * as EventSequenceNumber from "../EventSequenceNumber/mod.js";
+import { EncodedWithMeta, isEqualEncoded } from "./client.js";
+Vitest.describe('EncodedWithMeta', () => {
+    Vitest.test('toGlobal() produces numeric seqNums through JSON.stringify', () => {
+        const event = new EncodedWithMeta({
+            name: 'test-v1',
+            args: { id: '1' },
+            seqNum: EventSequenceNumber.Client.Composite.make({ global: 5, client: 0 }),
+            parentSeqNum: EventSequenceNumber.Client.Composite.make({ global: 4, client: 0 }),
+            clientId: 'client-1',
+            sessionId: 'session-1',
+            meta: {
+                sessionChangeset: { _tag: 'unset' },
+                syncMetadata: Option.none(),
+                materializerHashLeader: Option.none(),
+                materializerHashSession: Option.none(),
+            },
+        });
+        const global = event.toGlobal();
+        const parsed = JSON.parse(JSON.stringify(global));
+        expect(parsed.seqNum).toBe(5);
+        expect(parsed.parentSeqNum).toBe(4);
+    });
+});
+Vitest.describe('isEqualEncoded', () => {
+    const makeEncodedEvent = (args) => ({
+        name: 'testEvent-v1',
+        args,
+        seqNum: EventSequenceNumber.Client.Composite.make({ global: 1, client: 0 }),
+        parentSeqNum: EventSequenceNumber.Client.Composite.make(EventSequenceNumber.Client.ROOT),
+        clientId: 'client-1',
+        sessionId: 'session-1',
+    });
+    Vitest.it('should consider events with identical args as equal', () => {
+        const a = makeEncodedEvent({ id: 'abc', text: 'hello' });
+        const b = makeEncodedEvent({ id: 'abc', text: 'hello' });
+        expect(isEqualEncoded(a, b)).toBe(true);
+    });
+    Vitest.it('should consider events with different key order in args as equal', () => {
+        const a = makeEncodedEvent({ b: 2, a: 1 });
+        const b = makeEncodedEvent({ a: 1, b: 2 });
+        expect(isEqualEncoded(a, b)).toBe(true);
+    });
+    Vitest.it('should consider events with different key order in nested args as equal', () => {
+        const a = makeEncodedEvent({ outer: { b: 2, a: 1 }, x: 'y' });
+        const b = makeEncodedEvent({ x: 'y', outer: { a: 1, b: 2 } });
+        expect(isEqualEncoded(a, b)).toBe(true);
+    });
+    Vitest.it('should consider events with different args values as not equal', () => {
+        const a = makeEncodedEvent({ id: 'abc' });
+        const b = makeEncodedEvent({ id: 'def' });
+        expect(isEqualEncoded(a, b)).toBe(false);
+    });
+    Vitest.it('should consider events with different args keys as not equal', () => {
+        const a = makeEncodedEvent({ a: 1 });
+        const b = makeEncodedEvent({ b: 1 });
+        expect(isEqualEncoded(a, b)).toBe(false);
+    });
+    Vitest.it('should handle null args', () => {
+        const a = makeEncodedEvent(null);
+        const b = makeEncodedEvent(null);
+        expect(isEqualEncoded(a, b)).toBe(true);
+    });
+    Vitest.it('should handle array args', () => {
+        const a = makeEncodedEvent([1, 2, 3]);
+        const b = makeEncodedEvent([1, 2, 3]);
+        expect(isEqualEncoded(a, b)).toBe(true);
+    });
+    Vitest.it('should handle empty object args', () => {
+        const a = makeEncodedEvent({});
+        const b = makeEncodedEvent({});
+        expect(isEqualEncoded(a, b)).toBe(true);
+    });
+    Vitest.it('should consider events with different names as not equal', () => {
+        const a = { ...makeEncodedEvent({ id: 'abc' }), name: 'eventA' };
+        const b = { ...makeEncodedEvent({ id: 'abc' }), name: 'eventB' };
+        expect(isEqualEncoded(a, b)).toBe(false);
+    });
+    Vitest.it('should consider events with undefined-valued and missing keys as equal', () => {
+        const a = makeEncodedEvent({ id: 'abc', flag: undefined });
+        const b = makeEncodedEvent({ id: 'abc' });
+        expect(isEqualEncoded(a, b)).toBe(true);
+    });
+    Vitest.it('should consider events with nested undefined-valued and missing keys as equal', () => {
+        const a = makeEncodedEvent({ outer: { x: 1, y: undefined } });
+        const b = makeEncodedEvent({ outer: { x: 1 } });
+        expect(isEqualEncoded(a, b)).toBe(true);
+    });
+    Vitest.it('should consider Effect Schema UndefinedOr-encoded args equal to their JSON-roundtripped form', () => {
+        const argsSchema = Schema.Struct({
+            id: Schema.String,
+            flag: Schema.UndefinedOr(Schema.Boolean),
+        });
+        const localArgs = Schema.encodeUnknownSync(argsSchema)({ id: 'abc' });
+        const wireArgs = JSON.parse(JSON.stringify(localArgs));
+        expect(isEqualEncoded(makeEncodedEvent(localArgs), makeEncodedEvent(wireArgs))).toBe(true);
+    });
+    Vitest.it('should consider Effect Schema loose-optional encoded args equal to their JSON-roundtripped form', () => {
+        const argsSchema = Schema.Struct({
+            id: Schema.String,
+            label: Schema.optional(Schema.String),
+        });
+        const localArgs = Schema.encodeUnknownSync(argsSchema)({ id: 'abc', label: undefined });
+        const wireArgs = JSON.parse(JSON.stringify(localArgs));
+        expect(isEqualEncoded(makeEncodedEvent(localArgs), makeEncodedEvent(wireArgs))).toBe(true);
+    });
+});
+//# sourceMappingURL=client.test.js.map

package/dist/schema/LiveStoreEvent/client.test.js.map

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

package/dist/schema/LiveStoreEvent/for-event-def.d.ts

@@ -0,0 +1,52 @@
+import type { Schema } from '@livestore/utils/effect';
+import type { EventDef, EventDefRecord } from '../EventDef/mod.ts';
+import type * as EventSequenceNumber from '../EventSequenceNumber/mod.ts';
+/** Event without sequence numbers, with decoded (native TypeScript) args. Used as input to `store.commit()`. */
+export type InputDecoded<TEventDef extends EventDef.Any> = {
+    name: TEventDef['name'];
+    args: Schema.Schema.Type<TEventDef['schema']>;
+};
+/** Event without sequence numbers, with encoded (serialized) args. Used as input to `store.commit()`. */
+export type InputEncoded<TEventDef extends EventDef.Any> = {
+    name: TEventDef['name'];
+    args: Schema.Schema.Encoded<TEventDef['schema']>;
+};
+/** Full event with composite sequence numbers and decoded args. Includes clientId/sessionId for sync. */
+export type Decoded<TEventDef extends EventDef.Any> = {
+    name: TEventDef['name'];
+    args: Schema.Schema.Type<TEventDef['schema']>;
+    seqNum: EventSequenceNumber.Client.Composite;
+    parentSeqNum: EventSequenceNumber.Client.Composite;
+    clientId: string;
+    sessionId: string;
+};
+/** Full event with composite sequence numbers and encoded args. Includes clientId/sessionId for sync. */
+export type Encoded<TEventDef extends EventDef.Any> = {
+    name: TEventDef['name'];
+    args: Schema.Schema.Encoded<TEventDef['schema']>;
+    seqNum: EventSequenceNumber.Client.Composite;
+    parentSeqNum: EventSequenceNumber.Client.Composite;
+    clientId: string;
+    sessionId: string;
+};
+/** Effect Schema union of all event types in an EventDefRecord (with composite sequence numbers). */
+export type ForRecord<TEventDefRecord extends EventDefRecord> = Schema.Schema<{
+    [K in keyof TEventDefRecord]: {
+        name: K;
+        args: Schema.Schema.Type<TEventDefRecord[K]['schema']>;
+        seqNum: EventSequenceNumber.Client.Composite;
+        parentSeqNum: EventSequenceNumber.Client.Composite;
+        clientId: string;
+        sessionId: string;
+    };
+}[keyof TEventDefRecord], {
+    [K in keyof TEventDefRecord]: {
+        name: K;
+        args: Schema.Schema.Encoded<TEventDefRecord[K]['schema']>;
+        seqNum: EventSequenceNumber.Client.Composite;
+        parentSeqNum: EventSequenceNumber.Client.Composite;
+        clientId: string;
+        sessionId: string;
+    };
+}[keyof TEventDefRecord]>;
+//# sourceMappingURL=for-event-def.d.ts.map

package/dist/schema/LiveStoreEvent/for-event-def.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"for-event-def.d.ts","sourceRoot":"","sources":["../../../src/schema/LiveStoreEvent/for-event-def.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAErD,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAClE,OAAO,KAAK,KAAK,mBAAmB,MAAM,+BAA+B,CAAA;AAEzE,gHAAgH;AAChH,MAAM,MAAM,YAAY,CAAC,SAAS,SAAS,QAAQ,CAAC,GAAG,IAAI;IACzD,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,CAAA;IACvB,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAA;CAC9C,CAAA;AAED,yGAAyG;AACzG,MAAM,MAAM,YAAY,CAAC,SAAS,SAAS,QAAQ,CAAC,GAAG,IAAI;IACzD,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,CAAA;IACvB,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAA;CACjD,CAAA;AAED,yGAAyG;AACzG,MAAM,MAAM,OAAO,CAAC,SAAS,SAAS,QAAQ,CAAC,GAAG,IAAI;IACpD,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,CAAA;IACvB,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAA;IAC7C,MAAM,EAAE,mBAAmB,CAAC,MAAM,CAAC,SAAS,CAAA;IAC5C,YAAY,EAAE,mBAAmB,CAAC,MAAM,CAAC,SAAS,CAAA;IAClD,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,yGAAyG;AACzG,MAAM,MAAM,OAAO,CAAC,SAAS,SAAS,QAAQ,CAAC,GAAG,IAAI;IACpD,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,CAAA;IACvB,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAA;IAChD,MAAM,EAAE,mBAAmB,CAAC,MAAM,CAAC,SAAS,CAAA;IAC5C,YAAY,EAAE,mBAAmB,CAAC,MAAM,CAAC,SAAS,CAAA;IAClD,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,qGAAqG;AACrG,MAAM,MAAM,SAAS,CAAC,eAAe,SAAS,cAAc,IAAI,MAAM,CAAC,MAAM,CAC3E;KACG,CAAC,IAAI,MAAM,eAAe,GAAG;QAC5B,IAAI,EAAE,CAAC,CAAA;QACP,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;QACtD,MAAM,EAAE,mBAAmB,CAAC,MAAM,CAAC,SAAS,CAAA;QAC5C,YAAY,EAAE,mBAAmB,CAAC,MAAM,CAAC,SAAS,CAAA;QAClD,QAAQ,EAAE,MAAM,CAAA;QAChB,SAAS,EAAE,MAAM,CAAA;KAClB;CACF,CAAC,MAAM,eAAe,CAAC,EACxB;KACG,CAAC,IAAI,MAAM,eAAe,GAAG;QAC5B,IAAI,EAAE,CAAC,CAAA;QACP,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;QACzD,MAAM,EAAE,mBAAmB,CAAC,MAAM,CAAC,SAAS,CAAA;QAC5C,YAAY,EAAE,mBAAmB,CAAC,MAAM,CAAC,SAAS,CAAA;QAClD,QAAQ,EAAE,MAAM,CAAA;QAChB,SAAS,EAAE,MAAM,CAAA;KAClB;CACF,CAAC,MAAM,eAAe,CAAC,CACzB,CAAA"}

package/dist/schema/LiveStoreEvent/for-event-def.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=for-event-def.js.map

package/dist/schema/LiveStoreEvent/for-event-def.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"for-event-def.js","sourceRoot":"","sources":["../../../src/schema/LiveStoreEvent/for-event-def.ts"],"names":[],"mappings":""}

package/dist/schema/LiveStoreEvent/global.d.ts

@@ -0,0 +1,36 @@
+import { Schema } from '@livestore/utils/effect';
+import * as EventSequenceNumber from '../EventSequenceNumber/mod.ts';
+/**
+ * Effect Schema for global events with integer sequence numbers.
+ * @example
+ * ```ts
+ * const event: LiveStoreEvent.Global.Encoded = {
+ *   name: 'todoCreated-v1',
+ *   args: { id: 'abc', text: 'Buy milk' },
+ *   seqNum: 5,       // This event's position in the global log
+ *   parentSeqNum: 4, // Points to the previous event
+ *   clientId: 'client-xyz',
+ *   sessionId: 'session-123'
+ * }
+ * ```
+ */
+export declare const Encoded: 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;
+}>;
+/** Event with integer sequence numbers for sync backend wire format. */
+export type Encoded = typeof Encoded.Type;
+/** Converts a Global event to Client format by expanding integer seqNums to composite form. */
+export declare const toClientEncoded: (event: Encoded) => {
+    name: string;
+    args: any;
+    seqNum: EventSequenceNumber.Client.Composite;
+    parentSeqNum: EventSequenceNumber.Client.Composite;
+    clientId: string;
+    sessionId: string;
+};
+//# sourceMappingURL=global.d.ts.map

package/dist/schema/LiveStoreEvent/global.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global.d.ts","sourceRoot":"","sources":["../../../src/schema/LiveStoreEvent/global.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAEhD,OAAO,KAAK,mBAAmB,MAAM,+BAA+B,CAAA;AAEpE;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,OAAO;;;;;;;EAOsC,CAAA;AAE1D,wEAAwE;AACxE,MAAM,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,IAAI,CAAA;AAEzC,+FAA+F;AAC/F,eAAO,MAAM,eAAe,GAC1B,OAAO,OAAO,KACb;IACD,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,GAAG,CAAA;IACT,MAAM,EAAE,mBAAmB,CAAC,MAAM,CAAC,SAAS,CAAA;IAC5C,YAAY,EAAE,mBAAmB,CAAC,MAAM,CAAC,SAAS,CAAA;IAClD,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;CAKjB,CAAA"}

package/dist/schema/LiveStoreEvent/global.js

@@ -0,0 +1,31 @@
+import { Schema } from '@livestore/utils/effect';
+import * as EventSequenceNumber from "../EventSequenceNumber/mod.js";
+/**
+ * Effect Schema for global events with integer sequence numbers.
+ * @example
+ * ```ts
+ * const event: LiveStoreEvent.Global.Encoded = {
+ *   name: 'todoCreated-v1',
+ *   args: { id: 'abc', text: 'Buy milk' },
+ *   seqNum: 5,       // This event's position in the global log
+ *   parentSeqNum: 4, // Points to the previous event
+ *   clientId: 'client-xyz',
+ *   sessionId: 'session-123'
+ * }
+ * ```
+ */
+export const Encoded = Schema.Struct({
+    name: Schema.String,
+    args: Schema.Any,
+    seqNum: EventSequenceNumber.Global.Schema,
+    parentSeqNum: EventSequenceNumber.Global.Schema,
+    clientId: Schema.String,
+    sessionId: Schema.String,
+}).annotations({ title: 'LiveStoreEvent.Global.Encoded' });
+/** Converts a Global event to Client format by expanding integer seqNums to composite form. */
+export const toClientEncoded = (event) => ({
+    ...event,
+    seqNum: EventSequenceNumber.Client.fromGlobal(event.seqNum),
+    parentSeqNum: EventSequenceNumber.Client.fromGlobal(event.parentSeqNum),
+});
+//# sourceMappingURL=global.js.map

package/dist/schema/LiveStoreEvent/global.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global.js","sourceRoot":"","sources":["../../../src/schema/LiveStoreEvent/global.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAEhD,OAAO,KAAK,mBAAmB,MAAM,+BAA+B,CAAA;AAEpE;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC;IACnC,IAAI,EAAE,MAAM,CAAC,MAAM;IACnB,IAAI,EAAE,MAAM,CAAC,GAAG;IAChB,MAAM,EAAE,mBAAmB,CAAC,MAAM,CAAC,MAAM;IACzC,YAAY,EAAE,mBAAmB,CAAC,MAAM,CAAC,MAAM;IAC/C,QAAQ,EAAE,MAAM,CAAC,MAAM;IACvB,SAAS,EAAE,MAAM,CAAC,MAAM;CACzB,CAAC,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,+BAA+B,EAAE,CAAC,CAAA;AAK1D,+FAA+F;AAC/F,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,KAAc,EAQd,EAAE,CAAC,CAAC;IACJ,GAAG,KAAK;IACR,MAAM,EAAE,mBAAmB,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3D,YAAY,EAAE,mBAAmB,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC;CACxE,CAAC,CAAA"}

package/dist/schema/LiveStoreEvent/input.d.ts

@@ -0,0 +1,46 @@
+import { Schema } from '@livestore/utils/effect';
+import type { EventDef, EventDefRecord } from '../EventDef/mod.ts';
+import type { LiveStoreSchema } from '../schema.ts';
+import type * as ForEventDef from './for-event-def.ts';
+/**
+ * Effect Schema for validating/decoding input events with encoded args.
+ * @example
+ * ```ts
+ * import { Schema } from '@effect/schema'
+ * const decoded = Schema.decodeUnknownSync(LiveStoreEvent.Input.Encoded)(rawEvent)
+ * ```
+ */
+export declare const Encoded: Schema.Struct<{
+    name: typeof Schema.String;
+    args: typeof Schema.Any;
+}>;
+/** Event without sequence numbers, with decoded (native TypeScript) args. */
+export type Decoded = ForEventDef.InputDecoded<EventDef.Any>;
+/** Event without sequence numbers, with encoded (serialized) args. */
+export type Encoded = ForEventDef.InputEncoded<EventDef.Any>;
+/** Union of all input event types for a given schema (type-safe event discrimination). */
+export type ForSchema<TSchema extends LiveStoreSchema> = {
+    [K in keyof TSchema['_EventDefMapType']]: ForEventDef.InputDecoded<TSchema['_EventDefMapType'][K]>;
+}[keyof TSchema['_EventDefMapType']];
+/** Effect Schema union of all event types in an EventDefRecord (input format, no sequence numbers). */
+export type ForRecord<TEventDefRecord extends EventDefRecord> = Schema.Schema<{
+    [K in keyof TEventDefRecord]: {
+        name: K;
+        args: Schema.Schema.Type<TEventDefRecord[K]['schema']>;
+    };
+}[keyof TEventDefRecord], {
+    [K in keyof TEventDefRecord]: {
+        name: K;
+        args: Schema.Schema.Encoded<TEventDefRecord[K]['schema']>;
+    };
+}[keyof TEventDefRecord]>;
+/**
+ * Creates an Effect Schema union for all event types in a schema (input format, no sequence numbers).
+ * @example
+ * ```ts
+ * const inputSchema = LiveStoreEvent.Input.makeSchema(schema)
+ * const event = Schema.decodeUnknownSync(inputSchema)(rawEvent)
+ * ```
+ */
+export declare const makeSchema: <TSchema extends LiveStoreSchema>(schema: TSchema) => ForRecord<TSchema["_EventDefMapType"]>;
+//# sourceMappingURL=input.d.ts.map

package/dist/schema/LiveStoreEvent/input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../../src/schema/LiveStoreEvent/input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAEhD,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AACnD,OAAO,KAAK,KAAK,WAAW,MAAM,oBAAoB,CAAA;AAEtD;;;;;;;GAOG;AACH,eAAO,MAAM,OAAO;;;EAGqC,CAAA;AAEzD,6EAA6E;AAC7E,MAAM,MAAM,OAAO,GAAG,WAAW,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;AAE5D,sEAAsE;AACtE,MAAM,MAAM,OAAO,GAAG,WAAW,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;AAE5D,0FAA0F;AAC1F,MAAM,MAAM,SAAS,CAAC,OAAO,SAAS,eAAe,IAAI;KACtD,CAAC,IAAI,MAAM,OAAO,CAAC,kBAAkB,CAAC,GAAG,WAAW,CAAC,YAAY,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;CACnG,CAAC,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAA;AAEpC,uGAAuG;AACvG,MAAM,MAAM,SAAS,CAAC,eAAe,SAAS,cAAc,IAAI,MAAM,CAAC,MAAM,CAC3E;KACG,CAAC,IAAI,MAAM,eAAe,GAAG;QAC5B,IAAI,EAAE,CAAC,CAAA;QACP,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;KACvD;CACF,CAAC,MAAM,eAAe,CAAC,EACxB;KACG,CAAC,IAAI,MAAM,eAAe,GAAG;QAC5B,IAAI,EAAE,CAAC,CAAA;QACP,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;KAC1D;CACF,CAAC,MAAM,eAAe,CAAC,CACzB,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,GAAI,OAAO,SAAS,eAAe,EAAE,QAAQ,OAAO,KAAG,SAAS,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAQ1D,CAAA"}

package/dist/schema/LiveStoreEvent/input.js

@@ -0,0 +1,26 @@
+import { Schema } from '@livestore/utils/effect';
+/**
+ * Effect Schema for validating/decoding input events with encoded args.
+ * @example
+ * ```ts
+ * import { Schema } from '@effect/schema'
+ * const decoded = Schema.decodeUnknownSync(LiveStoreEvent.Input.Encoded)(rawEvent)
+ * ```
+ */
+export const Encoded = Schema.Struct({
+    name: Schema.String,
+    args: Schema.Any,
+}).annotations({ title: 'LiveStoreEvent.Input.Encoded' });
+/**
+ * Creates an Effect Schema union for all event types in a schema (input format, no sequence numbers).
+ * @example
+ * ```ts
+ * const inputSchema = LiveStoreEvent.Input.makeSchema(schema)
+ * const event = Schema.decodeUnknownSync(inputSchema)(rawEvent)
+ * ```
+ */
+export const makeSchema = (schema) => Schema.Union(...[...schema.eventsDefsMap.values()].map((def) => Schema.Struct({
+    name: Schema.Literal(def.name),
+    args: def.schema,
+}))).annotations({ title: 'LiveStoreEvent.Input' });
+//# sourceMappingURL=input.js.map

package/dist/schema/LiveStoreEvent/input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.js","sourceRoot":"","sources":["../../../src/schema/LiveStoreEvent/input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAMhD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC;IACnC,IAAI,EAAE,MAAM,CAAC,MAAM;IACnB,IAAI,EAAE,MAAM,CAAC,GAAG;CACjB,CAAC,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,8BAA8B,EAAE,CAAC,CAAA;AA6BzD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAkC,MAAe,EAA0C,EAAE,CACrH,MAAM,CAAC,KAAK,CACV,GAAG,CAAC,GAAG,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAChD,MAAM,CAAC,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;IAC9B,IAAI,EAAE,GAAG,CAAC,MAAM;CACjB,CAAC,CACH,CACF,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,sBAAsB,EAAE,CAAQ,CAAA"}

package/dist/schema/LiveStoreEvent/mod.d.ts

@@ -0,0 +1,5 @@
+export * as Client from './client.ts';
+export * as ForEventDef from './for-event-def.ts';
+export * as Global from './global.ts';
+export * as Input from './input.ts';
+//# sourceMappingURL=mod.d.ts.map

package/dist/schema/LiveStoreEvent/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/schema/LiveStoreEvent/mod.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,WAAW,MAAM,oBAAoB,CAAA;AACjD,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA"}

package/dist/schema/LiveStoreEvent/mod.js

@@ -0,0 +1,5 @@
+export * as Client from "./client.js";
+export * as ForEventDef from "./for-event-def.js";
+export * as Global from "./global.js";
+export * as Input from "./input.js";
+//# sourceMappingURL=mod.js.map

package/dist/schema/LiveStoreEvent/mod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../../src/schema/LiveStoreEvent/mod.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,WAAW,MAAM,oBAAoB,CAAA;AACjD,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA"}

package/dist/schema/events.d.ts

@@ -1,2 +1,2 @@
-export { clientOnly, defineEvent, synced } from './EventDef.ts';
+export { clientOnly, defineEvent, synced } from './EventDef/mod.ts';
 //# sourceMappingURL=events.d.ts.map

package/dist/schema/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/schema/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/schema/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/schema/events.js

@@ -1,2 +1,2 @@
-export { clientOnly, defineEvent, synced } from "./EventDef.js";
+export { clientOnly, defineEvent, synced } from "./EventDef/mod.js";
 //# sourceMappingURL=events.js.map

package/dist/schema/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/schema/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA"}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/schema/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/schema/mod.d.ts

@@ -1,10 +1,12 @@
-export * from './EventDef.ts';
-export * as EventSequenceNumber from './EventSequenceNumber.ts';
+export * from './EventDef/mod.ts';
+export * as EventSequenceNumber from './EventSequenceNumber/mod.ts';
 export * as Events from './events.ts';
-export * as LiveStoreEvent from './LiveStoreEvent.ts';
+export * as LiveStoreEvent from './LiveStoreEvent/mod.ts';
 export * from './schema.ts';
 export * as State from './state/mod.ts';
 export { SqliteAst, SqliteDsl } from './state/sqlite/db-schema/mod.ts';
 export * from './state/sqlite/schema-helpers.ts';
-export * as SystemTables from './state/sqlite/system-tables.ts';
+export * as SystemTables from './state/sqlite/system-tables/mod.ts';
+export type { UnknownEvents } from './unknown-events.ts';
+export { normalizeUnknownEventHandling, resolveEventDef } from './unknown-events.ts';
 //# sourceMappingURL=mod.d.ts.map

package/dist/schema/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/schema/mod.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,OAAO,KAAK,mBAAmB,MAAM,0BAA0B,CAAA;AAC/D,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AACrD,cAAc,aAAa,CAAA;AAC3B,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AACvC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAA;AACtE,cAAc,kCAAkC,CAAA;AAChD,OAAO,KAAK,YAAY,MAAM,iCAAiC,CAAA"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/schema/mod.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,OAAO,KAAK,mBAAmB,MAAM,8BAA8B,CAAA;AACnE,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,cAAc,MAAM,yBAAyB,CAAA;AACzD,cAAc,aAAa,CAAA;AAC3B,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AACvC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAA;AACtE,cAAc,kCAAkC,CAAA;AAChD,OAAO,KAAK,YAAY,MAAM,qCAAqC,CAAA;AACnE,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,EAAE,6BAA6B,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/schema/mod.js

@@ -1,10 +1,11 @@
-export * from "./EventDef.js";
-export * as EventSequenceNumber from "./EventSequenceNumber.js";
+export * from "./EventDef/mod.js";
+export * as EventSequenceNumber from "./EventSequenceNumber/mod.js";
 export * as Events from "./events.js";
-export * as LiveStoreEvent from "./LiveStoreEvent.js";
+export * as LiveStoreEvent from "./LiveStoreEvent/mod.js";
 export * from "./schema.js";
 export * as State from "./state/mod.js";
 export { SqliteAst, SqliteDsl } from "./state/sqlite/db-schema/mod.js";
 export * from "./state/sqlite/schema-helpers.js";
-export * as SystemTables from "./state/sqlite/system-tables.js";
+export * as SystemTables from "./state/sqlite/system-tables/mod.js";
+export { normalizeUnknownEventHandling, resolveEventDef } from "./unknown-events.js";
 //# sourceMappingURL=mod.js.map