@livestore/common 0.4.0-dev.1 → 0.4.0-dev.10

package/dist/sync/sync-backend-kv.js

@@ -0,0 +1,18 @@
+import { Effect, KeyValueStore, Option } from '@livestore/utils/effect';
+import { UnexpectedError } from "../errors.js";
+export const makeBackendIdHelper = Effect.gen(function* () {
+    const kv = yield* KeyValueStore.KeyValueStore;
+    const backendIdKey = `backendId`;
+    const backendIdRef = { current: yield* kv.get(backendIdKey).pipe(UnexpectedError.mapToUnexpectedError) };
+    const setBackendId = (backendId) => Effect.gen(function* () {
+        if (backendIdRef.current._tag === 'None' || backendIdRef.current.value !== backendId) {
+            backendIdRef.current = Option.some(backendId);
+            yield* kv.set(backendIdKey, backendId);
+        }
+    }).pipe(UnexpectedError.mapToUnexpectedError);
+    return {
+        lazySet: setBackendId,
+        get: () => backendIdRef.current,
+    };
+});
+//# sourceMappingURL=sync-backend-kv.js.map

package/dist/sync/sync-backend-kv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-backend-kv.js","sourceRoot":"","sources":["../../src/sync/sync-backend-kv.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAE9C,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IACrD,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,aAAa,CAAC,aAAa,CAAA;IAE7C,MAAM,YAAY,GAAG,WAAW,CAAA;IAChC,MAAM,YAAY,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,oBAAoB,CAAC,EAAE,CAAA;IAExG,MAAM,YAAY,GAAG,CAAC,SAAiB,EAAE,EAAE,CACzC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,IAAI,YAAY,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM,IAAI,YAAY,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YACrF,YAAY,CAAC,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;YAC7C,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,YAAY,EAAE,SAAS,CAAC,CAAA;QACxC,CAAC;IACH,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,oBAAoB,CAAC,CAAA;IAE/C,OAAO;QACL,OAAO,EAAE,YAAY;QACrB,GAAG,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO;KAChC,CAAA;AACH,CAAC,CAAC,CAAA"}

package/dist/sync/sync-backend.d.ts

@@ -0,0 +1,105 @@
+import { type Cause, type Effect, type HttpClient, type KeyValueStore, Option, Schema, type Scope, type Stream, type SubscriptionRef } from '@livestore/utils/effect';
+import type { UnexpectedError } from '../adapter-types.ts';
+import type * as LiveStoreEvent from '../schema/LiveStoreEvent.ts';
+import type { EventSequenceNumber } from '../schema/mod.ts';
+import type { InvalidPullError, InvalidPushError, IsOfflineError } from './errors.ts';
+export * from './sync-backend-kv.ts';
+/**
+ * Those arguments can be used to implement multi-tenancy etc and are passed in from the store.
+ */
+export type MakeBackendArgs = {
+    storeId: string;
+    clientId: string;
+    payload: Schema.JsonValue | undefined;
+};
+export type SyncBackendConstructor<TSyncMetadata = Schema.JsonValue> = (args: MakeBackendArgs) => Effect.Effect<SyncBackend<TSyncMetadata>, UnexpectedError, Scope.Scope | HttpClient.HttpClient | KeyValueStore.KeyValueStore>;
+export type SyncBackend<TSyncMetadata = Schema.JsonValue> = {
+    /**
+     * Can be implemented to prepare a connection to the sync backend to speed up the first pull/push.
+     */
+    connect: Effect.Effect<void, IsOfflineError | UnexpectedError, Scope.Scope>;
+    pull: (cursor: Option.Option<{
+        eventSequenceNumber: EventSequenceNumber.GlobalEventSequenceNumber;
+        /** Metadata is needed by some sync backends */
+        metadata: Option.Option<TSyncMetadata>;
+    }>, options?: {
+        /**
+         * If true, the sync backend will return a stream of events that have been pushed after the cursor.
+         *
+         * @default false
+         */
+        live?: boolean;
+    }) => Stream.Stream<PullResItem<TSyncMetadata>, IsOfflineError | InvalidPullError>;
+    push: (
+    /**
+     * Constraints for batch:
+     * - Number of events: 1-100
+     * - sequence numbers must be in ascending order
+     * */
+    batch: ReadonlyArray<LiveStoreEvent.AnyEncodedGlobal>) => Effect.Effect<void, IsOfflineError | InvalidPushError>;
+    ping: Effect.Effect<void, IsOfflineError | UnexpectedError | Cause.TimeoutException>;
+    isConnected: SubscriptionRef.SubscriptionRef<boolean>;
+    /**
+     * Metadata describing the sync backend. (Currently only used by devtools.)
+     */
+    metadata: {
+        name: string;
+        description: string;
+    } & Record<string, Schema.JsonValue>;
+    /** Information about the sync backend capabilities. */
+    supports: {
+        /**
+         * Whether the sync backend supports the `hasMore` field in the pull response.
+         */
+        pullPageInfoKnown: boolean;
+        /**
+         * Whether the sync backend supports the `live` option for the pull method and thus
+         * long-lived, reactive pull streams.
+         */
+        pullLive: boolean;
+    };
+};
+/**
+ * Connectivity metadata emitted by sync backends.
+ */
+export declare const NetworkStatus: Schema.Struct<{
+    /** True when the upstream sync backend is reachable and responding to health checks. */
+    isConnected: typeof Schema.Boolean;
+    /** Unix epoch timestamp (ms) of the latest connectivity state transition. */
+    timestampMs: typeof Schema.Number;
+    /** Devtools specific metadata describing simulator overrides. */
+    devtools: Schema.Struct<{
+        /** Indicates whether the devtools latch forced the client into an offline state. */
+        latchClosed: typeof Schema.Boolean;
+    }>;
+}>;
+export type NetworkStatus = typeof NetworkStatus.Type;
+/**
+ * Runtime type guard for SyncBackend objects.
+ * Performs lightweight structural checks on the object shape.
+ */
+export declare const isSyncBackend: (value: unknown) => value is SyncBackend<any>;
+export declare const PullResPageInfo: Schema.Union<[Schema.TaggedStruct<"MoreUnknown", {}>, Schema.TaggedStruct<"MoreKnown", {
+    remaining: typeof Schema.Number;
+}>, Schema.TaggedStruct<"NoMore", {}>]>;
+export type PullResPageInfo = typeof PullResPageInfo.Type;
+export declare const pageInfoNoMore: PullResPageInfo;
+export declare const pageInfoMoreUnknown: PullResPageInfo;
+export declare const pageInfoMoreKnown: (remaining: number) => PullResPageInfo;
+export declare const pullResItemEmpty: <TSyncMetadata = Schema.JsonValue>() => PullResItem<TSyncMetadata>;
+export interface PullResItem<TSyncMetadata = Schema.JsonValue> {
+    batch: ReadonlyArray<{
+        eventEncoded: LiveStoreEvent.AnyEncodedGlobal;
+        metadata: Option.Option<TSyncMetadata>;
+    }>;
+    pageInfo: PullResPageInfo;
+}
+export declare const of: <TSyncMetadata = Schema.JsonValue>(obj: SyncBackend<TSyncMetadata>) => SyncBackend<TSyncMetadata>;
+/**
+ * Useful to continue pulling from the last event in the batch.
+ */
+export declare const cursorFromPullResItem: <TSyncMetadata = Schema.JsonValue>(item: PullResItem<TSyncMetadata>) => Option.Option<{
+    eventSequenceNumber: EventSequenceNumber.GlobalEventSequenceNumber;
+    metadata: Option.Option<TSyncMetadata>;
+}>;
+//# sourceMappingURL=sync-backend.d.ts.map

