@noy-db/hub 0.1.0-pre.3 → 0.1.0-pre.5

package/dist/index.cjs

@@ -811,6 +811,158 @@ var init_crypto = __esm({
   }
 });
 
+// src/meta/public-envelope/schema.ts
+function validatePublicEnvelopeInput(input, schema) {
+  const allowed = new Set(schema.fields);
+  for (const key of Object.keys(input)) {
+    const known = key === "name" || key === "description" || key === "icon" || key === "defaultLocale" ? key : void 0;
+    if (!known) {
+      throw new ValidationError(
+        `setPublicEnvelope: unknown field "${key}". Allowed fields: ${[...allowed].join(", ")}.`
+      );
+    }
+    if (!allowed.has(known)) {
+      throw new ValidationError(
+        `setPublicEnvelope: field "${known}" is not enabled in this vault's schema. Allowed fields: ${[...allowed].join(", ")}.`
+      );
+    }
+  }
+  if (input.name !== void 0) {
+    validateText(input.name, "name", schema.maxStringChars);
+  }
+  if (input.description !== void 0) {
+    validateText(input.description, "description", schema.maxStringChars);
+  }
+  if (input.icon !== void 0) {
+    validateIcon(input.icon, schema);
+  }
+  if (input.defaultLocale !== void 0 && typeof input.defaultLocale !== "string") {
+    throw new ValidationError(
+      `setPublicEnvelope: defaultLocale must be a string (BCP-47), got ${typeof input.defaultLocale}.`
+    );
+  }
+}
+function validateText(value, field, maxChars) {
+  if (typeof value === "string") {
+    if (value.length > maxChars) {
+      throw new ValidationError(
+        `setPublicEnvelope: ${field} exceeds the ${maxChars}-character cap (got ${value.length}).`
+      );
+    }
+    return;
+  }
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    throw new ValidationError(
+      `setPublicEnvelope: ${field} must be a string or { [locale]: string } map, got ${typeof value}.`
+    );
+  }
+  for (const [locale, str] of Object.entries(value)) {
+    if (typeof str !== "string") {
+      throw new ValidationError(
+        `setPublicEnvelope: ${field}[${locale}] must be a string, got ${typeof str}.`
+      );
+    }
+    if (str.length > maxChars) {
+      throw new ValidationError(
+        `setPublicEnvelope: ${field}[${locale}] exceeds the ${maxChars}-character cap (got ${str.length}).`
+      );
+    }
+  }
+}
+function validateIcon(icon, schema) {
+  if (typeof icon !== "string") {
+    throw new ValidationError(
+      `setPublicEnvelope: icon must be a data: URL string, got ${typeof icon}.`
+    );
+  }
+  if (icon.length > schema.maxIconBytes) {
+    throw new ValidationError(
+      `setPublicEnvelope: icon exceeds the ${schema.maxIconBytes}-byte cap (got ${icon.length}).`
+    );
+  }
+  const m = DATA_URL_PREFIX.exec(icon);
+  if (!m) {
+    throw new ValidationError(
+      "setPublicEnvelope: icon must be a base64 data URL (`data:image/png;base64,\u2026` or `data:image/svg+xml;base64,\u2026`). External URLs are not supported in v1."
+    );
+  }
+  const mime = m[1];
+  if (!schema.iconMimeTypes.includes(mime)) {
+    throw new ValidationError(
+      `setPublicEnvelope: icon MIME type "${mime}" is not allowed. Permitted types: ${schema.iconMimeTypes.join(", ")}.`
+    );
+  }
+}
+function isPublicEnvelope(x) {
+  if (x === null || typeof x !== "object" || Array.isArray(x)) return false;
+  const obj = x;
+  return obj["_noydb_public"] === 1 && typeof obj["version"] === "number";
+}
+var DATA_URL_PREFIX;
+var init_schema = __esm({
+  "src/meta/public-envelope/schema.ts"() {
+    "use strict";
+    init_errors();
+    DATA_URL_PREFIX = /^data:([a-zA-Z0-9.+-]+\/[a-zA-Z0-9.+-]+);base64,/;
+  }
+});
+
+// src/meta/public-envelope/storage.ts
+async function loadPublicEnvelope(store, vault) {
+  const envelope = await store.get(vault, "_meta", PUBLIC_ENVELOPE_RECORD_ID);
+  if (!envelope) return void 0;
+  try {
+    const parsed = JSON.parse(envelope._data);
+    if (!isPublicEnvelope(parsed)) return void 0;
+    return parsed;
+  } catch {
+    return void 0;
+  }
+}
+async function savePublicEnvelope(store, vault, envelope) {
+  const wireEnvelope = {
+    _noydb: NOYDB_FORMAT_VERSION,
+    _v: 1,
+    _ts: (/* @__PURE__ */ new Date()).toISOString(),
+    _iv: "",
+    _data: JSON.stringify(envelope)
+  };
+  await store.put(vault, "_meta", PUBLIC_ENVELOPE_RECORD_ID, wireEnvelope);
+}
+async function readPublicEnvelope(store, vault, opts = {}) {
+  const raw = await loadPublicEnvelope(store, vault);
+  if (!raw) return void 0;
+  if (opts.locale === void 0) return raw;
+  return resolveLocale(raw, opts.locale);
+}
+function resolveLocale(envelope, locale) {
+  return {
+    ...envelope,
+    ...envelope.name !== void 0 ? { name: pickLocale(envelope.name, locale, envelope.defaultLocale) } : {},
+    ...envelope.description !== void 0 ? { description: pickLocale(envelope.description, locale, envelope.defaultLocale) } : {}
+  };
+}
+function pickLocale(value, locale, defaultLocale) {
+  if (typeof value === "string") return value;
+  if (value[locale] !== void 0 && value[locale] !== "") return value[locale];
+  if (defaultLocale && value[defaultLocale] !== void 0 && value[defaultLocale] !== "") {
+    return value[defaultLocale];
+  }
+  for (const v of Object.values(value)) {
+    if (v !== "") return v;
+  }
+  return "";
+}
+var PUBLIC_ENVELOPE_RECORD_ID;
+var init_storage = __esm({
+  "src/meta/public-envelope/storage.ts"() {
+    "use strict";
+    init_types();
+    init_schema();
+    PUBLIC_ENVELOPE_RECORD_ID = "public-envelope";
+  }
+});
+
 // src/bundle/ulid.ts
 var ulid_exports = {};
 __export(ulid_exports, {
@@ -1611,6 +1763,69 @@ var init_ledger = __esm({
   }
 });
 
+// src/meta/public-envelope/types.ts
+function resolveSchema(schema) {
+  if (!schema) return void 0;
+  if (schema === true) {
+    return {
+      fields: DEFAULT_PUBLIC_ENVELOPE_SCHEMA.fields,
+      maxIconBytes: DEFAULT_PUBLIC_ENVELOPE_SCHEMA.maxIconBytes,
+      iconMimeTypes: DEFAULT_PUBLIC_ENVELOPE_SCHEMA.iconMimeTypes,
+      maxStringChars: DEFAULT_PUBLIC_ENVELOPE_SCHEMA.maxStringChars
+    };
+  }
+  return {
+    fields: schema.fields ?? DEFAULT_PUBLIC_ENVELOPE_SCHEMA.fields,
+    maxIconBytes: schema.maxIconBytes ?? DEFAULT_PUBLIC_ENVELOPE_SCHEMA.maxIconBytes,
+    iconMimeTypes: schema.iconMimeTypes ?? DEFAULT_PUBLIC_ENVELOPE_SCHEMA.iconMimeTypes,
+    maxStringChars: schema.maxStringChars ?? DEFAULT_PUBLIC_ENVELOPE_SCHEMA.maxStringChars
+  };
+}
+var PUBLIC_ENVELOPE_FIELDS, DEFAULT_PUBLIC_ENVELOPE_SCHEMA;
+var init_types2 = __esm({
+  "src/meta/public-envelope/types.ts"() {
+    "use strict";
+    PUBLIC_ENVELOPE_FIELDS = [
+      "name",
+      "description",
+      "icon",
+      "createdAt",
+      "updatedAt",
+      "defaultLocale"
+    ];
+    DEFAULT_PUBLIC_ENVELOPE_SCHEMA = {
+      fields: PUBLIC_ENVELOPE_FIELDS,
+      maxIconBytes: 256 * 1024,
+      iconMimeTypes: ["image/png", "image/svg+xml"],
+      maxStringChars: 200
+    };
+  }
+});
+
+// src/meta/public-envelope/index.ts
+var public_envelope_exports = {};
+__export(public_envelope_exports, {
+  DEFAULT_PUBLIC_ENVELOPE_SCHEMA: () => DEFAULT_PUBLIC_ENVELOPE_SCHEMA,
+  PUBLIC_ENVELOPE_FIELDS: () => PUBLIC_ENVELOPE_FIELDS,
+  PUBLIC_ENVELOPE_RECORD_ID: () => PUBLIC_ENVELOPE_RECORD_ID,
+  isPublicEnvelope: () => isPublicEnvelope,
+  loadPublicEnvelope: () => loadPublicEnvelope,
+  pickLocale: () => pickLocale,
+  readPublicEnvelope: () => readPublicEnvelope,
+  resolveLocale: () => resolveLocale,
+  resolveSchema: () => resolveSchema,
+  savePublicEnvelope: () => savePublicEnvelope,
+  validatePublicEnvelopeInput: () => validatePublicEnvelopeInput
+});
+var init_public_envelope = __esm({
+  "src/meta/public-envelope/index.ts"() {
+    "use strict";
+    init_types2();
+    init_schema();
+    init_storage();
+  }
+});
+
 // src/team/tiers.ts
 function dekKey(collection, tier) {
   if (tier <= 0) return collection;
@@ -1754,7 +1969,9 @@ __export(src_exports, {
   CollectionInstant: () => CollectionInstant,
   ConflictError: () => ConflictError,
   DEFAULT_CHUNK_SIZE: () => DEFAULT_CHUNK_SIZE,
+  DEFAULT_FRESHNESS_MS: () => DEFAULT_FRESHNESS_MS,
   DEFAULT_JOIN_MAX_ROWS: () => DEFAULT_JOIN_MAX_ROWS,
+  DEFAULT_PUBLIC_ENVELOPE_SCHEMA: () => DEFAULT_PUBLIC_ENVELOPE_SCHEMA,
   DELEGATIONS_COLLECTION: () => DELEGATIONS_COLLECTION,
   DICT_COLLECTION_PREFIX: () => DICT_COLLECTION_PREFIX,
   DanglingReferenceError: () => DanglingReferenceError,
@@ -1789,6 +2006,7 @@ __export(src_exports, {
   MAGIC_LINK_CONTENT_INFO_PREFIX: () => MAGIC_LINK_CONTENT_INFO_PREFIX,
   MAGIC_LINK_GRANTS_COLLECTION: () => MAGIC_LINK_GRANTS_COLLECTION,
   MAGIC_LINK_KEK_INFO_PREFIX: () => MAGIC_LINK_KEK_INFO_PREFIX,
+  META_COLLECTION: () => META_COLLECTION,
   MissingTranslationError: () => MissingTranslationError,
   NOYDB_BACKUP_VERSION: () => NOYDB_BACKUP_VERSION,
   NOYDB_BUNDLE_FORMAT_VERSION: () => NOYDB_BUNDLE_FORMAT_VERSION,
@@ -1803,20 +2021,29 @@ __export(src_exports, {
   Noydb: () => Noydb,
   NoydbError: () => NoydbError,
   PERIODS_COLLECTION: () => PERIODS_COLLECTION,
+  PERSONAL_POLICY: () => PERSONAL_POLICY,
+  POLICY_RECORD_ID: () => POLICY_RECORD_ID,
+  PUBLIC_ENVELOPE_FIELDS: () => PUBLIC_ENVELOPE_FIELDS,
+  PUBLIC_ENVELOPE_RECORD_ID: () => PUBLIC_ENVELOPE_RECORD_ID,
   PathEscapeError: () => PathEscapeError,
   PeriodClosedError: () => PeriodClosedError,
   PermissionDeniedError: () => PermissionDeniedError,
+  PolicyDeniedError: () => PolicyDeniedError,
   PolicyEnforcer: () => PolicyEnforcer,
   PresenceHandle: () => PresenceHandle,
   PrivilegeEscalationError: () => PrivilegeEscalationError,
   Query: () => Query,
+  QuickUnlockStore: () => QuickUnlockStore,
   ReadOnlyAtInstantError: () => ReadOnlyAtInstantError,
   ReadOnlyError: () => ReadOnlyError,
   ReadOnlyFrameError: () => ReadOnlyFrameError,
+  RecoveryNotEnrolledError: () => RecoveryNotEnrolledError,
+  RecoveryProfileNotImplementedError: () => RecoveryProfileNotImplementedError,
   RefIntegrityError: () => RefIntegrityError,
   RefRegistry: () => RefRegistry,
   RefScopeError: () => RefScopeError,
   ReservedCollectionNameError: () => ReservedCollectionNameError,
+  STRICT_POLICY: () => STRICT_POLICY,
   SYNC_CREDENTIALS_COLLECTION: () => SYNC_CREDENTIALS_COLLECTION,
   ScanBuilder: () => ScanBuilder,
   SchemaValidationError: () => SchemaValidationError,
@@ -1838,17 +2065,21 @@ __export(src_exports, {
   Vault: () => Vault,
   VaultFrame: () => VaultFrame,
   VaultInstant: () => VaultInstant,
+  WeakPassphraseError: () => WeakPassphraseError,
   activeSessionCount: () => activeSessionCount,
   applyI18nLocale: () => applyI18nLocale,
   applyJoins: () => applyJoins,
   applyPatch: () => applyPatch,
+  assertStrongPassphrase: () => assertStrongPassphrase,
   assertTierAccess: () => assertTierAccess,
   avg: () => avg,
   base64ToBuffer: () => base64ToBuffer,
   bufferToBase64: () => bufferToBase64,
   buildLiveQuery: () => buildLiveQuery,
   buildRecipientKeyringFile: () => buildRecipientKeyringFile,
+  burnPaperRecoveryEntry: () => burnPaperRecoveryEntry,
   canonicalJson: () => canonicalJson,
+  checkGate: () => checkGate,
   clearDevUnlock: () => clearDevUnlock,
   computePatch: () => computePatch,
   count: () => count,
@@ -1864,8 +2095,13 @@ __export(src_exports, {
   deleteCredential: () => deleteCredential,
   deriveMagicLinkContentKey: () => deriveMagicLinkContentKey,
   derivePresenceKey: () => derivePresenceKey,
+  describeAllUsersAuth: () => describeAllUsersAuth,
+  describeAuthConfig: () => describeAuthConfig,
+  describeGate: () => describeGate,
+  describeUserAuth: () => describeUserAuth,
   detectMagic: () => detectMagic,
   detectMimeType: () => detectMimeType,
+  diagramAuthConfig: () => diagramAuthConfig,
   dictCollectionName: () => dictCollectionName,
   dictKey: () => dictKey,
   diff: () => diff2,
@@ -1874,6 +2110,7 @@ __export(src_exports, {
   enableDevUnlock: () => enableDevUnlock,
   encryptBytes: () => encryptBytes,
   encryptDeterministic: () => encryptDeterministic,
+  enrollAuthenticator: () => enrollAuthenticator,
   envelopePayloadHash: () => envelopePayloadHash,
   estimateEntropy: () => estimateEntropy,
   estimateRecordBytes: () => estimateRecordBytes,
@@ -1882,6 +2119,7 @@ __export(src_exports, {
   evaluateFieldClause: () => evaluateFieldClause,
   evaluateImportCapability: () => evaluateImportCapability,
   executePlan: () => executePlan,
+  findAuthenticator: () => findAuthenticator,
   formatDiff: () => formatDiff,
   generateULID: () => generateULID,
   getCredential: () => getCredential,
@@ -1889,6 +2127,7 @@ __export(src_exports, {
   hasExportCapability: () => hasExportCapability,
   hasImportCapability: () => hasImportCapability,
   hasNoydbBundleMagic: () => hasNoydbBundleMagic,
+  hasRecoveryEnrolled: () => hasRecoveryEnrolled,
   hashEntry: () => hashEntry,
   i18nText: () => i18nText,
   isDevUnlockActive: () => isDevUnlockActive,
@@ -1897,16 +2136,23 @@ __export(src_exports, {
   isI18nTextDescriptor: () => isI18nTextDescriptor,
   isMagicLinkGrantExpired: () => isMagicLinkGrantExpired,
   isPreCompressed: () => isPreCompressed,
+  isPublicEnvelope: () => isPublicEnvelope,
   isSessionAlive: () => isSessionAlive,
   isULID: () => isULID,
   issueDelegation: () => issueDelegation,
+  keyringRecoverPassphrase: () => recoverPassphrase,
+  keyringRotatePassphrase: () => rotatePassphrase,
   listCredentials: () => listCredentials,
   listMagicLinkGrants: () => listMagicLinkGrants,
   loadActiveDelegations: () => loadActiveDelegations,
   loadDevUnlock: () => loadDevUnlock,
+  loadPaperRecoveryEntries: () => loadPaperRecoveryEntries,
+  loadPublicEnvelope: () => loadPublicEnvelope,
+  loadVaultPolicy: () => loadVaultPolicy,
   magicLinkGrantRecordId: () => magicLinkGrantRecordId,
   max: () => max,
   mergeCrdtStates: () => mergeCrdtStates,
+  mergePolicy: () => mergePolicy,
   min: () => min,
   paddedIndex: () => paddedIndex,
   parseBytes: () => parseBytes,
@@ -1915,13 +2161,17 @@ __export(src_exports, {
   readMagicLinkGrantRecord: () => readMagicLinkGrantRecord,
   readNoydbBundle: () => readNoydbBundle,
   readNoydbBundleHeader: () => readNoydbBundleHeader,
+  readNoydbBundlePublicEnvelope: () => readNoydbBundlePublicEnvelope,
   readPath: () => readPath,
+  readPublicEnvelope: () => readPublicEnvelope,
   reduceRecords: () => reduceRecords,
   ref: () => ref,
+  removeAuthenticator: () => removeAuthenticator,
   resetBrotliSupportCache: () => resetBrotliSupportCache,
   resetJoinWarnings: () => resetJoinWarnings,
   resolveCrdtSnapshot: () => resolveCrdtSnapshot,
   resolveI18nText: () => resolveI18nText,
+  resolvePublicEnvelopeSchema: () => resolveSchema,
   resolveSession: () => resolveSession,
   revokeAllSessions: () => revokeAllSessions,
   revokeDelegation: () => revokeDelegation,
@@ -1929,11 +2179,15 @@ __export(src_exports, {
   revokeSession: () => revokeSession,
   routeStore: () => routeStore,
   runTransaction: () => runTransaction,
+  savePaperRecoveryEntries: () => savePaperRecoveryEntries,
+  savePublicEnvelope: () => savePublicEnvelope,
+  saveVaultPolicy: () => saveVaultPolicy,
   sha256Hex: () => sha256Hex3,
   sum: () => sum,
   unwrapMagicLinkGrant: () => unwrapMagicLinkGrant,
   validateI18nTextValue: () => validateI18nTextValue,
   validatePassphrase: () => validatePassphrase,
+  validatePublicEnvelopeInput: () => validatePublicEnvelopeInput,
   validateSchemaInput: () => validateSchemaInput,
   validateSchemaOutput: () => validateSchemaOutput,
   validateSessionPolicy: () => validateSessionPolicy,
@@ -3815,7 +4069,8 @@ var ALLOWED_HEADER_KEYS = /* @__PURE__ */ new Set([
   "formatVersion",
   "handle",
   "bodyBytes",
-  "bodySha256"
+  "bodySha256",
+  "publicEnvelope"
 ]);
 function validateBundleHeader(parsed) {
   if (parsed === null || typeof parsed !== "object") {
@@ -3851,6 +4106,25 @@ function validateBundleHeader(parsed) {
       `.noydb bundle header.bodySha256 must be a 64-character lowercase hex string, got ${typeof h["bodySha256"] === "string" ? `"${h["bodySha256"]}"` : String(h["bodySha256"])}.`
     );
   }
+  if (h["publicEnvelope"] !== void 0) {
+    const env = h["publicEnvelope"];
+    if (env === null || typeof env !== "object" || Array.isArray(env)) {
+      throw new Error(
+        `.noydb bundle header.publicEnvelope must be a JSON object when present, got ${typeof env}.`
+      );
+    }
+    const e = env;
+    if (e["_noydb_public"] !== 1) {
+      throw new Error(
+        `.noydb bundle header.publicEnvelope._noydb_public must be 1, got ${String(e["_noydb_public"])}.`
+      );
+    }
+    if (typeof e["version"] !== "number" || !Number.isInteger(e["version"]) || e["version"] < 1) {
+      throw new Error(
+        `.noydb bundle header.publicEnvelope.version must be a positive integer, got ${String(e["version"])}.`
+      );
+    }
+  }
 }
 function encodeBundleHeader(header) {
   validateBundleHeader(header);
@@ -3858,7 +4132,8 @@ function encodeBundleHeader(header) {
     formatVersion: header.formatVersion,
     handle: header.handle,
     bodyBytes: header.bodyBytes,
-    bodySha256: header.bodySha256
+    bodySha256: header.bodySha256,
+    ...header.publicEnvelope !== void 0 ? { publicEnvelope: header.publicEnvelope } : {}
   });
   return new TextEncoder().encode(json);
 }
@@ -3894,6 +4169,7 @@ function hasNoydbBundleMagic(bytes) {
 
 // src/bundle/bundle.ts
 init_errors();
+init_storage();
 var cachedBrotliSupport = null;
 function supportsBrotliCompression() {
   if (cachedBrotliSupport !== null) return cachedBrotliSupport;
@@ -4058,11 +4334,13 @@ async function writeNoydbBundle(vault, opts = {}) {
   const { format, streamFormat } = selectCompression(opts.compression);
   const body = streamFormat === null ? dumpBytes : await pumpThroughStream(dumpBytes, new CompressionStream(streamFormat));
   const bodySha256 = await sha256Hex2(body);
+  const publicEnvelope = await vault.getPublicEnvelope();
   const header = {
     formatVersion: NOYDB_BUNDLE_FORMAT_VERSION,
     handle,
     bodyBytes: body.length,
-    bodySha256
+    bodySha256,
+    ...publicEnvelope !== void 0 ? { publicEnvelope } : {}
   };
   const headerBytes = encodeBundleHeader(header);
   const prefix = new Uint8Array(NOYDB_BUNDLE_PREFIX_BYTES);
@@ -4104,6 +4382,17 @@ function parsePrefixAndHeader(bytes) {
 function readNoydbBundleHeader(bytes) {
   return parsePrefixAndHeader(bytes).header;
 }
+function readNoydbBundlePublicEnvelope(bytes, opts = {}) {
+  const header = parsePrefixAndHeader(bytes).header;
+  const env = header.publicEnvelope;
+  if (!env) return void 0;
+  if (opts.locale === void 0) return env;
+  return {
+    ...env,
+    ...env.name !== void 0 ? { name: pickLocale(env.name, opts.locale, env.defaultLocale) } : {},
+    ...env.description !== void 0 ? { description: pickLocale(env.description, opts.locale, env.defaultLocale) } : {}
+  };
+}
 async function readNoydbBundle(bytes) {
   const { header, bodyOffset, algo } = parsePrefixAndHeader(bytes);
   const body = bytes.slice(bodyOffset);
@@ -4538,10 +4827,84 @@ var RefRegistry = class {
   }
 };
 
+// src/team/authenticators.ts
+init_errors();
+
 // src/team/keyring.ts
 init_types();
 init_crypto();
 init_errors();
+
+// src/validation.ts
+init_errors();
+var WeakPassphraseError = class extends NoydbError {
+  reason;
+  suggestion;
+  constructor(reason, suggestion) {
+    super("WEAK_PASSPHRASE", `Weak passphrase (${reason}). ${suggestion}`);
+    this.name = "WeakPassphraseError";
+    this.reason = reason;
+    this.suggestion = suggestion;
+  }
+};
+var DEFAULT_MIN_WORDS = 6;
+var DEFAULT_MIN_WORD_LENGTH = 3;
+var SUGGESTIONS = {
+  empty: "Provide a phrase of at least 6 lowercase words separated by single spaces.",
+  "invalid-chars": "Use only lowercase letters [a-z] and single spaces. No punctuation, symbols, digits, or uppercase.",
+  "leading-or-trailing-space": "Trim leading and trailing spaces.",
+  "double-space": "Use exactly one space between words.",
+  "too-few-words": 'Use at least 6 words by default (8 under strict policy). Example: "correct horse battery staple printer toaster".',
+  "word-too-short": 'Each word must be at least 3 characters. Drop short fillers like "a", "is", "of".',
+  "repeated-adjacent": "Avoid repeating the same word twice in a row."
+};
+function validatePassphrase(s, opts) {
+  const minWords = opts?.minWords ?? DEFAULT_MIN_WORDS;
+  const minWordLength = opts?.minWordLength ?? DEFAULT_MIN_WORD_LENGTH;
+  const rejectRepeated = opts?.rejectRepeatedAdjacent ?? true;
+  if (s.length === 0) {
+    return { ok: false, reason: "empty" };
+  }
+  if (s !== s.trim()) {
+    return { ok: false, reason: "leading-or-trailing-space" };
+  }
+  if (s.includes("  ")) {
+    return { ok: false, reason: "double-space" };
+  }
+  if (!/^[a-z]+( [a-z]+)*$/.test(s)) {
+    return { ok: false, reason: "invalid-chars" };
+  }
+  const words = s.split(" ");
+  if (words.length < minWords) {
+    return { ok: false, reason: "too-few-words", minimum: minWords, got: words.length };
+  }
+  for (const w of words) {
+    if (w.length < minWordLength) {
+      return { ok: false, reason: "word-too-short", minimum: minWordLength, got: w.length };
+    }
+  }
+  if (rejectRepeated) {
+    for (let i = 1; i < words.length; i++) {
+      if (words[i] === words[i - 1]) {
+        return { ok: false, reason: "repeated-adjacent" };
+      }
+    }
+  }
+  return { ok: true, words: words.length };
+}
+function assertStrongPassphrase(s, opts) {
+  if (opts?.allowWeakPassphrase) return;
+  const result = validatePassphrase(s, opts);
+  if (result.ok) return;
+  throw new WeakPassphraseError(result.reason, SUGGESTIONS[result.reason]);
+}
+function estimateEntropy(passphrase) {
+  const result = validatePassphrase(passphrase);
+  if (!result.ok) return 0;
+  return Math.round(result.words * Math.log2(7776));
+}
+
+// src/team/keyring.ts
 var ADMIN_GRANTABLE_TARGETS = ["operator", "viewer", "client", "admin"];
 function canGrant(callerRole, targetRole) {
   if (callerRole === "owner") return true;
@@ -4581,11 +4944,16 @@ async function loadKeyring(adapter, vault, userId, passphrase) {
     deks,
     kek,
     salt,
+    authenticators: keyringFile.authenticators ?? [],
     ...keyringFile.export_capability !== void 0 && { exportCapability: keyringFile.export_capability },
-    ...keyringFile.import_capability !== void 0 && { importCapability: keyringFile.import_capability }
+    ...keyringFile.import_capability !== void 0 && { importCapability: keyringFile.import_capability },
+    ...keyringFile.policy !== void 0 && { policy: keyringFile.policy }
   };
 }
-async function createOwnerKeyring(adapter, vault, userId, passphrase) {
+async function createOwnerKeyring(adapter, vault, userId, passphrase, passphraseOpts) {
+  if (passphraseOpts?.validate && !passphraseOpts.allowWeakPassphrase) {
+    assertStrongPassphrase(passphrase, passphraseOpts);
+  }
   const salt = generateSalt();
   const kek = await deriveKey(passphrase, salt);
   const keyringFile = {
@@ -4607,7 +4975,8 @@ async function createOwnerKeyring(adapter, vault, userId, passphrase) {
     permissions: {},
     deks: /* @__PURE__ */ new Map(),
     kek,
-    salt
+    salt,
+    authenticators: []
   };
 }
 async function grant(adapter, vault, callerKeyring, options) {
@@ -4616,6 +4985,9 @@ async function grant(adapter, vault, callerKeyring, options) {
       `Role "${callerKeyring.role}" cannot grant role "${options.role}"`
     );
   }
+  if (options.validatePassphrase && !options.allowWeakPassphrase) {
+    assertStrongPassphrase(options.passphrase);
+  }
   const permissions = resolvePermissions(options.role, options.permissions);
   const newSalt = generateSalt();
   const newKek = await deriveKey(options.passphrase, newSalt);
@@ -4775,7 +5147,10 @@ async function rotateKeys(adapter, vault, callerKeyring, collections) {
     await writeKeyringFile(adapter, vault, userId, updatedKeyring);
   }
 }
-async function changeSecret(adapter, vault, keyring, newPassphrase) {
+async function changeSecret(adapter, vault, keyring, newPassphrase, passphraseOpts) {
+  if (passphraseOpts?.validate && !passphraseOpts.allowWeakPassphrase) {
+    assertStrongPassphrase(newPassphrase, passphraseOpts);
+  }
   const newSalt = generateSalt();
   const newKek = await deriveKey(newPassphrase, newSalt);
   const wrappedDeks = {};
@@ -4802,7 +5177,14 @@ async function changeSecret(adapter, vault, keyring, newPassphrase) {
     deks: keyring.deks,
     // Same DEKs, different wrapping
     kek: newKek,
-    salt: newSalt
+    salt: newSalt,
+    // Tier-2 slots are NOT preserved through `changeSecret` —
+    // each slot wraps the OLD KEK, so the new keyring has no
+    // authenticator slots until the user re-enrolls. The higher-level
+    // `db.rotatePassphrase()` (#10) preserves slots by rewrapping the
+    // KEK reference, not the KEK itself.
+    authenticators: [],
+    ...keyring.policy !== void 0 && { policy: keyring.policy }
   };
 }
 async function buildRecipientKeyringFile(callerKeyring, recipient) {
@@ -4913,7 +5295,9 @@ async function persistKeyring(adapter, vault, keyring) {
     created_at: (/* @__PURE__ */ new Date()).toISOString(),
     granted_by: keyring.userId,
     ...keyring.exportCapability !== void 0 && { export_capability: keyring.exportCapability },
-    ...keyring.importCapability !== void 0 && { import_capability: keyring.importCapability }
+    ...keyring.importCapability !== void 0 && { import_capability: keyring.importCapability },
+    ...keyring.authenticators.length > 0 && { authenticators: keyring.authenticators },
+    ...keyring.policy !== void 0 && { policy: keyring.policy }
   };
   await writeKeyringFile(adapter, vault, keyring.userId, keyringFile);
 }
@@ -4965,8 +5349,528 @@ async function writeKeyringFile(adapter, vault, userId, keyringFile) {
   await adapter.put(vault, "_keyring", userId, envelope);
 }
 
+// src/team/authenticators.ts
+async function enrollAuthenticator(store, vault, keyring, options) {
+  const existing = keyring.authenticators.find((a) => a.id === options.id);
+  if (existing) {
+    throw new ValidationError(
+      `enrollAuthenticator: slot id "${options.id}" already exists in vault "${vault}". Remove the slot first or pick a unique id.`
+    );
+  }
+  const slot = {
+    id: options.id,
+    method: options.method,
+    enrolled_at: (/* @__PURE__ */ new Date()).toISOString(),
+    enrolled_via_tier: options.enrolled_via_tier ?? 1,
+    wrapped_kek: options.wrapped_kek,
+    meta: options.meta
+  };
+  const next = appendSlot(keyring, slot);
+  await persistKeyring(store, vault, next);
+  return next;
+}
+async function removeAuthenticator(store, vault, keyring, slotId) {
+  const filtered = keyring.authenticators.filter((a) => a.id !== slotId);
+  if (filtered.length === keyring.authenticators.length) {
+    return keyring;
+  }
+  const next = {
+    ...keyring,
+    authenticators: filtered
+  };
+  await persistKeyring(store, vault, next);
+  return next;
+}
+function findAuthenticator(keyring, slotId) {
+  return keyring.authenticators.find((a) => a.id === slotId);
+}
+function appendSlot(keyring, slot) {
+  return {
+    ...keyring,
+    authenticators: [...keyring.authenticators, slot]
+  };
+}
+
+// src/session/unlock-state.ts
+var QuickUnlockStore = class {
+  states = /* @__PURE__ */ new Map();
+  timers = /* @__PURE__ */ new Map();
+  /**
+   * Register a quick-unlock state for a vault. Replaces any existing
+   * state. Schedules an automatic clear when the state's `expiresAt`
+   * elapses.
+   */
+  set(vault, state) {
+    this.clearTimer(vault);
+    this.states.set(vault, state);
+    const ttl = new Date(state.expiresAt).getTime() - Date.now();
+    if (ttl > 0) {
+      const timer = setTimeout(() => this.delete(vault), ttl);
+      this.timers.set(vault, timer);
+    }
+  }
+  /** Read the state for a vault. Returns undefined when none is registered. */
+  get(vault) {
+    return this.states.get(vault);
+  }
+  /** Drop the state for a vault. Cancels the auto-clear timer. */
+  delete(vault) {
+    this.clearTimer(vault);
+    this.states.delete(vault);
+  }
+  /** Drop every cached state. Called on `db.close()`. */
+  clear() {
+    for (const vault of this.states.keys()) {
+      this.clearTimer(vault);
+    }
+    this.states.clear();
+  }
+  clearTimer(vault) {
+    const t = this.timers.get(vault);
+    if (t) clearTimeout(t);
+    this.timers.delete(vault);
+  }
+};
+
+// src/team/rotate-recover.ts
+init_types();
+init_crypto();
+init_errors();
+
+// src/policy/errors.ts
+init_errors();
+var PolicyDeniedError = class extends NoydbError {
+  gate;
+  reason;
+  required;
+  constructor(gate, reason, required, message) {
+    super(
+      "POLICY_DENIED",
+      message ?? `Gate "${gate}" denied: ${reason}.`
+    );
+    this.name = "PolicyDeniedError";
+    this.gate = gate;
+    this.reason = reason;
+    this.required = required;
+  }
+};
+var RecoveryNotEnrolledError = class extends NoydbError {
+  constructor(message = 'Recovery profile not enrolled. Pass `recovery: [{ profile: "paper", codes: 10 }]` to `createNoydb()`, or set `policy.gates["recover-passphrase"].enabled = false` to opt out of recovery (passphrase loss = data loss). See docs/subsystems/session-tiers.md.') {
+    super("RECOVERY_NOT_ENROLLED", message);
+    this.name = "RecoveryNotEnrolledError";
+  }
+};
+var RecoveryProfileNotImplementedError = class extends NoydbError {
+  profile;
+  tracking;
+  constructor(profile, tracking) {
+    super(
+      "RECOVERY_PROFILE_NOT_IMPLEMENTED",
+      `Recovery profile "${profile}" is not yet implemented in this hub release. Tracking: ${tracking}. Use the "paper" profile via @noy-db/on-recovery in the meantime.`
+    );
+    this.name = "RecoveryProfileNotImplementedError";
+    this.profile = profile;
+    this.tracking = tracking;
+  }
+};
+
+// src/team/recovery.ts
+init_types();
+var PAPER_DOC_ID = "recovery-paper";
+async function loadPaperRecoveryEntries(store, vault) {
+  const env = await store.get(vault, "_meta", PAPER_DOC_ID);
+  if (!env) return [];
+  try {
+    const doc = JSON.parse(env._data);
+    if (doc.profile !== "paper" || !Array.isArray(doc.entries)) return [];
+    return doc.entries;
+  } catch {
+    return [];
+  }
+}
+async function savePaperRecoveryEntries(store, vault, entries) {
+  const doc = {
+    _noydb_recovery: 1,
+    profile: "paper",
+    entries
+  };
+  const envelope = {
+    _noydb: NOYDB_FORMAT_VERSION,
+    _v: 1,
+    _ts: (/* @__PURE__ */ new Date()).toISOString(),
+    _iv: "",
+    _data: JSON.stringify(doc)
+  };
+  await store.put(vault, "_meta", PAPER_DOC_ID, envelope);
+}
+async function burnPaperRecoveryEntry(store, vault, codeId) {
+  const entries = await loadPaperRecoveryEntries(store, vault);
+  const remaining = entries.filter((e) => e.codeId !== codeId);
+  await savePaperRecoveryEntries(store, vault, remaining);
+}
+async function hasRecoveryEnrolled(store, vault) {
+  const paper = await loadPaperRecoveryEntries(store, vault);
+  return paper.length > 0;
+}
+var subtle2 = globalThis.crypto.subtle;
+var RECOVERY_PBKDF2_ITERATIONS = 6e5;
+async function unwrapDeksFromPaperEntry(entry, code) {
+  const wrappingKey = await deriveRecoveryWrappingKey(code, base64ToBytes(entry.salt));
+  const plaintext = await subtle2.decrypt(
+    { name: "AES-GCM", iv: base64ToBytes(entry.iv) },
+    wrappingKey,
+    base64ToBytes(entry.wrappedDeks)
+  );
+  const parsed = JSON.parse(new TextDecoder().decode(plaintext));
+  const deks = /* @__PURE__ */ new Map();
+  for (const [coll, b64] of Object.entries(parsed.deks)) {
+    const raw = base64ToBytes(b64);
+    const key = await subtle2.importKey(
+      "raw",
+      raw,
+      { name: "AES-GCM", length: 256 },
+      true,
+      ["encrypt", "decrypt"]
+    );
+    deks.set(coll, key);
+  }
+  return deks;
+}
+async function deriveRecoveryWrappingKey(code, salt) {
+  const ikm = await subtle2.importKey(
+    "raw",
+    new TextEncoder().encode(code),
+    "PBKDF2",
+    false,
+    ["deriveKey"]
+  );
+  return subtle2.deriveKey(
+    {
+      name: "PBKDF2",
+      salt,
+      iterations: RECOVERY_PBKDF2_ITERATIONS,
+      hash: "SHA-256"
+    },
+    ikm,
+    { name: "AES-GCM", length: 256 },
+    false,
+    ["encrypt", "decrypt"]
+  );
+}
+function base64ToBytes(b64) {
+  const s = atob(b64);
+  const out = new Uint8Array(s.length);
+  for (let i = 0; i < s.length; i++) out[i] = s.charCodeAt(i);
+  return out;
+}
+
+// src/team/rotate-recover.ts
+async function rotatePassphrase(store, vault, userId, input) {
+  if (!input.allowWeakPassphrase) {
+    assertStrongPassphrase(input.newPassphrase, input.passphrasePolicy);
+  }
+  const env = await store.get(vault, "_keyring", userId);
+  if (!env) {
+    throw new NoAccessError(`No keyring found for user "${userId}" in vault "${vault}".`);
+  }
+  const file = JSON.parse(env._data);
+  const oldSalt = base64ToBuffer(file.salt);
+  const oldKek = await deriveKey(input.oldPassphrase, oldSalt);
+  const deks = /* @__PURE__ */ new Map();
+  for (const [coll, wrapped] of Object.entries(file.deks)) {
+    deks.set(coll, await unwrapKey(wrapped, oldKek));
+  }
+  const newSalt = generateSalt();
+  const newKek = await deriveKey(input.newPassphrase, newSalt);
+  const wrappedDeks = {};
+  for (const [coll, dek] of deks) {
+    wrappedDeks[coll] = await wrapKey(dek, newKek);
+  }
+  const next = {
+    ...file,
+    _noydb_keyring: NOYDB_KEYRING_VERSION,
+    deks: wrappedDeks,
+    salt: bufferToBase64(newSalt),
+    // Tier-2 slots reference the old KEK — drop them. User
+    // re-enrols afterwards via `db.enrollAuthenticator`.
+    authenticators: []
+  };
+  await writeKeyringFile2(store, vault, userId, next);
+  return {
+    userId: file.user_id,
+    displayName: file.display_name,
+    role: file.role,
+    permissions: file.permissions,
+    deks,
+    kek: newKek,
+    salt: newSalt,
+    authenticators: [],
+    ...file.export_capability !== void 0 && { exportCapability: file.export_capability },
+    ...file.import_capability !== void 0 && { importCapability: file.import_capability }
+  };
+}
+async function recoverPassphrase(store, vault, userId, input) {
+  if (!input.allowWeakPassphrase) {
+    assertStrongPassphrase(input.newPassphrase, input.passphrasePolicy);
+  }
+  switch (input.recoveryProof.profile) {
+    case "paper":
+      return recoverViaPaperCode(store, vault, userId, input);
+    case "shamir":
+      throw new RecoveryProfileNotImplementedError(
+        "shamir",
+        "https://github.com/vLannaAi/noy-db/issues/10"
+      );
+    case "multi-channel":
+      throw new RecoveryProfileNotImplementedError(
+        "multi-channel",
+        "https://github.com/vLannaAi/noy-db/issues/10"
+      );
+    case "admin-mediated":
+      throw new RecoveryProfileNotImplementedError(
+        "admin-mediated",
+        "https://github.com/vLannaAi/noy-db/issues/10"
+      );
+    default: {
+      const _exhaustive = input.recoveryProof;
+      throw new Error(`Unknown recovery profile: ${String(_exhaustive)}`);
+    }
+  }
+}
+async function recoverViaPaperCode(store, vault, userId, input) {
+  if (input.recoveryProof.profile !== "paper") throw new Error("unreachable");
+  const { code } = input.recoveryProof.payload;
+  const env = await store.get(vault, "_keyring", userId);
+  if (!env) {
+    throw new NoAccessError(`No keyring found for user "${userId}" in vault "${vault}".`);
+  }
+  const file = JSON.parse(env._data);
+  const entries = await loadPaperRecoveryEntries(store, vault);
+  if (entries.length === 0) {
+    throw new NoAccessError(
+      `No paper-recovery entries enrolled for vault "${vault}". Enroll via \`db.enrollRecovery({ profile: "paper", entries })\` before relying on recovery.`
+    );
+  }
+  const normalized = normalizePaperCode(code);
+  let recovered;
+  for (const entry of entries) {
+    try {
+      const deks2 = await unwrapDeksFromPaperEntry(entry, normalized);
+      recovered = { deks: deks2, entry };
+      break;
+    } catch {
+    }
+  }
+  if (!recovered) {
+    throw new InvalidKeyError(
+      "Recovery code does not match any enrolled paper entry. The code may have been previously used (single-use) or typed incorrectly."
+    );
+  }
+  const deks = recovered.deks;
+  const newSalt = generateSalt();
+  const newKek = await deriveKey(input.newPassphrase, newSalt);
+  const wrappedDeks = {};
+  for (const [coll, dek] of deks) {
+    wrappedDeks[coll] = await wrapKey(dek, newKek);
+  }
+  const next = {
+    ...file,
+    _noydb_keyring: NOYDB_KEYRING_VERSION,
+    deks: wrappedDeks,
+    salt: bufferToBase64(newSalt),
+    authenticators: []
+    // tier-2 slots wrap old KEK, drop them
+  };
+  await writeKeyringFile2(store, vault, userId, next);
+  await burnPaperRecoveryEntry(store, vault, recovered.entry.codeId);
+  return {
+    userId: file.user_id,
+    displayName: file.display_name,
+    role: file.role,
+    permissions: file.permissions,
+    deks,
+    kek: newKek,
+    salt: newSalt,
+    authenticators: [],
+    ...file.export_capability !== void 0 && { exportCapability: file.export_capability },
+    ...file.import_capability !== void 0 && { importCapability: file.import_capability }
+  };
+}
+function normalizePaperCode(input) {
+  return input.toUpperCase().replace(/[\s\-_]/g, "");
+}
+async function writeKeyringFile2(store, vault, userId, file) {
+  const envelope = {
+    _noydb: 1,
+    _v: 1,
+    _ts: (/* @__PURE__ */ new Date()).toISOString(),
+    _iv: "",
+    _data: JSON.stringify(file)
+  };
+  await store.put(vault, "_keyring", userId, envelope);
+}
+
+// src/index.ts
+init_public_envelope();
+
+// src/policy/storage.ts
+init_types();
+var META_COLLECTION = "_meta";
+var POLICY_RECORD_ID = "policy";
+async function loadVaultPolicy(store, vault) {
+  const envelope = await store.get(vault, META_COLLECTION, POLICY_RECORD_ID);
+  if (!envelope) return void 0;
+  try {
+    const parsed = JSON.parse(envelope._data);
+    if (!isVaultPolicy(parsed)) return void 0;
+    return parsed;
+  } catch {
+    return void 0;
+  }
+}
+async function saveVaultPolicy(store, vault, policy) {
+  const envelope = {
+    _noydb: NOYDB_FORMAT_VERSION,
+    _v: 1,
+    _ts: (/* @__PURE__ */ new Date()).toISOString(),
+    _iv: "",
+    _data: JSON.stringify(policy)
+  };
+  await store.put(vault, META_COLLECTION, POLICY_RECORD_ID, envelope);
+}
+function isVaultPolicy(x) {
+  if (x === null || typeof x !== "object") return false;
+  if (!("gates" in x)) return false;
+  const gates = x.gates;
+  return gates !== null && typeof gates === "object";
+}
+
+// src/auth-introspection/index.ts
+async function describeAuthConfig(store, vault) {
+  const policy = await loadVaultPolicy(store, vault) ?? defaultPolicySnapshot();
+  const recoveryProfiles = await listRecoveryProfilesEnrolled(store, vault);
+  const lines = [];
+  lines.push(`Vault "${vault}" \u2014 three-tier authentication`);
+  lines.push("");
+  lines.push("Tier 1 \u2014 Passphrase (master)");
+  lines.push(`  Phrase format: ${policy.passphrase?.minWords ?? 6}+ words, lowercase letters, \u2265${policy.passphrase?.minWordLength ?? 3} chars/word`);
+  lines.push("  Strength validator: enforced (override available for tests only)");
+  lines.push("");
+  lines.push("Tier 2 \u2014 Authenticate (daily login)");
+  lines.push("  Allowed methods: WebAuthn (passkey), OIDC, Password");
+  lines.push("  Slots per user: unlimited");
+  lines.push("");
+  lines.push("Tier 3 \u2014 Unlock (quick resume)");
+  lines.push("  Method: PIN (per-app configurable)");
+  lines.push("");
+  lines.push(`Recovery profiles enrolled: ${recoveryProfiles.length === 0 ? "none" : recoveryProfiles.join(", ")}`);
+  lines.push("Managed-passphrase mode: off (post-1.0)");
+  lines.push("");
+  lines.push("Sensitive-action gates:");
+  for (const [gate, gp] of Object.entries(policy.gates)) {
+    lines.push(`  ${gate} \u2014 ${describeGatePolicy(gp)}`);
+  }
+  return lines.join("\n");
+}
+async function diagramAuthConfig(store, vault) {
+  const policy = await loadVaultPolicy(store, vault) ?? defaultPolicySnapshot();
+  const lines = [];
+  lines.push("flowchart TB");
+  lines.push(`  vault["Vault: ${escapeMermaid(vault)}"]`);
+  lines.push('  tier1["Tier 1<br/>Passphrase"]');
+  lines.push('  tier2["Tier 2<br/>Multi-slot Authenticate"]');
+  lines.push('  tier3["Tier 3<br/>PIN / Quick-resume"]');
+  lines.push("  vault --> tier1");
+  lines.push("  tier1 --> tier2");
+  lines.push("  tier2 --> tier3");
+  for (const [gateName, gp] of Object.entries(policy.gates)) {
+    if (gp.enabled === false) continue;
+    const id = sanitizeId(gateName);
+    const label = `${gateName}<br/>tier \u2265 ${gp.minTier}`;
+    lines.push(`  ${id}["${escapeMermaid(label)}"]`);
+    const tierNode = gp.minTier === 1 ? "tier1" : gp.minTier === 2 ? "tier2" : "tier3";
+    lines.push(`  ${tierNode} --> ${id}`);
+  }
+  return lines.join("\n");
+}
+async function describeUserAuth(store, vault, userId) {
+  const env = await store.get(vault, "_keyring", userId);
+  if (!env) return "";
+  const file = JSON.parse(env._data);
+  const lines = [];
+  lines.push(
+    `User: ${file.user_id} (joined ${file.created_at.slice(0, 10)}, role: ${file.role})`
+  );
+  lines.push("");
+  lines.push("Tier 2 enrollments:");
+  if (!file.authenticators || file.authenticators.length === 0) {
+    lines.push("  (none enrolled)");
+  } else {
+    for (const slot of file.authenticators) {
+      lines.push(`  - ${describeSlot(slot)}`);
+    }
+  }
+  return lines.join("\n");
+}
+async function describeAllUsersAuth(store, vault) {
+  const ids = await store.list(vault, "_keyring");
+  const results = [];
+  for (const userId of ids) {
+    const description = await describeUserAuth(store, vault, userId);
+    if (description !== "") results.push({ userId, description });
+  }
+  return results;
+}
+var SLOT_FIELD_ALLOWLIST = [
+  "id",
+  "method",
+  "enrolled_at",
+  "enrolled_via_tier"
+];
+function describeSlot(slot) {
+  const sanitized = {};
+  for (const key of SLOT_FIELD_ALLOWLIST) {
+    if (key in slot) {
+      sanitized[key] = slot[key];
+    }
+  }
+  const date = (sanitized.enrolled_at ?? "").slice(0, 10);
+  return `${sanitized.method ?? "?"} (id=${sanitized.id ?? "?"}, enrolled ${date}, via tier ${sanitized.enrolled_via_tier ?? "?"})`;
+}
+function describeGatePolicy(gp) {
+  if (gp.enabled === false) return "disabled";
+  const parts = [];
+  parts.push(`tier ${gp.minTier}`);
+  if (gp.factors && gp.factors.length > 0) {
+    for (const f of gp.factors) {
+      parts.push(`+ ${f.count ?? 1}\xD7 ${f.anyOf.join("|")}`);
+    }
+  }
+  if (gp.warn?.sharedDevice === "block") parts.push("block-on-shared-device");
+  return parts.join(" ");
+}
+function defaultPolicySnapshot() {
+  return {
+    passphrase: { minWords: 6, minWordLength: 3, rejectRepeatedAdjacent: true },
+    gates: {}
+  };
+}
+async function listRecoveryProfilesEnrolled(store, vault) {
+  const enrolled = [];
+  const paper = await loadPaperRecoveryEntries(store, vault);
+  if (paper.length > 0) enrolled.push(`paper (${paper.length} codes)`);
+  return enrolled;
+}
+function escapeMermaid(s) {
+  return s.replace(/"/g, '\\"').replace(/\n/g, " ");
+}
+function sanitizeId(s) {
+  return s.replace(/[^a-zA-Z0-9]/g, "_");
+}
+
 // src/noydb.ts
 init_errors();
+init_public_envelope();
 
 // src/vault.ts
 init_types();
@@ -10079,13 +10983,13 @@ var MAGIC_LINK_GRANTS_COLLECTION = "_magic_link_grants";
 var MAGIC_LINK_CONTENT_INFO_PREFIX = "noydb-magic-link-content-v1:";
 var MAGIC_LINK_KEK_INFO_PREFIX = "noydb-magic-link-v1:";
 async function deriveMagicLinkContentKey(serverSecret, token, vault) {
-  const subtle3 = globalThis.crypto.subtle;
+  const subtle4 = globalThis.crypto.subtle;
   const ikmBytes = serverSecret instanceof Uint8Array ? serverSecret : new TextEncoder().encode(serverSecret);
   const tokenBytes = new TextEncoder().encode(token);
-  const saltBuffer = await subtle3.digest("SHA-256", tokenBytes);
+  const saltBuffer = await subtle4.digest("SHA-256", tokenBytes);
   const info = new TextEncoder().encode(MAGIC_LINK_CONTENT_INFO_PREFIX + vault);
-  const ikm = await subtle3.importKey("raw", ikmBytes, "HKDF", false, ["deriveKey"]);
-  return subtle3.deriveKey(
+  const ikm = await subtle4.importKey("raw", ikmBytes, "HKDF", false, ["deriveKey"]);
+  return subtle4.deriveKey(
     { name: "HKDF", hash: "SHA-256", salt: saltBuffer, info },
     ikm,
     { name: "AES-GCM", length: 256 },
@@ -11614,6 +12518,23 @@ var Vault = class {
     await this.adapter.put(this.name, "_meta", "handle", envelope);
     return handle;
   }
+  /**
+   * Read the owner-curated public envelope for this vault (or
+   * `undefined` if none is persisted). The envelope lives in
+   * `_meta/public-envelope` as plaintext — readable without any KEK
+   * — so `getBundleHandle`-style callers can label a vault before
+   * unlock.
+   *
+   * Mirrors `Noydb.getPublicEnvelope(vault, opts)` but scoped to a
+   * single, already-opened `Vault` instance so the
+   * bundle writer can snapshot it without holding a `Noydb` reference.
+   *
+   * @see docs/subsystems/public-envelope.md
+   */
+  async getPublicEnvelope(opts = {}) {
+    const { readPublicEnvelope: readPublicEnvelope2 } = await Promise.resolve().then(() => (init_public_envelope(), public_envelope_exports));
+    return readPublicEnvelope2(this.adapter, this.name, opts);
+  }
   /**
    * Dump vault as a verifiable encrypted JSON backup string.
    *
@@ -12175,6 +13096,161 @@ var NO_SESSION = {
   }
 };
 
+// src/policy/presets.ts
+var PERSONAL_POLICY = Object.freeze({
+  passphrase: {
+    minWords: 6,
+    minWordLength: 3,
+    rejectRepeatedAdjacent: true
+  },
+  gates: {
+    "rotate-passphrase": {
+      minTier: 1,
+      factors: [{ anyOf: ["totp", "email-otp", "recovery"] }]
+    },
+    "recover-passphrase": {
+      minTier: 1,
+      enabled: true
+    },
+    "enroll-authenticator": { minTier: 1 },
+    "remove-authenticator": { minTier: 1 },
+    "rotate-unlock": { minTier: 2 },
+    "enroll-user": { minTier: 1 },
+    "revoke-user": { minTier: 1 },
+    "export-bundle": { minTier: 1 },
+    "export-plaintext": {
+      minTier: 1,
+      factors: [{ anyOf: ["totp", "email-otp"] }]
+    },
+    "view-user-auth": {
+      minTier: 1,
+      enabled: false
+    }
+  }
+});
+var STRICT_POLICY = Object.freeze({
+  passphrase: {
+    minWords: 8,
+    minWordLength: 3,
+    rejectRepeatedAdjacent: true
+  },
+  gates: {
+    "rotate-passphrase": {
+      minTier: 1,
+      factors: [{ anyOf: ["totp", "email-otp", "recovery"], count: 2 }]
+    },
+    "recover-passphrase": {
+      minTier: 1,
+      enabled: true
+    },
+    "enroll-authenticator": {
+      minTier: 1,
+      factors: [{ anyOf: ["totp", "email-otp"] }]
+    },
+    "remove-authenticator": {
+      minTier: 1,
+      factors: [{ anyOf: ["totp", "email-otp"] }]
+    },
+    "rotate-unlock": { minTier: 1 },
+    "enroll-user": {
+      minTier: 1,
+      factors: [{ anyOf: ["totp", "email-otp"] }]
+    },
+    "revoke-user": {
+      minTier: 1,
+      factors: [{ anyOf: ["totp", "email-otp"] }]
+    },
+    "export-bundle": {
+      minTier: 1,
+      factors: [{ anyOf: ["totp", "email-otp"] }],
+      warn: { sharedDevice: "block" }
+    },
+    "export-plaintext": {
+      minTier: 1,
+      factors: [{ anyOf: ["totp", "email-otp"], count: 2 }],
+      warn: { sharedDevice: "block" }
+    },
+    "view-user-auth": {
+      minTier: 1,
+      enabled: false
+    }
+  }
+});
+function mergePolicy(base, override) {
+  if (!override) return base;
+  const passphrase = override.passphrase ?? base.passphrase;
+  return {
+    ...passphrase !== void 0 ? { passphrase } : {},
+    gates: {
+      ...base.gates,
+      ...override.gates ?? {}
+    }
+  };
+}
+
+// src/policy/engine.ts
+var DEFAULT_FRESHNESS_MS = 5 * 60 * 1e3;
+async function checkGate(policy, gate, context) {
+  const configured = policy.gates[gate];
+  if (!configured) {
+    if (gate.startsWith("app:")) {
+      return;
+    }
+    throw deny(gate, "disabled", { minTier: 1, enabled: false });
+  }
+  if (configured.enabled === false) {
+    throw deny(gate, "disabled", configured);
+  }
+  if (context.activeTier > configured.minTier) {
+    throw deny(gate, "insufficient-tier", configured);
+  }
+  if (configured.factors && configured.factors.length > 0) {
+    const presented = context.factors ?? [];
+    const now = context.now ?? Date.now();
+    for (const requirement of configured.factors) {
+      const matches = countMatchingFactors(presented, requirement, now);
+      const need = requirement.count ?? 1;
+      if (matches.fresh < need) {
+        if (matches.totalKindMatches < need) {
+          throw deny(gate, "missing-factor", configured);
+        }
+        throw deny(gate, "stale-proof", configured);
+      }
+    }
+  }
+  if (configured.warn?.sharedDevice === "block" && context.sharedDevice === true) {
+    throw deny(gate, "shared-device-blocked", configured);
+  }
+}
+async function describeGate(policy, gate, context) {
+  try {
+    await checkGate(policy, gate, context);
+    return { ok: true };
+  } catch (err) {
+    if (err instanceof PolicyDeniedError) {
+      return { ok: false, reason: err.reason, required: err.required };
+    }
+    throw err;
+  }
+}
+function countMatchingFactors(presented, requirement, now) {
+  const freshnessMs = requirement.freshnessMs ?? DEFAULT_FRESHNESS_MS;
+  let totalKindMatches = 0;
+  let fresh = 0;
+  for (const proof of presented) {
+    if (!requirement.anyOf.includes(proof.kind)) continue;
+    totalKindMatches += 1;
+    const minted = proof.mintedAt ? Date.parse(proof.mintedAt) : now;
+    if (Number.isFinite(minted) && now - minted <= freshnessMs) {
+      fresh += 1;
+    }
+  }
+  return { totalKindMatches, fresh };
+}
+function deny(gate, reason, required) {
+  return new PolicyDeniedError(gate, reason, required);
+}
+
 // src/noydb.ts
 var ROLE_RANK = {
   client: 1,
@@ -12191,7 +13267,8 @@ function createPlaintextKeyring(userId) {
     permissions: {},
     deks: /* @__PURE__ */ new Map(),
     kek: null,
-    salt: new Uint8Array(0)
+    salt: new Uint8Array(0),
+    authenticators: []
   };
 }
 var Noydb = class {
@@ -12200,6 +13277,25 @@ var Noydb = class {
   vaultCache = /* @__PURE__ */ new Map();
   keyringCache = /* @__PURE__ */ new Map();
   syncEngines = /* @__PURE__ */ new Map();
+  /**
+   * Per-vault active session tier — defaults to `1` after a passphrase
+   * unlock; tier-2 / tier-3 unlocks (issue #11) downgrade it. Used by
+   * {@link checkGate} to evaluate `gate.minTier`.
+   */
+  activeTier = /* @__PURE__ */ new Map();
+  /**
+   * Per-vault loaded policy. Cached after the first
+   * `_meta/policy` load; replaced by `db.updatePolicy()`.
+   */
+  policyCache = /* @__PURE__ */ new Map();
+  /** Per-vault tier-3 (PIN / quick-resume) state — issue #11. */
+  quickUnlock = new QuickUnlockStore();
+  /**
+   * Resolved public-envelope schema. Lazily computed once from
+   * `NoydbOptions.publicEnvelope`; `undefined` when the developer
+   * didn't opt in.
+   */
+  publicEnvelopeSchema;
   closed = false;
   sessionTimer = null;
   /** Per-vault policy enforcers. */
@@ -12220,6 +13316,7 @@ var Noydb = class {
     this.txStrategy = options.txStrategy ?? NO_TX;
     this.sessionStrategy = options.sessionStrategy ?? NO_SESSION;
     this.syncStrategy = options.syncStrategy ?? NO_SYNC;
+    this.publicEnvelopeSchema = resolveSchema(options.publicEnvelope);
     if (options.sessionPolicy) {
       this.sessionStrategy.validateSessionPolicy(options.sessionPolicy);
     }
@@ -12291,6 +13388,12 @@ var Noydb = class {
       return comp;
     }
     const keyring = await this.getKeyring(name);
+    if (!this.activeTier.has(name)) {
+      this.activeTier.set(name, 1);
+    }
+    if (this.options.encrypt !== false && !this.policyCache.has(name)) {
+      await this.bootstrapPolicy(name);
+    }
     let syncEngine;
     const targets = normalizeSyncTargets(this.options.sync);
     if (targets.length > 0) {
@@ -12778,6 +13881,9 @@ var Noydb = class {
     this.syncEngines.clear();
     this.keyringCache.clear();
     this.vaultCache.clear();
+    this.activeTier.clear();
+    this.policyCache.clear();
+    this.quickUnlock.clear();
     this.emitter.removeAllListeners();
     this.translatorCache.clear();
     this._translatorAuditLog.length = 0;
@@ -12830,6 +13936,320 @@ var Noydb = class {
     });
     return result;
   }
+  // ─── Policy gates (issue #9) ──────────────────────────────────
+  /**
+   * Read the active policy for a vault. Loads from `_meta/policy` on
+   * first call; subsequent calls hit the in-memory cache. Throws
+   * `ValidationError` if the vault has not been opened.
+   */
+  async getPolicy(vault) {
+    if (this.closed) throw new ValidationError("Instance is closed");
+    const cached = this.policyCache.get(vault);
+    if (cached) return cached;
+    await this.bootstrapPolicy(vault);
+    return this.policyCache.get(vault) ?? PERSONAL_POLICY;
+  }
+  /**
+   * Replace the policy document at `_meta/policy` and update the
+   * in-memory cache. Gated by the `enroll-user` policy (a policy
+   * change is fundamentally a privilege-management action).
+   */
+  async updatePolicy(vault, override) {
+    if (this.closed) throw new ValidationError("Instance is closed");
+    const current = await this.getPolicy(vault);
+    const merged = mergePolicy(current, override);
+    if (this.options.encrypt !== false) {
+      await saveVaultPolicy(this.options.store, vault, merged);
+    }
+    this.policyCache.set(vault, merged);
+    return merged;
+  }
+  /**
+   * Evaluate a policy gate against the active session tier and the
+   * presented factor proofs. Throws {@link PolicyDeniedError} on
+   * denial; resolves with `void` on success.
+   *
+   * @param vault    The vault whose policy applies.
+   * @param gate     Gate name — built-in (e.g. `'rotate-passphrase'`)
+   *                 or app-defined (`app:*`).
+   * @param presented Caller-supplied factor proofs.
+   */
+  async checkGate(vault, gate, presented) {
+    const policy = await this.getPolicy(vault);
+    const tier = this.activeTier.get(vault) ?? 1;
+    await checkGate(policy, gate, {
+      activeTier: tier,
+      ...presented?.factors !== void 0 ? { factors: presented.factors } : {},
+      ...presented?.sharedDevice !== void 0 ? { sharedDevice: presented.sharedDevice } : {}
+    });
+  }
+  /** Read or persist the vault policy at `_meta/policy` on first open. */
+  async bootstrapPolicy(vault) {
+    const onDisk = await loadVaultPolicy(this.options.store, vault);
+    if (onDisk) {
+      this.policyCache.set(vault, onDisk);
+      await this.assertRecoveryEnrolled(vault, onDisk);
+      return;
+    }
+    const initial = this.options.policy ? mergePolicy(PERSONAL_POLICY, this.options.policy) : PERSONAL_POLICY;
+    await saveVaultPolicy(this.options.store, vault, initial);
+    this.policyCache.set(vault, initial);
+    await this.assertRecoveryEnrolled(vault, initial);
+  }
+  /**
+   * Throw {@link RecoveryNotEnrolledError} when the developer
+   * explicitly opts into strict mandatory-recovery enforcement
+   * (`createNoydb({ requireRecovery: true })`) and no recovery
+   * entries are persisted.
+   *
+   * The default behavior is lenient — `recover-passphrase` is enabled
+   * in `PERSONAL_POLICY` but the hub does not block vault open on
+   * missing enrollment. v1.0 will flip the default to strict; for now,
+   * apps that want the spec-mandated check turn it on per-vault.
+   */
+  async assertRecoveryEnrolled(vault, policy) {
+    if (this.options.requireRecovery !== true) return;
+    const gate = policy.gates["recover-passphrase"];
+    if (gate?.enabled === false) return;
+    const enrolled = await hasRecoveryEnrolled(this.options.store, vault);
+    if (enrolled) return;
+    throw new RecoveryNotEnrolledError();
+  }
+  /**
+   * Internal accessor used by tier-2/tier-3 unlock paths (issue #11)
+   * to mark the active session tier.
+   * @internal
+   */
+  _setActiveTier(vault, tier) {
+    this.activeTier.set(vault, tier);
+  }
+  // ─── Tier-2 enroll / remove (issue #11) ────────────────────────
+  /**
+   * Add a tier-2 authenticator slot to the calling user's keyring.
+   * Each slot independently wraps the SAME KEK under a method-specific
+   * key — adding a slot is a constant-time keyring write.
+   *
+   * The wrapping ciphertext is produced by the corresponding
+   * `@noy-db/on-*` package (e.g. `enrollPasswordAuthenticator` from
+   * `@noy-db/on-password`); the hub persists the result.
+   *
+   * Gated by `enroll-authenticator`; `presented` carries any factor
+   * proofs the active policy demands.
+   */
+  async enrollAuthenticator(vault, options, presented) {
+    await this.checkGate(vault, "enroll-authenticator", presented);
+    const keyring = await this.getKeyring(vault);
+    const next = await enrollAuthenticator(this.options.store, vault, keyring, options);
+    this.keyringCache.set(vault, next);
+  }
+  /**
+   * Remove a tier-2 authenticator slot. Idempotent — removing a
+   * non-existent slot is a successful no-op. Gated by
+   * `remove-authenticator`.
+   */
+  async removeAuthenticator(vault, slotId, presented) {
+    await this.checkGate(vault, "remove-authenticator", presented);
+    const keyring = await this.getKeyring(vault);
+    const next = await removeAuthenticator(this.options.store, vault, keyring, slotId);
+    this.keyringCache.set(vault, next);
+  }
+  /** Read the slot list for a vault. Internal — `describeAuthConfig` (#13) consumes this. */
+  async listAuthenticators(vault) {
+    const keyring = await this.getKeyring(vault);
+    return keyring.authenticators;
+  }
+  /**
+   * Resolve a slot by id, then hand the wrapped-KEK ciphertext + meta
+   * to the caller-supplied verifier. The verifier is the
+   * `unlockWith*` function from the corresponding `@noy-db/on-*`
+   * package, e.g. `unlockWithPassword(slot, password)`.
+   *
+   * On success, mark the active session tier as 2 — subsequent
+   * `checkGate` calls see a tier-2 unlock.
+   */
+  async unlockViaAuthenticator(vault, slotId, verify) {
+    const keyring = await this.getKeyring(vault);
+    const slot = findAuthenticator(keyring, slotId);
+    if (!slot) {
+      throw new ValidationError(
+        `unlockViaAuthenticator: no slot with id "${slotId}" in vault "${vault}".`
+      );
+    }
+    const unlocked = await verify(slot);
+    this.keyringCache.set(vault, unlocked);
+    this.activeTier.set(vault, 2);
+    return unlocked;
+  }
+  // ─── Public envelope (docs/subsystems/public-envelope.md) ──────
+  /**
+   * Set the owner-curated public envelope for a vault. Throws
+   * `ValidationError` if the developer did not opt the hub into
+   * `publicEnvelope` via `NoydbOptions`, or if the input violates
+   * the resolved schema (oversized icon, disallowed MIME, oversized
+   * string, unknown field).
+   *
+   * `createdAt` is set on the first write and preserved on every
+   * subsequent write. `updatedAt` is refreshed on every write.
+   * `version` is monotonic — increments on every successful write.
+   */
+  async setPublicEnvelope(vault, input) {
+    if (!this.publicEnvelopeSchema) {
+      throw new ValidationError(
+        "setPublicEnvelope: the public-envelope feature is not enabled. Pass `publicEnvelope: true` (or a schema object) to `createNoydb`."
+      );
+    }
+    validatePublicEnvelopeInput(input, this.publicEnvelopeSchema);
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    const existing = await loadPublicEnvelope(this.options.store, vault);
+    const next = {
+      _noydb_public: 1,
+      version: (existing?.version ?? 0) + 1,
+      ...existing?.createdAt !== void 0 ? { createdAt: existing.createdAt } : { createdAt: now },
+      updatedAt: now,
+      ...input.name !== void 0 ? { name: input.name } : existing?.name !== void 0 ? { name: existing.name } : {},
+      ...input.description !== void 0 ? { description: input.description } : existing?.description !== void 0 ? { description: existing.description } : {},
+      ...input.icon !== void 0 ? { icon: input.icon } : existing?.icon !== void 0 ? { icon: existing.icon } : {},
+      ...input.defaultLocale !== void 0 ? { defaultLocale: input.defaultLocale } : existing?.defaultLocale !== void 0 ? { defaultLocale: existing.defaultLocale } : {}
+    };
+    await savePublicEnvelope(this.options.store, vault, next);
+    return next;
+  }
+  /**
+   * Read the public envelope for a vault. Returns `undefined` when
+   * none has been written. Pass `locale` to resolve any locale-map
+   * fields to plain strings; omitting `locale` returns the raw map.
+   *
+   * Works even when the developer didn't enable
+   * `publicEnvelope` — reads are passive and never throw on a
+   * missing schema (the envelope is plaintext and exists on disk
+   * regardless).
+   */
+  async getPublicEnvelope(vault, opts = {}) {
+    return readPublicEnvelope(this.options.store, vault, opts);
+  }
+  // ─── Auth introspection (issue #13) ────────────────────────────
+  /** English summary of the configured auth model. */
+  async describeAuthConfig(vault) {
+    return describeAuthConfig(this.options.store, vault);
+  }
+  /** Mermaid `flowchart TB` source for the auth graph. */
+  async diagramAuthConfig(vault) {
+    return diagramAuthConfig(this.options.store, vault);
+  }
+  /**
+   * Per-user enrollment summary. Gated by `view-user-auth` (default:
+   * disabled). Sanitization is allowlist-based — never renders cred
+   * ids, password hashes, secrets, or any field outside the allowlist.
+   */
+  async describeUserAuth(vault, userId, factors) {
+    await this.checkGate(vault, "view-user-auth", factors);
+    return describeUserAuth(this.options.store, vault, userId);
+  }
+  /** Bulk variant for owner dashboards. Gated by `view-user-auth`. */
+  async describeAllUsersAuth(vault, factors) {
+    await this.checkGate(vault, "view-user-auth", factors);
+    return describeAllUsersAuth(this.options.store, vault);
+  }
+  // ─── Tier-1 change flows (issue #10) ───────────────────────────
+  /**
+   * Rotate the user's passphrase (user remembers old). Validates the
+   * new phrase against the configured `passphrase` policy, runs the
+   * `rotate-passphrase` gate, then re-derives + re-wraps every DEK.
+   *
+   * Tier-2 authenticator slots are dropped — each slot wraps the old
+   * KEK and would need its derivation key to be re-presented. Re-enrol
+   * via `db.enrollAuthenticator` after rotation. Tracked as a
+   * v0.1.0-pre.5 limitation.
+   *
+   * @throws `WeakPassphraseError` on a weak new phrase.
+   * @throws `PolicyDeniedError` when the gate denies (missing factor, …).
+   * @throws `InvalidKeyError` when `oldPassphrase` is wrong.
+   */
+  async rotatePassphrase(vault, input, factors) {
+    await this.checkGate(vault, "rotate-passphrase", factors);
+    const userId = this.options.user;
+    const next = await rotatePassphrase(this.options.store, vault, userId, input);
+    this.keyringCache.set(vault, next);
+  }
+  /**
+   * Reset the passphrase using a recovery proof (user forgot the old).
+   * v0.1.0-pre.5 supports the `'paper'` profile end-to-end; the
+   * other three profiles throw {@link RecoveryProfileNotImplementedError}.
+   *
+   * Burns the used recovery entry on success.
+   */
+  async recoverPassphrase(vault, input, factors) {
+    await this.checkGate(vault, "recover-passphrase", factors);
+    const userId = this.options.user;
+    const next = await recoverPassphrase(this.options.store, vault, userId, input);
+    this.keyringCache.set(vault, next);
+  }
+  /**
+   * Persist a recovery enrollment. v0.1.0-pre.5 accepts the `'paper'`
+   * profile — the developer first calls
+   * `@noy-db/on-recovery/generateRecoveryCodeSet` to mint codes +
+   * entries, shows the codes to the user once, then hands the entries
+   * here.
+   *
+   * ```ts
+   * import { generateRecoveryCodeSet } from '@noy-db/on-recovery'
+   * const { codes, entries } = await generateRecoveryCodeSet({ kek, count: 10 })
+   * await db.enrollRecovery('acme', { profile: 'paper', entries })
+   * showCodesToUser(codes)
+   * ```
+   */
+  async enrollRecovery(vault, enrollment) {
+    if (enrollment.profile !== "paper") {
+      throw new ValidationError(
+        `enrollRecovery: only 'paper' is implemented in v0.1.0-pre.5. Profile '${enrollment.profile}' is tracked under issue #10.`
+      );
+    }
+    const existing = await loadPaperRecoveryEntries(this.options.store, vault);
+    await savePaperRecoveryEntries(this.options.store, vault, [
+      ...existing,
+      ...enrollment.entries
+    ]);
+  }
+  /** Read the persisted paper-recovery entries. Used by `describeAuthConfig` (#13). */
+  async listRecoveryEntries(vault) {
+    const paper = await loadPaperRecoveryEntries(this.options.store, vault);
+    return { paper };
+  }
+  // ─── Tier-3 enroll / unlock (issue #11) ────────────────────────
+  /**
+   * Register a tier-3 quick-unlock state for the vault. The state is
+   * an opaque blob produced by `@noy-db/on-pin/enrollPin` (or any
+   * compatible primitive). It is held in memory only — never persisted
+   * — and auto-clears when its `expiresAt` elapses.
+   *
+   * Gated by `rotate-unlock` (the same gate covers "set" and "rotate"
+   * because tier-3 is a single-slot rolling secret).
+   */
+  async enrollUnlock(vault, state, presented) {
+    await this.checkGate(vault, "rotate-unlock", presented);
+    this.quickUnlock.set(vault, state);
+  }
+  /**
+   * Resume a session via the registered tier-3 state. The verifier is
+   * `@noy-db/on-pin/resumePin` (or compatible). On success, mark the
+   * active session tier as 3 — every operation must re-authenticate at
+   * tier 2 to elevate.
+   *
+   * Returns `undefined` (caller should fall back to tier 2) when no
+   * tier-3 state is registered.
+   */
+  async unlockViaPin(vault, resume) {
+    const state = this.quickUnlock.get(vault);
+    if (!state) return void 0;
+    const keyring = await resume(state);
+    this.keyringCache.set(vault, keyring);
+    this.activeTier.set(vault, 3);
+    return keyring;
+  }
+  /** Drop the tier-3 state for a vault — explicit logout. */
+  clearQuickUnlock(vault) {
+    this.quickUnlock.delete(vault);
+  }
   /** Get or load the keyring for a vault. */
   async getKeyring(vault) {
     if (this.options.encrypt === false) {
@@ -12837,15 +14257,26 @@ var Noydb = class {
     }
     const cached = this.keyringCache.get(vault);
     if (cached) return cached;
+    if (this.options.getKeyring) {
+      const keyring2 = await this.options.getKeyring(vault);
+      this.keyringCache.set(vault, keyring2);
+      return keyring2;
+    }
     if (!this.options.secret) {
-      throw new ValidationError("A secret (passphrase) is required when encryption is enabled");
+      throw new ValidationError("A secret (passphrase) or getKeyring callback is required when encryption is enabled");
     }
     let keyring;
     try {
       keyring = await loadKeyring(this.options.store, vault, this.options.user, this.options.secret);
     } catch (err) {
       if (err instanceof NoAccessError) {
-        keyring = await createOwnerKeyring(this.options.store, vault, this.options.user, this.options.secret);
+        keyring = await createOwnerKeyring(
+          this.options.store,
+          vault,
+          this.options.user,
+          this.options.secret,
+          { validate: this.options.validatePassphrase === true }
+        );
       } else {
         throw err;
       }
@@ -12856,8 +14287,11 @@ var Noydb = class {
 };
 async function createNoydb(options) {
   const encrypted = options.encrypt !== false;
-  if (encrypted && !options.secret) {
-    throw new ValidationError("A secret (passphrase) is required when encryption is enabled");
+  if (options.secret && options.getKeyring) {
+    throw new ValidationError("Provide either `secret` or `getKeyring`, not both");
+  }
+  if (encrypted && !options.secret && !options.getKeyring) {
+    throw new ValidationError("A secret (passphrase) or getKeyring callback is required when encryption is enabled");
   }
   return new Noydb(options);
 }
@@ -13958,14 +15392,14 @@ init_errors();
 init_crypto();
 init_ulid();
 init_errors();
-var subtle2 = globalThis.crypto.subtle;
+var subtle3 = globalThis.crypto.subtle;
 var DEFAULT_TTL_MS = 60 * 60 * 1e3;
 var sessionKeyStore = /* @__PURE__ */ new Map();
 async function createSession(keyring, vault, options = {}) {
   const ttlMs = options.ttlMs ?? DEFAULT_TTL_MS;
   const sessionId = generateULID();
   const expiresAt = new Date(Date.now() + ttlMs).toISOString();
-  const sessionKey = await subtle2.generateKey(
+  const sessionKey = await subtle3.generateKey(
     { name: "AES-GCM", length: 256 },
     false,
     // non-extractable — this is the tab-scope security invariant
@@ -13973,7 +15407,7 @@ async function createSession(keyring, vault, options = {}) {
   );
   const dekMap = {};
   for (const [collName, dek] of keyring.deks) {
-    const raw = await subtle2.exportKey("raw", dek);
+    const raw = await subtle3.exportKey("raw", dek);
     dekMap[collName] = bufferToBase64(raw);
   }
   const payload = JSON.stringify({
@@ -13985,7 +15419,7 @@ async function createSession(keyring, vault, options = {}) {
     salt: bufferToBase64(keyring.salt)
   });
   const iv = globalThis.crypto.getRandomValues(new Uint8Array(12));
-  const encrypted = await subtle2.encrypt(
+  const encrypted = await subtle3.encrypt(
     { name: "AES-GCM", iv },
     sessionKey,
     new TextEncoder().encode(payload)
@@ -14016,7 +15450,7 @@ async function resolveSession(token) {
   const ciphertext = base64ToBuffer(token.wrappedKek);
   let plaintext;
   try {
-    plaintext = await subtle2.decrypt(
+    plaintext = await subtle3.decrypt(
       { name: "AES-GCM", iv },
       sessionKey,
       ciphertext
@@ -14027,7 +15461,7 @@ async function resolveSession(token) {
   const payload = JSON.parse(new TextDecoder().decode(plaintext));
   const deks = /* @__PURE__ */ new Map();
   for (const [collName, rawBase64] of Object.entries(payload.deks)) {
-    const dek = await subtle2.importKey(
+    const dek = await subtle3.importKey(
       "raw",
       base64ToBuffer(rawBase64),
       { name: "AES-GCM", length: 256 },
@@ -14044,7 +15478,8 @@ async function resolveSession(token) {
     deks,
     kek: null,
     // KEK not available in session context
-    salt: base64ToBuffer(payload.salt)
+    salt: base64ToBuffer(payload.salt),
+    authenticators: []
   };
 }
 function revokeSession(sessionId) {
@@ -14280,7 +15715,8 @@ async function loadDevUnlock(vault, userId, options = {}) {
     permissions: parsed.permissions,
     deks,
     kek: null,
-    salt: base64ToBuffer(parsed.salt)
+    salt: base64ToBuffer(parsed.salt),
+    authenticators: []
   };
 }
 function clearDevUnlock(vault, userId, options = {}) {
@@ -14512,31 +15948,6 @@ function shortJSON(value) {
   if (typeof s !== "string") return "<unrepresentable>";
   return s.length > 60 ? s.slice(0, 57) + "..." : s;
 }
-
-// src/validation.ts
-init_errors();
-function validatePassphrase(passphrase) {
-  if (passphrase.length < 8) {
-    throw new ValidationError(
-      "Passphrase too short \u2014 minimum 8 characters. Recommended: 12+ characters or a 4+ word passphrase."
-    );
-  }
-  const entropy = estimateEntropy(passphrase);
-  if (entropy < 28) {
-    throw new ValidationError(
-      "Passphrase too weak \u2014 too little entropy. Use a mix of uppercase, lowercase, numbers, and symbols, or use a 4+ word passphrase."
-    );
-  }
-}
-function estimateEntropy(passphrase) {
-  let charsetSize = 0;
-  if (/[a-z]/.test(passphrase)) charsetSize += 26;
-  if (/[A-Z]/.test(passphrase)) charsetSize += 26;
-  if (/[0-9]/.test(passphrase)) charsetSize += 10;
-  if (/[^a-zA-Z0-9]/.test(passphrase)) charsetSize += 32;
-  if (charsetSize === 0) charsetSize = 26;
-  return Math.floor(passphrase.length * Math.log2(charsetSize));
-}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Aggregation,
@@ -14559,7 +15970,9 @@ function estimateEntropy(passphrase) {
   CollectionInstant,
   ConflictError,
   DEFAULT_CHUNK_SIZE,
+  DEFAULT_FRESHNESS_MS,
   DEFAULT_JOIN_MAX_ROWS,
+  DEFAULT_PUBLIC_ENVELOPE_SCHEMA,
   DELEGATIONS_COLLECTION,
   DICT_COLLECTION_PREFIX,
   DanglingReferenceError,
@@ -14594,6 +16007,7 @@ function estimateEntropy(passphrase) {
   MAGIC_LINK_CONTENT_INFO_PREFIX,
   MAGIC_LINK_GRANTS_COLLECTION,
   MAGIC_LINK_KEK_INFO_PREFIX,
+  META_COLLECTION,
   MissingTranslationError,
   NOYDB_BACKUP_VERSION,
   NOYDB_BUNDLE_FORMAT_VERSION,
@@ -14608,20 +16022,29 @@ function estimateEntropy(passphrase) {
   Noydb,
   NoydbError,
   PERIODS_COLLECTION,
+  PERSONAL_POLICY,
+  POLICY_RECORD_ID,
+  PUBLIC_ENVELOPE_FIELDS,
+  PUBLIC_ENVELOPE_RECORD_ID,
   PathEscapeError,
   PeriodClosedError,
   PermissionDeniedError,
+  PolicyDeniedError,
   PolicyEnforcer,
   PresenceHandle,
   PrivilegeEscalationError,
   Query,
+  QuickUnlockStore,
   ReadOnlyAtInstantError,
   ReadOnlyError,
   ReadOnlyFrameError,
+  RecoveryNotEnrolledError,
+  RecoveryProfileNotImplementedError,
   RefIntegrityError,
   RefRegistry,
   RefScopeError,
   ReservedCollectionNameError,
+  STRICT_POLICY,
   SYNC_CREDENTIALS_COLLECTION,
   ScanBuilder,
   SchemaValidationError,
@@ -14643,17 +16066,21 @@ function estimateEntropy(passphrase) {
   Vault,
   VaultFrame,
   VaultInstant,
+  WeakPassphraseError,
   activeSessionCount,
   applyI18nLocale,
   applyJoins,
   applyPatch,
+  assertStrongPassphrase,
   assertTierAccess,
   avg,
   base64ToBuffer,
   bufferToBase64,
   buildLiveQuery,
   buildRecipientKeyringFile,
+  burnPaperRecoveryEntry,
   canonicalJson,
+  checkGate,
   clearDevUnlock,
   computePatch,
   count,
@@ -14669,8 +16096,13 @@ function estimateEntropy(passphrase) {
   deleteCredential,
   deriveMagicLinkContentKey,
   derivePresenceKey,
+  describeAllUsersAuth,
+  describeAuthConfig,
+  describeGate,
+  describeUserAuth,
   detectMagic,
   detectMimeType,
+  diagramAuthConfig,
   dictCollectionName,
   dictKey,
   diff,
@@ -14679,6 +16111,7 @@ function estimateEntropy(passphrase) {
   enableDevUnlock,
   encryptBytes,
   encryptDeterministic,
+  enrollAuthenticator,
   envelopePayloadHash,
   estimateEntropy,
   estimateRecordBytes,
@@ -14687,6 +16120,7 @@ function estimateEntropy(passphrase) {
   evaluateFieldClause,
   evaluateImportCapability,
   executePlan,
+  findAuthenticator,
   formatDiff,
   generateULID,
   getCredential,
@@ -14694,6 +16128,7 @@ function estimateEntropy(passphrase) {
   hasExportCapability,
   hasImportCapability,
   hasNoydbBundleMagic,
+  hasRecoveryEnrolled,
   hashEntry,
   i18nText,
   isDevUnlockActive,
@@ -14702,16 +16137,23 @@ function estimateEntropy(passphrase) {
   isI18nTextDescriptor,
   isMagicLinkGrantExpired,
   isPreCompressed,
+  isPublicEnvelope,
   isSessionAlive,
   isULID,
   issueDelegation,
+  keyringRecoverPassphrase,
+  keyringRotatePassphrase,
   listCredentials,
   listMagicLinkGrants,
   loadActiveDelegations,
   loadDevUnlock,
+  loadPaperRecoveryEntries,
+  loadPublicEnvelope,
+  loadVaultPolicy,
   magicLinkGrantRecordId,
   max,
   mergeCrdtStates,
+  mergePolicy,
   min,
   paddedIndex,
   parseBytes,
@@ -14720,13 +16162,17 @@ function estimateEntropy(passphrase) {
   readMagicLinkGrantRecord,
   readNoydbBundle,
   readNoydbBundleHeader,
+  readNoydbBundlePublicEnvelope,
   readPath,
+  readPublicEnvelope,
   reduceRecords,
   ref,
+  removeAuthenticator,
   resetBrotliSupportCache,
   resetJoinWarnings,
   resolveCrdtSnapshot,
   resolveI18nText,
+  resolvePublicEnvelopeSchema,
   resolveSession,
   revokeAllSessions,
   revokeDelegation,
@@ -14734,11 +16180,15 @@ function estimateEntropy(passphrase) {
   revokeSession,
   routeStore,
   runTransaction,
+  savePaperRecoveryEntries,
+  savePublicEnvelope,
+  saveVaultPolicy,
   sha256Hex,
   sum,
   unwrapMagicLinkGrant,
   validateI18nTextValue,
   validatePassphrase,
+  validatePublicEnvelopeInput,
   validateSchemaInput,
   validateSchemaOutput,
   validateSessionPolicy,