event-sourced-collection 0.0.9 → 0.0.10

package/CHANGELOG.md

@@ -5,6 +5,20 @@ All notable changes to `event-sourced-collection` are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.0.10] - 2026-09-08
+
+### Added
+
+- `recordLocalEchoes` option (default `true`). Set `false` to advance the pull
+  cursor past this device's own events without writing resolved inbox echo rows.
+
+## [0.0.9] - 2026-09-08
+
+### Added
+
+- `useSyncStatus` / `useEnsureDb` on `event-sourced-collection/react`
+- `useManualSync({ db })` so `syncing` follows `subscribeSyncStatus` (load sync + manual)
+
 ## [0.0.7] - 2026-08-09
 
 Reliability-focused release: dead-lettering, backend identity, retries, conflict detection, multi-tab locking, React helpers, and published examples.

package/dist/browser-event-sourced-db-YBmcmWDR.d.mts

@@ -0,0 +1,121 @@
+import { L as SyncLock, P as SQLiteDriver, Q as InjectedModuleFn, Z as InjectedCreateCollection, p as EventSourcedSharedOptions } from "./types-DChF-gGL.mjs";
+import { r as ModulesInput, t as EventSourcedDBHandle } from "./create-event-sourced-db-handle-B_uCsLJC.mjs";
+import { PersistedCollectionPersistence } from "@tanstack/db-sqlite-persistence-core";
+
+//#region src/platforms/browser-wa-sqlite-driver.d.ts
+type BrowserWASQLiteDatabase = {
+  execute: <TRow = unknown>(sql: string, params?: ReadonlyArray<unknown>) => Promise<ReadonlyArray<TRow>>;
+  close?: () => Promise<void> | void;
+};
+//#endregion
+//#region src/platforms/browser-types.d.ts
+type BrowserCoordinatorInstance = {
+  dispose: () => void;
+};
+/**
+ * Injected TanStack browser persistence bindings. Parameters are `never` so
+ * version-skewed `@tanstack/browser-db-sqlite-persistence` exports stay assignable.
+ */
+type BrowserPlatformDeps = {
+  openBrowserWASQLiteOPFSDatabase: (options: never) => Promise<BrowserWASQLiteDatabase>;
+  createBrowserWASQLitePersistence: (options: never) => PersistedCollectionPersistence;
+  BrowserCollectionCoordinator: new (options: never) => BrowserCoordinatorInstance;
+};
+type BrowserPlatformConfig = {
+  databaseName: string;
+  coordinatorDbName?: string;
+};
+type BrowserPlatformResult = {
+  driver: SQLiteDriver;
+  persistence: PersistedCollectionPersistence;
+  close: () => Promise<void>;
+};
+//#endregion
+//#region src/platforms/browser-event-sourced-db.d.ts
+type CollectionDefConstraint = {
+  getKey: (state: never) => string | number;
+};
+type BrowserEventSourcedModules = BrowserPlatformDeps & {
+  createCollection: InjectedCreateCollection;
+  persistedCollectionOptions: InjectedModuleFn;
+};
+/**
+ * Browser entry-point config. Shared sync/lifecycle fields come from
+ * {@link EventSourcedSharedOptions} (hover those properties for docs).
+ * Deep guide: `docs/usage.md`.
+ */
+type BrowserEventSourcedDBConfig<TDefs extends Record<string, CollectionDefConstraint>> = Omit<EventSourcedSharedOptions, "lock" | "lockName"> & {
+  /**
+   * User collection registry. Object keys become `db.collections.<key>` and
+   * the wire `collectionId`. Must not collide with reserved names.
+   */
+  collections: TDefs;
+  /**
+   * OPFS SQLite database file name (e.g. `"my-app.sqlite"`). Also used as the
+   * default sync lock namespace so only one tab syncs for this DB at a time.
+   */
+  databaseName: string;
+  /**
+   * Name for the cross-tab collection coordinator database. Defaults to
+   * `databaseName` with a trailing `.sqlite` stripped.
+   */
+  coordinatorDbName?: string;
+  /**
+   * Browser OPFS persistence modules from
+   * `@tanstack/browser-db-sqlite-persistence` plus `createCollection`.
+   * Pass the imported bindings directly, or a function to keep WASM off the
+   * critical path.
+   */
+  modules: ModulesInput<BrowserEventSourcedModules>;
+  /**
+   * Defaults to a Web Locks–backed lock so only one tab syncs at a time.
+   * Pass `null` to opt out and let every tab sync independently.
+   */
+  lock?: SyncLock | null;
+};
+/**
+ * Browser-flavoured event-sourced DB: OPFS SQLite + optional Web Locks sync
+ * election, returned as a lazy singleton.
+ *
+ * @param config - See {@link BrowserEventSourcedDBConfig} for every option.
+ *
+ * @example
+ * ```ts
+ * import { createBrowserEventSourcedDB } from "event-sourced-collection/browser"
+ * import type { CollectionDef, EventSourcedDB } from "event-sourced-collection"
+ *
+ * type Todo = { id: string; title: string }
+ * type Defs = { todos: CollectionDef<Todo, string> }
+ *
+ * const { ensureDb, db } = createBrowserEventSourcedDB<Defs>({
+ *   databaseName: "app.sqlite",
+ *   collections: { todos: { getKey: (todo) => todo.id } },
+ *   sync: { push: "/api/sync/events", pull: "/api/sync/events" },
+ *   modules: async () => {
+ *     const { createCollection } = await import("@tanstack/db")
+ *     const {
+ *       BrowserCollectionCoordinator,
+ *       createBrowserWASQLitePersistence,
+ *       openBrowserWASQLiteOPFSDatabase,
+ *       persistedCollectionOptions,
+ *     } = await import("@tanstack/browser-db-sqlite-persistence")
+ *     return {
+ *       createCollection,
+ *       BrowserCollectionCoordinator,
+ *       createBrowserWASQLitePersistence,
+ *       openBrowserWASQLiteOPFSDatabase,
+ *       persistedCollectionOptions,
+ *     }
+ *   },
+ * })
+ *
+ * export async function start() {
+ *   await ensureDb()
+ * }
+ * export { db }
+ * ```
+ */
+declare function createBrowserEventSourcedDB<const TDefs extends Record<string, CollectionDefConstraint>>(config: BrowserEventSourcedDBConfig<TDefs>): EventSourcedDBHandle<TDefs>;
+//#endregion
+export { BrowserPlatformConfig as a, BrowserWASQLiteDatabase as c, BrowserCoordinatorInstance as i, BrowserEventSourcedModules as n, BrowserPlatformDeps as o, createBrowserEventSourcedDB as r, BrowserPlatformResult as s, BrowserEventSourcedDBConfig as t };
+//# sourceMappingURL=browser-event-sourced-db-YBmcmWDR.d.mts.map

