v1.0.0-beta.233

What's Changed

Exciting New Features 🎉

• fix(billing): [OM-434] delete empty custom-currency overage lines by @turip in #4843
• fix(billing): [OM-434] delete empty invoices during issuing by @turip in #4849
• feat: add usage quantity detail to surface unit config on invoices api - OM-410 by @rolosp in #4858
• feat(customcurrency): materialize subscription item currencies by @GAlexIHU in #4742
• feat: separate fiat overage credit realizations from charge currency allocations by @turip in #4857
• feat: persist amount discounts on charge run detailed lines by @turip in #4869
• feat(kafka): add rackId for kafka consumers by @mark-vass-konghq in #4872
• feat: add db support for credit purchase costbasis pinning by @turip in #4870
• feat(charges): add backend customer charge deletion by @turip in #4887
• feat(charges): add backend customer charge override set by @turip in #4888
• feat(charges): add backend customer charge override clear by @turip in #4889
• feat(customcurrency): support custom currency subscriptions by @GAlexIHU in #4744
• feat(creditpurchase): resolve cost basis before realization by @turip in #4918
• feat(billing): finalize invoice lines before issuing by @turip in #4930
• feat(billing): settle custom-currency overages with fiat credits by @turip in #4925
• feat(flatfee): settle custom currency overage with fiat credits by @turip in #4935
• feat: extended subscription response body by @rolosp in #4929
• feat(charges): persist usage-based run immutability by @turip in #4998
• feat(charges): persist usage run lineage by @turip in #5003
• feat(billing): support unit config on v3 charges by @turip in #5016
• feat: Spend API (charges list endpoint) by @borosr in #4810
• feat(charges): support custom currencies in charges flat fee by @borosr in #5052
• feat(ledger): label voided funded transactions by @GAlexIHU in #5061
• feat: support inline plans on subscriptions by @rolosp in #5055
• feat: v3 credit grant purchase custom currency support by @borosr in #5067
• feat(api): expose billing validation issues by @turip in #5089
• feat(ledger): support custom currency balance history by @GAlexIHU in #5081
• feat(billing): gate gathering line invoice assignment by @turip in #5090
• feat(billing): gate usage invoice assignment by @turip in #5096
• feat(subscription): enable custom currency billing by @GAlexIHU in #5091
• feat(subscription): migrate plan versions in place by @GAlexIHU in #5102
• feat: global spend api by @borosr in #5134
• feat(api): expose subscription migration in v3 by @GAlexIHU in #5135
• feat(api): entitlement access value v3 api by @borosr in #5143

Bug Fixes 🐛

