@livestore/common 0.4.0-dev.18 → 0.4.0-dev.19

package/dist/schema/EventDef/materializer.js

@@ -0,0 +1,83 @@
+/**
+ * Materializer System
+ *
+ * Materializers transform events into SQL mutations (INSERT, UPDATE, DELETE).
+ * Every non-derived event must have a corresponding materializer that defines
+ * how it affects the SQLite database state.
+ *
+ * Materializers are pure functions that receive the event arguments and return
+ * SQL operations. They can also query current state when needed for complex
+ * transformations.
+ *
+ * @example
+ * ```ts
+ * import { State } from '@livestore/livestore'
+ *
+ * const materializers = State.SQLite.materializers(events, {
+ *   'v1.TodoCreated': ({ id, text }) =>
+ *     tables.todos.insert({ id, text, completed: false }),
+ *
+ *   'v1.TodoCompleted': ({ id }) =>
+ *     tables.todos.update({ completed: true }).where({ id }),
+ *
+ *   'v1.TodoDeleted': ({ id, deletedAt }) =>
+ *     tables.todos.update({ deletedAt }).where({ id }),
+ * })
+ * ```
+ * @module
+ */
+/**
+ * Type-safe wrapper for defining a single materializer.
+ *
+ * Useful when defining materializers separately from the `materializers()` builder.
+ * The first argument provides type inference for the second.
+ *
+ * @example
+ * ```ts
+ * const todoCreatedHandler = defineMaterializer(
+ *   events.todoCreated,
+ *   ({ id, text }) => tables.todos.insert({ id, text, completed: false })
+ * )
+ * ```
+ */
+export const defineMaterializer = (_eventDef, materializer) => {
+    return materializer;
+};
+/**
+ * Builder function for creating a type-safe materializer map.
+ *
+ * This is the primary way to define materializers in LiveStore. It ensures:
+ * - Every non-derived event has a corresponding materializer
+ * - Materializer argument types match their event schemas
+ * - Derived events are excluded from the required handlers
+ *
+ * @example
+ * ```ts
+ * import { State } from '@livestore/livestore'
+ *
+ * const handlers = State.SQLite.materializers(events, {
+ *   // Handler for each event - argument types are inferred
+ *   'v1.TodoCreated': ({ id, text, completed }) =>
+ *     tables.todos.insert({ id, text, completed }),
+ *
+ *   'v1.TodoUpdated': ({ id, text }) =>
+ *     tables.todos.update({ text }).where({ id }),
+ *
+ *   // Can return multiple operations
+ *   'v1.UserCreatedWithDefaults': ({ userId, name }) => [
+ *     tables.users.insert({ id: userId, name }),
+ *     tables.settings.insert({ userId, theme: 'light' }),
+ *   ],
+ *
+ *   // Can query current state
+ *   'v1.TodoToggled': ({ id }, { query }) => {
+ *     const todo = query(tables.todos.select().where({ id }).first())
+ *     return tables.todos.update({ completed: !todo?.completed }).where({ id })
+ *   },
+ * })
+ * ```
+ */
+export const materializers = (_eventDefRecord, handlers) => {
+    return handlers;
+};
+//# sourceMappingURL=materializer.js.map

package/dist/schema/EventDef/materializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"materializer.js","sourceRoot":"","sources":["../../../src/schema/EventDef/materializer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AA6EH;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,SAAoB,EACpB,YAAqC,EACZ,EAAE;IAC3B,OAAO,YAAY,CAAA;AACrB,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,eAA6B,EAC7B,QAOC,EACD,EAAE;IACF,OAAO,QAAQ,CAAA;AACjB,CAAC,CAAA"}

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

@@ -0,0 +1,5 @@
+export * from './define.ts';
+export * from './event-def.ts';
+export * from './facts.ts';
+export * from './materializer.ts';
+//# sourceMappingURL=mod.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/schema/EventDef/mod.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA"}

package/dist/schema/EventDef/mod.js

