@fragno-dev/tanstack-db-adapter 0.0.0-stage → 0.0.0

package/dist/coordinator/fragno-internal-collection.js

@@ -0,0 +1,142 @@
+import { createCollection } from "@tanstack/db";
+import { persistedCollectionOptions } from "@tanstack/db-sqlite-persistence-core";
+//#region src/coordinator/fragno-internal-collection.ts
+const FRAGNO_INTERNAL_COLLECTION_ID = "fragno.outbox.internal.v1";
+const FRAGNO_INTERNAL_STATUS_ID = "coordinator";
+const FRAGNO_INTERNAL_CHECKPOINT_METADATA_KEY = "fragno.outbox.checkpoint.v1";
+const FRAGNO_INTERNAL_FLUSH_MARKER_METADATA_KEY = "fragno.outbox.flush-marker.v1";
+/** Persisted and user-queryable coordinator state for one Fragno outbox database. */
+var FragnoInternalCollection = class {
+	collection;
+	#controls;
+	#preloadPromise;
+	#checkpoint;
+	#status;
+	constructor(options) {
+		const persistence = resolveCollectionPersistence(options.persistence, FRAGNO_INTERNAL_COLLECTION_ID, options.schemaVersion);
+		this.#status = {
+			id: FRAGNO_INTERNAL_STATUS_ID,
+			state: options.state ?? "opening",
+			checkpoint: null,
+			error: null
+		};
+		this.collection = createCollection(persistedCollectionOptions({
+			id: FRAGNO_INTERNAL_COLLECTION_ID,
+			getKey: (row) => row.id,
+			persistence,
+			schemaVersion: options.schemaVersion,
+			syncMode: "eager",
+			sync: {
+				rowUpdateMode: "full",
+				sync: (controls) => {
+					if (!controls.metadata) throw new Error("Fragno internal collection requires TanStack sync metadata.");
+					this.#controls = controls;
+					this.#checkpoint = controls.metadata.collection.get(FRAGNO_INTERNAL_CHECKPOINT_METADATA_KEY);
+					this.#status = {
+						...this.#status,
+						checkpoint: this.#checkpoint ?? null
+					};
+					controls.markReady();
+					return () => {
+						if (this.#controls === controls) this.#controls = void 0;
+					};
+				}
+			}
+		}));
+	}
+	preload() {
+		if (this.#preloadPromise) return this.#preloadPromise;
+		this.#preloadPromise = this.collection.preload().then(async () => {
+			await this.#publishStatus();
+		});
+		return this.#preloadPromise;
+	}
+	getCheckpoint() {
+		return this.#checkpoint;
+	}
+	setCheckpoint(checkpoint) {
+		this.#checkpoint = checkpoint;
+		this.#status = {
+			...this.#status,
+			checkpoint
+		};
+		const controls = this.#requireControls();
+		controls.begin();
+		controls.metadata.collection.set(FRAGNO_INTERNAL_CHECKPOINT_METADATA_KEY, checkpoint);
+		controls.write({
+			type: "update",
+			value: this.#status
+		});
+		return controls.commit();
+	}
+	/**
+	* Settles once every earlier write in the shared persistence database is durable: a persisted
+	* commit's receipt settles with its durable write, and writes persist in order.
+	*/
+	flushPersistence() {
+		const controls = this.#requireControls();
+		controls.begin();
+		controls.metadata.collection.set(FRAGNO_INTERNAL_FLUSH_MARKER_METADATA_KEY, globalThis.crypto.randomUUID());
+		return controls.commit();
+	}
+	clearCheckpoint() {
+		this.#checkpoint = void 0;
+		this.#status = {
+			...this.#status,
+			checkpoint: null
+		};
+		const controls = this.#requireControls();
+		controls.begin();
+		controls.metadata.collection.delete(FRAGNO_INTERNAL_CHECKPOINT_METADATA_KEY);
+		controls.write({
+			type: "update",
+			value: this.#status
+		});
+		return controls.commit();
+	}
+	setState(state, error = null) {
+		this.#status = {
+			...this.#status,
+			state,
+			error: state === "failed" ? coordinatorError(error) : null
+		};
+		return this.#publishStatus();
+	}
+	cleanup() {
+		return this.collection.cleanup().then(() => {});
+	}
+	#publishStatus() {
+		const controls = this.#requireControls();
+		controls.begin();
+		controls.write({
+			type: "update",
+			value: this.#status
+		});
+		return controls.commit();
+	}
+	#requireControls() {
+		if (!this.#controls) throw new Error("Fragno internal collection has not been preloaded.");
+		return this.#controls;
+	}
+};
+function coordinatorError(error) {
+	if (error instanceof Error) return {
+		name: error.name,
+		message: error.message
+	};
+	return {
+		name: "Error",
+		message: String(error)
+	};
+}
+function resolveCollectionPersistence(persistence, collectionId, schemaVersion) {
+	return persistence.resolvePersistenceForCollection?.({
+		collectionId,
+		mode: "sync-present",
+		schemaVersion
+	}) ?? persistence.resolvePersistenceForMode?.("sync-present") ?? persistence;
+}
+//#endregion
+export { FRAGNO_INTERNAL_CHECKPOINT_METADATA_KEY, FRAGNO_INTERNAL_COLLECTION_ID, FRAGNO_INTERNAL_STATUS_ID, FragnoInternalCollection };
+
+//# sourceMappingURL=fragno-internal-collection.js.map