package/dist/sync/sync-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-backend.d.ts","sourceRoot":"","sources":["../../src/sync/sync-backend.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,KAAK,EACV,KAAK,MAAM,EACX,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,MAAM,EACN,MAAM,EACN,KAAK,KAAK,EACV,KAAK,MAAM,EACX,KAAK,eAAe,EACrB,MAAM,yBAAyB,CAAA;AAChC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,KAAK,KAAK,cAAc,MAAM,6BAA6B,CAAA;AAClE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAErF,cAAc,sBAAsB,CAAA;AAEpC;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAC,SAAS,GAAG,SAAS,CAAA;CACtC,CAAA;AAGD,MAAM,MAAM,sBAAsB,CAAC,aAAa,GAAG,MAAM,CAAC,SAAS,IAAI,CACrE,IAAI,EAAE,eAAe,KAClB,MAAM,CAAC,MAAM,CAChB,WAAW,CAAC,aAAa,CAAC,EAC1B,eAAe,EACf,KAAK,CAAC,KAAK,GAAG,UAAU,CAAC,UAAU,GAAG,aAAa,CAAC,aAAa,CAClE,CAAA;AASD,MAAM,MAAM,WAAW,CAAC,aAAa,GAAG,MAAM,CAAC,SAAS,IAAI;IAC1D;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,GAAG,eAAe,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IAC3E,IAAI,EAAE,CACJ,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;QACpB,mBAAmB,EAAE,mBAAmB,CAAC,yBAAyB,CAAA;QAClE,+CAA+C;QAC/C,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAA;KACvC,CAAC,EACF,OAAO,CAAC,EAAE;QACR;;;;WAIG;QACH,IAAI,CAAC,EAAE,OAAO,CAAA;KACf,KACE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,aAAa,CAAC,EAAE,cAAc,GAAG,gBAAgB,CAAC,CAAA;IAEjF,IAAI,EAAE;IACJ;;;;SAIK;IACL,KAAK,EAAE,aAAa,CAAC,cAAc,CAAC,gBAAgB,CAAC,KAClD,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,GAAG,gBAAgB,CAAC,CAAA;IAC3D,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,GAAG,eAAe,GAAG,KAAK,CAAC,gBAAgB,CAAC,CAAA;IAEpF,WAAW,EAAE,eAAe,CAAC,eAAe,CAAC,OAAO,CAAC,CAAA;IACrD;;OAEG;IACH,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,CAAA;IAClF,uDAAuD;IACvD,QAAQ,EAAE;QACR;;WAEG;QACH,iBAAiB,EAAE,OAAO,CAAA;QAC1B;;;WAGG;QACH,QAAQ,EAAE,OAAO,CAAA;KAClB,CAAA;CACF,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,aAAa;IACxB,wFAAwF;;IAExF,6EAA6E;;IAE7E,iEAAiE;;QAE/D,oFAAoF;;;EAG9C,CAAA;AAE1C,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC,IAAI,CAAA;AAErD;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,WAAW,CAAC,GAAG,CAyBtE,CAAA;AAED,eAAO,MAAM,eAAe;;uCAM3B,CAAA;AAED,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC,IAAI,CAAA;AAEzD,eAAO,MAAM,cAAc,EAAE,eAA6C,CAAA;AAC1E,eAAO,MAAM,mBAAmB,EAAE,eAAkD,CAAA;AACpF,eAAO,MAAM,iBAAiB,GAAI,WAAW,MAAM,KAAG,eAAqD,CAAA;AAE3G,eAAO,MAAM,gBAAgB,GAAI,aAAa,GAAG,MAAM,CAAC,SAAS,OAAK,WAAW,CAAC,aAAa,CAG7F,CAAA;AAEF,MAAM,WAAW,WAAW,CAAC,aAAa,GAAG,MAAM,CAAC,SAAS;IAC3D,KAAK,EAAE,aAAa,CAAC;QACnB,YAAY,EAAE,cAAc,CAAC,gBAAgB,CAAA;QAC7C,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAA;KACvC,CAAC,CAAA;IACF,QAAQ,EAAE,eAAe,CAAA;CAC1B;AAED,eAAO,MAAM,EAAE,GAAI,aAAa,GAAG,MAAM,CAAC,SAAS,EAAE,KAAK,WAAW,CAAC,aAAa,CAAC,+BAAQ,CAAA;AAE5F;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAAI,aAAa,GAAG,MAAM,CAAC,SAAS,EACpE,MAAM,WAAW,CAAC,aAAa,CAAC,KAC/B,MAAM,CAAC,MAAM,CAAC;IACf,mBAAmB,EAAE,mBAAmB,CAAC,yBAAyB,CAAA;IAClE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAA;CACvC,CAMA,CAAA"}

