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