• fix(ledger): guard custom currency charge payments by @turip in #4853
• fix: validate charge patches by service period by @turip in #4868
• fix: preserve invoice backend for zero-amount artifacts by @turip in #4863
• fix(billing): retain non-zero overage lines settled via credits by @turip in #4882
• fix: add charge discount correlation IDs by @turip in #4890
• fix(billing): repair persisted charge discount IDs by @turip in #4892
• fix(subscription): preserve item JSON fields by @GAlexIHU in #4901
• fix(subscription): correct spec path JSON by @GAlexIHU in #4908
• fix(billing): return minimal invoice advancement targets by @turip in #4923
• fix(entitlements): honor query params when listing customer entitlement grants by @liormechlovich-kong in #4921
• fix(app): prevent uninstall of apps required by billing by @turip in #4924
• fix(app): preserve deleted workflow apps by @turip in #4932
• fix: feature reference for plan/addon ratecards by @chrisgacsal in #4934
• fix(entitlement): preserve grant usage across balance snapshots by @GAlexIHU in #4846
• fix(subscription): allow free plan currency mismatch by @GAlexIHU in #4954
• feat(productcatalog): enforce rate card feature references by @chrisgacsal in #4956
• fix(api): surface rate card price errors as user-serviceable by @tothandras in #4979
• fix(taxcode): drop duplicated required-ID check from the v3 converter by @tothandras in #4980
• fix(api): let domain validation own the metered entitlement usage period by @tothandras in #4981
• Fix/err data race in invoice collector by @LucLabarriere in #4946
• fix: repair distributed locks after Ent adoption by @turip in #4996
• fix(entitlement): validate namespace ownership on writes by @GAlexIHU in #4995
• fix(sink): handling partition assignment updates by @chrisgacsal in #4994
• fix(billing): register the custom invoicing app in the jobs binary by @iskron in #5004
• fix(productcatalog): make PUT /plans/{planId} replace omitted fields by @tothandras in #4967
• fix(charges): backfill immutable usage-based runs by @turip in #5002
• fix(charges): reconcile custom currency invoice preparation by @turip in #5001
• fix(billing): persist invoices with collection validation issues by @turip in #5029
• fix(billing): optimize worker database queries by @turip in #5037
• fix(subscription): validate custom rate card features by @turip in #5038
• fix(ledger): preserve fiat credit purchase units by @GAlexIHU in #5054
• fix(api): handle billing errors in customer endpoints by @turip in #5058
• fix(ledger): [OM-494] reconstruct credit transaction history by @GAlexIHU in #5040
• feat(ledger): support custom currency credit then invoice by @GAlexIHU in #4914
• fix(api): billing profile update by @tothandras in #5077
• fix(credits): preserve purchase and correction accounting by @GAlexIHU in #5083
• fix(ci): allow local Go cache for fork pull requests by @turip in #5098
• fix(llmcost): order namespace DESC NULLS LAST in ResolvePrice (#4562) by @Tyagiquamar in #5084
• fix(ledger): backfill advances in collection order by @GAlexIHU in #5092
• fix(ledger): preserve source attribution in earnings lineage by @GAlexIHU in #5100
• fix(customer): improve customer billing endpoint error handling by @borbelyr-kong in #5099
• fix(billing): defer usage feature pinning until activation by @turip in #5108
• fix(api): serialize empty addon rate cards as [] instead of null by @borbelyr-kong in #5110
• test(billing): reproduce DLQ validation failures by @turip in #5109
• fix(billing): skip rating unresolved features by @turip in #5115
• fix(billing): ignore invoice at on standard lines by @turip in #5116
• fix(billing): defer legacy feature validation by @turip in #5119
• fix(sink): batch Redis deduplication checks by @turip in #5123
• fix(billing): gate usage charges on feature meter readiness by @turip in #5126
• fix(billing): repair invalid created usage charges by @turip in #5129
• fix(billing): persist subscription charge feature issues by @turip in #5130
• fix(api): hide custom-currency subscriptions from v1 by @GAlexIHU in #5139
• fix(billing): repair charge subscription references by @turip in #5142

Dependency Updates ⬆️

• chore(deps): bump github.com/redpanda-data/connect/public/bundle/free/v4 from 4.99.0 to 4.101.0 in /collector in the benthos group across 1 directory by @dependabot[bot] in #4795
• chore(deps): bump github.com/ThreeDotsLabs/watermill-kafka/v3 from 3.1.3 to 3.1.4 by @dependabot[bot] in #4866
• chore(deps): bump the googlecloud group across 2 directories with 1 update by @dependabot[bot] in #4864
• chore(deps): bump github.com/redpanda-data/benthos/v4 from 4.76.0 to 4.77.0 in /collector in the benthos group across 1 directory by @dependabot[bot] in #4865
• chore(deps): bump github.com/IBM/sarama from 1.60.0 to 1.60.1 by @dependabot[bot] in #4867
• chore(deps): bump github.com/redpanda-data/connect/public/bundle/free/v4 from 4.101.0 to 4.103.0 in /collector in the benthos group across 1 directory by @dependabot[bot] in #4875
• chore(deps): bump github.com/go-git/go-git/v5 from 5.19.1 to 5.19.2 in /collector by @dependabot[bot] in #4898
• chore(deps): bump github.com/redpanda-data/connect/public/bundle/free/v4 from 4.103.0 to 4.103.1 in /collector in the benthos group across 1 directory by @dependabot[bot] in #4899
• chore(deps): bump github.com/getkin/kin-openapi from 0.145.0 to 0.146.0 by @dependabot[bot] in #4900
• chore(deps): bump the redis group across 1 directory with 2 updates by @dependabot[bot] in #4912
• chore(deps): bump github.com/ClickHouse/clickhouse-go/v2 from 2.47.0 to 2.48.0 by @dependabot[bot] in #4913
• chore(deps): bump the googlecloud group across 2 directories with 1 update by @dependabot[bot] in #4955
• chore(deps): bump github.com/stretchr/testify from 1.11.1 to 1.12.0 in /e2e by @dependabot[bot] in #4948
• chore(deps): bump github.com/redpanda-data/connect/public/bundle/free/v4 from 4.103.1 to 4.104.0 in /collector in the benthos group across 1 directory by @dependabot[bot] in #4937
• chore(deps): bump github.com/stretchr/testify from 1.11.1 to 1.12.0 by @dependabot[bot] in #4947
• chore(deps): bump github.com/invopop/gobl from 0.503.0 to 0.504.0 by @dependabot[bot] in #4928
• chore(deps): bump golang from 1.26.5-alpine3.23 to 1.26.6-alpine3.23 by @dependabot[bot] in #4982
• chore(deps): bump golang.org/x/text from 0.40.0 to 0.41.0 in the golang group across 1 directory by @dependabot[bot] in #4962
• chore(deps): bump github.com/redpanda-data/connect/public/bundle/free/v4 from 4.104.0 to 4.105.0 in /collector in the benthos group across 1 directory by @dependabot[bot] in #4965
• chore(deps): bump github.com/oapi-codegen/runtime from 1.6.0 to 1.7.0 in the oapi-codegen group across 1 directory by @dependabot[bot] in #4989
• chore(deps): bump github.com/stretchr/testify from 1.12.0 to 1.12.1 in /e2e by @dependabot[bot] in #4991
• chore(deps): bump github.com/stretchr/testify from 1.12.0 to 1.12.1 by @dependabot[bot] in #4990
• chore(deps): bump the googlecloud group across 2 directories with 1 update by @dependabot[bot] in #5011
• chore(deps): bump github.com/getkin/kin-openapi from 0.146.0 to 0.147.0 by @dependabot[bot] in #5012
• chore(deps): bump the otel group across 1 directory with 15 updates by @dependabot[bot] in #4919
• chore(deps): bump github.com/go-chi/chi/v5 from 5.3.1 to 5.3.2 by @dependabot[bot] in #5015
• chore: bump node version in nix to v26.8.1 by @borosr in #5025
• chore(deps): bump github.com/IBM/sarama from 1.60.1 to 1.60.2 by @dependabot[bot] in #5027
• chore(deps): bump github.com/huandu/go-sqlbuilder from 1.42.1 to 1.43.0 by @dependabot[bot] in #5026
• chore(deps): bump the benthos group across 1 directory with 2 updates by @dependabot[bot] in #5019
• chore(deps): bump the k8s group across 1 directory with 3 updates by @dependabot[bot] in #5018
• chore(deps): bump github.com/ThreeDotsLabs/watermill from 1.5.2 to 1.5.3 by @dependabot[bot] in #5049
• chore(deps): bump github.com/rickb777/period from 1.0.30 to 1.0.32 by @dependabot[bot] in #5048
• chore(deps): bump the googlecloud group across 2 directories with 1 update by @dependabot[bot] in #5046
• chore(deps): bump golang from 1.26.6-alpine3.23 to 1.27.0-alpine3.23 by @dependabot[bot] in #5021
• chore(deps-dev): bump orval from 8.15.0 to 8.26.0 in /api/client/javascript by @dependabot[bot] in #5056
• chore(deps): bump the otel group across 1 directory with 15 updates by @dependabot[bot] in #5053
• chore(deps): bump golang from 1.27.0-alpine3.23 to 1.27.1-alpine3.23 by @dependabot[bot] in #5087
• chore(deps): bump github.com/redpanda-data/connect/public/bundle/free/v4 from 4.106.0 to 4.107.0 in /collector in the benthos group across 1 directory by @dependabot[bot] in #5079
• chore(deps): bump github.com/rabbitmq/amqp091-go from 1.10.0 to 1.13.0 in /collector by @dependabot[bot] in #5075
• chore(deps): bump the k8s group across 1 directory with 2 updates by @dependabot[bot] in #5059
• chore(deps): bump the prometheus group across 2 directories with 2 updates by @dependabot[bot] in #5094
• chore(deps): bump github.com/getkin/kin-openapi from 0.147.0 to 0.149.0 by @dependabot[bot] in #5080
• chore(deps): bump github.com/redpanda-data/connect/public/bundle/free/v4 from 4.107.0 to 4.107.2 in /collector in the benthos group across 1 directory by @dependabot[bot] in #5104
• chore(deps): bump the golang group across 2 directories with 1 update by @dependabot[bot] in #5103
• chore(deps): bump github.com/rickb777/period from 1.0.32 to 1.1.0 by @dependabot[bot] in #5132
• chore(deps): bump sigs.k8s.io/controller-runtime from 0.24.1 to 0.25.0 in /collector by @dependabot[bot] in #5121
• chore(deps): bump github.com/redpanda-data/benthos/v4 from 4.78.0 to 4.79.0 in /collector in the benthos group across 1 directory by @dependabot[bot] in #5120
• chore(deps-dev): bump vitest from 4.1.8 to 4.1.11 in /api/client/javascript by @dependabot[bot] in #5114
• chore(deps): bump github.com/redpanda-data/connect/public/bundle/free/v4 from 4.107.2 to 4.108.0 in /collector in the benthos group across 1 directory by @dependabot[bot] in #5136

Other Changes

• refactor: JSON_VALUE in clickhouse query by @chrisgacsal in #4852
• refactor: use feature id instead of feature key at charges create by @borosr in #4851
• refactor(credit): model invoice purchases with state machine by @turip in #4859
• refactor(credit): migrate invoice purchase statuses by @turip in #4860
• refactor(credit): migrate external purchase statuses by @turip in #4862
• refactor(credit): move purchase valuation and lifecycle to line engine by @turip in #4861
• feat: backfill credit purchases to cost basis schema level 2 by @turip in #4871
• fix: fix late review comments for costbasis change by @turip in #4883
• refactor: remove credit purchase schema level 1 compatibility by @turip in #4881
• fix: validate billing feature references by @turip in #4897
• refactor(credit): simplify grant prioritization by @GAlexIHU in #4904
• refactor(ledger): deduplicate route queries by @GAlexIHU in #4907
• feat: strengthen namespace validate by @turip in #4905
• feat(customcurrency): backfill subscription items with currency by @chrisgacsal in #4895
• refactor: service hooks by @chrisgacsal in #4880
• fix: add private and internal extensions to the void-credit-grant by @borosr in #4910
• refactor(charges): make state machine invoice effects explicit by @turip in #4886
• refactor: split get*subscription calls by @turip in #4748
• docs: improve OSS README by @GAlexIHU in #4915
• refactor: move quantity snapshotting to line engine by @turip in #4749
• chore(devenv): share Go module cache by @GAlexIHU in #4931
• feat: expose feature_id and feature_key on the charges search view by @borosr in #4938
• refactor(entitlement-access): rename governance to entitlement access [OM-467] by @gergely-kurucz-konghq in #4926
• feat: export the feature API converter for cross-handler reuse by @borosr in #4949
• refactor: make subscription sync invoice line updates explicit by @turip in #4939
• fix: v3 api contract fixes by @borosr in #5000
• refactor(productcatalog): use feature references for rate cards by @chrisgacsal in #4960
• feat(charges): backfill usage run lineage by @turip in #5008
• feat(charges): require usage run lineage schema level 2 by @turip in #5013
• feat(ingest): observe events per request by @chrisgacsal in #5014
• fix(customer): improve conflict error diagnostics by @turip in #5041
• feat(ingest): set explicit buckets on the request event count histogram by @gergely-kurucz-konghq in #5043
• chore(deps): ignore ariga.io/atlas updates by @turip in #5044
• feat(billing): add validation message wrapper by @turip in #5062
• refactor(billing): evolve feature meter resolution by @turip in #5063
• refactor(billing): make billability result explicit by @turip in #5076
• feat: v3 edit subscription by @rolosp in #5031
• feat(billing): persist charge validation issues by @turip in #5086
• feat: support id and name filters, together with sort at billing profile search by @borosr in #5095
• fix(e2e): stabilize multi-subject usage aggregation by @turip in #5101
• refactor(billing): move billability into line engines by @turip in #5082
• V3 subscription API fixes for the subscription UI flow by @rolosp in #5107
• feat: subscription v3 scheduling endpoints by @rolosp in #5117
• refactor(billing): scope feature meter bypass to lines by @turip in #5122
• feat(app_stripe): add webhook_schema_version column to app stripe table, adjust the webhook types by @borosr in #5124
• fix: make sub addon update and sub unschedule/restore internal by @rolosp in #5140
• fix(billing): repair charge line subscription references by @turip in #5145
• feat(migrate): backfill tax code config on billing workflow configs by @borbelyr-kong in #5148
• feat(migrate): backfill add-on tax configs by @turip in #5150
• feat(migrate): backfill plan tax configs by @turip in #5153
• feat: expose settlement mode on v3 plan api by @rolosp in #5151
• feat(migrate): backfill subscription tax configs by @turip in #5157

New Contributors

• @liormechlovich-kong made their first contribution in #4921
• @LucLabarriere made their first contribution in #4946
• @iskron made their first contribution in #5004
• @Tyagiquamar made their first contribution in #5084

Full Changelog: v1.0.0-beta.232...v1.0.0-beta.233