package/dist/sync/sync-backend.js

@@ -0,0 +1,61 @@
+import { Option, Schema, } from '@livestore/utils/effect';
+export * from "./sync-backend-kv.js";
+/**
+ * Connectivity metadata emitted by sync backends.
+ */
+export const NetworkStatus = Schema.Struct({
+    /** True when the upstream sync backend is reachable and responding to health checks. */
+    isConnected: Schema.Boolean,
+    /** Unix epoch timestamp (ms) of the latest connectivity state transition. */
+    timestampMs: Schema.Number,
+    /** Devtools specific metadata describing simulator overrides. */
+    devtools: Schema.Struct({
+        /** Indicates whether the devtools latch forced the client into an offline state. */
+        latchClosed: Schema.Boolean,
+    }),
+}).annotations({ title: 'NetworkStatus' });
+/**
+ * Runtime type guard for SyncBackend objects.
+ * Performs lightweight structural checks on the object shape.
+ */
+export const isSyncBackend = (value) => {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const v = value;
+    const hasCoreFns = typeof v.connect === 'function' &&
+        typeof v.pull === 'function' &&
+        typeof v.push === 'function' &&
+        typeof v.ping === 'function';
+    const hasSupports = typeof v.supports === 'object' &&
+        v.supports !== null &&
+        typeof v.supports.pullPageInfoKnown === 'boolean' &&
+        typeof v.supports.pullLive === 'boolean';
+    const hasMetadata = typeof v.metadata === 'object' &&
+        v.metadata !== null &&
+        typeof v.metadata.name === 'string' &&
+        typeof v.metadata.description === 'string';
+    const hasIsConnected = typeof v.isConnected === 'object' && v.isConnected !== null;
+    return hasCoreFns && hasSupports && hasMetadata && hasIsConnected;
+};
+export const PullResPageInfo = Schema.Union(Schema.TaggedStruct('MoreUnknown', {}), Schema.TaggedStruct('MoreKnown', {
+    remaining: Schema.Number,
+}), Schema.TaggedStruct('NoMore', {}));
+export const pageInfoNoMore = { _tag: 'NoMore' };
+export const pageInfoMoreUnknown = { _tag: 'MoreUnknown' };
+export const pageInfoMoreKnown = (remaining) => ({ _tag: 'MoreKnown', remaining });
+export const pullResItemEmpty = () => ({
+    batch: [],
+    pageInfo: pageInfoNoMore,
+});
+export const of = (obj) => obj;
+/**
+ * Useful to continue pulling from the last event in the batch.
+ */
+export const cursorFromPullResItem = (item) => {
+    const lastEvent = item.batch.at(-1);
+    if (!lastEvent) {
+        return Option.none();
+    }
+    return Option.some({ eventSequenceNumber: lastEvent.eventEncoded.seqNum, metadata: lastEvent.metadata });
+};
+//# sourceMappingURL=sync-backend.js.map

package/dist/sync/sync-backend.js.map

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

package/dist/sync/sync.d.ts

@@ -1,17 +1,7 @@
-import type { Effect, HttpClient, Option, Scope, Stream, SubscriptionRef } from '@livestore/utils/effect';
-import { Schema } from '@livestore/utils/effect';
-import type { UnexpectedError } from '../adapter-types.ts';
+export * from './errors.ts';
+export * as SyncBackend from './sync-backend.ts';
 import type { InitialSyncOptions } from '../leader-thread/types.ts';
