v0.17.1

River-Zhang/SIFUv0.17.1Jan 27, 2026by github-actions[bot]

AI Summary

Enhances the Better Auth plugin with organization support and introduces new React hooks and server actions for efficient usage meter balance retrieval.

Key Highlights

Organization support in Better Auth plugin using `session.activeOrganizationId`
New `useUsageMeters()` and `useUsageMeter()` React hooks
New `getUsageMeterBalances` server action
Optimized organization lookup and membership verification

New Features

Organization customer resolution in billing endpoints
External ID, billing, and usage meter endpoints
Dedicated usage meter hooks with automatic cache invalidation
Shared usage meter schema and action key

Full Release Notes


### Patch Changes

- 7170932: ### Better Auth Plugin Improvements

  - [790042dd](https://github.com/flowglad/flowglad/commit/790042dd): Rework Better Auth plugin with organization support

    - Organization customer resolution when `customerType="organization"` using `session.activeOrganizationId` (and adapter lookups) if no custom `getCustomer` is provided
    - Added `getExternalId`, `billing/pricing`, and `getUsageMeterBalances` endpoints integrated with Better Auth
    - Optimized organization lookup and added membership verification in billing endpoints for defense-in-depth
    - Expanded test coverage for endpoints, plugin behavior, and utilities
    - Updated example projects to use the plugin pattern and removed standalone `/api/flowglad` route requirement
    - Migration: Use `flowgladPlugin` in Better Auth and set `FlowgladProvider betterAuthBasePath="/api/auth"` in apps

  - [037f19e2](https://github.com/flowglad/flowglad/commit/037f19e2): Update Better Auth documentation and type annotations
    - Clarified external ID resolution using `session.session.userId` and `session.session.activeOrganizationId`
    - Added notes about customer auto-creation hooks behavior
    - Updated examples and troubleshooting documentation
    - Documented optional `baseURL` parameter

  ### Usage Meter Hooks

  - [3fd2a3ae](https://github.com/flowglad/flowglad/commit/3fd2a3ae): Add `useUsageMeters()` and `useUsageMeter()` hooks to `@flowglad/react`

    - Provides dedicated and efficient way to fetch usage meter balances without relying on the full billing payload
    - Wired `createUsageEvent` to invalidate caches for these new usage meter hooks, ensuring automatic refresh after usage events
    - Includes dev-mode support and comprehensive tests

  - [71fd192a](https://github.com/flowglad/flowglad/commit/71fd192a): Implement server-side integration for `GetUsageMeterBalances` action

    - Added `getUsageMeterBalances` to `FlowgladServer` to call the platform endpoint
    - Created and registered new subroute handler for `GetUsageMeterBalances`
    - Wired the new action into the Better Auth plugin for authentication and authorization
    - Includes comprehensive tests for the new handler and updated auth mappings

  - [9dcbf5eb](https://github.com/flowglad/flowglad/commit/9dcbf5eb): Add shared usage meter schema and action key
    - Introduced new authenticated action key (`usage-meters/balances`) and Zod schema in the shared SDK
    - Enables dedicated, narrow endpoint for fetching usage meter balances
    - Decouples usage meter reads from the larger `GetCustomerBilling` payload
    - Includes comprehensive tests for the new schema and action validator

- Updated dependencies [7170932]
  - @flowglad/shared@0.17.1