package/dist/browser-event-sourced-db-YBmcmWDR.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-event-sourced-db-YBmcmWDR.d.mts","names":[],"sources":["../src/platforms/browser-wa-sqlite-driver.ts","../src/platforms/browser-types.ts","../src/platforms/browser-event-sourced-db.ts"],"mappings":";;;;;KAEY,uBAAA;EACV,OAAA,mBACE,GAAA,UACA,MAAA,GAAS,aAAA,cACN,OAAA,CAAQ,aAAA,CAAc,IAAA;EAC3B,KAAA,SAAc,OAAA;AAAA;;;KCJJ,0BAAA;EACV,OAAO;AAAA;ADFT;;;;AAAA,KCSY,mBAAA;EACV,+BAAA,GAAkC,OAAA,YAAmB,OAAA,CAAQ,uBAAA;EAC7D,gCAAA,GAAmC,OAAA,YAAmB,8BAAA;EACtD,4BAAA,OAAmC,OAAA,YAAmB,0BAAA;AAAA;AAAA,KAG5C,qBAAA;EACV,YAAA;EACA,iBAAiB;AAAA;AAAA,KAGP,qBAAA;EACV,MAAA,EAD+B,YAAA;EAE/B,WAAA,EAAa,8BAAA;EACb,KAAA,QAAa,OAAA;AAAA;;;KCTV,uBAAA;EACH,MAAA,GAAS,KAAY;AAAA;AAAA,KAGX,0BAAA,GAA6B,mBAAA;EACvC,gBAAA,EAAkB,wBAAA;EAClB,0BAAA,EAA4B,gBAAA;AAAA;;;;;;KAQlB,2BAAA,eAA0C,MAAA,SAAe,uBAAA,KACnE,IAAA,CAAK,yBAAA;EF3BH;;;;EEgCA,WAAA,EAAa,KAAA;EF9BY;;;;EEmCzB,YAAA;;;;ADtCJ;EC2CI,iBAAA;;;AD1CK;AAOT;;;EC0CI,OAAA,EAAS,YAAA,CAAa,0BAAA;EDzC6B;;;;EC8CnD,IAAA,GAAO,QAAA;AAAA;;;;;;;;;;AD5CuE;AAGlF;;;;AAEmB;AAGnB;;;;;;;;;;;;;;;AAGsB;;;;ACZqC;;;;AAIpC;AAGvB;;;iBAqFgB,2BAAA,qBACM,MAAA,SAAe,uBAAA,GACnC,MAAA,EAAQ,2BAAA,CAA4B,KAAA,IAAM,oBAAA,CAAA,KAAA"}

