@noy-db/hub 0.1.0-pre.9 → 0.2.0-pre.10

package/dist/{chunk-ACLDOTNQ.js → chunk-O6EJ6WTI.js}

@@ -26,6 +26,19 @@ var InvalidKeyError = class extends NoydbError {
     this.name = "InvalidKeyError";
   }
 };
+var KeyringCorruptError = class extends NoydbError {
+  failedCollections;
+  intactCount;
+  constructor(opts) {
+    super(
+      "KEYRING_CORRUPT",
+      opts.message ?? `Keyring has ${opts.failedCollections.length} corrupted wrapped DEK(s) (${opts.failedCollections.join(", ")}); ${opts.intactCount} other DEK(s) unwrapped successfully \u2014 the passphrase is correct, the entries are damaged. Do NOT use onInvalidKey: 'reset' here \u2014 that would destroy the intact DEKs.`
+    );
+    this.name = "KeyringCorruptError";
+    this.failedCollections = opts.failedCollections;
+    this.intactCount = opts.intactCount;
+  }
+};
 var NoAccessError = class extends NoydbError {
   constructor(message = "No access \u2014 user does not have a key for this collection") {
     super("NO_ACCESS", message);
@@ -139,6 +152,66 @@ var PeriodClosedError = class extends NoydbError {
     this.recordTs = recordTs;
   }
 };
+var RecordLockedError = class extends NoydbError {
+  collection;
+  id;
+  reason;
+  constructor(collection, id, reason) {
+    super(
+      "RECORD_LOCKED",
+      `Cannot modify ${collection}/${id} \u2014 locked by guard: ${reason}. Use withTransactions({ amendment: true, reason }) with admin/owner role to override.`
+    );
+    this.name = "RecordLockedError";
+    this.collection = collection;
+    this.id = id;
+    this.reason = reason;
+  }
+};
+var FieldFrozenError = class extends NoydbError {
+  collection;
+  id;
+  fields;
+  constructor(collection, id, fields) {
+    super(
+      "FIELD_FROZEN",
+      `Cannot change frozen field(s) on ${collection}/${id}: ${fields.join(", ")}. Use withTransactions({ amendment: true, reason }) with admin/owner role to override.`
+    );
+    this.name = "FieldFrozenError";
+    this.collection = collection;
+    this.id = id;
+    this.fields = fields;
+  }
+};
+var InvariantError = class extends NoydbError {
+  constructor(message) {
+    super("INVARIANT_VIOLATED", message);
+    this.name = "InvariantError";
+  }
+};
+var AmendmentForbiddenError = class extends NoydbError {
+  userId;
+  role;
+  constructor(userId, role) {
+    super(
+      "AMENDMENT_FORBIDDEN",
+      `User "${userId}" with role "${role}" cannot open an amendment transaction. Amendments require admin or owner role.`
+    );
+    this.name = "AmendmentForbiddenError";
+    this.userId = userId;
+    this.role = role;
+  }
+};
+var DirectoryDisabledError = class extends NoydbError {
+  vault;
+  constructor(vault) {
+    super(
+      "DIRECTORY_DISABLED",
+      `Vault "${vault}" has its user directory disabled. Only owners and admins can call listUsersWithEnvelopes() here. Use db.setDirectoryEnabled(vault, true) to re-enable.`
+    );
+    this.name = "DirectoryDisabledError";
+    this.vault = vault;
+  }
+};
 var TierNotGrantedError = class extends NoydbError {
   tier;
   collection;
@@ -253,6 +326,42 @@ var SchemaValidationError = class extends NoydbError {
     this.direction = direction;
   }
 };
+var SchemaUpdateError = class extends NoydbError {
+  constructor(code, message) {
+    super(code, message);
+    this.name = "SchemaUpdateError";
+  }
+};
+var NonAdditiveSchemaChangeError = class extends SchemaUpdateError {
+  constructor(message) {
+    super("NON_ADDITIVE_SCHEMA_CHANGE", message);
+    this.name = "NonAdditiveSchemaChangeError";
+  }
+};
+var SchemaLockedError = class extends SchemaUpdateError {
+  constructor(message) {
+    super("SCHEMA_LOCKED", message);
+    this.name = "SchemaLockedError";
+  }
+};
+var SchemaFenceError = class extends SchemaUpdateError {
+  constructor(message) {
+    super("SCHEMA_FENCE", message);
+    this.name = "SchemaFenceError";
+  }
+};
+var MigrationRequiredError = class extends SchemaUpdateError {
+  constructor(message) {
+    super("MIGRATION_REQUIRED", message);
+    this.name = "MigrationRequiredError";
+  }
+};
+var QuiesceTimeoutError = class extends SchemaUpdateError {
+  constructor(message) {
+    super("QUIESCE_TIMEOUT", message);
+    this.name = "QuiesceTimeoutError";
+  }
+};
 var GroupCardinalityError = class extends NoydbError {
   /** The field being grouped on. */
   field;
@@ -286,6 +395,31 @@ var IndexRequiredError = class extends NoydbError {
     this.missingFields = [...args.missingFields];
   }
 };
+var UniqueConstraintError = class extends NoydbError {
+  collection;
+  recordId;
+  fields;
+  conflictingId;
+  constructor(collection, recordId, fields, conflictingId) {
+    super(
+      "UNIQUE_CONSTRAINT",
+      `Unique constraint on ${collection}.[${fields.join(", ")}] violated: record "${recordId}" duplicates a value already held by "${conflictingId}".`
+    );
+    this.name = "UniqueConstraintError";
+    this.collection = collection;
+    this.recordId = recordId;
+    this.fields = fields;
+    this.conflictingId = conflictingId;
+  }
+};
+var UnsupportedIndexOptionError = class extends NoydbError {
+  option;
+  constructor(option, message) {
+    super("UNSUPPORTED_INDEX_OPTION", message);
+    this.name = "UnsupportedIndexOptionError";
+    this.option = option;
+  }
+};
 var IndexWriteFailureError = class extends NoydbError {
   recordId;
   field;
@@ -309,6 +443,26 @@ var BundleIntegrityError = class extends NoydbError {
     this.name = "BundleIntegrityError";
   }
 };
+var BundleSealMismatchError = class extends NoydbError {
+  userId;
+  pid;
+  constructor(userId, pid) {
+    super(
+      "BUNDLE_SEAL_MISMATCH",
+      `bundle carries sealed passphrase for user "${userId}" under provider "${pid}", but no registered provider matches that pid.
+
+Resolutions:
+  1. Configure a provider matching the pid and retry import.
+  2. Pass \`attemptUnsealAcrossProviders: true\` to try each registered
+     provider regardless of pid (extra credential prompts may surface).
+  3. Inspect the bundle without unsealing \u2014 pass no \`sealingProviders\`
+     to receive the sealed entries unmodified for offline analysis.`
+    );
+    this.name = "BundleSealMismatchError";
+    this.userId = userId;
+    this.pid = pid;
+  }
+};
 var ReservedCollectionNameError = class extends NoydbError {
   /** The rejected collection name. */
   collectionName;
@@ -384,6 +538,27 @@ var LocaleNotSpecifiedError = class extends NoydbError {
     this.field = field;
   }
 };
+var ScriptViolationError = class extends NoydbError {
+  /** The field whose value violated its script constraint. */
+  field;
+  /** The locale slot (e.g. `'en'`) that was checked. */
+  locale;
+  /** The Unicode scripts allowed for this slot. */
+  expected;
+  /** A short sample of the offending characters, for diagnostics. */
+  sample;
+  constructor(field, locale, expected, sample, message) {
+    super(
+      "SCRIPT_VIOLATION",
+      message ?? `Field "${field}" slot "${locale}" expects script(s) [${expected.join(", ")}] but contains disallowed character(s): "${sample}".`
+    );
+    this.name = "ScriptViolationError";
+    this.field = field;
+    this.locale = locale;
+    this.expected = expected;
+    this.sample = sample;
+  }
+};
 var TranslatorNotConfiguredError = class extends NoydbError {
   /** The field that requested auto-translation. */
   field;
@@ -419,6 +594,30 @@ var BackupCorruptedError = class extends NoydbError {
     this.id = id;
   }
 };
+var PartitionExtractionError = class extends NoydbError {
+  constructor(message) {
+    super("PARTITION_EXTRACTION", message);
+    this.name = "PartitionExtractionError";
+  }
+};
+var TransferSealError = class extends NoydbError {
+  constructor(message) {
+    super("TRANSFER_SEAL", message);
+    this.name = "TransferSealError";
+  }
+};
+var AdoptionStateError = class extends NoydbError {
+  constructor(message) {
+    super("ADOPTION_STATE", message);
+    this.name = "AdoptionStateError";
+  }
+};
+var AttestationError = class extends NoydbError {
+  constructor(message) {
+    super("ATTESTATION", message);
+    this.name = "AttestationError";
+  }
+};
 var SessionExpiredError = class extends NoydbError {
   sessionId;
   constructor(sessionId) {
@@ -460,6 +659,34 @@ var JoinTooLargeError = class extends NoydbError {
     this.side = opts.side;
   }
 };
+var CrossJoinTooLargeError = class extends NoydbError {
+  target;
+  expected;
+  limit;
+  constructor(opts) {
+    super(
+      "CROSS_JOIN_TOO_LARGE",
+      `crossJoin("${opts.target}"): would produce ${opts.expected} rows, exceeding the limit of ${opts.limit}. Narrow the left side with .where() first, or raise the ceiling with crossJoin("${opts.target}", { ..., maxRows: ${opts.expected} }).`
+    );
+    this.name = "CrossJoinTooLargeError";
+    this.target = opts.target;
+    this.expected = opts.expected;
+    this.limit = opts.limit;
+  }
+};
+var CrossJoinSourceUnknownError = class extends NoydbError {
+  target;
+  leftCollection;
+  constructor(target, leftCollection) {
+    super(
+      "CROSS_JOIN_SOURCE_UNKNOWN",
+      `crossJoin("${target}"): collection "${target}" is not known in the vault (cross-joining from "${leftCollection}"). Make sure "${target}" is open in the same vault before executing this query.`
+    );
+    this.name = "CrossJoinSourceUnknownError";
+    this.target = target;
+    this.leftCollection = leftCollection;
+  }
+};
 var DanglingReferenceError = class extends NoydbError {
   field;
   target;
@@ -491,12 +718,183 @@ var PathEscapeError = class extends NoydbError {
     this.targetDir = opts.targetDir;
   }
 };
+var DerivationCycleError = class extends NoydbError {
+  path;
+  constructor(path) {
+    super(
+      "DERIVATION_CYCLE",
+      `Derivation graph contains a cycle: ${path.join(" \u2192 ")}. Refusing to open vault \u2014 break the cycle before retrying.`
+    );
+    this.name = "DerivationCycleError";
+    this.path = path;
+  }
+};
+var DerivationDepthError = class extends NoydbError {
+  limit;
+  attempted;
+  constructor(limit, attempted) {
+    super(
+      "DERIVATION_DEPTH",
+      `Derivation cascade exceeded max depth ${limit} (attempted ${attempted}). Pass lifecycle: { maxDepth: N } to raise the limit if intentional.`
+    );
+    this.name = "DerivationDepthError";
+    this.limit = limit;
+    this.attempted = attempted;
+  }
+};
+var DerivationOutputUnknownError = class extends NoydbError {
+  collection;
+  constructor(collection) {
+    super(
+      "DERIVATION_OUTPUT_UNKNOWN",
+      `Derivation output collection "${collection}" is not declared on the vault. Register the collection (e.g. via schema) before registering a derivation that writes to it.`
+    );
+    this.name = "DerivationOutputUnknownError";
+    this.collection = collection;
+  }
+};
+var DerivationOutputShapeError = class extends NoydbError {
+  outputKey;
+  constructor(outputKey, detail) {
+    super(
+      "DERIVATION_OUTPUT_SHAPE",
+      `Derivation output "${outputKey}" has invalid shape: ${detail}.`
+    );
+    this.name = "DerivationOutputShapeError";
+    this.outputKey = outputKey;
+  }
+};
+var DerivationCapExceededError = class extends NoydbError {
+  outputKey;
+  returned;
+  maxFanout;
+  constructor(outputKey, returned, maxFanout) {
+    super(
+      "DERIVATION_CAP_EXCEEDED",
+      `Derivation array output "${outputKey}" returned ${returned} rows, exceeding maxFanout=${maxFanout}. Raise \`maxFanout\` on the OutputSpec if this fanout is intended (the cap exists to keep dispatch cost bounded).`
+    );
+    this.name = "DerivationCapExceededError";
+    this.outputKey = outputKey;
+    this.returned = returned;
+    this.maxFanout = maxFanout;
+  }
+};
+var MaterializedViewCycleError = class extends NoydbError {
+  path;
+  constructor(path) {
+    super(
+      "MATERIALIZED_VIEW_CYCLE",
+      `Materialized-view graph contains a cycle: ${path.join(" \u2192 ")}. Refusing to open vault \u2014 break the cycle before retrying.`
+    );
+    this.name = "MaterializedViewCycleError";
+    this.path = path;
+  }
+};
+var MaterializedViewSourceUnknownError = class extends NoydbError {
+  mvName;
+  collection;
+  constructor(mvName, collection) {
+    super(
+      "MATERIALIZED_VIEW_SOURCE_UNKNOWN",
+      `Materialized view "${mvName}" references unknown source collection "${collection}". Declare the collection (e.g. via schema or by writing to it once) before registering the MV.`
+    );
+    this.name = "MaterializedViewSourceUnknownError";
+    this.mvName = mvName;
+    this.collection = collection;
+  }
+};
+var MaterializedViewTooLargeError = class extends NoydbError {
+  mvName;
+  expected;
+  limit;
+  constructor(mvName, expected, limit) {
+    super(
+      "MATERIALIZED_VIEW_TOO_LARGE",
+      `Materialized view "${mvName}" would emit ${expected} rows, exceeding the configured limit of ${limit}. Override via { maxRows: N } on the MV strategy if intentional, or tighten the query's filter/groupBy.`
+    );
+    this.name = "MaterializedViewTooLargeError";
+    this.mvName = mvName;
+    this.expected = expected;
+    this.limit = limit;
+  }
+};
+var MaterializedViewConfigError = class extends NoydbError {
+  constructor(message) {
+    super(
+      "MATERIALIZED_VIEW_CONFIG",
+      `[noy-db] withMaterializedView: ${message}`
+    );
+    this.name = "MaterializedViewConfigError";
+  }
+};
+var OverlayBaseIsVirtualError = class extends NoydbError {
+  overlayName;
+  base;
+  constructor(overlayName, base) {
+    super(
+      "OVERLAY_BASE_IS_VIRTUAL",
+      `withOverlayedView "${overlayName}": base "${base}" is another overlay's virtual name. Multi-overlay stacking is a v3 feature; base must reference a concrete collection (a real source or an MV output).`
+    );
+    this.name = "OverlayBaseIsVirtualError";
+    this.overlayName = overlayName;
+    this.base = base;
+  }
+};
+var OverlayCollectionUnavailableError = class extends NoydbError {
+  overlayName;
+  overlay;
+  constructor(overlayName, overlay) {
+    super(
+      "OVERLAY_COLLECTION_UNAVAILABLE",
+      `withOverlayedView "${overlayName}": overlay collection "${overlay}" is unavailable. It must be a real vault-known collection that is NOT itself an MV output collection.`
+    );
+    this.name = "OverlayCollectionUnavailableError";
+    this.overlayName = overlayName;
+    this.overlay = overlay;
+  }
+};
+var OverlayNameCollisionError = class extends NoydbError {
+  overlayName;
+  constructor(overlayName) {
+    super(
+      "OVERLAY_NAME_COLLISION",
+      `withOverlayedView "${overlayName}": virtual name collides with an MV output or a concrete source collection. Pick a unique name for the virtual collection.`
+    );
+    this.name = "OverlayNameCollisionError";
+    this.overlayName = overlayName;
+  }
+};
+var OverlayIdMismatchError = class extends NoydbError {
+  actual;
+  expected;
+  constructor(actual, expected) {
+    super(
+      "OVERLAY_ID_MISMATCH",
+      `Overlay put(id, record): id "${actual}" does not match the base MV's rowKey(record) \u2192 "${expected}". Pass the row directly via .put(record) to derive the id, or fix the id to match the base MV's rowKey output.`
+    );
+    this.name = "OverlayIdMismatchError";
+    this.actual = actual;
+    this.expected = expected;
+  }
+};
+var SnapshotNotFoundError = class extends NoydbError {
+  version;
+  constructor(version) {
+    super(
+      "SNAPSHOT_NOT_FOUND",
+      `Snapshot not found: "${version}" does not exist in the snapshot store. It may have been pruned by the retention policy or deleted manually.`
+    );
+    this.name = "SnapshotNotFoundError";
+    this.version = version;
+  }
+};
 
 export {
   NoydbError,
   DecryptionError,
   TamperedError,
   InvalidKeyError,
+  KeyringCorruptError,
   NoAccessError,
   ReadOnlyError,
   ReadOnlyAtInstantError,
@@ -508,6 +906,11 @@ export {
   StoreCapabilityError,
   PrivilegeEscalationError,
   PeriodClosedError,
+  RecordLockedError,
+  FieldFrozenError,
+  InvariantError,
+  AmendmentForbiddenError,
+  DirectoryDisabledError,
   TierNotGrantedError,
   ElevationExpiredError,
   AlreadyElevatedError,
@@ -520,24 +923,54 @@ export {
   NotFoundError,
   ValidationError,
   SchemaValidationError,
+  SchemaUpdateError,
+  NonAdditiveSchemaChangeError,
+  SchemaLockedError,
+  SchemaFenceError,
+  MigrationRequiredError,
+  QuiesceTimeoutError,
   GroupCardinalityError,
   IndexRequiredError,
+  UniqueConstraintError,
+  UnsupportedIndexOptionError,
   IndexWriteFailureError,
   BundleIntegrityError,
+  BundleSealMismatchError,
   ReservedCollectionNameError,
   DictKeyMissingError,
   DictKeyInUseError,
   MissingTranslationError,
   LocaleNotSpecifiedError,
+  ScriptViolationError,
   TranslatorNotConfiguredError,
   BackupLedgerError,
   BackupCorruptedError,
+  PartitionExtractionError,
+  TransferSealError,
+  AdoptionStateError,
+  AttestationError,
   SessionExpiredError,
   SessionNotFoundError,
   SessionPolicyError,
   JoinTooLargeError,
+  CrossJoinTooLargeError,
+  CrossJoinSourceUnknownError,
   DanglingReferenceError,
   FilenameSanitizationError,
-  PathEscapeError
-};
-//# sourceMappingURL=chunk-ACLDOTNQ.js.map
+  PathEscapeError,
+  DerivationCycleError,
+  DerivationDepthError,
+  DerivationOutputUnknownError,
+  DerivationOutputShapeError,
+  DerivationCapExceededError,
+  MaterializedViewCycleError,
+  MaterializedViewSourceUnknownError,
+  MaterializedViewTooLargeError,
+  MaterializedViewConfigError,
+  OverlayBaseIsVirtualError,
+  OverlayCollectionUnavailableError,
+  OverlayNameCollisionError,
+  OverlayIdMismatchError,
+  SnapshotNotFoundError
+};
+//# sourceMappingURL=chunk-O6EJ6WTI.js.map