fetchium 0.1.0 → 0.1.1

package/dist/esm/production/QueryController-Ch_ncxiI.js

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

package/dist/esm/production/QueryController-Ch_ncxiI.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryController-Ch_ncxiI.js","sources":["../../../src/QueryController.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 QueryController needs from the client\n// (avoids circular import: QueryClient → QueryController → QueryClient)\n// ================================\n\nexport interface IQueryClientForController {\n  getContext(): QueryContext;\n  applyMutationEvent(event: import('./types.js').MutationEvent): void;\n}\n\n// ================================\n// QueryController base class\n// ================================\n\nexport abstract class QueryController {\n  protected queryClient: IQueryClientForController | undefined;\n\n  /**\n   * Called once by QueryClient when this controller is registered.\n   * Subclasses can override to do setup (e.g. open a WebSocket connection).\n   */\n  register(queryClient: IQueryClientForController): 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 controller 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":["QueryController","queryClient"],"mappings":"AAkBO,MAAeA,EAAgB;AAAA,EAC1B;AAAA;AAAA;AAAA;AAAA;AAAA,EAMV,SAASC,GAA8C;AACrD,SAAK,cAAcA;AAAA,EACrB;AAwCF;"}

package/dist/esm/production/index.js

@@ -1,103 +1,32 @@
-import { c as m, r as p, Q as M, e as b, V as l, t as y } from "./QueryClient-BP0Z1rQV.js";
-import { A as x, E as N, G as k, o as Q, L as T, M as K, N as P, j, l as F, k as _, h as $, n as G, d as Y, a as A, m as B, R as L, i as V, g as I, f as J, q as W, b as z } from "./QueryClient-BP0Z1rQV.js";
-import { getContext as w } from "signalium";
-class D {
-  params;
-  result;
-  optimisticUpdates;
-  config;
-  effects;
-  constructor() {
-    return m(this);
-  }
-}
-class q extends D {
-  path;
-  method = "POST";
-  body;
-  headers;
-  requestOptions;
-  getStorageKey() {
-    return `${this.method ?? "POST"}:${this.path ?? ""}`;
-  }
-  async send() {
-    const t = this.getPath ? this.getPath() : this.path, s = this.getMethod ? this.getMethod() : this.method, i = this.getBody ? this.getBody() : this.body, r = this.getRequestOptions ? this.getRequestOptions() : this.requestOptions;
-    if (!t)
-      throw new Error("RESTMutation requires a path. Define `path` as a field or override `getPath()`.");
-    const n = i ?? this.params, o = p(r?.baseUrl) ?? p(this.context.baseUrl), f = o ? `${o}${t}` : t, { baseUrl: c, signal: d, ...a } = r ?? {}, h = {
-      "Content-Type": "application/json",
-      ...this.headers
-    }, g = await this.context.fetch(f, {
-      method: s,
-      headers: h,
-      body: JSON.stringify(n),
-      signal: this.signal,
-      ...a
-    });
-    return this.response = g, g.json();
-  }
-}
-const u = /* @__PURE__ */ new WeakMap(), C = (e) => {
-  const t = u.get(e);
-  if (t === void 0)
-    throw new Error("Mutation definition not found");
-  return t().id;
-};
-function E(e) {
-  let t = u.get(e);
-  if (t !== void 0)
-    return t;
-  let s;
-  const i = () => {
-    if (s !== void 0)
-      return s;
-    const r = new e(), n = b(r), { fields: o } = n, f = `mutation:${String(n.methods.getStorageKey.call(o))}`, c = o.params ?? {}, d = c instanceof l ? c : y.object(c), a = o.result, h = a !== void 0 ? a instanceof l ? a : y.object(a) : void 0;
-    return s = {
-      id: f,
-      requestShape: d,
-      responseShape: h,
-      captured: n,
-      optimisticUpdates: o.optimisticUpdates ?? !1,
-      config: o.config,
-      effects: o.effects,
-      hasGetEffects: typeof n.methods.getEffects == "function"
-    }, s;
-  };
-  return u.set(e, i), i;
-}
-function S(e) {
-  const t = E(e), s = w(M);
-  if (s === void 0)
-    throw new Error("QueryClient not found");
-  return s.getMutation(t());
-}
+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-YqnBxFy1.js";
+import { Q as F } from "./QueryController-Ch_ncxiI.js";
+import { M as K, g as Y, m as A } from "./mutation-pgFl1uIY.js";
 export {
-  x as ARRAY_KEY,
-  N as Entity,
-  k as GcManager,
-  Q as LiveFieldConfig,
-  T as LiveFieldType,
-  K as Mask,
-  D as Mutation,
-  P as NetworkManager,
-  j as NetworkManagerContext,
-  F as NetworkMode,
-  _ as NoOpGcManager,
-  $ as NoOpNetworkManager,
-  G as QUERY_ID,
-  Y as Query,
-  A as QueryClient,
-  M as QueryClientContext,
-  B as RECORD_KEY,
-  q as RESTMutation,
-  L as RESTQuery,
-  V as defaultNetworkManager,
-  I as draft,
-  J as fetchQuery,
-  S as getMutation,
-  C as mutationKeyForClass,
-  W as queryKeyForClass,
-  z as registerFormat,
-  y as t
+  r as ARRAY_KEY,
+  s as Entity,
+  t as GcManager,
+  o as LiveFieldConfig,
+  n as LiveFieldType,
+  i as Mask,
+  K as Mutation,
+  M as NetworkManager,
+  g as NetworkManagerContext,
+  u as NetworkMode,
+  y as NoOpGcManager,
+  l as NoOpNetworkManager,
+  C as QUERY_ID,
+  f as Query,
+  N as QueryClient,
+  Q as QueryClientContext,
+  F as QueryController,
+  k as RECORD_KEY,
+  d as defaultNetworkManager,
+  m as draft,
+  p as fetchQuery,
+  Y as getMutation,
+  A as mutationKeyForClass,
+  E as queryKeyForClass,
+  R as registerFormat,
+  w as t
 };
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../src/mutation.ts"],"sourcesContent":["import { getContext, ReactiveTask } from 'signalium';\nimport {\n  ExtractType,\n  InternalTypeDef,\n  MutationEffects,\n  TypeDef,\n  RetryConfig,\n  TypeDefShape,\n  QueryRequestOptions,\n} from './types.js';\nimport { QueryClientContext, QueryContext, resolveBaseUrl } from './QueryClient.js';\nimport { ValidatorDef, t } from './typeDefs.js';\nimport { createDefinitionProxy, extractDefinition, type CapturedDefinition } from './fieldRef.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}\n\n// ================================\n// Mutation base class\n// ================================\n\nexport abstract class Mutation {\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  declare response: Response | undefined;\n  declare signal: AbortSignal;\n\n  abstract send(): Promise<unknown>;\n  abstract getStorageKey(): unknown;\n\n  getEffects?(): MutationEffects;\n\n  constructor() {\n    return createDefinitionProxy(this);\n  }\n}\n\n// ================================\n// RESTMutation\n// ================================\n\nexport abstract class RESTMutation extends Mutation {\n  path?: string;\n  method: 'POST' | 'PUT' | 'DELETE' | 'PATCH' = 'POST';\n  body?: Record<string, unknown>;\n  headers?: HeadersInit;\n  requestOptions?: QueryRequestOptions;\n\n  getStorageKey(): 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  async send(): Promise<unknown> {\n    const path = this.getPath ? this.getPath() : this.path;\n    const method = this.getMethod ? this.getMethod() : this.method;\n    const body = this.getBody ? this.getBody() : this.body;\n    const requestOptions = this.getRequestOptions ? this.getRequestOptions() : this.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 bodyData = body ?? (this.params as Record<string, unknown>);\n\n    const baseUrl = resolveBaseUrl(requestOptions?.baseUrl) ?? resolveBaseUrl(this.context.baseUrl);\n    const fullUrl = baseUrl ? `${baseUrl}${path}` : path;\n\n    const { baseUrl: _baseUrl, signal: _signal, ...fetchOptions } = requestOptions ?? ({} as Record<string, unknown>);\n\n    const headers: HeadersInit = {\n      'Content-Type': 'application/json',\n      ...(this.headers as Record<string, string>),\n    };\n\n    const fetchResponse = await this.context.fetch(fullUrl, {\n      method,\n      headers,\n      body: JSON.stringify(bodyData),\n      signal: this.signal,\n      ...fetchOptions,\n    });\n\n    this.response = fetchResponse;\n    return fetchResponse.json();\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.getStorageKey.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    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    };\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","RESTMutation","path","method","body","requestOptions","bodyData","baseUrl","resolveBaseUrl","fullUrl","_baseUrl","_signal","fetchOptions","headers","fetchResponse","mutationDefCache","mutationKeyForClass","cls","getMutationDef","buildMutationDefinition","MutationClass","cached","mutationDefinition","getter","instance","captured","extractDefinition","fields","id","requestDef","requestShape","ValidatorDef","t","responseDef","responseShape","getMutation","queryClient","getContext","QueryClientContext"],"mappings":"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"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;"}