package/dist/browser.d.mts

@@ -1,36 +1,6 @@
-import { L as SyncLock, P as SQLiteDriver, Q as InjectedModuleFn, Z as InjectedCreateCollection, p as EventSourcedSharedOptions } from "./types-BSdudVLh.mjs";
-import { r as ModulesInput, t as EventSourcedDBHandle } from "./create-event-sourced-db-handle-BAos-9pS.mjs";
-import { PersistedCollectionPersistence } from "@tanstack/db-sqlite-persistence-core";
+import { a as BrowserPlatformConfig, c as BrowserWASQLiteDatabase, i as BrowserCoordinatorInstance, n as BrowserEventSourcedModules, o as BrowserPlatformDeps, r as createBrowserEventSourcedDB, s as BrowserPlatformResult, t as BrowserEventSourcedDBConfig } from "./browser-event-sourced-db-YBmcmWDR.mjs";
+import { t as EventSourcedDBHandle } from "./create-event-sourced-db-handle-B_uCsLJC.mjs";
 
-//#region src/platforms/browser-wa-sqlite-driver.d.ts
-type BrowserWASQLiteDatabase = {
-  execute: <TRow = unknown>(sql: string, params?: ReadonlyArray<unknown>) => Promise<ReadonlyArray<TRow>>;
-  close?: () => Promise<void> | void;
-};
-//#endregion
-//#region src/platforms/browser-types.d.ts
-type BrowserCoordinatorInstance = {
-  dispose: () => void;
-};
-/**
- * Injected TanStack browser persistence bindings. Parameters are `never` so
- * version-skewed `@tanstack/browser-db-sqlite-persistence` exports stay assignable.
- */
-type BrowserPlatformDeps = {
-  openBrowserWASQLiteOPFSDatabase: (options: never) => Promise<BrowserWASQLiteDatabase>;
-  createBrowserWASQLitePersistence: (options: never) => PersistedCollectionPersistence;
-  BrowserCollectionCoordinator: new (options: never) => BrowserCoordinatorInstance;
-};
-type BrowserPlatformConfig = {
-  databaseName: string;
-  coordinatorDbName?: string;
-};
-type BrowserPlatformResult = {
-  driver: SQLiteDriver;
-  persistence: PersistedCollectionPersistence;
-  close: () => Promise<void>;
-};
-//#endregion
 //#region src/platforms/browser.d.ts
 /**
  * Opens OPFS SQLite, a cross-tab coordinator, and TanStack persistence.
@@ -61,91 +31,5 @@ type BrowserPlatformResult = {
  */
 declare function createBrowserPlatform(deps: BrowserPlatformDeps, config: BrowserPlatformConfig): Promise<BrowserPlatformResult>;
 //#endregion
