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

package/dist/blobs/index.d.cts

@@ -1,11 +1,11 @@
-import { B as BlobStrategy } from '../types-r-y7TIqj.cjs';
-export { q as BLOB_CHUNKS_COLLECTION, t as BLOB_COLLECTION, u as BLOB_EVICTION_AUDIT_COLLECTION, w as BLOB_INDEX_COLLECTION, x as BLOB_SLOTS_PREFIX, y as BLOB_VERSIONS_PREFIX, z as BlobEvictionEntry, A as BlobFieldPolicy, C as BlobFieldsConfig, E as BlobObject, F as BlobPutOptions, G as BlobResponseOptions, H as BlobSet, J as BlobStrategyOpenArgs, K as CompactRunOptions, L as CompactionContext, M as CompactionResult, N as DEFAULT_CHUNK_SIZE, O as EXPORT_AUDIT_COLLECTION, Q as ExportBlobsAbortedError, R as ExportBlobsAuditEntry, T as ExportBlobsHandle, U as ExportBlobsOptions, V as ExportedBlob, W as SlotInfo, X as SlotRecord, Y as VersionRecord, Z as createExportBlobsHandle, _ as runCompaction } from '../types-r-y7TIqj.cjs';
+import { B as BlobStrategy } from '../types-DyXYr8rE.cjs';
+export { z as BLOB_CHUNKS_COLLECTION, A as BLOB_COLLECTION, C as BLOB_EVICTION_AUDIT_COLLECTION, E as BLOB_INDEX_COLLECTION, F as BLOB_SLOTS_PREFIX, G as BLOB_VERSIONS_PREFIX, H as BlobEvictionEntry, J as BlobFieldPolicy, K as BlobFieldsConfig, M as BlobObject, N as BlobPutOptions, Q as BlobResponseOptions, T as BlobSet, U as BlobStrategyOpenArgs, V as CompactRunOptions, W as CompactionContext, X as CompactionResult, Y as DEFAULT_CHUNK_SIZE, Z as EXPORT_AUDIT_COLLECTION, _ as ExportBlobsAbortedError, $ as ExportBlobsAuditEntry, a0 as ExportBlobsHandle, a1 as ExportBlobsOptions, a2 as ExportedBlob, a3 as SlotInfo, a4 as SlotRecord, a5 as VersionRecord, a6 as createExportBlobsHandle, a7 as runCompaction } from '../types-DyXYr8rE.cjs';
 export { d as detectMagic, a as detectMimeType, i as isPreCompressed } from '../mime-magic-CBBSOkjm.cjs';
 import '../lazy-builder-wY4pMCEe.cjs';
 import '../predicate-BSAGEyu5.cjs';
 import '../strategy-DSTrsZ8t.cjs';
 import '../strategy-BSxFXGzb.cjs';