package/dist/esm/production/mutation-pgFl1uIY.js

@@ -0,0 +1,58 @@
+import { getContext as h } from "signalium";
+import { l as y, h as D, m as w, V as u, t as l } from "./QueryClient-YqnBxFy1.js";
+class x {
+  static controller;
+  params;
+  result;
+  optimisticUpdates;
+  config;
+  effects;
+  constructor() {
+    return y(this);
+  }
+}
+const c = /* @__PURE__ */ new WeakMap(), C = (t) => {
+  const e = c.get(t);
+  if (e === void 0)
+    throw new Error("Mutation definition not found");
+  return e().id;
+};
+function M(t) {
+  let e = c.get(t);
+  if (e !== void 0)
+    return e;
+  let o;
+  const a = () => {
+    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;
+    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.`
+      );
+    return o = {
+      id: m,
+      requestShape: p,
+      responseShape: g,
+      captured: i,
+      optimisticUpdates: n.optimisticUpdates ?? !1,
+      config: n.config,
+      effects: n.effects,
+      hasGetEffects: typeof i.methods.getEffects == "function",
+      controllerClass: f
+    }, o;
+  };
+  return c.set(t, a), a;
+}
+function S(t) {
+  const e = M(t), o = h(D);
+  if (o === void 0)
+    throw new Error("QueryClient not found");
+  return o.getMutation(e());
+}
+export {
+  x as M,
+  S as g,
+  C as m
+};
+//# sourceMappingURL=mutation-pgFl1uIY.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mutation-pgFl1uIY.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 { QueryController } from './QueryController.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  controllerClass: typeof QueryController;\n}\n\n// ================================\n// Mutation base class\n// ================================\n\nexport abstract class Mutation {\n  static controller?: typeof QueryController;\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 controllerClass = (MutationClass as typeof Mutation).controller;\n    if (!controllerClass) {\n      throw new Error(\n        `Mutation class \"${MutationClass.name}\" must define a static \\`controller\\` property. ` +\n          `Extend RESTMutation (from fetchium/rest) or set \\`static controller = MyController\\` 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      controllerClass,\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","controllerClass","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,IAAmBf,EAAkC;AAC3D,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,iBAAAU;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 { f as u } from "../QueryClient-BP0Z1rQV.js";
+import { k as u } from "../QueryClient-YqnBxFy1.js";
 function n(e) {
   if (Array.isArray(e))
     return e.map(n);

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

@@ -0,0 +1,142 @@
+import { n as v, o as U, f as O } from "../QueryClient-YqnBxFy1.js";
+import { Q as T } from "../QueryController-Ch_ncxiI.js";
+import { M as w } from "../mutation-pgFl1uIY.js";
+class P extends T {
+  _fetch;
+  _baseUrl;
+  constructor(e) {
+    super(), this._fetch = e?.fetch ?? globalThis.fetch, this._baseUrl = e?.baseUrl;
+  }
+  async send(e, s) {
+    return this.executeRequest(e, s);
+  }
+  async sendNext(e, s) {
+    const t = this.resolveFetchNext(e);
+    if (t === void 0)
+      throw new Error("fetchNext is not configured for this query");
+    return this.executeRequest(e, s, t);
+  }
+  hasNext(e) {
+    const s = this.resolveFetchNext(e);
+    if (s === void 0) return !1;
+    if (s.url !== void 0 && s.url !== null)
+      return !0;
+    if (s.searchParams !== void 0) {
+      const t = Object.keys(s.searchParams);
+      if (t.length === 0) return !1;
+      for (const r of t)
+        if (s.searchParams[r] === void 0 || s.searchParams[r] === null)
+          return !1;
+      return !0;
+    }
+    return !1;
+  }
+  resolveFetchNext(e) {
+    const t = (e.getFetchNext ? e.getFetchNext() : void 0) ?? e.rawFetchNext;
+    if (t === void 0) return;
+    const r = {
+      params: e.params ?? {},
+      result: e.resultData
+    };
+    return {
+      url: t.url !== void 0 ? v(t.url, r) : void 0,
+      searchParams: t.searchParams !== void 0 ? v(t.searchParams, r) : void 0
+    };
+  }
+  /**
+   * Resolves a path to a full URL.
+   *
+   * - 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`.
+   *   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.
+   */
+  buildUrl(e, s) {
+    if (e.startsWith("http://") || e.startsWith("https://") || e.startsWith("//"))
+      return e;
+    if (e.startsWith("/")) {
+      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.`
+        );
+      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;
+    if (!r)
+      throw new Error("RESTQuery requires a path. Define `path` as a field or override `getPath()`.");
+    let l = r;
+    if (a) {
+      const y = new URLSearchParams();
+      for (const b in a) {
+        const c = a[b];
+        c != null && y.append(b, String(c));
+      }
+      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 ? {
+      ...n ? { "Content-Type": "application/json" } : void 0,
+      ...e.headers
+    } : void 0, p = await this._fetch(u, {
+      method: h,
+      headers: S,
+      body: n ? JSON.stringify(n) : void 0,
+      signal: s,
+      ...q
+    });
+    return e.response = p, p.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;
+    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" } : {},
+      ...t.headers
+    };
+    return (await this._fetch(i, {
+      method: h,
+      headers: g,
+      ...o !== void 0 ? { body: JSON.stringify(o) } : {},
+      signal: s,
+      ...u
+    })).json();
+  }
+}
+class M extends O {
+  static controller = P;
+  method = "GET";
+  path;
+  baseUrl;
+  searchParams;
+  body;
+  headers;
+  requestOptions;
+  fetchNext;
+  getIdentityKey() {
+    return `${this.method ?? "GET"}:${this.path ?? ""}`;
+  }
+}
+class Q extends w {
+  static controller = P;
+  path;
+  baseUrl;
+  method = "POST";
+  body;
+  headers;
+  requestOptions;
+  getIdentityKey() {
+    return `${this.method ?? "POST"}:${this.path ?? ""}`;
+  }
+}
+export {
+  Q as RESTMutation,
+  M as RESTQuery,
+  P as RESTQueryController
+};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +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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"}

package/dist/esm/production/{shared-Dq2yW78d.js → shared-DcuVH8Pf.js}

@@ -1,15 +1,15 @@
 const o = (s) => `sq:doc:value:${s}`, e = (s) => `sq:doc:refCount:${s}`, c = (s) => `sq:doc:refIds:${s}`, a = (s) => `sq:doc:updatedAt:${s}`, t = (s) => `sq:doc:queue:${s}`, d = (s) => `sq:doc:lastUsed:${s}`, n = (s) => `sq:doc:cacheTime:${s}`, r = "sq:doc:lastUsed:", q = 50, u = 1440, F = 5;
 export {
-  F as D,
+  u as D,
   r as L,
-  u as a,
-  q as b,
+  q as a,
+  e as b,
   n as c,
-  e as d,
+  F as d,
   d as l,
   t as q,
   c as r,
   a as u,
   o as v
 };
-//# sourceMappingURL=shared-Dq2yW78d.js.map
+//# sourceMappingURL=shared-DcuVH8Pf.js.map

package/dist/esm/production/{shared-Dq2yW78d.js.map → shared-DcuVH8Pf.js.map}

@@ -1 +1 @@
-{"version":3,"file":"shared-Dq2yW78d.js","sources":["../../../src/stores/shared.ts"],"sourcesContent":["// Query Instance keys\nexport const valueKeyFor = (id: number) => `sq:doc:value:${id}`;\nexport const refCountKeyFor = (id: number) => `sq:doc:refCount:${id}`;\nexport const refIdsKeyFor = (id: number) => `sq:doc:refIds:${id}`;\nexport const updatedAtKeyFor = (id: number) => `sq:doc:updatedAt:${id}`;\n// Query Type keys\nexport const queueKeyFor = (queryDefId: string) => `sq:doc:queue:${queryDefId}`;\n// Query Type metadata keys (used for stale cache cleanup)\nexport const lastUsedKeyFor = (queryDefId: string) => `sq:doc:lastUsed:${queryDefId}`;\nexport const cacheTimeKeyFor = (queryDefId: string) => `sq:doc:cacheTime:${queryDefId}`;\n\nexport const LAST_USED_PREFIX = 'sq:doc:lastUsed:';\n\n// Default values\nexport const DEFAULT_MAX_COUNT = 50;\nexport const DEFAULT_CACHE_TIME = 60 * 24; // 24 hours in minutes\nexport const DEFAULT_GC_TIME = 5; // 5 minutes - in-memory eviction default\n"],"names":["valueKeyFor","id","refCountKeyFor","refIdsKeyFor","updatedAtKeyFor","queueKeyFor","queryDefId","lastUsedKeyFor","cacheTimeKeyFor","LAST_USED_PREFIX","DEFAULT_MAX_COUNT","DEFAULT_CACHE_TIME","DEFAULT_GC_TIME"],"mappings":"AACO,MAAMA,IAAc,CAACC,MAAe,gBAAgBA,CAAE,IAChDC,IAAiB,CAACD,MAAe,mBAAmBA,CAAE,IACtDE,IAAe,CAACF,MAAe,iBAAiBA,CAAE,IAClDG,IAAkB,CAACH,MAAe,oBAAoBA,CAAE,IAExDI,IAAc,CAACC,MAAuB,gBAAgBA,CAAU,IAEhEC,IAAiB,CAACD,MAAuB,mBAAmBA,CAAU,IACtEE,IAAkB,CAACF,MAAuB,oBAAoBA,CAAU,IAExEG,IAAmB,oBAGnBC,IAAoB,IACpBC,IAAqB,MACrBC,IAAkB;"}
+{"version":3,"file":"shared-DcuVH8Pf.js","sources":["../../../src/stores/shared.ts"],"sourcesContent":["// Query Instance keys\nexport const valueKeyFor = (id: number) => `sq:doc:value:${id}`;\nexport const refCountKeyFor = (id: number) => `sq:doc:refCount:${id}`;\nexport const refIdsKeyFor = (id: number) => `sq:doc:refIds:${id}`;\nexport const updatedAtKeyFor = (id: number) => `sq:doc:updatedAt:${id}`;\n// Query Type keys\nexport const queueKeyFor = (queryDefId: string) => `sq:doc:queue:${queryDefId}`;\n// Query Type metadata keys (used for stale cache cleanup)\nexport const lastUsedKeyFor = (queryDefId: string) => `sq:doc:lastUsed:${queryDefId}`;\nexport const cacheTimeKeyFor = (queryDefId: string) => `sq:doc:cacheTime:${queryDefId}`;\n\nexport const LAST_USED_PREFIX = 'sq:doc:lastUsed:';\n\n// Default values\nexport const DEFAULT_MAX_COUNT = 50;\nexport const DEFAULT_CACHE_TIME = 60 * 24; // 24 hours in minutes\nexport const DEFAULT_GC_TIME = 5; // 5 minutes - in-memory eviction default\n"],"names":["valueKeyFor","id","refCountKeyFor","refIdsKeyFor","updatedAtKeyFor","queueKeyFor","queryDefId","lastUsedKeyFor","cacheTimeKeyFor","LAST_USED_PREFIX","DEFAULT_MAX_COUNT","DEFAULT_CACHE_TIME","DEFAULT_GC_TIME"],"mappings":"AACO,MAAMA,IAAc,CAACC,MAAe,gBAAgBA,CAAE,IAChDC,IAAiB,CAACD,MAAe,mBAAmBA,CAAE,IACtDE,IAAe,CAACF,MAAe,iBAAiBA,CAAE,IAClDG,IAAkB,CAACH,MAAe,oBAAoBA,CAAE,IAExDI,IAAc,CAACC,MAAuB,gBAAgBA,CAAU,IAEhEC,IAAiB,CAACD,MAAuB,mBAAmBA,CAAU,IACtEE,IAAkB,CAACF,MAAuB,oBAAoBA,CAAU,IAExEG,IAAmB,oBAGnBC,IAAoB,IACpBC,IAAqB,MACrBC,IAAkB;"}

package/dist/esm/production/stores/async.js

@@ -1,4 +1,4 @@
-import { u as h, a as d, v as u, r as l, q as w, b as v, l as m, c as f, L as y, d as g } from "../shared-Dq2yW78d.js";
+import { u as h, D as d, v as u, r as l, a as v, l as m, c as w, L as y, q as f, b as g } from "../shared-DcuVH8Pf.js";
 class A {
   isWriter;
   delegate;
@@ -134,13 +134,13 @@ class A {
   async writerActivateQuery(e, t, s) {
     if (!await this.delegate.has(u(t)))
       return;
-    const a = w(e);
+    const a = f(e);
     let i = this.queues.get(e);
     if (i === void 0) {
       const o = v;
       i = await this.delegate.getBuffer(a), i === void 0 ? (i = new Uint32Array(o), await this.delegate.setBuffer(a, i)) : i.length !== o && (i = new Uint32Array(i.buffer, 0, o), await this.delegate.setBuffer(a, i)), this.queues.set(e, i);
     }
-    await this.delegate.setNumber(m(e), Date.now()), await this.delegate.setNumber(f(e), s);
+    await this.delegate.setNumber(m(e), Date.now()), await this.delegate.setNumber(w(e), s);
     const r = i.indexOf(t);
     if (r >= 0) {
       if (r === 0)
@@ -156,13 +156,13 @@ class A {
     const e = await this.delegate.getAllKeys(), t = Date.now();
     for (const s of e) {
       if (!s.startsWith(y)) continue;
-      const a = s.slice(y.length), i = await this.delegate.getNumber(s), n = (await this.delegate.getNumber(f(a)) ?? d) * 60 * 1e3;
+      const a = s.slice(y.length), i = await this.delegate.getNumber(s), n = (await this.delegate.getNumber(w(a)) ?? d) * 60 * 1e3;
       if (i === void 0 || t - i > n) {
-        const o = await this.delegate.getBuffer(w(a));
+        const o = await this.delegate.getBuffer(f(a));
         if (o !== void 0)
           for (const c of o)
             c !== 0 && (await this.writerDeleteValue(c), await this.delegate.delete(h(c)));
-        await this.delegate.delete(w(a)), await this.delegate.delete(s), await this.delegate.delete(f(a)), this.queues.delete(a);
+        await this.delegate.delete(f(a)), await this.delegate.delete(s), await this.delegate.delete(w(a)), this.queues.delete(a);
       }
     }
   }

package/dist/esm/production/stores/sync.js

@@ -1,4 +1,4 @@
-import { u as v, a as d, v as f, r as h, b as y, q as a, l as C, c as l, L as g, d as k } from "../shared-Dq2yW78d.js";
+import { u as v, D as l, v as f, r as h, a as y, q as a, l as C, c as d, L as g, b as k } from "../shared-DcuVH8Pf.js";
 class N {
   kv = /* @__PURE__ */ Object.create(null);
   has(e) {
@@ -35,7 +35,7 @@ class S {
   }
   queues = /* @__PURE__ */ new Map();
   loadQuery(e, s) {
-    const i = this.kv.getNumber(v(s)), t = (e.statics.cache?.cacheTime ?? d) * 60 * 1e3;
+    const i = this.kv.getNumber(v(s)), t = (e.statics.cache?.cacheTime ?? l) * 60 * 1e3;
     if (i === void 0 || i < Date.now() - t)
       return;
     const n = this.kv.getString(f(s));
@@ -75,7 +75,7 @@ class S {
       const o = e.statics.cache?.maxCount ?? y;
       t = this.kv.getBuffer(a(i)), t === void 0 ? (t = new Uint32Array(o), this.kv.setBuffer(a(i), t)) : t.length !== o && (t = new Uint32Array(t.buffer, 0, o), this.kv.setBuffer(a(i), t)), this.queues.set(i, t);
     }
-    this.kv.setNumber(C(i), Date.now()), this.kv.setNumber(l(i), e.statics.cache?.cacheTime ?? d);
+    this.kv.setNumber(C(i), Date.now()), this.kv.setNumber(d(i), e.statics.cache?.cacheTime ?? l);
     const n = t.indexOf(s);
     if (n >= 0) {
       if (n === 0)
@@ -90,13 +90,13 @@ class S {
     const e = this.kv.getAllKeys(), s = Date.now();
     for (const i of e) {
       if (!i.startsWith(g)) continue;
-      const t = i.slice(g.length), n = this.kv.getNumber(i), o = (this.kv.getNumber(l(t)) ?? d) * 60 * 1e3;
+      const t = i.slice(g.length), n = this.kv.getNumber(i), o = (this.kv.getNumber(d(t)) ?? l) * 60 * 1e3;
       if (n === void 0 || s - n > o) {
         const c = this.kv.getBuffer(a(t));
         if (c !== void 0)
           for (const u of c)
             u !== 0 && (this.deleteQuery(u), this.kv.delete(v(u)));
-        this.kv.delete(a(t)), this.kv.delete(i), this.kv.delete(l(t)), this.queues.delete(t);
+        this.kv.delete(a(t)), this.kv.delete(i), this.kv.delete(d(t)), this.queues.delete(t);
       }
     }
   }

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

@@ -0,0 +1,86 @@
+import { f as a } from "../QueryClient-YqnBxFy1.js";
+import { Q as d } from "../QueryController-Ch_ncxiI.js";
+class g extends a {
+  static controller;
+  getIdentityKey() {
+    return `topic:${this.topic}`;
+  }
+  getConfig() {
+    return {
+      staleTime: 0,
+      subscribe: () => () => {
+        this._topicController?.unsubscribe(this.topic);
+      }
+    };
+  }
+}
+class _ extends d {
+  _topics = /* @__PURE__ */ new Map();
+  /**
+   * Resolve the pending promise for a topic with initial data.
+   * Can be called before `send()` — the data will be picked up
+   * when the query activates.
+   */
+  fulfillTopic(e, s) {
+    const t = this._topics.get(e);
+    if (t === void 0) {
+      this._topics.set(e, { status: "fulfilled", data: s });
+      return;
+    }
+    t.status === "pending" && (t.status = "fulfilled", t.data = s, t.resolve(s));
+  }
+  /**
+   * Reject the pending promise for a topic.
+   * Can be called before `send()` — the error will be propagated
+   * when the query activates.
+   */
+  rejectTopic(e, s) {
+    const t = this._topics.get(e);
+    if (t === void 0) {
+      this._topics.set(e, { status: "rejected", error: s });
+      return;
+    }
+    t.status === "pending" && (t.status = "rejected", t.error = s, t.reject(s));
+  }
+  /**
+   * Clears internal state for a topic. Called automatically by
+   * `unsubscribe` — subclasses generally don't need to call this.
+   */
+  clearTopic(e) {
+    this._topics.delete(e);
+  }
+  clearAll() {
+    this._topics.clear();
+  }
+  async send(e, s) {
+    const t = e;
+    t._topicController = this;
+    const r = t.topic, i = this._topics.get(r);
+    if (i)
+      switch (i.status) {
+        case "fulfilled":
+          return i.data;
+        case "rejected":
+          throw i.error;
+        case "pending":
+          return i.promise;
+      }
+    let o, c;
+    const n = new Promise((p, u) => {
+      o = p, c = u;
+    });
+    return this._topics.set(r, { status: "pending", promise: n, resolve: o, reject: c }), this.subscribe(r), n;
+  }
+  /**
+   * Convenience wrapper — pushes a mutation event through the QueryClient
+   * so that entities and live collections are updated reactively.
+   */
+  sendMutationEvent(e) {
+    this.queryClient.applyMutationEvent(e);
+  }
+}
+export {
+  g as TopicQuery,
+  _ as TopicQueryController
+};
+//# sourceMappingURL=index.js.map