@ethlete/query 6.0.0-next.19 → 6.0.0-next.20

package/CHANGELOG.md

@@ -1,5 +1,61 @@
 # @ethlete/query
 
+## 6.0.0-next.20
+
+### Minor Changes
+
+- [#3037](https://github.com/ethlete-io/ethdk/pull/3037) [`a83cfe4`](https://github.com/ethlete-io/ethdk/commit/a83cfe4b3e69c3e70ac20f81a5c287bdb6278a63) Thanks [@github-actions](https://github.com/apps/github-actions)! - Cache entries are now kept for `keepUnusedFor` (5 minutes by default) after their last consumer was destroyed, instead of being discarded immediately. A query that mounts again within that window — a list page reached via browser back navigation, for instance — binds to the existing entry and renders its previous response right away while revalidating in the background (`executionState()` reports `{ type: 'loading', hasCachedResponse: true }`).
+
+  - Configurable per client (`createQueryClient({ keepUnusedFor })`) and per query creator; `0` restores the previous release-immediately behavior.
+  - Independent of `cache-control`, so it also applies to private/authenticated responses.
+  - Only entries holding a response are kept — in-flight and errored ones are still aborted immediately. At most 50 unused entries per client are retained, and retention is disabled on the server.
+
+- [#3037](https://github.com/ethlete-io/ethdk/pull/3037) [`7ae9eaa`](https://github.com/ethlete-io/ethdk/commit/7ae9eaa878c6c3bfa80876c67ac1f9360a1c24ec) Thanks [@github-actions](https://github.com/apps/github-actions)! - Close the gaps found while migrating a real workspace from the legacy client to v3:
+
+  - **Client-level headers.** `createQueryClient({ headers })` takes `HttpHeaders` or a function
+    re-read on every request, so a signal can drive it. Per-query `args.headers` merge on top and win
+    per name. `client.refreshQueriesInUse()` re-runs every bound `GET`/`HEAD`/`OPTIONS` (in-flight ones
+    included) — the replacement for v2's `setDefaultHeaders({ refreshQueriesInUse: true })`.
+  - **`provider.setTokens(access, refresh)`** on the public bearer auth provider, for tokens issued
+    outside it (SSO callbacks, native shells). Previously reachable only from inside a custom feature.
+  - **`logout()` now resets bound secure queries.** It already unbound their cache entries, but the
+    query objects kept their `response()`, so a component mounted across a logout went on rendering the
+    previous user until something called `reset()`.
+  - **Legacy `prepare()` failures are diagnosable.** Calling it without an injection context throws
+    `ET950` naming the creator instead of a bare `NG0203`; calling it with an already destroyed injector
+    returns an inert query and warns in dev mode instead of throwing `NG0205` from a view's cleanup
+    phase. `createLegacyQueryCreator` takes a `name` for those messages.
+  - **Query-collection consumers accept real legacy queries.** `AnyQueryCollection` no longer pins the
+    arguments type, so a `createQueryCollectionSignal` result is assignable to `*etQuery`,
+    `queryStateErrorSignal` and `switchQueryCollectionState` without a cast.
+  - **`queryErrorMessages(error)` / `queryErrorMessage(error)`** flatten a `QueryErrorResponse` into
+    displayable strings, and `emptyQueryArgs<TArgs>()` covers argless queries in generic code (auth
+    registry `execute()` now takes no argument either).
+  - **`BearerAuthProviderOf<typeof ref>`** derives the exact provider type; `AnyBearerAuthProvider` no
+    longer forces bracket access on `provider.queries` under `noPropertyAccessFromIndexSignature`.
+
+  `migrate-to-query-v3` got a precision pass:
+
+  - Renames are scoped to imports that actually resolve to the migrated symbol, so same-named type
+    members, config properties and exports from unrelated packages are left alone; import aliases are
+    preserved instead of dropped.
+  - `--projects` / `--include` migrate one app or library at a time.
+  - Unused imports (`def`, `AnyLegacyQuery*`, stale client symbols) are no longer left behind.
+  - Auth providers are scaffolded from the v2 `V2BearerAuthProvider` config instead of `queries: []`.
+  - Devtools are migrated rather than deleted: the per-client `provideQueryClientForDevtools` calls
+    collapse into one `provideQueryDevtools()`, `QueryDevtoolsComponent` is re-imported from
+    `@ethlete/components`, and `<et-query-devtools>` markup is left alone — both versions use that selector.
+  - New report tasks for dropped v2 client options, missing `provideHttpClient()`, `setDefaultHeaders`
+    call sites and the auth import-cycle layout.
+
+- [#3037](https://github.com/ethlete-io/ethdk/pull/3037) [`0c30546`](https://github.com/ethlete-io/ethdk/commit/0c30546c220bc40f5a167c9d5cbad2757e9c7108) Thanks [@github-actions](https://github.com/apps/github-actions)! - Add a signals-first query form: `createQueryForm({ fields, queryParamPrefix? })` alongside field creators `queryField`, `searchQueryField`, `sortQueryField`, `stringArrayQueryField`, `numberArrayQueryField`, `booleanArrayQueryField`, `dateQueryField`, `dateArrayQueryField`.
+
+  Built on Angular signal forms, so each field is bindable to the SDK's own controls with `[formField]` (e.g. `<input etInput [formField]="qf.fields.search" />`). Fields commit as a debounced signal `value`, sync to the URL query params (default elision, `ET_NULL__` sentinel, `active:direction` sort format, prefix namespacing), reset dependents via the `isResetBy` graph, expose `activeFilterCount` as a signal, and support a detached `branch()` for edit-then-apply filter flows.
+
+  Also adds a `withPageResetOnError` query feature that resets the page (a signal or a query-form field) when the current page goes out of range (HTTP `416`, or a dev-mode `500` Pagerfanta out-of-range error), plus the exported `isPageOutOfRangeError` predicate.
+
+  The existing reactive-forms `QueryForm` is unchanged and remains available.
+
 ## 6.0.0-next.19
 
 ### Minor Changes