@@ -0,0 +1,5 @@
+export * from "./define.js";
+export * from "./event-def.js";
+export * from "./facts.js";
+export * from "./materializer.js";
+//# sourceMappingURL=mod.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../../src/schema/EventDef/mod.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA"}

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

@@ -0,0 +1,136 @@
+import { Brand, Schema as S } from '@livestore/utils/effect';
+import { type Type as Global } from './global.ts';
+/** Branded integer type for client-local sequence numbers. */
+export type Type = Brand.Branded<number, 'ClientEventSequenceNumber'>;
+/** Effect Schema for encoding/decoding client sequence numbers. */
+export declare const Schema: S.BrandSchema<number & Brand.Brand<"ClientEventSequenceNumber">, number, never>;
+/**
+ * Creates a branded client sequence number from a plain number.
+ *
+ * @example
+ * ```ts
+ * const clientSeq = EventSequenceNumber.Client.make(1)
+ * ```
+ */
+export declare const make: Brand.Brand.Constructor<Type>;
+/**
+ * Default client sequence number (0). Used for confirmed/synced events.
+ *
+ * @example
+ * ```ts
+ * const defaultSeq = EventSequenceNumber.Client.DEFAULT // 0
+ * ```
+ */
+export declare const DEFAULT: Type;
+/** Default rebase generation (0). Increments each time the client rebases unconfirmed events. */
+export declare const REBASE_GENERATION_DEFAULT = 0;
+/**
+ * Composite event sequence number consisting of global + client + rebaseGeneration.
+ * Used for client-side event tracking with support for unconfirmed local events.
+ *
+ * For event notation documentation, see: contributor-docs/events-notation.md
+ */
+export type Composite = {
+    global: Global;
+    client: Type;
+    /**
+     * Generation integer that is incremented whenever the client rebased.
+     * Remains constant for all subsequent events until another rebase occurs.
+     */
+    rebaseGeneration: number;
+};
+/** Input type for creating a Composite sequence number. Allows omitting rebaseGeneration (defaults to 0). */
+export type CompositeInput = Composite | (Omit<typeof CompositeSchema.Encoded, 'rebaseGeneration'> & {
+    rebaseGeneration?: number;
+});
+/** A pair of sequence numbers representing an event and its parent. */
+export type CompositePair = {
+    seqNum: Composite;
+    parentSeqNum: Composite;
+};
+/**
+ * Compare two composite sequence numbers.
+ * Comparison hierarchy: global > client > rebaseGeneration
+ */
+export declare const compare: (a: Composite, b: Composite) => number;
+/**
+ * Convert a composite sequence number to a string representation.
+ *
+ * For notation documentation, see: contributor-docs/events-notation.md
+ */
+export declare const toString: (seqNum: Composite) => string;
+/**
+ * Convert a string representation of a sequence number to a Composite.
+ * Parses strings in the format: e{global}[.{client}][r{rebaseGeneration}]
+ * Examples: "e0", "e0r1", "e0.1", "e0.1r1"
+ *
+ * For full notation documentation, see: contributor-docs/events-notation.md
+ */
+export declare const fromString: (str: string) => Composite;
+/** Creates a Composite sequence number from a global sequence number (client=0, rebaseGeneration=0). */
+export declare const fromGlobal: (seqNum: Global) => Composite;
+/** Returns true if two Composite sequence numbers are structurally equal. */
+export declare const isEqual: (a: Composite, b: Composite) => boolean;
+/** Returns true if `a` is strictly greater than `b` (compares global, then client). */
+export declare const isGreaterThan: (a: Composite, b: Composite) => boolean;
+/** Returns true if `a` is greater than or equal to `b` (compares global, then client). */
+export declare const isGreaterThanOrEqual: (a: Composite, b: Composite) => boolean;
+/** Returns the larger of two Composite sequence numbers. */
+export declare const max: (a: Composite, b: Composite) => Composite;
+/** Returns the difference between two Composite sequence numbers (a - b) for global and client components. */
+export declare const diff: (a: Composite, b: Composite) => {
+    global: number;
+    client: number;
+};
+/**
+ * Schema for the composite event sequence number.
+ * NOTE: Client mutation events with a non-0 client id won't be synced to the sync backend.
+ */
+declare const CompositeSchema: S.Struct<{
+    global: S.BrandSchema<number & Brand.Brand<"GlobalEventSequenceNumber">, number, never>;
+    /** Only increments for client-local events */
+    client: S.BrandSchema<number & Brand.Brand<"ClientEventSequenceNumber">, number, never>;
+    rebaseGeneration: typeof S.Int;
+}>;
+/**
+ * Effect Schema for the composite event sequence number (global + client + rebaseGeneration).
+ * Also includes a `make` helper for creating validated Composite values.
+ *
+ * @example
+ * ```ts
+ * const seqNum: EventSequenceNumber.Client.Composite = {
+ *   global: EventSequenceNumber.Global.make(5),
+ *   client: EventSequenceNumber.Client.DEFAULT,
+ *   rebaseGeneration: 0
+ * }
+ *
+ * const validated = EventSequenceNumber.Client.Composite.make({ global: 5, client: 0, rebaseGeneration: 0 })
+ * ```
+ */
+export declare const Composite: S.Struct<{
+    global: S.BrandSchema<number & Brand.Brand<"GlobalEventSequenceNumber">, number, never>;
+    /** Only increments for client-local events */
+    client: S.BrandSchema<number & Brand.Brand<"ClientEventSequenceNumber">, number, never>;
+    rebaseGeneration: typeof S.Int;
+}> & {
+    make: (seqNum: CompositeInput) => Composite;
+};
+/** The root sequence number (global=0, client=0, rebaseGeneration=0). Parent of the first event. */
+export declare const ROOT: {
+    global: Global;
+    client: Type;
+    rebaseGeneration: number;
+};
+/**
+ * Computes the next sequence number and its parent based on the current position.
+ *
+ * For client-local events (isClient=true): increments the client component, keeps global.
+ * For global events (isClient=false): increments global, resets client to 0.
+ */
+export declare const nextPair: ({ seqNum, isClient, rebaseGeneration, }: {
+    seqNum: Composite;
+    isClient: boolean;
+    rebaseGeneration?: number;
+}) => CompositePair;
+export {};
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/schema/EventSequenceNumber/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC,EAAE,MAAM,yBAAyB,CAAA;AAE5D,OAAO,EAAE,KAAK,IAAI,IAAI,MAAM,EAA8C,MAAM,aAAa,CAAA;AAE7F,8DAA8D;AAC9D,MAAM,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAA;AAIrE,mEAAmE;AACnE,eAAO,MAAM,MAAM,iFAAkC,CAAA;AAErD;;;;;;;GAOG;AACH,eAAO,MAAM,IAAI,+BAAc,CAAA;AAE/B;;;;;;;GAOG;AACH,eAAO,MAAM,OAAO,EAAe,IAAI,CAAA;AAEvC,iGAAiG;AACjG,eAAO,MAAM,yBAAyB,IAAI,CAAA;AAE1C;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,IAAI,CAAA;IACZ;;;OAGG;IACH,gBAAgB,EAAE,MAAM,CAAA;CACzB,CAAA;AAED,6GAA6G;AAC7G,MAAM,MAAM,cAAc,GACtB,SAAS,GACT,CAAC,IAAI,CAAC,OAAO,eAAe,CAAC,OAAO,EAAE,kBAAkB,CAAC,GAAG;IAAE,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AAE9F,uEAAuE;AACvE,MAAM,MAAM,aAAa,GAAG;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,YAAY,EAAE,SAAS,CAAA;CAAE,CAAA;AAE1E;;;GAGG;AACH,eAAO,MAAM,OAAO,GAAI,GAAG,SAAS,EAAE,GAAG,SAAS,WAQjD,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GAAI,QAAQ,SAAS,WAKzC,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GAAI,KAAK,MAAM,KAAG,SAyCxC,CAAA;AAED,wGAAwG;AACxG,eAAO,MAAM,UAAU,GAAI,QAAQ,MAAM,KAAG,SAI1C,CAAA;AAEF,6EAA6E;AAC7E,eAAO,MAAM,OAAO,GAAI,GAAG,SAAS,EAAE,GAAG,SAAS,YAC2C,CAAA;AAE7F,uFAAuF;AACvF,eAAO,MAAM,aAAa,GAAI,GAAG,SAAS,EAAE,GAAG,SAAS,YAEvD,CAAA;AAED,0FAA0F;AAC1F,eAAO,MAAM,oBAAoB,GAAI,GAAG,SAAS,EAAE,GAAG,SAAS,YAE9D,CAAA;AAED,4DAA4D;AAC5D,eAAO,MAAM,GAAG,GAAI,GAAG,SAAS,EAAE,GAAG,SAAS,cAE7C,CAAA;AAED,8GAA8G;AAC9G,eAAO,MAAM,IAAI,GAAI,GAAG,SAAS,EAAE,GAAG,SAAS;;;CAK9C,CAAA;AAED;;;GAGG;AACH,QAAA,MAAM,eAAe;;IAEnB,8CAA8C;;;EAO9C,CAAA;AAeF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,SAAS;;IArCpB,8CAA8C;;;;mBAajB,cAAc,KAAG,SAAS;CAwBuB,CAAA;AAEhF,oGAAoG;AACpG,eAAO,MAAM,IAAI;;;;CAII,CAAA;AAErB;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GAAI,yCAItB;IACD,MAAM,EAAE,SAAS,CAAA;IACjB,QAAQ,EAAE,OAAO,CAAA;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B,KAAG,aAqBH,CAAA"}