-import * as EventSequenceNumber from '../schema/EventSequenceNumber.ts';
-import type * as LiveStoreEvent from '../schema/LiveStoreEvent.ts';
-/**
- * Those arguments can be used to implement multi-tenancy etc and are passed in from the store.
- */
-export type MakeBackendArgs = {
-    storeId: string;
-    clientId: string;
-    payload: Schema.JsonValue | undefined;
-};
+import type { SyncBackendConstructor } from './sync-backend.ts';
 export type SyncOptions = {
     backend?: SyncBackendConstructor<any>;
     /** @default { _tag: 'Skip' } */
@@ -26,78 +16,10 @@ export type SyncOptions = {
      * @default 'ignore'
      * */
     onSyncError?: 'shutdown' | 'ignore';
-};
-export type SyncBackendConstructor<TSyncMetadata = Schema.JsonValue> = (args: MakeBackendArgs) => Effect.Effect<SyncBackend<TSyncMetadata>, UnexpectedError, Scope.Scope | HttpClient.HttpClient>;
-export type SyncBackend<TSyncMetadata = Schema.JsonValue> = {
-    /**
-     * Can be implemented to prepare a connection to the sync backend to speed up the first pull/push.
-     */
-    connect: Effect.Effect<void, IsOfflineError | UnexpectedError, HttpClient.HttpClient | Scope.Scope>;
-    pull: (args: Option.Option<{
-        cursor: EventSequenceNumber.EventSequenceNumber;
-        metadata: Option.Option<TSyncMetadata>;
-    }>) => Stream.Stream<{
-        batch: ReadonlyArray<{
-            eventEncoded: LiveStoreEvent.AnyEncodedGlobal;
-            metadata: Option.Option<TSyncMetadata>;
-        }>;
-        remaining: number;
-    }, IsOfflineError | InvalidPullError, HttpClient.HttpClient>;
-    push: (
-    /**
-     * Constraints for batch:
-     * - Number of events: 1-100
-     * - sequence numbers must be in ascending order
-     * */
-    batch: ReadonlyArray<LiveStoreEvent.AnyEncodedGlobal>) => Effect.Effect<void, IsOfflineError | InvalidPushError, HttpClient.HttpClient>;
-    isConnected: SubscriptionRef.SubscriptionRef<boolean>;
     /**
-     * Metadata describing the sync backend. (Currently only used by devtools.)
+     * Whether the sync backend should reactively pull new events from the sync backend
+     * @default true
      */
-    metadata: {
-        name: string;
-        description: string;
-    } & Record<string, Schema.JsonValue>;
+    livePull?: boolean;
 };
-declare const IsOfflineError_base: Schema.TaggedErrorClass<IsOfflineError, "IsOfflineError", {
-    readonly _tag: Schema.tag<"IsOfflineError">;
-}>;
-export declare class IsOfflineError extends IsOfflineError_base {
-}
-declare const InvalidPushError_base: Schema.TaggedErrorClass<InvalidPushError, "InvalidPushError", {
-    readonly _tag: Schema.tag<"InvalidPushError">;
-} & {
-    reason: Schema.Union<[Schema.TaggedStruct<"Unexpected", {
-        message: typeof Schema.String;
-    }>, Schema.TaggedStruct<"ServerAhead", {
-        minimumExpectedNum: typeof Schema.Number;
-        providedNum: typeof Schema.Number;
-    }>]>;
-}>;
-export declare class InvalidPushError extends InvalidPushError_base {
-}
-declare const InvalidPullError_base: Schema.TaggedErrorClass<InvalidPullError, "InvalidPullError", {
-    readonly _tag: Schema.tag<"InvalidPullError">;
-} & {
-    message: typeof Schema.String;
-}>;
-export declare class InvalidPullError extends InvalidPullError_base {
-}
-declare const LeaderAheadError_base: Schema.TaggedErrorClass<LeaderAheadError, "LeaderAheadError", {
-    readonly _tag: Schema.tag<"LeaderAheadError">;
-} & {
-    minimumExpectedNum: 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;
-    }>;
-    providedNum: 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;
-    }>;
-}>;
-export declare class LeaderAheadError extends LeaderAheadError_base {
-}
-export {};
 //# sourceMappingURL=sync.d.ts.map

