Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

0.3.19 - 2026-10-12

Changed

• Updated Clojure to 1.12.6, Datalevin to 1.2.2, Biff core and graph to 2.0.2, and Jsonista to 1.0.2.
• Refreshed CI setup actions. Maven remains on 3.9.16 for compatibility with deps-deploy's Maven Resolver 1.x API.
• Requires Java 21 or newer, following Biff 2.0.2's minimum JVM version.
• Datalevin 1.2 uses DLMDB data format version 2; existing databases migrate automatically when opened.

0.3.18 - 2026-09-11

Added

• Biff 2 adapter (biff.datalevin.adapter)
  • module implementing Biff 2's database adapter interface: lifecycle functions, :biff.core/kv-get / :biff.core/kv-set / :biff.core/kv-list, :biff.core/wrap-db-snapshot, and :biff.core/on-tx notifications
  • :biff.datalevin/snapshot? module option (default true); set it to false to skip :biff.core/wrap-db-snapshot and allow concurrent graph queries
  • biff.fx handlers :biff.datalevin.fx/q and :biff.datalevin.fx/execute-tx
  • make-resolvers, which generates biff.graph resolvers from a Datalevin schema, with ref attributes returned as joins
  • :biff.datalevin/ref schema key for ref attributes whose target entity type can't be inferred from the attribute name (e.g. :group/members)

Changed

• Added com.biffweb/core and com.biffweb/graph dependencies.

[0.1.6] - 2026-01-31

Improved

• Updated deps.

0.1.0 - 2026-01-21

Added

• Core system lifecycle (biff.datalevin.core)

  • start-system / stop-system for component lifecycle management
  • use-datalevin component for database connection (sets both :biff.datalevin/conn and :biff/db)
  • assoc-stop for registering cleanup functions
  • Biff compatibility: use-datalevin works as a drop-in component with Biff's start-system

• Database utilities (biff.datalevin.db)

  • Connection management with get-db, get-conn
  • assoc-db for refreshing :biff/db snapshot (matches Biff's pattern)
  • Transaction helpers with special values (:db/now, :db/uuid)
  • Query functions: q, lookup, lookup-all, lookup-id, entity-exists?
  • Entity operations: pull, pull-many, merge-tx, delete-tx

• Authentication (biff.datalevin.auth)

  • Password hashing with bcrypt (hash-password, verify-password)
  • User management (create-user-tx, authenticate-user, find-user-by-email)
  • GitHub OAuth integration (github-authorize-url, github-exchange-code, github-get-user)
  • Generic OAuth support (oauth-authorize-url, oauth-exchange-code)
  • Email verification tokens (create-verification-token, verify-token)

• Session management (biff.datalevin.session)

  • Datalevin-backed sessions (create-session, get-session, delete-session-tx)
  • JWT token support (create-session-token, verify-session-token)
  • Ring session store (datalevin-session-store)
  • Session cleanup utilities (cleanup-expired-sessions-tx)

• Middleware (biff.datalevin.middleware)

  • Authentication middleware (wrap-authentication, wrap-require-auth, wrap-require-role)
  • CSRF protection (wrap-csrf, csrf-token, csrf-input)
  • Composed middleware stacks (wrap-site-defaults, wrap-api-defaults)
  • Utility middleware (wrap-catch-exceptions, wrap-logging)

• Comprehensive test suite (50 tests, 195 assertions)

• Documentation with usage examples