fetchium 0.1.1 → 0.2.0

package/dist/esm/development/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 l, Q as C, f, g as N, h as Q, R as k, i as d, j as m, k as p, q as E, r as R, t as w } from "./QueryClient-Dtde3pss.js";
-import { Q as F } from "./QueryController-Ch_ncxiI.js";
-import { M as K, g as Y, m as A } from "./mutation-UZshUQAf.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-BajBmpnA.js";
+import { Q as F } from "./QueryAdapter-Bu5UJjE4.js";
+import { M as A, g as K, m as Y } from "./mutation-DAOZE4Ok.js";
 export {
   r as ARRAY_KEY,
   s as Entity,
@@ -8,23 +8,23 @@ export {
   o as LiveFieldConfig,
   n as LiveFieldType,
   i as Mask,
-  K as Mutation,
+  A as Mutation,
   M as NetworkManager,
   g as NetworkManagerContext,
   u as NetworkMode,
   y as NoOpGcManager,
-  l as NoOpNetworkManager,
+  f as NoOpNetworkManager,
   C as QUERY_ID,
-  f as Query,
-  N as QueryClient,
-  Q as QueryClientContext,
-  F as QueryController,
+  N as Query,
+  F as QueryAdapter,
+  Q as QueryClient,
+  d as QueryClientContext,
   k as RECORD_KEY,
-  d as defaultNetworkManager,
-  m as draft,
-  p as fetchQuery,
-  Y as getMutation,
-  A as mutationKeyForClass,
+  l as defaultNetworkManager,
+  p as draft,
+  m as fetchQuery,
+  K as getMutation,
+  Y as mutationKeyForClass,
   E as queryKeyForClass,
   R as registerFormat,
   w as t

package/dist/esm/development/{mutation-UZshUQAf.js → mutation-DAOZE4Ok.js}

@@ -1,7 +1,7 @@
 import { getContext as h } from "signalium";
-import { l as y, h as D, m as w, V as u, t as l } from "./QueryClient-Dtde3pss.js";
+import { l as y, h as D, m as w, V as u, t as d } from "./QueryClient-BajBmpnA.js";
 class x {
-  static controller;
+  static adapter;
   params;
   result;
   optimisticUpdates;
@@ -11,38 +11,38 @@ class x {
     return y(this);
   }
 }
-const c = /* @__PURE__ */ new WeakMap(), C = (t) => {
-  const e = c.get(t);
+const a = /* @__PURE__ */ new WeakMap(), C = (t) => {
+  const e = a.get(t);
   if (e === void 0)
     throw new Error("Mutation definition not found");
   return e().id;
 };
 function M(t) {
-  let e = c.get(t);
+  let e = a.get(t);
   if (e !== void 0)
     return e;
   let o;
-  const a = () => {
+  const c = () => {
     if (o !== void 0)
       return o;
-    const d = new t(), i = w(d), { fields: n } = i, m = `mutation:${String(i.methods.getIdentityKey.call(n))}`, s = n.params ?? {}, p = s instanceof u ? s : l.object(s), r = n.result, g = r !== void 0 ? r instanceof u ? r : l.object(r) : void 0, f = t.controller;
+    const p = new t(), i = w(p), { fields: n } = i, m = `mutation:${String(i.methods.getIdentityKey.call(n))}`, s = n.params ?? {}, g = s instanceof u ? s : d.object(s), r = n.result, l = r !== void 0 ? r instanceof u ? r : d.object(r) : void 0, f = t.adapter;
     if (!f)
       throw new Error(
-        `Mutation class "${t.name}" must define a static \`controller\` property. Extend RESTMutation (from fetchium/rest) or set \`static controller = MyController\` on your mutation class.`
+        `Mutation class "${t.name}" must define a static \`adapter\` property. Extend RESTMutation (from fetchium/rest) or set \`static adapter = MyAdapter\` on your mutation class.`
       );
     return o = {
       id: m,
-      requestShape: p,
-      responseShape: g,
+      requestShape: g,
+      responseShape: l,
       captured: i,
       optimisticUpdates: n.optimisticUpdates ?? !1,
       config: n.config,
       effects: n.effects,
       hasGetEffects: typeof i.methods.getEffects == "function",
-      controllerClass: f
+      adapterClass: f
     }, o;
   };
-  return c.set(t, a), a;
+  return a.set(t, c), c;
 }
 function S(t) {
   const e = M(t), o = h(D);
@@ -55,4 +55,4 @@ export {
   S as g,
   C as m
 };
-//# sourceMappingURL=mutation-UZshUQAf.js.map
+//# sourceMappingURL=mutation-DAOZE4Ok.js.map

package/dist/esm/development/mutation-DAOZE4Ok.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation-DAOZE4Ok.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 } 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: typeof QueryAdapter;\n}\n\n// ================================\n// Mutation base class\n// ================================\n\nexport abstract class Mutation {\n  static adapter?: typeof QueryAdapter;\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/development/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-Dtde3pss.js";
+import { k as u } from "../QueryClient-BajBmpnA.js";
 function n(e) {
   if (Array.isArray(e))
     return e.map(n);

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

@@ -1,6 +1,6 @@
-import { n as v, o as U, f as O } from "../QueryClient-Dtde3pss.js";
-import { Q as T } from "../QueryController-Ch_ncxiI.js";
-import { M as w } from "../mutation-UZshUQAf.js";
+import { n as v, o as U, f as O } from "../QueryClient-BajBmpnA.js";
+import { Q as T } from "../QueryAdapter-Bu5UJjE4.js";
+import { M as w } from "../mutation-DAOZE4Ok.js";
 class P extends T {
   _fetch;
   _baseUrl;
@@ -48,7 +48,7 @@ class P extends T {
    *
    * - Absolute URLs (`https://...`, `//...`) are returned as-is.
    * - Root-relative paths (`/foo`) are prepended with the resolved baseUrl.
-   *   The baseUrl priority is: per-query/mutation > controller-level > `location.origin`.
+   *   The baseUrl priority is: per-query/mutation > adapter-level > `location.origin`.
    *   If none is available and the path is root-relative, an error is thrown.
    * - Other paths (e.g. `example.com/foo`) are returned as-is.
    */
@@ -59,57 +59,57 @@ class P extends T {
       const t = U(s) ?? U(this._baseUrl) ?? globalThis.location?.origin;
       if (!t)
         throw new Error(
-          `RESTQueryController: cannot resolve URL for path "${e}". Set \`baseUrl\` on the query/mutation, pass it to \`new RESTQueryController({ baseUrl })\`, or use an absolute URL.`
+          `RESTQueryAdapter: cannot resolve URL for path "${e}". Set \`baseUrl\` on the query/mutation, pass it to \`new RESTQueryAdapter({ baseUrl })\`, or use an absolute URL.`
         );
       return `${t}${e}`;
     }
     return e;
   }
   async executeRequest(e, s, t) {
-    const r = t?.url ?? (e.getPath ? e.getPath() : e.path), h = e.getMethod ? e.getMethod() : e.method, o = e.getSearchParams ? e.getSearchParams() : e.searchParams, a = t?.searchParams ? { ...o, ...t.searchParams } : o, n = e.getBody ? e.getBody() : e.body, i = e.getRequestOptions ? e.getRequestOptions() : e.requestOptions;
+    const r = t?.url ?? (e.getPath ? e.getPath() : e.path), h = e.getMethod ? e.getMethod() : e.method, a = e.getSearchParams ? e.getSearchParams() : e.searchParams, o = t?.searchParams ? { ...a, ...t.searchParams } : a, n = e.getBody ? e.getBody() : e.body, i = e.getRequestOptions ? e.getRequestOptions() : e.requestOptions;
     if (!r)
       throw new Error("RESTQuery requires a path. Define `path` as a field or override `getPath()`.");
     let l = r;
-    if (a) {
+    if (o) {
       const y = new URLSearchParams();
-      for (const b in a) {
-        const c = a[b];
-        c != null && y.append(b, String(c));
+      for (const b in o) {
+        const u = o[b];
+        u != null && y.append(b, String(u));
       }
       const m = y.toString();
       m && (l += "?" + m);
     }
-    const f = i?.baseUrl ?? e.baseUrl, u = this.buildUrl(l, f), { baseUrl: g, signal: R, ...q } = i ?? {}, S = n || e.headers ? {
+    const f = i?.baseUrl ?? e.baseUrl, d = this.buildUrl(l, f), { baseUrl: p, signal: R, ...q } = i ?? {}, S = n || e.headers ? {
       ...n ? { "Content-Type": "application/json" } : void 0,
       ...e.headers
-    } : void 0, p = await this._fetch(u, {
+    } : void 0, g = await this._fetch(d, {
       method: h,
       headers: S,
       body: n ? JSON.stringify(n) : void 0,
       signal: s,
       ...q
     });
-    return e.response = p, p.json();
+    return e.response = g, g.json();
   }
   async sendMutation(e, s) {
-    const t = e, r = t.getPath ? t.getPath() : t.path, h = t.getMethod ? t.getMethod() : t.method, o = t.getBody ? t.getBody() : t.body, a = t.getRequestOptions ? t.getRequestOptions() : t.requestOptions;
+    const t = e, r = t.getPath ? t.getPath() : t.path, h = t.getMethod ? t.getMethod() : t.method, a = t.getBody ? t.getBody() : t.body, o = t.getRequestOptions ? t.getRequestOptions() : t.requestOptions;
     if (!r)
       throw new Error("RESTMutation requires a path. Define `path` as a field or override `getPath()`.");
-    const n = a?.baseUrl ?? t.baseUrl, i = this.buildUrl(r, n), { baseUrl: l, signal: f, ...u } = a ?? {}, g = {
-      ...o !== void 0 ? { "Content-Type": "application/json" } : {},
+    const n = o?.baseUrl ?? t.baseUrl, i = this.buildUrl(r, n), { baseUrl: l, signal: f, ...d } = o ?? {}, p = {
+      ...a !== void 0 ? { "Content-Type": "application/json" } : {},
       ...t.headers
     };
     return (await this._fetch(i, {
       method: h,
-      headers: g,
-      ...o !== void 0 ? { body: JSON.stringify(o) } : {},
+      headers: p,
+      ...a !== void 0 ? { body: JSON.stringify(a) } : {},
       signal: s,
-      ...u
+      ...d
     })).json();
   }
 }
-class M extends O {
-  static controller = P;
+class Q extends O {
+  static adapter = P;
   method = "GET";
   path;
   baseUrl;
@@ -122,8 +122,8 @@ class M extends O {
     return `${this.method ?? "GET"}:${this.path ?? ""}`;
   }
 }
-class Q extends w {
-  static controller = P;
+class B extends w {
+  static adapter = P;
   path;
   baseUrl;
   method = "POST";
@@ -135,8 +135,8 @@ class Q extends w {
   }
 }
 export {
-  Q as RESTMutation,
-  M as RESTQuery,
-  P as RESTQueryController
+  B as RESTMutation,
+  Q as RESTQuery,
+  P as RESTQueryAdapter
 };
 //# sourceMappingURL=index.js.map

package/dist/esm/development/rest/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../../src/rest/RESTQueryController.ts","../../../../src/rest/RESTQuery.ts","../../../../src/rest/RESTMutation.ts"],"sourcesContent":["import { QueryController } from '../QueryController.js';\nimport { resolveBaseUrl } from '../query-types.js';\nimport { reifyValue } from '../fieldRef.js';\nimport type { Query } from '../query.js';\nimport type { Mutation } from '../mutation.js';\nimport type { FetchNextConfig } from '../query-types.js';\nimport type { RESTQuery } from './RESTQuery.js';\nimport type { RESTMutation } from './RESTMutation.js';\nimport type { QueryRequestInit, BaseUrlValue, QueryRequestOptions } from '../types.js';\n\n// ================================\n// ResolvedFetchNext\n// ================================\n\nexport interface ResolvedFetchNext {\n  url?: string;\n  searchParams?: Record<string, unknown>;\n}\n\n// ================================\n// RESTQueryController options\n// ================================\n\nexport interface RESTQueryControllerOptions {\n  fetch?: (url: string, init?: QueryRequestInit) => Promise<Response>;\n  baseUrl?: BaseUrlValue;\n}\n\n// ================================\n// RESTQueryController\n// ================================\n\nexport class RESTQueryController extends QueryController {\n  private readonly _fetch: (url: string, init?: QueryRequestInit) => Promise<Response>;\n  private readonly _baseUrl: BaseUrlValue | undefined;\n\n  constructor(options?: RESTQueryControllerOptions) {\n    super();\n    this._fetch =\n      options?.fetch ?? (globalThis.fetch as unknown as (url: string, init?: QueryRequestInit) => Promise<Response>);\n    this._baseUrl = options?.baseUrl;\n  }\n\n  override async send(ctx: Query, signal: AbortSignal): Promise<unknown> {\n    return this.executeRequest(ctx as RESTQuery, signal);\n  }\n\n  override async sendNext(ctx: Query, signal: AbortSignal): Promise<unknown> {\n    const resolved = this.resolveFetchNext(ctx as RESTQuery);\n    if (resolved === undefined) {\n      throw new Error('fetchNext is not configured for this query');\n    }\n    return this.executeRequest(ctx as RESTQuery, signal, resolved);\n  }\n\n  override hasNext(ctx: Query): boolean {\n    const resolved = this.resolveFetchNext(ctx as RESTQuery);\n    if (resolved === undefined) return false;\n\n    if (resolved.url !== undefined && resolved.url !== null) {\n      return true;\n    }\n\n    if (resolved.searchParams !== undefined) {\n      const keys = Object.keys(resolved.searchParams);\n      if (keys.length === 0) return false;\n      for (const key of keys) {\n        if (resolved.searchParams[key] === undefined || resolved.searchParams[key] === null) {\n          return false;\n        }\n      }\n      return true;\n    }\n\n    return false;\n  }\n\n  private resolveFetchNext(ctx: RESTQuery): ResolvedFetchNext | undefined {\n    const dynamicConfig = ctx.getFetchNext ? ctx.getFetchNext() : undefined;\n    const fetchNextConfig: FetchNextConfig | undefined = dynamicConfig ?? ctx.rawFetchNext;\n    if (fetchNextConfig === undefined) return undefined;\n\n    const resolveRoot: Record<string, unknown> = {\n      params: ctx.params ?? {},\n      result: ctx.resultData,\n    };\n\n    return {\n      url: fetchNextConfig.url !== undefined ? (reifyValue(fetchNextConfig.url, resolveRoot) as string) : undefined,\n      searchParams:\n        fetchNextConfig.searchParams !== undefined\n          ? (reifyValue(fetchNextConfig.searchParams, resolveRoot) as Record<string, unknown>)\n          : undefined,\n    };\n  }\n\n  /**\n   * Resolves a path to a full URL.\n   *\n   * - Absolute URLs (`https://...`, `//...`) are returned as-is.\n   * - Root-relative paths (`/foo`) are prepended with the resolved baseUrl.\n   *   The baseUrl priority is: per-query/mutation > controller-level > `location.origin`.\n   *   If none is available and the path is root-relative, an error is thrown.\n   * - Other paths (e.g. `example.com/foo`) are returned as-is.\n   */\n  private buildUrl(path: string, ctxBaseUrl: BaseUrlValue | undefined): string {\n    // Absolute URL — use as-is regardless of any configured baseUrl\n    if (path.startsWith('http://') || path.startsWith('https://') || path.startsWith('//')) {\n      return path;\n    }\n\n    // Root-relative path — needs a base\n    if (path.startsWith('/')) {\n      const base = resolveBaseUrl(ctxBaseUrl) ?? resolveBaseUrl(this._baseUrl) ?? globalThis.location?.origin;\n\n      if (!base) {\n        throw new Error(\n          `RESTQueryController: cannot resolve URL for path \"${path}\". ` +\n            `Set \\`baseUrl\\` on the query/mutation, pass it to \\`new RESTQueryController({ baseUrl })\\`, ` +\n            `or use an absolute URL.`,\n        );\n      }\n\n      return `${base}${path}`;\n    }\n\n    // Relative path — use as-is\n    return path;\n  }\n\n  private async executeRequest(\n    ctx: RESTQuery,\n    signal: AbortSignal,\n    next?: { url?: string; searchParams?: Record<string, unknown> },\n  ): Promise<unknown> {\n    const path = next?.url ?? (ctx.getPath ? ctx.getPath() : ctx.path);\n    const method = ctx.getMethod ? ctx.getMethod() : ctx.method;\n    const baseSearchParams = ctx.getSearchParams ? ctx.getSearchParams() : ctx.searchParams;\n    const searchParams = next?.searchParams ? { ...baseSearchParams, ...next.searchParams } : baseSearchParams;\n    const body = ctx.getBody ? ctx.getBody() : ctx.body;\n    const requestOptions = ctx.getRequestOptions ? ctx.getRequestOptions() : ctx.requestOptions;\n\n    if (!path) {\n      throw new Error('RESTQuery requires a path. Define `path` as a field or override `getPath()`.');\n    }\n\n    let url = path;\n\n    if (searchParams) {\n      const sp = new URLSearchParams();\n      for (const key in searchParams) {\n        const val = searchParams[key];\n        if (val !== undefined && val !== null) {\n          sp.append(key, String(val));\n        }\n      }\n      const qs = sp.toString();\n      if (qs) {\n        url += '?' + qs;\n      }\n    }\n\n    const ctxBaseUrl = requestOptions?.baseUrl ?? ctx.baseUrl;\n    const fullUrl = this.buildUrl(url, ctxBaseUrl);\n\n    const { baseUrl: _baseUrl, signal: _signal, ...fetchOptions } = requestOptions ?? ({} as Record<string, unknown>);\n\n    const hasHeaders = body || ctx.headers;\n    const headers: HeadersInit | undefined = hasHeaders\n      ? {\n          ...(body ? { 'Content-Type': 'application/json' } : undefined),\n          ...(ctx.headers as Record<string, string>),\n        }\n      : undefined;\n\n    const fetchResponse = await this._fetch(fullUrl, {\n      method,\n      headers,\n      body: body ? JSON.stringify(body) : undefined,\n      signal,\n      ...fetchOptions,\n    });\n\n    ctx.response = fetchResponse as unknown as Response;\n\n    return fetchResponse.json();\n  }\n\n  override async sendMutation(ctx: Mutation, signal: AbortSignal): Promise<unknown> {\n    const restCtx = ctx as RESTMutation;\n    const path = restCtx.getPath ? restCtx.getPath() : restCtx.path;\n    const method = restCtx.getMethod ? restCtx.getMethod() : restCtx.method;\n    const body = restCtx.getBody ? restCtx.getBody() : restCtx.body;\n    const requestOptions = restCtx.getRequestOptions ? restCtx.getRequestOptions() : restCtx.requestOptions;\n\n    if (!path) {\n      throw new Error('RESTMutation requires a path. Define `path` as a field or override `getPath()`.');\n    }\n\n    const ctxBaseUrl = (requestOptions as QueryRequestOptions | undefined)?.baseUrl ?? restCtx.baseUrl;\n    const fullUrl = this.buildUrl(path, ctxBaseUrl);\n\n    const { baseUrl: _baseUrl, signal: _signal, ...fetchOptions } = (requestOptions ?? {}) as Record<string, unknown>;\n\n    const headers: HeadersInit = {\n      ...(body !== undefined ? { 'Content-Type': 'application/json' } : {}),\n      ...(restCtx.headers as Record<string, string>),\n    };\n\n    const fetchResponse = await this._fetch(fullUrl, {\n      method,\n      headers,\n      ...(body !== undefined ? { body: JSON.stringify(body) } : {}),\n      signal,\n      ...fetchOptions,\n    });\n\n    return fetchResponse.json();\n  }\n}\n","import { Query } from '../query.js';\nimport { RESTQueryController } from './RESTQueryController.js';\nimport type { FetchNextConfig } from '../query-types.js';\nimport type { BaseUrlValue, QueryRequestOptions } from '../types.js';\n\n// ================================\n// RESTQuery — declarative HTTP query definition\n// ================================\n\nexport abstract class RESTQuery extends Query {\n  static override controller = RESTQueryController;\n\n  method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' = 'GET';\n  path?: string;\n  baseUrl?: BaseUrlValue;\n  searchParams?: Record<string, unknown>;\n  body?: Record<string, unknown>;\n  headers?: HeadersInit;\n  requestOptions?: QueryRequestOptions;\n  fetchNext?: FetchNextConfig;\n\n  declare response: Response | undefined;\n\n  getIdentityKey(): string {\n    return `${this.method ?? 'GET'}:${this.path ?? ''}`;\n  }\n\n  // User-overridable getters — the controller reads these from the execution context\n  getPath?(): string | undefined;\n  getMethod?(): string;\n  getSearchParams?(): Record<string, unknown> | undefined;\n  getBody?(): Record<string, unknown> | undefined;\n  getRequestOptions?(): QueryRequestOptions | undefined;\n  getFetchNext?(): FetchNextConfig | undefined;\n}\n","import { Mutation } from '../mutation.js';\nimport type { BaseUrlValue, QueryRequestOptions } from '../types.js';\nimport { RESTQueryController } from './RESTQueryController.js';\n\nexport abstract class RESTMutation extends Mutation {\n  static override controller = RESTQueryController;\n\n  path?: string;\n  baseUrl?: BaseUrlValue;\n  method: 'POST' | 'PUT' | 'DELETE' | 'PATCH' = 'POST';\n  body?: Record<string, unknown>;\n  headers?: HeadersInit;\n  requestOptions?: QueryRequestOptions;\n\n  getIdentityKey(): string {\n    return `${this.method ?? 'POST'}:${this.path ?? ''}`;\n  }\n\n  getPath?(): string | undefined;\n  getMethod?(): string;\n  getBody?(): Record<string, unknown> | undefined;\n  getRequestOptions?(): QueryRequestOptions | undefined;\n}\n"],"names":["RESTQueryController","QueryController","options","ctx","signal","resolved","keys","key","fetchNextConfig","resolveRoot","reifyValue","path","ctxBaseUrl","base","resolveBaseUrl","next","method","baseSearchParams","searchParams","body","requestOptions","url","sp","val","qs","fullUrl","_baseUrl","_signal","fetchOptions","headers","fetchResponse","restCtx","RESTQuery","Query","RESTMutation","Mutation"],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../../../../src/rest/RESTQueryAdapter.ts","../../../../src/rest/RESTQuery.ts","../../../../src/rest/RESTMutation.ts"],"sourcesContent":["import { QueryAdapter } from '../QueryAdapter.js';\nimport { resolveBaseUrl } from '../query-types.js';\nimport { reifyValue } from '../fieldRef.js';\nimport type { Query } from '../query.js';\nimport type { Mutation } from '../mutation.js';\nimport type { FetchNextConfig } from '../query-types.js';\nimport type { RESTQuery } from './RESTQuery.js';\nimport type { RESTMutation } from './RESTMutation.js';\nimport type { QueryRequestInit, BaseUrlValue, QueryRequestOptions } from '../types.js';\n\n// ================================\n// ResolvedFetchNext\n// ================================\n\nexport interface ResolvedFetchNext {\n  url?: string;\n  searchParams?: Record<string, unknown>;\n}\n\n// ================================\n// RESTQueryAdapter options\n// ================================\n\nexport interface RESTQueryAdapterOptions {\n  fetch?: (url: string, init?: QueryRequestInit) => Promise<Response>;\n  baseUrl?: BaseUrlValue;\n}\n\n// ================================\n// RESTQueryAdapter\n// ================================\n\nexport class RESTQueryAdapter extends QueryAdapter {\n  private readonly _fetch: (url: string, init?: QueryRequestInit) => Promise<Response>;\n  private readonly _baseUrl: BaseUrlValue | undefined;\n\n  constructor(options?: RESTQueryAdapterOptions) {\n    super();\n    this._fetch =\n      options?.fetch ?? (globalThis.fetch as unknown as (url: string, init?: QueryRequestInit) => Promise<Response>);\n    this._baseUrl = options?.baseUrl;\n  }\n\n  override async send(ctx: Query, signal: AbortSignal): Promise<unknown> {\n    return this.executeRequest(ctx as RESTQuery, signal);\n  }\n\n  override async sendNext(ctx: Query, signal: AbortSignal): Promise<unknown> {\n    const resolved = this.resolveFetchNext(ctx as RESTQuery);\n    if (resolved === undefined) {\n      throw new Error('fetchNext is not configured for this query');\n    }\n    return this.executeRequest(ctx as RESTQuery, signal, resolved);\n  }\n\n  override hasNext(ctx: Query): boolean {\n    const resolved = this.resolveFetchNext(ctx as RESTQuery);\n    if (resolved === undefined) return false;\n\n    if (resolved.url !== undefined && resolved.url !== null) {\n      return true;\n    }\n\n    if (resolved.searchParams !== undefined) {\n      const keys = Object.keys(resolved.searchParams);\n      if (keys.length === 0) return false;\n      for (const key of keys) {\n        if (resolved.searchParams[key] === undefined || resolved.searchParams[key] === null) {\n          return false;\n        }\n      }\n      return true;\n    }\n\n    return false;\n  }\n\n  private resolveFetchNext(ctx: RESTQuery): ResolvedFetchNext | undefined {\n    const dynamicConfig = ctx.getFetchNext ? ctx.getFetchNext() : undefined;\n    const fetchNextConfig: FetchNextConfig | undefined = dynamicConfig ?? ctx.rawFetchNext;\n    if (fetchNextConfig === undefined) return undefined;\n\n    const resolveRoot: Record<string, unknown> = {\n      params: ctx.params ?? {},\n      result: ctx.resultData,\n    };\n\n    return {\n      url: fetchNextConfig.url !== undefined ? (reifyValue(fetchNextConfig.url, resolveRoot) as string) : undefined,\n      searchParams:\n        fetchNextConfig.searchParams !== undefined\n          ? (reifyValue(fetchNextConfig.searchParams, resolveRoot) as Record<string, unknown>)\n          : undefined,\n    };\n  }\n\n  /**\n   * Resolves a path to a full URL.\n   *\n   * - Absolute URLs (`https://...`, `//...`) are returned as-is.\n   * - Root-relative paths (`/foo`) are prepended with the resolved baseUrl.\n   *   The baseUrl priority is: per-query/mutation > adapter-level > `location.origin`.\n   *   If none is available and the path is root-relative, an error is thrown.\n   * - Other paths (e.g. `example.com/foo`) are returned as-is.\n   */\n  private buildUrl(path: string, ctxBaseUrl: BaseUrlValue | undefined): string {\n    // Absolute URL — use as-is regardless of any configured baseUrl\n    if (path.startsWith('http://') || path.startsWith('https://') || path.startsWith('//')) {\n      return path;\n    }\n\n    // Root-relative path — needs a base\n    if (path.startsWith('/')) {\n      const base = resolveBaseUrl(ctxBaseUrl) ?? resolveBaseUrl(this._baseUrl) ?? globalThis.location?.origin;\n\n      if (!base) {\n        throw new Error(\n          `RESTQueryAdapter: cannot resolve URL for path \"${path}\". ` +\n            `Set \\`baseUrl\\` on the query/mutation, pass it to \\`new RESTQueryAdapter({ baseUrl })\\`, ` +\n            `or use an absolute URL.`,\n        );\n      }\n\n      return `${base}${path}`;\n    }\n\n    // Relative path — use as-is\n    return path;\n  }\n\n  private async executeRequest(\n    ctx: RESTQuery,\n    signal: AbortSignal,\n    next?: { url?: string; searchParams?: Record<string, unknown> },\n  ): Promise<unknown> {\n    const path = next?.url ?? (ctx.getPath ? ctx.getPath() : ctx.path);\n    const method = ctx.getMethod ? ctx.getMethod() : ctx.method;\n    const baseSearchParams = ctx.getSearchParams ? ctx.getSearchParams() : ctx.searchParams;\n    const searchParams = next?.searchParams ? { ...baseSearchParams, ...next.searchParams } : baseSearchParams;\n    const body = ctx.getBody ? ctx.getBody() : ctx.body;\n    const requestOptions = ctx.getRequestOptions ? ctx.getRequestOptions() : ctx.requestOptions;\n\n    if (!path) {\n      throw new Error('RESTQuery requires a path. Define `path` as a field or override `getPath()`.');\n    }\n\n    let url = path;\n\n    if (searchParams) {\n      const sp = new URLSearchParams();\n      for (const key in searchParams) {\n        const val = searchParams[key];\n        if (val !== undefined && val !== null) {\n          sp.append(key, String(val));\n        }\n      }\n      const qs = sp.toString();\n      if (qs) {\n        url += '?' + qs;\n      }\n    }\n\n    const ctxBaseUrl = requestOptions?.baseUrl ?? ctx.baseUrl;\n    const fullUrl = this.buildUrl(url, ctxBaseUrl);\n\n    const { baseUrl: _baseUrl, signal: _signal, ...fetchOptions } = requestOptions ?? ({} as Record<string, unknown>);\n\n    const hasHeaders = body || ctx.headers;\n    const headers: HeadersInit | undefined = hasHeaders\n      ? {\n          ...(body ? { 'Content-Type': 'application/json' } : undefined),\n          ...(ctx.headers as Record<string, string>),\n        }\n      : undefined;\n\n    const fetchResponse = await this._fetch(fullUrl, {\n      method,\n      headers,\n      body: body ? JSON.stringify(body) : undefined,\n      signal,\n      ...fetchOptions,\n    });\n\n    ctx.response = fetchResponse as unknown as Response;\n\n    return fetchResponse.json();\n  }\n\n  override async sendMutation(ctx: Mutation, signal: AbortSignal): Promise<unknown> {\n    const restCtx = ctx as RESTMutation;\n    const path = restCtx.getPath ? restCtx.getPath() : restCtx.path;\n    const method = restCtx.getMethod ? restCtx.getMethod() : restCtx.method;\n    const body = restCtx.getBody ? restCtx.getBody() : restCtx.body;\n    const requestOptions = restCtx.getRequestOptions ? restCtx.getRequestOptions() : restCtx.requestOptions;\n\n    if (!path) {\n      throw new Error('RESTMutation requires a path. Define `path` as a field or override `getPath()`.');\n    }\n\n    const ctxBaseUrl = (requestOptions as QueryRequestOptions | undefined)?.baseUrl ?? restCtx.baseUrl;\n    const fullUrl = this.buildUrl(path, ctxBaseUrl);\n\n    const { baseUrl: _baseUrl, signal: _signal, ...fetchOptions } = (requestOptions ?? {}) as Record<string, unknown>;\n\n    const headers: HeadersInit = {\n      ...(body !== undefined ? { 'Content-Type': 'application/json' } : {}),\n      ...(restCtx.headers as Record<string, string>),\n    };\n\n    const fetchResponse = await this._fetch(fullUrl, {\n      method,\n      headers,\n      ...(body !== undefined ? { body: JSON.stringify(body) } : {}),\n      signal,\n      ...fetchOptions,\n    });\n\n    return fetchResponse.json();\n  }\n}\n","import { Query } from '../query.js';\nimport { RESTQueryAdapter } from './RESTQueryAdapter.js';\nimport type { FetchNextConfig } from '../query-types.js';\nimport type { BaseUrlValue, QueryRequestOptions } from '../types.js';\n\n// ================================\n// RESTQuery — declarative HTTP query definition\n// ================================\n\nexport abstract class RESTQuery extends Query {\n  static override adapter = RESTQueryAdapter;\n\n  method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' = 'GET';\n  path?: string;\n  baseUrl?: BaseUrlValue;\n  searchParams?: Record<string, unknown>;\n  body?: Record<string, unknown>;\n  headers?: HeadersInit;\n  requestOptions?: QueryRequestOptions;\n  fetchNext?: FetchNextConfig;\n\n  declare response: Response | undefined;\n\n  getIdentityKey(): string {\n    return `${this.method ?? 'GET'}:${this.path ?? ''}`;\n  }\n\n  // User-overridable getters — the adapter reads these from the execution context\n  getPath?(): string | undefined;\n  getMethod?(): string;\n  getSearchParams?(): Record<string, unknown> | undefined;\n  getBody?(): Record<string, unknown> | undefined;\n  getRequestOptions?(): QueryRequestOptions | undefined;\n  getFetchNext?(): FetchNextConfig | undefined;\n}\n","import { Mutation } from '../mutation.js';\nimport type { BaseUrlValue, QueryRequestOptions } from '../types.js';\nimport { RESTQueryAdapter } from './RESTQueryAdapter.js';\n\nexport abstract class RESTMutation extends Mutation {\n  static override adapter = RESTQueryAdapter;\n\n  path?: string;\n  baseUrl?: BaseUrlValue;\n  method: 'POST' | 'PUT' | 'DELETE' | 'PATCH' = 'POST';\n  body?: Record<string, unknown>;\n  headers?: HeadersInit;\n  requestOptions?: QueryRequestOptions;\n\n  getIdentityKey(): string {\n    return `${this.method ?? 'POST'}:${this.path ?? ''}`;\n  }\n\n  getPath?(): string | undefined;\n  getMethod?(): string;\n  getBody?(): Record<string, unknown> | undefined;\n  getRequestOptions?(): QueryRequestOptions | undefined;\n}\n"],"names":["RESTQueryAdapter","QueryAdapter","options","ctx","signal","resolved","keys","key","fetchNextConfig","resolveRoot","reifyValue","path","ctxBaseUrl","base","resolveBaseUrl","next","method","baseSearchParams","searchParams","body","requestOptions","url","sp","val","qs","fullUrl","_baseUrl","_signal","fetchOptions","headers","fetchResponse","restCtx","RESTQuery","Query","RESTMutation","Mutation"],"mappings":"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"}

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

@@ -1,7 +1,7 @@
-import { f as a } from "../QueryClient-Dtde3pss.js";
-import { Q as d } from "../QueryController-Ch_ncxiI.js";
-class g extends a {
-  static controller;
+import { f as l } from "../QueryClient-BajBmpnA.js";
+import { Q as d } from "../QueryAdapter-Bu5UJjE4.js";
+class g extends l {
+  static adapter;
   getIdentityKey() {
     return `topic:${this.topic}`;
   }
@@ -9,7 +9,7 @@ class g extends a {
     return {
       staleTime: 0,
       subscribe: () => () => {
-        this._topicController?.unsubscribe(this.topic);
+        this._topicAdapter?.unsubscribe(this.topic);
       }
     };
   }
@@ -54,7 +54,7 @@ class _ extends d {
   }
   async send(e, s) {
     const t = e;
-    t._topicController = this;
+    t._topicAdapter = this;
     const r = t.topic, i = this._topics.get(r);
     if (i)
       switch (i.status) {
@@ -65,11 +65,11 @@ class _ extends d {
         case "pending":
           return i.promise;
       }
-    let o, c;
-    const n = new Promise((p, u) => {
-      o = p, c = u;
+    let c, o;
+    const n = new Promise((a, u) => {
+      c = a, o = u;
     });
-    return this._topics.set(r, { status: "pending", promise: n, resolve: o, reject: c }), this.subscribe(r), n;
+    return this._topics.set(r, { status: "pending", promise: n, resolve: c, reject: o }), this.subscribe(r), n;
   }
   /**
    * Convenience wrapper — pushes a mutation event through the QueryClient
@@ -81,6 +81,6 @@ class _ extends d {
 }
 export {
   g as TopicQuery,
-  _ as TopicQueryController
+  _ as TopicQueryAdapter
 };
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../../src/topic/TopicQuery.ts","../../../../src/topic/TopicQueryController.ts"],"sourcesContent":["import { Query } from '../query.js';\nimport type { TopicQueryController } from './TopicQueryController.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 controller: typeof TopicQueryController;\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 controller = (this as Record<string, any>)._topicController as TopicQueryController | undefined;\n          controller?.unsubscribe(this.topic);\n        };\n      },\n    };\n  }\n}\n","import { QueryController } from '../QueryController.js';\nimport type { Query } from '../query.js';\nimport type { MutationEvent } from '../types.js';\n\n// ================================\n// TopicQueryController — abstract controller for topic-based subscriptions\n// ================================\n\ninterface TopicCtx extends Query {\n  topic: string;\n  _topicController?: TopicQueryController;\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 TopicQueryController extends QueryController {\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._topicController = 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","TopicQueryController","QueryController","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,QADoB,KAA6B,kBACrC,YAAY,KAAK,KAAK;AAAA,MACpC;AAAA,IACF;AAAA,EAEJ;AACF;ACNO,MAAeC,UAA6BC,EAAgB;AAAA,EACzD,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,mBAAmB;AAC5B,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/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;"}

package/dist/esm/index.d.ts

@@ -1,8 +1,8 @@
 export * from './types.js';
 export { QueryClient, QueryClientContext } from './QueryClient.js';
 export type { QueryContext, QueryClientConfig } from './QueryClient.js';
-export { QueryController } from './QueryController.js';
-export type { IQueryClientForController } from './QueryController.js';
+export { QueryAdapter } from './QueryAdapter.js';
+export type { IQueryClientForAdapter } from './QueryAdapter.js';
 export { t, registerFormat } from './typeDefs.js';
 export { Query, fetchQuery, queryKeyForClass } from './query.js';
 export { Mutation, getMutation, mutationKeyForClass } from './mutation.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAE3B,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACnE,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,CAAC,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAC3E,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACvH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAE3B,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACnE,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,CAAC,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAC3E,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACvH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC"}

package/dist/esm/mutation.d.ts

@@ -2,7 +2,7 @@ import { ReactiveTask } from 'signalium';
 import { ExtractType, InternalTypeDef, MutationEffects, RetryConfig, TypeDefShape } from './types.js';
 import { type QueryContext } from './QueryClient.js';
 import { type CapturedDefinition } from './fieldRef.js';
-import type { QueryController } from './QueryController.js';
+import type { QueryAdapter } from './QueryAdapter.js';
 export interface MutationConfigOptions {
     retry?: RetryConfig | number | false;
 }
@@ -15,10 +15,10 @@ export interface MutationDefinition<Request, Response> {
     config?: MutationConfigOptions;
     effects?: MutationEffects;
     hasGetEffects: boolean;
-    controllerClass: typeof QueryController;
+    adapterClass: typeof QueryAdapter;
 }
 export declare abstract class Mutation {
-    static controller?: typeof QueryController;
+    static adapter?: typeof QueryAdapter;
     readonly params?: TypeDefShape;
     readonly result?: TypeDefShape;
     readonly optimisticUpdates?: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"mutation.d.ts","sourceRoot":"","sources":["../../src/mutation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,YAAY,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,eAAe,EAAW,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/G,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEzE,OAAO,EAA4C,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAClG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAM5D,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,KAAK,CAAC;CACtC;AAED,MAAM,WAAW,kBAAkB,CAAC,OAAO,EAAE,QAAQ;IACnD,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,eAAe,CAAC;IAC9B,aAAa,EAAE,eAAe,GAAG,SAAS,CAAC;IAC3C,QAAQ,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACvC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,OAAO,eAAe,CAAC;CACzC;AAMD,8BAAsB,QAAQ;IAC5B,MAAM,CAAC,UAAU,CAAC,EAAE,OAAO,eAAe,CAAC;IAE3C,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,qBAAqB,CAAC;IACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;IAErC,OAAO,EAAE,YAAY,CAAC;IAE9B,QAAQ,CAAC,cAAc,IAAI,OAAO;IAElC,UAAU,CAAC,IAAI,eAAe;;CAK/B;AAQD,eAAO,MAAM,mBAAmB,GAAI,KAAK,UAAU,QAAQ,KAAG,MAQ7D,CAAC;AAmEF,wBAAgB,WAAW,CAAC,CAAC,SAAS,QAAQ,EAC5C,aAAa,EAAE,UAAU,CAAC,GACzB,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAU9E"}
+{"version":3,"file":"mutation.d.ts","sourceRoot":"","sources":["../../src/mutation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,YAAY,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,eAAe,EAAW,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/G,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEzE,OAAO,EAA4C,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAClG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAMtD,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,KAAK,CAAC;CACtC;AAED,MAAM,WAAW,kBAAkB,CAAC,OAAO,EAAE,QAAQ;IACnD,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,eAAe,CAAC;IAC9B,aAAa,EAAE,eAAe,GAAG,SAAS,CAAC;IAC3C,QAAQ,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACvC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,OAAO,YAAY,CAAC;CACnC;AAMD,8BAAsB,QAAQ;IAC5B,MAAM,CAAC,OAAO,CAAC,EAAE,OAAO,YAAY,CAAC;IAErC,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,qBAAqB,CAAC;IACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;IAErC,OAAO,EAAE,YAAY,CAAC;IAE9B,QAAQ,CAAC,cAAc,IAAI,OAAO;IAElC,UAAU,CAAC,IAAI,eAAe;;CAK/B;AAQD,eAAO,MAAM,mBAAmB,GAAI,KAAK,UAAU,QAAQ,KAAG,MAQ7D,CAAC;AAmEF,wBAAgB,WAAW,CAAC,CAAC,SAAS,QAAQ,EAC5C,aAAa,EAAE,UAAU,CAAC,GACzB,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAU9E"}

package/dist/esm/production/{QueryController-Ch_ncxiI.js → QueryAdapter-Bu5UJjE4.js}

@@ -1,7 +1,7 @@
 class t {
   queryClient;
   /**
-   * Called once by QueryClient when this controller is registered.
+   * Called once by QueryClient when this adapter is registered.
    * Subclasses can override to do setup (e.g. open a WebSocket connection).
    */
   register(e) {
@@ -11,4 +11,4 @@ class t {
 export {
   t as Q
 };
-//# sourceMappingURL=QueryController-Ch_ncxiI.js.map
+//# sourceMappingURL=QueryAdapter-Bu5UJjE4.js.map

package/dist/esm/production/QueryAdapter-Bu5UJjE4.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryAdapter-Bu5UJjE4.js","sources":["../../../src/QueryAdapter.ts"],"sourcesContent":["import { type QueryContext } from './query-types.js';\nimport type { Query } from './query.js';\nimport type { Mutation } from './mutation.js';\n\n// ================================\n// IQueryClient — minimal interface QueryAdapter needs from the client\n// (avoids circular import: QueryClient → QueryAdapter → QueryClient)\n// ================================\n\nexport interface IQueryClientForAdapter {\n  getContext(): QueryContext;\n  applyMutationEvent(event: import('./types.js').MutationEvent): void;\n}\n\n// ================================\n// QueryAdapter base class\n// ================================\n\nexport abstract class QueryAdapter {\n  protected queryClient: IQueryClientForAdapter | undefined;\n\n  /**\n   * Called once by QueryClient when this adapter is registered.\n   * Subclasses can override to do setup (e.g. open a WebSocket connection).\n   */\n  register(queryClient: IQueryClientForAdapter): void {\n    this.queryClient = queryClient;\n  }\n\n  /**\n   * Called when the network comes online or goes offline.\n   * Subclasses can override to reconnect persistent connections (e.g. WebSocket).\n   */\n  onNetworkStatusChange?(isOnline: boolean): void;\n\n  /**\n   * Called when the QueryClient is destroyed.\n   * Subclasses can override to clean up connections or timers.\n   */\n  destroy?(): void;\n\n  /**\n   * Send the query and return the raw response data.\n   * @param ctx  The query execution context (a reified Query instance with params applied).\n   * @param signal  AbortSignal to cancel the in-flight request.\n   */\n  abstract send(ctx: Query, signal: AbortSignal): Promise<unknown>;\n\n  /**\n   * Fetch the next page of results. Only implement if the adapter supports pagination.\n   * @param ctx  The query execution context. `ctx.resultData` contains the current page's data.\n   * @param signal  AbortSignal to cancel the in-flight request.\n   */\n  sendNext?(ctx: Query, signal: AbortSignal): Promise<unknown>;\n\n  /**\n   * Return true if more pages are available for the current result.\n   * Called reactively — do not perform async work here.\n   */\n  hasNext?(ctx: Query): boolean;\n\n  /**\n   * Send a mutation and return the raw response data.\n   * @param ctx  The mutation execution context (a reified Mutation instance with params applied).\n   * @param signal  AbortSignal to cancel the in-flight request.\n   */\n  sendMutation?(ctx: Mutation, signal: AbortSignal): Promise<unknown>;\n}\n"],"names":["QueryAdapter","queryClient"],"mappings":"AAkBO,MAAeA,EAAa;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMV,SAASC,GAA2C;AAClD,SAAK,cAAcA;AAAA,EACrB;AAwCF;"}