@nsky/sync 0.1.0

package/dist/core/index.mjs

@@ -0,0 +1,272 @@
+import { ExponentialBackoffPolicy, compareHLC } from "../utils/index.mjs";
+//#region src/core/conflict.ts
+var LWWResolver = class {
+	resolve(context) {
+		const { local, remote } = context;
+		if (local.action === "delete" && remote.action !== "delete") return {
+			winner: local,
+			strategy: "Tombstone wins over non-delete change"
+		};
+		if (remote.action === "delete" && local.action !== "delete") return {
+			winner: remote,
+			strategy: "Tombstone wins over non-delete change"
+		};
+		const order = compareHLC(remote.version, local.version);
+		if (order > 0) return {
+			winner: remote,
+			strategy: "LWW: remote version newer"
+		};
+		if (order < 0) return {
+			winner: local,
+			strategy: "LWW: local version newer"
+		};
+		return {
+			winner: remote,
+			strategy: "LWW: equal version, remote wins"
+		};
+	}
+};
+//#endregion
+//#region src/core/errors.ts
+function createSyncError(code, message, cause) {
+	return {
+		code,
+		message,
+		cause,
+		occurredAt: Date.now()
+	};
+}
+function isSyncError(error) {
+	return typeof error === "object" && error !== null && "code" in error && "message" in error && "occurredAt" in error;
+}
+function normalizeSyncError(error) {
+	if (isSyncError(error)) return error;
+	if (error instanceof Error) return createSyncError("UNKNOWN", error.message, error);
+	return createSyncError("UNKNOWN", "Unknown sync error.", error);
+}
+//#endregion
+//#region src/core/event-bus.ts
+var TypedSyncEventBus = class {
+	#listeners = /* @__PURE__ */ new Map();
+	on(event, listener) {
+		const listeners = this.#listeners.get(event) ?? /* @__PURE__ */ new Set();
+		listeners.add(listener);
+		this.#listeners.set(event, listeners);
+		return () => this.off(event, listener);
+	}
+	once(event, listener) {
+		const wrapped = ((payload) => {
+			this.off(event, wrapped);
+			if (payload === void 0) listener();
+			else listener(payload);
+		});
+		this.on(event, wrapped);
+	}
+	off(event, listener) {
+		this.#listeners.get(event)?.delete(listener);
+	}
+	emit(event, ...args) {
+		const listeners = [...this.#listeners.get(event) ?? []];
+		for (const listener of listeners) if (args.length === 0) listener();
+		else listener(args[0]);
+	}
+};
+//#endregion
+//#region src/core/engine.ts
+var SyncEngine = class {
+	#database;
+	#transport;
+	#deviceId;
+	#batchSize;
+	#unsubscribe;
+	#status = "idle";
+	#inFlight = null;
+	resolver;
+	events = new TypedSyncEventBus();
+	constructor(options) {
+		this.#database = options.database;
+		this.#transport = options.transport;
+		this.#deviceId = options.deviceId;
+		this.#batchSize = options.batchSize ?? 100;
+		this.resolver = options.resolver ?? new LWWResolver();
+		this.#unsubscribe = this.#transport.subscribe?.(() => {
+			this.sync();
+		});
+	}
+	get status() {
+		return this.#status;
+	}
+	sync() {
+		if (this.#inFlight !== null) return this.#inFlight;
+		this.#inFlight = this.#syncOnce().finally(() => {
+			this.#inFlight = null;
+		});
+		return this.#inFlight;
+	}
+	async dispose() {
+		this.#unsubscribe?.();
+	}
+	async #syncOnce() {
+		const startedAt = Date.now();
+		let uploadedCount = 0;
+		let downloadedCount = 0;
+		this.events.emit("syncStart");
+		try {
+			this.#setStatus("uploading");
+			const pendingChanges = await this.#database.getPendingChanges(this.#batchSize);
+			if (pendingChanges.length > 0) {
+				await this.#transport.push({
+					changes: pendingChanges,
+					deviceId: this.#deviceId
+				});
+				await this.#database.markAsSynced(pendingChanges.map((change) => change.id));
+				uploadedCount = pendingChanges.length;
+			}
+			this.events.emit("uploadComplete", { uploadedCount });
+			let cursor = await this.#database.getLocalCursor();
+			let hasMore = true;
+			while (hasMore) {
+				this.#setStatus("downloading");
+				const pulled = await this.#transport.pull(cursor?.value ?? null, this.#batchSize);
+				this.events.emit("downloadComplete", { downloadedCount: pulled.changes.length });
+				this.#setStatus("applying");
+				await this.#database.runInTransaction(async () => {
+					await this.#database.applyRemoteChanges([...pulled.changes]);
+					await this.#database.saveLocalCursor(pulled.cursor);
+				});
+				downloadedCount += pulled.changes.length;
+				cursor = pulled.cursor;
+				hasMore = pulled.hasMore;
+			}
+			this.#setStatus("idle");
+			const result = {
+				success: true,
+				uploadedCount,
+				downloadedCount,
+				durationMs: Date.now() - startedAt
+			};
+			this.events.emit("syncFinish", result);
+			return result;
+		} catch (cause) {
+			const error = normalizeSyncError(cause);
+			const result = {
+				success: false,
+				uploadedCount,
+				downloadedCount,
+				durationMs: Date.now() - startedAt,
+				error
+			};
+			this.events.emit("error", error);
+			this.#setStatus("idle");
+			this.events.emit("syncFinish", result);
+			return result;
+		}
+	}
+	#setStatus(status) {
+		this.#status = status;
+		this.events.emit("statusChange", status);
+	}
+};
+//#endregion
+//#region src/core/scheduler.ts
+const DEFAULT_INTERVAL_MS = 3e4;
+const DEFAULT_TOMBSTONE_CLEANUP_INTERVAL_MS = 10080 * 60 * 1e3;
+const DEFAULT_TOMBSTONE_MAX_AGE_MS = 720 * 60 * 60 * 1e3;
+var DefaultSyncScheduler = class {
+	#engine;
+	#database;
+	#defaultRetryPolicy;
+	#window;
+	#document;
+	#syncTimer = null;
+	#retryTimer = null;
+	#tombstoneTimer = null;
+	#inFlight = null;
+	#retryAttempt = 0;
+	#firstFailedAt = 0;
+	#retryPolicy;
+	#handleOnline = () => {
+		this.triggerSync();
+	};
+	#handleVisibilityChange = () => {
+		if (this.#document?.visibilityState === "visible") this.triggerSync();
+	};
+	constructor(options) {
+		this.#engine = options.engine;
+		this.#database = options.database;
+		this.#defaultRetryPolicy = options.retryPolicy ?? new ExponentialBackoffPolicy();
+		this.#retryPolicy = this.#defaultRetryPolicy;
+		this.#window = options.window ?? globalThis.window;
+		this.#document = options.document ?? globalThis.document;
+	}
+	start(options = {}) {
+		this.stop();
+		this.#retryPolicy = options.retryPolicy ?? this.#defaultRetryPolicy;
+		const intervalMs = options.intervalMs ?? DEFAULT_INTERVAL_MS;
+		if (intervalMs > 0) this.#syncTimer = setInterval(() => {
+			this.triggerSync();
+		}, intervalMs);
+		if (options.syncOnNetworkRecover ?? true) this.#window?.addEventListener("online", this.#handleOnline);
+		if (options.syncOnForeground ?? true) this.#document?.addEventListener("visibilitychange", this.#handleVisibilityChange);
+		const tombstoneCleanupIntervalMs = options.tombstoneCleanupIntervalMs ?? DEFAULT_TOMBSTONE_CLEANUP_INTERVAL_MS;
+		if (this.#database !== void 0 && tombstoneCleanupIntervalMs > 0) {
+			const tombstoneMaxAgeMs = options.tombstoneMaxAgeMs ?? DEFAULT_TOMBSTONE_MAX_AGE_MS;
+			this.#tombstoneTimer = setInterval(() => {
+				this.#database?.clearTombstones(Date.now() - tombstoneMaxAgeMs);
+			}, tombstoneCleanupIntervalMs);
+		}
+	}
+	stop() {
+		if (this.#syncTimer !== null) {
+			clearInterval(this.#syncTimer);
+			this.#syncTimer = null;
+		}
+		if (this.#retryTimer !== null) {
+			clearTimeout(this.#retryTimer);
+			this.#retryTimer = null;
+		}
+		if (this.#tombstoneTimer !== null) {
+			clearInterval(this.#tombstoneTimer);
+			this.#tombstoneTimer = null;
+		}
+		this.#window?.removeEventListener("online", this.#handleOnline);
+		this.#document?.removeEventListener("visibilitychange", this.#handleVisibilityChange);
+	}
+	async triggerSync() {
+		if (this.#inFlight !== null) return await this.#inFlight;
+		this.#inFlight = this.#engine.sync().then((result) => {
+			this.#handleResult(result);
+			return result;
+		});
+		try {
+			return await this.#inFlight;
+		} finally {
+			this.#inFlight = null;
+		}
+	}
+	#handleResult(result) {
+		if (result.success) {
+			this.#retryAttempt = 0;
+			this.#firstFailedAt = 0;
+			return;
+		}
+		if (result.error === void 0) return;
+		this.#firstFailedAt = this.#firstFailedAt === 0 ? result.error.occurredAt : this.#firstFailedAt;
+		const decision = this.#retryPolicy.decide({
+			attempt: this.#retryAttempt,
+			firstFailedAt: this.#firstFailedAt,
+			lastError: result.error
+		});
+		this.#retryAttempt += 1;
+		if (decision.action === "abort") return;
+		if (this.#retryTimer !== null) clearTimeout(this.#retryTimer);
+		this.#retryTimer = setTimeout(() => {
+			this.#retryTimer = null;
+			this.triggerSync();
+		}, decision.delayMs);
+	}
+};
+//#endregion
+export { DefaultSyncScheduler, LWWResolver, SyncEngine, TypedSyncEventBus, createSyncError, isSyncError, normalizeSyncError };
+
+//# sourceMappingURL=index.mjs.map

