@peerbit/shared-log 13.1.15 → 13.1.17

package/src/sync/index.ts

@@ -7,6 +7,9 @@ import type { EntryWithRefs } from "../exchange-heads.js";
 import type { Numbers } from "../integers.js";
 import type { TransportMessage } from "../message.js";
 import type { EntryReplicated, ReplicationRangeIndexable } from "../ranges.js";
+import type { SyncProfileFn } from "./profile.js";
+
+export type { SyncProfileEvent, SyncProfileFn } from "./profile.js";
 
 export type SyncPriorityFn<R extends "u32" | "u64"> = (
 	entry: EntryReplicated<R>,
@@ -14,7 +17,8 @@ export type SyncPriorityFn<R extends "u32" | "u64"> = (
 
 export type SyncOptions<R extends "u32" | "u64"> = {
 	/**
-	 * Higher numbers are synced first.
+	 * Orders entries inside a sync batch; higher numbers are selected first.
+	 * This does not change the transport message priority/lane.
 	 * The callback should be fast and side-effect free.
 	 */
 	priority?: SyncPriorityFn<R>;
@@ -48,6 +52,12 @@ export type SyncOptions<R extends "u32" | "u64"> = {
 	 * Larger values reduce orchestration overhead but increase per-target memory.
 	 */
 	repairSweepTargetBufferSize?: number;
+
+	/**
+	 * Optional profiling callback. It is only invoked when provided, and should
+	 * avoid blocking because it runs inside sync hot paths.
+	 */
+	profile?: SyncProfileFn;
 };
 
 export type SynchronizerComponents<R extends "u32" | "u64"> = {

package/src/sync/profile.ts

@@ -0,0 +1,9 @@
+export {
+	diagnosticStart as syncProfileStart,
+	emitDiagnosticDuration as emitSyncProfileDuration,
+	emitDiagnosticEvent as emitSyncProfileEvent,
+} from "@peerbit/diagnostics";
+export type {
+	DiagnosticEvent as SyncProfileEvent,
+	DiagnosticSink as SyncProfileFn,
+} from "@peerbit/diagnostics";