package/dist/coordinator/fragno-internal-collection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fragno-internal-collection.js","names":["#status","#controls","#checkpoint","#preloadPromise","#publishStatus","#requireControls"],"sources":["../../src/coordinator/fragno-internal-collection.ts"],"sourcesContent":["import {\n  createCollection,\n  type Collection,\n  type SyncAppliedReceipt,\n  type SyncConfig,\n} from \"@tanstack/db\";\nimport {\n  persistedCollectionOptions,\n  type PersistedCollectionPersistence,\n} from \"@tanstack/db-sqlite-persistence-core\";\n\nimport type { FragnoOutboxCheckpoint } from \"../checkpoint\";\n\nexport const FRAGNO_INTERNAL_COLLECTION_ID = \"fragno.outbox.internal.v1\";\nexport const FRAGNO_INTERNAL_STATUS_ID = \"coordinator\" as const;\nexport const FRAGNO_INTERNAL_CHECKPOINT_METADATA_KEY = \"fragno.outbox.checkpoint.v1\";\nconst FRAGNO_INTERNAL_FLUSH_MARKER_METADATA_KEY = \"fragno.outbox.flush-marker.v1\";\n\nexport type FragnoOutboxCoordinatorState =\n  | \"opening\"\n  | \"idle\"\n  | \"registering\"\n  | \"catching-up\"\n  | \"replaying\"\n  | \"live\"\n  | \"retrying\"\n  | \"rotating\"\n  | \"failed\"\n  | \"disposed\";\n\nexport type FragnoOutboxCoordinatorError = {\n  name: string;\n  message: string;\n};\n\nexport type FragnoInternalRow = {\n  id: typeof FRAGNO_INTERNAL_STATUS_ID;\n  state: FragnoOutboxCoordinatorState;\n  checkpoint: FragnoOutboxCheckpoint | null;\n  error: FragnoOutboxCoordinatorError | null;\n};\n\ntype FragnoInternalSyncControls = Parameters<SyncConfig<FragnoInternalRow, string>[\"sync\"]>[0];\n\n/** Persisted and user-queryable coordinator state for one Fragno outbox database. */\nexport class FragnoInternalCollection {\n  readonly collection: Collection<FragnoInternalRow, string>;\n\n  #controls: FragnoInternalSyncControls | undefined;\n  #preloadPromise: Promise<void> | undefined;\n  #checkpoint: FragnoOutboxCheckpoint | undefined;\n  #status: FragnoInternalRow;\n\n  constructor(options: {\n    persistence: PersistedCollectionPersistence;\n    schemaVersion?: number;\n    state?: FragnoOutboxCoordinatorState;\n  }) {\n    const persistence = resolveCollectionPersistence(\n      options.persistence,\n      FRAGNO_INTERNAL_COLLECTION_ID,\n      options.schemaVersion,\n    );\n    this.#status = {\n      id: FRAGNO_INTERNAL_STATUS_ID,\n      state: options.state ?? \"opening\",\n      checkpoint: null,\n      error: null,\n    };\n\n    this.collection = createCollection(\n      persistedCollectionOptions<FragnoInternalRow, string>({\n        id: FRAGNO_INTERNAL_COLLECTION_ID,\n        getKey: (row) => row.id,\n        persistence,\n        schemaVersion: options.schemaVersion,\n        syncMode: \"eager\",\n        sync: {\n          rowUpdateMode: \"full\",\n          sync: (controls) => {\n            if (!controls.metadata) {\n              throw new Error(\"Fragno internal collection requires TanStack sync metadata.\");\n            }\n\n            this.#controls = controls;\n            this.#checkpoint = controls.metadata.collection.get(\n              FRAGNO_INTERNAL_CHECKPOINT_METADATA_KEY,\n            ) as FragnoOutboxCheckpoint | undefined;\n            this.#status = {\n              ...this.#status,\n              checkpoint: this.#checkpoint ?? null,\n            };\n            controls.markReady();\n\n            return () => {\n              if (this.#controls === controls) {\n                this.#controls = undefined;\n              }\n            };\n          },\n        },\n      }),\n    );\n  }\n\n  preload(): Promise<void> {\n    if (this.#preloadPromise) {\n      return this.#preloadPromise;\n    }\n    this.#preloadPromise = this.collection.preload().then(async () => {\n      await this.#publishStatus();\n    });\n    return this.#preloadPromise;\n  }\n\n  getCheckpoint(): FragnoOutboxCheckpoint | undefined {\n    return this.#checkpoint;\n  }\n\n  setCheckpoint(checkpoint: FragnoOutboxCheckpoint): SyncAppliedReceipt {\n    this.#checkpoint = checkpoint;\n    this.#status = { ...this.#status, checkpoint };\n\n    const controls = this.#requireControls();\n    controls.begin();\n    controls.metadata!.collection.set(FRAGNO_INTERNAL_CHECKPOINT_METADATA_KEY, checkpoint);\n    controls.write({ type: \"update\", value: this.#status });\n    return controls.commit();\n  }\n\n  /**\n   * Settles once every earlier write in the shared persistence database is durable: a persisted\n   * commit's receipt settles with its durable write, and writes persist in order.\n   */\n  flushPersistence(): SyncAppliedReceipt {\n    const controls = this.#requireControls();\n    controls.begin();\n    // A fresh marker gives the commit a change to persist.\n    controls.metadata!.collection.set(\n      FRAGNO_INTERNAL_FLUSH_MARKER_METADATA_KEY,\n      globalThis.crypto.randomUUID(),\n    );\n    return controls.commit();\n  }\n\n  clearCheckpoint(): SyncAppliedReceipt {\n    this.#checkpoint = undefined;\n    this.#status = { ...this.#status, checkpoint: null };\n\n    const controls = this.#requireControls();\n    controls.begin();\n    controls.metadata!.collection.delete(FRAGNO_INTERNAL_CHECKPOINT_METADATA_KEY);\n    controls.write({ type: \"update\", value: this.#status });\n    return controls.commit();\n  }\n\n  setState(state: FragnoOutboxCoordinatorState, error: unknown = null): SyncAppliedReceipt {\n    this.#status = {\n      ...this.#status,\n      state,\n      error: state === \"failed\" ? coordinatorError(error) : null,\n    };\n    return this.#publishStatus();\n  }\n\n  cleanup(): Promise<void> {\n    return this.collection.cleanup().then(() => {});\n  }\n\n  #publishStatus(): SyncAppliedReceipt {\n    const controls = this.#requireControls();\n    controls.begin();\n    controls.write({ type: \"update\", value: this.#status });\n    return controls.commit();\n  }\n\n  #requireControls(): FragnoInternalSyncControls {\n    if (!this.#controls) {\n      throw new Error(\"Fragno internal collection has not been preloaded.\");\n    }\n    return this.#controls;\n  }\n}\n\nfunction coordinatorError(error: unknown): FragnoOutboxCoordinatorError {\n  if (error instanceof Error) {\n    return { name: error.name, message: error.message };\n  }\n\n  return { name: \"Error\", message: String(error) };\n}\n\nfunction resolveCollectionPersistence(\n  persistence: PersistedCollectionPersistence,\n  collectionId: string,\n  schemaVersion: number | undefined,\n): PersistedCollectionPersistence {\n  return (\n    persistence.resolvePersistenceForCollection?.({\n      collectionId,\n      mode: \"sync-present\",\n      schemaVersion,\n    }) ??\n    persistence.resolvePersistenceForMode?.(\"sync-present\") ??\n    persistence\n  );\n}\n"],"mappings":"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"}

package/dist/coordinator/fragno-internal-fetcher.d.ts

@@ -0,0 +1,23 @@
+//#region src/coordinator/fragno-internal-fetcher.d.ts
+type FragnoInternalDescription = {
+  adapterIdentity: string;
+  currentVersionstamp: string | null;
+  fragments: Array<{
+    name: string;
+    mountRoute: string;
+  }>;
+  schemas: Array<{
+    name: string;
+    namespace: string | null;
+    version: number;
+    tables: string[];
+  }>;
+  routes: {
+    internal: "/_internal";
+    outbox?: "/_internal/outbox";
+    outboxStream?: "/_internal/outbox/stream";
+  };
+};
+//#endregion
+export { FragnoInternalDescription };
+//# sourceMappingURL=fragno-internal-fetcher.d.ts.map

package/dist/coordinator/fragno-internal-fetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fragno-internal-fetcher.d.ts","names":[],"sources":["../../src/coordinator/fragno-internal-fetcher.ts"],"mappings":";KAMY;EACV;EACA;EACA,WAAW;IAAQ;IAAc;;EACjC,SAAS;IACP;IACA;IACA;IACA;;EAEF;IACE;IACA;IACA"}

package/dist/coordinator/fragno-internal-fetcher.js