-//#region src/platforms/browser-event-sourced-db.d.ts
-type CollectionDefConstraint = {
-  getKey: (state: never) => string | number;
-};
-type BrowserEventSourcedModules = BrowserPlatformDeps & {
-  createCollection: InjectedCreateCollection;
-  persistedCollectionOptions: InjectedModuleFn;
-};
-/**
- * Browser entry-point config. Shared sync/lifecycle fields come from
- * {@link EventSourcedSharedOptions} (hover those properties for docs).
- * Deep guide: `docs/usage.md`.
- */
-type BrowserEventSourcedDBConfig<TDefs extends Record<string, CollectionDefConstraint>> = Omit<EventSourcedSharedOptions, "lock" | "lockName"> & {
-  /**
-   * User collection registry. Object keys become `db.collections.<key>` and
-   * the wire `collectionId`. Must not collide with reserved names.
-   */
-  collections: TDefs;
-  /**
-   * OPFS SQLite database file name (e.g. `"my-app.sqlite"`). Also used as the
-   * default sync lock namespace so only one tab syncs for this DB at a time.
-   */
-  databaseName: string;
-  /**
-   * Name for the cross-tab collection coordinator database. Defaults to
-   * `databaseName` with a trailing `.sqlite` stripped.
-   */
-  coordinatorDbName?: string;
-  /**
-   * Browser OPFS persistence modules from
-   * `@tanstack/browser-db-sqlite-persistence` plus `createCollection`.
-   * Pass the imported bindings directly, or a function to keep WASM off the
-   * critical path.
-   */
-  modules: ModulesInput<BrowserEventSourcedModules>;
-  /**
-   * Defaults to a Web Locks–backed lock so only one tab syncs at a time.
-   * Pass `null` to opt out and let every tab sync independently.
-   */
-  lock?: SyncLock | null;
-};
-/**
- * Browser-flavoured event-sourced DB: OPFS SQLite + optional Web Locks sync
- * election, returned as a lazy singleton.
- *
- * @param config - See {@link BrowserEventSourcedDBConfig} for every option.
- *
- * @example
- * ```ts
- * import { createBrowserEventSourcedDB } from "event-sourced-collection/browser"
- * import type { CollectionDef, EventSourcedDB } from "event-sourced-collection"
- *
- * type Todo = { id: string; title: string }
- * type Defs = { todos: CollectionDef<Todo, string> }
- *
- * const { ensureDb, db } = createBrowserEventSourcedDB<Defs>({
- *   databaseName: "app.sqlite",
- *   collections: { todos: { getKey: (todo) => todo.id } },
- *   sync: { push: "/api/sync/events", pull: "/api/sync/events" },
- *   modules: async () => {
- *     const { createCollection } = await import("@tanstack/db")
- *     const {
- *       BrowserCollectionCoordinator,
- *       createBrowserWASQLitePersistence,
- *       openBrowserWASQLiteOPFSDatabase,
- *       persistedCollectionOptions,
- *     } = await import("@tanstack/browser-db-sqlite-persistence")
- *     return {
- *       createCollection,
- *       BrowserCollectionCoordinator,
- *       createBrowserWASQLitePersistence,
- *       openBrowserWASQLiteOPFSDatabase,
- *       persistedCollectionOptions,
- *     }
- *   },
- * })
- *
- * export async function start() {
- *   await ensureDb()
- * }
- * export { db }
- * ```
- */
-declare function createBrowserEventSourcedDB<const TDefs extends Record<string, CollectionDefConstraint>>(config: BrowserEventSourcedDBConfig<TDefs>): EventSourcedDBHandle<TDefs>;
-//#endregion
 export { type BrowserCoordinatorInstance, type BrowserEventSourcedDBConfig, type EventSourcedDBHandle as BrowserEventSourcedDBHandle, type BrowserEventSourcedModules, type BrowserPlatformConfig, type BrowserPlatformDeps, type BrowserPlatformResult, type BrowserWASQLiteDatabase, createBrowserEventSourcedDB, createBrowserPlatform };
 //# sourceMappingURL=browser.d.mts.map