-import '../index-vB43MAt4.cjs';
+import '../index-4fBVt8j9.cjs';
 import '@noy-db/attestation';
 
 /**

package/dist/blobs/index.d.ts

@@ -1,11 +1,11 @@
-import { B as BlobStrategy } from '../types-DT7cXRHq.js';
-export { q as BLOB_CHUNKS_COLLECTION, t as BLOB_COLLECTION, u as BLOB_EVICTION_AUDIT_COLLECTION, w as BLOB_INDEX_COLLECTION, x as BLOB_SLOTS_PREFIX, y as BLOB_VERSIONS_PREFIX, z as BlobEvictionEntry, A as BlobFieldPolicy, C as BlobFieldsConfig, E as BlobObject, F as BlobPutOptions, G as BlobResponseOptions, H as BlobSet, J as BlobStrategyOpenArgs, K as CompactRunOptions, L as CompactionContext, M as CompactionResult, N as DEFAULT_CHUNK_SIZE, O as EXPORT_AUDIT_COLLECTION, Q as ExportBlobsAbortedError, R as ExportBlobsAuditEntry, T as ExportBlobsHandle, U as ExportBlobsOptions, V as ExportedBlob, W as SlotInfo, X as SlotRecord, Y as VersionRecord, Z as createExportBlobsHandle, _ as runCompaction } from '../types-DT7cXRHq.js';
+import { B as BlobStrategy } from '../types-Df28QFKb.js';
+export { z as BLOB_CHUNKS_COLLECTION, A as BLOB_COLLECTION, C as BLOB_EVICTION_AUDIT_COLLECTION, E as BLOB_INDEX_COLLECTION, F as BLOB_SLOTS_PREFIX, G as BLOB_VERSIONS_PREFIX, H as BlobEvictionEntry, J as BlobFieldPolicy, K as BlobFieldsConfig, M as BlobObject, N as BlobPutOptions, Q as BlobResponseOptions, T as BlobSet, U as BlobStrategyOpenArgs, V as CompactRunOptions, W as CompactionContext, X as CompactionResult, Y as DEFAULT_CHUNK_SIZE, Z as EXPORT_AUDIT_COLLECTION, _ as ExportBlobsAbortedError, $ as ExportBlobsAuditEntry, a0 as ExportBlobsHandle, a1 as ExportBlobsOptions, a2 as ExportedBlob, a3 as SlotInfo, a4 as SlotRecord, a5 as VersionRecord, a6 as createExportBlobsHandle, a7 as runCompaction } from '../types-Df28QFKb.js';
 export { d as detectMagic, a as detectMimeType, i as isPreCompressed } from '../mime-magic-CBBSOkjm.js';
 import '../lazy-builder-7tIpFyWN.js';
 import '../predicate-BSAGEyu5.js';
 import '../strategy-DSTrsZ8t.js';
 import '../strategy-BSxFXGzb.js';
-import '../index-CmWQyC4e.js';
+import '../index-D8I_pyJD.js';
 import '@noy-db/attestation';
 
 /**

package/dist/blobs/index.js

@@ -9,17 +9,17 @@ import {
   detectMagic,
   detectMimeType,
   isPreCompressed
-} from "../chunk-4YVVF6JN.js";
+} from "../chunk-QODLLGQ7.js";
 import {
   BLOB_EVICTION_AUDIT_COLLECTION,
   EXPORT_AUDIT_COLLECTION,
   ExportBlobsAbortedError,
   createExportBlobsHandle,
   runCompaction
-} from "../chunk-WBUG3324.js";
+} from "../chunk-3BFJOWSU.js";
 import "../chunk-WIRRPTFH.js";
-import "../chunk-YAMTXW77.js";
-import "../chunk-REQJJIPP.js";
+import "../chunk-PP6W64Y3.js";
+import "../chunk-B6PB7JLN.js";
 
 // src/blobs/active.ts
 function withBlobs() {

package/dist/bundle/index.cjs

@@ -31,7 +31,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/errors.ts
-var NoydbError, DecryptionError, TamperedError, InvalidKeyError, KeyringCorruptError, NoAccessError, ReadOnlyError, PermissionDeniedError, ExportCapabilityError, KeyringExpiredError, ImportCapabilityError, StoreCapabilityError, PrivilegeEscalationError, FieldFrozenError, InvariantError, AmendmentForbiddenError, TierNotGrantedError, ElevationExpiredError, AlreadyElevatedError, TierDemoteDeniedError, DelegationTargetMissingError, ConflictError, LedgerContentionError, BundleVersionConflictError, ValidationError, SchemaValidationError, SchemaUpdateError, SchemaFenceError, MigrationRequiredError, QuiesceTimeoutError, GroupCardinalityError, IndexRequiredError, IndexWriteFailureError, BundleIntegrityError, BundleSealMismatchError, ReservedCollectionNameError, TranslatorNotConfiguredError, BackupLedgerError, BackupCorruptedError, PartitionExtractionError, TransferSealError, AdoptionStateError, AttestationError, JoinTooLargeError, CrossJoinTooLargeError, CrossJoinSourceUnknownError, DanglingReferenceError, DerivationCycleError, DerivationOutputShapeError, DerivationCapExceededError, MaterializedViewCycleError, MaterializedViewSourceUnknownError, MaterializedViewTooLargeError, OverlayBaseIsVirtualError, OverlayCollectionUnavailableError, OverlayNameCollisionError, OverlayIdMismatchError;
+var NoydbError, DecryptionError, TamperedError, InvalidKeyError, KeyringCorruptError, NoAccessError, ReadOnlyError, PermissionDeniedError, ExportCapabilityError, KeyringExpiredError, ImportCapabilityError, StoreCapabilityError, PrivilegeEscalationError, FieldFrozenError, InvariantError, AmendmentForbiddenError, TierNotGrantedError, ElevationExpiredError, AlreadyElevatedError, TierDemoteDeniedError, DelegationTargetMissingError, ConflictError, LedgerContentionError, BundleVersionConflictError, ValidationError, SchemaValidationError, SchemaUpdateError, SchemaFenceError, MigrationRequiredError, QuiesceTimeoutError, GroupCardinalityError, IndexRequiredError, IndexWriteFailureError, BundleIntegrityError, BundleSealMismatchError, ReservedCollectionNameError, LocaleNotSpecifiedError, TranslatorNotConfiguredError, BackupLedgerError, BackupCorruptedError, PartitionExtractionError, TransferSealError, AdoptionStateError, AttestationError, JoinTooLargeError, CrossJoinTooLargeError, CrossJoinSourceUnknownError, DanglingReferenceError, DerivationCycleError, DerivationOutputShapeError, DerivationCapExceededError, MaterializedViewCycleError, MaterializedViewSourceUnknownError, MaterializedViewTooLargeError, OverlayBaseIsVirtualError, OverlayCollectionUnavailableError, OverlayNameCollisionError, OverlayIdMismatchError;
 var init_errors = __esm({
   "src/errors.ts"() {
     "use strict";
@@ -403,6 +403,18 @@ Resolutions:
         this.collectionName = collectionName;
       }
     };
+    LocaleNotSpecifiedError = class extends NoydbError {
+      /** The field name that required a locale. */
+      field;
+      constructor(field, message) {
+        super(
+          "LOCALE_NOT_SPECIFIED",
+          message ?? `Cannot read i18nText field "${field}" without a locale. Pass { locale } to get()/list()/query() or set a default via openVault(name, { locale }).`
+        );
+        this.name = "LocaleNotSpecifiedError";
+        this.field = field;
+      }
+    };
     TranslatorNotConfiguredError = class extends NoydbError {
       /** The field that requested auto-translation. */
       field;
@@ -3499,6 +3511,19 @@ var init_strategy = __esm({
   }
 });
 
