fetchium 0.2.1 → 0.2.3

package/dist/esm/production/index.js

@@ -1,6 +1,6 @@
-import { A as r, E as s, G as t, L as o, a as n, M as i, N as M, b as g, c as u, d as y, e as f, Q as C, f as N, g as Q, h as d, R as k, i as l, j as p, k as m, q as E, r as R, t as w } from "./QueryClient-DSAzqTG6.js";
+import { A as r, E as s, G as t, L as o, a as n, M as i, N as M, b as g, c as u, d as y, e as f, Q as C, f as N, g as Q, h as d, R as k, i as l, j as p, k as m, q as E, r as R, t as w } from "./QueryClient-3aWu_mJE.js";
 import { Q as F } from "./QueryAdapter-Bu5UJjE4.js";
-import { M as A, g as K, m as Y } from "./mutation-Dmb9k9FG.js";
+import { M as A, g as K, m as Y } from "./mutation-YpiJLNWU.js";
 export {
   r as ARRAY_KEY,
   s as Entity,

package/dist/esm/production/{mutation-Dmb9k9FG.js → mutation-YpiJLNWU.js}

@@ -1,5 +1,5 @@
 import { getContext as h } from "signalium";
-import { l as y, h as D, m as w, V as u, t as d } from "./QueryClient-DSAzqTG6.js";
+import { l as y, h as D, m as w, V as u, t as d } from "./QueryClient-3aWu_mJE.js";
 class x {
   static adapter;
   params;
@@ -55,4 +55,4 @@ export {
   S as g,
   C as m
 };
-//# sourceMappingURL=mutation-Dmb9k9FG.js.map
+//# sourceMappingURL=mutation-YpiJLNWU.js.map

package/dist/esm/production/mutation-YpiJLNWU.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation-YpiJLNWU.js","sources":["../../../src/mutation.ts"],"sourcesContent":["import { getContext, ReactiveTask } from 'signalium';\nimport { ExtractType, InternalTypeDef, MutationEffects, TypeDef, RetryConfig, TypeDefShape } from './types.js';\nimport { QueryClientContext, type QueryContext } from './QueryClient.js';\nimport { ValidatorDef, t } from './typeDefs.js';\nimport { createDefinitionProxy, extractDefinition, type CapturedDefinition } from './fieldRef.js';\nimport type { QueryAdapter, QueryAdapterClass } from './QueryAdapter.js';\n\n// ================================\n// Mutation Definition Types\n// ================================\n\nexport interface MutationConfigOptions {\n  retry?: RetryConfig | number | false;\n}\n\nexport interface MutationDefinition<Request, Response> {\n  id: string;\n  requestShape: InternalTypeDef;\n  responseShape: InternalTypeDef | undefined;\n  captured: CapturedDefinition<Mutation>;\n  optimisticUpdates: boolean;\n  config?: MutationConfigOptions;\n  effects?: MutationEffects;\n  hasGetEffects: boolean;\n  adapterClass: QueryAdapterClass;\n}\n\n// ================================\n// Mutation base class\n// ================================\n\nexport abstract class Mutation {\n  static adapter?: QueryAdapterClass;\n\n  readonly params?: TypeDefShape;\n  readonly result?: TypeDefShape;\n  readonly optimisticUpdates?: boolean;\n  readonly config?: MutationConfigOptions;\n  readonly effects?: Readonly<MutationEffects>;\n\n  declare context: QueryContext;\n\n  abstract getIdentityKey(): unknown;\n\n  getEffects?(): MutationEffects;\n\n  constructor() {\n    return createDefinitionProxy(this);\n  }\n}\n\n// ================================\n// Mutation definition cache and lookup\n// ================================\n\nconst mutationDefCache = new WeakMap<new () => Mutation, () => MutationDefinition<any, any>>();\n\nexport const mutationKeyForClass = (cls: new () => Mutation): string => {\n  const getMutationDef = mutationDefCache.get(cls);\n\n  if (getMutationDef === undefined) {\n    throw new Error('Mutation definition not found');\n  }\n\n  return getMutationDef().id;\n};\n\n// ================================\n// Internal: build mutation definition from class\n// ================================\n\nfunction buildMutationDefinition(MutationClass: new () => Mutation): () => MutationDefinition<any, any> {\n  let cached = mutationDefCache.get(MutationClass);\n\n  if (cached !== undefined) {\n    return cached;\n  }\n\n  let mutationDefinition: MutationDefinition<any, any> | undefined;\n\n  const getter = (): MutationDefinition<any, any> => {\n    if (mutationDefinition !== undefined) {\n      return mutationDefinition;\n    }\n\n    const instance = new MutationClass();\n    const captured = extractDefinition(instance);\n    const { fields } = captured;\n\n    const id = `mutation:${String(captured.methods.getIdentityKey.call(fields))}`;\n\n    const requestDef = fields.params ?? {};\n    const requestShape = (requestDef instanceof ValidatorDef\n      ? requestDef\n      : t.object(requestDef)) as unknown as InternalTypeDef;\n    const responseDef = fields.result;\n    const responseShape =\n      responseDef !== undefined\n        ? ((responseDef instanceof ValidatorDef ? responseDef : t.object(responseDef)) as unknown as InternalTypeDef)\n        : undefined;\n\n    const adapterClass = (MutationClass as typeof Mutation).adapter;\n    if (!adapterClass) {\n      throw new Error(\n        `Mutation class \"${MutationClass.name}\" must define a static \\`adapter\\` property. ` +\n          `Extend RESTMutation (from fetchium/rest) or set \\`static adapter = MyAdapter\\` on your mutation class.`,\n      );\n    }\n\n    mutationDefinition = {\n      id,\n      requestShape,\n      responseShape,\n      captured,\n      optimisticUpdates: fields.optimisticUpdates ?? false,\n      config: fields.config,\n      effects: fields.effects,\n      hasGetEffects: typeof captured.methods.getEffects === 'function',\n      adapterClass,\n    };\n\n    return mutationDefinition;\n  };\n\n  mutationDefCache.set(MutationClass, getter);\n  return getter;\n}\n\n// ================================\n// Public API\n// ================================\n\nexport function getMutation<T extends Mutation>(\n  MutationClass: new () => T,\n): ReactiveTask<Readonly<ExtractType<T['result']>>, [ExtractType<T['params']>]> {\n  const getMutationDef = buildMutationDefinition(MutationClass);\n\n  const queryClient = getContext(QueryClientContext);\n\n  if (queryClient === undefined) {\n    throw new Error('QueryClient not found');\n  }\n\n  return queryClient.getMutation<any, any>(getMutationDef());\n}\n"],"names":["Mutation","createDefinitionProxy","mutationDefCache","mutationKeyForClass","cls","getMutationDef","buildMutationDefinition","MutationClass","cached","mutationDefinition","getter","instance","captured","extractDefinition","fields","id","requestDef","requestShape","ValidatorDef","t","responseDef","responseShape","adapterClass","getMutation","queryClient","getContext","QueryClientContext"],"mappings":";;AA+BO,MAAeA,EAAS;AAAA,EAC7B,OAAO;AAAA,EAEE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAQT,cAAc;AACZ,WAAOC,EAAsB,IAAI;AAAA,EACnC;AACF;AAMA,MAAMC,wBAAuB,QAAA,GAEhBC,IAAsB,CAACC,MAAoC;AACtE,QAAMC,IAAiBH,EAAiB,IAAIE,CAAG;AAE/C,MAAIC,MAAmB;AACrB,UAAM,IAAI,MAAM,+BAA+B;AAGjD,SAAOA,IAAiB;AAC1B;AAMA,SAASC,EAAwBC,GAAuE;AACtG,MAAIC,IAASN,EAAiB,IAAIK,CAAa;AAE/C,MAAIC,MAAW;AACb,WAAOA;AAGT,MAAIC;AAEJ,QAAMC,IAAS,MAAoC;AACjD,QAAID,MAAuB;AACzB,aAAOA;AAGT,UAAME,IAAW,IAAIJ,EAAA,GACfK,IAAWC,EAAkBF,CAAQ,GACrC,EAAE,QAAAG,MAAWF,GAEbG,IAAK,YAAY,OAAOH,EAAS,QAAQ,eAAe,KAAKE,CAAM,CAAC,CAAC,IAErEE,IAAaF,EAAO,UAAU,CAAA,GAC9BG,IAAgBD,aAAsBE,IACxCF,IACAG,EAAE,OAAOH,CAAU,GACjBI,IAAcN,EAAO,QACrBO,IACJD,MAAgB,SACVA,aAAuBF,IAAeE,IAAcD,EAAE,OAAOC,CAAW,IAC1E,QAEAE,IAAgBf,EAAkC;AACxD,QAAI,CAACe;AACH,YAAM,IAAI;AAAA,QACR,mBAAmBf,EAAc,IAAI;AAAA,MAAA;AAKzC,WAAAE,IAAqB;AAAA,MACnB,IAAAM;AAAA,MACA,cAAAE;AAAA,MACA,eAAAI;AAAA,MACA,UAAAT;AAAA,MACA,mBAAmBE,EAAO,qBAAqB;AAAA,MAC/C,QAAQA,EAAO;AAAA,MACf,SAASA,EAAO;AAAA,MAChB,eAAe,OAAOF,EAAS,QAAQ,cAAe;AAAA,MACtD,cAAAU;AAAA,IAAA,GAGKb;AAAA,EACT;AAEA,SAAAP,EAAiB,IAAIK,GAAeG,CAAM,GACnCA;AACT;AAMO,SAASa,EACdhB,GAC8E;AAC9E,QAAMF,IAAiBC,EAAwBC,CAAa,GAEtDiB,IAAcC,EAAWC,CAAkB;AAEjD,MAAIF,MAAgB;AAClB,UAAM,IAAI,MAAM,uBAAuB;AAGzC,SAAOA,EAAY,YAAsBnB,GAAgB;AAC3D;"}

package/dist/esm/production/react/index.js

@@ -1,6 +1,6 @@
 import { useReactive as i } from "signalium/react";
 import { reactive as f } from "signalium";
-import { k as u } from "../QueryClient-DSAzqTG6.js";
+import { k as u } from "../QueryClient-3aWu_mJE.js";
 function n(e) {
   if (Array.isArray(e))
     return e.map(n);

package/dist/esm/production/rest/index.js

@@ -1,6 +1,6 @@
-import { n as v, o as U, f as O } from "../QueryClient-DSAzqTG6.js";
+import { n as v, o as U, f as O } from "../QueryClient-3aWu_mJE.js";
 import { Q as T } from "../QueryAdapter-Bu5UJjE4.js";
-import { M as w } from "../mutation-Dmb9k9FG.js";
+import { M as w } from "../mutation-YpiJLNWU.js";
 class P extends T {
   _fetch;
   _baseUrl;

package/dist/esm/production/topic/index.js

@@ -1,20 +1,6 @@
-import { f as l } from "../QueryClient-DSAzqTG6.js";
+import { f as l } from "../QueryClient-3aWu_mJE.js";
 import { Q as d } from "../QueryAdapter-Bu5UJjE4.js";
-class g extends l {
-  static adapter;
-  getIdentityKey() {
-    return `topic:${this.topic}`;
-  }
-  getConfig() {
-    return {
-      staleTime: 0,
-      subscribe: () => () => {
-        this._topicAdapter?.unsubscribe(this.topic);
-      }
-    };
-  }
-}
-class _ extends d {
+class f extends d {
   _topics = /* @__PURE__ */ new Map();
   /**
    * Resolve the pending promise for a topic with initial data.
@@ -79,8 +65,23 @@ class _ extends d {
     this.queryClient.applyMutationEvent(e);
   }
 }
+class _ extends l {
+  // Explicit type lets subclasses override with adapters that take constructor args.
+  static adapter = f;
+  getIdentityKey() {
+    return `topic:${this.topic}`;
+  }
+  getConfig() {
+    return {
+      staleTime: 0,
+      subscribe: () => () => {
+        this._topicAdapter?.unsubscribe(this.topic);
+      }
+    };
+  }
+}
 export {
-  g as TopicQuery,
-  _ as TopicQueryAdapter
+  _ as TopicQuery,
+  f as TopicQueryAdapter
 };
 //# sourceMappingURL=index.js.map

package/dist/esm/production/topic/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../../src/topic/TopicQuery.ts","../../../../src/topic/TopicQueryAdapter.ts"],"sourcesContent":["import { Query } from '../query.js';\nimport type { TopicQueryAdapter } from './TopicQueryAdapter.js';\nimport type { QueryConfigOptions } from '../query-types.js';\n\n// ================================\n// TopicQuery — declarative topic-based query definition\n// ================================\n\nexport abstract class TopicQuery extends Query {\n  static override adapter: typeof TopicQueryAdapter;\n\n  abstract topic: string;\n\n  getIdentityKey(): string {\n    return `topic:${this.topic}`;\n  }\n\n  getConfig(): QueryConfigOptions {\n    return {\n      staleTime: 0,\n      subscribe: () => {\n        return () => {\n          const adapter = (this as Record<string, any>)._topicAdapter as TopicQueryAdapter | undefined;\n          adapter?.unsubscribe(this.topic);\n        };\n      },\n    };\n  }\n}\n","import { QueryAdapter } from '../QueryAdapter.js';\nimport type { Query } from '../query.js';\nimport type { MutationEvent } from '../types.js';\n\n// ================================\n// TopicQueryAdapter — abstract adapter for topic-based subscriptions\n// ================================\n\ninterface TopicCtx extends Query {\n  topic: string;\n  _topicAdapter?: TopicQueryAdapter;\n}\n\ninterface TopicState {\n  status: 'pending' | 'fulfilled' | 'rejected';\n  promise?: Promise<unknown>;\n  resolve?: (data: unknown) => void;\n  reject?: (error: unknown) => void;\n  data?: unknown;\n  error?: unknown;\n}\n\nexport abstract class TopicQueryAdapter extends QueryAdapter {\n  private _topics = new Map<string, TopicState>();\n\n  /**\n   * Called when a query activates for a given topic.\n   * Implementations should start delivering data for this topic,\n   * calling `fulfillTopic()` when initial data is available and\n   * `sendMutationEvent()` for ongoing updates.\n   */\n  abstract subscribe(topic: string): void;\n\n  /**\n   * Called when the query deactivates. Implementations should\n   * tear down any resources for this topic.\n   */\n  abstract unsubscribe(topic: string): void;\n\n  /**\n   * Resolve the pending promise for a topic with initial data.\n   * Can be called before `send()` — the data will be picked up\n   * when the query activates.\n   */\n  protected fulfillTopic(topic: string, data: unknown): void {\n    const state = this._topics.get(topic);\n\n    if (state === undefined) {\n      this._topics.set(topic, { status: 'fulfilled', data });\n      return;\n    }\n\n    if (state.status === 'pending') {\n      state.status = 'fulfilled';\n      state.data = data;\n      state.resolve!(data);\n    }\n  }\n\n  /**\n   * Reject the pending promise for a topic.\n   * Can be called before `send()` — the error will be propagated\n   * when the query activates.\n   */\n  protected rejectTopic(topic: string, error: unknown): void {\n    const state = this._topics.get(topic);\n\n    if (state === undefined) {\n      this._topics.set(topic, { status: 'rejected', error });\n      return;\n    }\n\n    if (state.status === 'pending') {\n      state.status = 'rejected';\n      state.error = error;\n      state.reject!(error);\n    }\n  }\n\n  /**\n   * Clears internal state for a topic. Called automatically by\n   * `unsubscribe` — subclasses generally don't need to call this.\n   */\n  protected clearTopic(topic: string): void {\n    this._topics.delete(topic);\n  }\n\n  protected clearAll(): void {\n    this._topics.clear();\n  }\n\n  override async send(ctx: Query, _signal: AbortSignal): Promise<unknown> {\n    const topicCtx = ctx as TopicCtx;\n    topicCtx._topicAdapter = this;\n    const topic = topicCtx.topic;\n\n    const existing = this._topics.get(topic);\n\n    if (existing) {\n      switch (existing.status) {\n        case 'fulfilled':\n          return existing.data;\n        case 'rejected':\n          throw existing.error;\n        case 'pending':\n          return existing.promise;\n      }\n    }\n\n    // No state yet — create a deferred and subscribe\n    let resolve!: (data: unknown) => void;\n    let reject!: (error: unknown) => void;\n    const promise = new Promise<unknown>((res, rej) => {\n      resolve = res;\n      reject = rej;\n    });\n\n    this._topics.set(topic, { status: 'pending', promise, resolve, reject });\n    this.subscribe(topic);\n\n    return promise;\n  }\n\n  /**\n   * Convenience wrapper — pushes a mutation event through the QueryClient\n   * so that entities and live collections are updated reactively.\n   */\n  protected sendMutationEvent(event: MutationEvent): void {\n    this.queryClient!.applyMutationEvent(event);\n  }\n}\n"],"names":["TopicQuery","Query","TopicQueryAdapter","QueryAdapter","topic","data","state","error","ctx","_signal","topicCtx","existing","resolve","reject","promise","res","rej","event"],"mappings":";;AAQO,MAAeA,UAAmBC,EAAM;AAAA,EAC7C,OAAgB;AAAA,EAIhB,iBAAyB;AACvB,WAAO,SAAS,KAAK,KAAK;AAAA,EAC5B;AAAA,EAEA,YAAgC;AAC9B,WAAO;AAAA,MACL,WAAW;AAAA,MACX,WAAW,MACF,MAAM;AAEX,QADiB,KAA6B,eACrC,YAAY,KAAK,KAAK;AAAA,MACjC;AAAA,IACF;AAAA,EAEJ;AACF;ACNO,MAAeC,UAA0BC,EAAa;AAAA,EACnD,8BAAc,IAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAqBZ,aAAaC,GAAeC,GAAqB;AACzD,UAAMC,IAAQ,KAAK,QAAQ,IAAIF,CAAK;AAEpC,QAAIE,MAAU,QAAW;AACvB,WAAK,QAAQ,IAAIF,GAAO,EAAE,QAAQ,aAAa,MAAAC,GAAM;AACrD;AAAA,IACF;AAEA,IAAIC,EAAM,WAAW,cACnBA,EAAM,SAAS,aACfA,EAAM,OAAOD,GACbC,EAAM,QAASD,CAAI;AAAA,EAEvB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOU,YAAYD,GAAeG,GAAsB;AACzD,UAAMD,IAAQ,KAAK,QAAQ,IAAIF,CAAK;AAEpC,QAAIE,MAAU,QAAW;AACvB,WAAK,QAAQ,IAAIF,GAAO,EAAE,QAAQ,YAAY,OAAAG,GAAO;AACrD;AAAA,IACF;AAEA,IAAID,EAAM,WAAW,cACnBA,EAAM,SAAS,YACfA,EAAM,QAAQC,GACdD,EAAM,OAAQC,CAAK;AAAA,EAEvB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMU,WAAWH,GAAqB;AACxC,SAAK,QAAQ,OAAOA,CAAK;AAAA,EAC3B;AAAA,EAEU,WAAiB;AACzB,SAAK,QAAQ,MAAA;AAAA,EACf;AAAA,EAEA,MAAe,KAAKI,GAAYC,GAAwC;AACtE,UAAMC,IAAWF;AACjB,IAAAE,EAAS,gBAAgB;AACzB,UAAMN,IAAQM,EAAS,OAEjBC,IAAW,KAAK,QAAQ,IAAIP,CAAK;AAEvC,QAAIO;AACF,cAAQA,EAAS,QAAA;AAAA,QACf,KAAK;AACH,iBAAOA,EAAS;AAAA,QAClB,KAAK;AACH,gBAAMA,EAAS;AAAA,QACjB,KAAK;AACH,iBAAOA,EAAS;AAAA,MAAA;AAKtB,QAAIC,GACAC;AACJ,UAAMC,IAAU,IAAI,QAAiB,CAACC,GAAKC,MAAQ;AACjD,MAAAJ,IAAUG,GACVF,IAASG;AAAA,IACX,CAAC;AAED,gBAAK,QAAQ,IAAIZ,GAAO,EAAE,QAAQ,WAAW,SAAAU,GAAS,SAAAF,GAAS,QAAAC,GAAQ,GACvE,KAAK,UAAUT,CAAK,GAEbU;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA,EAMU,kBAAkBG,GAA4B;AACtD,SAAK,YAAa,mBAAmBA,CAAK;AAAA,EAC5C;AACF;"}
+{"version":3,"file":"index.js","sources":["../../../../src/topic/TopicQueryAdapter.ts","../../../../src/topic/TopicQuery.ts"],"sourcesContent":["import { QueryAdapter } from '../QueryAdapter.js';\nimport type { Query } from '../query.js';\nimport type { MutationEvent } from '../types.js';\n\n// ================================\n// TopicQueryAdapter — abstract adapter for topic-based subscriptions\n// ================================\n\ninterface TopicCtx extends Query {\n  topic: string;\n  _topicAdapter?: TopicQueryAdapter;\n}\n\ninterface TopicState {\n  status: 'pending' | 'fulfilled' | 'rejected';\n  promise?: Promise<unknown>;\n  resolve?: (data: unknown) => void;\n  reject?: (error: unknown) => void;\n  data?: unknown;\n  error?: unknown;\n}\n\nexport abstract class TopicQueryAdapter extends QueryAdapter {\n  private _topics = new Map<string, TopicState>();\n\n  /**\n   * Called when a query activates for a given topic.\n   * Implementations should start delivering data for this topic,\n   * calling `fulfillTopic()` when initial data is available and\n   * `sendMutationEvent()` for ongoing updates.\n   */\n  abstract subscribe(topic: string): void;\n\n  /**\n   * Called when the query deactivates. Implementations should\n   * tear down any resources for this topic.\n   */\n  abstract unsubscribe(topic: string): void;\n\n  /**\n   * Resolve the pending promise for a topic with initial data.\n   * Can be called before `send()` — the data will be picked up\n   * when the query activates.\n   */\n  protected fulfillTopic(topic: string, data: unknown): void {\n    const state = this._topics.get(topic);\n\n    if (state === undefined) {\n      this._topics.set(topic, { status: 'fulfilled', data });\n      return;\n    }\n\n    if (state.status === 'pending') {\n      state.status = 'fulfilled';\n      state.data = data;\n      state.resolve!(data);\n    }\n  }\n\n  /**\n   * Reject the pending promise for a topic.\n   * Can be called before `send()` — the error will be propagated\n   * when the query activates.\n   */\n  protected rejectTopic(topic: string, error: unknown): void {\n    const state = this._topics.get(topic);\n\n    if (state === undefined) {\n      this._topics.set(topic, { status: 'rejected', error });\n      return;\n    }\n\n    if (state.status === 'pending') {\n      state.status = 'rejected';\n      state.error = error;\n      state.reject!(error);\n    }\n  }\n\n  /**\n   * Clears internal state for a topic. Called automatically by\n   * `unsubscribe` — subclasses generally don't need to call this.\n   */\n  protected clearTopic(topic: string): void {\n    this._topics.delete(topic);\n  }\n\n  protected clearAll(): void {\n    this._topics.clear();\n  }\n\n  override async send(ctx: Query, _signal: AbortSignal): Promise<unknown> {\n    const topicCtx = ctx as TopicCtx;\n    topicCtx._topicAdapter = this;\n    const topic = topicCtx.topic;\n\n    const existing = this._topics.get(topic);\n\n    if (existing) {\n      switch (existing.status) {\n        case 'fulfilled':\n          return existing.data;\n        case 'rejected':\n          throw existing.error;\n        case 'pending':\n          return existing.promise;\n      }\n    }\n\n    // No state yet — create a deferred and subscribe\n    let resolve!: (data: unknown) => void;\n    let reject!: (error: unknown) => void;\n    const promise = new Promise<unknown>((res, rej) => {\n      resolve = res;\n      reject = rej;\n    });\n\n    this._topics.set(topic, { status: 'pending', promise, resolve, reject });\n    this.subscribe(topic);\n\n    return promise;\n  }\n\n  /**\n   * Convenience wrapper — pushes a mutation event through the QueryClient\n   * so that entities and live collections are updated reactively.\n   */\n  protected sendMutationEvent(event: MutationEvent): void {\n    this.queryClient!.applyMutationEvent(event);\n  }\n}\n","import { Query } from '../query.js';\nimport { TopicQueryAdapter } from './TopicQueryAdapter.js';\nimport type { QueryAdapterClass } from '../QueryAdapter.js';\nimport type { QueryConfigOptions } from '../query-types.js';\n\n// ================================\n// TopicQuery — declarative topic-based query definition\n// ================================\n\nexport abstract class TopicQuery extends Query {\n  // Explicit type lets subclasses override with adapters that take constructor args.\n  static override adapter: QueryAdapterClass<TopicQueryAdapter> = TopicQueryAdapter;\n\n  abstract topic: string;\n\n  getIdentityKey(): string {\n    return `topic:${this.topic}`;\n  }\n\n  getConfig(): QueryConfigOptions {\n    return {\n      staleTime: 0,\n      subscribe: () => {\n        return () => {\n          const adapter = (this as Record<string, any>)._topicAdapter as TopicQueryAdapter | undefined;\n          adapter?.unsubscribe(this.topic);\n        };\n      },\n    };\n  }\n}\n"],"names":["TopicQueryAdapter","QueryAdapter","topic","data","state","error","ctx","_signal","topicCtx","existing","resolve","reject","promise","res","rej","event","TopicQuery","Query"],"mappings":";;AAsBO,MAAeA,UAA0BC,EAAa;AAAA,EACnD,8BAAc,IAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAqBZ,aAAaC,GAAeC,GAAqB;AACzD,UAAMC,IAAQ,KAAK,QAAQ,IAAIF,CAAK;AAEpC,QAAIE,MAAU,QAAW;AACvB,WAAK,QAAQ,IAAIF,GAAO,EAAE,QAAQ,aAAa,MAAAC,GAAM;AACrD;AAAA,IACF;AAEA,IAAIC,EAAM,WAAW,cACnBA,EAAM,SAAS,aACfA,EAAM,OAAOD,GACbC,EAAM,QAASD,CAAI;AAAA,EAEvB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOU,YAAYD,GAAeG,GAAsB;AACzD,UAAMD,IAAQ,KAAK,QAAQ,IAAIF,CAAK;AAEpC,QAAIE,MAAU,QAAW;AACvB,WAAK,QAAQ,IAAIF,GAAO,EAAE,QAAQ,YAAY,OAAAG,GAAO;AACrD;AAAA,IACF;AAEA,IAAID,EAAM,WAAW,cACnBA,EAAM,SAAS,YACfA,EAAM,QAAQC,GACdD,EAAM,OAAQC,CAAK;AAAA,EAEvB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMU,WAAWH,GAAqB;AACxC,SAAK,QAAQ,OAAOA,CAAK;AAAA,EAC3B;AAAA,EAEU,WAAiB;AACzB,SAAK,QAAQ,MAAA;AAAA,EACf;AAAA,EAEA,MAAe,KAAKI,GAAYC,GAAwC;AACtE,UAAMC,IAAWF;AACjB,IAAAE,EAAS,gBAAgB;AACzB,UAAMN,IAAQM,EAAS,OAEjBC,IAAW,KAAK,QAAQ,IAAIP,CAAK;AAEvC,QAAIO;AACF,cAAQA,EAAS,QAAA;AAAA,QACf,KAAK;AACH,iBAAOA,EAAS;AAAA,QAClB,KAAK;AACH,gBAAMA,EAAS;AAAA,QACjB,KAAK;AACH,iBAAOA,EAAS;AAAA,MAAA;AAKtB,QAAIC,GACAC;AACJ,UAAMC,IAAU,IAAI,QAAiB,CAACC,GAAKC,MAAQ;AACjD,MAAAJ,IAAUG,GACVF,IAASG;AAAA,IACX,CAAC;AAED,gBAAK,QAAQ,IAAIZ,GAAO,EAAE,QAAQ,WAAW,SAAAU,GAAS,SAAAF,GAAS,QAAAC,GAAQ,GACvE,KAAK,UAAUT,CAAK,GAEbU;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA,EAMU,kBAAkBG,GAA4B;AACtD,SAAK,YAAa,mBAAmBA,CAAK;AAAA,EAC5C;AACF;ACzHO,MAAeC,UAAmBC,EAAM;AAAA;AAAA,EAE7C,OAAgB,UAAgDjB;AAAA,EAIhE,iBAAyB;AACvB,WAAO,SAAS,KAAK,KAAK;AAAA,EAC5B;AAAA,EAEA,YAAgC;AAC9B,WAAO;AAAA,MACL,WAAW;AAAA,MACX,WAAW,MACF,MAAM;AAEX,QADiB,KAA6B,eACrC,YAAY,KAAK,KAAK;AAAA,MACjC;AAAA,IACF;AAAA,EAEJ;AACF;"}

package/dist/esm/query.d.ts

@@ -3,7 +3,7 @@ import { QueryCacheOptions, QueryConfigOptions, FetchNextConfig, QueryParams } f
 import { ValidatorDef } from './typeDefs.js';
 import { HasRequiredKeys, Optionalize, Signalize } from './type-utils.js';
 import { type CapturedDefinition } from './fieldRef.js';
-import type { QueryAdapter } from './QueryAdapter.js';
+import type { QueryAdapterClass } from './QueryAdapter.js';
 export interface ResolvedRetryConfig {
     retries: number;
     retryDelay: (attempt: number) => number;
@@ -15,7 +15,7 @@ export declare abstract class Query {
      * The adapter class responsible for sending requests for this query type.
      * Must be set on each concrete Query subclass (or inherited from a base like RESTQuery).
      */
-    static adapter?: typeof QueryAdapter;
+    static adapter?: QueryAdapterClass;
     params?: Record<string, TypeDef>;
     abstract result: TypeDefShape;
     config?: QueryConfigOptions;
@@ -45,7 +45,7 @@ export interface QueryDefinitionStatics {
     /** Whether the result shape is already an entity (vs synthetic wrapper). */
     readonly isEntityResult: boolean;
     /** The adapter class responsible for sending requests. */
-    readonly adapterClass: typeof QueryAdapter;
+    readonly adapterClass: QueryAdapterClass;
 }
 export declare class QueryDefinition<Params extends QueryParams | undefined, Result, StreamType> {
     readonly captured: CapturedDefinition<Query>;

package/dist/esm/query.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/query.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/query.ts"],"names":[],"mappings":"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"}

package/dist/esm/topic/TopicQuery.d.ts

@@ -1,8 +1,9 @@
 import { Query } from '../query.js';
-import type { TopicQueryAdapter } from './TopicQueryAdapter.js';
+import { TopicQueryAdapter } from './TopicQueryAdapter.js';
+import type { QueryAdapterClass } from '../QueryAdapter.js';
 import type { QueryConfigOptions } from '../query-types.js';
 export declare abstract class TopicQuery extends Query {
-    static adapter: typeof TopicQueryAdapter;
+    static adapter: QueryAdapterClass<TopicQueryAdapter>;
     abstract topic: string;
     getIdentityKey(): string;
     getConfig(): QueryConfigOptions;

package/dist/esm/topic/TopicQuery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TopicQuery.d.ts","sourceRoot":"","sources":["../../../src/topic/TopicQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAM5D,8BAAsB,UAAW,SAAQ,KAAK;IAC5C,OAAgB,OAAO,EAAE,OAAO,iBAAiB,CAAC;IAElD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,cAAc,IAAI,MAAM;IAIxB,SAAS,IAAI,kBAAkB;CAWhC"}
+{"version":3,"file":"TopicQuery.d.ts","sourceRoot":"","sources":["../../../src/topic/TopicQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAM5D,8BAAsB,UAAW,SAAQ,KAAK;IAE5C,OAAgB,OAAO,EAAE,iBAAiB,CAAC,iBAAiB,CAAC,CAAqB;IAElF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,cAAc,IAAI,MAAM;IAIxB,SAAS,IAAI,kBAAkB;CAWhC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fetchium",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "type": "module",
   "repository": {
     "type": "git",

package/plugin/docs/api/fetchium.md

@@ -226,7 +226,7 @@ new QueryClient(config: QueryClientConfig)
 
 | Field                | Type                         | Default                | Description                                                                          |
 | -------------------- | ---------------------------- | ---------------------- | ------------------------------------------------------------------------------------ |
-| `store`              | `QueryStore`                 | —                      | **(required)** Persistent storage backend.                                           |
+| `store`              | `QueryStore`                 | In-memory              | Persistent storage backend. Defaults to `SyncQueryStore(MemoryPersistentStore)`.     |
 | `adapters`           | `QueryAdapter[]`             | `[]`                   | Transport adapters (e.g. `new RESTQueryAdapter({ fetch, baseUrl })`).                |
 | `log`                | `LogContext \| undefined`    | `console`              | Logger with `error`, `warn`, `info`, `debug` methods.                                |
 | `evictionMultiplier` | `number \| undefined`        | `1`                    | Scales all GC times for testing. Set to `0.001` to make timers fire in milliseconds. |
@@ -604,7 +604,7 @@ The `t` object provides a declarative type definition DSL for describing query p
 | `QueryCacheOptions`             | `{ maxCount?: number; cacheTime?: number }`                                                                               | Persistent storage cache settings. `cacheTime` is in minutes (default: 1440 / 24 hours). `maxCount` is the LRU queue size. |
 | `QueryConfigOptions`            | `{ gcTime?, staleTime?, debounce?, networkMode?, retry?, refreshStaleOnReconnect?, subscribe? }`                          | Instance-level query configuration. See property table below.                                                              |
 | `QueryRequestOptions`           | `{ baseUrl?, credentials?, mode?, cache?, redirect?, referrer?, referrerPolicy?, integrity?, keepalive?, signal? }`       | Extended fetch options for individual queries.                                                                             |
-| `QueryContext`                  | `{ fetch, baseUrl?, log?, evictionMultiplier? }`                                                                          | Context object provided to the `QueryClient`.                                                                              |
+| `QueryContext`                  | `{ log?, evictionMultiplier? }`                                                                                           | Context object provided to the `QueryClient`.                                                                              |
 | `QueryParams`                   | `Record<string, string \| number \| boolean \| undefined \| null \| Signal<...> \| unknown[] \| Record<string, unknown>>` | The shape of query parameters at runtime.                                                                                  |
 | `FetchNextConfig`               | `{ url?: unknown; searchParams?: Record<string, unknown> }`                                                               | Pagination configuration. Values can be FieldRefs.                                                                         |
 

package/plugin/docs/api/stores-async.md

@@ -181,6 +181,7 @@ type StoreMessage =
 ```ts
 import { QueryClient } from 'fetchium';
 import { AsyncQueryStore } from 'fetchium/stores/async';
+import { RESTQueryAdapter } from 'fetchium/rest';
 
 const worker = new Worker('./store-worker.js');
 
@@ -194,9 +195,14 @@ const store = new AsyncQueryStore({
   },
 });
 
-const client = new QueryClient(store, {
-  fetch: globalThis.fetch,
-  baseUrl: 'https://api.example.com',
+const client = new QueryClient({
+  store,
+  adapters: [
+    new RESTQueryAdapter({
+      fetch: globalThis.fetch,
+      baseUrl: 'https://api.example.com',
+    }),
+  ],
 });
 ```
 

package/plugin/docs/api/stores-sync.md

@@ -121,13 +121,19 @@ Internally, `SyncQueryStore` uses the following key prefixes in the underlying `
 ```ts
 import { QueryClient } from 'fetchium';
 import { SyncQueryStore, MemoryPersistentStore } from 'fetchium/stores/sync';
+import { RESTQueryAdapter } from 'fetchium/rest';
 
 // Create an in-memory store
 const store = new SyncQueryStore(new MemoryPersistentStore());
 
 // Create the query client
-const client = new QueryClient(store, {
-  fetch: globalThis.fetch,
-  baseUrl: 'https://api.example.com',
+const client = new QueryClient({
+  store,
+  adapters: [
+    new RESTQueryAdapter({
+      fetch: globalThis.fetch,
+      baseUrl: 'https://api.example.com',
+    }),
+  ],
 });
 ```

package/plugin/docs/core/entities.md

@@ -171,7 +171,7 @@ class User extends Entity {
   }
 
   greet() {
-    return `Hello, ${this.name}!`;
+    return `Hello, ${this.fullName}!`;
   }
 
   isAdult() {
@@ -185,7 +185,7 @@ Methods work on entity proxies just like regular methods:
 ```tsx
 const user = result.user;
 user.fullName; // "Alice Smith"
-user.greet(); // "Hello, Alice!"
+user.greet(); // "Hello, Alice Smith!"
 user.isAdult(); // true
 ```
 

package/plugin/docs/core/queries.md

@@ -163,17 +163,16 @@ interface ReactivePromise<T> {
 
 ```ts
 type QueryResult<Q extends Query> = Q['result'] & {
-  __refetch(): Promise<Q['result']>;
+  __refetch(): QueryPromise<Q>;
   __fetchNext(): Promise<Q['result']>;
+  __hasNext: boolean;
+  __isFetchingNext: boolean;
 };
 
 declare function useQuery<Q extends Query>(
-  query: Q,
-  params: Q['params'],
-  opts?: {
-    suspended?: boolean;
-  },
-): ReactivePromise<QueryResult<Q>>;
+  QueryClass: new () => Q,
+  params?: ExtractQueryParams<Q>,
+): QueryPromise<Q>;
 ```
 
 The reason `__refetch` and `__fetchNext` are defined on the _result_ of the query and not the `ReactivePromise` is about composability, which leads us into usage within Signalium.
@@ -190,27 +189,21 @@ import { GetCurrentUser, GetUserProfile } from './queries';
 
 export function UserProfile() {
   const userResult = useQuery(GetCurrentUser);
-  const userProfileResult = useQuery(
-    GetUserProfile,
-    { user },
-    { suspended: !user },
+  const userProfileResult = useQuery(GetUserProfile, {
+    user: userResult.value,
   });
 
   if (userResult.isRejected || userProfileResult.isRejected) {
     const message =
-      userResult.error?.message ||
-      userProfileResult.error?.message;
+      userResult.error?.message || userProfileResult.error?.message;
 
-    return <div>
-	    Error: {message}
-	</div>;
+    return <div>Error: {message}</div>;
   }
 
   if (!userResult.isReady || !userProfileResult.isReady) {
-	return <div>Loading...</div>;
+    return <div>Loading...</div>;
   }
 
-
   return (
     <div>
       <h1>{userProfileResult.value.name}</h1>
@@ -344,7 +337,7 @@ class GetUser extends RESTQuery {
 }
 ```
 
-By convention, every field provided by `RESTQuery` and other query implementations has a corresponding `get*` method. So for `path` there is `getPath`, for `headers` there is `getHeaders`, etc.
+By convention, most fields provided by `RESTQuery` and other query implementations have a corresponding `get*` method. So for `path` there is `getPath`, for `searchParams` there is `getSearchParams`, for `body` there is `getBody`, and so on.
 
 {% callout title="API design by TypeScript limitations" type="note" %}
 The original API design for this feature allowed getters in place of fields, so `get path() {}` would work as well. The issue was that TypeScript does not allow this specific combination on abstract classes at the moment. See [this issue](https://github.com/microsoft/TypeScript/issues/40635) for more information.

package/plugin/docs/core/streaming.md

@@ -139,7 +139,7 @@ A topic query extends `TopicQuery` and provides a `topic` field and a `result` s
 import { t } from 'fetchium';
 import { TopicQuery } from 'fetchium/topic';
 
-class GetPrices extends MyTopicQuery {
+class GetPrices extends TopicQuery {
   topic = 'prices:live';
 
   result = {
@@ -151,7 +151,7 @@ class GetPrices extends MyTopicQuery {
 Topics can be parameterized using `this.params`, just like paths in `RESTQuery`:
 
 ```tsx
-class GetBalances extends MyTopicQuery {
+class GetBalances extends TopicQuery {
   params = { walletId: t.string };
 
   topic = `balances:${this.params.walletId}`;
@@ -231,13 +231,11 @@ const queryClient = new QueryClient({
 });
 ```
 
-Then make your topic query classes reference the adapter:
+Topic query classes that extend `TopicQuery` directly resolve to the registered `MyStreamAdapter` automatically. Internally, `TopicQuery` declares `static adapter = TopicQueryAdapter` (the abstract base), and `QueryClient` looks up registered adapters by `instanceof` match, so any subclass of `TopicQueryAdapter` you register fulfills the lookup.
 
-```tsx
-abstract class MyTopicQuery extends TopicQuery {
-  static override adapter = MyStreamAdapter;
-}
-```
+{% callout title="One streaming adapter per QueryClient" %}
+Register at most one `TopicQueryAdapter` subclass on a given `QueryClient`. If your app needs multiple streaming protocols, create a separate `QueryClient` for each. Dev builds throw if more than one registered adapter satisfies the same lookup.
+{% /callout %}
 
 ### Pre-fulfillment
 
@@ -515,7 +513,7 @@ In practice, most applications combine multiple real-time strategies:
 
 ```tsx
 // Topic-based streaming for live market data
-class GetPrices extends MyTopicQuery {
+class GetPrices extends TopicQuery {
   topic = 'prices:live';
   result = { prices: t.liveArray(Price) };
 }

package/plugin/docs/data/mutations.md

@@ -364,7 +364,7 @@ import { Mutation, t } from 'fetchium';
 class UploadAvatar extends Mutation {
   static override adapter = MyAdapter;
 
-  params = { userId: t.id, file: t.any };
+  params = { userId: t.id };
   result = { url: t.string };
 
   getIdentityKey() {

package/plugin/docs/guides/auth.md

@@ -2,7 +2,7 @@
 title: Auth & Headers
 ---
 
-In most data-fetching libraries, authentication is handled through interceptors, middleware chains, or framework-specific hooks. Fetchium takes a different approach: authentication is handled through the `fetch` function you pass to the `QueryClient`.
+In most data-fetching libraries, authentication is handled through interceptors, middleware chains, or framework-specific hooks. Fetchium takes a different approach: authentication is handled through the `fetch` function you pass to the `RESTQueryAdapter`.
 
 This is intentional. Rather than adding a framework-specific interceptor system, Fetchium leverages the web platform's standard `fetch` API. Your auth logic is a _plain JavaScript function_ --- testable, portable, and completely decoupled from the library. You can unit test it without importing Fetchium, reuse it across projects, or swap it out without touching a single query definition.
 
@@ -12,7 +12,7 @@ This page covers the common patterns for adding authentication and custom header
 
 ## Global Headers via a Fetch Wrapper
 
-The simplest and most common pattern is wrapping the native `fetch` with a function that injects your auth token on every request. You pass this wrapper to the `QueryClient` at setup time, and every query uses it automatically.
+The simplest and most common pattern is wrapping the native `fetch` with a function that injects your auth token on every request. You pass this wrapper to the `RESTQueryAdapter` at setup time, and every query uses it automatically.
 
 ```ts
 function createAuthFetch(getToken: () => string | null) {
@@ -28,9 +28,13 @@ function createAuthFetch(getToken: () => string | null) {
   };
 }
 
-const client = new QueryClient(store, {
-  fetch: createAuthFetch(() => localStorage.getItem('auth_token')),
-  baseUrl: 'https://api.example.com',
+const client = new QueryClient({
+  adapters: [
+    new RESTQueryAdapter({
+      fetch: createAuthFetch(() => localStorage.getItem('auth_token')),
+      baseUrl: 'https://api.example.com',
+    }),
+  ],
 });
 ```
 
@@ -45,13 +49,17 @@ Notice that `createAuthFetch` accepts a _getter function_ rather than the token
 If your API uses a static key rather than a user token, the pattern is even simpler:
 
 ```ts
-const client = new QueryClient(store, {
-  fetch: async (url, init) => {
-    const headers = new Headers(init?.headers);
-    headers.set('X-API-Key', process.env.API_KEY!);
-    return fetch(url, { ...init, headers });
-  },
-  baseUrl: 'https://api.example.com',
+const client = new QueryClient({
+  adapters: [
+    new RESTQueryAdapter({
+      fetch: async (url, init) => {
+        const headers = new Headers(init?.headers);
+        headers.set('X-API-Key', process.env.API_KEY!);
+        return fetch(url, { ...init, headers });
+      },
+      baseUrl: 'https://api.example.com',
+    }),
+  ],
 });
 ```
 
@@ -93,9 +101,13 @@ function createReactiveAuthFetch() {
   };
 }
 
-const client = new QueryClient(store, {
-  fetch: createReactiveAuthFetch(),
-  baseUrl: 'https://api.example.com',
+const client = new QueryClient({
+  adapters: [
+    new RESTQueryAdapter({
+      fetch: createReactiveAuthFetch(),
+      baseUrl: 'https://api.example.com',
+    }),
+  ],
 });
 ```
 
@@ -132,7 +144,7 @@ class UploadAvatar extends RESTQuery {
 
 The layering is straightforward: your global fetch wrapper handles _auth_ (the concern that applies everywhere), and per-query headers handle _API-specific needs_ (the concerns that vary by endpoint). The two are composed naturally --- `headers` from the query class are passed through `init.headers` to your fetch wrapper, which can merge them with auth headers using `new Headers(init?.headers)`.
 
-For dynamic per-query headers that depend on runtime conditions, use the `getHeaders()` method:
+For dynamic per-query headers that depend on runtime conditions, use `getRequestOptions()` to include headers as part of the fetch options:
 
 ```ts
 class GetReport extends RESTQuery {
@@ -143,14 +155,11 @@ class GetReport extends RESTQuery {
 
   path = `/reports/${this.params.reportId}`;
 
-  getHeaders() {
-    const headers: Record<string, string> = {};
-
+  getRequestOptions() {
     if (this.params.format === 'csv') {
-      headers['Accept'] = 'text/csv';
+      return { headers: { Accept: 'text/csv' } };
     }
-
-    return headers;
+    return undefined;
   }
 
   result = {
@@ -159,7 +168,7 @@ class GetReport extends RESTQuery {
 }
 ```
 
-As described in the [Queries](/core/queries) guide, every field on `RESTQuery` has a corresponding `get*()` method for when you need logic that goes beyond simple references and interpolations.
+As described in the [Queries](/core/queries) guide, most fields on `RESTQuery` have a corresponding `get*()` method for when you need logic that goes beyond simple references and interpolations.
 
 ---
 
@@ -215,13 +224,17 @@ A few things to note in this pattern:
 Wire it into your client the same way:
 
 ```ts
-const client = new QueryClient(store, {
-  fetch: createAuthFetchWithRefresh(
-    () => authToken.value,
-    () => api.refreshSession(),
-    (token) => authToken.set(token),
-  ),
-  baseUrl: 'https://api.example.com',
+const client = new QueryClient({
+  adapters: [
+    new RESTQueryAdapter({
+      fetch: createAuthFetchWithRefresh(
+        () => authToken.value,
+        () => api.refreshSession(),
+        (token) => authToken.set(token),
+      ),
+      baseUrl: 'https://api.example.com',
+    }),
+  ],
 });
 ```
 
@@ -236,18 +249,28 @@ If your application talks to multiple APIs with different auth schemes --- for i
 The cleanest approach is creating a dedicated `QueryClient` for each backend:
 
 ```ts
-const appClient = new QueryClient(appStore, {
-  fetch: createAuthFetch(() => authToken.value),
-  baseUrl: 'https://api.myapp.com',
+const appClient = new QueryClient({
+  store: appStore,
+  adapters: [
+    new RESTQueryAdapter({
+      fetch: createAuthFetch(() => authToken.value),
+      baseUrl: 'https://api.myapp.com',
+    }),
+  ],
 });
 
-const analyticsClient = new QueryClient(analyticsStore, {
-  fetch: async (url, init) => {
-    const headers = new Headers(init?.headers);
-    headers.set('X-API-Key', ANALYTICS_API_KEY);
-    return fetch(url, { ...init, headers });
-  },
-  baseUrl: 'https://analytics.example.com',
+const analyticsClient = new QueryClient({
+  store: analyticsStore,
+  adapters: [
+    new RESTQueryAdapter({
+      fetch: async (url, init) => {
+        const headers = new Headers(init?.headers);
+        headers.set('X-API-Key', ANALYTICS_API_KEY);
+        return fetch(url, { ...init, headers });
+      },
+      baseUrl: 'https://analytics.example.com',
+    }),
+  ],
 });
 ```
 
@@ -294,12 +317,12 @@ This is a deliberate design decision. Fetchium favors _composition over configur
 | Global fetch wrapper               | Auth that applies to all requests (JWT, session cookies, API keys) |
 | Reactive signal token              | SPAs where auth state changes at runtime (login/logout)            |
 | Per-query `headers`                | Endpoint-specific headers (content types, API versions)            |
-| `getHeaders()` method              | Dynamic per-query headers based on runtime conditions              |
+| `getRequestOptions()` method       | Dynamic per-query headers based on runtime conditions              |
 | 401 catch + refresh + retry        | Token expiration with automatic renewal                            |
 | Multiple `QueryClient` instances   | Different APIs with different auth schemes or stores               |
 | Per-query `requestOptions.baseUrl` | Same auth, different host                                          |
 
-The common thread is that Fetchium does not own your auth logic. It provides the _seam_ --- the `fetch` option on `QueryClient` --- and you fill it with whatever your application needs. This keeps the library small, your auth testable, and your options open.
+The common thread is that Fetchium does not own your auth logic. It provides the _seam_ --- the `fetch` option on `RESTQueryAdapter` --- and you fill it with whatever your application needs. This keeps the library small, your auth testable, and your options open.
 
 ---