Packages

@pinia/colada

1.4.9 · 30 Oct 2026MIT207.8k / weekRepositoryHomepagenpmAtom feed

Your version

83 stable releases, newest first, by release line. Notes are quoted as the maintainers published them.

  1. 1.x · latest line
  2. 1.4.9

    30 Oct 2026
    • devtools: Copy values as JSON

    • Abort in-flight queries with data on unmount

    • nuxt: Preserve query cache for SSR head

  3. 1.4.8

    8 Oct 2026
    • Preserve replacement entries during stale GC

    • define-query: Keep defined query state per app

  4. 1.4.7

    2 Oct 2026
    • Warn when removing active query entries

    • Avoid cancelling a non-ensured entry

    • Move every defineQuery consumer to the new entry when its key changes

  5. 1.4.6

    23 Sep 2026
    • Discard gced old entries with defineQuery

    • Skip onError for cancelled fetches in query hooks plugin

    • auto-refetch: Skip refetch when staleTime is not finite

  6. 1.4.5

    16 Sep 2026
    • Use devframe's in-page channel

    • Mcp integration

    • Better autoscroll for colllapsables

  7. 1.4.4

    2 Sep 2026
    • Update variables on initial mutation

  8. 1.4.3

    31 Aug 2026
    • Compat nuxt 5

    • persistence: Preserve date

    • types: Avoid types pollution

  9. 1.4.2

    15 Jul 2026
    • Keep asyncStatus loading when canceled request settles after refetch

  10. 1.4.1

    15 Jul 2026
    • Support pinia 4

  11. 1.4.0

    14 Jul 2026
    • Drag button devtools

    • Subtle rotation animation in devtools button

    • Nostics migration

  12. 1.3.1

    20 May 2026
    • Reset when if a retry is canceled

    • infinite-query: Store nextPageIndicator on entry.ext instead of closure

  13. 1.3.0

    8 May 2026
    • Add PiniaColadaSSRNoGc plugin

  14. 1.2.1

    28 Apr 2026
    • cache-persister: Await captured promise on async restore

    • hmr: Avoid cancelling in-flight requests on remount

    • hmr: Key __hmr snapshots by __hmrId

  15. 1.2.0

    17 Apr 2026
    • Add entry to UseMutationGlobalContext

    • Add defineMutationOptions for type-safe reusable mutation options

    • Add tagged key type to defineMutationOptions

  16. 1.1.0

    31 Mar 2026
    • Add meta support to mutations

    • delay: Add mutation support

    • Update entry options on ensure early return

  17. 1.0.0

    6 Mar 2026
    • Breaking

      Remove deprecated two-parameter overloads from useQuery and useQueryState

    • tanstack-compat: Make augmented type properties optional

    • tanstack-compat: Emit .d.ts to .tsc-types instead of src

  18. 0.21.x
  19. 0.21.7

    2 Mar 2026
    • infinite: Detach $onAction listener to survive component unmount

  20. 0.21.6

    26 Feb 2026
    • Use debug instead of log

    • devtools: Surface retry plugin info in devtools plugins panel

    • Clamp devtools height to minimum when reading from localStorage

  21. 0.21.5

    22 Feb 2026
    • Deprecated

      The two-parameter form of useQuery(setup, () => params) and useQueryState(setup, () => params) is deprecated. Use a single function parameter instead:

      - useQuery(useContactList, () => ({ search: search.value }))
      + useQuery(() => useContactList({ search: search.value }))

      A codemod is available to automate this migration. Commit your changes first, then run:

      pnpm --package=@ast-grep/cli dlx ast-grep scan -r node_modules/@pinia/colada/codemods/rules/migration-0-21-to-1-0.yaml -i src

      See Migration Codemods for details.

    • Improve hover titel

    • Pass previousEntry in placeholderData

  22. 0.21.4

    9 Feb 2026
    • Plugin support for mutations

  23. 0.21.3

    6 Feb 2026
    • Add more auto imports

    • Skip refetchOnWindowFocus and refetchOnReconnect for inactive defined queries

    • infinite-query: Compute hasNextPage correctly on cache hit

  24. 0.21.2

    20 Jan 2026
    • Respect enabled option during retry delays

    • Correct GC time display for prefetched queries

    • Distinguish refetch and invalidate behavior in devtools

  25. 0.21.1

    9 Jan 2026
    • Make ext readonly

    • Avoid extra tick

    • Only persist success

  26. 0.21.0

    6 Jan 2026
    • Breaking

      Remove @vue/devtools-api dependencies

    • Breaking

      Remove CJS support

    • Add number of queries/mutations to tabs

  27. 0.20.x
  28. 0.20.0

    23 Dec 2025
    • Breaking

      Remove devtools from production builds

    • Breaking

      The merge option has been removed and data contains an object with pages and pageParams arrays that can be flattened.

    • Breaking

      initialPage has now been replaced with initialPageParam

  29. 0.19.x
  30. 0.19.1

    17 Dec 2025
    • Warns if the user extends in create instead of ext

    • Thiner scrollbar

    • InitialDataUpdatedAt

  31. 0.19.0

    16 Dec 2025
    • Breaking

      mutations: Keep mutations key as passed

    • Message of missing query key

    • Display date for anonymous mutations

  32. 0.18.x
  33. 0.18.1

    11 Dec 2025
    • query: Add meta

    • Add hydrated data to queries

    • Set updatedAt based on entry.when

  34. 0.18.0

    2 Dec 2025
    • Breaking

      While technically a fix, this is a breaking change if you were relying on an external signal that aborts within the query. It used to not set the state by just being an AbortError DomException and now it will become an error. This behavior is more correct as we don't want to ignore aborted signals that are external. Each fetch creates an AbortController and passes the signal to query which is aborted (without a reason) if any other method of the store fetches again. This is done to avoid using an outdated request.

    • query: preserve any external AbortError

  35. 0.17.x
  36. 0.17.9

    24 Nov 2025
    • Export mutation cache

    • Expose mutation cache

    • Warn wrong useMutationcache usage

  37. 0.17.8

    7 Nov 2025
    • Allow passing extra options to defineQueryOptions

    • types: allow interfaces in keys (19ab616), closes #420

  38. 0.17.7

    30 Oct 2025
    • Export toCacheKey

    • query: abort signal if query becomes inactive

    • Avoid watched on enabled

  39. 0.17.6

    25 Sep 2025
    • Improve type of DefineQueryOptions

    • Make type inference of DefineQueryOptions.placeholderData correct

  40. 0.17.5

    11 Sep 2025
    • query: add overloaded for optional define options params

  41. 0.17.4

    9 Sep 2025
  42. 0.17.3

    1 Sep 2025
    • Add ssrCatchError

  43. 0.17.2

    25 Aug 2025
    • Expose internal method to plugins

    • Allow initial fetch with refetchOnMount false and placeholderData

    • Always propagate errors (9268b37), closes #371

  44. 0.17.1

    13 Jun 2025
    • Avoid uncaught error in defineQuery (3037012), closes #312

  45. 0.17.0

    3 Jun 2025
    • Breaking

      Replace EntryNodeKey with EntryKey

    • Breaking

      types: The EntryKeyTagged type now has multiple type params and an array is no longer assignable to it. This is necessary to correctly infer the types for TData and TDataInitial and if you were manually using EntryKeyTagged, you will either need to cast arrays to it or use EntryKey instead. In most cases this should not affect you. This makes types stricter and also disallows setting a query data to undefined. If you were doing queryCache.setQueryData(key, undefined), use queryCache.setEntryState instead.

    • Removed

      Remove deprecated EntryNodeKey

  46. 0.16.x
  47. 0.16.1

    22 May 2025
    • ssr: make when relative to work across timezones (43b4f7d), closes #293

  48. 0.16.0

    21 May 2025
    • Breaking

      query: queryCache.invalidateQueries() now accepts a second parameter to control whether to refetch or not active queries. It can be set to 'all' to force fetch all queries. This replaces the existing behavior of passing active: null (can be removed now) which wasn't actually working. You shouldn't be negatively affected by this change as it wasn't working previously.

    • Breaking

      The internal cache structure has been refactored to be simpler, faster and smaller. Keys now support deeply nested objects and partially matches them when filtering (e.g. queryCache.getEntries()). To achieve this, the hydrated version of the cache has changed. serializeTreeMap has been removed but serializeQueryCache (which should be preferred) has been kept. EntryNodeKey and TreeMapNode (internals) have been removed. EntryNodeKey was just string | number. toCacheKey has been adapted and now returns a plain string rather than an array. This also fixed queryCache.getEntries(['1']) actually returning entries defined with a numeric key ([1]). The type for key is now stricter to ensure everything works well at the type level, you might notice it doesn't allow undefined as a value (except in objects), this is intended as the serialized version (JSON) transforms it no null, and will not match in the cache if used, if you want an nullish value, use null. The documentation has been updated to reflect this

    • Breaking

      types: If you built a plugin, you will have to rename the type params of generics like UseQueryEntryExtensions from TResult to TData. Otherwise, this change won't affect you.

  49. 0.15.x
  50. 0.15.3

    6 May 2025
    • Correctly handle refetchOn* when false

  51. 0.15.2

    3 May 2025
    • Check false refetchOnWindowFocus (c6400d7), closes #272

  52. 0.15.1

    26 Apr 2025
    • Support node 18

  53. 0.15.0

    18 Apr 2025
    • Breaking

      mutations: mutations are now created each time they are invoked. This change will only affect users directly creating entries with the mutation store (which should be avoided except in very advanced cases). Given the new structure of mutation entries and the fact that they are recreated for each mutation in order to keep a history of mutations, the new process simplifies things and reduces bundle size. The actions create and ensure in the mutation store are now simpler and take less arguments (many were redundant). Alongside these changes, the mutation store has fixed many subtle bugs.

    • Add gcTime option for global mutations

    • Add mutation id

  54. 0.14.x
  55. 0.14.2

    26 Mar 2025
    • Allow global mutation hooks

    • Avoid incompatible line with Vue 2

    • defineQuery: pause the query when inactive (2b5057e), closes #227

  56. 0.14.1

    18 Mar 2025
    • types: allow extending global query options

  57. 0.14.0

    18 Mar 2025
    • Breaking

      Every global query (useQuery() and defineQuery()) option passed to PiniaColada has been moved to its own option queryOptions:

      app.use(PiniaColada, {
        plugins: [],
      -  gcTime: 20_000,
      +  queryOptions: {
      +    gcTime: 20_000,
      +  },
      })

      You can also use the new codemods to automatically migrate this.

    • Breaking

      types: This changes allows for Pinia Colada global options to auto complete but it also requires you to use pass an options object to app.use(PiniaColada, {}). This is just for typing reasons (it could be a limitation of Vue) but the same old code actually works.

      -app.use(PiniaColada)
      +app.use(PiniaColada, {})
    • Breaking

      Replace serialize with serializeTreeMap

  58. 0.13.x
  59. 0.13.8

    9 Mar 2025
    • Add more actions to the mutation cache

    • Pass previous placeholderData if present (a576093), closes #197

  60. 0.13.7

    4 Mar 2025
    • queryCache should not invalidate query when it disabled

    • warn: avoid repeated queries warn (0fbe29a), closes #192

A whole project to check? Paste its package.json in the dependency check: every deprecated, outdated or vulnerable dependency, with what to upgrade to. Free, no account.