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

package/src/sync/transport-chunking.ts

@@ -0,0 +1,85 @@
+import type { ReadonlyArray as EffectArray } from '@livestore/utils/effect'
+import { Effect, Schema } from '@livestore/utils/effect'
+
+const textEncoder = new TextEncoder()
+
+/**
+ * Configuration describing how to break an array batch into smaller payload-safe batches.
+ */
+export interface ChunkingOptions<A> {
+  /** Maximum number of items that may appear in any emitted batch. */
+  readonly maxItems: number
+  /** Maximum encoded byte size allowed for any emitted batch. */
+  readonly maxBytes: number
+  /**
+   * Callback that produces a JSON-serialisable structure whose byte size should
+   * fit within {@link maxBytes}. This lets callers control framing overhead.
+   */
+  readonly encode: (items: ReadonlyArray<A>) => unknown
+  /**
+   * Optional custom measurement function. When provided it overrides the
+   * default {@link JSON.stringify}-based measurement logic.
+   */
+  readonly measure?: (items: ReadonlyArray<A>) => number
+}
+
+export class OversizeChunkItemError extends Schema.TaggedError<OversizeChunkItemError>(
+  '~@livestore/common/OversizeChunkItemError',
+)('OversizeChunkItemError', {
+  size: Schema.Finite,
+  maxBytes: Schema.Finite,
+}) {}
+
+/**
+ * Derives a function that splits an input array into sub-arrays confined by
+ * both item count and encoded byte size limits. Designed for stream boundaries
+ * and transports with strict frame caps (e.g. Cloudflare hibernated WebSockets).
+ */
+export const splitArrayBySize =
+  <A>(options: ChunkingOptions<A>) =>
+  (
+    items: EffectArray.NonEmptyReadonlyArray<A>,
+  ): Effect.Effect<EffectArray.NonEmptyArray<ReadonlyArray<A>>, OversizeChunkItemError> =>
+    Effect.gen(function* () {
+      const maxItems = Math.max(1, options.maxItems)
+      const maxBytes = Math.max(1, options.maxBytes)
+      const encode = options.encode
+      const measure = options.measure
+
+      const computeSize = (items: ReadonlyArray<A>) => {
+        if (measure !== undefined) {
+          return measure(items)
+        }
+
+        const encoded = encode(items)
+        return textEncoder.encode(JSON.stringify(encoded)).byteLength
+      }
+
+      const [first, ...rest] = items
+      let current: EffectArray.NonEmptyArray<A> = [first]
+      const result: EffectArray.NonEmptyArray<ReadonlyArray<A>> = [current]
+
+      if (computeSize(current) > maxBytes) {
+        return yield* new OversizeChunkItemError({ size: computeSize(current), maxBytes })
+      }
+
+      for (const item of rest) {
+        current.push(item)
+        const exceedsLimit = current.length > maxItems || computeSize(current) > maxBytes
+
+        if (exceedsLimit === true) {
+          // Remove the item we just added; the previous batch was already recorded in `result`.
+          current.splice(current.length - 1, 1)
+          current = [item]
+
+          const singleItemTooLarge = computeSize(current) > maxBytes
+          if (singleItemTooLarge === true || current.length > maxItems) {
+            return yield* new OversizeChunkItemError({ size: computeSize(current), maxBytes })
+          }
+
+          result.push(current)
+        }
+      }
+
+      return result
+    })

package/src/sync/validate-push-payload.ts

@@ -1,20 +1,18 @@
 import { Effect } from '@livestore/utils/effect'
 
 import { EventSequenceNumber, type LiveStoreEvent } from '../schema/mod.ts'
