@raf-query/core 0.7.9 → 0.7.11

package/CHANGELOG.md

@@ -1,12 +1,31 @@
 # Changelog
 
+## [0.7.11](https://github.com/KATT/raf-query/compare/0.7.10...0.7.11) (2026-10-14)
+
+### Features
+
+* **examples:** add a stale time setting ([#119](https://github.com/KATT/raf-query/issues/119)) ([02467ef](https://github.com/KATT/raf-query/commit/02467ef4cf700d2ca1a57647c2fbc5cad2bf7abc))
+
+### Bug Fixes
+
+* **core:** leave error out of query types when it isn't inferred ([#120](https://github.com/KATT/raf-query/issues/120)) ([d2098e8](https://github.com/KATT/raf-query/commit/d2098e84dea31c8e0d136f7850177e37f56d4678)), references [#69](https://github.com/KATT/raf-query/issues/69) [#69](https://github.com/KATT/raf-query/issues/69)
+
+## [0.7.10](https://github.com/KATT/raf-query/compare/0.7.9...0.7.10) (2026-10-14)
+
+### Bug Fixes
+
+- **examples:** fit the example apps on a phone screen ([#116](https://github.com/KATT/raf-query/issues/116)) ([1580e00](https://github.com/KATT/raf-query/commit/1580e00f79f4e47e82ddba64e0d22723b9ffb4ba)), references [#112](https://github.com/KATT/raf-query/issues/112)
+- **examples:** open issue pages with prefetch skeletons ([#106](https://github.com/KATT/raf-query/issues/106)) ([db6b5bc](https://github.com/KATT/raf-query/commit/db6b5bcd162dd34073d36c74eaf7618f5012dc31))
+- **examples:** remount the issue page when next or previous changes the id ([#112](https://github.com/KATT/raf-query/issues/112)) ([e4b709b](https://github.com/KATT/raf-query/commit/e4b709b455e4e7bbd85746afe46ecca269a728ee))
+- **react:** type useQuery's promise as Promise ([#118](https://github.com/KATT/raf-query/issues/118)) ([f1b4efe](https://github.com/KATT/raf-query/commit/f1b4efefc7624719b00f0c6e308dd7a72c18c132))
+
 ## [0.7.9](https://github.com/KATT/raf-query/compare/0.7.8...0.7.9) (2026-10-14)
 
-* add a Links table to the pull request template ([#108](https://github.com/KATT/raf-query/issues/108)) ([91247e4](https://github.com/KATT/raf-query/commit/91247e47d4d1b4a0b6e5eb2068602629c3fbce9e))
+- add a Links table to the pull request template ([#108](https://github.com/KATT/raf-query/issues/108)) ([91247e4](https://github.com/KATT/raf-query/commit/91247e47d4d1b4a0b6e5eb2068602629c3fbce9e))
 
 ### Features
 
-* QueryClient.runPromise, typed Effect errors, and the Effect RPC example ([#103](https://github.com/KATT/raf-query/issues/103)) ([98bd182](https://github.com/KATT/raf-query/commit/98bd1821081313feb1846531feac0dfbe7215d31)), references [#96](https://github.com/KATT/raf-query/issues/96) [#97](https://github.com/KATT/raf-query/issues/97)
+- QueryClient.runPromise, typed Effect errors, and the Effect RPC example ([#103](https://github.com/KATT/raf-query/issues/103)) ([98bd182](https://github.com/KATT/raf-query/commit/98bd1821081313feb1846531feac0dfbe7215d31)), references [#96](https://github.com/KATT/raf-query/issues/96) [#97](https://github.com/KATT/raf-query/issues/97)
 
 ## [0.7.8](https://github.com/KATT/raf-query/compare/0.7.7...0.7.8) (2026-10-14)
 

package/dist/options.d.mts

@@ -3,8 +3,9 @@ import { Effect, Schedule } from "effect";
 //#region src/options.d.ts
 /**
  * The types of a plain query: what its `queryFn` resolves to, and for an
- * Effect `queryFn`, its error and the services it needs. `error` defaults to
- * `unknown` (promises reject with anything), `services` to `never`.
+ * Effect `queryFn`, its error and the services it needs. Leave `error` out
+ * and it is `unknown` (promises reject with anything); leave `services` out
+ * and it is `never`.
  *
  * ```ts
  * type PostOptions = QueryOptions<{ data: Post }>;
@@ -33,6 +34,43 @@ type ErrorIn<TTypes> = TTypes extends {
 type ServicesIn<TTypes> = TTypes extends {
   readonly services: infer TServices;
 } ? TServices : never;
+/**
+ * The bag `queryOptions` returns. `error` is left out when the `queryFn`
+ * doesn't name one (`unknown`: a promise or a plain value). `services` is
+ * left out when the `queryFn` needs none (`never`). An Effect's error,
+ * including `never` when it can't fail, stays.
+ */
+type QueryTypesOf<TData, TError, TServices> = unknown extends TError ? [TServices] extends [never] ? {
+  data: TData;
+} : {
+  data: TData;
+  services: TServices;
+} : [TServices] extends [never] ? {
+  data: TData;
+  error: TError;
+} : {
+  data: TData;
+  error: TError;
+  services: TServices;
+};
+/** As {@link QueryTypesOf}, for a paged query. */
+type InfiniteQueryTypesOf<TPage, TPageParam, TError, TServices> = unknown extends TError ? [TServices] extends [never] ? {
+  page: TPage;
+  pageParam: TPageParam;
+} : {
+  page: TPage;
+  pageParam: TPageParam;
+  services: TServices;
+} : [TServices] extends [never] ? {
+  error: TError;
+  page: TPage;
+  pageParam: TPageParam;
+} : {
+  error: TError;
+  page: TPage;
+  pageParam: TPageParam;
+  services: TServices;
+};
 /**
  * What a `queryFn` may return: a value, a promise, or an `Effect`. An
  * Effect's error type becomes the query's (promises reject with `unknown`),
@@ -181,7 +219,9 @@ export type AnyQueryOptions = QueryOptions<{
  * ```
  *
  * A `queryFn` Effect may need services; they're inferred, and every verb
- * that can start the query requires them.
+ * that can start the query requires them. Its error is part of the returned
+ * type. A promise or a plain value has no error to infer, so the type leaves
+ * `error` out (`ErrorOf` is `unknown`).
  *
  * The type parameters are only there for TypeScript to infer the types bag
  * from `queryFn`; it can't infer a bag's members.
@@ -190,26 +230,18 @@ export declare function queryOptions<TData, TError = unknown, TServices = never>
   data: TData;
   error: TError;
   services: TServices;
-}>, "kind">): QueryOptions<{
-  data: TData;
-  error: TError;
-  services: TServices;
-}>;
+}>, "kind">): QueryOptions<QueryTypesOf<TData, TError, TServices>>;
 /**
  * Typed options for a paged query factory. The page type is inferred from
- * `queryFn`, as in {@link queryOptions}.
+ * `queryFn`, as in {@link queryOptions}. So is an Effect `queryFn`'s error;
+ * a promise or a plain value leaves `error` out.
  */
 export declare function infiniteQueryOptions<TPage, TPageParam, TError = unknown, TServices = never>(options: Omit<InfiniteQueryOptions<{
   error: TError;
   page: TPage;
   pageParam: TPageParam;
   services: TServices;
-}>, "kind">): InfiniteQueryOptions<{
-  error: TError;
-  page: TPage;
-  pageParam: TPageParam;
-  services: TServices;
-}>;
+}>, "kind">): InfiniteQueryOptions<InfiniteQueryTypesOf<TPage, TPageParam, TError, TServices>>;
 interface FactoryResult {
   readonly kind: "infinite" | "query";
   readonly queryKey: QueryKey;

package/dist/options.mjs

@@ -12,7 +12,9 @@
 * ```
 *
 * A `queryFn` Effect may need services; they're inferred, and every verb
-* that can start the query requires them.
+* that can start the query requires them. Its error is part of the returned
+* type. A promise or a plain value has no error to infer, so the type leaves
+* `error` out (`ErrorOf` is `unknown`).
 *
 * The type parameters are only there for TypeScript to infer the types bag
 * from `queryFn`; it can't infer a bag's members.
@@ -25,7 +27,8 @@ function queryOptions(options) {
 }
 /**
 * Typed options for a paged query factory. The page type is inferred from
-* `queryFn`, as in {@link queryOptions}.
+* `queryFn`, as in {@link queryOptions}. So is an Effect `queryFn`'s error;
+* a promise or a plain value leaves `error` out.
 */
 function infiniteQueryOptions(options) {
 	return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@raf-query/core",
-  "version": "0.7.9",
+  "version": "0.7.11",
   "description": "Framework-agnostic core of raf-query, a render-as-you-fetch query library",
   "keywords": [
     "query",