package/dist/browser.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"browser.d.mts","names":[],"sources":["../src/platforms/browser-wa-sqlite-driver.ts","../src/platforms/browser-types.ts","../src/platforms/browser.ts","../src/platforms/browser-event-sourced-db.ts"],"mappings":";;;;;KAEY,uBAAA;EACV,OAAA,mBACE,GAAA,UACA,MAAA,GAAS,aAAA,cACN,OAAA,CAAQ,aAAA,CAAc,IAAA;EAC3B,KAAA,SAAc,OAAA;AAAA;;;KCJJ,0BAAA;EACV,OAAO;AAAA;;ADFT;;;KCSY,mBAAA;EACV,+BAAA,GAAkC,OAAA,YAAmB,OAAA,CAAQ,uBAAA;EAC7D,gCAAA,GAAmC,OAAA,YAAmB,8BAAA;EACtD,4BAAA,OAAmC,OAAA,YAAmB,0BAAA;AAAA;AAAA,KAG5C,qBAAA;EACV,YAAA;EACA,iBAAiB;AAAA;AAAA,KAGP,qBAAA;EACV,MAAA,EAD+B,YAAA;EAE/B,WAAA,EAAa,8BAAA;EACb,KAAA,QAAa,OAAA;AAAA;;;;;;ADvBf;;;;;;;;;;;;;;;;;;;;;AAKuB;;;iBEoCD,qBAAA,CACpB,IAAA,EAAM,mBAAA,EACN,MAAA,EAAQ,qBAAA,GACP,OAAA,CAAQ,qBAAA;;;KC9BN,uBAAA;EACH,MAAA,GAAS,KAAY;AAAA;AAAA,KAGX,0BAAA,GAA6B,mBAAA;EACvC,gBAAA,EAAkB,wBAAA;EAClB,0BAAA,EAA4B,gBAAA;AAAA;;;;;;KAQlB,2BAAA,eAA0C,MAAA,SAAe,uBAAA,KACnE,IAAA,CAAK,yBAAA;EH5BK;;;;EGiCR,WAAA,EAAa,KAAA;EH9BF;;;;EGmCX,YAAA;EHlCmB;;;;EGuCnB,iBAAA;EF3CkC;;;AAC7B;AAOT;;EE0CI,OAAA,EAAS,YAAA,CAAa,0BAAA;EFzCqC;;;;EE8C3D,IAAA,GAAO,QAAA;AAAA;;;;;;;;;;;AF5CuE;AAGlF;;;;AAEmB;AAGnB;;;;;;;;;;;;;;;AAGsB;;;;ACkBtB;;;;;;;iBC8DgB,2BAAA,qBACM,MAAA,SAAe,uBAAA,GACnC,MAAA,EAAQ,2BAAA,CAA4B,KAAA,IAAM,oBAAA,CAAA,KAAA"}
+{"version":3,"file":"browser.d.mts","names":[],"sources":["../src/platforms/browser.ts"],"mappings":";;;;;AA2CA;;;;;;;;;;;;;;;;AAGgC;;;;;;;;;;iBAHV,qBAAA,CACpB,IAAA,EAAM,mBAAA,EACN,MAAA,EAAQ,qBAAA,GACP,OAAA,CAAQ,qBAAA"}

package/dist/browser.mjs

