@livestore/common 0.4.0-dev.9 → 0.5.0-dev.0

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

@@ -0,0 +1,168 @@
+import { Option, Schema } from '@livestore/utils/effect';
+import type { EventDef } from '../EventDef/mod.ts';
+import * as EventSequenceNumber from '../EventSequenceNumber/mod.ts';
+import type { LiveStoreSchema } from '../schema.ts';
+import type * as ForEventDef from './for-event-def.ts';
+import type * as Global from './global.ts';
+/** Effect Schema for client events with decoded args. */
+export declare const Decoded: Schema.Struct<{
+    readonly name: Schema.String;
+    readonly args: Schema.Any;
+    readonly seqNum: Schema.Struct<{
+        readonly global: Schema.brand<Schema.Int, "GlobalEventSequenceNumber">;
+        readonly client: Schema.brand<Schema.Int, "ClientEventSequenceNumber">;
+        readonly rebaseGeneration: Schema.Int;
+    }> & {
+        make: (seqNum: EventSequenceNumber.Client.CompositeInput) => EventSequenceNumber.Client.Composite;
+    };
+    readonly parentSeqNum: Schema.Struct<{
+        readonly global: Schema.brand<Schema.Int, "GlobalEventSequenceNumber">;
+        readonly client: Schema.brand<Schema.Int, "ClientEventSequenceNumber">;
+        readonly rebaseGeneration: Schema.Int;
+    }> & {
+        make: (seqNum: EventSequenceNumber.Client.CompositeInput) => EventSequenceNumber.Client.Composite;
+    };
+    readonly clientId: Schema.String;
+    readonly sessionId: Schema.String;
+}>;
+/**
+ * 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 declare const Encoded: Schema.Struct<{
+    readonly name: Schema.String;
+    readonly args: Schema.Any;
+    readonly seqNum: Schema.Struct<{
+        readonly global: Schema.brand<Schema.Int, "GlobalEventSequenceNumber">;
+        readonly client: Schema.brand<Schema.Int, "ClientEventSequenceNumber">;
+        readonly rebaseGeneration: Schema.Int;
+    }> & {
+        make: (seqNum: EventSequenceNumber.Client.CompositeInput) => EventSequenceNumber.Client.Composite;
+    };
+    readonly parentSeqNum: Schema.Struct<{
+        readonly global: Schema.brand<Schema.Int, "GlobalEventSequenceNumber">;
+        readonly client: Schema.brand<Schema.Int, "ClientEventSequenceNumber">;
+        readonly rebaseGeneration: Schema.Int;
+    }> & {
+        make: (seqNum: EventSequenceNumber.Client.CompositeInput) => EventSequenceNumber.Client.Composite;
+    };
+    readonly clientId: Schema.String;
+    readonly sessionId: Schema.String;
+}>;
+/** Event with composite sequence numbers and decoded (native TypeScript) args. */
+export type Decoded = ForEventDef.Decoded<EventDef.Any>;
+/** Event with composite sequence numbers and encoded (serialized) args. */
+export type Encoded = ForEventDef.Encoded<EventDef.Any>;
+/** Union of all client event types for a given schema (type-safe event discrimination). */
+export type ForSchema<TSchema extends LiveStoreSchema> = {
+    [K in keyof TSchema['_EventDefMapType']]: ForEventDef.Decoded<TSchema['_EventDefMapType'][K]>;
+}[keyof TSchema['_EventDefMapType']];
+declare const EncodedWithMeta_base: Schema.Class<EncodedWithMeta, Schema.Struct<{
+    readonly name: Schema.String;
+    readonly args: Schema.Any;
+    readonly seqNum: Schema.Struct<{
+        readonly global: Schema.brand<Schema.Int, "GlobalEventSequenceNumber">;
+        readonly client: Schema.brand<Schema.Int, "ClientEventSequenceNumber">;
+        readonly rebaseGeneration: Schema.Int;
+    }> & {
+        make: (seqNum: EventSequenceNumber.Client.CompositeInput) => EventSequenceNumber.Client.Composite;
+    };
+    readonly parentSeqNum: Schema.Struct<{
+        readonly global: Schema.brand<Schema.Int, "GlobalEventSequenceNumber">;
+        readonly client: Schema.brand<Schema.Int, "ClientEventSequenceNumber">;
+        readonly rebaseGeneration: Schema.Int;
+    }> & {
+        make: (seqNum: EventSequenceNumber.Client.CompositeInput) => EventSequenceNumber.Client.Composite;
+    };
+    readonly clientId: Schema.String;
+    readonly sessionId: Schema.String;
+    readonly meta: Schema.withConstructorDefault<Schema.withDecodingDefaultType<Schema.Struct<{
+        readonly sessionChangeset: Schema.mutableKey<Schema.Union<readonly [Schema.TaggedStruct<"sessionChangeset", {
+            readonly data: Schema.Codec<Uint8Array<ArrayBuffer>>;
+            readonly debug: Schema.optional<Schema.Any>;
+        }>, Schema.TaggedStruct<"no-op", {}>, Schema.TaggedStruct<"unset", {}>]>>;
+        readonly syncMetadata: Schema.mutableKey<Schema.Option<Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+        readonly materializerHashLeader: Schema.mutableKey<Schema.Option<Schema.Finite>>;
+        readonly materializerHashSession: Schema.mutableKey<Schema.Option<Schema.Finite>>;
+    }>, never>>;
+}>, {}>;
+/**
+ * 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 declare class EncodedWithMeta extends EncodedWithMeta_base {
+    toJSON: () => any;
+    /**
+     * 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, isClientOnly, rebaseGeneration, }: {
+        parentSeqNum: EventSequenceNumber.Client.Composite;
+        isClientOnly: boolean;
+        rebaseGeneration: number;
+    }) => EncodedWithMeta;
+    static fromGlobal: (event: Global.Encoded, meta: {
+        syncMetadata: Option.Option<Schema.Json>;
+        materializerHashLeader: Option.Option<number>;
+        materializerHashSession: Option.Option<number>;
+    }) => EncodedWithMeta;
+    toGlobal: () => Global.Encoded;
+}
+/**
+ * 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 declare const isEqualEncoded: (a: Encoded, b: Encoded) => boolean;
+/**
+ * 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 declare const makeSchema: <TSchema extends LiveStoreSchema>(schema: TSchema) => ForEventDef.ForRecord<TSchema["_EventDefMapType"]>;
+/** Memoized `makeSchema` - caches the generated schema by reference. */
+export declare const makeSchemaMemo: <TSchema extends LiveStoreSchema>(schema: TSchema) => ForEventDef.ForRecord<TSchema["_EventDefMapType"]>;
+export {};
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/schema/LiveStoreEvent/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAU,MAAM,EAAE,MAAM,EAAU,MAAM,yBAAyB,CAAA;AAExE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,KAAK,mBAAmB,MAAM,+BAA+B,CAAA;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AACnD,OAAO,KAAK,KAAK,WAAW,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,KAAK,MAAM,MAAM,aAAa,CAAA;AAE1C,yDAAyD;AACzD,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;EAOmC,CAAA;AAEvD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;EAOmC,CAAA;AAEvD,kFAAkF;AAClF,MAAM,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;AAEvD,2EAA2E;AAC3E,MAAM,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;AAEvD,2FAA2F;AAC3F,MAAM,MAAM,SAAS,CAAC,OAAO,SAAS,eAAe,IAAI;KACtD,CAAC,IAAI,MAAM,OAAO,CAAC,kBAAkB,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;CAC9F,CAAC,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAA;;;;;;;;;;;;;;;;;;;;;;2BAmBM,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;;;;;;;;AAjB/E;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,oBAyCnC;IACA,MAAM,QAAO,GAAG,CASf;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,GAAI,mDAIP;QACD,YAAY,EAAE,mBAAmB,CAAC,MAAM,CAAC,SAAS,CAAA;QAClD,YAAY,EAAE,OAAO,CAAA;QACrB,gBAAgB,EAAE,MAAM,CAAA;KACzB,qBAIG;IAEJ,MAAM,CAAC,UAAU,GACf,OAAO,MAAM,CAAC,OAAO,EACrB,MAAM;QACJ,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QACxC,sBAAsB,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QAC7C,uBAAuB,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;KAC/C,qBAoBC;IAEJ,QAAQ,QAAO,MAAM,CAAC,OAAO,CAO3B;CACH;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,cAAc,GAAI,GAAG,OAAO,EAAE,GAAG,OAAO,YAMU,CAAA;AAI/D;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,GAAI,OAAO,SAAS,eAAe,EACxD,QAAQ,OAAO,KACd,WAAW,CAAC,SAAS,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAYG,CAAA;AAEvD,wEAAwE;AACxE,eAAO,MAAM,cAAc,GAjBA,OAAO,SAAS,eAAe,UAChD,OAAO,KACd,WAAW,CAAC,SAAS,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAeE,CAAA"}

