@noy-db/hub 0.1.0-pre.3

package/dist/history/index.d.cts

@@ -0,0 +1,62 @@
+import { as as HistoryStrategy, at as NoydbStore, au as HistoryOptions, av as EncryptedEnvelope, aw as PruneOptions } from '../types-Bfs0qr5F.cjs';
+export { ax as AppendInput, ay as ChangeType, az as CollectionInstant, aA as DiffEntry, aB as JsonPatch, aC as JsonPatchOp, aD as LedgerEntry, aE as LedgerStore, aF as VaultEngine, aG as VaultInstant, aH as VerifyResult, aI as applyPatch, aJ as canonicalJson, aK as computePatch, aL as diff, aM as formatDiff, aN as hashEntry, aO as paddedIndex, aP as parseIndex, aQ as sha256Hex } from '../types-Bfs0qr5F.cjs';
+export { L as LEDGER_COLLECTION, a as LEDGER_DELTAS_COLLECTION, e as envelopePayloadHash } from '../hash-9KO1BGxh.cjs';
+import '../lazy-builder-CZVLKh0Z.cjs';
+import '../predicate-SBHmi6D0.cjs';
+import '../strategy-D-SrOLCl.cjs';
+import '../strategy-BSxFXGzb.cjs';
+import '../index-DN-J-5wT.cjs';
+
+/**
+ * Active history strategy — `withHistory()` returns the real
+ * implementation that wires per-record snapshots, the hash-chained
+ * audit ledger, JSON-patch deltas, and time-machine reads into the
+ * core write/read paths.
+ *
+ * Consumers opt in by:
+ *
+ * ```ts
+ * import { createNoydb } from '@noy-db/hub'
+ * import { withHistory } from '@noy-db/hub/history'
+ *
+ * const db = await createNoydb({
+ *   store: ...,
+ *   user: ...,
+ *   historyStrategy: withHistory(),
+ * })
+ * ```
+ *
+ * The factory is a thin wrapper that delegates to the existing
+ * `history.ts`, `diff.ts`, `ledger/store.ts`, `ledger/patch.ts`, and
+ * `time-machine.ts` modules. Splitting the import chain through this
+ * file is what lets `tsup` tree-shake the heavy modules out of the
+ * default `@noy-db/hub` bundle when no `withHistory()` import is
+ * present in the consumer.
+ *
+ * @public
+ */
+
+/**
+ * Build the active history strategy. Today the factory takes no
+ * options; per-collection retention tuning still flows through
+ * `HistoryConfig` on `Vault.collection()` / `vault.openVault()`.
+ *
+ * Future option slots (kept off the LTS surface for now):
+ *   - global maxVersions cap
+ *   - global beforeDate prune cadence
+ *   - ledger encryption toggle (today inferred from vault.encrypted)
+ */
+declare function withHistory(): HistoryStrategy;
+
+/** Save a history entry (a complete encrypted envelope snapshot). */
+declare function saveHistory(adapter: NoydbStore, vault: string, collection: string, recordId: string, envelope: EncryptedEnvelope): Promise<void>;
+/** Get history entries for a record, sorted newest-first. */
+declare function getHistory(adapter: NoydbStore, vault: string, collection: string, recordId: string, options?: HistoryOptions): Promise<EncryptedEnvelope[]>;
+/** Get a specific version's envelope from history. */
+declare function getVersionEnvelope(adapter: NoydbStore, vault: string, collection: string, recordId: string, version: number): Promise<EncryptedEnvelope | null>;
+/** Prune history entries. Returns the number of entries deleted. */
+declare function pruneHistory(adapter: NoydbStore, vault: string, collection: string, recordId: string | undefined, options: PruneOptions): Promise<number>;
+/** Clear all history for a vault, optionally scoped to a collection or record. */
+declare function clearHistory(adapter: NoydbStore, vault: string, collection?: string, recordId?: string): Promise<number>;
+
+export { HistoryStrategy, clearHistory, getHistory, getVersionEnvelope, pruneHistory, saveHistory, withHistory };

package/dist/history/index.d.ts