@@ -0,0 +1,60 @@
+import { rethrowOutboxNetworkFailure } from "../outbox-transport-error.js";
+import { FragnoOutboxProtocolError } from "../outbox-stream.js";
+import { FRAGNO_OUTBOX_PAGE_SIZE } from "@fragno-dev/db/outbox";
+//#region src/coordinator/fragno-internal-fetcher.ts
+/** Typed Fetch access to the trusted Fragno internal routes used by outbox synchronization. */
+var FragnoInternalFetcher = class {
+	baseUrl;
+	#fetch;
+	#describeUrl;
+	#outboxStreamUrl;
+	constructor(options) {
+		const baseUrl = new URL(options.baseUrl, globalThis.location?.href);
+		if (baseUrl.protocol !== "http:" && baseUrl.protocol !== "https:") throw new Error("Fragno outbox synchronization requires an HTTP(S) base URL.");
+		baseUrl.hash = "";
+		baseUrl.pathname = baseUrl.pathname.replace(/\/+$/, "");
+		const internalUrl = new URL(baseUrl);
+		internalUrl.pathname = `${baseUrl.pathname}/_internal`;
+		const outboxStreamUrl = new URL(internalUrl);
+		outboxStreamUrl.pathname = `${internalUrl.pathname}/outbox/stream`;
+		this.baseUrl = baseUrl.toString();
+		this.#fetch = options.fetch;
+		this.#describeUrl = internalUrl;
+		this.#outboxStreamUrl = outboxStreamUrl;
+	}
+	async describe(options = {}) {
+		return await (await this.#get(this.#describeUrl, options.signal)).json();
+	}
+	async openOutboxStream(options) {
+		const url = new URL(this.#outboxStreamUrl);
+		url.searchParams.set("protocol", "1");
+		if (options.checkpoint) {
+			url.searchParams.set("afterVersionstamp", options.checkpoint.versionstamp);
+			url.searchParams.set("afterUowId", options.checkpoint.uowId);
+		}
+		url.searchParams.set("limit", String(FRAGNO_OUTBOX_PAGE_SIZE));
+		const request = new Request(url, { signal: options.signal });
+		let response;
+		try {
+			response = await this.#fetch(request);
+		} catch (cause) {
+			rethrowOutboxNetworkFailure(cause, options.signal);
+		}
+		if (!response.ok) {
+			await response.body?.cancel().catch(() => {});
+			if (response.status === 400 || response.status === 409) throw new FragnoOutboxProtocolError(`Fragno outbox stream rejected its protocol or cursor: ${response.status}.`);
+			throw new Error(`Fragno outbox stream request failed: ${response.status} ${response.statusText}`);
+		}
+		if (!response.body) throw new Error("Fragno outbox stream response has no body.");
+		return response.body;
+	}
+	async #get(url, signal) {
+		const response = await this.#fetch(url, { signal });
+		if (!response.ok) throw new Error(`Fragno internal request failed: ${response.status} ${response.statusText}`);
+		return response;
+	}
+};
+//#endregion
+export { FragnoInternalFetcher };
+
+//# sourceMappingURL=fragno-internal-fetcher.js.map

package/dist/coordinator/fragno-internal-fetcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fragno-internal-fetcher.js","names":["#fetch","#describeUrl","#outboxStreamUrl","#get"],"sources":["../../src/coordinator/fragno-internal-fetcher.ts"],"sourcesContent":["import { FRAGNO_OUTBOX_PAGE_SIZE } from \"@fragno-dev/db/outbox\";\n\nimport type { FragnoOutboxCheckpoint } from \"../checkpoint\";\nimport { FragnoOutboxProtocolError } from \"../outbox-stream\";\nimport { rethrowOutboxNetworkFailure } from \"../outbox-transport-error\";\n\nexport type FragnoInternalDescription = {\n  adapterIdentity: string;\n  currentVersionstamp: string | null;\n  fragments: Array<{ name: string; mountRoute: string }>;\n  schemas: Array<{\n    name: string;\n    namespace: string | null;\n    version: number;\n    tables: string[];\n  }>;\n  routes: {\n    internal: \"/_internal\";\n    outbox?: \"/_internal/outbox\";\n    outboxStream?: \"/_internal/outbox/stream\";\n  };\n};\n\n/** Typed Fetch access to the trusted Fragno internal routes used by outbox synchronization. */\nexport class FragnoInternalFetcher {\n  readonly baseUrl: string;\n\n  readonly #fetch: typeof globalThis.fetch;\n  readonly #describeUrl: URL;\n  readonly #outboxStreamUrl: URL;\n\n  constructor(options: { baseUrl: string | URL; fetch: typeof globalThis.fetch }) {\n    const baseUrl = new URL(options.baseUrl, globalThis.location?.href);\n    if (baseUrl.protocol !== \"http:\" && baseUrl.protocol !== \"https:\") {\n      throw new Error(\"Fragno outbox synchronization requires an HTTP(S) base URL.\");\n    }\n    baseUrl.hash = \"\";\n    baseUrl.pathname = baseUrl.pathname.replace(/\\/+$/, \"\");\n\n    const internalUrl = new URL(baseUrl);\n    internalUrl.pathname = `${baseUrl.pathname}/_internal`;\n    const outboxStreamUrl = new URL(internalUrl);\n    outboxStreamUrl.pathname = `${internalUrl.pathname}/outbox/stream`;\n\n    this.baseUrl = baseUrl.toString();\n    this.#fetch = options.fetch;\n    this.#describeUrl = internalUrl;\n    this.#outboxStreamUrl = outboxStreamUrl;\n  }\n\n  async describe(options: { signal?: AbortSignal } = {}): Promise<FragnoInternalDescription> {\n    const response = await this.#get(this.#describeUrl, options.signal);\n    const description = (await response.json()) as FragnoInternalDescription;\n    return description;\n  }\n\n  async openOutboxStream(options: {\n    checkpoint: FragnoOutboxCheckpoint | undefined;\n    signal?: AbortSignal;\n  }): Promise<ReadableStream<Uint8Array>> {\n    const url = new URL(this.#outboxStreamUrl);\n    url.searchParams.set(\"protocol\", \"1\");\n    if (options.checkpoint) {\n      url.searchParams.set(\"afterVersionstamp\", options.checkpoint.versionstamp);\n      url.searchParams.set(\"afterUowId\", options.checkpoint.uowId);\n    }\n    url.searchParams.set(\"limit\", String(FRAGNO_OUTBOX_PAGE_SIZE));\n    const request = new Request(url, { signal: options.signal });\n    let response: Response;\n    try {\n      response = await this.#fetch(request);\n    } catch (cause) {\n      rethrowOutboxNetworkFailure(cause, options.signal);\n    }\n    if (!response.ok) {\n      await response.body?.cancel().catch(() => {});\n      if (response.status === 400 || response.status === 409) {\n        throw new FragnoOutboxProtocolError(\n          `Fragno outbox stream rejected its protocol or cursor: ${response.status}.`,\n        );\n      }\n      throw new Error(\n        `Fragno outbox stream request failed: ${response.status} ${response.statusText}`,\n      );\n    }\n    if (!response.body) {\n      throw new Error(\"Fragno outbox stream response has no body.\");\n    }\n    return response.body;\n  }\n\n  async #get(url: URL, signal: AbortSignal | undefined): Promise<Response> {\n    const response = await this.#fetch(url, { signal });\n    if (!response.ok) {\n      throw new Error(`Fragno internal request failed: ${response.status} ${response.statusText}`);\n    }\n    return response;\n  }\n}\n"],"mappings":";;;;;AAwBA,IAAa,wBAAb,MAAmC;CACjC;CAEA;CACA;CACA;CAEA,YAAY,SAAoE;EAC9E,MAAM,UAAU,IAAI,IAAI,QAAQ,SAAS,WAAW,UAAU,IAAI;EAClE,IAAI,QAAQ,aAAa,WAAW,QAAQ,aAAa,UACvD,MAAM,IAAI,MAAM,6DAA6D;EAE/E,QAAQ,OAAO;EACf,QAAQ,WAAW,QAAQ,SAAS,QAAQ,QAAQ,EAAE;EAEtD,MAAM,cAAc,IAAI,IAAI,OAAO;EACnC,YAAY,WAAW,GAAG,QAAQ,SAAS;EAC3C,MAAM,kBAAkB,IAAI,IAAI,WAAW;EAC3C,gBAAgB,WAAW,GAAG,YAAY,SAAS;EAEnD,KAAK,UAAU,QAAQ,SAAS;EAChC,KAAKA,SAAS,QAAQ;EACtB,KAAKC,eAAe;EACpB,KAAKC,mBAAmB;CAC1B;CAEA,MAAM,SAAS,UAAoC,CAAC,GAAuC;EAGzF,OAAO,OADoB,MADJ,KAAKC,KAAK,KAAKF,cAAc,QAAQ,MAAM,EAAA,CAC9B,KAAK;CAE3C;CAEA,MAAM,iBAAiB,SAGiB;EACtC,MAAM,MAAM,IAAI,IAAI,KAAKC,gBAAgB;EACzC,IAAI,aAAa,IAAI,YAAY,GAAG;EACpC,IAAI,QAAQ,YAAY;GACtB,IAAI,aAAa,IAAI,qBAAqB,QAAQ,WAAW,YAAY;GACzE,IAAI,aAAa,IAAI,cAAc,QAAQ,WAAW,KAAK;EAC7D;EACA,IAAI,aAAa,IAAI,SAAS,OAAO,uBAAuB,CAAC;EAC7D,MAAM,UAAU,IAAI,QAAQ,KAAK,EAAE,QAAQ,QAAQ,OAAO,CAAC;EAC3D,IAAI;EACJ,IAAI;GACF,WAAW,MAAM,KAAKF,OAAO,OAAO;EACtC,SAAS,OAAO;GACd,4BAA4B,OAAO,QAAQ,MAAM;EACnD;EACA,IAAI,CAAC,SAAS,IAAI;GAChB,MAAM,SAAS,MAAM,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC;GAC5C,IAAI,SAAS,WAAW,OAAO,SAAS,WAAW,KACjD,MAAM,IAAI,0BACR,yDAAyD,SAAS,OAAO,EAC3E;GAEF,MAAM,IAAI,MACR,wCAAwC,SAAS,OAAO,GAAG,SAAS,YACtE;EACF;EACA,IAAI,CAAC,SAAS,MACZ,MAAM,IAAI,MAAM,4CAA4C;EAE9D,OAAO,SAAS;CAClB;CAEA,MAAMG,KAAK,KAAU,QAAoD;EACvE,MAAM,WAAW,MAAM,KAAKH,OAAO,KAAK,EAAE,OAAO,CAAC;EAClD,IAAI,CAAC,SAAS,IACZ,MAAM,IAAI,MAAM,mCAAmC,SAAS,OAAO,GAAG,SAAS,YAAY;EAE7F,OAAO;CACT;AACF"}

package/dist/coordinator/fragno-ordered-persistence.js

@@ -0,0 +1,66 @@
+//#region src/coordinator/fragno-ordered-persistence.ts
+/**
+* A hydration scope hands TanStack an unscheduled inner adapter whose writes would bypass the
+* queue, and queueing them would wait on writes blocked behind that same scope. Hiding the scope
+* makes TanStack run hydration through the wrapped adapter.
+*/
+const HIDDEN_ADAPTER_PROPERTIES = /* @__PURE__ */ new Set([
+	"runInHydrationScope",
+	"runInRegularScope",
+	"isHydrationScopeScheduled"
+]);
+/** Orders every collection write before later writes to the shared Fragno persistence database. */
+function orderFragnoPersistenceWrites(persistence) {
+	const queue = new FragnoPersistenceWriteQueue();
+	const persistenceCache = /* @__PURE__ */ new WeakMap();
+	const adapterCache = /* @__PURE__ */ new WeakMap();
+	const wrapAdapter = (adapter) => {
+		const cached = adapterCache.get(adapter);
+		if (cached) return cached;
+		const wrapped = forwardAdapterCapabilities(adapter);
+		wrapped.applyCommittedTx = (target, transaction) => queue.enqueue(() => adapter.applyCommittedTx(target, transaction));
+		const { reconcileCommittedTx } = adapter;
+		if (reconcileCommittedTx) wrapped.reconcileCommittedTx = (target, transaction, anchor) => queue.enqueue(() => reconcileCommittedTx.call(adapter, target, transaction, anchor));
+		adapterCache.set(adapter, wrapped);
+		return wrapped;
+	};
+	const wrapPersistence = (resolvedPersistence) => {
+		const cached = persistenceCache.get(resolvedPersistence);
+		if (cached) return cached;
+		const wrapped = { adapter: wrapAdapter(resolvedPersistence.adapter) };
+		persistenceCache.set(resolvedPersistence, wrapped);
+		if (resolvedPersistence.coordinator) wrapped.coordinator = resolvedPersistence.coordinator;
+		if (resolvedPersistence.resolvePersistenceForCollection) wrapped.resolvePersistenceForCollection = (options) => wrapPersistence(resolvedPersistence.resolvePersistenceForCollection(options));
+		if (resolvedPersistence.resolvePersistenceForMode) wrapped.resolvePersistenceForMode = (mode) => wrapPersistence(resolvedPersistence.resolvePersistenceForMode(mode));
+		return wrapped;
+	};
+	return Object.assign(wrapPersistence(persistence), { drain: () => queue.drain() });
+}
+/**
+* Binds every adapter method, including class methods, so coordinators keep the capabilities they
+* require, such as the browser coordinator's `reserveLeadershipTerm`.
+*/
+function forwardAdapterCapabilities(adapter) {
+	const forwarded = {};
+	for (let source = adapter; source && source !== Object.prototype; source = Object.getPrototypeOf(source)) for (const property of Reflect.ownKeys(source)) {
+		if (property === "constructor" || HIDDEN_ADAPTER_PROPERTIES.has(property) || Object.hasOwn(forwarded, property)) continue;
+		const value = Object.getOwnPropertyDescriptor(source, property)?.value;
+		if (typeof value === "function") forwarded[property] = value.bind(adapter);
+	}
+	return forwarded;
+}
+var FragnoPersistenceWriteQueue = class {
+	#tail = Promise.resolve();
+	enqueue(write) {
+		const queuedWrite = this.#tail.then(write);
+		this.#tail = queuedWrite;
+		return queuedWrite;
+	}
+	async drain() {
+		await this.#tail;
+	}
+};
+//#endregion
+export { orderFragnoPersistenceWrites };
+
+//# sourceMappingURL=fragno-ordered-persistence.js.map

package/dist/coordinator/fragno-ordered-persistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fragno-ordered-persistence.js","names":["#tail"],"sources":["../../src/coordinator/fragno-ordered-persistence.ts"],"sourcesContent":["import type {\n  PersistedCollectionPersistence,\n  PersistenceAdapter,\n} from \"@tanstack/db-sqlite-persistence-core\";\n\n/**\n * A hydration scope hands TanStack an unscheduled inner adapter whose writes would bypass the\n * queue, and queueing them would wait on writes blocked behind that same scope. Hiding the scope\n * makes TanStack run hydration through the wrapped adapter.\n */\nconst HIDDEN_ADAPTER_PROPERTIES: ReadonlySet<PropertyKey> = new Set([\n  \"runInHydrationScope\",\n  \"runInRegularScope\",\n  \"isHydrationScopeScheduled\",\n]);\n\nexport type OrderedFragnoPersistence = PersistedCollectionPersistence & {\n  drain(): Promise<void>;\n};\n\n/** Orders every collection write before later writes to the shared Fragno persistence database. */\nexport function orderFragnoPersistenceWrites(\n  persistence: PersistedCollectionPersistence,\n): OrderedFragnoPersistence {\n  const queue = new FragnoPersistenceWriteQueue();\n  const persistenceCache = new WeakMap<\n    PersistedCollectionPersistence,\n    PersistedCollectionPersistence\n  >();\n  const adapterCache = new WeakMap<PersistenceAdapter, PersistenceAdapter>();\n\n  const wrapAdapter = (adapter: PersistenceAdapter): PersistenceAdapter => {\n    const cached = adapterCache.get(adapter);\n    if (cached) {\n      return cached;\n    }\n\n    const wrapped = forwardAdapterCapabilities(adapter);\n    wrapped.applyCommittedTx = (target, transaction) =>\n      queue.enqueue(() => adapter.applyCommittedTx(target, transaction));\n    const { reconcileCommittedTx } = adapter;\n    if (reconcileCommittedTx) {\n      wrapped.reconcileCommittedTx = (target, transaction, anchor) =>\n        queue.enqueue(() => reconcileCommittedTx.call(adapter, target, transaction, anchor));\n    }\n\n    adapterCache.set(adapter, wrapped);\n    return wrapped;\n  };\n\n  const wrapPersistence = (\n    resolvedPersistence: PersistedCollectionPersistence,\n  ): PersistedCollectionPersistence => {\n    const cached = persistenceCache.get(resolvedPersistence);\n    if (cached) {\n      return cached;\n    }\n\n    const wrapped: PersistedCollectionPersistence = {\n      adapter: wrapAdapter(resolvedPersistence.adapter),\n    };\n    persistenceCache.set(resolvedPersistence, wrapped);\n\n    if (resolvedPersistence.coordinator) {\n      wrapped.coordinator = resolvedPersistence.coordinator;\n    }\n    if (resolvedPersistence.resolvePersistenceForCollection) {\n      wrapped.resolvePersistenceForCollection = (options) =>\n        wrapPersistence(resolvedPersistence.resolvePersistenceForCollection!(options));\n    }\n    if (resolvedPersistence.resolvePersistenceForMode) {\n      wrapped.resolvePersistenceForMode = (mode) =>\n        wrapPersistence(resolvedPersistence.resolvePersistenceForMode!(mode));\n    }\n\n    return wrapped;\n  };\n\n  return Object.assign(wrapPersistence(persistence), {\n    drain: () => queue.drain(),\n  });\n}\n\n/**\n * Binds every adapter method, including class methods, so coordinators keep the capabilities they\n * require, such as the browser coordinator's `reserveLeadershipTerm`.\n */\nfunction forwardAdapterCapabilities(adapter: PersistenceAdapter): PersistenceAdapter {\n  const forwarded: Record<PropertyKey, unknown> = {};\n  for (\n    let source: object | null = adapter;\n    source && source !== Object.prototype;\n    source = Object.getPrototypeOf(source) as object | null\n  ) {\n    for (const property of Reflect.ownKeys(source)) {\n      if (\n        property === \"constructor\" ||\n        HIDDEN_ADAPTER_PROPERTIES.has(property) ||\n        Object.hasOwn(forwarded, property)\n      ) {\n        continue;\n      }\n      const value: unknown = Object.getOwnPropertyDescriptor(source, property)?.value;\n      if (typeof value === \"function\") {\n        forwarded[property] = value.bind(adapter);\n      }\n    }\n  }\n  return forwarded as unknown as PersistenceAdapter;\n}\n\nclass FragnoPersistenceWriteQueue {\n  #tail: Promise<unknown> = Promise.resolve();\n\n  enqueue<TResult>(write: () => Promise<TResult>): Promise<TResult> {\n    const queuedWrite = this.#tail.then(write);\n    // Keep a rejection in the chain so a later shared checkpoint can never pass a failed table\n    // write and become the durable resume position.\n    this.#tail = queuedWrite;\n    return queuedWrite;\n  }\n\n  async drain(): Promise<void> {\n    await this.#tail;\n  }\n}\n"],"mappings":";;;;;;AAUA,MAAM,4CAAsD,IAAI,IAAI;CAClE;CACA;CACA;AACF,CAAC;;AAOD,SAAgB,6BACd,aAC0B;CAC1B,MAAM,QAAQ,IAAI,4BAA4B;CAC9C,MAAM,mCAAmB,IAAI,QAG3B;CACF,MAAM,+BAAe,IAAI,QAAgD;CAEzE,MAAM,eAAe,YAAoD;EACvE,MAAM,SAAS,aAAa,IAAI,OAAO;EACvC,IAAI,QACF,OAAO;EAGT,MAAM,UAAU,2BAA2B,OAAO;EAClD,QAAQ,oBAAoB,QAAQ,gBAClC,MAAM,cAAc,QAAQ,iBAAiB,QAAQ,WAAW,CAAC;EACnE,MAAM,EAAE,yBAAyB;EACjC,IAAI,sBACF,QAAQ,wBAAwB,QAAQ,aAAa,WACnD,MAAM,cAAc,qBAAqB,KAAK,SAAS,QAAQ,aAAa,MAAM,CAAC;EAGvF,aAAa,IAAI,SAAS,OAAO;EACjC,OAAO;CACT;CAEA,MAAM,mBACJ,wBACmC;EACnC,MAAM,SAAS,iBAAiB,IAAI,mBAAmB;EACvD,IAAI,QACF,OAAO;EAGT,MAAM,UAA0C,EAC9C,SAAS,YAAY,oBAAoB,OAAO,EAClD;EACA,iBAAiB,IAAI,qBAAqB,OAAO;EAEjD,IAAI,oBAAoB,aACtB,QAAQ,cAAc,oBAAoB;EAE5C,IAAI,oBAAoB,iCACtB,QAAQ,mCAAmC,YACzC,gBAAgB,oBAAoB,gCAAiC,OAAO,CAAC;EAEjF,IAAI,oBAAoB,2BACtB,QAAQ,6BAA6B,SACnC,gBAAgB,oBAAoB,0BAA2B,IAAI,CAAC;EAGxE,OAAO;CACT;CAEA,OAAO,OAAO,OAAO,gBAAgB,WAAW,GAAG,EACjD,aAAa,MAAM,MAAM,EAC3B,CAAC;AACH;;;;;AAMA,SAAS,2BAA2B,SAAiD;CACnF,MAAM,YAA0C,CAAC;CACjD,KACE,IAAI,SAAwB,SAC5B,UAAU,WAAW,OAAO,WAC5B,SAAS,OAAO,eAAe,MAAM,GAErC,KAAK,MAAM,YAAY,QAAQ,QAAQ,MAAM,GAAG;EAC9C,IACE,aAAa,iBACb,0BAA0B,IAAI,QAAQ,KACtC,OAAO,OAAO,WAAW,QAAQ,GAEjC;EAEF,MAAM,QAAiB,OAAO,yBAAyB,QAAQ,QAAQ,CAAC,EAAE;EAC1E,IAAI,OAAO,UAAU,YACnB,UAAU,YAAY,MAAM,KAAK,OAAO;CAE5C;CAEF,OAAO;AACT;AAEA,IAAM,8BAAN,MAAkC;CAChC,QAA0B,QAAQ,QAAQ;CAE1C,QAAiB,OAAiD;EAChE,MAAM,cAAc,KAAKA,MAAM,KAAK,KAAK;EAGzC,KAAKA,QAAQ;EACb,OAAO;CACT;CAEA,MAAM,QAAuB;EAC3B,MAAM,KAAKA;CACb;AACF"}

package/dist/coordinator/fragno-outbox-synchronizer.js

@@ -0,0 +1,193 @@
+import { FragnoOutboxProtocolError, consumeNdjsonOutboxStream } from "../outbox-stream.js";
+import { decodeFragnoOutboxPayload, fragnoOutboxOperationTarget, projectFragnoOutboxOperations } from "../protocol.js";
+import { FRAGNO_OUTBOX_PAGE_SIZE } from "@fragno-dev/db/outbox";
+//#region src/coordinator/fragno-outbox-synchronizer.ts
+/** Owns shared outbox ordering and delivers target-specific changes to collection adapters. */
+var FragnoOutboxSynchronizer = class {
+	#fetcher;
+	#checkpointStore;
+	#abortController = new AbortController();
+	#subscribers = /* @__PURE__ */ new Map();
+	#registrationWaiters = /* @__PURE__ */ new Set();
+	#sessionPromise;
+	#adapterIdentity;
+	#ready = false;
+	#disposed = false;
+	#onCatchUpPage;
+	constructor(options) {
+		this.#fetcher = options.fetcher;
+		this.#adapterIdentity = options.adapterIdentity;
+		this.#checkpointStore = options.checkpointStore;
+		this.#onCatchUpPage = options.onCatchUpPage;
+	}
+	register(subscriber) {
+		if (this.#disposed) throw new Error("Cannot register a collection after Fragno outbox synchronization disposal.");
+		this.#subscribers.set(subscriber.target.key, subscriber);
+		this.#resolveRegistrationWaiters();
+		return () => {
+			if (this.#subscribers.get(subscriber.target.key) === subscriber) this.#subscribers.delete(subscriber.target.key);
+		};
+	}
+	waitUntilRegistered(targets) {
+		if (this.#disposed) return Promise.reject(/* @__PURE__ */ new Error("Fragno outbox synchronization has been disposed."));
+		if (this.#hasEveryTarget(targets)) return Promise.resolve();
+		return new Promise((resolve, reject) => {
+			this.#registrationWaiters.add({
+				targets,
+				resolve,
+				reject
+			});
+		});
+	}
+	/** Runs catch-up and live delivery on one response; resolves only on planned rotation. */
+	streamSession(options) {
+		if (this.#disposed) return Promise.reject(new DOMException("Fragno outbox synchronization was disposed.", "AbortError"));
+		this.#sessionPromise ??= this.#runStreamSession(options).finally(() => {
+			this.#sessionPromise = void 0;
+		});
+		return this.#sessionPromise;
+	}
+	applyChanges(targetKey, delivery) {
+		return this.#requireSubscriber(targetKey).apply(delivery);
+	}
+	truncate(targetKey) {
+		return this.#requireSubscriber(targetKey).truncate();
+	}
+	markReady() {
+		for (const subscriber of this.#subscribers.values()) subscriber.markReady();
+	}
+	dispose() {
+		if (this.#disposed) return;
+		this.#disposed = true;
+		this.#abortController.abort();
+		this.#subscribers.clear();
+		const error = /* @__PURE__ */ new Error("Fragno outbox synchronization was disposed before registration.");
+		for (const waiter of this.#registrationWaiters) waiter.reject(error);
+		this.#registrationWaiters.clear();
+	}
+	async #runStreamSession(options) {
+		if (this.#disposed) throw new Error("Cannot catch up a disposed Fragno outbox synchronizer.");
+		await Promise.all([...this.#subscribers.values()].map((subscriber) => subscriber.prepareCatchUp?.()).filter((preparation) => preparation !== void 0));
+		const initialCheckpoint = this.#checkpointStore.getCheckpoint();
+		const afterVersionstamp = initialCheckpoint?.versionstamp;
+		let caughtUp = false;
+		let entries = [];
+		let completedBatches = 0;
+		const flushCatchUpBatch = async () => {
+			const page = entries;
+			entries = [];
+			await this.#applyAndAdvancePage(page);
+			completedBatches += 1;
+			this.#onCatchUpPage?.(this.#checkpointStore.getCheckpoint());
+		};
+		await consumeNdjsonOutboxStream(await this.#fetcher.openOutboxStream({
+			checkpoint: initialCheckpoint,
+			signal: this.#abortController.signal
+		}), {
+			signal: this.#abortController.signal,
+			afterVersionstamp,
+			onFrame: async (frame) => {
+				switch (frame.type) {
+					case "started":
+						if (frame.adapterIdentity !== this.#adapterIdentity) throw new FragnoOutboxProtocolError("Fragno outbox adapter identity changed during synchronization.");
+						if (initialCheckpoint && (frame.catchUpTargetVersionstamp === null || frame.catchUpTargetVersionstamp < initialCheckpoint.versionstamp)) throw new FragnoOutboxProtocolError("Fragno outbox source is behind the persisted checkpoint.");
+						options.onStarted(frame.catchUpTargetVersionstamp);
+						break;
+					case "entry":
+						if (caughtUp) await this.#applyAndAdvanceEntry(frame.entry);
+						else {
+							entries.push(frame.entry);
+							if (entries.length === FRAGNO_OUTBOX_PAGE_SIZE) await flushCatchUpBatch();
+						}
+						break;
+					case "caught-up":
+						if (entries.length > 0 || completedBatches === 0) await flushCatchUpBatch();
+						caughtUp = true;
+						if (!this.#ready) {
+							this.markReady();
+							this.#ready = true;
+						}
+						options.onCaughtUp();
+						break;
+					case "rotate":
+						if (!caughtUp && entries.length > 0) await flushCatchUpBatch();
+						break;
+					case "heartbeat": break;
+				}
+			}
+		});
+	}
+	async #applyAndAdvancePage(entries) {
+		const lastEntry = entries.at(-1);
+		if (!lastEntry) return;
+		const deliveriesByTarget = /* @__PURE__ */ new Map();
+		for (const entry of entries) this.#planEntryDeliveries(entry, deliveriesByTarget);
+		await Promise.all([...deliveriesByTarget].map(([targetKey, deliveries]) => Promise.resolve(this.#requireSubscriber(targetKey).applyBatch(deliveries))));
+		this.#checkpointStore.setCheckpoint({
+			versionstamp: lastEntry.versionstamp,
+			uowId: lastEntry.uowId
+		});
+	}
+	async #applyAndAdvanceEntry(entry) {
+		const deliveriesByTarget = /* @__PURE__ */ new Map();
+		this.#planEntryDeliveries(entry, deliveriesByTarget);
+		await Promise.all([...deliveriesByTarget].map(([targetKey, deliveries]) => Promise.resolve(this.#requireSubscriber(targetKey).apply(deliveries[0]))));
+		this.#checkpointStore.setCheckpoint({
+			versionstamp: entry.versionstamp,
+			uowId: entry.uowId
+		});
+	}
+	#planEntryDeliveries(entry, deliveriesByTarget) {
+		const payload = decodeFragnoOutboxPayload(entry.payload);
+		const operationsByTarget = /* @__PURE__ */ new Map();
+		for (const operation of payload.operations) {
+			const target = fragnoOutboxOperationTarget(operation);
+			const targetKey = fragnoOutboxTargetKey(target.namespace, target.table);
+			if (!this.#subscribers.has(targetKey)) continue;
+			const targetOperations = operationsByTarget.get(targetKey);
+			if (targetOperations) targetOperations.push(operation);
+			else operationsByTarget.set(targetKey, [operation]);
+		}
+		for (const [targetKey, operations] of operationsByTarget) {
+			const subscriber = this.#requireSubscriber(targetKey);
+			const changes = projectFragnoOutboxOperations(entry, operations, {
+				schema: subscriber.target.schema,
+				table: subscriber.target.tableName,
+				namespace: subscriber.target.namespace
+			});
+			const deliveries = deliveriesByTarget.get(targetKey) ?? [];
+			deliveries.push({
+				checkpoint: {
+					versionstamp: entry.versionstamp,
+					uowId: entry.uowId
+				},
+				changes
+			});
+			deliveriesByTarget.set(targetKey, deliveries);
+		}
+	}
+	#requireSubscriber(targetKey) {
+		const subscriber = this.#subscribers.get(targetKey);
+		if (!subscriber) throw new Error(`No Fragno collection is registered for outbox target ${targetKey}.`);
+		return subscriber;
+	}
+	#hasEveryTarget(targets) {
+		return targets.every((target) => this.#subscribers.has(target));
+	}
+	#resolveRegistrationWaiters() {
+		for (const waiter of this.#registrationWaiters) if (this.#hasEveryTarget(waiter.targets)) {
+			this.#registrationWaiters.delete(waiter);
+			waiter.resolve();
+		}
+	}
+};
+function fragnoOutboxTargetKey(namespace, tableName) {
+	return `${identifierSegment(namespace)}${identifierSegment(tableName)}`;
+}
+function identifierSegment(value) {
+	return `${value.length}:${value}`;
+}
+//#endregion
+export { FragnoOutboxSynchronizer, fragnoOutboxTargetKey };
+
+//# sourceMappingURL=fragno-outbox-synchronizer.js.map

package/dist/coordinator/fragno-outbox-synchronizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fragno-outbox-synchronizer.js","names":["#fetcher","#checkpointStore","#abortController","#subscribers","#registrationWaiters","#adapterIdentity","#onCatchUpPage","#disposed","#resolveRegistrationWaiters","#hasEveryTarget","#sessionPromise","#runStreamSession","#requireSubscriber","#applyAndAdvancePage","#applyAndAdvanceEntry","#ready","#planEntryDeliveries"],"sources":["../../src/coordinator/fragno-outbox-synchronizer.ts"],"sourcesContent":["import { FRAGNO_OUTBOX_PAGE_SIZE } from \"@fragno-dev/db/outbox\";\nimport type { AnySchema } from \"@fragno-dev/db/schema\";\n\nimport type { OutboxOperation } from \"@fragno-dev/db\";\n\nimport type { SyncAppliedReceipt } from \"@tanstack/db\";\n\nimport type { FragnoOutboxCheckpoint } from \"../checkpoint\";\nimport { consumeNdjsonOutboxStream, FragnoOutboxProtocolError } from \"../outbox-stream\";\nimport {\n  decodeFragnoOutboxPayload,\n  fragnoOutboxOperationTarget,\n  projectFragnoOutboxOperations,\n  type FragnoCollectionChange,\n  type FragnoOutboxEntry,\n} from \"../protocol\";\ntype FragnoSynchronizedRow = Record<string, unknown>;\n\ntype FragnoOutboxFetcher = {\n  openOutboxStream(options: {\n    checkpoint: FragnoOutboxCheckpoint | undefined;\n    signal?: AbortSignal;\n  }): Promise<ReadableStream<Uint8Array>>;\n};\n\ntype FragnoOutboxCheckpointStore = {\n  getCheckpoint(): FragnoOutboxCheckpoint | undefined;\n  setCheckpoint(checkpoint: FragnoOutboxCheckpoint): void;\n};\n\nexport type FragnoOutboxTarget = {\n  key: string;\n  namespace: string;\n  schema: AnySchema;\n  tableName: string;\n};\n\nexport type FragnoOutboxDelivery = {\n  checkpoint: FragnoOutboxCheckpoint;\n  changes: FragnoCollectionChange<FragnoSynchronizedRow>[];\n};\n\nexport type FragnoOutboxSubscriber = {\n  target: FragnoOutboxTarget;\n  prepareCatchUp?(): Promise<void>;\n  apply(delivery: FragnoOutboxDelivery): SyncAppliedReceipt;\n  applyBatch(deliveries: readonly FragnoOutboxDelivery[]): SyncAppliedReceipt;\n  truncate(): SyncAppliedReceipt;\n  markReady(): void;\n};\n\ntype RegistrationWaiter = {\n  targets: readonly string[];\n  resolve(): void;\n  reject(error: Error): void;\n};\n\n/** Owns shared outbox ordering and delivers target-specific changes to collection adapters. */\nexport class FragnoOutboxSynchronizer {\n  readonly #fetcher: FragnoOutboxFetcher;\n  readonly #checkpointStore: FragnoOutboxCheckpointStore;\n  readonly #abortController = new AbortController();\n  readonly #subscribers = new Map<string, FragnoOutboxSubscriber>();\n  readonly #registrationWaiters = new Set<RegistrationWaiter>();\n\n  #sessionPromise: Promise<void> | undefined;\n  readonly #adapterIdentity: string;\n  #ready = false;\n  #disposed = false;\n\n  readonly #onCatchUpPage?: (checkpoint: FragnoOutboxCheckpoint | undefined) => void;\n\n  constructor(options: {\n    fetcher: FragnoOutboxFetcher;\n    adapterIdentity: string;\n    checkpointStore: FragnoOutboxCheckpointStore;\n    onCatchUpPage?: (checkpoint: FragnoOutboxCheckpoint | undefined) => void;\n  }) {\n    this.#fetcher = options.fetcher;\n    this.#adapterIdentity = options.adapterIdentity;\n    this.#checkpointStore = options.checkpointStore;\n    this.#onCatchUpPage = options.onCatchUpPage;\n  }\n\n  register(subscriber: FragnoOutboxSubscriber): () => void {\n    if (this.#disposed) {\n      throw new Error(\"Cannot register a collection after Fragno outbox synchronization disposal.\");\n    }\n\n    this.#subscribers.set(subscriber.target.key, subscriber);\n    this.#resolveRegistrationWaiters();\n\n    return () => {\n      if (this.#subscribers.get(subscriber.target.key) === subscriber) {\n        this.#subscribers.delete(subscriber.target.key);\n      }\n    };\n  }\n\n  waitUntilRegistered(targets: readonly string[]): Promise<void> {\n    if (this.#disposed) {\n      return Promise.reject(new Error(\"Fragno outbox synchronization has been disposed.\"));\n    }\n    if (this.#hasEveryTarget(targets)) {\n      return Promise.resolve();\n    }\n\n    return new Promise<void>((resolve, reject) => {\n      this.#registrationWaiters.add({ targets, resolve, reject });\n    });\n  }\n\n  /** Runs catch-up and live delivery on one response; resolves only on planned rotation. */\n  streamSession(options: {\n    onStarted(targetVersionstamp: string | null): void;\n    onCaughtUp(): void;\n  }): Promise<void> {\n    if (this.#disposed) {\n      return Promise.reject(\n        new DOMException(\"Fragno outbox synchronization was disposed.\", \"AbortError\"),\n      );\n    }\n    this.#sessionPromise ??= this.#runStreamSession(options).finally(() => {\n      this.#sessionPromise = undefined;\n    });\n    return this.#sessionPromise;\n  }\n\n  applyChanges(targetKey: string, delivery: FragnoOutboxDelivery): SyncAppliedReceipt {\n    return this.#requireSubscriber(targetKey).apply(delivery);\n  }\n\n  truncate(targetKey: string): SyncAppliedReceipt {\n    return this.#requireSubscriber(targetKey).truncate();\n  }\n\n  markReady(): void {\n    for (const subscriber of this.#subscribers.values()) {\n      subscriber.markReady();\n    }\n  }\n\n  dispose(): void {\n    if (this.#disposed) {\n      return;\n    }\n\n    this.#disposed = true;\n    this.#abortController.abort();\n    this.#subscribers.clear();\n    const error = new Error(\"Fragno outbox synchronization was disposed before registration.\");\n    for (const waiter of this.#registrationWaiters) {\n      waiter.reject(error);\n    }\n    this.#registrationWaiters.clear();\n  }\n\n  async #runStreamSession(options: {\n    onStarted(targetVersionstamp: string | null): void;\n    onCaughtUp(): void;\n  }): Promise<void> {\n    if (this.#disposed) {\n      throw new Error(\"Cannot catch up a disposed Fragno outbox synchronizer.\");\n    }\n\n    await Promise.all(\n      [...this.#subscribers.values()]\n        .map((subscriber) => subscriber.prepareCatchUp?.())\n        .filter((preparation): preparation is Promise<void> => preparation !== undefined),\n    );\n\n    const initialCheckpoint = this.#checkpointStore.getCheckpoint();\n    const afterVersionstamp = initialCheckpoint?.versionstamp;\n    let caughtUp = false;\n    let entries: FragnoOutboxEntry[] = [];\n    let completedBatches = 0;\n    const flushCatchUpBatch = async () => {\n      const page = entries;\n      entries = [];\n      await this.#applyAndAdvancePage(page);\n      completedBatches += 1;\n      this.#onCatchUpPage?.(this.#checkpointStore.getCheckpoint());\n    };\n    const body = await this.#fetcher.openOutboxStream({\n      checkpoint: initialCheckpoint,\n      signal: this.#abortController.signal,\n    });\n    await consumeNdjsonOutboxStream(body, {\n      signal: this.#abortController.signal,\n      afterVersionstamp,\n      onFrame: async (frame) => {\n        switch (frame.type) {\n          case \"started\":\n            if (frame.adapterIdentity !== this.#adapterIdentity) {\n              throw new FragnoOutboxProtocolError(\n                \"Fragno outbox adapter identity changed during synchronization.\",\n              );\n            }\n            if (\n              initialCheckpoint &&\n              (frame.catchUpTargetVersionstamp === null ||\n                frame.catchUpTargetVersionstamp < initialCheckpoint.versionstamp)\n            ) {\n              throw new FragnoOutboxProtocolError(\n                \"Fragno outbox source is behind the persisted checkpoint.\",\n              );\n            }\n            options.onStarted(frame.catchUpTargetVersionstamp);\n            break;\n          case \"entry\":\n            if (caughtUp) {\n              await this.#applyAndAdvanceEntry(frame.entry);\n            } else {\n              entries.push(frame.entry);\n              if (entries.length === FRAGNO_OUTBOX_PAGE_SIZE) {\n                await flushCatchUpBatch();\n              }\n            }\n            break;\n          case \"caught-up\":\n            if (entries.length > 0 || completedBatches === 0) {\n              await flushCatchUpBatch();\n            }\n            caughtUp = true;\n            if (!this.#ready) {\n              this.markReady();\n              this.#ready = true;\n            }\n            options.onCaughtUp();\n            break;\n          case \"rotate\":\n            // A planned boundary is safe to commit; an interrupted partial batch is discarded.\n            if (!caughtUp && entries.length > 0) {\n              await flushCatchUpBatch();\n            }\n            break;\n          case \"heartbeat\":\n            break;\n        }\n      },\n    });\n  }\n\n  // A persisted TanStack commit publishes asynchronously, and its receipt resolves once the write is\n  // durable. Awaiting table receipts keeps \"caught up\" meaning \"visible\" and surfaces failed\n  // commits. The shared checkpoint is not awaited so the coordinator can go live before it is\n  // durable; a failed checkpoint write still fails every later table write in the ordered queue.\n  async #applyAndAdvancePage(entries: readonly FragnoOutboxEntry[]): Promise<void> {\n    const lastEntry = entries.at(-1);\n    if (!lastEntry) {\n      return;\n    }\n\n    const deliveriesByTarget = new Map<string, FragnoOutboxDelivery[]>();\n    for (const entry of entries) {\n      this.#planEntryDeliveries(entry, deliveriesByTarget);\n    }\n\n    await Promise.all(\n      [...deliveriesByTarget].map(([targetKey, deliveries]) =>\n        Promise.resolve(this.#requireSubscriber(targetKey).applyBatch(deliveries)),\n      ),\n    );\n    this.#checkpointStore.setCheckpoint({\n      versionstamp: lastEntry.versionstamp,\n      uowId: lastEntry.uowId,\n    });\n  }\n\n  async #applyAndAdvanceEntry(entry: FragnoOutboxEntry): Promise<void> {\n    const deliveriesByTarget = new Map<string, FragnoOutboxDelivery[]>();\n    this.#planEntryDeliveries(entry, deliveriesByTarget);\n\n    await Promise.all(\n      [...deliveriesByTarget].map(([targetKey, deliveries]) =>\n        Promise.resolve(this.#requireSubscriber(targetKey).apply(deliveries[0])),\n      ),\n    );\n    // Collection checkpoints make partial cross-collection commits safe to retry.\n    this.#checkpointStore.setCheckpoint({ versionstamp: entry.versionstamp, uowId: entry.uowId });\n  }\n\n  #planEntryDeliveries(\n    entry: FragnoOutboxEntry,\n    deliveriesByTarget: Map<string, FragnoOutboxDelivery[]>,\n  ): void {\n    const payload = decodeFragnoOutboxPayload(entry.payload);\n    const operationsByTarget = new Map<string, OutboxOperation[]>();\n\n    for (const operation of payload.operations) {\n      const target = fragnoOutboxOperationTarget(operation);\n      const targetKey = fragnoOutboxTargetKey(target.namespace, target.table);\n      if (!this.#subscribers.has(targetKey)) {\n        continue;\n      }\n\n      const targetOperations = operationsByTarget.get(targetKey);\n      if (targetOperations) {\n        targetOperations.push(operation);\n      } else {\n        operationsByTarget.set(targetKey, [operation]);\n      }\n    }\n\n    for (const [targetKey, operations] of operationsByTarget) {\n      const subscriber = this.#requireSubscriber(targetKey);\n      const changes = projectFragnoOutboxOperations(entry, operations, {\n        schema: subscriber.target.schema,\n        table: subscriber.target.tableName,\n        namespace: subscriber.target.namespace,\n      });\n      const deliveries = deliveriesByTarget.get(targetKey) ?? [];\n      deliveries.push({\n        checkpoint: { versionstamp: entry.versionstamp, uowId: entry.uowId },\n        changes: changes as FragnoCollectionChange<FragnoSynchronizedRow>[],\n      });\n      deliveriesByTarget.set(targetKey, deliveries);\n    }\n  }\n\n  #requireSubscriber(targetKey: string): FragnoOutboxSubscriber {\n    const subscriber = this.#subscribers.get(targetKey);\n    if (!subscriber) {\n      throw new Error(`No Fragno collection is registered for outbox target ${targetKey}.`);\n    }\n    return subscriber;\n  }\n\n  #hasEveryTarget(targets: readonly string[]): boolean {\n    return targets.every((target) => this.#subscribers.has(target));\n  }\n\n  #resolveRegistrationWaiters(): void {\n    for (const waiter of this.#registrationWaiters) {\n      if (this.#hasEveryTarget(waiter.targets)) {\n        this.#registrationWaiters.delete(waiter);\n        waiter.resolve();\n      }\n    }\n  }\n}\n\nexport function fragnoOutboxTargetKey(namespace: string, tableName: string): string {\n  return `${identifierSegment(namespace)}${identifierSegment(tableName)}`;\n}\n\nfunction identifierSegment(value: string): string {\n  return `${value.length}:${value}`;\n}\n"],"mappings":"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"}