package/dist/core/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["#listeners","#database","#transport","#deviceId","#batchSize","#unsubscribe","#status","#inFlight","#syncOnce","#setStatus","#engine","#database","#defaultRetryPolicy","#window","#document","#retryPolicy","#syncTimer","#handleOnline","#handleVisibilityChange","#tombstoneTimer","#retryTimer","#inFlight","#handleResult","#retryAttempt","#firstFailedAt"],"sources":["../../src/core/conflict.ts","../../src/core/errors.ts","../../src/core/event-bus.ts","../../src/core/engine.ts","../../src/core/scheduler.ts"],"sourcesContent":["import { compareHLC } from \"../utils\";\nimport type { Change, DeviceId } from \"./types\";\n\nexport interface ConflictContext {\n  readonly local: Change;\n  readonly remote: Change;\n  readonly deviceId: DeviceId;\n}\n\nexport interface ConflictResolution {\n  readonly winner: Change;\n  readonly strategy: string;\n}\n\nexport interface ConflictResolver {\n  resolve(context: ConflictContext): ConflictResolution;\n}\n\nexport class LWWResolver implements ConflictResolver {\n  resolve(context: ConflictContext): ConflictResolution {\n    const { local, remote } = context;\n\n    if (local.action === \"delete\" && remote.action !== \"delete\") {\n      return { winner: local, strategy: \"Tombstone wins over non-delete change\" };\n    }\n\n    if (remote.action === \"delete\" && local.action !== \"delete\") {\n      return { winner: remote, strategy: \"Tombstone wins over non-delete change\" };\n    }\n\n    const order = compareHLC(remote.version, local.version);\n\n    if (order > 0) {\n      return { winner: remote, strategy: \"LWW: remote version newer\" };\n    }\n\n    if (order < 0) {\n      return { winner: local, strategy: \"LWW: local version newer\" };\n    }\n\n    return { winner: remote, strategy: \"LWW: equal version, remote wins\" };\n  }\n}\n","import type { SyncError, SyncErrorCode } from \"./types\";\n\nexport function createSyncError(code: SyncErrorCode, message: string, cause?: unknown): SyncError {\n  return {\n    code,\n    message,\n    cause,\n    occurredAt: Date.now(),\n  };\n}\n\nexport function isSyncError(error: unknown): error is SyncError {\n  return (\n    typeof error === \"object\" &&\n    error !== null &&\n    \"code\" in error &&\n    \"message\" in error &&\n    \"occurredAt\" in error\n  );\n}\n\nexport function normalizeSyncError(error: unknown): SyncError {\n  if (isSyncError(error)) {\n    return error;\n  }\n\n  if (error instanceof Error) {\n    return createSyncError(\"UNKNOWN\", error.message, error);\n  }\n\n  return createSyncError(\"UNKNOWN\", \"Unknown sync error.\", error);\n}\n","import type { Change, SyncError, SyncResult, SyncStatus } from \"./types\";\nimport type { ConflictResolution } from \"./conflict\";\n\nexport interface SyncEventMap {\n  readonly syncStart: void;\n  readonly syncFinish: SyncResult;\n  readonly statusChange: SyncStatus;\n  readonly uploadComplete: { readonly uploadedCount: number };\n  readonly downloadComplete: { readonly downloadedCount: number };\n  readonly conflictResolved: ConflictResolution;\n  readonly error: SyncError;\n  readonly deadLetter: { readonly changes: ReadonlyArray<Change>; readonly error: SyncError };\n}\n\nexport type SyncEventListener<K extends keyof SyncEventMap> = SyncEventMap[K] extends void\n  ? () => void\n  : (payload: SyncEventMap[K]) => void;\n\nexport interface SyncEventBus {\n  on<K extends keyof SyncEventMap>(event: K, listener: SyncEventListener<K>): () => void;\n  once<K extends keyof SyncEventMap>(event: K, listener: SyncEventListener<K>): void;\n  off<K extends keyof SyncEventMap>(event: K, listener: SyncEventListener<K>): void;\n}\n\nexport class TypedSyncEventBus implements SyncEventBus {\n  readonly #listeners = new Map<keyof SyncEventMap, Set<SyncEventListener<keyof SyncEventMap>>>();\n\n  on<K extends keyof SyncEventMap>(event: K, listener: SyncEventListener<K>): () => void {\n    const listeners =\n      this.#listeners.get(event) ?? new Set<SyncEventListener<keyof SyncEventMap>>();\n    listeners.add(listener as SyncEventListener<keyof SyncEventMap>);\n    this.#listeners.set(event, listeners);\n\n    return () => this.off(event, listener);\n  }\n\n  once<K extends keyof SyncEventMap>(event: K, listener: SyncEventListener<K>): void {\n    const wrapped = ((payload?: SyncEventMap[K]) => {\n      this.off(event, wrapped as SyncEventListener<K>);\n      if (payload === undefined) {\n        (listener as () => void)();\n      } else {\n        (listener as (value: SyncEventMap[K]) => void)(payload);\n      }\n    }) as SyncEventListener<K>;\n\n    this.on(event, wrapped);\n  }\n\n  off<K extends keyof SyncEventMap>(event: K, listener: SyncEventListener<K>): void {\n    this.#listeners.get(event)?.delete(listener as SyncEventListener<keyof SyncEventMap>);\n  }\n\n  emit<K extends keyof SyncEventMap>(\n    event: K,\n    ...args: SyncEventMap[K] extends void ? [] : [SyncEventMap[K]]\n  ): void {\n    const listeners = [...(this.#listeners.get(event) ?? [])] as Array<SyncEventListener<K>>;\n\n    for (const listener of listeners) {\n      if (args.length === 0) {\n        (listener as () => void)();\n      } else {\n        (listener as (payload: SyncEventMap[K]) => void)(args[0] as SyncEventMap[K]);\n      }\n    }\n  }\n}\n","import { LWWResolver, type ConflictResolver } from \"./conflict\";\nimport { normalizeSyncError } from \"./errors\";\nimport { TypedSyncEventBus } from \"./event-bus\";\nimport type { DatabaseAdapter, DeviceId, SyncResult, SyncStatus, SyncTransport } from \"./types\";\n\nexport interface SyncEngineOptions {\n  readonly database: DatabaseAdapter;\n  readonly transport: SyncTransport;\n  readonly resolver?: ConflictResolver;\n  readonly deviceId: DeviceId;\n  readonly batchSize?: number;\n}\n\nexport class SyncEngine {\n  readonly #database: DatabaseAdapter;\n  readonly #transport: SyncTransport;\n  readonly #deviceId: DeviceId;\n  readonly #batchSize: number;\n  readonly #unsubscribe?: () => void;\n  #status: SyncStatus = \"idle\";\n  #inFlight: Promise<SyncResult> | null = null;\n\n  readonly resolver: ConflictResolver;\n  readonly events = new TypedSyncEventBus();\n\n  constructor(options: SyncEngineOptions) {\n    this.#database = options.database;\n    this.#transport = options.transport;\n    this.#deviceId = options.deviceId;\n    this.#batchSize = options.batchSize ?? 100;\n    this.resolver = options.resolver ?? new LWWResolver();\n    this.#unsubscribe = this.#transport.subscribe?.(() => {\n      void this.sync();\n    });\n  }\n\n  get status(): SyncStatus {\n    return this.#status;\n  }\n\n  sync(): Promise<SyncResult> {\n    if (this.#inFlight !== null) {\n      return this.#inFlight;\n    }\n\n    this.#inFlight = this.#syncOnce().finally(() => {\n      this.#inFlight = null;\n    });\n\n    return this.#inFlight;\n  }\n\n  async dispose(): Promise<void> {\n    this.#unsubscribe?.();\n  }\n\n  async #syncOnce(): Promise<SyncResult> {\n    const startedAt = Date.now();\n    let uploadedCount = 0;\n    let downloadedCount = 0;\n\n    this.events.emit(\"syncStart\");\n\n    try {\n      this.#setStatus(\"uploading\");\n      const pendingChanges = await this.#database.getPendingChanges(this.#batchSize);\n\n      if (pendingChanges.length > 0) {\n        await this.#transport.push({ changes: pendingChanges, deviceId: this.#deviceId });\n        await this.#database.markAsSynced(pendingChanges.map((change) => change.id));\n        uploadedCount = pendingChanges.length;\n      }\n\n      this.events.emit(\"uploadComplete\", { uploadedCount });\n\n      let cursor = await this.#database.getLocalCursor();\n      let hasMore = true;\n\n      while (hasMore) {\n        this.#setStatus(\"downloading\");\n        // Cursor pagination is stateful; each pull depends on the cursor returned by the previous page.\n        // oxlint-disable-next-line no-await-in-loop\n        const pulled = await this.#transport.pull(cursor?.value ?? null, this.#batchSize);\n        this.events.emit(\"downloadComplete\", { downloadedCount: pulled.changes.length });\n\n        this.#setStatus(\"applying\");\n        // oxlint-disable-next-line no-await-in-loop\n        await this.#database.runInTransaction(async () => {\n          await this.#database.applyRemoteChanges([...pulled.changes]);\n          await this.#database.saveLocalCursor(pulled.cursor);\n        });\n\n        downloadedCount += pulled.changes.length;\n        cursor = pulled.cursor;\n        hasMore = pulled.hasMore;\n      }\n\n      this.#setStatus(\"idle\");\n\n      const result: SyncResult = {\n        success: true,\n        uploadedCount,\n        downloadedCount,\n        durationMs: Date.now() - startedAt,\n      };\n      this.events.emit(\"syncFinish\", result);\n\n      return result;\n    } catch (cause) {\n      const error = normalizeSyncError(cause);\n      const result: SyncResult = {\n        success: false,\n        uploadedCount,\n        downloadedCount,\n        durationMs: Date.now() - startedAt,\n        error,\n      };\n\n      this.events.emit(\"error\", error);\n      this.#setStatus(\"idle\");\n      this.events.emit(\"syncFinish\", result);\n\n      return result;\n    }\n  }\n\n  #setStatus(status: SyncStatus): void {\n    this.#status = status;\n    this.events.emit(\"statusChange\", status);\n  }\n}\n","import { ExponentialBackoffPolicy, type RetryPolicy } from \"../utils\";\nimport type { DatabaseAdapter, SyncResult } from \"./types\";\n\nexport interface SyncSchedulerEngine {\n  sync(): Promise<SyncResult>;\n}\n\nexport interface SyncSchedulerDatabase {\n  clearTombstones(beforeTimestamp: number): Promise<number>;\n}\n\nexport interface SchedulerOptions {\n  readonly intervalMs?: number;\n  readonly retryPolicy?: RetryPolicy;\n  readonly syncOnNetworkRecover?: boolean;\n  readonly syncOnForeground?: boolean;\n  readonly tombstoneCleanupIntervalMs?: number;\n  readonly tombstoneMaxAgeMs?: number;\n}\n\nexport interface DefaultSyncSchedulerOptions {\n  readonly engine: SyncSchedulerEngine;\n  readonly database?: SyncSchedulerDatabase | Pick<DatabaseAdapter, \"clearTombstones\">;\n  readonly retryPolicy?: RetryPolicy;\n  readonly window?: Pick<Window, \"addEventListener\" | \"removeEventListener\">;\n  readonly document?: Pick<\n    Document,\n    \"addEventListener\" | \"removeEventListener\" | \"visibilityState\"\n  >;\n}\n\nexport interface SyncScheduler {\n  start(options?: SchedulerOptions): void;\n  stop(): void;\n  triggerSync(): Promise<SyncResult>;\n}\n\nconst DEFAULT_INTERVAL_MS = 30_000;\nconst DEFAULT_TOMBSTONE_CLEANUP_INTERVAL_MS = 7 * 24 * 60 * 60 * 1_000;\nconst DEFAULT_TOMBSTONE_MAX_AGE_MS = 30 * 24 * 60 * 60 * 1_000;\n\nexport class DefaultSyncScheduler implements SyncScheduler {\n  readonly #engine: SyncSchedulerEngine;\n  readonly #database?: SyncSchedulerDatabase;\n  readonly #defaultRetryPolicy: RetryPolicy;\n  readonly #window?: Pick<Window, \"addEventListener\" | \"removeEventListener\">;\n  readonly #document?: Pick<\n    Document,\n    \"addEventListener\" | \"removeEventListener\" | \"visibilityState\"\n  >;\n  #syncTimer: ReturnType<typeof setInterval> | null = null;\n  #retryTimer: ReturnType<typeof setTimeout> | null = null;\n  #tombstoneTimer: ReturnType<typeof setInterval> | null = null;\n  #inFlight: Promise<SyncResult> | null = null;\n  #retryAttempt = 0;\n  #firstFailedAt = 0;\n  #retryPolicy: RetryPolicy;\n  #handleOnline = (): void => {\n    void this.triggerSync();\n  };\n  #handleVisibilityChange = (): void => {\n    if (this.#document?.visibilityState === \"visible\") {\n      void this.triggerSync();\n    }\n  };\n\n  constructor(options: DefaultSyncSchedulerOptions) {\n    this.#engine = options.engine;\n    this.#database = options.database;\n    this.#defaultRetryPolicy = options.retryPolicy ?? new ExponentialBackoffPolicy();\n    this.#retryPolicy = this.#defaultRetryPolicy;\n    this.#window = options.window ?? globalThis.window;\n    this.#document = options.document ?? globalThis.document;\n  }\n\n  start(options: SchedulerOptions = {}): void {\n    this.stop();\n    this.#retryPolicy = options.retryPolicy ?? this.#defaultRetryPolicy;\n\n    const intervalMs = options.intervalMs ?? DEFAULT_INTERVAL_MS;\n    if (intervalMs > 0) {\n      this.#syncTimer = setInterval(() => {\n        void this.triggerSync();\n      }, intervalMs);\n    }\n\n    if (options.syncOnNetworkRecover ?? true) {\n      this.#window?.addEventListener(\"online\", this.#handleOnline);\n    }\n\n    if (options.syncOnForeground ?? true) {\n      this.#document?.addEventListener(\"visibilitychange\", this.#handleVisibilityChange);\n    }\n\n    const tombstoneCleanupIntervalMs =\n      options.tombstoneCleanupIntervalMs ?? DEFAULT_TOMBSTONE_CLEANUP_INTERVAL_MS;\n    if (this.#database !== undefined && tombstoneCleanupIntervalMs > 0) {\n      const tombstoneMaxAgeMs = options.tombstoneMaxAgeMs ?? DEFAULT_TOMBSTONE_MAX_AGE_MS;\n      this.#tombstoneTimer = setInterval(() => {\n        void this.#database?.clearTombstones(Date.now() - tombstoneMaxAgeMs);\n      }, tombstoneCleanupIntervalMs);\n    }\n  }\n\n  stop(): void {\n    if (this.#syncTimer !== null) {\n      clearInterval(this.#syncTimer);\n      this.#syncTimer = null;\n    }\n\n    if (this.#retryTimer !== null) {\n      clearTimeout(this.#retryTimer);\n      this.#retryTimer = null;\n    }\n\n    if (this.#tombstoneTimer !== null) {\n      clearInterval(this.#tombstoneTimer);\n      this.#tombstoneTimer = null;\n    }\n\n    this.#window?.removeEventListener(\"online\", this.#handleOnline);\n    this.#document?.removeEventListener(\"visibilitychange\", this.#handleVisibilityChange);\n  }\n\n  async triggerSync(): Promise<SyncResult> {\n    if (this.#inFlight !== null) {\n      return await this.#inFlight;\n    }\n\n    this.#inFlight = this.#engine.sync().then((result) => {\n      this.#handleResult(result);\n      return result;\n    });\n\n    try {\n      return await this.#inFlight;\n    } finally {\n      this.#inFlight = null;\n    }\n  }\n\n  #handleResult(result: SyncResult): void {\n    if (result.success) {\n      this.#retryAttempt = 0;\n      this.#firstFailedAt = 0;\n      return;\n    }\n\n    if (result.error === undefined) {\n      return;\n    }\n\n    this.#firstFailedAt = this.#firstFailedAt === 0 ? result.error.occurredAt : this.#firstFailedAt;\n    const decision = this.#retryPolicy.decide({\n      attempt: this.#retryAttempt,\n      firstFailedAt: this.#firstFailedAt,\n      lastError: result.error,\n    });\n\n    this.#retryAttempt += 1;\n\n    if (decision.action === \"abort\") {\n      return;\n    }\n\n    if (this.#retryTimer !== null) {\n      clearTimeout(this.#retryTimer);\n    }\n\n    this.#retryTimer = setTimeout(() => {\n      this.#retryTimer = null;\n      void this.triggerSync();\n    }, decision.delayMs);\n  }\n}\n"],"mappings":"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"}

