@tensorix/metahub 0.1.9 → 0.1.11

package/dist/core/compact.d.ts

@@ -0,0 +1,42 @@
+import type { Database } from "bun:sqlite";
+export interface CompactResult {
+    /** HLC cutoff actually used — history at or before this collapses to a baseline. */
+    cutoff: string;
+    deleted_changes: number;
+    kept_changes: number;
+    blobs_deleted: number;
+    blob_bytes_freed: number;
+    db_bytes_before: number;
+    db_bytes_after: number;
+    dry_run: boolean;
+}
+export interface CompactOptions {
+    /** Keep full history for this many days; 0 keeps only the head state. */
+    keepDays: number;
+    /** Report what would be removed without changing anything. */
+    dryRun?: boolean;
+    /** Run VACUUM afterwards to return the freed pages to the filesystem. */
+    vacuum?: boolean;
+    /** Test hook: "now" in epoch millis. */
+    now?: number;
+}
+export declare function compactOplog(db: Database, opts: CompactOptions): CompactResult;
+/**
+ * Delete cache blobs no longer referenced by any remaining oplog value or
+ * materialized site file. Conservative: only files named like a sha256 hash
+ * are candidates; anything else in the cache dir is left alone.
+ */
+export declare function gcBlobs(db: Database, opts?: {
+    dryRun?: boolean;
+}): {
+    deleted: number;
+    bytes: number;
+};
+/** Dry-run quick stats for doctor: total oplog rows and how many compaction
+ *  with the given window would remove. */
+export declare function compactEstimate(db: Database, keepDays: number, now?: number): {
+    total_changes: number;
+    compactable_changes: number;
+    db_bytes: number;
+};
+//# sourceMappingURL=compact.d.ts.map

package/dist/core/compact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compact.d.ts","sourceRoot":"","sources":["../../src/core/compact.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAsB3C,MAAM,WAAW,aAAa;IAC5B,oFAAoF;IACpF,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,yEAAyE;IACzE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAqBD,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,GAAG,aAAa,CAkD9E;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CACrB,EAAE,EAAE,QAAQ,EACZ,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GAC9B;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CA0CpC;AAED;0CAC0C;AAC1C,wBAAgB,eAAe,CAC7B,EAAE,EAAE,QAAQ,EACZ,QAAQ,EAAE,MAAM,EAChB,GAAG,SAAa,GACf;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,mBAAmB,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAa1E"}

package/dist/core/config.d.ts

@@ -1,4 +1,4 @@
-import type { Database } from "bun:sqlite";
+import type { DbDriver } from "./driver.ts";
 export interface ServerConfig {
     host: string;
     port: number;
@@ -8,7 +8,7 @@ export interface ServerConfig {
 }
 export declare const DEFAULT_CONFIG: ServerConfig;
 /** Persisted server config, falling back to DEFAULT_CONFIG per field. */
-export declare function getServerConfig(db: Database): ServerConfig;
+export declare function getServerConfig(db: DbDriver): ServerConfig;
 /** Persist a partial config update. Only provided fields are written. */
-export declare function setServerConfig(db: Database, partial: Partial<ServerConfig>): ServerConfig;
+export declare function setServerConfig(db: DbDriver, partial: Partial<ServerConfig>): ServerConfig;
 //# sourceMappingURL=config.d.ts.map

package/dist/core/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAQ3C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,eAAO,MAAM,cAAc,EAAE,YAK5B,CAAC;AAeF,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,GAAG,YAAY,CAW1D;AAED,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAO1F"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAQ5C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,eAAO,MAAM,cAAc,EAAE,YAK5B,CAAC;AAeF,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,GAAG,YAAY,CAW1D;AAED,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAO1F"}

package/dist/core/context.d.ts

@@ -1,11 +1,11 @@
-import type { Database } from "bun:sqlite";
+import type { DbDriver } from "./driver.ts";
 import { type DatabaseRow } from "./databases.ts";
 /**
  * The current database, or null. Validated on read: if it points at a database
  * that no longer exists (deleted, or gone after a snapshot restore), the stale
  * pointer is cleared and null returned — no coupling to delete/restore paths.
  */
-export declare function getCurrentDatabase(db: Database): DatabaseRow | null;
-export declare function setCurrentDatabase(db: Database, id: string): void;
-export declare function clearCurrentDatabase(db: Database): void;
+export declare function getCurrentDatabase(db: DbDriver): DatabaseRow | null;
+export declare function setCurrentDatabase(db: DbDriver, id: string): void;
+export declare function clearCurrentDatabase(db: DbDriver): void;
 //# sourceMappingURL=context.d.ts.map

