Skip to main content
Introducing packages.sweber.dev
All posts
Release1 min read

Logarithm 0.8.0 released

The API is frozen ahead of 1.0. Eight undocumented helpers left the public exports, and the docs now say exactly what the compatibility promise covers.

By Seya Weber

Logarithm 0.8.0 is out on npm as @sweberdev/logarithm and @sweberdev/logarithm-react, with provenance. The Pro packages stay at 0.9.1. This is the API freeze before 1.0.

What changed

The helpers that 0.6.0 marked as deprecated are no longer exported: DEFAULT_LIMIT, MAX_LIMIT, encodeCursor, decodeCursor, toStoreQuery, toStoreFilter and sortGroups from the core package, and relativeTime from the React package. They were internals that slipped into the exports. Nothing that the documentation describes has changed, so if your code only uses documented functions, you do not need to change anything. If an import breaks, you were using one of the eight; open an issue and tell us what you need it for.

What the 1.0 promise will cover

The API reference has a new Stability section. From 1.0, Logarithm follows semantic versioning for:

  • everything in the API reference, the AuditStore interface and the types it uses,
  • the parameters and responses of the HTTP endpoint and the props of the React components,
  • the table layout, through the schema version introduced in 0.6.0: a change is a new version with a migration, never a silent edit,
  • the CSS custom properties (--lg-*) and the data-theme attribute.

It does not cover the lg-* class names inside the viewer, the wording of error messages or of the built-in labels. Deprecations are announced one minor version ahead.

Update

pnpm add @sweberdev/logarithm@latest @sweberdev/logarithm-react@latest

Logarithm is on the package page.

Package in this post

Logarithm

A self-hosted audit log for SaaS apps: who changed what, and when. Field-level diffs in your own Postgres or SQLite, and a ready React view for your customers' admins.

pnpm add @sweberdev/logarithm @sweberdev/logarithm-react
View package

Related posts

Release

Logarithm 1.0 released

The self-hosted audit log for SaaS apps is stable. A frozen API, a verified accessible viewer, a 10 million event load test, a security review and tamper evidence with independently checkable timestamps.

Logarithm
Release

Logarithm 0.5.0 released

A conformance suite so your own audit-log store behaves exactly like the built-in ones, a verified WCAG AA contrast for the viewer, and new guides for migrations, Drizzle and Prisma.

Logarithm
Release

Logarithm 0.6.0 released

The table layout gets a version number, so a rollback can no longer run old code against a newer table. Plus framework recipes, a security chapter and timings from a 10 million event load test.

Logarithm