-import { InvalidPushError, ServerAheadError } from './sync.ts'
+import { ServerAheadError } from './sync.ts'
 
 // TODO proper batch validation
 export const validatePushPayload = (
-  batch: ReadonlyArray<LiveStoreEvent.AnyEncodedGlobal>,
-  currentEventSequenceNumber: EventSequenceNumber.GlobalEventSequenceNumber,
+  batch: ReadonlyArray<LiveStoreEvent.Global.Encoded>,
+  currentEventSequenceNumber: EventSequenceNumber.Global.Type,
 ) =>
   Effect.gen(function* () {
     if (batch[0]!.seqNum <= currentEventSequenceNumber) {
-      return yield* InvalidPushError.make({
-        cause: new ServerAheadError({
-          minimumExpectedNum: EventSequenceNumber.globalEventSequenceNumber(currentEventSequenceNumber + 1),
-          providedNum: EventSequenceNumber.globalEventSequenceNumber(batch[0]!.seqNum),
-        }),
+      return yield* new ServerAheadError({
+        minimumExpectedNum: EventSequenceNumber.Global.make(currentEventSequenceNumber + 1),
+        providedNum: EventSequenceNumber.Global.make(batch[0]!.seqNum),
       })
     }
   })

package/src/testing/event-factory.ts

@@ -33,9 +33,9 @@
 
 import { Schema } from '@livestore/utils/effect'
 
-import type { EventDef } from '../schema/EventDef.ts'
-import * as EventSequenceNumber from '../schema/EventSequenceNumber.ts'
-import * as LiveStoreEvent from '../schema/LiveStoreEvent.ts'
+import type { EventDef } from '../schema/EventDef/mod.ts'
+import * as EventSequenceNumber from '../schema/EventSequenceNumber/mod.ts'
+import * as LiveStoreEvent from '../schema/LiveStoreEvent/mod.ts'
 
 export interface ClientIdentity {
   clientId: string
@@ -80,7 +80,7 @@ export const makeFactory =
     client,
     startSeq = 1,
     initialParent = 'root',
-  }: EventFactoriesConfig): EventFactories<TDefs, LiveStoreEvent.AnyEncodedGlobal> => {
+  }: EventFactoriesConfig): EventFactories<TDefs, LiveStoreEvent.Global.Encoded> => {
     let nextSeq = startSeq
     let parentRef: SequenceValue = initialParent
 
@@ -95,7 +95,7 @@ export const makeFactory =
 
     const current = () => ({ seq: nextSeq, parent: parentRef })
 
-    const factories: Partial<EventFactories<TDefs, LiveStoreEvent.AnyEncodedGlobal>> = {}
+    const factories: Partial<EventFactories<TDefs, LiveStoreEvent.Global.Encoded>> = {}
 
     for (const [name, eventDef] of Object.entries(eventDefs) as [keyof TDefs, TDefs[keyof TDefs]][]) {
       const next = (args: EventFactoriesArgs<TDefs>[typeof name]) => {
@@ -103,14 +103,12 @@ export const makeFactory =
         const encodedArgs = Schema.encodeSync(eventDef.schema)(decoded.args)
         const encoded = eventDef.encoded(encodedArgs)
 
-        const event = LiveStoreEvent.AnyEncodedGlobal.make({
+        const event = LiveStoreEvent.Global.Encoded.make({
           name: encoded.name,
           args: encoded.args,
-          seqNum: EventSequenceNumber.globalEventSequenceNumber(nextSeq),
+          seqNum: EventSequenceNumber.Global.make(nextSeq),
           parentSeqNum:
-            parentRef === 'root'
-              ? EventSequenceNumber.ROOT.global
-              : EventSequenceNumber.globalEventSequenceNumber(parentRef),
+            parentRef === 'root' ? EventSequenceNumber.Client.ROOT.global : EventSequenceNumber.Global.make(parentRef),
           clientId: client.clientId,
           sessionId: client.sessionId,
         })
@@ -126,8 +124,8 @@ export const makeFactory =
         advanceTo,
         setParent,
         current,
-      } as EventFactories<TDefs, LiveStoreEvent.AnyEncodedGlobal>[typeof name]
+      } as EventFactories<TDefs, LiveStoreEvent.Global.Encoded>[typeof name]
     }
 
-    return factories as EventFactories<TDefs, LiveStoreEvent.AnyEncodedGlobal>
+    return factories as EventFactories<TDefs, LiveStoreEvent.Global.Encoded>
   }

package/src/util.ts

@@ -1,24 +1,33 @@
 /// <reference lib="es2022" />
 
-import type { Brand } from '@livestore/utils/effect'
-import { Schema } from '@livestore/utils/effect'
+import { type Brand, Schema } from '@livestore/utils/effect'
 
 export type ParamsObject = Record<string, SqlValue>
 export type SqlValue = string | number | Uint8Array<ArrayBuffer> | null
 
 export type Bindable = ReadonlyArray<SqlValue> | ParamsObject
 
-export const SqlValueSchema = Schema.Union(
+/**
+ * Numeric schema for the SQLite `REAL` domain. Unlike `Schema.Finite` it accepts
+ * `Infinity`/`NaN`, because SQLite `REAL` columns can legitimately store them and
+ * bind values / DEFAULT codecs must round-trip those through the devtools/debug
+ * protocol. This is the single carve-out for the SQLite REAL numeric domain — use it
+ * instead of a bare `Schema.Number` so the `schemaNumber` exception lives in one place.
+ */
+// @effect-diagnostics-next-line schemaNumber:off -- see SqliteReal docstring: SQLite REAL permits Infinity/NaN, so Schema.Finite would wrongly reject valid values
+export const SqliteReal = Schema.Number
+
+export const SqlValueSchema = Schema.Union([
   Schema.String,
-  Schema.Number,
-  Schema.Uint8Array as any as Schema.Schema<Uint8Array<ArrayBuffer>>,
+  SqliteReal,
+  Schema.Uint8Array as any as Schema.Codec<Uint8Array<ArrayBuffer>>,
   Schema.Null,
-)
+])
 
-export const PreparedBindValues = Schema.Union(
+export const PreparedBindValues = Schema.Union([
   Schema.Array(SqlValueSchema),
-  Schema.Record({ key: Schema.String, value: SqlValueSchema }),
-).pipe(Schema.brand('PreparedBindValues'))
+  Schema.Record(Schema.String, SqlValueSchema),
+]).pipe(Schema.brand('PreparedBindValues'))
 
 export type PreparedBindValues = Brand.Branded<Bindable, 'PreparedBindValues'>
 
@@ -47,11 +56,11 @@ export const sql = (template: TemplateStringsArray, ...args: unknown[]): string
  * TODO: Also make sure that the SQLite binding limit of 1000 is respected
  */
 export const prepareBindValues = (values: Bindable, statement: string): PreparedBindValues => {
-  if (Array.isArray(values)) return values as any as PreparedBindValues
+  if (Array.isArray(values) === true) return values as any as PreparedBindValues
 
   const result: ParamsObject = {}
   for (const [key, value] of Object.entries(values)) {
-    if (statement.includes(key)) {
+    if (statement.includes(key) === true) {
       result[`$${key}`] = value
     }
   }

package/src/version.ts

@@ -1,14 +1,38 @@
-// TODO bring back when Expo and Playwright supports `with` imports
-// import packageJson from '../package.json' with { type: 'json' }
-// export const liveStoreVersion = packageJson.version
+import pkg from '../package.json' with { type: 'json' }
 
-export const liveStoreVersion = '0.4.0-dev.9' as const
+/**
+ * Current LiveStore package version used for display, release assets, and install guidance.
+ *
+ * Can be overridden at runtime via `globalThis.__LIVESTORE_VERSION_OVERRIDE__` for testing display-only version values.
+ */
+export const liveStoreVersion: string = (globalThis as any).__LIVESTORE_VERSION_OVERRIDE__ ?? pkg.version
+
+export const devtoolsProtocolVersion: number = (globalThis as any).__LIVESTORE_DEVTOOLS_PROTOCOL_VERSION_OVERRIDE__ ?? 1
+
+export const supportedDevtoolsProtocolVersions: ReadonlyArray<number> = [devtoolsProtocolVersion]
+
+export const resolveDevtoolsProtocolVersion = (version: number | undefined): number => version ?? 1
+
+export const isDevtoolsProtocolVersionSupported = (
+  version: number | undefined,
+  supportedVersions: ReadonlyArray<number> = supportedDevtoolsProtocolVersions,
+): boolean => supportedVersions.includes(resolveDevtoolsProtocolVersion(version))
 
 /**
- * This version number is incremented whenever the internal storage format changes in a breaking way.
- * Whenever this version changes, LiveStore will start with fresh database files. Old database files are not deleted.
+ * CRITICAL: Increment this version whenever you modify client-side EVENTLOG table schemas.
+ *
+ * Used to generate database file names (e.g., `eventlog@6.db`, `state@6.db`) across all client adapters.
+ *
+ * Bump required when:
+ * - Modifying eventlog system tables (eventlogMetaTable, syncStatusTable) in schema/state/sqlite/system-tables/eventlog-tables.ts
+ * - Changing columns, types, constraints, or indexes in eventlog tables
+ *
+ * Bump NOT required when:
+ * - Modifying STATE table schemas (auto-migrated via hash-based detection and rebuilt from eventlog)
+ * - Changing query patterns or client-side implementation details
+ *
+ * ⚠️  CRITICAL: Eventlog changes without bumping this version cause permanent data loss!
  *
- * While LiveStore is in beta, this might happen more frequently.
- * In the future, LiveStore will provide a migration path for older database files to avoid the impression of data loss.
+ * Impact: Version changes trigger a "soft reset" - old data becomes inaccessible but remains on disk.
  */
 export const liveStoreStorageFormatVersion = 6

package/dist/schema/EventDef.d.ts

@@ -1,126 +0,0 @@
-import type { SingleOrReadonlyArray } from '@livestore/utils';
-import { Schema } from '@livestore/utils/effect';
-import type { BindValues } from '../sql-queries/sql-queries.ts';
-import type { ParamsObject } from '../util.ts';
-import type * as LiveStoreEvent from './LiveStoreEvent.ts';
-import type { QueryBuilder } from './state/sqlite/query-builder/mod.ts';
-export type EventDefMap = {
-    map: Map<string, EventDef.Any>;
-};
-export type EventDefRecord = {
-    [name: string]: EventDef.Any;
-};
-export type EventDef<TName extends string, TType, TEncoded = TType, TDerived extends boolean = false> = {
-    name: TName;
-    schema: Schema.Schema<TType, TEncoded>;
-    options: {
-        /**
-         * When set to true, the mutation won't be synced across clients but
-         */
-        clientOnly: boolean;
-        /** Warning: This feature is not fully implemented yet */
-        facts: FactsCallback<TType> | undefined;
-        derived: TDerived;
-    };
-    /** Helper function to construct a partial event */
-    (args: TType): {
-        name: TName;
-        args: TType;
-    };
-    /** Helper function to construct a partial encoded event */
-    encoded: (args: TEncoded) => {
-        name: TName;
-        args: TEncoded;
-    };
-    readonly Event: {
-        name: TName;
-        args: TType;
-    };
-};
-export type FactsCallback<TTo> = (args: TTo, currentFacts: EventDefFacts) => {
-    modify: {
-        set: Iterable<EventDefFactInput>;
-        unset: Iterable<EventDefFactInput>;
-    };
-    require: Iterable<EventDefFactInput>;
-};
-export declare namespace EventDef {
-    type Any = EventDef<string, any, any, boolean>;
-    type AnyWithoutFn = Pick<Any, 'name' | 'schema' | 'options'>;
-}
-export type EventDefKey = string;
-export type EventDefFact = string;
-export type EventDefFacts = ReadonlyMap<string, any>;
-export type EventDefFactsGroup = {
-    modifySet: EventDefFacts;
-    modifyUnset: EventDefFacts;
-    /**
-     * Events on independent "dependency" branches are commutative which can facilitate more prioritized syncing
-     */
-    depRequire: EventDefFacts;
-    depRead: EventDefFacts;
-};
-export type EventDefFactsSnapshot = Map<string, any>;
-export type EventDefFactInput = string | readonly [string, any];
-export declare const defineFacts: <TRecord extends Record<string, EventDefFactInput | ((...args: any[]) => EventDefFactInput)>>(record: TRecord) => TRecord;
-export type DefineEventOptions<TTo, TDerived extends boolean = false> = {
-    /** Warning: This feature is not fully implemented yet */
-    facts?: (args: TTo, currentFacts: EventDefFacts) => {
-        modify?: {
-            set?: Iterable<EventDefFactInput>;
-            unset?: Iterable<EventDefFactInput>;
-        };
-        /**
-         * Two purposes: constrain history and constrain compaction
-         */
-        require?: Iterable<EventDefFactInput>;
-    };
-    /**
-     * When set to true, the event won't be synced over the network
-     */
-    clientOnly?: boolean;
-    derived?: TDerived;
-};
-export declare const defineEvent: <TName extends string, TType, TEncoded = TType, TDerived extends boolean = false>(args: {
-    name: TName;
-    schema: Schema.Schema<TType, TEncoded>;
-} & DefineEventOptions<TType, TDerived>) => EventDef<TName, TType, TEncoded, TDerived>;
-export declare const synced: <TName extends string, TType, TEncoded = TType>(args: {
-    name: TName;
-    schema: Schema.Schema<TType, TEncoded>;
-} & Omit<DefineEventOptions<TType, false>, "derived" | "clientOnly">) => EventDef<TName, TType, TEncoded>;
-export declare const clientOnly: <TName extends string, TType, TEncoded = TType>(args: {
-    name: TName;
-    schema: Schema.Schema<TType, TEncoded>;
-} & Omit<DefineEventOptions<TType, false>, "derived" | "clientOnly">) => EventDef<TName, TType, TEncoded>;
-export type MaterializerResult = {
-    sql: string;
-    bindValues: BindValues;
-    writeTables?: ReadonlySet<string>;
-} | QueryBuilder.Any | string;
-export type MaterializerContextQuery = {
-    (args: {
-        query: string;
-        bindValues: ParamsObject;
-    }): ReadonlyArray<unknown>;
-    <TResult>(qb: QueryBuilder<TResult, any, any>): TResult;
-};
-export type Materializer<TEventDef extends EventDef.AnyWithoutFn = EventDef.AnyWithoutFn> = (event: TEventDef['schema']['Type'], context: {
-    currentFacts: EventDefFacts;
-    eventDef: TEventDef;
-    /** Can be used to query the current state */
-    query: MaterializerContextQuery;
-    /** The full LiveStore event with clientId, sessionId, etc. */
-    event: LiveStoreEvent.AnyDecoded;
-}) => SingleOrReadonlyArray<MaterializerResult>;
-export declare const defineMaterializer: <TEventDef extends EventDef.AnyWithoutFn>(_eventDef: TEventDef, materializer: Materializer<TEventDef>) => Materializer<TEventDef>;
-export declare const materializers: <TInputRecord extends Record<string, EventDef.AnyWithoutFn>>(_eventDefRecord: TInputRecord, handlers: { [TEventName in TInputRecord[keyof TInputRecord]["name"] as Extract<TInputRecord[keyof TInputRecord], {
-    name: TEventName;
-}>["options"]["derived"] extends true ? never : TEventName]: Materializer<Extract<TInputRecord[keyof TInputRecord], {
-    name: TEventName;
-}>>; }) => { [TEventName in TInputRecord[keyof TInputRecord]["name"] as Extract<TInputRecord[keyof TInputRecord], {
-    name: TEventName;
-}>["options"]["derived"] extends true ? never : TEventName]: Materializer<Extract<TInputRecord[keyof TInputRecord], {
-    name: TEventName;
-}>>; };
-//# sourceMappingURL=EventDef.d.ts.map

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

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

package/dist/schema/EventDef.js

@@ -1,46 +0,0 @@
-import { shouldNeverHappen } from '@livestore/utils';
-import { Schema } from '@livestore/utils/effect';
-export const defineFacts = (record) => record;
-export const defineEvent = (args) => {
-    const { name, schema, ...options } = args;
-    const makePartialEvent = (args) => {
-        const res = Schema.validateEither(schema)(args);
-        if (res._tag === 'Left') {
-            shouldNeverHappen(`Invalid event args for event '${name}':`, res.left.message, '\n');
-        }
-        return { name: name, args };
-    };
-    Object.defineProperty(makePartialEvent, 'name', { value: name });
-    Object.defineProperty(makePartialEvent, 'schema', { value: schema });
-    Object.defineProperty(makePartialEvent, 'encoded', {
-        value: (args) => ({ name: name, args }),
-    });
-    Object.defineProperty(makePartialEvent, 'options', {
-        value: {
-            clientOnly: options?.clientOnly ?? false,
-            facts: options?.facts
-                ? (args, currentFacts) => {
-                    const res = options.facts(args, currentFacts);
-                    return {
-                        modify: {
-                            set: res.modify?.set ? new Set(res.modify.set) : new Set(),
-                            unset: res.modify?.unset ? new Set(res.modify.unset) : new Set(),
-                        },
-                        require: res.require ? new Set(res.require) : new Set(),
-                    };
-                }
-                : undefined,
-            derived: options?.derived ?? false,
-        },
-    });
-    return makePartialEvent;
-};
-export const synced = (args) => defineEvent({ ...args, clientOnly: false });
-export const clientOnly = (args) => defineEvent({ ...args, clientOnly: true });
-export const defineMaterializer = (_eventDef, materializer) => {
-    return materializer;
-};
-export const materializers = (_eventDefRecord, handlers) => {
-    return handlers;
-};
-//# sourceMappingURL=EventDef.js.map

package/dist/schema/EventDef.js.map

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

package/dist/schema/EventSequenceNumber.d.ts

@@ -1,80 +0,0 @@
-import { Brand, Schema } from '@livestore/utils/effect';
-export type ClientEventSequenceNumber = Brand.Branded<number, 'ClientEventSequenceNumber'>;
-export declare const localEventSequenceNumber: Brand.Brand.Constructor<ClientEventSequenceNumber>;
-export declare const ClientEventSequenceNumber: Schema.BrandSchema<number & Brand.Brand<"ClientEventSequenceNumber">, number, never>;
-export type GlobalEventSequenceNumber = Brand.Branded<number, 'GlobalEventSequenceNumber'>;
-export declare const globalEventSequenceNumber: Brand.Brand.Constructor<GlobalEventSequenceNumber>;
-export declare const GlobalEventSequenceNumber: Schema.BrandSchema<number & Brand.Brand<"GlobalEventSequenceNumber">, number, never>;
-export declare const clientDefault: ClientEventSequenceNumber;
-export declare const rebaseGenerationDefault = 0;
-/**
- * LiveStore event sequence number value consisting of a globally unique event sequence number
- * and a client sequence number.
- *
- * The client sequence number is only used for clientOnly events and starts from 0 for each global sequence number.
- */
-export type EventSequenceNumber = {
-    global: GlobalEventSequenceNumber;
-    client: ClientEventSequenceNumber;
-    /**
-     * Generation integer that is incremented whenever the client rebased.
-     * Starts from and resets to 0 for each global sequence number.
-     */
-    rebaseGeneration: number;
-};
-export type EventSequenceNumberInput = EventSequenceNumber | (Omit<typeof EventSequenceNumber.Encoded, 'rebaseGeneration'> & {
-    rebaseGeneration?: number;
-});
-/**
- * NOTE: Client mutation events with a non-0 client id, won't be synced to the sync backend.
- */
-export declare const EventSequenceNumber: Schema.Struct<{
-    global: Schema.BrandSchema<number & Brand.Brand<"GlobalEventSequenceNumber">, number, never>;
-    /** Only increments for clientOnly events */
-    client: Schema.BrandSchema<number & Brand.Brand<"ClientEventSequenceNumber">, number, never>;
-    rebaseGeneration: typeof Schema.Int;
-}>;
-/**
- * Compare two event sequence numbers i.e. checks if the first event sequence number is less than the second.
- * Comparison hierarchy: global > client > rebaseGeneration
- */
-export declare const compare: (a: EventSequenceNumber, b: EventSequenceNumber) => number;
-/**
- * Convert an event sequence number to a string representation.
- */
-export declare const toString: (seqNum: EventSequenceNumber) => string;
-/**
- * Convert a string representation of an event sequence number to an event sequence number.
- * Parses strings in the format: e{global}[+{client}][r{rebaseGeneration}]
- * Examples: "e0", "e0r1", "e0+1", "e0+1r1"
- */
-export declare const fromString: (str: string) => EventSequenceNumber;
-export declare const fromGlobal: (seqNum: GlobalEventSequenceNumber) => {
-    global: GlobalEventSequenceNumber;
-    client: ClientEventSequenceNumber;
-    rebaseGeneration: number;
-};
-export declare const isEqual: (a: EventSequenceNumber, b: EventSequenceNumber) => boolean;
-export type EventSequenceNumberPair = {
-    seqNum: EventSequenceNumber;
-    parentSeqNum: EventSequenceNumber;
-};
-export declare const ROOT: {
-    global: GlobalEventSequenceNumber;
-    client: ClientEventSequenceNumber;
-    rebaseGeneration: number;
-};
-export declare const isGreaterThan: (a: EventSequenceNumber, b: EventSequenceNumber) => boolean;
-export declare const isGreaterThanOrEqual: (a: EventSequenceNumber, b: EventSequenceNumber) => boolean;
-export declare const max: (a: EventSequenceNumber, b: EventSequenceNumber) => EventSequenceNumber;
-export declare const diff: (a: EventSequenceNumber, b: EventSequenceNumber) => {
-    global: number;
-    client: number;
-};
-export declare const make: (seqNum: EventSequenceNumberInput) => EventSequenceNumber;
-export declare const nextPair: ({ seqNum, isClient, rebaseGeneration, }: {
-    seqNum: EventSequenceNumber;
-    isClient: boolean;
-    rebaseGeneration?: number;
-}) => EventSequenceNumberPair;
-//# sourceMappingURL=EventSequenceNumber.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"EventSequenceNumber.d.ts","sourceRoot":"","sources":["../../src/schema/EventSequenceNumber.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAEvD,MAAM,MAAM,yBAAyB,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAA;AAC1F,eAAO,MAAM,wBAAwB,oDAA6C,CAAA;AAClF,eAAO,MAAM,yBAAyB,sFAAyD,CAAA;AAE/F,MAAM,MAAM,yBAAyB,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAA;AAC1F,eAAO,MAAM,yBAAyB,oDAA6C,CAAA;AACnF,eAAO,MAAM,yBAAyB,sFAA0D,CAAA;AAEhG,eAAO,MAAM,aAAa,EAAe,yBAAyB,CAAA;AAElE,eAAO,MAAM,uBAAuB,IAAI,CAAA;AAExC;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,yBAAyB,CAAA;IACjC,MAAM,EAAE,yBAAyB,CAAA;IACjC;;;OAGG;IACH,gBAAgB,EAAE,MAAM,CAAA;CACzB,CAAA;AAED,MAAM,MAAM,wBAAwB,GAChC,mBAAmB,GACnB,CAAC,IAAI,CAAC,OAAO,mBAAmB,CAAC,OAAO,EAAE,kBAAkB,CAAC,GAAG;IAAE,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AAGlG;;GAEG;AACH,eAAO,MAAM,mBAAmB;;IAE9B,4CAA4C;;;EAU5C,CAAA;AAEF;;;GAGG;AACH,eAAO,MAAM,OAAO,GAAI,GAAG,mBAAmB,EAAE,GAAG,mBAAmB,WAQrE,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ,GAAI,QAAQ,mBAAmB,WAKnD,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,KAAK,MAAM,KAAG,mBAyCxC,CAAA;AAED,eAAO,MAAM,UAAU,GAAI,QAAQ,yBAAyB;;;;CAI1D,CAAA;AAEF,eAAO,MAAM,OAAO,GAAI,GAAG,mBAAmB,EAAE,GAAG,mBAAmB,YACuB,CAAA;AAE7F,MAAM,MAAM,uBAAuB,GAAG;IAAE,MAAM,EAAE,mBAAmB,CAAC;IAAC,YAAY,EAAE,mBAAmB,CAAA;CAAE,CAAA;AAExG,eAAO,MAAM,IAAI;YACK,yBAAyB;;;CAGhB,CAAA;AAE/B,eAAO,MAAM,aAAa,GAAI,GAAG,mBAAmB,EAAE,GAAG,mBAAmB,YAE3E,CAAA;AAED,eAAO,MAAM,oBAAoB,GAAI,GAAG,mBAAmB,EAAE,GAAG,mBAAmB,YAElF,CAAA;AAED,eAAO,MAAM,GAAG,GAAI,GAAG,mBAAmB,EAAE,GAAG,mBAAmB,wBAEjE,CAAA;AAED,eAAO,MAAM,IAAI,GAAI,GAAG,mBAAmB,EAAE,GAAG,mBAAmB;;;CAKlE,CAAA;AAED,eAAO,MAAM,IAAI,GAAI,QAAQ,wBAAwB,KAAG,mBAOvD,CAAA;AAED,eAAO,MAAM,QAAQ,GAAI,yCAItB;IACD,MAAM,EAAE,mBAAmB,CAAA;IAC3B,QAAQ,EAAE,OAAO,CAAA;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B,KAAG,uBAqBH,CAAA"}