@livestore/common 0.4.0-dev.2 → 0.4.0-dev.21

package/dist/schema/{LiveStoreEvent.d.ts → LiveStoreEvent/client.d.ts}

@@ -1,123 +1,79 @@
 import { Option, Schema } from '@livestore/utils/effect';
-import type { EventDef, EventDefRecord } from './EventDef.ts';
-import * as EventSequenceNumber from './EventSequenceNumber.ts';
-import type { LiveStoreSchema } from './schema.ts';
-export declare namespace ForEventDef {
-    type PartialDecoded<TEventDef extends EventDef.Any> = {
-        name: TEventDef['name'];
-        args: Schema.Schema.Type<TEventDef['schema']>;
-    };
-    type PartialEncoded<TEventDef extends EventDef.Any> = {
-        name: TEventDef['name'];
-        args: Schema.Schema.Encoded<TEventDef['schema']>;
-    };
-    type Decoded<TEventDef extends EventDef.Any> = {
-        name: TEventDef['name'];
-        args: Schema.Schema.Type<TEventDef['schema']>;
-        seqNum: EventSequenceNumber.EventSequenceNumber;
-        parentSeqNum: EventSequenceNumber.EventSequenceNumber;
-        clientId: string;
-        sessionId: string;
-    };
-    type Encoded<TEventDef extends EventDef.Any> = {
-        name: TEventDef['name'];
-        args: Schema.Schema.Encoded<TEventDef['schema']>;
-        seqNum: EventSequenceNumber.EventSequenceNumber;
-        parentSeqNum: EventSequenceNumber.EventSequenceNumber;
-        clientId: string;
-        sessionId: string;
-    };
-}
-export type AnyDecoded = ForEventDef.Decoded<EventDef.Any>;
-export declare const AnyDecoded: Schema.Struct<{
+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<{
     name: typeof Schema.String;
     args: typeof Schema.Any;
     seqNum: Schema.Struct<{
         global: Schema.BrandSchema<number & import("effect/Brand").Brand<"GlobalEventSequenceNumber">, number, never>;
         client: Schema.BrandSchema<number & import("effect/Brand").Brand<"ClientEventSequenceNumber">, number, never>;
         rebaseGeneration: typeof Schema.Int;
-    }>;
+    }> & {
+        make: (seqNum: EventSequenceNumber.Client.CompositeInput) => EventSequenceNumber.Client.Composite;
+    };
     parentSeqNum: Schema.Struct<{
         global: Schema.BrandSchema<number & import("effect/Brand").Brand<"GlobalEventSequenceNumber">, number, never>;
         client: Schema.BrandSchema<number & import("effect/Brand").Brand<"ClientEventSequenceNumber">, number, never>;
         rebaseGeneration: typeof Schema.Int;
-    }>;
+    }> & {
+        make: (seqNum: EventSequenceNumber.Client.CompositeInput) => EventSequenceNumber.Client.Composite;
+    };
     clientId: typeof Schema.String;
     sessionId: typeof Schema.String;
 }>;