@@ -0,0 +1,62 @@
+import { as as HistoryStrategy, at as NoydbStore, au as HistoryOptions, av as EncryptedEnvelope, aw as PruneOptions } from '../types-BZpCZB8N.js';
+export { ax as AppendInput, ay as ChangeType, az as CollectionInstant, aA as DiffEntry, aB as JsonPatch, aC as JsonPatchOp, aD as LedgerEntry, aE as LedgerStore, aF as VaultEngine, aG as VaultInstant, aH as VerifyResult, aI as applyPatch, aJ as canonicalJson, aK as computePatch, aL as diff, aM as formatDiff, aN as hashEntry, aO as paddedIndex, aP as parseIndex, aQ as sha256Hex } from '../types-BZpCZB8N.js';
+export { L as LEDGER_COLLECTION, a as LEDGER_DELTAS_COLLECTION, e as envelopePayloadHash } from '../hash-ChfJjRjQ.js';
+import '../lazy-builder-BwEoBQZ9.js';
+import '../predicate-SBHmi6D0.js';
+import '../strategy-D-SrOLCl.js';
+import '../strategy-BSxFXGzb.js';
+import '../index-BRHBCmLt.js';
+
+/**
+ * Active history strategy — `withHistory()` returns the real
+ * implementation that wires per-record snapshots, the hash-chained
+ * audit ledger, JSON-patch deltas, and time-machine reads into the
+ * core write/read paths.
+ *
+ * Consumers opt in by:
+ *
+ * ```ts
+ * import { createNoydb } from '@noy-db/hub'
+ * import { withHistory } from '@noy-db/hub/history'
+ *
+ * const db = await createNoydb({
+ *   store: ...,
+ *   user: ...,
+ *   historyStrategy: withHistory(),
+ * })
+ * ```
+ *
+ * The factory is a thin wrapper that delegates to the existing
+ * `history.ts`, `diff.ts`, `ledger/store.ts`, `ledger/patch.ts`, and
+ * `time-machine.ts` modules. Splitting the import chain through this
+ * file is what lets `tsup` tree-shake the heavy modules out of the
+ * default `@noy-db/hub` bundle when no `withHistory()` import is
+ * present in the consumer.
+ *
+ * @public
+ */
+
+/**
+ * Build the active history strategy. Today the factory takes no
+ * options; per-collection retention tuning still flows through
+ * `HistoryConfig` on `Vault.collection()` / `vault.openVault()`.
+ *
+ * Future option slots (kept off the LTS surface for now):
+ *   - global maxVersions cap
+ *   - global beforeDate prune cadence
+ *   - ledger encryption toggle (today inferred from vault.encrypted)
+ */
+declare function withHistory(): HistoryStrategy;
+
+/** Save a history entry (a complete encrypted envelope snapshot). */
+declare function saveHistory(adapter: NoydbStore, vault: string, collection: string, recordId: string, envelope: EncryptedEnvelope): Promise<void>;
+/** Get history entries for a record, sorted newest-first. */
+declare function getHistory(adapter: NoydbStore, vault: string, collection: string, recordId: string, options?: HistoryOptions): Promise<EncryptedEnvelope[]>;
+/** Get a specific version's envelope from history. */
+declare function getVersionEnvelope(adapter: NoydbStore, vault: string, collection: string, recordId: string, version: number): Promise<EncryptedEnvelope | null>;
+/** Prune history entries. Returns the number of entries deleted. */
+declare function pruneHistory(adapter: NoydbStore, vault: string, collection: string, recordId: string | undefined, options: PruneOptions): Promise<number>;
+/** Clear all history for a vault, optionally scoped to a collection or record. */
+declare function clearHistory(adapter: NoydbStore, vault: string, collection?: string, recordId?: string): Promise<number>;
+
+export { HistoryStrategy, clearHistory, getHistory, getVersionEnvelope, pruneHistory, saveHistory, withHistory };

package/dist/history/index.js