package/dist/sync/sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/sync/sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AACzG,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAEhD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AACnE,OAAO,KAAK,mBAAmB,MAAM,kCAAkC,CAAA;AACvE,OAAO,KAAK,KAAK,cAAc,MAAM,6BAA6B,CAAA;AAElE;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAC,SAAS,GAAG,SAAS,CAAA;CACtC,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,CAAC,EAAE,sBAAsB,CAAC,GAAG,CAAC,CAAA;IACrC,gCAAgC;IAChC,kBAAkB,CAAC,EAAE,kBAAkB,CAAA;IACvC;;;;;;;;SAQK;IACL,WAAW,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAA;CACpC,CAAA;AAGD,MAAM,MAAM,sBAAsB,CAAC,aAAa,GAAG,MAAM,CAAC,SAAS,IAAI,CACrE,IAAI,EAAE,eAAe,KAClB,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,aAAa,CAAC,EAAE,eAAe,EAAE,KAAK,CAAC,KAAK,GAAG,UAAU,CAAC,UAAU,CAAC,CAAA;AASpG,MAAM,MAAM,WAAW,CAAC,aAAa,GAAG,MAAM,CAAC,SAAS,IAAI;IAC1D;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,GAAG,eAAe,EAAE,UAAU,CAAC,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,CAAA;IACnG,IAAI,EAAE,CACJ,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC;QAClB,MAAM,EAAE,mBAAmB,CAAC,mBAAmB,CAAA;QAC/C,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAA;KACvC,CAAC,KACC,MAAM,CAAC,MAAM,CAChB;QACE,KAAK,EAAE,aAAa,CAAC;YACnB,YAAY,EAAE,cAAc,CAAC,gBAAgB,CAAA;YAC7C,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAA;SACvC,CAAC,CAAA;QACF,SAAS,EAAE,MAAM,CAAA;KAClB,EACD,cAAc,GAAG,gBAAgB,EACjC,UAAU,CAAC,UAAU,CACtB,CAAA;IAED,IAAI,EAAE;IACJ;;;;SAIK;IACL,KAAK,EAAE,aAAa,CAAC,cAAc,CAAC,gBAAgB,CAAC,KAClD,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,GAAG,gBAAgB,EAAE,UAAU,CAAC,UAAU,CAAC,CAAA;IAClF,WAAW,EAAE,eAAe,CAAC,eAAe,CAAC,OAAO,CAAC,CAAA;IACrD;;OAEG;IACH,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,CAAA;CACnF,CAAA;;;;AAED,qBAAa,cAAe,SAAQ,mBAA0D;CAAG;;;;;;;;;;;AAGjG,qBAAa,gBAAiB,SAAQ,qBAUpC;CAAG;;;;;;AAGL,qBAAa,gBAAiB,SAAQ,qBAEpC;CAAG;;;;;;;;;;;;;;;AAGL,qBAAa,gBAAiB,SAAQ,qBAKpC;CAAG"}
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/sync/sync.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAA;AAEhD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AACnE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAA;AAE/D,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,CAAC,EAAE,sBAAsB,CAAC,GAAG,CAAC,CAAA;IACrC,gCAAgC;IAChC,kBAAkB,CAAC,EAAE,kBAAkB,CAAA;IACvC;;;;;;;;SAQK;IACL,WAAW,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAA;IACnC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA"}

package/dist/sync/sync.js

@@ -1,28 +1,3 @@
-import { Schema } from '@livestore/utils/effect';
-import * as EventSequenceNumber from "../schema/EventSequenceNumber.js";
-export class IsOfflineError extends Schema.TaggedError()('IsOfflineError', {}) {
-}
-// TODO gt rid of this error in favour of SyncError
-export class InvalidPushError extends Schema.TaggedError()('InvalidPushError', {
-    reason: Schema.Union(Schema.TaggedStruct('Unexpected', {
-        message: Schema.String,
-    }), Schema.TaggedStruct('ServerAhead', {
-        minimumExpectedNum: Schema.Number,
-        providedNum: Schema.Number,
-    })),
-}) {
-}
-// TODO gt rid of this error in favour of SyncError
-export class InvalidPullError extends Schema.TaggedError()('InvalidPullError', {
-    message: Schema.String,
-}) {
-}
-// TODO gt rid of this error in favour of SyncError
-export class LeaderAheadError extends Schema.TaggedError()('LeaderAheadError', {
-    minimumExpectedNum: EventSequenceNumber.EventSequenceNumber,
-    providedNum: EventSequenceNumber.EventSequenceNumber,
-    /** Generation number the client session should use for subsequent pushes */
-    // nextGeneration: Schema.Number,
-}) {
-}
+export * from "./errors.js";
+export * as SyncBackend from "./sync-backend.js";
 //# sourceMappingURL=sync.js.map

package/dist/sync/sync.js.map

