v0.16.4

Wan-Video/Wan2.2v0.16.4Jan 18, 2026by github-actions[bot]

AI Summary

This release prepares the SDK for future pricing developments by renaming internal structures from 'Catalog' to 'PricingModel' while maintaining backward compatibility through deprecation warnings. It also improves type safety for usage meter prices.

Key Highlights

  • Upgraded `@flowglad/node` to version 0.29.0 for improved type safety.
  • Renamed `Catalog` to `PricingModel` across shared utilities and React hooks.
  • Added deprecated aliases (`useCatalog`, `Catalog`) for backward compatibility.
  • Updated documentation to reflect new pricing terminology.

New Features

  • Node.js package upgrade
  • Catalog to PricingModel migration
  • Backward-compatible deprecated aliases
  • Improved type safety for usage meters

Full Release Notes


### Patch Changes

- e4cc2c6: ### Upgrade to @flowglad/node 0.29.0

  - [f3249ae8](https://github.com/flowglad/flowglad/commit/f3249ae8): Bump @flowglad/node from 0.28.0 to 0.29.0 across all packages
    - Adds proper typing for `UsageMeter.prices` field in the SDK
    - Removes the need for type cast workarounds when accessing usage meter prices

  ### Catalog → PricingModel Migration

  - [275550da](https://github.com/flowglad/flowglad/commit/275550da): Rename `catalog` to `pricingModel` in shared utilities

    - `constructGetProduct`, `constructGetPrice`, and `constructHasPurchased` now accept `pricingModel` parameter
    - Type safety improvements by removing `UsageMeterWithPrices` cast workaround

  - [17792466](https://github.com/flowglad/flowglad/commit/17792466): Replace `catalog` with `pricingModel` across packages

    - `@flowglad/react`: `useCatalog` hook renamed to `usePricingModel`
    - `@flowglad/server`: Updated `FlowgladServer` to use `pricingModel` internally
    - `@flowglad/shared`: Renamed `types/catalog.ts` to `types/pricingModel.ts`, `Catalog` type renamed to `PricingModel`
    - Documentation updated to reflect new naming

  - [ddaa0fca](https://github.com/flowglad/flowglad/commit/ddaa0fca): Add deprecated aliases for backward compatibility
    - `Catalog` type alias (deprecated, use `PricingModel`)
    - `useCatalog` hook (deprecated, use `usePricingModel`)
    - `catalog` property remains available in billing context (deprecated, use `pricingModel`)

  ## Migration Guide

  ### Hook Migration

  **Before:**

  ```typescript
  import { useCatalog } from "@flowglad/react";
  const catalog = useCatalog();
  ```

  **After:**

  ```typescript
  import { usePricingModel } from "@flowglad/react";
  const pricingModel = usePricingModel();
  ```

  ### Type Migration

  **Before:**

  ```typescript
  import type { Catalog } from "@flowglad/shared";
  ```

  **After:**

  ```typescript
  import type { PricingModel } from "@flowglad/shared";
  ```

  ## Breaking Changes

  ⚠️ **None** - All changes include backward-compatible deprecated aliases. The `catalog` property, `useCatalog` hook, and `Catalog` type continue to work but are marked as deprecated. Users are encouraged to migrate to the new `pricingModel` naming.

- Updated dependencies [e4cc2c6]
  - @flowglad/shared@0.16.4