package/dist/core/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/core/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAO/D;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,GAAG,WAAW,GAAG,IAAI,CAWnE;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAIjE;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAEvD"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/core/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAO/D;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,GAAG,WAAW,GAAG,IAAI,CAWnE;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAIjE;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAEvD"}

package/dist/core/crdt.d.ts

@@ -1,4 +1,4 @@
-import type { Database } from "bun:sqlite";
+import type { DbDriver } from "./driver.ts";
 export interface Change {
     hlc: string;
     node_id: string;
@@ -6,30 +6,53 @@ export interface Change {
     row_id: string;
     col: string;
     value: string | null;
+    txn?: string | null;
 }
+/** Oplog SELECT list, locked to the Change interface (also reused by history). */
+export declare const CHANGE_COLS: readonly ["hlc", "node_id", "dataset", "row_id", "col", "value", "txn"];
+export declare const CHANGE_SELECT: string;
+/**
+ * Run `fn` with all emits stamped with one shared txn id. Nested calls keep the
+ * outermost group (a revert that calls updateDocument is ONE revision). `label`
+ * prefixes the id ("repair:", "revert:") so history can classify the source.
+ */
+export declare function withChangeGroup<T>(label: string | null, fn: () => T): T;
+/** Wrap a mutator so its body runs inside one change group. */
+export declare function grouped<A extends unknown[], R>(fn: (...args: A) => R, label?: string | null): (...args: A) => R;
 /**
  * Record a change in the oplog (idempotent) and, if it is the latest write for
  * its register, materialize it. Order-independent: convergence holds regardless
  * of the order changes are applied, because the winner is recomputed as the max
  * HLC over the full oplog for that register.
  */
-export declare function applyChange(db: Database, c: Change): boolean;
+export declare function applyChange(db: DbDriver, c: Change): boolean;
 /** Apply a local write: assign a fresh HLC, append to oplog, materialize. */
-export declare function emit(db: Database, dataset: string, rowId: string, col: string, value: unknown): Change;
+export declare function emit(db: DbDriver, dataset: string, rowId: string, col: string, value: unknown): Change;
 /** Apply multiple local field writes to the same row. */
-export declare function emitFields(db: Database, dataset: string, rowId: string, fields: Record<string, unknown>): Change[];
+export declare function emitFields(db: DbDriver, dataset: string, rowId: string, fields: Record<string, unknown>): Change[];
 /** Apply remote changes from a sync peer (advances clock, then merges). */
-export declare function ingest(db: Database, changes: Change[]): number;
+export declare function ingest(db: DbDriver, changes: Change[]): number;
 /** All oplog changes with HLC strictly greater than `since` (test/debug helper). */
-export declare function changesSince(db: Database, since: string): Change[];
+export declare function changesSince(db: DbDriver, since: string): Change[];
 export interface ChangeBatch {
     changes: Change[];
     cursor: number;
 }
+export interface ChangesAfterOpts {
+    /** Max rows to return — pagination for large pulls (initial hydration). */
+    limit?: number;
+    /** Datasets to omit (partial replicas, e.g. a phone skipping site_files). */
+    excludeDatasets?: string[];
+}
 /**
  * Changes inserted after `seq` (a local rowid), in insertion order, plus the
  * new high-water cursor. Used for replication: insertion order never skips a
  * change even when clocks are skewed.
+ *
+ * With `limit`, the cursor stops at the last returned row so the next pull
+ * resumes there; when the scan is exhausted (fewer rows than the limit, or no
+ * limit) the cursor jumps to the table's high-water rowid so excluded-dataset
+ * tails aren't rescanned every round.
  */
-export declare function changesAfterSeq(db: Database, seq: number): ChangeBatch;
+export declare function changesAfterSeq(db: DbDriver, seq: number, opts?: ChangesAfterOpts): ChangeBatch;
 //# sourceMappingURL=crdt.d.ts.map

package/dist/core/crdt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"crdt.d.ts","sourceRoot":"","sources":["../../src/core/crdt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAO3C,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AA0ID;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAc5D;AAED,6EAA6E;AAC7E,wBAAgB,IAAI,CAClB,EAAE,EAAE,QAAQ,EACZ,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,GACb,MAAM,CAYR;AAED,yDAAyD;AACzD,wBAAgB,UAAU,CACxB,EAAE,EAAE,QAAQ,EACZ,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,EAAE,CAMV;AAED,2EAA2E;AAC3E,wBAAgB,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAW9D;AAED,oFAAoF;AACpF,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAMlE;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,CAStE"}
+{"version":3,"file":"crdt.d.ts","sourceRoot":"","sources":["../../src/core/crdt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAW5C,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,kFAAkF;AAClF,eAAO,MAAM,WAAW,yEAA0E,CAAC;AAEnG,eAAO,MAAM,aAAa,QAAyB,CAAC;AAMpD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAQvE;AAED,+DAA+D;AAC/D,wBAAgB,OAAO,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,CAAC,EAC5C,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC,EACrB,KAAK,GAAE,MAAM,GAAG,IAAW,GAC1B,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC,CAEnB;AA0ID;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAc5D;AAED,6EAA6E;AAC7E,wBAAgB,IAAI,CAClB,EAAE,EAAE,QAAQ,EACZ,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,GACb,MAAM,CAaR;AAED,yDAAyD;AACzD,wBAAgB,UAAU,CACxB,EAAE,EAAE,QAAQ,EACZ,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,EAAE,CAMV;AAED,2EAA2E;AAC3E,wBAAgB,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAW9D;AAED,oFAAoF;AACpF,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAIlE;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,QAAQ,EACZ,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,gBAAqB,GAC1B,WAAW,CAuBb"}

package/dist/core/databases.d.ts

@@ -1,19 +1,33 @@
-import type { Database } from "bun:sqlite";
+import type { DbDriver } from "./driver.ts";
 export interface DatabaseRow {
     id: string;
     name: string;
     icon: string | null;
     created_hlc: string;
 }
-export declare function createDatabase(db: Database, opts: {
+export declare const DATABASE_COLS: readonly ["id", "name", "icon", "created_hlc"];
+export declare const createDatabase: (db: DbDriver, opts: {
     name: string;
     icon?: string;
-}): DatabaseRow;
-export declare function updateDatabase(db: Database, id: string, fields: {
+}) => DatabaseRow;
+export declare const updateDatabase: (db: DbDriver, id: string, fields: {
     name?: string;
     icon?: string | null;
-}): DatabaseRow;
-export declare function getDatabase(db: Database, id: string): DatabaseRow | null;
-export declare function listDatabases(db: Database): DatabaseRow[];
-export declare function deleteDatabase(db: Database, id: string): boolean;
+}) => DatabaseRow;
+/**
+ * Copy a database whole — name, icon, every property (type/config/position
+ * preserved) and every record (in order, cells carried via an old→new property
+ * id map, so duplicate property names copy losslessly). A relation column
+ * pointing back at the *source* database is remapped to the copy so it stays
+ * self-referential; relations to other databases keep their target.
+ * `name`/`icon` override the defaults; the locale "copy" suffix is the
+ * caller's job. All emits share one txn, so the copy syncs as one revision.
+ */
+export declare const duplicateDatabase: (db: DbDriver, id: string, opts?: {
+    name?: string;
+    icon?: string;
+} | undefined) => DatabaseRow;
+export declare function getDatabase(db: DbDriver, id: string): DatabaseRow | null;
+export declare function listDatabases(db: DbDriver): DatabaseRow[];
+export declare const deleteDatabase: (db: DbDriver, id: string) => boolean;
 //# sourceMappingURL=databases.d.ts.map

package/dist/core/databases.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"databases.d.ts","sourceRoot":"","sources":["../../src/core/databases.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAI3C,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,cAAc,CAC5B,EAAE,EAAE,QAAQ,EACZ,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACpC,WAAW,CAMb;AAED,wBAAgB,cAAc,CAC5B,EAAE,EAAE,QAAQ,EACZ,EAAE,EAAE,MAAM,EACV,MAAM,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC9C,WAAW,CAKb;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAMxE;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,GAAG,WAAW,EAAE,CAMzD;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAqBhE"}
+{"version":3,"file":"databases.d.ts","sourceRoot":"","sources":["../../src/core/databases.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAQ5C,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,aAAa,gDAAiD,CAAC;AAI5E,eAAO,MAAM,cAAc;UAEX,MAAM;WAAS,MAAM;iBAOnC,CAAC;AAEH,eAAO,MAAM,cAAc;WAGR,MAAM;WAAS,MAAM,GAAG,IAAI;iBAM7C,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB;WAGb,MAAM;WAAS,MAAM;6BAwBpC,CAAC;AAEH,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAIxE;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,GAAG,WAAW,EAAE,CAIzD;AAED,eAAO,MAAM,cAAc,uCAqBzB,CAAC"}

package/dist/core/db.d.ts

@@ -1,32 +1,6 @@
 import { Database } from "bun:sqlite";
+export { runSchema, ftsAvailable, migrateRecords, migratePeers, migrateDocBlocks, migrateDocuments, migrateOplog, initSchema, } from "./schema-init.ts";
 export declare function ensureDirs(): void;
-export declare function runSchema(db: Database): void;
-export declare function ftsAvailable(db: Database): boolean;
-/**
- * Migrate legacy EAV records (record_values: one row per cell) to the JSON
- * layout (records.data: one row per record). Idempotent — keyed off schema
- * shape, no version flag. A no-op for fresh databases.
- */
-export declare function migrateRecords(db: Database): void;
-/**
- * Add the peer-pairing columns to a legacy `peers` table (token/label/node_id/
- * enabled/last_sync_at/last_status/last_error). Idempotent — guarded per column,
- * never drops the table so existing replication cursors survive.
- */
-export declare function migratePeers(db: Database): void;
-/**
- * Add the `blank_after` column to a legacy `doc_blocks` table. Idempotent —
- * guarded by hasColumn; existing blocks default to 0 (canonical single-blank-line
- * separators), so the migration never changes an existing document's body.
- */
-export declare function migrateDocBlocks(db: Database): void;
-/**
- * Add the `order_key` column to a legacy `documents` table and backfill it.
- * Idempotent — guarded by hasColumn; backfill only touches rows with a NULL key,
- * assigning per-parent fractional indices in current created_hlc order, so the
- * displayed document order is unchanged until the user first drags something.
- */
-export declare function migrateDocuments(db: Database): void;
 /** Open (and migrate) the on-disk metahub database for the resolved home. */
 export declare function openMetahub(): Database;
 //# sourceMappingURL=db.d.ts.map

package/dist/core/db.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/core/db.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAOtC,wBAAgB,UAAU,IAAI,IAAI,CAGjC;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAO5C;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAKlD;AAeD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAuBjD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAa/C;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAGnD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAInD;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,IAAI,QAAQ,CAUtC"}
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/core/db.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAOtC,OAAO,EACL,SAAS,EACT,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,UAAU,GACX,MAAM,kBAAkB,CAAC;AAE1B,wBAAgB,UAAU,IAAI,IAAI,CAGjC;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,IAAI,QAAQ,CAMtC"}

package/dist/core/documents.d.ts

@@ -1,4 +1,4 @@
-import type { Database } from "bun:sqlite";
+import type { DbDriver } from "./driver.ts";
 export interface DocumentRow {
     id: string;
     title: string;
@@ -9,33 +9,48 @@ export interface DocumentRow {
     order_key: string | null;
 }
 export type DocumentSummary = Omit<DocumentRow, "body">;
+export declare const DOCUMENT_COLS: readonly ["id", "title", "body", "database_id", "parent_id", "created_hlc", "order_key"];
 /** Max HLC over a document's own register and all its blocks — a read/edit token. */
-export declare function documentVersion(db: Database, id: string): string;
-export declare function createDocument(db: Database, opts: {
+export declare function documentVersion(db: DbDriver, id: string): string;
+export declare const createDocument: (db: DbDriver, opts: {
     title: string;
     body?: string;
     database_id?: string;
     parent_id?: string;
-}): DocumentRow;
-export declare function getDocument(db: Database, id: string): DocumentRow | null;
-export declare function listDocuments(db: Database, opts?: {
+}) => DocumentRow;
+export declare function getDocument(db: DbDriver, id: string): DocumentRow | null;
+export declare function listDocuments(db: DbDriver, opts?: {
     database_id?: string;
     parent_id?: string;
 }): DocumentSummary[];
 /** Backfill order_key for every parent group that has un-keyed live documents. */
-export declare function backfillDocumentOrderKeys(db: Database): void;
+export declare const backfillDocumentOrderKeys: (db: DbDriver) => void;
 /**
  * Move a document next to / into another, atomically updating both its parent
  * and its order_key. `into` nests it as the last child of `targetId`;
  * `before`/`after` re-orders (and reparents if needed) among the target's siblings.
  */
-export declare function moveDocument(db: Database, id: string, targetId: string, where: "before" | "after" | "into"): DocumentRow;
-export declare function updateDocument(db: Database, id: string, fields: {
+export declare const moveDocument: (db: DbDriver, id: string, targetId: string, where: "before" | "after" | "into") => DocumentRow;
+/**
+ * Copy a document — title, every block (verbatim, with fresh block ids so the
+ * copy edits independently) and its `database_id`/`parent_id`. The copy lands
+ * right after its source in the same sibling scope. Blocks are cloned at the
+ * block level (not via a markdown round-trip) so empty list items / blank-line
+ * runs survive losslessly. `title`/`parentId` override the defaults; the locale
+ * "copy" suffix is the caller's job. `created_hlc` is the copy's own birth time.
+ */
+export declare const duplicateDocument: (db: DbDriver, id: string, opts?: {
+    title?: string;
+    parentId?: string | null;
+} | undefined) => DocumentRow;
+export declare const updateDocument: (db: DbDriver, id: string, fields: {
     title?: string;
     body?: string;
     database_id?: string;
     parent_id?: string | null;
-}): DocumentRow;
+}, opts?: {
+    ifMatch?: string;
+} | undefined) => DocumentRow;
 export interface EditDocResult {
     id: string;
     changed: boolean;
@@ -48,13 +63,13 @@ export interface EditDocResult {
  * cannot author it without current content, and drift surfaces as "not found".
  * `ifMatch` is an optional staleness backstop (a version from documentVersion).
  */
-export declare function editDocument(db: Database, id: string, opts: {
+export declare const editDocument: (db: DbDriver, id: string, opts: {
     old: string;
     new: string;
     replaceAll?: boolean;
     ifMatch?: string;
-}): EditDocResult;
-export declare function appendDocument(db: Database, id: string, body: string): EditDocResult;
-export declare function prependDocument(db: Database, id: string, body: string): EditDocResult;
-export declare function deleteDocument(db: Database, id: string): boolean;
+}) => EditDocResult;
+export declare const appendDocument: (db: DbDriver, id: string, body: string) => EditDocResult;
+export declare const prependDocument: (db: DbDriver, id: string, body: string) => EditDocResult;
+export declare const deleteDocument: (db: DbDriver, id: string) => boolean;
 //# sourceMappingURL=documents.d.ts.map

package/dist/core/documents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../src/core/documents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAM3C,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AA6FxD,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAShE;AAID,wBAAgB,cAAc,CAC5B,EAAE,EAAE,QAAQ,EACZ,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/E,WAAW,CAYb;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAMxE;AAMD,wBAAgB,aAAa,CAC3B,EAAE,EAAE,QAAQ,EACZ,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACtD,eAAe,EAAE,CAYnB;AAgFD,kFAAkF;AAClF,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAK5D;AAgDD;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,EAAE,EAAE,QAAQ,EACZ,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,GACjC,WAAW,CAUb;AAED,wBAAgB,cAAc,CAC5B,EAAE,EAAE,QAAQ,EACZ,EAAE,EAAE,MAAM,EACV,MAAM,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACzF,WAAW,CAiBb;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,EAAE,EAAE,QAAQ,EACZ,EAAE,EAAE,MAAM,EACV,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACzE,aAAa,CAmCf;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CAUpF;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CAUrF;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAUhE"}
+{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../src/core/documents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAQ5C,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AAExD,eAAO,MAAM,aAAa,0FAEhB,CAAC;AAqGX,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAShE;AAID,eAAO,MAAM,cAAc;WAEV,MAAM;WAAS,MAAM;kBAAgB,MAAM;gBAAc,MAAM;iBAa9E,CAAC;AAEH,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAIxE;AAMD,wBAAgB,aAAa,CAC3B,EAAE,EAAE,QAAQ,EACZ,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACtD,eAAe,EAAE,CAWnB;AAgFD,kFAAkF;AAClF,eAAO,MAAM,yBAAyB,wBAOpC,CAAC;AAgDH;;;;GAIG;AACH,eAAO,MAAM,YAAY,iGAevB,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB;YAGZ,MAAM;eAAa,MAAM,GAAG,IAAI;6BAuBhD,CAAC;AAEH,eAAO,MAAM,cAAc;YAGP,MAAM;WAAS,MAAM;kBAAgB,MAAM;gBAAc,MAAM,GAAG,IAAI;;cACtE,MAAM;6BAsBxB,CAAC;AAEH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY;SAGV,MAAM;SAAO,MAAM;iBAAe,OAAO;cAAY,MAAM;mBAqCxE,CAAC;AAEH,eAAO,MAAM,cAAc,2DAczB,CAAC;AAEH,eAAO,MAAM,eAAe,2DAc1B,CAAC;AAEH,eAAO,MAAM,cAAc,uCAUzB,CAAC"}

package/dist/core/driver.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Minimal synchronous SQLite driver surface that every runtime hosting a
+ * metahub database must provide. The portable core modules type against this
+ * instead of bun:sqlite so the same code can run on Bun (bun:sqlite's
+ * `Database` satisfies it structurally — no adapter needed) and in a browser
+ * worker (sqlite-wasm behind a small adapter).
+ *
+ * Keep this surface to what bun:sqlite and sqlite-wasm can both serve
+ * synchronously: positional `?` binds, `get`/`all`/`run` on prepared
+ * statements, `exec` for scripts, and re-entrant `transaction` wrappers.
+ */
+export type SqlBindable = string | number | bigint | boolean | null | Uint8Array;
+export interface Stmt {
+    get(...params: SqlBindable[]): unknown;
+    all(...params: SqlBindable[]): unknown[];
+    run(...params: SqlBindable[]): {
+        changes: number;
+    };
+}
+export interface DbDriver {
+    query(sql: string): Stmt;
+    exec(sql: string): void;
+    transaction<A extends unknown[], R>(fn: (...args: A) => R): (...args: A) => R;
+}
+//# sourceMappingURL=driver.d.ts.map

package/dist/core/driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../src/core/driver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,UAAU,CAAC;AAEjF,MAAM,WAAW,IAAI;IACnB,GAAG,CAAC,GAAG,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IACvC,GAAG,CAAC,GAAG,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,EAAE,CAAC;IACzC,GAAG,CAAC,GAAG,MAAM,EAAE,WAAW,EAAE,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACpD;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC;CAC/E"}

package/dist/core/errors.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Machine-readable error taxonomy — the contract between core and its callers.
+ *
+ * Agents and scripts dispatch on `code`, never on message text (messages may
+ * be reworded freely). The CLI maps codes to exit codes (src/cli/output.ts)
+ * and the HTTP layer maps them to status codes (src/webui/server/routes.ts),
+ * so adding a code here is enough for both surfaces to pick it up.
+ */
+export type MhErrorCode = 
+/** Bad arguments / refusing a request as stated (HTTP 400, exit 2). */
+"invalid_input"
+/** Referenced entity does not exist (HTTP 404, exit 3). */
+ | "not_found"
+/** A ref matched more than one entity — disambiguate and retry (exit 4). */
+ | "ambiguous"
+/** Optimistic-concurrency failure: re-read, then retry (HTTP 409, exit 5). */
+ | "stale"
+/** State conflict, e.g. a name that already exists (HTTP 409, exit 5). */
+ | "conflict"
+/** Missing/invalid credentials (HTTP 401, exit 6). */
+ | "auth"
+/** A remote peer was unreachable or replied non-OK — retryable (exit 7). */
+ | "network"
+/** The requested listen port is taken (exit 98, historical). */
+ | "port_in_use";
+export declare class MhError extends Error {
+    readonly code: MhErrorCode;
+    constructor(code: MhErrorCode, message: string);
+}
+/** The error's code, for errors that carry one (anything else → undefined). */
+export declare function errorCode(e: unknown): MhErrorCode | undefined;
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW;AACrB,uEAAuE;AACrE,eAAe;AACjB,2DAA2D;GACzD,WAAW;AACb,4EAA4E;GAC1E,WAAW;AACb,8EAA8E;GAC5E,OAAO;AACT,0EAA0E;GACxE,UAAU;AACZ,sDAAsD;GACpD,MAAM;AACR,4EAA4E;GAC1E,SAAS;AACX,gEAAgE;GAC9D,aAAa,CAAC;AAElB,qBAAa,OAAQ,SAAQ,KAAK;IAE9B,QAAQ,CAAC,IAAI,EAAE,WAAW;gBAAjB,IAAI,EAAE,WAAW,EAC1B,OAAO,EAAE,MAAM;CAKlB;AAED,+EAA+E;AAC/E,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,CAE7D"}

package/dist/core/history.d.ts

@@ -0,0 +1,174 @@
+import type { DbDriver } from "./driver.ts";
+/** Where a revision came from, derived from its change-group label. */
+export type RevisionKind = "user" | "repair" | "revert";
+export interface DocRevision {
+    /** Version token (max HLC of the revision) — pass to documentAtVersion/revertDocument. */
+    version: string;
+    /** Wall-clock time derived from the version HLC (ISO 8601). */
+    at: string;
+    node_id: string;
+    /** Source of the revision: a user edit, a repairHub fix, or a revert. */
+    kind: RevisionKind;
+    changes: number;
+    created: boolean;
+    deleted: boolean;
+    title_changed: boolean;
+    blocks_changed: number;
+    blocks_deleted: number;
+}
+/** A document's edit history, newest first, clustered into save-sized revisions. */
+export declare function listDocumentRevisions(db: DbDriver, id: string): DocRevision[];
+export interface DocumentVersionState {
+    id: string;
+    title: string;
+    body: string;
+    deleted: boolean;
+    /** Exact version (max HLC <= the requested cutoff) this state corresponds to. */
+    version: string;
+}
+/** Reconstruct a document as of version cutoff `at` (state at hlc <= at). */
+export declare function documentAtVersion(db: DbDriver, id: string, at: string): DocumentVersionState;
+export interface RevertDocResult {
+    id: string;
+    changed: boolean;
+    /** The version token the document was restored to. */
+    restored: string;
+    /** The document's version after the revert (a new head — revert is a forward write). */
+    version: string;
+    /** True when the revert resurrected a tombstoned document. */
+    undeleted: boolean;
+}
+/**
+ * Restore a document's title/body to a past version, as a new forward edit
+ * (reuses updateDocument's block reconcile, so unchanged blocks keep identity).
+ * Reverting a tombstoned document resurrects it; children unparented by the
+ * delete stay where they are. One change group, so history shows ONE revision.
+ */
+export declare const revertDocument: (db: DbDriver, id: string, to: string, opts?: {
+    ifMatch?: string;
+} | undefined) => RevertDocResult;
+export interface RecordRevision {
+    version: string;
+    at: string;
+    node_id: string;
+    kind: RevisionKind;
+    changes: number;
+    created: boolean;
+    deleted: boolean;
+    /** Property ids of the cells written in this revision. */
+    fields: string[];
+    moved: boolean;
+}
+/** A record's edit history, newest first, clustered into save-sized revisions. */
+export declare function listRecordRevisions(db: DbDriver, id: string): RecordRevision[];
+/** One cell's value change inside a revision. A missing `before`/`after` key
+ *  means the cell did not exist on that side (distinct from an explicit null). */
+export interface FieldChange {
+    prop: string;
+    before?: unknown;
+    after?: unknown;
+}
+export interface DatabaseActivityEntry extends RecordRevision {
+    record_id: string;
+    /** Title-property value as of this revision — deleted records keep their last title. */
+    record_title: string | null;
+    /** Value-level changes of the touched cells. */
+    diffs: FieldChange[];
+}
+/**
+ * "What happened in this table lately": every record's revisions, merged and
+ * sorted newest first. Includes tombstoned records (so deletions show up) — a
+ * read-only aggregation, same clustering as listRecordRevisions per record.
+ * Walking each record's change stream oldest-first lets us carry a running
+ * cell-state map, so every entry ships its old→new values and a title snapshot
+ * for free (no extra queries). After compaction, `before` at the window edge
+ * may be missing (the superseded write was pruned) — it reads as "was empty".
+ */
+export declare function listDatabaseActivity(db: DbDriver, databaseId: string, opts?: {
+    limit?: number;
+}): DatabaseActivityEntry[];
+export interface RecordVersionState {
+    id: string;
+    database_id: string | null;
+    deleted: boolean;
+    /** Cells present at that version, keyed by property id (raw, no name mapping). */
+    data: Record<string, unknown>;
+    version: string;
+}
+/** Reconstruct a record as of version cutoff `at` (state at hlc <= at). */
+export declare function recordAtVersion(db: DbDriver, id: string, at: string): RecordVersionState;
+export interface RevertRecordResult {
+    id: string;
+    changed: boolean;
+    /** Property ids whose cells were written by the revert. */
+    fields: string[];
+    /** True when the revert resurrected a tombstoned record. */
+    undeleted: boolean;
+    restored: string;
+}
+/** Restore a record's cells to a past version as a new forward edit. Only cells
+ *  of currently-live properties are touched, so no orphan cells are recreated
+ *  (the repairHub invariant). Reverting a tombstoned record resurrects it. */
+export declare const revertRecord: (db: DbDriver, id: string, to: string) => RevertRecordResult;
+export interface PropertyRevision {
+    version: string;
+    at: string;
+    node_id: string;
+    kind: RevisionKind;
+    changes: number;
+    created: boolean;
+    deleted: boolean;
+    /** Definition columns touched in this revision (name/type/config/position). */
+    fields: string[];
+    /** Record cells the same change group cleared (a type change / removal cascade). */
+    cells_cleared: number;
+}
+/** A property's definition history, newest first. Cascaded cell clears are
+ *  counted via the shared txn so a type change reads as one revision. */
+export declare function listPropertyRevisions(db: DbDriver, id: string): PropertyRevision[];
+export interface PropertyVersionState {
+    id: string;
+    database_id: string | null;
+    name: string;
+    type: string;
+    config: unknown;
+    position: number | null;
+    deleted: boolean;
+    version: string;
+}
+/** Reconstruct a property definition as of version cutoff `at`. */
+export declare function propertyAtVersion(db: DbDriver, id: string, at: string): PropertyVersionState;
+export interface RevertPropertyResult {
+    id: string;
+    changed: boolean;
+    /** Definition columns the revert wrote. */
+    fields: string[];
+    /** Record cells restored to their value at the target version. */
+    restored_cells: number;
+    /** Cells left alone because a user wrote them after the target version. */
+    skipped_cells: number;
+    undeleted: boolean;
+    restored: string;
+}
+/**
+ * Schema-level rollback: restore a property's definition AND the record cells
+ * its later type-change/removal cascades cleared. Definition registers are
+ * emitted directly (never via updateProperty — its type-change cascade would
+ * re-clear the cells being restored). A cell is only touched when its current
+ * winner IS the cascade (or a repair); it is restored to the last value before
+ * that cascade, so user data — written before or after the target version —
+ * always survives. Cells whose winner is a user write are kept (skipped_cells).
+ * Pre-txn legacy writes can't be attributed, so they count as user writes.
+ */
+export declare const revertProperty: (db: DbDriver, id: string, to: string) => RevertPropertyResult;
+export interface FieldHistoryEntry {
+    version: string;
+    at: string;
+    node_id: string;
+    /** The value written; undefined when the write cleared the cell. */
+    value: unknown;
+    cleared: boolean;
+}
+/** The full write trail of one record cell (property id), newest first. */
+export declare function recordFieldHistory(db: DbDriver, id: string, propId: string): FieldHistoryEntry[];
+//# sourceMappingURL=history.d.ts.map

package/dist/core/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/core/history.ts"],"names":[],"mappings":"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"}

package/dist/core/hlc.d.ts

@@ -1,4 +1,4 @@
-import type { Database } from "bun:sqlite";
+import type { DbDriver } from "./driver.ts";
 export interface Hlc {
     millis: number;
     counter: number;
@@ -7,7 +7,7 @@ export interface Hlc {
 export declare function formatHlc(h: Hlc): string;
 export declare function parseHlc(s: string): Hlc;
 /** Issue a new timestamp for a local event, advancing the persisted clock. */
-export declare function nextHlc(db: Database, node: string, now?: number): string;
+export declare function nextHlc(db: DbDriver, node: string, now?: number): string;
 /** Advance the local clock to account for an observed remote timestamp. */
-export declare function observeHlc(db: Database, node: string, remote: string, now?: number): void;
+export declare function observeHlc(db: DbDriver, node: string, remote: string, now?: number): void;
 //# sourceMappingURL=hlc.d.ts.map

package/dist/core/hlc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hlc.d.ts","sourceRoot":"","sources":["../../src/core/hlc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAK3C,MAAM,WAAW,GAAG;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,GAAG,MAAM,CAIxC;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAQvC;AAeD,8EAA8E;AAC9E,wBAAgB,OAAO,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,SAAa,GAAG,MAAM,CAO5E;AAED,2EAA2E;AAC3E,wBAAgB,UAAU,CACxB,EAAE,EAAE,QAAQ,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,GAAG,SAAa,GACf,IAAI,CAWN"}
+{"version":3,"file":"hlc.d.ts","sourceRoot":"","sources":["../../src/core/hlc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAK5C,MAAM,WAAW,GAAG;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,GAAG,MAAM,CAIxC;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAQvC;AAeD,8EAA8E;AAC9E,wBAAgB,OAAO,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,SAAa,GAAG,MAAM,CAO5E;AAED,2EAA2E;AAC3E,wBAAgB,UAAU,CACxB,EAAE,EAAE,QAAQ,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,GAAG,SAAa,GACf,IAAI,CAWN"}