v1.0.0-beta.222

openmeterio/openmeterv1.0.0-beta.222Sep 12, 2025by github-actions[bot]

AI Summary

Introduces Entitlement V2 APIs and establishes a subject-entitlement database linking, along with customer subject service hooks.

Key Highlights

  • Entitlement V2 APIs
  • Subject-entitlement database linking
  • Customer subject service hooks
  • Bug fixes for customer lookups and entitlements

Breaking Changes

  • Added customer to entitlement notification events

New Features

  • Entitlement v2 APIs
  • Subject-entitlement linking
  • Customer subject service hooks
  • Customer entitlement override status code fixes

Full Release Notes

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

## What's Changed
### Exciting New Features 🎉
* refactor(entitlement): subject-entitlement db linking by @GAlexIHU in https://github.com/openmeterio/openmeter/pull/3222
* refactor: customer subject service hooks by @chrisgacsal in https://github.com/openmeterio/openmeter/pull/3291
* feat: CustomerEntitlements by @GAlexIHU in https://github.com/openmeterio/openmeter/pull/3255
* feat(api): add root entitlement v2 APIs by @GAlexIHU in https://github.com/openmeterio/openmeter/pull/3372
* feat(api): include entitlements v2 methods in JavaScript SDK by @tothandras in https://github.com/openmeterio/openmeter/pull/3375
### Bug Fixes 🐛
* fix(stripe): app client error handling by @hekike in https://github.com/openmeterio/openmeter/pull/3271
* fix: customer lookup by usage attribution by @chrisgacsal in https://github.com/openmeterio/openmeter/pull/3292
* fix: breaking down migration by @GAlexIHU in https://github.com/openmeterio/openmeter/pull/3301
* fix(entitlement): fix upsertentitlementcurrentperiods by @GAlexIHU in https://github.com/openmeterio/openmeter/pull/3302
* chore: fix meter query validation errors by @turip in https://github.com/openmeterio/openmeter/pull/3310
* fix: subscription sync should save deleted invoices by @turip in https://github.com/openmeterio/openmeter/pull/3311
* fix: support time zoned monthly metered queries by @turip in https://github.com/openmeterio/openmeter/pull/3313
* fix(customer): check if customer has entitlements by @hekike in https://github.com/openmeterio/openmeter/pull/3319
* chore: fix missing nil check by @turip in https://github.com/openmeterio/openmeter/pull/3321
* fix(notification): fix payload type by @tothandras in https://github.com/openmeterio/openmeter/pull/3322
* chore: prevent deletion of customers/subjects with active entitlements by @turip in https://github.com/openmeterio/openmeter/pull/3324
* fix: missing usage attribution for deleted customer by @chrisgacsal in https://github.com/openmeterio/openmeter/pull/3327
* fix: check for deleted customer by @chrisgacsal in https://github.com/openmeterio/openmeter/pull/3337
* fix: upsert of stripe customer id by @chrisgacsal in https://github.com/openmeterio/openmeter/pull/3339
* fix: integration tests by @chrisgacsal in https://github.com/openmeterio/openmeter/pull/3345
* fix: customer subject hook init by @chrisgacsal in https://github.com/openmeterio/openmeter/pull/3347
* fix(entitlement/repo): properly resolve entitlement's customer's cust… by @GAlexIHU in https://github.com/openmeterio/openmeter/pull/3357
* fix(subscription-sync): allow calculating FullServicePeriod for zero-item at end of subscription by @GAlexIHU in https://github.com/openmeterio/openmeter/pull/3346
* fix(stripe): send invoice payment collection method with period due date by @hekike in https://github.com/openmeterio/openmeter/pull/3343
* fix: entitlement threshold validation by @chrisgacsal in https://github.com/openmeterio/openmeter/pull/3364
* fix: define custom type to be used instead of duration scalar by @GAlexIHU in https://github.com/openmeterio/openmeter/pull/3365
* fix: transaction handling by @chrisgacsal in https://github.com/openmeterio/openmeter/pull/3369
* fix: deletion of customer with active subscriptions by @chrisgacsal in https://github.com/openmeterio/openmeter/pull/3368
### Breaking Changes 🛠
* feat!: add customer to entitlement notification events by @chrisgacsal in https://github.com/openmeterio/openmeter/pull/3285
### Dependency Updates ⬆️
* chore(deps): bump github.com/ThreeDotsLabs/watermill-kafka/v3 from 3.0.6 to 3.1.0 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/3275
* chore(deps): bump github.com/svix/svix-webhooks from 1.73.0 to 1.75.0 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/3277
* chore(deps): bump github.com/google/wire from 0.6.0 to 0.7.0 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/3266
* chore(deps): bump google.golang.org/protobuf from 1.36.7 to 1.36.8 in the googlecloud group by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/3253
* chore(deps): bump github.com/ThreeDotsLabs/watermill from 1.4.7 to 1.5.0 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/3274
* chore(deps): bump entgo.io/ent from 0.14.5-0.20250325141242-9db6f4df431f to 0.14.5 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/3169
* chore(deps): bump github.com/getkin/kin-openapi from 0.132.0 to 0.133.0 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/3267
* chore(deps): bump sigs.k8s.io/controller-runtime from 0.21.0 to 0.22.0 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/3280
* chore(deps): bump github.com/huandu/go-sqlbuilder from 1.36.0 to 1.36.1 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/3281
* chore(deps): bump github.com/go-chi/chi/v5 from 5.2.2 to 5.2.3 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/3283
* chore(deps): bump github.com/stretchr/testify from 1.10.0 to 1.11.1 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/3278
* chore(deps): bump github.com/go-co-op/gocron/v2 from 2.16.3 to 2.16.4 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/3290
* chore(deps): bump github.com/IBM/sarama from 1.45.2 to 1.46.0 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/3265
* chore(deps): bump github.com/spf13/pflag from 1.0.7 to 1.0.9 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/3298
* chore(deps): bump golang from 1.25.0-alpine3.21 to 1.25.1-alpine3.21 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/3329
* chore(deps): bump github.com/svix/svix-webhooks from 1.75.0 to 1.76.1 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/3317
* chore(deps): bump github.com/samber/slog-multi from 1.4.1 to 1.5.0 in the samber group by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/3315
* chore(deps): bump github.com/go-co-op/gocron/v2 from 2.16.4 to 2.16.5 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/3308
* chore(deps): bump github.com/ThreeDotsLabs/watermill from 1.5.0 to 1.5.1 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/3305
* chore(deps): bump github.com/golang-migrate/migrate/v4 from 4.18.3 to 4.19.0 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/3300
* chore(deps): bump github.com/spf13/pflag from 1.0.9 to 1.0.10 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/3307
* chore(deps): bump the prometheus group across 1 directory with 2 updates by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/3316
* chore(deps): bump github.com/spf13/cobra from 1.9.1 to 1.10.1 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/3304
* chore(deps): bump the otel group across 1 directory with 16 updates by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/3306
* chore(deps): bump the k8s group with 3 updates by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/3362
* chore(deps): bump the golang group across 1 directory with 5 updates by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/3360
* chore(deps): bump github.com/XSAM/otelsql from 0.39.0 to 0.40.0 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/3355
* chore(deps): bump github.com/spf13/viper from 1.20.1 to 1.21.0 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/3354
* chore(deps): bump sigs.k8s.io/controller-runtime from 0.22.0 to 0.22.1 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/3352
* chore(deps): bump github.com/ThreeDotsLabs/watermill-kafka/v3 from 3.1.0 to 3.1.1 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/3351
* chore(deps): bump github.com/jackc/pgx/v5 from 5.7.5 to 5.7.6 by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/3353
* chore(deps): bump the redis group with 2 updates by @dependabot[bot] in https://github.com/openmeterio/openmeter/pull/3350
### Other Changes
* fix: tune subject manager cache by @turip in https://github.com/openmeterio/openmeter/pull/3312
* fix: rm new tx for immutable operations in subject service by @chrisgacsal in https://github.com/openmeterio/openmeter/pull/3335
* chore(api): remove x-internal tags from v2 entitlement endpoints by @tothandras in https://github.com/openmeterio/openmeter/pull/3358
* refactor: rm unnecessary validation by @chrisgacsal in https://github.com/openmeterio/openmeter/pull/3374


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