package/dist/schema/{EventSequenceNumber.js → EventSequenceNumber/client.js}

@@ -1,27 +1,30 @@
-import { Brand, Schema } from '@livestore/utils/effect';
-export const localEventSequenceNumber = Brand.nominal();
-export const ClientEventSequenceNumber = Schema.fromBrand(localEventSequenceNumber)(Schema.Int);
-export const globalEventSequenceNumber = Brand.nominal();
-export const GlobalEventSequenceNumber = Schema.fromBrand(globalEventSequenceNumber)(Schema.Int);
-export const clientDefault = 0;
-export const rebaseGenerationDefault = 0;
-// TODO adjust name to `ClientEventSequenceNumber`
+import { Brand, Schema as S } from '@livestore/utils/effect';
+import { Schema as GlobalSchema, make as makeGlobal } from "./global.js";
+const ClientBrand = Brand.nominal();
+/** Effect Schema for encoding/decoding client sequence numbers. */
+export const Schema = S.fromBrand(ClientBrand)(S.Int);
 /**
- * NOTE: Client mutation events with a non-0 client id, won't be synced to the sync backend.
+ * Creates a branded client sequence number from a plain number.
+ *
+ * @example
+ * ```ts
+ * const clientSeq = EventSequenceNumber.Client.make(1)
+ * ```
  */
