@noy-db/hub 0.2.0-pre.8 → 0.2.0-pre.9

package/dist/consent/index.d.cts

@@ -1,5 +1,5 @@
-import { a8 as ConsentStrategy } from '../types-DjunxzJa.cjs';
-export { a9 as CONSENT_AUDIT_COLLECTION, aa as ConsentAuditEntry, ab as ConsentAuditFilter, ac as ConsentContext, ad as ConsentOp, ae as loadConsentEntries, af as writeConsentEntry } from '../types-DjunxzJa.cjs';
+import { a8 as ConsentStrategy } from '../types-DyXYr8rE.cjs';
+export { a9 as CONSENT_AUDIT_COLLECTION, aa as ConsentAuditEntry, ab as ConsentAuditFilter, ac as ConsentContext, ad as ConsentOp, ae as loadConsentEntries, af as writeConsentEntry } from '../types-DyXYr8rE.cjs';
 import '../lazy-builder-wY4pMCEe.cjs';
 import '../predicate-BSAGEyu5.cjs';
 import '../strategy-DSTrsZ8t.cjs';

package/dist/consent/index.d.ts

@@ -1,5 +1,5 @@
-import { a8 as ConsentStrategy } from '../types-DGU60JDt.js';
-export { a9 as CONSENT_AUDIT_COLLECTION, aa as ConsentAuditEntry, ab as ConsentAuditFilter, ac as ConsentContext, ad as ConsentOp, ae as loadConsentEntries, af as writeConsentEntry } from '../types-DGU60JDt.js';
+import { a8 as ConsentStrategy } from '../types-Df28QFKb.js';
+export { a9 as CONSENT_AUDIT_COLLECTION, aa as ConsentAuditEntry, ab as ConsentAuditFilter, ac as ConsentContext, ad as ConsentOp, ae as loadConsentEntries, af as writeConsentEntry } from '../types-Df28QFKb.js';
 import '../lazy-builder-7tIpFyWN.js';
 import '../predicate-BSAGEyu5.js';
 import '../strategy-DSTrsZ8t.js';

package/dist/derivations/index.d.cts

@@ -1,6 +1,6 @@
-export { w as withDerivation } from '../with-derivation-Df0kMlED.cjs';
-import { aL as DerivationStrategy, aM as DerivationContext } from '../types-DjunxzJa.cjs';
-export { aN as ArrayOutputSpec, aO as DerivationRegistry, aP as DerivationStrategyHandle, aQ as DerivedFromMeta, aR as OutputSpec, aS as RecordOutputSpec } from '../types-DjunxzJa.cjs';
+export { w as withDerivation } from '../with-derivation-DU3Sjazm.cjs';
+import { aN as DerivationStrategy, aO as DerivationContext } from '../types-DyXYr8rE.cjs';
+export { aP as ArrayOutputSpec, aQ as DerivationRegistry, aR as DerivationStrategyHandle, aS as DerivedFromMeta, aT as OutputSpec, aU as RecordOutputSpec } from '../types-DyXYr8rE.cjs';
 export { g as DerivationCapExceededError, h as DerivationCycleError, i as DerivationDepthError, j as DerivationOutputShapeError, k as DerivationOutputUnknownError } from '../index-4fBVt8j9.cjs';
 import '../lazy-builder-wY4pMCEe.cjs';
 import '../predicate-BSAGEyu5.cjs';

package/dist/derivations/index.d.ts

