v1.0.0-beta.234
openmeterio/openmeterv1.0.0-beta.234Sep 25, 2026by github-actions[bot]
Upgrading?
AI Summary
This beta release focuses on a comprehensive suite of v3 API endpoints for customer entitlements, including granular management of grants, values, and history. It also refactors the ledger to use provenance and includes various billing and subscription fixes.
Key Highlights
- Comprehensive v3 API for customer entitlements (create, list, get, delete, override, reset usage, grants)
- Refactor of ledger lineage to use provenance
- Bug fixes for billing workflow tax consistency and negative metered usage handling
Breaking Changes
- Refactor(ledger): replace collection lineage with provenance
New Features
- V3 create customer entitlement endpoint
- V3 customer entitlement history
- V3 get and list customer entitlement endpoints
- V3 reset customer entitlement usage endpoint
- Match grants against plan filters
- V3 delete customer entitlement endpoint
- V3 get and list entitlement endpoints
- V3 notification channels APIs
- V3 override customer entitlement endpoint
- V3 customer entitlement grants
- V3 customer entitlement value
- V3 grants for entitlements
- Customer entitlement value lookup by feature key
- Enforce billing workflow tax consistency
- Handle custom currency gathering previews
- Accept persisted charge validation issues
- Make validation issue classification explicit
- Make invoice deletion idempotent
- Clamp negative metered usage with warnings
- Require rate-card billing periods of at least 24 hours
- Handle negative usage in charge rating
- Reconcile subscription charge reference changes
- Tie-break view phase order by sort hint
- Publish system events through a transactional outbox
- Allow rate card currency changes in edits
- Backfill standard invoice line tax configs
- Consolidate v3 tax code config into Tax.TaxCodeConfig
- Add compatible credit filter storage
- Correct visibility annotations for subscription add-on
Full Release Notes
<!-- Release notes generated using configuration in .github/release.yml at v1.0.0-beta.234 --> ## What's Changed ### Exciting New Features π * feat(api): add v3 create customer entitlement endpoint by @borosr in https://github.com/openmeterio/openmeter/pull/5152 * feat(api): v3 customer entitlement history by @borosr in https://github.com/openmeterio/openmeter/pull/5186 * feat(api): add v3 get and list customer entitlement endpoints by @borosr in https://github.com/openmeterio/openmeter/pull/5160 * feat(api): add v3 reset customer entitlement usage endpoint by @borosr in https://github.com/openmeterio/openmeter/pull/5184 * feat(credits): match grants against plan filters by @GAlexIHU in https://github.com/openmeterio/openmeter/pull/5174 * feat(api): add v3 delete customer entitlement endpoint by @borosr in https://github.com/openmeterio/openmeter/pull/5178 * feat(api): add v3 get and list entitlement endpoints by @borosr in https://github.com/openmeterio/openmeter/pull/5193 * feat: notification channels v3 APIs by @borosr in https://github.com/openmeterio/openmeter/pull/4829 * feat(api): add v3 override customer entitlement endpoint by @borosr in https://github.com/openmeterio/openmeter/pull/5202 * Feat(api): v3 customer entitlement grants by @borosr in https://github.com/openmeterio/openmeter/pull/5192 * feat(api): v3 customer entitlement value by @borosr in https://github.com/openmeterio/openmeter/pull/5149 * feat(api): v3 grants for entitlmenets by @borosr in https://github.com/openmeterio/openmeter/pull/5206 * feat(api): add customer entitlement value lookup by feature key by @turip in https://github.com/openmeterio/openmeter/pull/5212 ### Bug Fixes π * feat(migrate): enforce billing workflow tax consistency by @turip in https://github.com/openmeterio/openmeter/pull/5165 * fix(billing): handle custom currency gathering previews by @turip in https://github.com/openmeterio/openmeter/pull/5167 * fix(billing): accept persisted charge validation issues by @turip in https://github.com/openmeterio/openmeter/pull/5168 * fix(billing): make validation issue classification explicit by @turip in https://github.com/openmeterio/openmeter/pull/5177 * fix(billing): make invoice deletion idempotent by @turip in https://github.com/openmeterio/openmeter/pull/5171 * fix(billing): clamp negative metered usage with warnings by @turip in https://github.com/openmeterio/openmeter/pull/5185 * fix(plan): reject warnings when updating scheduled plans by @turip in https://github.com/openmeterio/openmeter/pull/5190 * Require rate-card billing periods of at least 24 hours by @turip in https://github.com/openmeterio/openmeter/pull/5191 * fix(billing): handle negative usage in charge rating by @turip in https://github.com/openmeterio/openmeter/pull/5194 * fix(billing): reconcile subscription charge reference changes by @turip in https://github.com/openmeterio/openmeter/pull/5203 * fix(subscription): tie-break view phase order by sort hint by @GAlexIHU in https://github.com/openmeterio/openmeter/pull/5201 * fix(events): publish system events through a transactional outbox by @GAlexIHU in https://github.com/openmeterio/openmeter/pull/5200 * fix(subscription): allow rate card currency changes in edits by @GAlexIHU in https://github.com/openmeterio/openmeter/pull/5213 ### Breaking Changes π * refactor(ledger): replace collection lineage with provenance by @GAlexIHU in https://github.com/openmeterio/openmeter/pull/5085 ### Dependency Updates β¬οΈ * chore(deps): bump github.com/redpanda-data/benthos/v4 from 4.79.0 to 4.80.0 in /collector in the benthos group across 1 directory by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/5162 * chore(deps): bump go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp from 1.44.0 to 1.45.0 in /collector by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/5159 * chore(deps): bump sigs.k8s.io/controller-runtime from 0.25.0 to 0.25.1 in /collector by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/5169 * chore(deps): bump github.com/jackc/pgx/v5 from 5.10.0 to 5.11.0 in /e2e by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/5138 * chore(deps): bump golang.org/x/text from 0.41.0 to 0.42.0 in the golang group across 1 directory by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/5146 * chore(deps): bump github.com/invopop/gobl from 0.504.0 to 0.505.0 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/5155 * chore(deps): bump github.com/confluentinc/confluent-kafka-go/v2 from 2.15.0 to 2.15.1 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/5154 * chore(deps): bump github.com/XSAM/otelsql from 0.43.0 to 0.44.0 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/5131 * chore(deps): bump github.com/jackc/pgx/v5 from 5.10.0 to 5.11.0 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/5137 * chore(deps): bump github.com/golang-migrate/migrate/v4 from 4.19.1 to 4.20.1 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/5147 ### Other Changes * feat(migrate): backfill standard invoice line tax configs by @turip in https://github.com/openmeterio/openmeter/pull/5170 * refactor(api): consolidate v3 tax code config into Tax.TaxCodeConfig by @borbelyr-kong in https://github.com/openmeterio/openmeter/pull/5141 * refactor(ledger): add compatible credit filter storage by @GAlexIHU in https://github.com/openmeterio/openmeter/pull/5172 * feat: correct visibility annotations for subscription add-on create and list-apps by @rolosp in https://github.com/openmeterio/openmeter/pull/5179 * feat(api): add unstable, private and internal extensions to entitlements get endpoint by @borosr in https://github.com/openmeterio/openmeter/pull/5189 * refactor(ledger): backfill and read JSON credit filters by @GAlexIHU in https://github.com/openmeterio/openmeter/pull/5173 **Full Changelog**: https://github.com/openmeterio/openmeter/compare/v1.0.0-beta.233...v1.0.0-beta.234
Related Repositories
Get up and running with Kimi, GLM, MiniMax, DeepSeek, gpt-oss, Qwen, Gemma and other models.
A fast reverse proxy to help you expose a local server behind a NAT or firewall to the internet.
RAGFlow is a leading open-source Retrieval-Augmented Generation (RAG) engine that fuses cutting-edge RAG with Agent capabilities to create a superior context layer for LLMs
The worldβs fastest framework for building websites.
:cherry_blossom: A command-line fuzzy finder