@@ -1,4 +1,4 @@
-import { n as resolveModules, t as createEventSourcedDBHandle } from "./create-event-sourced-db-handle-BPsVV1x6.mjs";
+import { n as resolveModules, t as createEventSourcedDBHandle } from "./create-event-sourced-db-handle-D-fHKczr.mjs";
 import { t as createWebLocksSyncLock } from "./web-locks-Bi2f732X.mjs";
 //#region src/platforms/browser-wa-sqlite-driver.ts
 function assertTransactionCallbackHasDriverArg(fn) {

package/dist/{create-event-sourced-db-handle-BAos-9pS.d.mts → create-event-sourced-db-handle-B_uCsLJC.d.mts}

@@ -1,4 +1,4 @@
-import { l as EventSourcedDB, u as EventSourcedDBConfig } from "./types-BSdudVLh.mjs";
+import { l as EventSourcedDB, u as EventSourcedDBConfig } from "./types-DChF-gGL.mjs";
 
 //#region src/core/create-event-sourced-db-handle.d.ts
 type CollectionDefConstraint = {
@@ -102,4 +102,4 @@ type ModulesInput<T> = T | (() => T | Promise<T>);
 declare function resolveModules<T>(modules: ModulesInput<T>): Promise<T>;
 //#endregion
 export { resolveModules as a, createEventSourcedDBHandle as i, EventSourcedDBHandleSetup as n, ModulesInput as r, EventSourcedDBHandle as t };
-//# sourceMappingURL=create-event-sourced-db-handle-BAos-9pS.d.mts.map
+//# sourceMappingURL=create-event-sourced-db-handle-B_uCsLJC.d.mts.map

package/dist/{create-event-sourced-db-handle-BAos-9pS.d.mts.map → create-event-sourced-db-handle-B_uCsLJC.d.mts.map}

@@ -1 +1 @@
-{"version":3,"file":"create-event-sourced-db-handle-BAos-9pS.d.mts","names":[],"sources":["../src/core/create-event-sourced-db-handle.ts"],"mappings":";;;KAIK,uBAAA;EACH,MAAA,GAAS,KAAY;AAAA;;;;AAAA;AAyBvB;;;;;;;;;;;;;;;;;;KAAY,oBAAA,eAAmC,MAAA,SAAe,uBAAA;EAErB,uFAAvC,QAAA,QAAgB,OAAA,CAAQ,cAAA,CAAe,KAAA;EAKnC;;;;EAAJ,EAAA,EAAI,cAAA,CAAe,KAAA,GAEC;EAApB,KAAA,QAAa,OAAA;AAAA;AAAA,KAGH,yBAAA,eAAwC,MAAA,SAAe,uBAAA,KACjE,oBAAA,CAAqB,KAAA;EAD4C,uEAG/D,KAAA,SAAc,OAAA;AAAA;;;;;;;;;;;;;AAAO;AAsCzB;;;;;;;;;;;;;;;;;;;;;;iBAAgB,0BAAA,qBACM,MAAA,SAAe,uBAAA,GACnC,OAAA;EACA,KAAA,QAAa,OAAA,CAAQ,yBAAA,CAA0B,KAAA;EAC/C,KAAA;EACA,qBAAA;AAAA,IACE,oBAAA,CAAqB,KAAA;;KAuCb,YAAA,MAAkB,CAAA,UAAW,CAAA,GAAI,OAAA,CAAQ,CAAA;;;;;;;;;;;;;AAAC;AAqBtD;;;;;;iBAAsB,cAAA,IAAkB,OAAA,EAAS,YAAA,CAAa,CAAA,IAAK,OAAA,CAAQ,CAAA"}
+{"version":3,"file":"create-event-sourced-db-handle-B_uCsLJC.d.mts","names":[],"sources":["../src/core/create-event-sourced-db-handle.ts"],"mappings":";;;KAIK,uBAAA;EACH,MAAA,GAAS,KAAY;AAAA;;;;AAAA;AAyBvB;;;;;;;;;;;;;;;;;;KAAY,oBAAA,eAAmC,MAAA,SAAe,uBAAA;EAErB,uFAAvC,QAAA,QAAgB,OAAA,CAAQ,cAAA,CAAe,KAAA;EAKnC;;;;EAAJ,EAAA,EAAI,cAAA,CAAe,KAAA,GAEC;EAApB,KAAA,QAAa,OAAA;AAAA;AAAA,KAGH,yBAAA,eAAwC,MAAA,SAAe,uBAAA,KACjE,oBAAA,CAAqB,KAAA;EAD4C,uEAG/D,KAAA,SAAc,OAAA;AAAA;;;;;;;;;;;;;AAAO;AAsCzB;;;;;;;;;;;;;;;;;;;;;;iBAAgB,0BAAA,qBACM,MAAA,SAAe,uBAAA,GACnC,OAAA;EACA,KAAA,QAAa,OAAA,CAAQ,yBAAA,CAA0B,KAAA;EAC/C,KAAA;EACA,qBAAA;AAAA,IACE,oBAAA,CAAqB,KAAA;;KAuCb,YAAA,MAAkB,CAAA,UAAW,CAAA,GAAI,OAAA,CAAQ,CAAA;;;;;;;;;;;;;AAAC;AAqBtD;;;;;;iBAAsB,cAAA,IAAkB,OAAA,EAAS,YAAA,CAAa,CAAA,IAAK,OAAA,CAAQ,CAAA"}

package/dist/{create-event-sourced-db-handle-BPsVV1x6.mjs → create-event-sourced-db-handle-D-fHKczr.mjs}

@@ -480,7 +480,7 @@ var BackendMismatchError = class extends Error {
 	}
 };
 async function pullInbox(args) {
-	const { outbox, inbox, syncmeta, pull, clientId, pullOverlap, context } = args;
+	const { outbox, inbox, syncmeta, pull, clientId, pullOverlap, recordLocalEchoes, context } = args;
 	const { log } = context;
 	let pulled = 0;
 	let skipped = 0;
@@ -513,10 +513,11 @@ async function pullInbox(args) {
 		let halted = false;
 		for (const event of sorted) {
 			if (isLocalOrigin(event, outbox, clientId)) {
-				await markInboxEventResolved(inbox, event);
+				if (recordLocalEchoes) await markInboxEventResolved(inbox, event);
 				log.debug("pull skipped: event originated locally", {
 					eventId: event.eventId,
-					globalSeq: event.globalSeq
+					globalSeq: event.globalSeq,
+					recorded: recordLocalEchoes
 				});
 				continue;
 			}
@@ -1280,6 +1281,7 @@ async function createEventSourcedDB(config) {
 	const clientId = { value: config.clientId ?? generateEventId() };
 	const unknownEventHandling = config.unknownEventHandling ?? "skip";
 	const pullOverlap = Math.max(0, config.pullOverlap ?? 0);
+	const recordLocalEchoes = config.recordLocalEchoes ?? true;
 	const eventSchemaVersion = config.eventSchemaVersion ?? 1;
 	const pushBatchSize = Math.max(1, config.pushBatchSize ?? 100);
 	const backendMismatch = config.backendMismatch ?? "resetCursor";
@@ -1297,6 +1299,7 @@ async function createEventSourcedDB(config) {
 		syncEnabled,
 		unknownEventHandling,
 		pullOverlap,
+		recordLocalEchoes,
 		pushBatchSize,
 		backendMismatch,
 		conflictDetection,
@@ -1456,6 +1459,7 @@ async function createEventSourcedDB(config) {
 					pull: transport.pull,
 					clientId: clientId.value,
 					pullOverlap,
+					recordLocalEchoes,
 					backendMismatch,
 					context: replayContext
 				});
@@ -2026,4 +2030,4 @@ async function resolveModules(modules) {
 //#endregion
 export { generateEventId as a, SyncPushError as c, createEventSourcedDB as i, createHttpTransport as l, resolveModules as n, createEventSourcedLogger as o, createLazySingleton as r, SyncPullError as s, createEventSourcedDBHandle as t, BackendMismatchError as u };
 
-//# sourceMappingURL=create-event-sourced-db-handle-BPsVV1x6.mjs.map
+//# sourceMappingURL=create-event-sourced-db-handle-D-fHKczr.mjs.map