Skip to content

DiagnosticDumpReport

Defined in: packages/client/src/export-store.ts:95

A diagnostic dump (ADR-0035, via the throwaway clone of the addendum): human-readable SQL of EVERYTHING the store holds — synced tables, the _overlay/_mutations journal, the pgxsinkit metadata schema, the read-model views, and the reconcile functions/triggers. It is a live datadir dump (checkpoint

  • dumpDataDir) fed into a memory-backed throwaway PGlite via loadDataDir, against which pg_dump runs — so the live engine is never touched (the addendum’s whole point). Its phases add the clone boot and the pg_dump walls to the shared checkpoint/dump pair.

byteLength: number

Defined in: packages/client/src/export-store.ts:54

The artefact’s byte length — the size the caller downloads / persists.

ExportReportCommon.byteLength


diagnostics: MutationDiagnostics

Defined in: packages/client/src/export-store.ts:60

The MutationDiagnostics snapshot at export time — the journal state captured alongside the artefact (for the store backup, the very journal that travels INSIDE the tarball; for the diagnostic dump, the live store’s journal at dump time, whose rows the SQL also carries).

ExportReportCommon.diagnostics


kind: "diagnostic-dump"

Defined in: packages/client/src/export-store.ts:96


phases: object

Defined in: packages/client/src/export-store.ts:99

checkpointMs: number

CHECKPOINT wall — flushing dirty buffers before the internal datadir dump the clone consumes.

checkpointStartedAtMs: number

Offset from export start when the CHECKPOINT began.

cloneBootMs: number

Clone boot wall — booting the memory-backed throwaway from the internal dump.

cloneBootStartedAtMs: number

Offset from export start when the throwaway clone’s PGlite.create({ loadDataDir }) began.

dumpMs: number

dumpDataDir wall — the uncompressed internal tarball the throwaway clone boots from (compression: "none").

dumpStartedAtMs: number

Offset from export start when the internal dumpDataDir began.

pgDumpMs: number

pg_dump wall — the WASM pg_dump reading the clone out to SQL.

pgDumpStartedAtMs: number

Offset from export start when pg_dump began running against the clone.


reportVersion: 1

Defined in: packages/client/src/export-store.ts:48

ExportReportCommon.reportVersion


scope: "everything"

Defined in: packages/client/src/export-store.ts:98

A diagnostic dump covers everything the store holds — synced data, journal, metadata, views, functions.


startedAt: number

Defined in: packages/client/src/export-store.ts:50

Epoch anchor (Date.now()) at export start; every other duration/offset is monotonic relative to it.

ExportReportCommon.startedAt


totalMs: number

Defined in: packages/client/src/export-store.ts:52

Export start → artefact ready.

ExportReportCommon.totalMs