@@ -1,6 +1,6 @@
-export { w as withDerivation } from '../with-derivation-DfOpKjFw.js';
-import { aL as DerivationStrategy, aM as DerivationContext } from '../types-DGU60JDt.js';
-export { aN as ArrayOutputSpec, aO as DerivationRegistry, aP as DerivationStrategyHandle, aQ as DerivedFromMeta, aR as OutputSpec, aS as RecordOutputSpec } from '../types-DGU60JDt.js';
+export { w as withDerivation } from '../with-derivation-DFnFByiQ.js';
+import { aN as DerivationStrategy, aO as DerivationContext } from '../types-Df28QFKb.js';
+export { aP as ArrayOutputSpec, aQ as DerivationRegistry, aR as DerivationStrategyHandle, aS as DerivedFromMeta, aT as OutputSpec, aU as RecordOutputSpec } from '../types-Df28QFKb.js';
 export { g as DerivationCapExceededError, h as DerivationCycleError, i as DerivationDepthError, j as DerivationOutputShapeError, k as DerivationOutputUnknownError } from '../index-D8I_pyJD.js';
 import '../lazy-builder-7tIpFyWN.js';
 import '../predicate-BSAGEyu5.js';

package/dist/{dev-unlock-p3ysikWP.d.ts → dev-unlock-B4kDxep_.d.ts}

