fetchium 0.2.2 → 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-CS4iUKWj.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-B1EiA34B.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-B1EiA34B.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-CS4iUKWj.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-B1EiA34B.js.map
+//# sourceMappingURL=mutation-YpiJLNWU.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"mutation-B1EiA34B.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;"}
+{"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-CS4iUKWj.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-CS4iUKWj.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-B1EiA34B.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-CS4iUKWj.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 { 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  static override adapter: QueryAdapterClass<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":";;AASO,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;ACPO,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/topic/TopicQuery.d.ts

@@ -1,5 +1,5 @@
 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 {

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,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAM5D,8BAAsB,UAAW,SAAQ,KAAK;IAC5C,OAAgB,OAAO,EAAE,iBAAiB,CAAC,iBAAiB,CAAC,CAAC;IAE9D,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.2",
+  "version": "0.2.3",
   "type": "module",
   "repository": {
     "type": "git",

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) };
 }