v1.0.0-beta.232

openmeterio/openmeterv1.0.0-beta.232Aug 4, 2026by github-actions[bot]

AI Summary

Focuses on custom currency support across billing, invoices, and the ledger, alongside new v3 endpoints for invoices and app catalog management.

Key Highlights

  • Custom currency support for credits, charges, and ledger
  • New v3 Invoice API actions and App Catalog v3 endpoints
  • Security fix for streaming customer attribution map values

Breaking Changes

  • Adopt legacy Ent databases into Atlas migrations

New Features

  • Custom currency support for credits, charges, and ledger
  • New v3 Invoice API actions
  • App Catalog v3 endpoints (list, get by type, install, uninstall, update)
  • Scope credit grant idempotency key to customer

Full Release Notes

<!-- Release notes generated using configuration in .github/release.yml at v1.0.0-beta.232 -->

## What's Changed
### Security Fixes 🚨
* fix(streaming):  bind customer attribution map values by @chrisgacsal in https://github.com/openmeterio/openmeter/pull/4848
### Exciting New Features 🎉
* feat: default billing invoices to schema level 2 by @turip in https://github.com/openmeterio/openmeter/pull/4709
* feat: report overdue billing worker invoices by @turip in https://github.com/openmeterio/openmeter/pull/4710
* feat: v3 invoice api actions by @borosr in https://github.com/openmeterio/openmeter/pull/4671
* feat: app catalog v3 list, get by type and install app by @borosr in https://github.com/openmeterio/openmeter/pull/4658
* feat: scope credit grant idempotency key to customer by @tothandras in https://github.com/openmeterio/openmeter/pull/4716
* feat(api): remove unstable extensions from events, features and meters operations by @tothandras in https://github.com/openmeterio/openmeter/pull/4760
* feat: uninstall app v3 endpoint by @borosr in https://github.com/openmeterio/openmeter/pull/4759
* chore: charges add custom currency support by @turip in https://github.com/openmeterio/openmeter/pull/4755
* feat(charges): support custom currency credits-only charges by @turip in https://github.com/openmeterio/openmeter/pull/4769
* feat: add app update v3 endpoint by @borosr in https://github.com/openmeterio/openmeter/pull/4768
* feat(customcurrencies): support resolving costbases by @turip in https://github.com/openmeterio/openmeter/pull/4772
* feat(customcurrencies): support custom currency credit purchases by @turip in https://github.com/openmeterio/openmeter/pull/4773
* feat(customcurrencies): support usage-based credit then invoice by @turip in https://github.com/openmeterio/openmeter/pull/4780
* feat(customcurrencies): support flat fee credit then invoice by @turip in https://github.com/openmeterio/openmeter/pull/4794
* feat(customcurrencies): add configuration flag by @turip in https://github.com/openmeterio/openmeter/pull/4776
* feat(productcatalog): support custom currencies by @GAlexIHU in https://github.com/openmeterio/openmeter/pull/4738
* feat(ledger): add custom currencies support (credit_only) by @mark-vass-konghq in https://github.com/openmeterio/openmeter/pull/4731
* fix(ledger): nit comments from #4731 by @mark-vass-konghq in https://github.com/openmeterio/openmeter/pull/4839
### Bug Fixes 🐛
* fix(sdk): TypeSpec emitters by @tothandras in https://github.com/openmeterio/openmeter/pull/4719
* fix(sdk): handle nullable unions and browser headers by @tothandras in https://github.com/openmeterio/openmeter/pull/4722
* fix: reject invalid flat price usage discounts by @turip in https://github.com/openmeterio/openmeter/pull/4725
* fix(api): v3 TypeScript sdk datetime validation by @tothandras in https://github.com/openmeterio/openmeter/pull/4728
* chore: clean up gathering invoice detailed lines by @turip in https://github.com/openmeterio/openmeter/pull/3799
* fix(ledger): zero historical live balances by @GAlexIHU in https://github.com/openmeterio/openmeter/pull/4726
* fix(charges): persist fiat payment amounts by @turip in https://github.com/openmeterio/openmeter/pull/4779
* fix(usagebased): persist credits in CTI run details by @turip in https://github.com/openmeterio/openmeter/pull/4793
* fix(api/spec): typespec dependency update by @tothandras in https://github.com/openmeterio/openmeter/pull/4798
* fix(api/spec): set explicit rootDir for TypeScript 7 SDK build by @tothandras in https://github.com/openmeterio/openmeter/pull/4802
* fix(ledger): book advance attribution at purchase time by @GAlexIHU in https://github.com/openmeterio/openmeter/pull/4767
* fix: active entitlement validation blocking meter delete by @chrisgacsal in https://github.com/openmeterio/openmeter/pull/4835
* fix: meter delete in tx by @chrisgacsal in https://github.com/openmeterio/openmeter/pull/4838
* fix(billing): reject custom-currency manual charges by @GAlexIHU in https://github.com/openmeterio/openmeter/pull/4840
* fix(app/stripe): stop stripe webhook 500s on secret store failures by @tothandras in https://github.com/openmeterio/openmeter/pull/4828
* fix(entitlement): invalidate snapshots after reset by @GAlexIHU in https://github.com/openmeterio/openmeter/pull/4845
### Dependency Updates ⬆️
* chore(deps): bump golang from 1.26.4-alpine3.23 to 1.26.5-alpine3.23 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/4751
* chore(deps): bump the prometheus group across 2 directories with 1 update by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/4734
* chore(deps): bump github.com/go-co-op/gocron/v2 from 2.21.2 to 2.22.0 in /collector by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/4737
* chore(deps): bump cirello.io/pglock from 1.16.1 to 1.16.2 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/4713
* chore(deps): bump github.com/go-co-op/gocron/v2 from 2.21.2 to 2.22.0 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/4735
* chore(deps): bump golang.org/x/text from 0.39.0 to 0.40.0 in the golang group across 1 directory by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/4723
* chore(deps): bump the production-dependencies group across 1 directory with 2 updates by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/4696
* chore(deps): bump github.com/redpanda-data/connect/public/bundle/free/v4 from 4.98.0 to 4.99.0 in /collector in the benthos group across 1 directory by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/4697
* chore(deps): bump github.com/go-chi/chi/v5 from 5.3.0 to 5.3.1 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/4698
* chore: fix critical issue in tar npm package by @borosr in https://github.com/openmeterio/openmeter/pull/4766
* chore(deps): bump github.com/oapi-codegen/runtime from 1.4.2 to 1.5.0 in the oapi-codegen group across 1 directory by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/4761
* chore(deps): bump github.com/svix/svix-webhooks from 1.96.1 to 1.97.0 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/4778
* chore(deps): bump google.golang.org/grpc from 1.82.0 to 1.82.1 in /collector by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/4775
* chore(deps): bump the googlecloud group across 1 directory with 1 update by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/4777
* chore(deps): bump github.com/invopop/gobl from 0.502.1 to 0.503.0 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/4797
* chore(deps): bump the oapi-codegen group across 1 directory with 2 updates by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/4796
* chore(deps): bump github.com/lmittmann/tint from 1.1.3 to 1.2.0 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/4765
* chore(deps): bump github.com/XSAM/otelsql from 0.42.0 to 0.43.0 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/4763
* chore(deps): bump github.com/IBM/sarama from 1.50.3 to 1.60.0 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/4764
* chore(deps): bump github.com/go-logr/logr from 1.4.3 to 1.4.4 in /collector by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/4807
* chore(deps): bump github.com/oapi-codegen/oapi-codegen/v2 from 2.6.1-0.20260403235458-a76544bd16ff to 2.7.1 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/4743
* chore(deps): bump github.com/svix/svix-webhooks from 1.97.0 to 1.98.0 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/4805
* chore(deps): bump the prometheus group across 2 directories with 2 updates by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/4809
* chore(deps): bump the k8s group across 1 directory with 3 updates by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/4817
* chore(deps): bump github.com/svix/svix-webhooks from 1.98.0 to 1.99.0 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/4819
* chore(deps): bump go.opentelemetry.io/proto/otlp from 1.10.0 to 1.11.0 in the otel group across 1 directory by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/4818
* chore(deps): bump github.com/rickb777/period from 1.0.27 to 1.0.29 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/4806
* chore(deps): bump github.com/ThreeDotsLabs/watermill-kafka/v3 from 3.1.2 to 3.1.3 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/4825
* chore(deps): bump github.com/svix/svix-webhooks from 1.99.0 to 1.99.1 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/4824
* chore(deps): bump github.com/oklog/ulid/v2 from 2.1.1 to 2.1.2 in /e2e by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/4826
* chore(deps): bump the prometheus group across 2 directories with 1 update by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/4821
* chore(deps): bump github.com/go-openapi/inflect from 0.21.6 to 1.0.0 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/4804
* chore(deps): bump github.com/ClickHouse/ch-go from 0.73.0 to 0.74.0 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/4822
* chore(deps): bump github.com/oklog/ulid/v2 from 2.1.1 to 2.1.2 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/4823
* chore(deps): bump github.com/rickb777/period from 1.0.29 to 1.0.30 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/4841
### Other Changes
* feat: remove usage-based legacy realization statuses by @turip in https://github.com/openmeterio/openmeter/pull/4661
* refactor: currencyx package by @chrisgacsal in https://github.com/openmeterio/openmeter/pull/4701
* feat: writable unit_config on the v3 add-on API by @rolosp in https://github.com/openmeterio/openmeter/pull/4718
* feat: add gathering invoice line schema by @turip in https://github.com/openmeterio/openmeter/pull/4720
* feat: expose unit_config on the v3 invoice line rate card by @rolosp in https://github.com/openmeterio/openmeter/pull/4730
* feat: add bulk invoice schema migration function by @turip in https://github.com/openmeterio/openmeter/pull/4727
* refactor: currencies API by @chrisgacsal in https://github.com/openmeterio/openmeter/pull/4708
* refactor: currency code validation and helpers by @chrisgacsal in https://github.com/openmeterio/openmeter/pull/4757
* feat: add expand option to currency list api by @chrisgacsal in https://github.com/openmeterio/openmeter/pull/4771
* feat: bulk customer usage attribution lookup performance and correctness by @gergely-kurucz-konghq in https://github.com/openmeterio/openmeter/pull/4686
* refactor(flatfee): split invoice realization and run realization by @turip in https://github.com/openmeterio/openmeter/pull/4792
* refactor: agent utils by @GAlexIHU in https://github.com/openmeterio/openmeter/pull/4808
* feat: unit config conversion support for entitlements - OM-400 by @rolosp in https://github.com/openmeterio/openmeter/pull/4712
* feat(currencies): support cost_basis expand on list-currencies v3 endpoint by @borbelyr-kong in https://github.com/openmeterio/openmeter/pull/4781
* fix(dev): initialize CodeGraph in worktrees by @GAlexIHU in https://github.com/openmeterio/openmeter/pull/4815
* fix: if there is no billing cadence set allow construction and flow through validation by @rolosp in https://github.com/openmeterio/openmeter/pull/4816
* fix: add guard for unit config precision to avoid overflow/panic by @rolosp in https://github.com/openmeterio/openmeter/pull/4820
* fix: return only active costbasis for currency by @chrisgacsal in https://github.com/openmeterio/openmeter/pull/4837
* perf: make balance calculation linear in entitlement reset count by @tothandras in https://github.com/openmeterio/openmeter/pull/4827
* feat(credit): add usage snapshot schema by @GAlexIHU in https://github.com/openmeterio/openmeter/pull/4850


**Full Changelog**: https://github.com/openmeterio/openmeter/compare/v1.0.0-beta.231...v1.0.0-beta.232