dsh-vault 0.1.0

package/lib/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","names":["css"],"sources":["../src/client/VaultSection.tsx","../src/client/locales.ts","../src/client/index.ts"],"sourcesContent":["/**\n * Vault settings section: list, search, add, edit, delete, and copy encrypted\n * credentials. All mutations go through the host VaultGateway remote; secrets\n * are shown only inside the edit form or a copy action, never in the list.\n */\n\nimport { useEffect, useId, useMemo, useState, type ReactNode } from 'react'\nimport type { PropsLocale, PropsRuntime, InjectFace, TranslateNS } from '@deepseek-ai/dsh-client-ui-slots'\nimport type { VaultLocaleKey } from './locales.ts'\nimport css from './VaultSection.module.css'\n\n/** Wire shapes shared with the host gateway (mirror of src/index.ts types). */\nexport interface VaultSummaryWire {\n  id: string\n  title: string\n  kind?: string\n  username?: string\n  email?: string\n  phone?: string\n  host?: string\n  port?: string\n  url?: string\n  tags?: string[]\n}\n\nexport interface VaultFullWire {\n  id: string\n  title: string\n  kind?: string\n  username?: string\n  email?: string\n  phone?: string\n  password?: string\n  host?: string\n  port?: string\n  privateKey?: string\n  apiKey?: string\n  secret?: string\n  accessToken?: string\n  refreshToken?: string\n  expiresAt?: number\n  otpSecret?: string\n  url?: string\n  notes?: string\n  tags?: string[]\n  fields?: Record<string, unknown>\n}\n\n/** Patch shape accepted by vault.add / vault.update. */\nexport type VaultPatch = Partial<Omit<VaultFullWire, 'id'>>\n\n/** Registration-side business face supplied by the plugin entry. */\nexport interface VaultSectionInjected {\n  t: TranslateNS<'settings.vault'>\n  list: () => Promise<VaultSummaryWire[]>\n  search: (query: string, limit?: number) => Promise<VaultSummaryWire[]>\n  get: (id: string) => Promise<{ found: boolean; entry?: VaultFullWire }>\n  add: (patch: VaultPatch & { title: string }) => Promise<VaultSummaryWire>\n  update: (id: string, patch: VaultPatch) => Promise<{ found: boolean; entry?: VaultSummaryWire }>\n  remove: (id: string) => Promise<{ deleted: boolean }>\n  totp: (id: string) => Promise<{ code: string; label?: string; secondsRemaining: number }>\n}\n\n/** Type-level alias so consumers can reference the wire shapes without values. */\nexport type VaultSectionTypes = {\n  entries: VaultSummaryWire[]\n  fullEntry: VaultFullWire\n  summaryEntry: VaultSummaryWire\n}\n\n/** Full component props assembled by the Settings slot renderer. */\nexport type VaultSectionProps =\n  PropsRuntime<'settings.section'>\n  & PropsLocale<'settings.vault'>\n  & InjectFace<VaultSectionInjected>\n\n/** The editable form fields we render (subset of the full wire). */\ntype FormFields = Pick<\n  VaultFullWire, 'title' | 'kind' | 'username' | 'email' | 'phone' | 'password' | 'host' | 'port'\n  | 'privateKey' | 'apiKey' | 'secret' | 'accessToken' | 'refreshToken' | 'otpSecret' | 'url' | 'notes'\n>\n\nconst FORM_FIELDS: Array<{ key: keyof FormFields; label: VaultLocaleKey }> = [\n  { key: 'title', label: 'fieldTitle' },\n  { key: 'kind', label: 'fieldKind' },\n  { key: 'username', label: 'fieldUsername' },\n  { key: 'email', label: 'fieldEmail' },\n  { key: 'phone', label: 'fieldPhone' },\n  { key: 'password', label: 'fieldPassword' },\n  { key: 'host', label: 'fieldHost' },\n  { key: 'port', label: 'fieldPort' },\n  { key: 'apiKey', label: 'fieldApiKey' },\n  { key: 'secret', label: 'fieldSecret' },\n  { key: 'accessToken', label: 'fieldAccessToken' },\n  { key: 'refreshToken', label: 'fieldRefreshToken' },\n  { key: 'otpSecret', label: 'fieldOtpSecret' },\n  { key: 'url', label: 'fieldUrl' },\n  { key: 'notes', label: 'fieldNotes' },\n]\n\nconst KIND_KEYS: Record<string, VaultLocaleKey> = {\n  login: 'kindLogin',\n  ssh: 'kindSsh',\n  'api-key': 'kindApiKey',\n  secret: 'kindSecret',\n  oauth: 'kindOauth',\n  custom: 'kindCustom',\n}\n\ntype ViewState =\n  | { readonly status: 'loading' }\n  | { readonly status: 'error' }\n  | { readonly status: 'ready'; readonly entries: VaultSummaryWire[] }\n\ntype EditorState =\n  | { readonly status: 'closed' }\n  | { readonly status: 'creating' }\n  | { readonly status: 'editing'; readonly entry: VaultFullWire }\n\nfunction emptyForm(): FormFields {\n  return { title: '', kind: 'login', username: '', email: '', phone: '', password: '', host: '', port: '' }\n}\n\n/** Render the Vault settings section. */\nexport function VaultSection(props: VaultSectionProps): ReactNode {\n  const { t, list, search, get, add, update, remove, totp } = props\n  const searchId = useId()\n  const [query, setQuery] = useState('')\n  const [state, setState] = useState<ViewState>({ status: 'loading' })\n  const [editor, setEditor] = useState<EditorState>({ status: 'closed' })\n  const [form, setForm] = useState<FormFields>(emptyForm())\n  const [busy, setBusy] = useState(false)\n  const [message, setMessage] = useState<string | null>(null)\n  const [copiedId, setCopiedId] = useState<string | null>(null)\n  const [codeMap, setCodeMap] = useState<Record<string, string>>({})\n  const [tagsDraft, setTagsDraft] = useState('')\n\n  const refresh = useMemo(() => async () => {\n    setState({ status: 'loading' })\n    try {\n      const entries = query.trim().length === 0\n        ? await list()\n        : await search(query.trim())\n      setState({ status: 'ready', entries })\n    } catch {\n      setState({ status: 'error' })\n    }\n  }, [list, search, query])\n\n  useEffect(() => {\n    let current = true\n    void Promise.resolve().then(refresh).then(\n      () => { /* state already set inside refresh */ },\n      () => { if (current) setState({ status: 'error' }) },\n    )\n    return () => { current = false }\n    // refresh is memoized on query; list/search are stable inject faces.\n  }, [refresh])\n\n  /** Open the editor for a new entry. */\n  function startCreate(): void {\n    setForm(emptyForm())\n    setTagsDraft('')\n    setMessage(null)\n    setEditor({ status: 'creating' })\n  }\n\n  /** Open the editor for an existing entry (fetches full secrets). */\n  async function startEdit(id: string): Promise<void> {\n    setBusy(true)\n    setMessage(null)\n    try {\n      const result = await get(id)\n      if (!result.found || result.entry === undefined) {\n        setMessage(t('error'))\n        return\n      }\n      const entry = result.entry\n      setForm({\n        title: entry.title ?? '',\n        kind: entry.kind ?? 'login',\n        username: entry.username ?? '',\n        email: entry.email ?? '',\n        phone: entry.phone ?? '',\n        password: entry.password ?? '',\n        host: entry.host ?? '',\n        port: entry.port ?? '',\n        privateKey: entry.privateKey ?? '',\n        apiKey: entry.apiKey ?? '',\n        secret: entry.secret ?? '',\n        accessToken: entry.accessToken ?? '',\n        refreshToken: entry.refreshToken ?? '',\n        otpSecret: entry.otpSecret ?? '',\n        url: entry.url ?? '',\n        notes: entry.notes ?? '',\n      })\n      setTagsDraft((entry.tags ?? []).join(', '))\n      setEditor({ status: 'editing', entry })\n    } catch {\n      setMessage(t('error'))\n    } finally {\n      setBusy(false)\n    }\n  }\n\n  /** Save the current form (create or update). */\n  async function save(): Promise<void> {\n    if (!form.title.trim()) {\n      setMessage(t('error'))\n      return\n    }\n    setBusy(true)\n    setMessage(null)\n    try {\n      const tags = tagsDraft.split(',').map(x => x.trim()).filter(x => x.length > 0)\n      const patch: VaultPatch = {\n        title: form.title.trim(),\n        ...(form.kind !== undefined ? { kind: form.kind } : {}),\n        ...(form.username !== undefined ? { username: form.username } : {}),\n        ...(form.email !== undefined ? { email: form.email } : {}),\n        ...(form.phone !== undefined ? { phone: form.phone } : {}),\n        ...(form.password !== undefined ? { password: form.password } : {}),\n        ...(form.host !== undefined ? { host: form.host } : {}),\n        ...(form.port !== undefined ? { port: form.port } : {}),\n        ...(form.privateKey !== undefined ? { privateKey: form.privateKey } : {}),\n        ...(form.apiKey !== undefined ? { apiKey: form.apiKey } : {}),\n        ...(form.secret !== undefined ? { secret: form.secret } : {}),\n        ...(form.accessToken !== undefined ? { accessToken: form.accessToken } : {}),\n        ...(form.refreshToken !== undefined ? { refreshToken: form.refreshToken } : {}),\n        ...(form.otpSecret !== undefined ? { otpSecret: form.otpSecret } : {}),\n        ...(form.url !== undefined ? { url: form.url } : {}),\n        ...(form.notes !== undefined ? { notes: form.notes } : {}),\n        // Always send tags: an empty array clears them, and the host store\n        // treats empty string values as \"clear this field\" too.\n        tags,\n      }\n      if (editor.status === 'creating') {\n        await add(patch as VaultPatch & { title: string })\n      } else if (editor.status === 'editing') {\n        await update(editor.entry.id, patch)\n      }\n      setEditor({ status: 'closed' })\n      await refresh()\n    } catch {\n      setMessage(t('error'))\n    } finally {\n      setBusy(false)\n    }\n  }\n\n  /** Delete an entry after confirmation. */\n  async function removeEntry(id: string): Promise<void> {\n    if (!window.confirm(t('deleteConfirm'))) return\n    setBusy(true)\n    try {\n      await remove(id)\n      await refresh()\n    } catch {\n      setMessage(t('error'))\n    } finally {\n      setBusy(false)\n    }\n  }\n\n  /** Copy a field value to the clipboard and flash the row. */\n  async function copyValue(id: string, value: string): Promise<void> {\n    try {\n      await navigator.clipboard.writeText(value)\n    } catch {\n      // Clipboard may be blocked; fall back to a temporary textarea.\n      const textarea = document.createElement('textarea')\n      textarea.value = value\n      document.body.appendChild(textarea)\n      textarea.select()\n      document.execCommand('copy')\n      textarea.remove()\n    }\n    setCopiedId(id)\n    window.setTimeout(() => setCopiedId(null), 1500)\n  }\n\n  /** Fetch and display a TOTP code for an entry with an otpSecret. */\n  async function showTotp(id: string): Promise<void> {\n    setBusy(true)\n    try {\n      const result = await totp(id)\n      setCodeMap(previous => ({ ...previous, [id]: `${result.code} (${result.secondsRemaining}s)` }))\n    } catch {\n      setCodeMap(previous => ({ ...previous, [id]: t('error') }))\n    } finally {\n      setBusy(false)\n    }\n  }\n\n  /** Field-set summary line for one entry (non-secret). */\n  function identityLine(entry: VaultSummaryWire): string {\n    const parts = [\n      entry.kind !== undefined ? t(KIND_KEYS[entry.kind] ?? 'kindCustom') : t('kindLogin'),\n      entry.username,\n      entry.email,\n      entry.phone,\n      entry.host !== undefined ? `${entry.host}${entry.port !== undefined ? `:${entry.port}` : ''}` : undefined,\n      entry.url,\n    ].filter((value): value is string => value !== undefined && value.length > 0)\n    return parts.join(' · ')\n  }\n\n  return (\n    <section className={css.section} aria-labelledby=\"vault-heading\">\n      <h2 id=\"vault-heading\">{t('heading')}</h2>\n      <p className={css.intro}>{t('intro')}</p>\n\n      <div className={css.toolbar}>\n        <label className={css.searchBox}>\n          <span className=\"sr-only\">{t('searchPlaceholder')}</span>\n          <input\n            id={searchId}\n            type=\"search\"\n            placeholder={t('searchPlaceholder')}\n            value={query}\n            onChange={event => setQuery(event.target.value)}\n          />\n        </label>\n        <button type=\"button\" className={css.addButton} onClick={startCreate} disabled={busy}>\n          + {t('add')}\n        </button>\n      </div>\n\n      {message !== null && <p role=\"alert\" className={css.error}>{message}</p>}\n\n      {state.status === 'loading' && <p className={css.status}>{t('loading')}</p>}\n      {state.status === 'error' && <p role=\"alert\" className={css.error}>{t('error')}</p>}\n      {state.status === 'ready' && state.entries.length === 0 && <p className={css.empty}>{t('empty')}</p>}\n\n      {state.status === 'ready' && state.entries.length > 0 && (\n        <ul className={css.list}>\n          {state.entries.map(entry => {\n            const code = codeMap[entry.id]\n            return (\n              <li key={entry.id} className={css.row}>\n                <div className={css.rowMain}>\n                  <span className={css.title}>{entry.title}</span>\n                  <span className={css.identity}>{identityLine(entry)}</span>\n                  {code !== undefined && <span className={css.totp}>{code}</span>}\n                </div>\n                <div className={css.rowActions}>\n                  {copiedId === entry.id && <span className={css.copied}>{t('copied')}</span>}\n                  <button\n                    type=\"button\"\n                    onClick={() => void copyValue(entry.id, entry.username ?? entry.title)}\n                    disabled={busy}\n                  >{t('copy')}</button>\n                  <button type=\"button\" onClick={() => void showTotp(entry.id)} disabled={busy}>{t('totp')}</button>\n                  <button type=\"button\" onClick={() => void startEdit(entry.id)} disabled={busy}>{t('edit')}</button>\n                  <button\n                    type=\"button\"\n                    className={css.deleteButton}\n                    onClick={() => void removeEntry(entry.id)}\n                    disabled={busy}\n                  >{t('delete')}</button>\n                </div>\n              </li>\n            )\n          })}\n        </ul>\n      )}\n\n      {editor.status !== 'closed' && (\n        <div className={css.editor} role=\"dialog\" aria-label={editor.status === 'creating' ? t('add') : t('edit')}>\n          <div className={css.editorBody}>\n            {FORM_FIELDS.map(field => (\n              <label key={field.key} className={css.field}>\n                <span>{t(field.label)}</span>\n                {field.key === 'kind' ? (\n                  <select\n                    value={form.kind ?? 'login'}\n                    onChange={event => setForm(previous => ({ ...previous, kind: event.target.value }))}\n                  >\n                    {Object.entries(KIND_KEYS).map(([value, key]) => (\n                      <option key={value} value={value}>{t(key)}</option>\n                    ))}\n                  </select>\n                ) : field.key === 'title' ? (\n                  <input\n                    value={form.title ?? ''}\n                    onChange={event => setForm(previous => ({ ...previous, title: event.target.value }))}\n                  />\n                ) : (\n                  <input\n                    type={field.key === 'password' || field.key === 'otpSecret' ? 'password' : 'text'}\n                    value={(form[field.key] as string | undefined) ?? ''}\n                    onChange={event => setForm(previous => ({ ...previous, [field.key]: event.target.value }))}\n                  />\n                )}\n              </label>\n            ))}\n            <label className={css.field}>\n              <span>{t('fieldTags')}</span>\n              <input\n                value={tagsDraft}\n                onChange={event => setTagsDraft(event.target.value)}\n                placeholder=\"dev, prod\"\n              />\n            </label>\n          </div>\n          <div className={css.editorActions}>\n            <button type=\"button\" onClick={() => setEditor({ status: 'closed' })} disabled={busy}>{t('cancel')}</button>\n            <button type=\"button\" className={css.saveButton} onClick={() => void save()} disabled={busy}>{t('save')}</button>\n          </div>\n        </div>\n      )}\n    </section>\n  )\n}\n","/** Copy dictionaries for the Vault settings section. */\n\n/** English strings (the key-set source of truth for this pair). */\nexport const en = {\n  nav: 'Vault',\n  heading: 'Vault',\n  intro: 'Encrypted credentials stored on this machine.',\n  searchPlaceholder: 'Search title, username, email, host…',\n  loading: 'Loading…',\n  empty: 'No credentials yet. Add one to get started.',\n  add: 'Add credential',\n  cancel: 'Cancel',\n  save: 'Save',\n  edit: 'Edit',\n  delete: 'Delete',\n  deleteConfirm: 'Delete this entry? This cannot be undone.',\n  copy: 'Copy',\n  copied: 'Copied',\n  totp: 'Code',\n  fieldTitle: 'Title',\n  fieldKind: 'Kind',\n  fieldUsername: 'Username',\n  fieldEmail: 'Email',\n  fieldPhone: 'Phone',\n  fieldPassword: 'Password',\n  fieldHost: 'Host',\n  fieldPort: 'Port',\n  fieldApiKey: 'API key',\n  fieldSecret: 'Secret',\n  fieldAccessToken: 'Access token',\n  fieldRefreshToken: 'Refresh token',\n  fieldOtpSecret: 'OTP secret',\n  fieldUrl: 'URL',\n  fieldNotes: 'Notes',\n  fieldTags: 'Tags',\n  error: 'Something went wrong.',\n  kindLogin: 'Login',\n  kindSsh: 'SSH',\n  kindApiKey: 'API key',\n  kindSecret: 'Secret',\n  kindOauth: 'OAuth',\n  kindCustom: 'Custom',\n} as const\n\nexport type VaultLocaleKey = keyof typeof en\n\n/** Chinese strings (same keys as English). */\nexport const zh: Record<VaultLocaleKey, string> = {\n  nav: '凭据库',\n  heading: 'Vault 凭据库',\n  intro: '本机加密存储的凭据。',\n  searchPlaceholder: '搜索标题、用户名、邮箱、主机…',\n  loading: '加载中…',\n  empty: '还没有凭据，添加一条开始使用。',\n  add: '新增凭据',\n  cancel: '取消',\n  save: '保存',\n  edit: '编辑',\n  delete: '删除',\n  deleteConfirm: '确定删除该条目？此操作不可撤销。',\n  copy: '复制',\n  copied: '已复制',\n  totp: '验证码',\n  fieldTitle: '标题',\n  fieldKind: '类型',\n  fieldUsername: '用户名',\n  fieldEmail: '邮箱',\n  fieldPhone: '手机号',\n  fieldPassword: '密码',\n  fieldHost: '主机',\n  fieldPort: '端口',\n  fieldApiKey: 'API 密钥',\n  fieldSecret: 'Secret',\n  fieldAccessToken: '访问令牌',\n  fieldRefreshToken: '刷新令牌',\n  fieldOtpSecret: 'TOTP 密钥',\n  fieldUrl: 'URL',\n  fieldNotes: '备注',\n  fieldTags: '标签',\n  error: '操作失败。',\n  kindLogin: '登录',\n  kindSsh: 'SSH',\n  kindApiKey: 'API 密钥',\n  kindSecret: 'Secret',\n  kindOauth: 'OAuth',\n  kindCustom: '自定义',\n}\n","/**\n * dsh-vault browser half: a Vault settings page managing encrypted\n * credentials — list, search, add, edit, delete, and copy — through the host\n * VaultGateway remote over the /api RPC channel.\n *\n * @module dsh-vault/client\n */\n\nimport type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client'\nimport type { ConnectionHandle } from '@deepseek-ai/dsh-api-remotes/client'\nimport type {} from '@deepseek-ai/dsh-client-locale/client'\nimport type {} from '@deepseek-ai/dsh-client-ui-settings/client'\nimport { VaultSection, type VaultSectionInjected } from './VaultSection.tsx'\nimport type { VaultSectionTypes } from './VaultSection.tsx'\nimport { en, zh, type VaultLocaleKey } from './locales.ts'\n\nexport type { VaultSectionInjected, VaultSectionProps } from './VaultSection.tsx'\nexport type { VaultSectionTypes } from './VaultSection.tsx'\nexport type { VaultLocaleKey } from './locales.ts'\n\ndeclare module '@deepseek-ai/dsh-client-ui-slots' {\n  interface LocaleNamespaceMap {\n    /** Vault settings page copy. */\n    'settings.vault': VaultLocaleKey\n  }\n}\n\n/** Dictionary namespace owned by this plugin. */\nexport const NS = 'settings.vault'\n\n/** Services required by the Settings registration and the RPC face. */\nexport const inject = ['slots', 'locale', 'connection']\n\n/**\n * Register the Vault settings section once the `settings.section` declaration\n * is on the ledger. The section talks to the host through the connection RPC\n * channel (endpoints `vault/*` served by the host VaultGateway remote).\n */\nexport function apply(ctx: ClientContext): void {\n  ctx.effect(() => ctx.locale.register(NS, { zh, en }), 'dsh-vault: dictionaries')\n\n  const t = ctx.locale.bind(NS)\n  const connection = ctx.get('connection') as ConnectionHandle\n\n  /** Invoke one host vault remote and normalize the RPC envelope. */\n  async function invoke<T>(method: string, args: Record<string, unknown> = {}): Promise<T> {\n    const result = await connection.rpc.call('/api', `vault/${method}`, { args })\n    if (!result.ok) {\n      throw new Error(`vault.${method} failed: ${result.error.code}: ${result.error.message}`)\n    }\n    return result.value as T\n  }\n\n  const injected = (): VaultSectionInjected => ({\n    t,\n    list: () => invoke<{ entries: VaultSectionTypes['entries'] }>('list').then(r => r.entries),\n    search: (query, limit) => invoke<{ entries: VaultSectionTypes['entries'] }>('search', { query, limit: limit ?? 50 }).then(r => r.entries),\n    get: (id) => invoke<{ found: boolean; entry?: VaultSectionTypes['fullEntry'] }>('get', { id }),\n    add: (patch) => invoke<VaultSectionTypes['summaryEntry']>('add', { patch }),\n    update: (id, patch) => invoke<{ found: boolean; entry?: VaultSectionTypes['summaryEntry'] }>('update', { id, patch }),\n    remove: (id) => invoke<{ deleted: boolean }>('delete', { id }),\n    totp: (id) => invoke<{ code: string; label?: string; secondsRemaining: number }>('totp', { id }),\n  })\n\n  ctx.slots.inject('settings.section', () => ctx.slots.register({\n    name: 'settings.section',\n    id: 'vault',\n    order: 30,\n    label: () => t('nav'),\n    inject: injected,\n  }, VaultSection))\n}\n"],"mappings":"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"}

package/lib/crypto.js

@@ -0,0 +1,87 @@
+/**
+ * Cryptographic core for dsh-vault: scrypt key derivation, AES-256-GCM
+ * authenticated encryption, and helper constants.
+ *
+ * Zero external dependencies — everything comes from `node:crypto`, so the
+ * vault's security posture is limited to Node's FIPS-capable primitives and
+ * the master password's strength.
+ *
+ * @module dsh-vault/crypto
+ */
+import { createCipheriv, createDecipheriv, randomBytes, scrypt as scryptCallback, timingSafeEqual, } from 'node:crypto';
+import { promisify } from 'node:util';
+const scrypt = promisify(scryptCallback);
+/** AES-256 key length in bytes. */
+export const KEY_LENGTH = 32;
+/** GCM nonce length in bytes (the recommended 96-bit default). */
+export const IV_LENGTH = 12;
+/** GCM authentication tag length in bytes. */
+export const TAG_LENGTH = 16;
+/** scrypt CPU/memory cost (2^15). Chosen to make offline brute force of a
+ * master password expensive while staying snappy on laptops. */
+export const SCRYPT_N = 2 ** 15;
+/** scrypt block size. */
+export const SCRYPT_R = 8;
+/** scrypt parallelization. */
+export const SCRYPT_P = 1;
+/** 1 GiB cap for the scrypt worker (N=32768, r=8 needs ~32 MiB; the cap is
+ * generous headroom for future cost bumps). */
+const SCRYPT_MAXMEM = 1024 * 1024 * 1024;
+/** Version tag stamped into every encrypted vault header. */
+export const VAULT_FORMAT_VERSION = 1;
+/**
+ * Derive the 256-bit vault key from the master password with scrypt.
+ * The same salt must be used for every derivation of one vault.
+ */
+export async function deriveKey(masterPassword, params) {
+    const salt = Buffer.from(params.saltHex, 'hex');
+    return scrypt(masterPassword, salt, KEY_LENGTH, {
+        N: params.n,
+        r: params.r,
+        p: params.p,
+        maxmem: SCRYPT_MAXMEM,
+    });
+}
+/** Generate fresh random KDF parameters (a new salt for a new vault). */
+export function newKdfParams() {
+    return {
+        algo: 'scrypt',
+        n: SCRYPT_N,
+        r: SCRYPT_R,
+        p: SCRYPT_P,
+        saltHex: randomBytes(16).toString('hex'),
+    };
+}
+/**
+ * Encrypt `plaintext` with AES-256-GCM under `key`. A fresh random nonce is
+ * drawn per call, so encrypting the same plaintext twice yields different
+ * blobs — no IV reuse across entries.
+ */
+export function encrypt(plaintext, key) {
+    const iv = randomBytes(IV_LENGTH);
+    const cipher = createCipheriv('aes-256-gcm', key, iv);
+    const data = Buffer.concat([cipher.update(plaintext), cipher.final()]);
+    const tag = cipher.getAuthTag();
+    return { ivHex: iv.toString('hex'), tagHex: tag.toString('hex'), dataHex: data.toString('hex') };
+}
+/**
+ * Decrypt an {@link EncryptedBlob}. GCM authenticates the ciphertext: a wrong
+ * key, tampered nonce, or modified data throws instead of returning garbage.
+ * @throws when authentication fails (wrong master password or corruption).
+ */
+export function decrypt(blob, key) {
+    const decipher = createDecipheriv('aes-256-gcm', key, Buffer.from(blob.ivHex, 'hex'));
+    decipher.setAuthTag(Buffer.from(blob.tagHex, 'hex'));
+    return Buffer.concat([
+        decipher.update(Buffer.from(blob.dataHex, 'hex')),
+        decipher.final(),
+    ]);
+}
+/** Constant-time comparison of two Buffers of equal length. */
+export function safeEqual(a, b) {
+    return a.length === b.length && timingSafeEqual(a, b);
+}
+/** Generate `bytes` cryptographically strong random bytes as hex. */
+export function randomHex(bytes) {
+    return randomBytes(bytes).toString('hex');
+}