-export type AnyEncoded = ForEventDef.Encoded<EventDef.Any>;
-export declare const AnyEncoded: Schema.Struct<{
+/**
+ * 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<{
     name: typeof Schema.String;
     args: typeof Schema.Any;
     seqNum: Schema.Struct<{
         global: Schema.BrandSchema<number & import("effect/Brand").Brand<"GlobalEventSequenceNumber">, number, never>;
         client: Schema.BrandSchema<number & import("effect/Brand").Brand<"ClientEventSequenceNumber">, number, never>;
         rebaseGeneration: typeof Schema.Int;
-    }>;
+    }> & {
+        make: (seqNum: EventSequenceNumber.Client.CompositeInput) => EventSequenceNumber.Client.Composite;
+    };
     parentSeqNum: Schema.Struct<{
         global: Schema.BrandSchema<number & import("effect/Brand").Brand<"GlobalEventSequenceNumber">, number, never>;
         client: Schema.BrandSchema<number & import("effect/Brand").Brand<"ClientEventSequenceNumber">, number, never>;
         rebaseGeneration: typeof Schema.Int;
-    }>;
-    clientId: typeof Schema.String;
-    sessionId: typeof Schema.String;
-}>;
-export declare const AnyEncodedGlobal: 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>;
+    }> & {
+        make: (seqNum: EventSequenceNumber.Client.CompositeInput) => EventSequenceNumber.Client.Composite;
+    };
     clientId: typeof Schema.String;
     sessionId: typeof Schema.String;
 }>;
-export type AnyEncodedGlobal = typeof AnyEncodedGlobal.Type;
-export type PartialAnyDecoded = ForEventDef.PartialDecoded<EventDef.Any>;
-export type PartialAnyEncoded = ForEventDef.PartialEncoded<EventDef.Any>;
-export declare const PartialAnyEncoded: Schema.Struct<{
-    name: typeof Schema.String;
-    args: typeof Schema.Any;
-}>;
-export type PartialForSchema<TSchema extends LiveStoreSchema> = {
-    [K in keyof TSchema['_EventDefMapType']]: ForEventDef.PartialDecoded<TSchema['_EventDefMapType'][K]>;
-}[keyof TSchema['_EventDefMapType']];
+/** 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']];
-export declare const isPartialEventDef: (event: AnyDecoded | PartialAnyDecoded) => event is PartialAnyDecoded;
-export type ForEventDefRecord<TEventDefRecord extends EventDefRecord> = Schema.Schema<{
-    [K in keyof TEventDefRecord]: {
-        name: K;
-        args: Schema.Schema.Type<TEventDefRecord[K]['schema']>;
-        seqNum: EventSequenceNumber.EventSequenceNumber;
-        parentSeqNum: EventSequenceNumber.EventSequenceNumber;
-        clientId: string;
-        sessionId: string;
-    };
-}[keyof TEventDefRecord], {
-    [K in keyof TEventDefRecord]: {
-        name: K;
-        args: Schema.Schema.Encoded<TEventDefRecord[K]['schema']>;
-        seqNum: EventSequenceNumber.EventSequenceNumber;
-        parentSeqNum: EventSequenceNumber.EventSequenceNumber;
-        clientId: string;
-        sessionId: string;
-    };
-}[keyof TEventDefRecord]>;
-export type EventDefPartialSchema<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]>;
-export declare const makeEventDefSchema: <TSchema extends LiveStoreSchema>(schema: TSchema) => ForEventDefRecord<TSchema["_EventDefMapType"]>;
-export declare const makeEventDefPartialSchema: <TSchema extends LiveStoreSchema>(schema: TSchema) => EventDefPartialSchema<TSchema["_EventDefMapType"]>;
-export declare const makeEventDefSchemaMemo: <TSchema extends LiveStoreSchema>(schema: TSchema) => ForEventDefRecord<TSchema["_EventDefMapType"]>;
-export declare const encodedFromGlobal: (event: AnyEncodedGlobal) => AnyEncoded;
 declare const EncodedWithMeta_base: Schema.Class<EncodedWithMeta, {
     name: typeof Schema.String;
     args: typeof Schema.Any;
@@ -125,12 +81,16 @@ declare const EncodedWithMeta_base: Schema.Class<EncodedWithMeta, {
         global: Schema.BrandSchema<number & import("effect/Brand").Brand<"GlobalEventSequenceNumber">, number, never>;
         client: Schema.BrandSchema<number & import("effect/Brand").Brand<"ClientEventSequenceNumber">, number, never>;
         rebaseGeneration: typeof Schema.Int;
-    }>;
+    }> & {
+        make: (seqNum: EventSequenceNumber.Client.CompositeInput) => EventSequenceNumber.Client.Composite;
+    };
     parentSeqNum: Schema.Struct<{
         global: Schema.BrandSchema<number & import("effect/Brand").Brand<"GlobalEventSequenceNumber">, number, never>;
         client: Schema.BrandSchema<number & import("effect/Brand").Brand<"ClientEventSequenceNumber">, number, never>;
         rebaseGeneration: typeof Schema.Int;
-    }>;
+    }> & {
+        make: (seqNum: EventSequenceNumber.Client.CompositeInput) => EventSequenceNumber.Client.Composite;
+    };
     clientId: typeof Schema.String;
     sessionId: typeof Schema.String;
     meta: Schema.PropertySignature<":", {
@@ -182,12 +142,16 @@ declare const EncodedWithMeta_base: Schema.Class<EncodedWithMeta, {
         global: Schema.BrandSchema<number & import("effect/Brand").Brand<"GlobalEventSequenceNumber">, number, never>;
         client: Schema.BrandSchema<number & import("effect/Brand").Brand<"ClientEventSequenceNumber">, number, never>;
         rebaseGeneration: typeof Schema.Int;
-    }>;
+    }> & {
+        make: (seqNum: EventSequenceNumber.Client.CompositeInput) => EventSequenceNumber.Client.Composite;
+    };
     parentSeqNum: Schema.Struct<{
         global: Schema.BrandSchema<number & import("effect/Brand").Brand<"GlobalEventSequenceNumber">, number, never>;
         client: Schema.BrandSchema<number & import("effect/Brand").Brand<"ClientEventSequenceNumber">, number, never>;
         rebaseGeneration: typeof Schema.Int;
-    }>;
+    }> & {
+        make: (seqNum: EventSequenceNumber.Client.CompositeInput) => EventSequenceNumber.Client.Composite;
+    };
     clientId: typeof Schema.String;
     sessionId: typeof Schema.String;
     meta: Schema.PropertySignature<":", {
@@ -266,9 +230,14 @@ declare const EncodedWithMeta_base: Schema.Class<EncodedWithMeta, {
         syncMetadata: Option.Option<Schema.JsonValue>;
         materializerHashLeader: Option.Option<number>;
         materializerHashSession: Option.Option<number>;
-    } | undefined;
+    };
 }, {}, {}>;
-/** Equivalent to AnyEncoded but with a meta field and some convenience methods */
+/**
+ * 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;
     /**
@@ -277,30 +246,44 @@ export declare class EncodedWithMeta extends EncodedWithMeta_base {
      * 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
+     * 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
+     * Syntax: e2.2 → e2.1
      *          ^ ^    ^ ^
      *          | |    | +- client parent number
      *          | |    +--- global parent number
      *          | +-- client number
      *          +---- global number
-     * Client num is ommitted for global events
+     * Client num is omitted for global events
      */
     rebase: ({ parentSeqNum, isClient, rebaseGeneration, }: {
-        parentSeqNum: EventSequenceNumber.EventSequenceNumber;
+        parentSeqNum: EventSequenceNumber.Client.Composite;
         isClient: boolean;
         rebaseGeneration: number;
     }) => EncodedWithMeta;
-    static fromGlobal: (event: AnyEncodedGlobal, meta: {
+    static fromGlobal: (event: Global.Encoded, meta: {
         syncMetadata: Option.Option<Schema.JsonValue>;
         materializerHashLeader: Option.Option<number>;
         materializerHashSession: Option.Option<number>;
     }) => EncodedWithMeta;
-    toGlobal: () => AnyEncodedGlobal;
+    toGlobal: () => Global.Encoded;
 }
-/** NOTE `meta` is not considered for equality */
-export declare const isEqualEncoded: (a: AnyEncoded, b: AnyEncoded) => boolean;
+/**
+ * Structural equality check for client events. Compares seqNum (global + client),
+ * name, clientId, sessionId, and args. The `meta` field is ignored.
+ */
+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=LiveStoreEvent.d.ts.map
+//# 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,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAExD,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;;;;;;;;;;;;;;;;;;;EAOsC,CAAA;AAE1D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;EAOsC,CAAA;AAE1D,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEpC;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,oBAuCnC;IACA,MAAM,QAAO,GAAG,CASf;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,GAAI,+CAIP;QACD,YAAY,EAAE,mBAAmB,CAAC,MAAM,CAAC,SAAS,CAAA;QAClD,QAAQ,EAAE,OAAO,CAAA;QACjB,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,SAAS,CAAC,CAAA;QAC7C,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,CAI3B;CACH;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,GAAG,OAAO,EAAE,GAAG,OAAO,YAMF,CAAA;AAEnD;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,GAAI,OAAO,SAAS,eAAe,EACxD,QAAQ,OAAO,KACd,WAAW,CAAC,SAAS,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAYM,CAAA;AAE1D,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.js → LiveStoreEvent/client.js}

@@ -1,59 +1,55 @@
 import { memoizeByRef } from '@livestore/utils';
 import { Option, Schema } from '@livestore/utils/effect';
-import * as EventSequenceNumber from "./EventSequenceNumber.js";
-export const AnyDecoded = Schema.Struct({
+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.EventSequenceNumber,
-    parentSeqNum: EventSequenceNumber.EventSequenceNumber,
+    seqNum: EventSequenceNumber.Client.Composite,
+    parentSeqNum: EventSequenceNumber.Client.Composite,
     clientId: Schema.String,
     sessionId: Schema.String,
-}).annotations({ title: 'LiveStoreEvent.AnyDecoded' });
-export const AnyEncoded = Schema.Struct({
+}).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.EventSequenceNumber,
-    parentSeqNum: EventSequenceNumber.EventSequenceNumber,
+    seqNum: EventSequenceNumber.Client.Composite,
+    parentSeqNum: EventSequenceNumber.Client.Composite,
     clientId: Schema.String,
     sessionId: Schema.String,
-}).annotations({ title: 'LiveStoreEvent.AnyEncoded' });
-export const AnyEncodedGlobal = Schema.Struct({
+}).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.GlobalEventSequenceNumber,
-    parentSeqNum: EventSequenceNumber.GlobalEventSequenceNumber,
-    clientId: Schema.String,
-    sessionId: Schema.String,
-}).annotations({ title: 'LiveStoreEvent.AnyEncodedGlobal' });
-export const PartialAnyEncoded = Schema.Struct({
-    name: Schema.String,
-    args: Schema.Any,
-});
-export const isPartialEventDef = (event) => 'num' in event === false && 'parentSeqNum' in event === false;
-export const makeEventDefSchema = (schema) => Schema.Union(...[...schema.eventsDefsMap.values()].map((def) => Schema.Struct({
-    name: Schema.Literal(def.name),
-    args: def.schema,
-    seqNum: EventSequenceNumber.EventSequenceNumber,
-    parentSeqNum: EventSequenceNumber.EventSequenceNumber,
-    clientId: Schema.String,
-    sessionId: Schema.String,
-}))).annotations({ title: 'EventDef' });
-export const makeEventDefPartialSchema = (schema) => Schema.Union(...[...schema.eventsDefsMap.values()].map((def) => Schema.Struct({
-    name: Schema.Literal(def.name),
-    args: def.schema,
-}))).annotations({ title: 'EventDefPartial' });
-export const makeEventDefSchemaMemo = memoizeByRef(makeEventDefSchema);
-export const encodedFromGlobal = (event) => ({
-    ...event,
-    seqNum: EventSequenceNumber.fromGlobal(event.seqNum),
-    parentSeqNum: EventSequenceNumber.fromGlobal(event.parentSeqNum),
-});
-/** Equivalent to AnyEncoded but with a meta field and some convenience methods */
-export class EncodedWithMeta extends Schema.Class('LiveStoreEvent.EncodedWithMeta')({
-    name: Schema.String,
-    args: Schema.Any,
-    seqNum: EventSequenceNumber.EventSequenceNumber,
-    parentSeqNum: EventSequenceNumber.EventSequenceNumber,
+    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
@@ -86,7 +82,7 @@ export class EncodedWithMeta extends Schema.Class('LiveStoreEvent.EncodedWithMet
         // - More readable way to print the seqNum + parentSeqNum
         // - not including `meta`, `clientId`, `sessionId`
         return {
-            seqNum: `${EventSequenceNumber.toString(this.seqNum)} → ${EventSequenceNumber.toString(this.parentSeqNum)} (${this.clientId}, ${this.sessionId})`,
+            seqNum: `${EventSequenceNumber.Client.toString(this.seqNum)} → ${EventSequenceNumber.Client.toString(this.parentSeqNum)} (${this.clientId}, ${this.sessionId})`,
             name: this.name,
             args: this.args,
         };
@@ -97,32 +93,32 @@ export class EncodedWithMeta extends Schema.Class('LiveStoreEvent.EncodedWithMet
      * 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
+     * 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
+     * Syntax: e2.2 → e2.1
      *          ^ ^    ^ ^
      *          | |    | +- client parent number
      *          | |    +--- global parent number
      *          | +-- client number
      *          +---- global number
-     * Client num is ommitted for global events
+     * Client num is omitted for global events
      */
     rebase = ({ parentSeqNum, isClient, rebaseGeneration, }) => new EncodedWithMeta({
         ...this,
-        ...EventSequenceNumber.nextPair({ seqNum: parentSeqNum, isClient, rebaseGeneration }),
+        ...EventSequenceNumber.Client.nextPair({ seqNum: parentSeqNum, isClient, rebaseGeneration }),
     });
     static fromGlobal = (event, meta) => new EncodedWithMeta({
         ...event,
         seqNum: {
             global: event.seqNum,
-            client: EventSequenceNumber.clientDefault,
-            rebaseGeneration: EventSequenceNumber.rebaseGenerationDefault,
+            client: EventSequenceNumber.Client.DEFAULT,
+            rebaseGeneration: EventSequenceNumber.Client.REBASE_GENERATION_DEFAULT,
         },
         parentSeqNum: {
             global: event.parentSeqNum,
-            client: EventSequenceNumber.clientDefault,
-            rebaseGeneration: EventSequenceNumber.rebaseGenerationDefault,
+            client: EventSequenceNumber.Client.DEFAULT,
+            rebaseGeneration: EventSequenceNumber.Client.REBASE_GENERATION_DEFAULT,
         },
         meta: {
             sessionChangeset: { _tag: 'unset' },
@@ -137,12 +133,32 @@ export class EncodedWithMeta extends Schema.Class('LiveStoreEvent.EncodedWithMet
         parentSeqNum: this.parentSeqNum.global,
     });
 }
-/** NOTE `meta` is not considered for equality */
+/**
+ * Structural equality check for client events. Compares seqNum (global + client),
+ * name, clientId, sessionId, and args. The `meta` field is ignored.
+ */
 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 &&
-    // TODO use schema equality here
-    JSON.stringify(a.args) === JSON.stringify(b.args);
-//# sourceMappingURL=LiveStoreEvent.js.map
+    JSON.stringify(a.args) === JSON.stringify(b.args); // TODO use schema equality here
+/**
+ * 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/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"}