-export const EventSequenceNumber = Schema.Struct({
-    global: GlobalEventSequenceNumber,
-    /** Only increments for client-local events */
-    client: ClientEventSequenceNumber,
-    // TODO also provide a way to see "confirmation level" of event (e.g. confirmed by leader/sync backend)
-    // Client only
-    rebaseGeneration: Schema.Int,
-}).annotations({
-    title: 'LiveStore.EventSequenceNumber',
-    pretty: () => (seqNum) => toString(seqNum),
-});
+export const make = ClientBrand;
+/**
+ * Default client sequence number (0). Used for confirmed/synced events.
+ *
+ * @example
+ * ```ts
+ * const defaultSeq = EventSequenceNumber.Client.DEFAULT // 0
+ * ```
+ */
+export const DEFAULT = 0;
+/** Default rebase generation (0). Increments each time the client rebases unconfirmed events. */
+export const REBASE_GENERATION_DEFAULT = 0;
 /**
- * Compare two event sequence numbers i.e. checks if the first event sequence number is less than the second.
+ * Compare two composite sequence numbers.
  * Comparison hierarchy: global > client > rebaseGeneration
  */
 export const compare = (a, b) => {
@@ -34,7 +37,7 @@ export const compare = (a, b) => {
     return a.rebaseGeneration - b.rebaseGeneration;
 };
 /**
- * Convert an event sequence number to a string representation.
+ * Convert a composite sequence number to a string representation.
  *
  * For notation documentation, see: contributor-docs/events-notation.md
  */
@@ -45,7 +48,7 @@ export const toString = (seqNum) => {
         : `e${seqNum.global}.${seqNum.client}${rebaseGenerationStr}`;
 };
 /**
- * Convert a string representation of an event sequence number to an event sequence number.
+ * Convert a string representation of a sequence number to a Composite.
  * Parses strings in the format: e{global}[.{client}][r{rebaseGeneration}]
  * Examples: "e0", "e0r1", "e0.1", "e0.1r1"
  *
@@ -58,7 +61,7 @@ export const fromString = (str) => {
     // Remove the 'e' prefix
     const remaining = str.slice(1);
     // Parse rebase generation if present
-    let rebaseGeneration = rebaseGenerationDefault;
+    let rebaseGeneration = REBASE_GENERATION_DEFAULT;
     let withoutRebase = remaining;
     const rebaseMatch = remaining.match(/r(\d+)$/);
     if (rebaseMatch !== null) {
@@ -85,42 +88,86 @@ export const fromString = (str) => {
         rebaseGeneration,
     };
 };
+/** Creates a Composite sequence number from a global sequence number (client=0, rebaseGeneration=0). */
 export const fromGlobal = (seqNum) => ({
     global: seqNum,
-    client: clientDefault,
-    rebaseGeneration: rebaseGenerationDefault,
+    client: DEFAULT,
+    rebaseGeneration: REBASE_GENERATION_DEFAULT,
 });
+/** Returns true if two Composite sequence numbers are structurally equal. */
 export const isEqual = (a, b) => a.global === b.global && a.client === b.client && a.rebaseGeneration === b.rebaseGeneration;
-export const ROOT = {
-    global: 0,
-    client: clientDefault,
-    rebaseGeneration: rebaseGenerationDefault,
-};
+/** Returns true if `a` is strictly greater than `b` (compares global, then client). */
 export const isGreaterThan = (a, b) => {
     return a.global > b.global || (a.global === b.global && a.client > b.client);
 };
+/** Returns true if `a` is greater than or equal to `b` (compares global, then client). */
 export const isGreaterThanOrEqual = (a, b) => {
     return a.global > b.global || (a.global === b.global && a.client >= b.client);
 };
+/** Returns the larger of two Composite sequence numbers. */
 export const max = (a, b) => {
     return a.global > b.global || (a.global === b.global && a.client > b.client) ? a : b;
 };
+/** Returns the difference between two Composite sequence numbers (a - b) for global and client components. */
 export const diff = (a, b) => {
     return {
         global: a.global - b.global,
         client: a.client - b.client,
     };
 };
-export const make = (seqNum) => {
-    return Schema.is(EventSequenceNumber)(seqNum)
+/**
+ * Schema for the composite event sequence number.
+ * NOTE: Client mutation events with a non-0 client id won't be synced to the sync backend.
+ */
+const CompositeSchema = S.Struct({
+    global: GlobalSchema,
+    /** Only increments for client-local events */
+    client: Schema,
+    // Client only
+    rebaseGeneration: S.Int,
+}).annotations({
+    title: 'EventSequenceNumber.Composite',
+    pretty: () => (seqNum) => toString(seqNum),
+});
+/**
+ * Creates a validated Composite sequence number from input.
+ * If rebaseGeneration is omitted, defaults to REBASE_GENERATION_DEFAULT (0).
+ */
+const makeComposite = (seqNum) => {
+    return S.is(CompositeSchema)(seqNum)
         ? seqNum
-        : Schema.decodeSync(EventSequenceNumber)({
+        : S.decodeSync(CompositeSchema)({
             ...seqNum,
-            rebaseGeneration: seqNum.rebaseGeneration ?? rebaseGenerationDefault,
+            rebaseGeneration: seqNum.rebaseGeneration ?? REBASE_GENERATION_DEFAULT,
         });
 };
 /**
- * Computes the next event sequence/parent pair.
+ * Effect Schema for the composite event sequence number (global + client + rebaseGeneration).
+ * Also includes a `make` helper for creating validated Composite values.
+ *
+ * @example
+ * ```ts
+ * const seqNum: EventSequenceNumber.Client.Composite = {
+ *   global: EventSequenceNumber.Global.make(5),
+ *   client: EventSequenceNumber.Client.DEFAULT,
+ *   rebaseGeneration: 0
+ * }
+ *
+ * const validated = EventSequenceNumber.Client.Composite.make({ global: 5, client: 0, rebaseGeneration: 0 })
+ * ```
+ */
+export const Composite = Object.assign(CompositeSchema, { make: makeComposite });
+/** The root sequence number (global=0, client=0, rebaseGeneration=0). Parent of the first event. */
+export const ROOT = {
+    global: makeGlobal(0),
+    client: DEFAULT,
+    rebaseGeneration: REBASE_GENERATION_DEFAULT,
+};
+/**
+ * Computes the next sequence number and its parent based on the current position.
+ *
+ * For client-local events (isClient=true): increments the client component, keeps global.
+ * For global events (isClient=false): increments global, resets client to 0.
  */
 export const nextPair = ({ seqNum, isClient, rebaseGeneration, }) => {
     if (isClient) {
@@ -136,11 +183,11 @@ export const nextPair = ({ seqNum, isClient, rebaseGeneration, }) => {
     return {
         seqNum: {
             global: (seqNum.global + 1),
-            client: clientDefault,
+            client: DEFAULT,
             rebaseGeneration: rebaseGeneration ?? seqNum.rebaseGeneration,
         },
         // NOTE we always point to `client: 0` for non-client-local events
-        parentSeqNum: { global: seqNum.global, client: clientDefault, rebaseGeneration: seqNum.rebaseGeneration },
+        parentSeqNum: { global: seqNum.global, client: DEFAULT, rebaseGeneration: seqNum.rebaseGeneration },
     };
 };
-//# sourceMappingURL=EventSequenceNumber.js.map
+//# sourceMappingURL=client.js.map

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

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

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

@@ -0,0 +1,15 @@
+import { Brand, Schema as S } from '@livestore/utils/effect';
+/** Branded integer type for global sequence numbers assigned by the sync backend. */
+export type Type = Brand.Branded<number, 'GlobalEventSequenceNumber'>;
+/** Effect Schema for encoding/decoding global sequence numbers. */
+export declare const Schema: S.BrandSchema<number & Brand.Brand<"GlobalEventSequenceNumber">, number, never>;
+/**
+ * Creates a branded global sequence number from a plain number.
+ *
+ * @example
+ * ```ts
+ * const seqNum = EventSequenceNumber.Global.make(5)
+ * ```
+ */
+export declare const make: Brand.Brand.Constructor<Type>;
+//# sourceMappingURL=global.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"global.d.ts","sourceRoot":"","sources":["../../../src/schema/EventSequenceNumber/global.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC,EAAE,MAAM,yBAAyB,CAAA;AAE5D,qFAAqF;AACrF,MAAM,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAA;AAIrE,mEAAmE;AACnE,eAAO,MAAM,MAAM,iFAAkC,CAAA;AAErD;;;;;;;GAOG;AACH,eAAO,MAAM,IAAI,+BAAc,CAAA"}

package/dist/schema/EventSequenceNumber/global.js

@@ -0,0 +1,14 @@
+import { Brand, Schema as S } from '@livestore/utils/effect';
+const GlobalBrand = Brand.nominal();
+/** Effect Schema for encoding/decoding global sequence numbers. */
+export const Schema = S.fromBrand(GlobalBrand)(S.Int);
+/**
+ * Creates a branded global sequence number from a plain number.
+ *
+ * @example
+ * ```ts
+ * const seqNum = EventSequenceNumber.Global.make(5)
+ * ```
+ */
+export const make = GlobalBrand;
+//# sourceMappingURL=global.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"global.js","sourceRoot":"","sources":["../../../src/schema/EventSequenceNumber/global.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC,EAAE,MAAM,yBAAyB,CAAA;AAK5D,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,EAAQ,CAAA;AAEzC,mEAAmE;AACnE,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;AAErD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,WAAW,CAAA"}

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

@@ -0,0 +1,37 @@
+/**
+ * Client sequence numbers track events created locally before sync confirmation.
+ * Also contains the Composite type combining global and client sequence numbers with a rebase
+ * generation to fully identify an event's position in the eventlog.
+ *
+ * For event notation documentation, see: contributor-docs/events-notation.md
+ *
+ * @example
+ * ```ts
+ * import { EventSequenceNumber } from '@livestore/common'
+ *
+ * // Client sequence number
+ * const clientSeq = EventSequenceNumber.Client.make(1)
+ *
+ * // Composite sequence number
+ * const composite: EventSequenceNumber.Client.Composite = {
+ *   global: EventSequenceNumber.Global.make(5),
+ *   client: EventSequenceNumber.Client.DEFAULT,
+ *   rebaseGeneration: 0,
+ * }
+ * ```
+ */
+export * as Client from './client.ts';
+/**
+ * Global sequence numbers are assigned by the sync backend and represent
+ * the canonical ordering of events across all clients. They are monotonically
+ * increasing integers that establish the authoritative event timeline.
+ *
+ * @example
+ * ```ts
+ * import { EventSequenceNumber } from '@livestore/common'
+ *
+ * const globalSeq = EventSequenceNumber.Global.make(5)
+ * ```
+ */
+export * as Global from './global.ts';
+//# sourceMappingURL=mod.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/schema/EventSequenceNumber/mod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA"}

package/dist/schema/EventSequenceNumber/mod.js

@@ -0,0 +1,37 @@
+/**
+ * Client sequence numbers track events created locally before sync confirmation.
+ * Also contains the Composite type combining global and client sequence numbers with a rebase
+ * generation to fully identify an event's position in the eventlog.
+ *
+ * For event notation documentation, see: contributor-docs/events-notation.md
+ *
+ * @example
+ * ```ts
+ * import { EventSequenceNumber } from '@livestore/common'
+ *
+ * // Client sequence number
+ * const clientSeq = EventSequenceNumber.Client.make(1)
+ *
+ * // Composite sequence number
+ * const composite: EventSequenceNumber.Client.Composite = {
+ *   global: EventSequenceNumber.Global.make(5),
+ *   client: EventSequenceNumber.Client.DEFAULT,
+ *   rebaseGeneration: 0,
+ * }
+ * ```
+ */
+export * as Client from "./client.js";
+/**
+ * Global sequence numbers are assigned by the sync backend and represent
+ * the canonical ordering of events across all clients. They are monotonically
+ * increasing integers that establish the authoritative event timeline.
+ *
+ * @example
+ * ```ts
+ * import { EventSequenceNumber } from '@livestore/common'
+ *
+ * const globalSeq = EventSequenceNumber.Global.make(5)
+ * ```
+ */
+export * as Global from "./global.js";
+//# sourceMappingURL=mod.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../../src/schema/EventSequenceNumber/mod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA"}