@@ -1 +1 @@
-{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../src/sync/sync.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAIhD,OAAO,KAAK,mBAAmB,MAAM,kCAAkC,CAAA;AA6EvE,MAAM,OAAO,cAAe,SAAQ,MAAM,CAAC,WAAW,EAAkB,CAAC,gBAAgB,EAAE,EAAE,CAAC;CAAG;AAEjG,mDAAmD;AACnD,MAAM,OAAO,gBAAiB,SAAQ,MAAM,CAAC,WAAW,EAAoB,CAAC,kBAAkB,EAAE;IAC/F,MAAM,EAAE,MAAM,CAAC,KAAK,CAClB,MAAM,CAAC,YAAY,CAAC,YAAY,EAAE;QAChC,OAAO,EAAE,MAAM,CAAC,MAAM;KACvB,CAAC,EACF,MAAM,CAAC,YAAY,CAAC,aAAa,EAAE;QACjC,kBAAkB,EAAE,MAAM,CAAC,MAAM;QACjC,WAAW,EAAE,MAAM,CAAC,MAAM;KAC3B,CAAC,CACH;CACF,CAAC;CAAG;AAEL,mDAAmD;AACnD,MAAM,OAAO,gBAAiB,SAAQ,MAAM,CAAC,WAAW,EAAoB,CAAC,kBAAkB,EAAE;IAC/F,OAAO,EAAE,MAAM,CAAC,MAAM;CACvB,CAAC;CAAG;AAEL,mDAAmD;AACnD,MAAM,OAAO,gBAAiB,SAAQ,MAAM,CAAC,WAAW,EAAoB,CAAC,kBAAkB,EAAE;IAC/F,kBAAkB,EAAE,mBAAmB,CAAC,mBAAmB;IAC3D,WAAW,EAAE,mBAAmB,CAAC,mBAAmB;IACpD,4EAA4E;IAC5E,iCAAiC;CAClC,CAAC;CAAG"}
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../src/sync/sync.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAA"}

package/dist/sync/transport-chunking.d.ts

@@ -0,0 +1,36 @@
+import { Chunk, Effect, Schema } from '@livestore/utils/effect';
+/**
+ * Configuration describing how to break a chunk into smaller payload-safe chunks.
+ */
+export interface ChunkingOptions<A> {
+    /** Maximum number of items that may appear in any emitted chunk. */
+    readonly maxItems: number;
+    /** Maximum encoded byte size allowed for any emitted chunk. */
+    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;
+}
+declare const OversizeChunkItemError_base: Schema.TaggedErrorClass<OversizeChunkItemError, "OversizeChunkItemError", {
+    readonly _tag: Schema.tag<"OversizeChunkItemError">;
+} & {
+    size: typeof Schema.Number;
+    maxBytes: typeof Schema.Number;
+}>;
+/**
+ * Derives a function that splits an input chunk into sub-chunks confined by
+ * both item count and encoded byte size limits. Designed for transports with
+ * strict frame caps (e.g. Cloudflare hibernated WebSockets).
+ */
+export declare class OversizeChunkItemError extends OversizeChunkItemError_base {
+}
+export declare const splitChunkBySize: <A>(options: ChunkingOptions<A>) => (chunk: Chunk.Chunk<A>) => Effect.Effect<Chunk.Chunk<Chunk.Chunk<A>>, OversizeChunkItemError>;
+export {};
+//# sourceMappingURL=transport-chunking.d.ts.map

package/dist/sync/transport-chunking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-chunking.d.ts","sourceRoot":"","sources":["../../src/sync/transport-chunking.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAI/D;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,+DAA+D;IAC/D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,KAAK,OAAO,CAAA;IACrD;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,KAAK,MAAM,CAAA;CACvD;;;;;;;AAED;;;;GAIG;AACH,qBAAa,sBAAuB,SAAQ,2BAG1C;CAAG;AAEL,eAAO,MAAM,gBAAgB,GAC1B,CAAC,EAAE,SAAS,eAAe,CAAC,CAAC,CAAC,MAC9B,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,sBAAsB,CAqDtF,CAAA"}

package/dist/sync/transport-chunking.js

@@ -0,0 +1,56 @@
+import { Chunk, Effect, Schema } from '@livestore/utils/effect';
+const textEncoder = new TextEncoder();
+/**
+ * Derives a function that splits an input chunk into sub-chunks confined by
+ * both item count and encoded byte size limits. Designed for transports with
+ * strict frame caps (e.g. Cloudflare hibernated WebSockets).
+ */
+export class OversizeChunkItemError extends Schema.TaggedError()('OversizeChunkItemError', {
+    size: Schema.Number,
+    maxBytes: Schema.Number,
+}) {
+}
+export const splitChunkBySize = (options) => (chunk) => 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) => {
+        if (measure !== undefined) {
+            return measure(items);
+        }
+        const encoded = encode(items);
+        return textEncoder.encode(JSON.stringify(encoded)).byteLength;
+    };
+    const items = Chunk.toReadonlyArray(chunk);
+    if (items.length === 0) {
+        return Chunk.fromIterable([]);
+    }
+    const result = [];
+    let current = [];
+    const flushCurrent = () => {
+        if (current.length > 0) {
+            result.push(Chunk.fromIterable(current));
+            current = [];
+        }
+    };
+    for (const item of items) {
+        current.push(item);
+        const exceedsLimit = current.length > maxItems || computeSize(current) > maxBytes;
+        if (exceedsLimit) {
+            // remove the item we just added and emit the previous chunk if it exists
+            const last = current.pop();
+            flushCurrent();
+            if (last !== undefined) {
+                current = [last];
+                const singleItemTooLarge = computeSize(current) > maxBytes;
+                if (singleItemTooLarge || current.length > maxItems) {
+                    return yield* new OversizeChunkItemError({ size: computeSize([last]), maxBytes });
+                }
+            }
+        }
+    }
+    flushCurrent();
+    return Chunk.fromIterable(result);
+});
+//# sourceMappingURL=transport-chunking.js.map