package/dist/schema/LiveStoreEvent/client.js

@@ -0,0 +1,179 @@
+import { deepEqual, memoizeByRef } from '@livestore/utils';
+import { Effect, Option, Schema, Struct } 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,
+}).annotate({ 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,
+}).annotate({ 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.Json),
+        /** Used to detect if the materializer is side effecting (during dev) */
+        materializerHashLeader: Schema.Option(Schema.Finite),
+        materializerHashSession: Schema.Option(Schema.Finite),
+    })
+        .mapFields(Struct.map(Schema.mutableKey))
+        .pipe(Schema.withDecodingDefaultType(Effect.succeed({
+        sessionChangeset: { _tag: 'unset' },
+        syncMetadata: Option.none(),
+        materializerHashLeader: Option.none(),
+        materializerHashSession: Option.none(),
+    })), Schema.withConstructorDefault(Effect.succeed({
+        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, isClientOnly, rebaseGeneration, }) => new EncodedWithMeta({
+        ...this,
+        ...EventSequenceNumber.Client.nextPair({ seqNum: parentSeqNum, isClientOnly, 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,
+}))).annotate({ 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,120 @@
+import { expect } from 'vitest';
+import { Vitest } from '@livestore/utils-dev/node-vitest';
+import { Option, Schema } from '@livestore/utils/effect';
+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 with explicit undefined 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', flag: undefined });
+        const wireArgs = JSON.parse(JSON.stringify(localArgs));
+        expect(isEqualEncoded(makeEncodedEvent(localArgs), makeEncodedEvent(wireArgs))).toBe(true);
+    });
+    Vitest.it('should consider Effect Schema optionalKey-encoded args equal to their JSON-roundtripped form', () => {
+        const argsSchema = Schema.Struct({
+            id: Schema.String,
+            label: Schema.optionalKey(Schema.String),
+        });
+        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: TEventDef['schema']['Type'];
+};
+/** 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: TEventDef['schema']['Encoded'];
+};
+/** 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: TEventDef['schema']['Type'];
+    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: TEventDef['schema']['Encoded'];
+    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.Codec<{
+    [K in keyof TEventDefRecord]: {
+        name: K;
+        args: TEventDefRecord[K]['schema']['Type'];
+        seqNum: EventSequenceNumber.Client.Composite;
+        parentSeqNum: EventSequenceNumber.Client.Composite;
+        clientId: string;
+        sessionId: string;
+    };
+}[keyof TEventDefRecord], {
+    [K in keyof TEventDefRecord]: {
+        name: K;
+        args: TEventDefRecord[K]['schema']['Encoded'];
+        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,SAAS,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAA;CAClC,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,SAAS,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAA;CACrC,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,SAAS,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAA;IACjC,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,SAAS,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAA;IACpC,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,KAAK,CAC1E;KACG,CAAC,IAAI,MAAM,eAAe,GAAG;QAC5B,IAAI,EAAE,CAAC,CAAA;QACP,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAA;QAC1C,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,eAAe,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAA;QAC7C,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<{
+    readonly name: Schema.String;
+    readonly args: Schema.Any;
+    readonly seqNum: Schema.brand<Schema.Int, "GlobalEventSequenceNumber">;
+    readonly parentSeqNum: Schema.brand<Schema.Int, "GlobalEventSequenceNumber">;
+    readonly clientId: Schema.String;
+    readonly sessionId: 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;;;;;;;EAOmC,CAAA;AAEvD,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,
+}).annotate({ 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,QAAQ,CAAC,EAAE,KAAK,EAAE,+BAA+B,EAAE,CAAC,CAAA;AAKvD,+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"}