@nuucognition/mesh-ops

Operations-first mutation layer for Mesh SDK.

mesh-ops builds canonical MeshOperation[] batches for CRUD, rename, media rename, and ID backfill flows. It does not persist writes directly. Persistence happens through adapter applyOperations().

Quick start

import {
  applyOperations,
  buildRenameDocumentOperationsByTitle,
  buildRenameMediaOperations,
  buildEnsureIdsOperations,
} from "@nuucognition/mesh-ops"

const rename = await buildRenameDocumentOperationsByTitle(adapter, mesh, "Old", "New")
await applyOperations(adapter, rename.operations)

const mediaRename = await buildRenameMediaOperations(adapter, mesh, {
  oldMediaTitle: "old.png",
  newMediaTitle: "new.webp",
})
await applyOperations(adapter, mediaRename.operations)

const ensure = await buildEnsureIdsOperations(adapter, mesh)
await applyOperations(adapter, ensure.operations)

API groups

• updateWikiReferences and updateWikiReferencesWithReport
• updateWikiEmbedReferences and updateWikiEmbedReferencesWithReport
• buildCreateDocumentOperations
• buildUpdateDocumentOperations
• buildDeleteDocumentOperations
• buildCreateBlobOperations
• buildDeleteBlobOperations
• buildRenameDocumentOperations
• buildRenameDocumentOperationsByTitle
• buildRenameMediaOperations
• buildEnsureIdsOperations
• applyOperations

Compatibility wrappers

For existing callers, wrappers still exist:

• renameDocument
• renameDocumentByTitle
• ensureIds

These wrappers now use the same operation-builder path under the hood.

Behavior notes

• Alias mutation is intentionally not part of the operations-first rename path.
• Frontmatter-only and body edits are represented uniformly as type: "update" operations.
• Builders may use MeshReadAdapter reads to capture reversible before/after snapshots.

Adapter expectations

• MeshReadAdapter for operation construction.
• MeshWriteAdapter.applyOperations for persistence.

Related packages

• @nuucognition/mesh-core for core contracts and transaction helpers.
• @nuucognition/mesh-adapter-fs for filesystem persistence and optional journaling.