+// src/i18n/policy.ts
+function resolvePolicy(onMissing, layer) {
+  const explicit = onMissing && typeof onMissing === "object" ? onMissing[layer] : void 0;
+  const scalar = typeof onMissing === "string" ? onMissing : void 0;
+  const layerDefault = layer === "guard" ? "substitute" : void 0;
+  return explicit ?? layerDefault ?? scalar ?? "throw";
+}
+var init_policy = __esm({
+  "src/i18n/policy.ts"() {
+    "use strict";
+  }
+});
+
 // src/i18n/core.ts
 function getAtPath(obj, path) {
   const arrayIdx = path.indexOf("[].");
@@ -3558,6 +3583,9 @@ var init_strategy2 = __esm({
       validateI18nTextValue() {
         throw notEnabled("i18nText field validation");
       },
+      enforceScript(value) {
+        return { value, warnings: [] };
+      },
       buildDictionaryHandle() {
         throw notEnabled("vault.dictionary()");
       }
@@ -5790,7 +5818,7 @@ function estimateRecordBytes(record) {
   }
 }
 var UNITS;
-var init_policy = __esm({
+var init_policy2 = __esm({
   "src/cache/policy.ts"() {
     "use strict";
     UNITS = {
@@ -5809,7 +5837,7 @@ var init_cache = __esm({
   "src/cache/index.ts"() {
     "use strict";
     init_lru();
-    init_policy();
+    init_policy2();
   }
 });
 
@@ -6833,6 +6861,7 @@ var init_collection = __esm({
     init_strategy();
     init_core();
     init_strategy2();
+    init_policy();
     init_crypto();
     init_errors();
     init_tiers();
@@ -7472,6 +7501,22 @@ var init_collection = __esm({
             setAtPathInPlace(obj, field, translated);
           }
         }
+        if (this.i18nFields) {
+          const obj = record;
+          for (const [field, descriptor] of Object.entries(this.i18nFields)) {
+            if (!descriptor.options.script) continue;
+            for (const leaf of getAtPath(obj, field)) {
+              if (!leaf || typeof leaf !== "object" || Array.isArray(leaf)) continue;
+              const leafMap = leaf;
+              const { value: cleaned } = this.i18nStrategy.enforceScript(
+                leafMap,
+                field,
+                descriptor
+              );
+              if (cleaned !== leafMap) Object.assign(leafMap, cleaned);
+            }
+          }
+        }
         if (this.i18nPutValidator !== void 0) {
           this.i18nPutValidator(record);
         }
@@ -8914,17 +8959,52 @@ var init_collection = __esm({
         }
         if (hasDict && this.dictKeyFields && this.dictLabelResolver && locale !== "raw") {
           const withLabels = { ...result };
+          const resolver = this.dictLabelResolver;
           for (const [field, desc] of Object.entries(this.dictKeyFields)) {
-            const key = result[field];
-            if (typeof key !== "string") continue;
-            const label = await this.dictLabelResolver(
-              desc.name,
-              key,
-              locale,
-              localeOpts?.fallback
-            );
-            if (label !== void 0) {
-              withLabels[`${field}Label`] = label;
+            const policy = desc.onMissing ? resolvePolicy(desc.onMissing, "read") : "null";
+            const fallback = policy === "substitute" ? localeOpts?.fallback ?? desc.substitute : localeOpts?.fallback;
+            const resolveKey = async (key) => {
+              const label = await resolver(desc.name, key, locale, fallback);
+              if (label === void 0) {
+                if (policy === "throw") {
+                  throw new LocaleNotSpecifiedError(
+                    field,
+                    `dictKey "${field}": no label for key "${key}" in locale "${locale}".`
+                  );
+                }
+                return null;
+              }
+              return label;
+            };
+            if (field.includes("[].")) {
+              const parts = field.split("[].");
+              const arrayKey = parts[0];
+              const leaf = parts[1];
+              if (!leaf || leaf.includes(".")) continue;
+              const arr = withLabels[arrayKey];
+              if (!Array.isArray(arr)) continue;
+              const labelKey = `${leaf}Label`;
+              withLabels[arrayKey] = await Promise.all(
+                arr.map(async (el) => {
+                  if (!el || typeof el !== "object" || Array.isArray(el)) return el;
+                  const k = el[leaf];
+                  if (typeof k !== "string") return el;
+                  return { ...el, [labelKey]: await resolveKey(k) };
+                })
+              );
+              continue;
+            }
+            const val = result[field];
+            if (Array.isArray(val)) {
+              withLabels[`${field}Label`] = await Promise.all(
+                val.map(async (k) => ({
+                  key: k,
+                  label: typeof k === "string" ? await resolveKey(k) : null
+                }))
+              );
+            } else if (typeof val === "string") {
+              const label = await resolveKey(val);
+              if (label !== null) withLabels[`${field}Label`] = label;
             }
           }
           result = withLabels;
@@ -15096,6 +15176,125 @@ var init_strategy10 = __esm({
       },
       async restoreSnapshot() {
         throw NOT_ENABLED5;
+      },
+      async autoSnapshot() {
+        throw NOT_ENABLED5;
+      }
+    };
+  }
+});
+
+// src/snapshots/scheduler.ts
+var SnapshotScheduler;
+var init_scheduler = __esm({
+  "src/snapshots/scheduler.ts"() {
+    "use strict";
+    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";
       }
     };
   }
@@ -15412,7 +15611,7 @@ var init_engine = __esm({
 });
 
 // src/policy/index.ts
-var init_policy2 = __esm({
+var init_policy3 = __esm({
   "src/policy/index.ts"() {
     "use strict";
     init_presets();
@@ -15576,11 +15775,12 @@ var init_noydb = __esm({
     init_unlock_state();
     init_sync_strategy();
     init_strategy10();
+    init_scheduler();
     init_transaction();
     init_strategy11();
     init_sync_policy();
     init_strategy12();
-    init_policy2();
+    init_policy3();
     ROLE_RANK = {
       client: 1,
       viewer: 2,
@@ -15637,6 +15837,8 @@ var init_noydb = __esm({
       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
@@ -15662,6 +15864,7 @@ var init_noydb = __esm({
         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);
@@ -16618,6 +16821,8 @@ var init_noydb = __esm({
       }
       close() {
         this.closed = true;
+        this.snapshotScheduler?.stop();
+        this.snapshotScheduler = null;
         if (this.sessionTimer) {
           clearTimeout(this.sessionTimer);
           this.sessionTimer = null;
@@ -17663,6 +17868,41 @@ var init_noydb = __esm({
         }
         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.