package/dist/sync/transport-chunking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-chunking.js","sourceRoot":"","sources":["../../src/sync/transport-chunking.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAE/D,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAA;AAsBrC;;;;GAIG;AACH,MAAM,OAAO,sBAAuB,SAAQ,MAAM,CAAC,WAAW,EAA0B,CAAC,wBAAwB,EAAE;IACjH,IAAI,EAAE,MAAM,CAAC,MAAM;IACnB,QAAQ,EAAE,MAAM,CAAC,MAAM;CACxB,CAAC;CAAG;AAEL,MAAM,CAAC,MAAM,gBAAgB,GAC3B,CAAI,OAA2B,EAAE,EAAE,CACnC,CAAC,KAAqB,EAAsE,EAAE,CAC5F,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC9C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;IAC7B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAA;IAE/B,MAAM,WAAW,GAAG,CAAC,KAAuB,EAAE,EAAE;QAC9C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,OAAO,CAAC,KAAK,CAAC,CAAA;QACvB,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;QAC7B,OAAO,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAA;IAC/D,CAAC,CAAA;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,eAAe,CAAC,KAAK,CAAC,CAAA;IAC1C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,KAAK,CAAC,YAAY,CAAiB,EAAE,CAAC,CAAA;IAC/C,CAAC;IAED,MAAM,MAAM,GAA0B,EAAE,CAAA;IACxC,IAAI,OAAO,GAAa,EAAE,CAAA;IAE1B,MAAM,YAAY,GAAG,GAAG,EAAE;QACxB,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAA;YACxC,OAAO,GAAG,EAAE,CAAA;QACd,CAAC;IACH,CAAC,CAAA;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAClB,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,GAAG,QAAQ,IAAI,WAAW,CAAC,OAAO,CAAC,GAAG,QAAQ,CAAA;QAEjF,IAAI,YAAY,EAAE,CAAC;YACjB,yEAAyE;YACzE,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAG,CAAA;YAC3B,YAAY,EAAE,CAAA;YAEd,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,OAAO,GAAG,CAAC,IAAI,CAAC,CAAA;gBAChB,MAAM,kBAAkB,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,QAAQ,CAAA;gBAC1D,IAAI,kBAAkB,IAAI,OAAO,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;oBACpD,OAAO,KAAK,CAAC,CAAC,IAAI,sBAAsB,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAA;gBACnF,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,YAAY,EAAE,CAAA;IAEd,OAAO,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAA;AACnC,CAAC,CAAC,CAAA"}

package/dist/sync/validate-push-payload.d.ts

@@ -1,5 +1,5 @@
 import { Effect } from '@livestore/utils/effect';
-import type { EventSequenceNumber, LiveStoreEvent } from '../schema/mod.ts';
+import { EventSequenceNumber, type LiveStoreEvent } from '../schema/mod.ts';
 import { InvalidPushError } from './sync.ts';
 export declare const validatePushPayload: (batch: ReadonlyArray<LiveStoreEvent.AnyEncodedGlobal>, currentEventSequenceNumber: EventSequenceNumber.GlobalEventSequenceNumber) => Effect.Effect<undefined, InvalidPushError, never>;
 //# sourceMappingURL=validate-push-payload.d.ts.map