@@ -1,4 +1,4 @@
-import { a_ as Role, a$ as UnlockedKeyring } from './types-DGU60JDt.js';
+import { b0 as Role, b1 as UnlockedKeyring } from './types-Df28QFKb.js';
 
 /**
  * Session tokens —

package/dist/{dev-unlock-M4VAWNq_.d.cts → dev-unlock-BIoEFbwm.d.cts}

@@ -1,4 +1,4 @@
-import { a_ as Role, a$ as UnlockedKeyring } from './types-DjunxzJa.cjs';
+import { b0 as Role, b1 as UnlockedKeyring } from './types-DyXYr8rE.cjs';
 
 /**
  * Session tokens —

package/dist/guards/index.d.cts

@@ -1,6 +1,6 @@
-export { w as withGuard } from '../with-guard-C6W5RVrH.cjs';
-import { as as GuardStrategy, at as GuardChange, au as GuardContext } from '../types-DjunxzJa.cjs';
-export { av as GuardRegistry, aw as GuardStrategyHandle, ax as ReadOnlyVaultFacade } from '../types-DjunxzJa.cjs';
+export { w as withGuard } from '../with-guard-ByyxmEe7.cjs';
+import { as as GuardStrategy, at as GuardChange, au as GuardContext } from '../types-DyXYr8rE.cjs';
+export { av as GuardRegistry, aw as GuardStrategyHandle, ax as ReadOnlyVaultFacade } from '../types-DyXYr8rE.cjs';
 export { A as AmendmentForbiddenError, F as FieldFrozenError, I as InvariantError, e as RecordLockedError } from '../index-4fBVt8j9.cjs';
 import '../lazy-builder-wY4pMCEe.cjs';
 import '../predicate-BSAGEyu5.cjs';

package/dist/guards/index.d.ts

@@ -1,6 +1,6 @@
-export { w as withGuard } from '../with-guard-0KksDtSR.js';
-import { as as GuardStrategy, at as GuardChange, au as GuardContext } from '../types-DGU60JDt.js';
-export { av as GuardRegistry, aw as GuardStrategyHandle, ax as ReadOnlyVaultFacade } from '../types-DGU60JDt.js';
+export { w as withGuard } from '../with-guard-qube6BMI.js';
+import { as as GuardStrategy, at as GuardChange, au as GuardContext } from '../types-Df28QFKb.js';
+export { av as GuardRegistry, aw as GuardStrategyHandle, ax as ReadOnlyVaultFacade } from '../types-Df28QFKb.js';
 export { A as AmendmentForbiddenError, F as FieldFrozenError, I as InvariantError, e as RecordLockedError } from '../index-D8I_pyJD.js';
 import '../lazy-builder-7tIpFyWN.js';
 import '../predicate-BSAGEyu5.js';

package/dist/{hash-BPsYPcv_.d.cts → hash-DdpVypUp.d.cts}

@@ -1,4 +1,4 @@
-import { b3 as EncryptedEnvelope } from './types-DjunxzJa.cjs';
+import { b5 as EncryptedEnvelope } from './types-DyXYr8rE.cjs';
 
 /**
  * Ledger storage constants — pinned in their own leaf module so

package/dist/{hash-C1GtiOhR.d.ts → hash-HJqD14vS.d.ts}

@@ -1,4 +1,4 @@
-import { b3 as EncryptedEnvelope } from './types-DGU60JDt.js';
+import { b5 as EncryptedEnvelope } from './types-Df28QFKb.js';
 
 /**
  * Ledger storage constants — pinned in their own leaf module so

package/dist/history/index.d.cts

@@ -1,6 +1,6 @@
-import { b0 as HistoryStrategy, b1 as NoydbStore, b2 as HistoryOptions, b3 as EncryptedEnvelope, b4 as PruneOptions } from '../types-DjunxzJa.cjs';
-export { b5 as AppendInput, b6 as ChangeType, b7 as CollectionInstant, b8 as DiffEntry, b9 as JsonPatch, ba as JsonPatchOp, bb as LedgerEntry, bc as LedgerStore, bd as VaultEngine, be as VaultInstant, bf as VerifyResult, bg as applyPatch, bh as canonicalJson, bi as computePatch, bj as diff, bk as formatDiff, bl as hashEntry, bm as paddedIndex, bn as parseIndex, bo as sha256Hex } from '../types-DjunxzJa.cjs';
-export { L as LEDGER_COLLECTION, a as LEDGER_DELTAS_COLLECTION, e as envelopePayloadHash } from '../hash-BPsYPcv_.cjs';
+import { b2 as HistoryStrategy, b3 as NoydbStore, b4 as HistoryOptions, b5 as EncryptedEnvelope, b6 as PruneOptions } from '../types-DyXYr8rE.cjs';
+export { b7 as AppendInput, b8 as ChangeType, b9 as CollectionInstant, ba as DiffEntry, bb as JsonPatch, bc as JsonPatchOp, bd as LedgerEntry, be as LedgerStore, bf as VaultEngine, bg as VaultInstant, bh as VerifyResult, bi as applyPatch, bj as canonicalJson, bk as computePatch, bl as diff, bm as formatDiff, bn as hashEntry, bo as paddedIndex, bp as parseIndex, bq as sha256Hex } from '../types-DyXYr8rE.cjs';
+export { L as LEDGER_COLLECTION, a as LEDGER_DELTAS_COLLECTION, e as envelopePayloadHash } from '../hash-DdpVypUp.cjs';
 import '../lazy-builder-wY4pMCEe.cjs';
 import '../predicate-BSAGEyu5.cjs';
 import '../strategy-DSTrsZ8t.cjs';

package/dist/history/index.d.ts

@@ -1,6 +1,6 @@
-import { b0 as HistoryStrategy, b1 as NoydbStore, b2 as HistoryOptions, b3 as EncryptedEnvelope, b4 as PruneOptions } from '../types-DGU60JDt.js';
-export { b5 as AppendInput, b6 as ChangeType, b7 as CollectionInstant, b8 as DiffEntry, b9 as JsonPatch, ba as JsonPatchOp, bb as LedgerEntry, bc as LedgerStore, bd as VaultEngine, be as VaultInstant, bf as VerifyResult, bg as applyPatch, bh as canonicalJson, bi as computePatch, bj as diff, bk as formatDiff, bl as hashEntry, bm as paddedIndex, bn as parseIndex, bo as sha256Hex } from '../types-DGU60JDt.js';
-export { L as LEDGER_COLLECTION, a as LEDGER_DELTAS_COLLECTION, e as envelopePayloadHash } from '../hash-C1GtiOhR.js';
+import { b2 as HistoryStrategy, b3 as NoydbStore, b4 as HistoryOptions, b5 as EncryptedEnvelope, b6 as PruneOptions } from '../types-Df28QFKb.js';
+export { b7 as AppendInput, b8 as ChangeType, b9 as CollectionInstant, ba as DiffEntry, bb as JsonPatch, bc as JsonPatchOp, bd as LedgerEntry, be as LedgerStore, bf as VaultEngine, bg as VaultInstant, bh as VerifyResult, bi as applyPatch, bj as canonicalJson, bk as computePatch, bl as diff, bm as formatDiff, bn as hashEntry, bo as paddedIndex, bp as parseIndex, bq as sha256Hex } from '../types-Df28QFKb.js';
+export { L as LEDGER_COLLECTION, a as LEDGER_DELTAS_COLLECTION, e as envelopePayloadHash } from '../hash-HJqD14vS.js';
 import '../lazy-builder-7tIpFyWN.js';
 import '../predicate-BSAGEyu5.js';
 import '../strategy-DSTrsZ8t.js';

package/dist/i18n/index.d.cts

@@ -1,5 +1,5 @@
-import { I as I18nStrategy } from '../types-DjunxzJa.cjs';
-export { D as DICT_COLLECTION_PREFIX, a as DictEntry, b as DictKeyDescriptor, c as DictionaryHandle, d as DictionaryOptions, e as I18nMap, f as I18nTextDescriptor, g as I18nTextOptions, L as Layer, O as OnMissing, h as OnMissingPolicy, R as ResolveI18nOptions, S as ScriptWarning, i as applyI18nLocale, j as dictCollectionName, k as dictKey, l as enforceScript, m as getAtPath, n as i18nText, o as inferScripts, p as isDictCollectionName, q as isDictKeyDescriptor, r as isI18nTextDescriptor, s as resolveI18nText, t as resolvePolicy, u as setAtPathInPlace, v as validateI18nTextValue } from '../types-DjunxzJa.cjs';
+import { I as I18nStrategy } from '../types-DyXYr8rE.cjs';
+export { D as DICT_COLLECTION_PREFIX, a as DictEntry, b as DictKeyDescriptor, c as DictionaryHandle, d as DictionaryOptions, e as I18nMap, f as I18nTextDescriptor, g as I18nTextOptions, L as Layer, O as OnMissing, h as OnMissingPolicy, R as ResolveI18nOptions, S as ScriptWarning, i as applyI18nLocale, j as dictCollectionName, k as dictKey, l as enforceScript, m as getAtPath, n as i18nText, o as inferScripts, p as isDictCollectionName, q as isDictKeyDescriptor, r as isI18nTextDescriptor, s as resolveI18nText, t as resolvePolicy, u as setAtPathInPlace, v as validateI18nTextValue } from '../types-DyXYr8rE.cjs';
 export { D as DictKeyInUseError, a as DictKeyMissingError, L as LocaleNotSpecifiedError, M as MissingTranslationError, R as ReservedCollectionNameError, S as ScriptViolationError, T as TranslatorNotConfiguredError } from '../index-4fBVt8j9.cjs';
 import '../lazy-builder-wY4pMCEe.cjs';
 import '../predicate-BSAGEyu5.cjs';

package/dist/i18n/index.d.ts

@@ -1,5 +1,5 @@
-import { I as I18nStrategy } from '../types-DGU60JDt.js';
-export { D as DICT_COLLECTION_PREFIX, a as DictEntry, b as DictKeyDescriptor, c as DictionaryHandle, d as DictionaryOptions, e as I18nMap, f as I18nTextDescriptor, g as I18nTextOptions, L as Layer, O as OnMissing, h as OnMissingPolicy, R as ResolveI18nOptions, S as ScriptWarning, i as applyI18nLocale, j as dictCollectionName, k as dictKey, l as enforceScript, m as getAtPath, n as i18nText, o as inferScripts, p as isDictCollectionName, q as isDictKeyDescriptor, r as isI18nTextDescriptor, s as resolveI18nText, t as resolvePolicy, u as setAtPathInPlace, v as validateI18nTextValue } from '../types-DGU60JDt.js';
+import { I as I18nStrategy } from '../types-Df28QFKb.js';
+export { D as DICT_COLLECTION_PREFIX, a as DictEntry, b as DictKeyDescriptor, c as DictionaryHandle, d as DictionaryOptions, e as I18nMap, f as I18nTextDescriptor, g as I18nTextOptions, L as Layer, O as OnMissing, h as OnMissingPolicy, R as ResolveI18nOptions, S as ScriptWarning, i as applyI18nLocale, j as dictCollectionName, k as dictKey, l as enforceScript, m as getAtPath, n as i18nText, o as inferScripts, p as isDictCollectionName, q as isDictKeyDescriptor, r as isI18nTextDescriptor, s as resolveI18nText, t as resolvePolicy, u as setAtPathInPlace, v as validateI18nTextValue } from '../types-Df28QFKb.js';
 export { D as DictKeyInUseError, a as DictKeyMissingError, L as LocaleNotSpecifiedError, M as MissingTranslationError, R as ReservedCollectionNameError, S as ScriptViolationError, T as TranslatorNotConfiguredError } from '../index-D8I_pyJD.js';
 import '../lazy-builder-7tIpFyWN.js';
 import '../predicate-BSAGEyu5.js';

package/dist/index.cjs

@@ -19863,6 +19863,119 @@ var NO_SNAPSHOTS = {
   },
   async restoreSnapshot() {
     throw NOT_ENABLED5;
+  },
+  async autoSnapshot() {
+    throw NOT_ENABLED5;
+  }
+};
+
+// src/snapshots/scheduler.ts
+var SnapshotScheduler = class {
+  policy;
+  callbacks;
+  debounceTimer = null;
+  intervalTimer = null;
+  lastFireTime = 0;
+  firing = false;
+  started = false;
+  boundVisibility = null;
+  boundUnload = null;
+  constructor(policy, callbacks) {
+    this.policy = policy;
+    this.callbacks = callbacks;
+    if (this.shouldRegisterUnload()) {
+      this.boundVisibility = this.handleVisibility.bind(this);
+      this.boundUnload = this.handleUnload.bind(this);
+    }
+  }
+  start() {
+    if (this.started) return;
+    this.started = true;
+    if (this.policy.mode === "interval") {
+      const ms = this.policy.intervalMs ?? 3e5;
+      this.intervalTimer = setInterval(() => {
+        void this.execFire();
+      }, ms);
+    }
+    if (this.boundVisibility && this.boundUnload) {
+      if (typeof document !== "undefined") {
+        document.addEventListener("visibilitychange", this.boundVisibility);
+      }
+      if (typeof globalThis.addEventListener === "function") {
+        globalThis.addEventListener("pagehide", this.boundUnload);
+      }
+      if (typeof process !== "undefined" && typeof process.on === "function") {
+        process.on("beforeExit", this.boundUnload);
+      }
+    }
+  }
+  stop() {
+    if (!this.started) return;
+    this.started = false;
+    if (this.debounceTimer) {
+      clearTimeout(this.debounceTimer);
+      this.debounceTimer = null;
+    }
+    if (this.intervalTimer) {
+      clearInterval(this.intervalTimer);
+      this.intervalTimer = null;
+    }
+    if (this.boundVisibility && this.boundUnload) {
+      if (typeof document !== "undefined") {
+        document.removeEventListener("visibilitychange", this.boundVisibility);
+      }
+      if (typeof globalThis.removeEventListener === "function") {
+        globalThis.removeEventListener("pagehide", this.boundUnload);
+      }
+      if (typeof process !== "undefined" && typeof process.removeListener === "function") {
+        process.removeListener("beforeExit", this.boundUnload);
+      }
+    }
+  }
+  notifyChange() {
+    if (!this.started) return;
+    if (this.policy.mode === "debounce") this.resetDebounce();
+  }
+  resetDebounce() {
+    if (this.debounceTimer) clearTimeout(this.debounceTimer);
+    const ms = this.policy.debounceMs ?? 3e4;
+    this.debounceTimer = setTimeout(() => {
+      this.debounceTimer = null;
+      void this.execFire();
+    }, ms);
+  }
+  async execFire() {
+    if (this.firing) return;
+    const minInterval = this.policy.minIntervalMs ?? 0;
+    if (minInterval > 0 && Date.now() - this.lastFireTime < minInterval) {
+      if (this.policy.mode === "debounce") this.resetDebounce();
+      return;
+    }
+    if (this.callbacks.pendingCount() === 0) return;
+    this.firing = true;
+    try {
+      await this.callbacks.fire();
+      this.lastFireTime = Date.now();
+    } catch {
+    } finally {
+      this.firing = false;
+    }
+  }
+  handleVisibility() {
+    if (typeof document !== "undefined" && document.visibilityState === "hidden") {
+      this.flush();
+    }
+  }
+  handleUnload() {
+    this.flush();
+  }
+  flush() {
+    if (this.callbacks.pendingCount() === 0) return;
+    void this.callbacks.fire().catch(() => {
+    });
+  }
+  shouldRegisterUnload() {
+    return this.policy.onUnload ?? this.policy.mode !== "manual";
   }
 };
 
@@ -20219,6 +20332,8 @@ var Noydb = class {
   sessionStrategy;
   syncStrategy;
   snapshotStrategy;
+  snapshotScheduler = null;
+  dirtySnapshotVaults = /* @__PURE__ */ new Set();
   /**
    * Currently-running multi-record transaction, set by
    * `runTransaction` at the start of Phase 2 (commit) and cleared in
@@ -20244,6 +20359,7 @@ var Noydb = class {
     this.sessionStrategy = options.sessionStrategy ?? NO_SESSION;
     this.syncStrategy = options.syncStrategy ?? NO_SYNC;
     this.snapshotStrategy = options.snapshotStrategy ?? NO_SNAPSHOTS;
+    this.initSnapshotCadence();
     this.publicEnvelopeSchema = resolveSchema(options.publicEnvelope);
     if (options.sessionPolicy) {
       this.sessionStrategy.validateSessionPolicy(options.sessionPolicy);
@@ -21200,6 +21316,8 @@ var Noydb = class {
   }
   close() {
     this.closed = true;
+    this.snapshotScheduler?.stop();
+    this.snapshotScheduler = null;
     if (this.sessionTimer) {
       clearTimeout(this.sessionTimer);
       this.sessionTimer = null;
@@ -22245,6 +22363,41 @@ var Noydb = class {
     }
     return this.snapshotStrategy.snapshot(v, this.options.user, opts);
   }
+  /**
+   * Wire the automatic-snapshot cadence when a non-manual `snapshotPolicy` is
+   * configured. Subscribes to `onAfterWrite` to mark the written vault dirty and
+   * nudge the scheduler; the scheduler fires `autoSnapshot()` per dirty vault.
+   * No-op for `mode:'manual'` or no policy.
+   */
+  initSnapshotCadence() {
+    const policy = this.snapshotStrategy.policy;
+    if (!policy || !policy.mode || policy.mode === "manual") return;
+    const scheduler = new SnapshotScheduler(policy, {
+      fire: async () => {
+        const names = [...this.dirtySnapshotVaults];
+        this.dirtySnapshotVaults.clear();
+        for (const name of names) {
+          const v = this.vaultCache.get(name);
+          if (!v) continue;
+          try {
+            await this.snapshotStrategy.autoSnapshot(v, this.options.user);
+          } catch (err) {
+            this.dirtySnapshotVaults.add(name);
+            console.warn(
+              `[noy-db] auto-snapshot failed for vault "${name}": ` + (err instanceof Error ? err.message : String(err))
+            );
+          }
+        }
+      },
+      pendingCount: () => this.dirtySnapshotVaults.size
+    });
+    this.onAfterWrite((event) => {
+      this.dirtySnapshotVaults.add(event.vault);
+      scheduler.notifyChange();
+    });
+    scheduler.start();
+    this.snapshotScheduler = scheduler;
+  }
   /**
    * List all snapshots for the given vault, newest first.
    * Reads only the sidecar index — does not download snapshot bytes.