@@ -0,0 +1,79 @@
+import {
+  CollectionInstant,
+  VaultInstant,
+  clearHistory,
+  diff,
+  formatDiff,
+  getHistory,
+  getVersionEnvelope,
+  pruneHistory,
+  saveHistory
+} from "../chunk-NXFEYLVG.js";
+import {
+  LEDGER_COLLECTION,
+  LEDGER_DELTAS_COLLECTION,
+  LedgerStore,
+  applyPatch,
+  computePatch
+} from "../chunk-XHFOENR2.js";
+import {
+  canonicalJson,
+  envelopePayloadHash,
+  hashEntry,
+  paddedIndex,
+  parseIndex,
+  sha256Hex
+} from "../chunk-CIMZBAZB.js";
+import "../chunk-ZRG4V3F5.js";
+import "../chunk-MR4424N3.js";
+import "../chunk-ACLDOTNQ.js";
+
+// src/history/active.ts
+function withHistory() {
+  return {
+    saveHistory,
+    getHistoryEntries: getHistory,
+    getVersionEnvelope,
+    pruneHistory,
+    clearHistory,
+    envelopePayloadHash,
+    computePatch,
+    diff,
+    buildLedger(opts) {
+      return new LedgerStore({
+        adapter: opts.adapter,
+        vault: opts.vault,
+        encrypted: opts.encrypted,
+        getDEK: opts.getDEK,
+        actor: opts.actor
+      });
+    },
+    buildVaultInstant(engine, timestamp) {
+      return new VaultInstant(engine, timestamp);
+    }
+  };
+}
+export {
+  CollectionInstant,
+  LEDGER_COLLECTION,
+  LEDGER_DELTAS_COLLECTION,
+  LedgerStore,
+  VaultInstant,
+  applyPatch,
+  canonicalJson,
+  clearHistory,
+  computePatch,
+  diff,
+  envelopePayloadHash,
+  formatDiff,
+  getHistory,
+  getVersionEnvelope,
+  hashEntry,
+  paddedIndex,
+  parseIndex,
+  pruneHistory,
+  saveHistory,
+  sha256Hex,
+  withHistory
+};
+//# sourceMappingURL=index.js.map

package/dist/history/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/history/active.ts"],"sourcesContent":["/**\n * Active history strategy — `withHistory()` returns the real\n * implementation that wires per-record snapshots, the hash-chained\n * audit ledger, JSON-patch deltas, and time-machine reads into the\n * core write/read paths.\n *\n * Consumers opt in by:\n *\n * ```ts\n * import { createNoydb } from '@noy-db/hub'\n * import { withHistory } from '@noy-db/hub/history'\n *\n * const db = await createNoydb({\n *   store: ...,\n *   user: ...,\n *   historyStrategy: withHistory(),\n * })\n * ```\n *\n * The factory is a thin wrapper that delegates to the existing\n * `history.ts`, `diff.ts`, `ledger/store.ts`, `ledger/patch.ts`, and\n * `time-machine.ts` modules. Splitting the import chain through this\n * file is what lets `tsup` tree-shake the heavy modules out of the\n * default `@noy-db/hub` bundle when no `withHistory()` import is\n * present in the consumer.\n *\n * @public\n */\n\nimport type { HistoryStrategy, BuildLedgerOptions } from './strategy.js'\nimport {\n  saveHistory,\n  getHistory,\n  getVersionEnvelope,\n  pruneHistory,\n  clearHistory,\n} from './history.js'\nimport { diff as computeDiff } from './diff.js'\nimport { LedgerStore, envelopePayloadHash } from './ledger/store.js'\nimport { computePatch } from './ledger/patch.js'\nimport { VaultInstant } from './time-machine.js'\n\n/**\n * Build the active history strategy. Today the factory takes no\n * options; per-collection retention tuning still flows through\n * `HistoryConfig` on `Vault.collection()` / `vault.openVault()`.\n *\n * Future option slots (kept off the LTS surface for now):\n *   - global maxVersions cap\n *   - global beforeDate prune cadence\n *   - ledger encryption toggle (today inferred from vault.encrypted)\n */\nexport function withHistory(): HistoryStrategy {\n  return {\n    saveHistory,\n    getHistoryEntries: getHistory,\n    getVersionEnvelope,\n    pruneHistory,\n    clearHistory,\n    envelopePayloadHash,\n    computePatch,\n    diff: computeDiff,\n    buildLedger(opts: BuildLedgerOptions): LedgerStore {\n      return new LedgerStore({\n        adapter: opts.adapter,\n        vault: opts.vault,\n        encrypted: opts.encrypted,\n        getDEK: opts.getDEK,\n        actor: opts.actor,\n      })\n    },\n    buildVaultInstant(engine, timestamp): VaultInstant {\n      return new VaultInstant(engine, timestamp)\n    },\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoDO,SAAS,cAA+B;AAC7C,SAAO;AAAA,IACL;AAAA,IACA,mBAAmB;AAAA,IACnB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,YAAY,MAAuC;AACjD,aAAO,IAAI,YAAY;AAAA,QACrB,SAAS,KAAK;AAAA,QACd,OAAO,KAAK;AAAA,QACZ,WAAW,KAAK;AAAA,QAChB,QAAQ,KAAK;AAAA,QACb,OAAO,KAAK;AAAA,MACd,CAAC;AAAA,IACH;AAAA,IACA,kBAAkB,QAAQ,WAAyB;AACjD,aAAO,IAAI,aAAa,QAAQ,SAAS;AAAA,IAC3C;AAAA,EACF;AACF;","names":[]}