package/dist/sync/validate-push-payload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate-push-payload.d.ts","sourceRoot":"","sources":["../../src/sync/validate-push-payload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAEhD,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAG5C,eAAO,MAAM,mBAAmB,GAC9B,OAAO,aAAa,CAAC,cAAc,CAAC,gBAAgB,CAAC,EACrD,4BAA4B,mBAAmB,CAAC,yBAAyB,sDAYvE,CAAA"}
+{"version":3,"file":"validate-push-payload.d.ts","sourceRoot":"","sources":["../../src/sync/validate-push-payload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAEhD,OAAO,EAAE,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAC3E,OAAO,EAAE,gBAAgB,EAAoB,MAAM,WAAW,CAAA;AAG9D,eAAO,MAAM,mBAAmB,GAC9B,OAAO,aAAa,CAAC,cAAc,CAAC,gBAAgB,CAAC,EACrD,4BAA4B,mBAAmB,CAAC,yBAAyB,sDAWvE,CAAA"}

package/dist/sync/validate-push-payload.js

@@ -1,14 +1,14 @@
 import { Effect } from '@livestore/utils/effect';
-import { InvalidPushError } from "./sync.js";
+import { EventSequenceNumber } from "../schema/mod.js";
+import { InvalidPushError, ServerAheadError } from "./sync.js";
 // TODO proper batch validation
 export const validatePushPayload = (batch, currentEventSequenceNumber) => Effect.gen(function* () {
     if (batch[0].seqNum <= currentEventSequenceNumber) {
         return yield* InvalidPushError.make({
-            reason: {
-                _tag: 'ServerAhead',
-                minimumExpectedNum: currentEventSequenceNumber + 1,
-                providedNum: batch[0].seqNum,
-            },
+            cause: new ServerAheadError({
+                minimumExpectedNum: EventSequenceNumber.globalEventSequenceNumber(currentEventSequenceNumber + 1),
+                providedNum: EventSequenceNumber.globalEventSequenceNumber(batch[0].seqNum),
+            }),
         });
     }
 });

package/dist/sync/validate-push-payload.js.map

@@ -1 +1 @@
-{"version":3,"file":"validate-push-payload.js","sourceRoot":"","sources":["../../src/sync/validate-push-payload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAGhD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAE5C,+BAA+B;AAC/B,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,KAAqD,EACrD,0BAAyE,EACzE,EAAE,CACF,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,IAAI,KAAK,CAAC,CAAC,CAAE,CAAC,MAAM,IAAI,0BAA0B,EAAE,CAAC;QACnD,OAAO,KAAK,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC;YAClC,MAAM,EAAE;gBACN,IAAI,EAAE,aAAa;gBACnB,kBAAkB,EAAE,0BAA0B,GAAG,CAAC;gBAClD,WAAW,EAAE,KAAK,CAAC,CAAC,CAAE,CAAC,MAAM;aAC9B;SACF,CAAC,CAAA;IACJ,CAAC;AACH,CAAC,CAAC,CAAA"}
+{"version":3,"file":"validate-push-payload.js","sourceRoot":"","sources":["../../src/sync/validate-push-payload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAEhD,OAAO,EAAE,mBAAmB,EAAuB,MAAM,kBAAkB,CAAA;AAC3E,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAE9D,+BAA+B;AAC/B,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,KAAqD,EACrD,0BAAyE,EACzE,EAAE,CACF,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,IAAI,KAAK,CAAC,CAAC,CAAE,CAAC,MAAM,IAAI,0BAA0B,EAAE,CAAC;QACnD,OAAO,KAAK,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC;YAClC,KAAK,EAAE,IAAI,gBAAgB,CAAC;gBAC1B,kBAAkB,EAAE,mBAAmB,CAAC,yBAAyB,CAAC,0BAA0B,GAAG,CAAC,CAAC;gBACjG,WAAW,EAAE,mBAAmB,CAAC,yBAAyB,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,MAAM,CAAC;aAC7E,CAAC;SACH,CAAC,CAAA;IACJ,CAAC;AACH,CAAC,CAAC,CAAA"}

package/dist/testing/event-factory.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Helpers for synthesizing LiveStore events in tests while keeping track of
+ * sequence numbers, parent pointers, and authoring client identity. Inspired
+ * by the effect-based schema utilities, the factory exposes a namespaced API
+ * where each event definition maps to a helper with `next`, `advanceTo`, and
+ * `setParent` functions that share a single sequence stream.
+ *
+ * @example
+ * ```ts
+ * import { EventFactory } from '@livestore/common/testing'
+ * import { events } from './schema'
+ *
+ * const eventFactory = EventFactory.makeFactory(events)({
+ *   client: EventFactory.clientIdentity('test-client'),
+ *   startSeq: 1,
+ *   initialParent: 'root',
+ * })
+ *
+ * const bootstrap = eventFactory.todoCreated.next({
+ *   id: 'todo-1',
+ *   text: 'write tests',
+ *   completed: false,
+ * })
+ *
+ * eventFactory.todoCreated.advanceTo(42)
+ * const branched = eventFactory.todoUpdated.next({
+ *   id: 'todo-1',
+ *   text: 'ship feature',
+ *   completed: true,
+ * })
+ * ```
+ */
+import type { EventDef } from '../schema/EventDef.ts';
+import * as LiveStoreEvent from '../schema/LiveStoreEvent.ts';
+export interface ClientIdentity {
+    clientId: string;
+    sessionId: string;
+}
+export declare const clientIdentity: (label: string, session?: string) => ClientIdentity;
+export type SequenceValue = 'root' | number;
+type EventFactoriesArgs<TDefs extends Record<string, EventDef.Any>> = {
+    [K in keyof TDefs]: Parameters<TDefs[K]>[0];
+};
+type EventFactories<TDefs extends Record<string, EventDef.Any>, TResult> = {
+    [K in keyof TDefs]: {
+        next: (args: EventFactoriesArgs<TDefs>[K]) => TResult;
+        advanceTo: (seq: number, parent?: SequenceValue) => void;
+        setParent: (parent: SequenceValue) => void;
+        current: () => {
+            seq: number;
+            parent: SequenceValue;
+        };
+    };
+};
+export interface EventFactoriesConfig {
+    client: ClientIdentity;
+    /**
+     * @default 1
+     */
+    startSeq?: number;
+    /**
+     * @default 0 (root)
+     */
+    initialParent?: SequenceValue;
+}
+export declare const makeFactory: <TDefs extends Record<string, EventDef.Any>>(eventDefs: TDefs) => ({ client, startSeq, initialParent, }: EventFactoriesConfig) => EventFactories<TDefs, LiveStoreEvent.AnyEncodedGlobal>;
+export {};
+//# sourceMappingURL=event-factory.d.ts.map

package/dist/testing/event-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-factory.d.ts","sourceRoot":"","sources":["../../src/testing/event-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAErD,OAAO,KAAK,cAAc,MAAM,6BAA6B,CAAA;AAE7D,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,EAAE,gBAA4B,KAAG,cAG3E,CAAA;AAEF,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,CAAA;AAE3C,KAAK,kBAAkB,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,IAAI;KACnE,CAAC,IAAI,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAC5C,CAAA;AAED,KAAK,cAAc,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,IAAI;KACxE,CAAC,IAAI,MAAM,KAAK,GAAG;QAClB,IAAI,EAAE,CAAC,IAAI,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,CAAA;QACrD,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,KAAK,IAAI,CAAA;QACxD,SAAS,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,CAAA;QAC1C,OAAO,EAAE,MAAM;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,aAAa,CAAA;SAAE,CAAA;KACtD;CACF,CAAA;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,cAAc,CAAA;IACtB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;OAEG;IACH,aAAa,CAAC,EAAE,aAAa,CAAA;CAC9B;AAED,eAAO,MAAM,WAAW,GACrB,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,WAAW,KAAK,MAC5D,sCAIE,oBAAoB,KAAG,cAAc,CAAC,KAAK,EAAE,cAAc,CAAC,gBAAgB,CAkD9E,CAAA"}