package/dist/http/index.cjs

@@ -0,0 +1,184 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_utils_index = require("../utils/index.cjs");
+const require_core_index = require("../core/index.cjs");
+//#region src/http/fetch-transport.ts
+var FetchSyncTransport = class {
+	type = "http";
+	#baseUrl;
+	#fetch;
+	#headers;
+	#retryPolicy;
+	constructor(options) {
+		this.#baseUrl = options.baseUrl.replace(/\/+$/, "");
+		this.#fetch = options.fetch ?? globalThis.fetch.bind(globalThis);
+		this.#headers = options.headers ?? {};
+		this.#retryPolicy = options.retryPolicy ?? new require_utils_index.ExponentialBackoffPolicy();
+	}
+	async push(payload) {
+		await require_utils_index.retryOperation(async () => {
+			await ensureOk(await this.#fetch(`${this.#baseUrl}/push`, {
+				method: "POST",
+				headers: this.#createHeaders(),
+				body: JSON.stringify(payload)
+			}));
+		}, {
+			policy: this.#retryPolicy,
+			normalizeError: require_core_index.normalizeSyncError
+		});
+	}
+	async pull(cursor, limit) {
+		return await require_utils_index.retryOperation(async () => {
+			const url = new URL(`${this.#baseUrl}/pull`);
+			if (cursor !== null && cursor.length > 0) url.searchParams.set("cursor", cursor);
+			if (limit !== void 0) url.searchParams.set("limit", limit.toString());
+			const response = await this.#fetch(url.toString(), {
+				method: "GET",
+				headers: this.#createHeaders()
+			});
+			await ensureOk(response);
+			return await response.json();
+		}, {
+			policy: this.#retryPolicy,
+			normalizeError: require_core_index.normalizeSyncError
+		});
+	}
+	#createHeaders() {
+		return {
+			"Content-Type": "application/json",
+			...this.#headers
+		};
+	}
+};
+async function ensureOk(response) {
+	if (response.ok) return;
+	throw require_core_index.createSyncError(codeFromStatus(response.status), `Sync HTTP request failed with status ${response.status}.`, await response.text());
+}
+function codeFromStatus(status) {
+	if (status === 401 || status === 403) return "AUTH_FAILED";
+	if (status === 410) return "CURSOR_EXPIRED";
+	if (status >= 500) return "SERVER_ERROR";
+	return "TRANSPORT_ERROR";
+}
+//#endregion
+//#region src/http/websocket-transport.ts
+var WebSocketSyncTransport = class {
+	type = "websocket";
+	#url;
+	#WebSocket;
+	#requestTimeoutMs;
+	#retryPolicy;
+	#subscribers = /* @__PURE__ */ new Set();
+	#pending = /* @__PURE__ */ new Map();
+	#socket = null;
+	constructor(options) {
+		this.#url = options.url;
+		this.#WebSocket = options.WebSocket ?? globalThis.WebSocket;
+		this.#requestTimeoutMs = options.requestTimeoutMs ?? 3e4;
+		this.#retryPolicy = options.retryPolicy ?? new require_utils_index.ExponentialBackoffPolicy();
+	}
+	async push(payload) {
+		await require_utils_index.retryOperation(async () => {
+			if ((await this.#request({
+				type: "push",
+				payload
+			})).type !== "pushResult") throw require_core_index.createSyncError("SERIALIZATION_ERROR", "Unexpected WebSocket push response.");
+		}, {
+			policy: this.#retryPolicy,
+			normalizeError: require_core_index.normalizeSyncError
+		});
+	}
+	async pull(cursor, limit) {
+		return await require_utils_index.retryOperation(async () => {
+			const message = await this.#request({
+				type: "pull",
+				cursor,
+				limit
+			});
+			if (message.type !== "pullResult") throw require_core_index.createSyncError("SERIALIZATION_ERROR", "Unexpected WebSocket pull response.");
+			return message.result;
+		}, {
+			policy: this.#retryPolicy,
+			normalizeError: require_core_index.normalizeSyncError
+		});
+	}
+	subscribe(onChanges) {
+		this.#subscribers.add(onChanges);
+		this.#connect();
+		return () => {
+			this.#subscribers.delete(onChanges);
+		};
+	}
+	close() {
+		this.#socket?.close();
+		this.#socket = null;
+		for (const pending of this.#pending.values()) {
+			clearTimeout(pending.timeout);
+			pending.reject(require_core_index.createSyncError("TRANSPORT_ERROR", "WebSocket transport closed."));
+		}
+		this.#pending.clear();
+	}
+	async #request(payload) {
+		const socket = await this.#connect();
+		const id = crypto.randomUUID();
+		const message = JSON.stringify({
+			id,
+			...payload
+		});
+		return await new Promise((resolve, reject) => {
+			const timeout = setTimeout(() => {
+				this.#pending.delete(id);
+				reject(require_core_index.createSyncError("NETWORK_UNAVAILABLE", "WebSocket sync request timed out."));
+			}, this.#requestTimeoutMs);
+			this.#pending.set(id, {
+				resolve,
+				reject,
+				timeout
+			});
+			socket.send(message);
+		});
+	}
+	async #connect() {
+		if (this.#socket?.readyState === this.#WebSocket.OPEN) return this.#socket;
+		const socket = new this.#WebSocket(this.#url);
+		this.#socket = socket;
+		socket.addEventListener("message", (event) => this.#handleMessage(event));
+		if (socket.readyState === this.#WebSocket.OPEN) return socket;
+		return await new Promise((resolve, reject) => {
+			const handleOpen = () => {
+				cleanup();
+				resolve(socket);
+			};
+			const handleError = () => {
+				cleanup();
+				reject(require_core_index.createSyncError("NETWORK_UNAVAILABLE", "WebSocket connection failed."));
+			};
+			const cleanup = () => {
+				socket.removeEventListener("open", handleOpen);
+				socket.removeEventListener("error", handleError);
+			};
+			socket.addEventListener("open", handleOpen);
+			socket.addEventListener("error", handleError);
+		});
+	}
+	#handleMessage(event) {
+		const rawData = "data" in event ? event.data : void 0;
+		if (typeof rawData !== "string") return;
+		const message = JSON.parse(rawData);
+		if (message.type === "changes") {
+			for (const subscriber of this.#subscribers) subscriber(message.cursor);
+			return;
+		}
+		const pending = this.#pending.get(message.id);
+		if (pending === void 0) return;
+		clearTimeout(pending.timeout);
+		this.#pending.delete(message.id);
+		if ("error" in message && message.error !== void 0) {
+			pending.reject(require_core_index.createSyncError("TRANSPORT_ERROR", message.error.message ?? "WebSocket sync request failed.", message.error));
+			return;
+		}
+		pending.resolve(message);
+	}
+};
+//#endregion
+exports.FetchSyncTransport = FetchSyncTransport;
+exports.WebSocketSyncTransport = WebSocketSyncTransport;

package/dist/http/index.d.cts

@@ -0,0 +1,37 @@
+import { s as RetryPolicy } from "../index.cjs";
+import { T as PushPayload, j as SyncTransport, w as PullResult } from "../index2.cjs";
+
+//#region src/http/fetch-transport.d.ts
+interface FetchSyncTransportOptions {
+  readonly baseUrl: string;
+  readonly fetch?: typeof fetch;
+  readonly headers?: Record<string, string>;
+  readonly retryPolicy?: RetryPolicy;
+}
+declare class FetchSyncTransport implements SyncTransport {
+  #private;
+  readonly type = "http";
+  constructor(options: FetchSyncTransportOptions);
+  push(payload: PushPayload): Promise<void>;
+  pull(cursor: string | null, limit?: number): Promise<PullResult>;
+}
+//#endregion
+//#region src/http/websocket-transport.d.ts
+interface WebSocketSyncTransportOptions {
+  readonly url: string;
+  readonly WebSocket?: typeof globalThis.WebSocket;
+  readonly requestTimeoutMs?: number;
+  readonly retryPolicy?: RetryPolicy;
+}
+declare class WebSocketSyncTransport implements SyncTransport {
+  #private;
+  readonly type = "websocket";
+  constructor(options: WebSocketSyncTransportOptions);
+  push(payload: PushPayload): Promise<void>;
+  pull(cursor: string | null, limit?: number): Promise<PullResult>;
+  subscribe(onChanges: (cursor: string) => void): () => void;
+  close(): void;
+}
+//#endregion
+export { FetchSyncTransport, FetchSyncTransportOptions, WebSocketSyncTransport, WebSocketSyncTransportOptions };
+//# sourceMappingURL=index.d.cts.map

package/dist/http/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/http/fetch-transport.ts","../../src/http/websocket-transport.ts"],"mappings":";;;;UAKiB,yBAAA;EAAA,SACN,OAAA;EAAA,SACA,KAAA,UAAe,KAAA;EAAA,SACf,OAAA,GAAU,MAAA;EAAA,SACV,WAAA,GAAc,WAAA;AAAA;AAAA,cAGZ,kBAAA,YAA8B,aAAA;EAAA;WAChC,IAAA;cAMG,OAAA,EAAS,yBAAA;EAOf,IAAA,CAAK,OAAA,EAAS,WAAA,GAAc,OAAA;EAe5B,IAAA,CAAK,MAAA,iBAAuB,KAAA,YAAiB,OAAA,CAAQ,UAAA;AAAA;;;UCrC5C,6BAAA;EAAA,SACN,GAAA;EAAA,SACA,SAAA,UAAmB,UAAA,CAAW,SAAA;EAAA,SAC9B,gBAAA;EAAA,SACA,WAAA,GAAc,WAAW;AAAA;AAAA,cAkBvB,sBAAA,YAAkC,aAAA;EAAA;WACpC,IAAA;cAgBG,OAAA,EAAS,6BAAA;EAOf,IAAA,CAAK,OAAA,EAAS,WAAA,GAAc,OAAA;EAY5B,IAAA,CAAK,MAAA,iBAAuB,KAAA,YAAiB,OAAA,CAAQ,UAAA;EAa3D,SAAA,CAAU,SAAA,GAAY,MAAA;EAQtB,KAAA;AAAA"}

package/dist/http/index.d.mts

@@ -0,0 +1,37 @@
+import { s as RetryPolicy } from "../index.mjs";
+import { T as PushPayload, j as SyncTransport, w as PullResult } from "../index2.mjs";
+
+//#region src/http/fetch-transport.d.ts
+interface FetchSyncTransportOptions {
+  readonly baseUrl: string;
+  readonly fetch?: typeof fetch;
+  readonly headers?: Record<string, string>;
+  readonly retryPolicy?: RetryPolicy;
+}
+declare class FetchSyncTransport implements SyncTransport {
+  #private;
+  readonly type = "http";
+  constructor(options: FetchSyncTransportOptions);
+  push(payload: PushPayload): Promise<void>;
+  pull(cursor: string | null, limit?: number): Promise<PullResult>;
+}
+//#endregion
+//#region src/http/websocket-transport.d.ts
+interface WebSocketSyncTransportOptions {
+  readonly url: string;
+  readonly WebSocket?: typeof globalThis.WebSocket;
+  readonly requestTimeoutMs?: number;
+  readonly retryPolicy?: RetryPolicy;
+}
+declare class WebSocketSyncTransport implements SyncTransport {
+  #private;
+  readonly type = "websocket";
+  constructor(options: WebSocketSyncTransportOptions);
+  push(payload: PushPayload): Promise<void>;
+  pull(cursor: string | null, limit?: number): Promise<PullResult>;
+  subscribe(onChanges: (cursor: string) => void): () => void;
+  close(): void;
+}
+//#endregion
+export { FetchSyncTransport, FetchSyncTransportOptions, WebSocketSyncTransport, WebSocketSyncTransportOptions };
+//# sourceMappingURL=index.d.mts.map

package/dist/http/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/http/fetch-transport.ts","../../src/http/websocket-transport.ts"],"mappings":";;;;UAKiB,yBAAA;EAAA,SACN,OAAA;EAAA,SACA,KAAA,UAAe,KAAA;EAAA,SACf,OAAA,GAAU,MAAA;EAAA,SACV,WAAA,GAAc,WAAA;AAAA;AAAA,cAGZ,kBAAA,YAA8B,aAAA;EAAA;WAChC,IAAA;cAMG,OAAA,EAAS,yBAAA;EAOf,IAAA,CAAK,OAAA,EAAS,WAAA,GAAc,OAAA;EAe5B,IAAA,CAAK,MAAA,iBAAuB,KAAA,YAAiB,OAAA,CAAQ,UAAA;AAAA;;;UCrC5C,6BAAA;EAAA,SACN,GAAA;EAAA,SACA,SAAA,UAAmB,UAAA,CAAW,SAAA;EAAA,SAC9B,gBAAA;EAAA,SACA,WAAA,GAAc,WAAW;AAAA;AAAA,cAkBvB,sBAAA,YAAkC,aAAA;EAAA;WACpC,IAAA;cAgBG,OAAA,EAAS,6BAAA;EAOf,IAAA,CAAK,OAAA,EAAS,WAAA,GAAc,OAAA;EAY5B,IAAA,CAAK,MAAA,iBAAuB,KAAA,YAAiB,OAAA,CAAQ,UAAA;EAa3D,SAAA,CAAU,SAAA,GAAY,MAAA;EAQtB,KAAA;AAAA"}