mikser-io-archive

Archive plugin for Mikser. Persists matching entities to YAML files in a configurable archives folder, keeping snapshots in sync on create, update, and delete.

Useful when you need an audit trail, a versioned content history, or a portable export to feed a downstream consumer (an LLM training set, a backup target, an analytics pipeline). The archive is just YAML on disk — diffable, git-trackable, takeable-with-you on day one and day 3,000.

Install

npm install mikser-io-archive

Usage

// mikser.config.js
import { archive } from 'mikser-io-archive'

export default {
  plugins: [
    archive({
      archivesFolder: 'archives',
      archives: [
        { match: { collection: 'pages' }, use: 'meta' }
      ]
    })
  ]
}

Each entry in archives selects entities via match and dumps the slice at use (default meta) to <archivesFolder>/<entity.name>.yml. match accepts:

• an object — partial match against the entity (lodash isMatch)
• a string — glob against entity.id, or @/<glob> to match against entity.name
• a function — (entity) => boolean

License

ISC