fetchium 0.1.0 → 0.1.1

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

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

package/dist/esm/query-types.d.ts

@@ -1,9 +1,7 @@
 import { type Signal } from 'signalium';
-import { NetworkMode, RetryConfig, BaseUrlValue, QueryRequestInit } from './types.js';
+import { NetworkMode, RetryConfig, BaseUrlValue } from './types.js';
 import { QueryDefinition } from './query.js';
 export interface QueryContext {
-    fetch: (url: string, init?: QueryRequestInit) => Promise<Response>;
-    baseUrl?: BaseUrlValue;
     log?: {
         error?: (message: string, error?: unknown) => void;
         warn?: (message: string, error?: unknown) => void;
@@ -21,7 +19,7 @@ export interface QueryCacheOptions {
     maxCount?: number;
     cacheTime?: number;
 }
-export interface LoadNextConfig {
+export interface FetchNextConfig {
     /** Override the URL/path for the next page request. Can be a FieldRef (e.g. this.result.nextUrl). */
     url?: unknown;
     /** Search params for the next page. Values can be FieldRefs (e.g. this.result.nextCursor). */

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

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

package/dist/esm/query.d.ts

@@ -1,12 +1,9 @@
-import { ExtractType, TypeDef, QueryRequestOptions, TypeDefShape, RetryConfig, QueryPromise } from './types.js';
-import { QueryCacheOptions, QueryConfigOptions, LoadNextConfig, QueryContext, QueryParams } from './QueryClient.js';
+import { ExtractType, TypeDef, TypeDefShape, RetryConfig, QueryPromise } from './types.js';
+import { QueryCacheOptions, QueryConfigOptions, FetchNextConfig, QueryParams } from './QueryClient.js';
 import { ValidatorDef } from './typeDefs.js';
 import { HasRequiredKeys, Optionalize, Signalize } from './type-utils.js';
 import { type CapturedDefinition } from './fieldRef.js';
-export interface ResolvedLoadNext {
-    url?: string;
-    searchParams?: Record<string, unknown>;
-}
+import type { QueryController } from './QueryController.js';
 export interface ResolvedRetryConfig {
     retries: number;
     retryDelay: (attempt: number) => number;
@@ -14,43 +11,22 @@ export interface ResolvedRetryConfig {
 export declare function resolveRetryConfig(retryOption: RetryConfig | number | boolean | undefined, isServer?: boolean): ResolvedRetryConfig;
 export declare abstract class Query {
     static cache?: QueryCacheOptions;
+    /**
+     * The controller class responsible for sending requests for this query type.
+     * Must be set on each concrete Query subclass (or inherited from a base like RESTQuery).
+     */
+    static controller?: typeof QueryController;
     params?: Record<string, TypeDef>;
     abstract result: TypeDefShape;
     config?: QueryConfigOptions;
-    context: QueryContext;
-    response: Response | undefined;
-    signal: AbortSignal;
+    context: import('./query-types.js').QueryContext;
     refetch: () => void;
     resultData: Record<string, unknown>;
-    rawLoadNext: LoadNextConfig | undefined;
-    abstract getStorageKey(): unknown;
-    abstract send(): Promise<unknown>;
+    rawFetchNext: FetchNextConfig | undefined;
+    abstract getIdentityKey(): unknown;
     getConfig?(): QueryConfigOptions | undefined;
-    sendNext?(): Promise<unknown>;
-    hasNext?(): boolean;
     constructor();
 }
-export declare abstract class RESTQuery extends Query {
-    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
-    path?: string;
-    searchParams?: Record<string, unknown>;
-    body?: Record<string, unknown>;
-    headers?: HeadersInit;
-    requestOptions?: QueryRequestOptions;
-    loadNext?: LoadNextConfig;
-    getStorageKey(): string;
-    getPath?(): string | undefined;
-    getMethod?(): string;
-    getSearchParams?(): Record<string, unknown> | undefined;
-    getBody?(): Record<string, unknown> | undefined;
-    getRequestOptions?(): QueryRequestOptions | undefined;
-    getLoadNext?(): LoadNextConfig | undefined;
-    send(): Promise<unknown>;
-    private resolveLoadNext;
-    hasNext(): boolean;
-    sendNext(): Promise<unknown>;
-    private executeRequest;
-}
 export interface ResolvedQueryOptions {
     config: QueryConfigOptions | undefined;
     retryConfig: ResolvedRetryConfig;
@@ -62,18 +38,20 @@ export interface QueryDefinitionStatics {
      *  ValidatorDef. */
     readonly shape: ValidatorDef<unknown>;
     readonly cache: QueryCacheOptions | undefined;
-    /** Raw loadNext config with unresolved FieldRefs, extracted before reification. */
-    readonly rawLoadNext: LoadNextConfig | undefined;
-    /** Whether the query class implements sendNext(). */
+    /** Raw fetchNext config with unresolved FieldRefs, extracted before reification. */
+    readonly rawFetchNext: FetchNextConfig | undefined;
+    /** Whether the controller implements sendNext(). */
     readonly hasSendNext: boolean;
     /** Whether the result shape is already an entity (vs synthetic wrapper). */
     readonly isEntityResult: boolean;
+    /** The controller class responsible for sending requests. */
+    readonly controllerClass: typeof QueryController;
 }
 export declare class QueryDefinition<Params extends QueryParams | undefined, Result, StreamType> {
     readonly captured: CapturedDefinition<Query>;
     readonly statics: QueryDefinitionStatics;
     constructor(statics: QueryDefinitionStatics, captured: CapturedDefinition<Query>);
-    createExecutionContext(actualParams: Record<string, unknown>, queryContext: QueryContext): Query;
+    createExecutionContext(actualParams: Record<string, unknown>, queryContext: import('./query-types.js').QueryContext): Query;
     resolveOptions(ctx: Query): ResolvedQueryOptions;
     static for(QueryClass: new () => Query): QueryDefinition<any, any, any>;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/query.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/query.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAkB,MAAM,YAAY,CAAC;AAC3G,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EAEf,WAAW,EAEZ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAK,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAM5D,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;CACzC;AAED,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,EACvD,QAAQ,GAAE,OAAuC,GAChD,mBAAmB,CAmBrB;AAMD,8BAAsB,KAAK;IACzB,MAAM,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC;IACjC;;;OAGG;IACH,MAAM,CAAC,UAAU,CAAC,EAAE,OAAO,eAAe,CAAC;IAE3C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAEpB,OAAO,EAAE,OAAO,kBAAkB,EAAE,YAAY,CAAC;IACjD,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,YAAY,EAAE,eAAe,GAAG,SAAS,CAAC;IAElD,QAAQ,CAAC,cAAc,IAAI,OAAO;IAElC,SAAS,CAAC,IAAI,kBAAkB,GAAG,SAAS;;CAK7C;AAQD,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACvC,WAAW,EAAE,mBAAmB,CAAC;CAClC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB;;wBAEoB;IACpB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC9C,oFAAoF;IACpF,QAAQ,CAAC,YAAY,EAAE,eAAe,GAAG,SAAS,CAAC;IACnD,oDAAoD;IACpD,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,4EAA4E;IAC5E,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,6DAA6D;IAC7D,QAAQ,CAAC,eAAe,EAAE,OAAO,eAAe,CAAC;CAClD;AAED,qBAAa,eAAe,CAAC,MAAM,SAAS,WAAW,GAAG,SAAS,EAAE,MAAM,EAAE,UAAU;aAKnE,QAAQ,EAAE,kBAAkB,CAAC,KAAK,CAAC;IAJrD,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAC;gBAGvC,OAAO,EAAE,sBAAsB,EACf,QAAQ,EAAE,kBAAkB,CAAC,KAAK,CAAC;IAKrD,sBAAsB,CACpB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,YAAY,EAAE,OAAO,kBAAkB,EAAE,YAAY,GACpD,KAAK;IAIR,cAAc,CAAC,GAAG,EAAE,KAAK,GAAG,oBAAoB;IAShD,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,KAAK,GAAG,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;CAyDxE;AAMD,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,KAAK,IAC5C,CAAC,CAAC,QAAQ,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvC;KAAG,CAAC,IAAI,MAAM,CAAC,CAAC,QAAQ,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GAEzD,EAAE,CAAC;AAMT,eAAO,MAAM,gBAAgB,GAAI,KAAK,UAAU,KAAK,EAAE,QAAQ,OAAO,KAAG,MAGxE,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,UAAU,KAAK,GAAG,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAE9F;AAMD,wBAAgB,UAAU,CAAC,CAAC,SAAS,KAAK,EACxC,UAAU,EAAE,UAAU,CAAC,EACvB,GAAG,IAAI,EAAE,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,IAAI,GAC3D,CAAC,MAAM,EAAE,WAAW,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAC1D,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,GAC1E,YAAY,CAAC,CAAC,CAAC,CAYjB"}

package/dist/esm/rest/RESTMutation.d.ts

@@ -0,0 +1,18 @@
+import { Mutation } from '../mutation.js';
+import type { BaseUrlValue, QueryRequestOptions } from '../types.js';
+import { RESTQueryController } from './RESTQueryController.js';
+export declare abstract class RESTMutation extends Mutation {
+    static controller: typeof RESTQueryController;
+    path?: string;
+    baseUrl?: BaseUrlValue;
+    method: 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    body?: Record<string, unknown>;
+    headers?: HeadersInit;
+    requestOptions?: QueryRequestOptions;
+    getIdentityKey(): string;
+    getPath?(): string | undefined;
+    getMethod?(): string;
+    getBody?(): Record<string, unknown> | undefined;
+    getRequestOptions?(): QueryRequestOptions | undefined;
+}
+//# sourceMappingURL=RESTMutation.d.ts.map

package/dist/esm/rest/RESTMutation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RESTMutation.d.ts","sourceRoot":"","sources":["../../../src/rest/RESTMutation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,8BAAsB,YAAa,SAAQ,QAAQ;IACjD,OAAgB,UAAU,6BAAuB;IAEjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAU;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,cAAc,CAAC,EAAE,mBAAmB,CAAC;IAErC,cAAc,IAAI,MAAM;IAIxB,OAAO,CAAC,IAAI,MAAM,GAAG,SAAS;IAC9B,SAAS,CAAC,IAAI,MAAM;IACpB,OAAO,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAC/C,iBAAiB,CAAC,IAAI,mBAAmB,GAAG,SAAS;CACtD"}

package/dist/esm/rest/RESTQuery.d.ts

@@ -0,0 +1,24 @@
+import { Query } from '../query.js';
+import { RESTQueryController } from './RESTQueryController.js';
+import type { FetchNextConfig } from '../query-types.js';
+import type { BaseUrlValue, QueryRequestOptions } from '../types.js';
+export declare abstract class RESTQuery extends Query {
+    static controller: typeof RESTQueryController;
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    path?: string;
+    baseUrl?: BaseUrlValue;
+    searchParams?: Record<string, unknown>;
+    body?: Record<string, unknown>;
+    headers?: HeadersInit;
+    requestOptions?: QueryRequestOptions;
+    fetchNext?: FetchNextConfig;
+    response: Response | undefined;
+    getIdentityKey(): string;
+    getPath?(): string | undefined;
+    getMethod?(): string;
+    getSearchParams?(): Record<string, unknown> | undefined;
+    getBody?(): Record<string, unknown> | undefined;
+    getRequestOptions?(): QueryRequestOptions | undefined;
+    getFetchNext?(): FetchNextConfig | undefined;
+}
+//# sourceMappingURL=RESTQuery.d.ts.map

package/dist/esm/rest/RESTQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RESTQuery.d.ts","sourceRoot":"","sources":["../../../src/rest/RESTQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAMrE,8BAAsB,SAAU,SAAQ,KAAK;IAC3C,OAAgB,UAAU,6BAAuB;IAEjD,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAS;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,cAAc,CAAC,EAAE,mBAAmB,CAAC;IACrC,SAAS,CAAC,EAAE,eAAe,CAAC;IAEpB,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAC;IAEvC,cAAc,IAAI,MAAM;IAKxB,OAAO,CAAC,IAAI,MAAM,GAAG,SAAS;IAC9B,SAAS,CAAC,IAAI,MAAM;IACpB,eAAe,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IACvD,OAAO,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAC/C,iBAAiB,CAAC,IAAI,mBAAmB,GAAG,SAAS;IACrD,YAAY,CAAC,IAAI,eAAe,GAAG,SAAS;CAC7C"}

package/dist/esm/rest/RESTQueryController.d.ts

@@ -0,0 +1,34 @@
+import { QueryController } from '../QueryController.js';
+import type { Query } from '../query.js';
+import type { Mutation } from '../mutation.js';
+import type { QueryRequestInit, BaseUrlValue } from '../types.js';
+export interface ResolvedFetchNext {
+    url?: string;
+    searchParams?: Record<string, unknown>;
+}
+export interface RESTQueryControllerOptions {
+    fetch?: (url: string, init?: QueryRequestInit) => Promise<Response>;
+    baseUrl?: BaseUrlValue;
+}
+export declare class RESTQueryController extends QueryController {
+    private readonly _fetch;
+    private readonly _baseUrl;
+    constructor(options?: RESTQueryControllerOptions);
+    send(ctx: Query, signal: AbortSignal): Promise<unknown>;
+    sendNext(ctx: Query, signal: AbortSignal): Promise<unknown>;
+    hasNext(ctx: Query): boolean;
+    private resolveFetchNext;
+    /**
+     * 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.
+     */
+    private buildUrl;
+    private executeRequest;
+    sendMutation(ctx: Mutation, signal: AbortSignal): Promise<unknown>;
+}
+//# sourceMappingURL=RESTQueryController.d.ts.map

package/dist/esm/rest/RESTQueryController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RESTQueryController.d.ts","sourceRoot":"","sources":["../../../src/rest/RESTQueryController.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAuB,MAAM,aAAa,CAAC;AAMvF,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAMD,MAAM,WAAW,0BAA0B;IACzC,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,gBAAgB,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpE,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB;AAMD,qBAAa,mBAAoB,SAAQ,eAAe;IACtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8D;IACrF,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2B;gBAExC,OAAO,CAAC,EAAE,0BAA0B;IAOjC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvD,QAAQ,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAQjE,OAAO,CAAC,GAAG,EAAE,KAAK,GAAG,OAAO;IAsBrC,OAAO,CAAC,gBAAgB;IAmBxB;;;;;;;;OAQG;IACH,OAAO,CAAC,QAAQ;YAyBF,cAAc;IA0Db,YAAY,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;CA+BlF"}

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

@@ -0,0 +1,5 @@
+export { RESTQuery } from './RESTQuery.js';
+export { RESTMutation } from './RESTMutation.js';
+export { RESTQueryController } from './RESTQueryController.js';
+export type { ResolvedFetchNext, RESTQueryControllerOptions } from './RESTQueryController.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/rest/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/esm/stores/shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/stores/shared.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,WAAW,OAAQ,MAAM,WAAyB,CAAC;AAChE,eAAO,MAAM,cAAc,OAAQ,MAAM,WAA4B,CAAC;AACtE,eAAO,MAAM,YAAY,OAAQ,MAAM,WAA0B,CAAC;AAClE,eAAO,MAAM,eAAe,OAAQ,MAAM,WAA6B,CAAC;AAExE,eAAO,MAAM,WAAW,eAAgB,MAAM,WAAiC,CAAC;AAEhF,eAAO,MAAM,cAAc,eAAgB,MAAM,WAAoC,CAAC;AACtF,eAAO,MAAM,eAAe,eAAgB,MAAM,WAAqC,CAAC;AAExF,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AAGnD,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,eAAO,MAAM,kBAAkB,QAAU,CAAC;AAC1C,eAAO,MAAM,eAAe,IAAI,CAAC"}
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/stores/shared.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,WAAW,GAAI,IAAI,MAAM,WAAyB,CAAC;AAChE,eAAO,MAAM,cAAc,GAAI,IAAI,MAAM,WAA4B,CAAC;AACtE,eAAO,MAAM,YAAY,GAAI,IAAI,MAAM,WAA0B,CAAC;AAClE,eAAO,MAAM,eAAe,GAAI,IAAI,MAAM,WAA6B,CAAC;AAExE,eAAO,MAAM,WAAW,GAAI,YAAY,MAAM,WAAiC,CAAC;AAEhF,eAAO,MAAM,cAAc,GAAI,YAAY,MAAM,WAAoC,CAAC;AACtF,eAAO,MAAM,eAAe,GAAI,YAAY,MAAM,WAAqC,CAAC;AAExF,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AAGnD,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,eAAO,MAAM,kBAAkB,QAAU,CAAC;AAC1C,eAAO,MAAM,eAAe,IAAI,CAAC"}

package/dist/esm/testing/MockClient.d.ts

@@ -0,0 +1,64 @@
+import { QueryClient } from '../QueryClient.js';
+import { Query } from '../query.js';
+import { Mutation } from '../mutation.js';
+import type { Entity } from '../proxy.js';
+import type { MockFetchCall, EntityGenerators, ResponseTransform } from './types.js';
+import { GeneratorContext } from './auto-generate.js';
+interface MockRoute {
+    method: string;
+    url: string;
+    responses: MockRouteResponse[];
+    currentIndex: number;
+}
+interface MockRouteResponse {
+    data?: unknown;
+    status: number;
+    headers: Record<string, string>;
+    delay: number;
+    error?: Error;
+    networkError?: string;
+}
+export declare class MockQueryBuilder<T extends Query | Mutation = Query> {
+    private route;
+    private mockClient;
+    constructor(mockClient: MockClient, method: string, url: string);
+    respond(data: unknown): this;
+    thenRespond(data: unknown): this;
+    auto(overrides?: Record<string, unknown>): this;
+    error(status?: number, body?: unknown): this;
+    networkError(message?: string): this;
+    raw(data: unknown): this;
+    delay(ms: number): this;
+    private _pendingDelay;
+    private applyPendingDelay;
+}
+export declare class MockClient {
+    private _client;
+    private routes;
+    private _calls;
+    private queryClassMap;
+    private _responseTransforms;
+    /** @internal */
+    _generatorCtx: GeneratorContext;
+    constructor();
+    get client(): QueryClient;
+    get calls(): readonly MockFetchCall[];
+    when<T extends Query>(queryClass: new () => T, params?: Record<string, unknown>): MockQueryBuilder<T>;
+    entity<T extends Entity>(cls: new () => T, overrides?: Record<string, unknown>): Record<string, unknown>;
+    define<T extends Entity>(cls: new () => T, generators: EntityGenerators<T>): void;
+    wasCalled(queryClass: new () => Query | Mutation, params?: Record<string, unknown>): boolean;
+    lastCall(queryClass: new () => Query | Mutation): MockFetchCall | undefined;
+    _setResponseTransform(key: string, transform: ResponseTransform): void;
+    _clearResponseTransform(key: string): void;
+    _clearAllResponseTransforms(): void;
+    reset(): void;
+    destroy(): void;
+    /** @internal */
+    _registerRoute(route: MockRoute): void;
+    /** @internal */
+    _getQueryClassForRoute(route: MockRoute): (new () => Query | Mutation) | undefined;
+    private _mockFetch;
+    private _findRoute;
+}
+export {};
+//# sourceMappingURL=MockClient.d.ts.map

package/dist/esm/testing/MockClient.d.ts.map

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

package/dist/esm/testing/auto-generate.d.ts

@@ -0,0 +1,20 @@
+import { type InternalTypeDef, type InternalObjectShape } from '../types.js';
+import type { Entity } from '../proxy.js';
+import type { FieldGenerator } from './types.js';
+export declare class GeneratorContext {
+    private idCounters;
+    private seqCounters;
+    private visiting;
+    private factories;
+    registerFactory(cls: new () => Entity, generators: Record<string, FieldGenerator | unknown>): void;
+    nextId(typename?: string): string;
+    nextSeq(typename?: string): number;
+    getFactory(cls: new () => Entity): Record<string, FieldGenerator | unknown> | undefined;
+    enterEntity(typename: string): boolean;
+    leaveEntity(typename: string): void;
+    reset(): void;
+}
+export declare function generateFromTypeDef(typeDef: InternalTypeDef, fieldName: string, ctx: GeneratorContext): unknown;
+export declare function generateEntityData(cls: new () => Entity, overrides?: Record<string, unknown>, ctx?: GeneratorContext): Record<string, unknown>;
+export declare function generateQueryResponse(resultDef: InternalTypeDef | InternalObjectShape, ctx: GeneratorContext, overrides?: Record<string, unknown>): unknown;
+//# sourceMappingURL=auto-generate.d.ts.map

package/dist/esm/testing/auto-generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-generate.d.ts","sourceRoot":"","sources":["../../../src/testing/auto-generate.ts"],"names":[],"mappings":"AACA,OAAO,EAAQ,KAAK,eAAe,EAAE,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMjD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,SAAS,CAAyE;IAE1F,eAAe,CAAC,GAAG,EAAE,UAAU,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,GAAG,IAAI;IAIlG,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM;IAQjC,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM;IAQlC,UAAU,CAAC,GAAG,EAAE,UAAU,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,GAAG,SAAS;IAIvF,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAMtC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAInC,KAAK,IAAI,IAAI;CAKd;AAMD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAe/G;AAoKD,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,UAAU,MAAM,EACrB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,GAAG,CAAC,EAAE,gBAAgB,GACrB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUzB;AAED,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,eAAe,GAAG,mBAAmB,EAChD,GAAG,EAAE,gBAAgB,EACrB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,OAAO,CAgBT"}

package/dist/esm/testing/entity-factory.d.ts

@@ -0,0 +1,13 @@
+import type { Entity } from '../proxy.js';
+import type { EntityGenerators } from './types.js';
+import { GeneratorContext } from './auto-generate.js';
+export declare class EntityFactory<T extends Entity> {
+    private cls;
+    private generators;
+    private ctx;
+    constructor(cls: new () => T, generators: EntityGenerators<T>, ctx?: GeneratorContext);
+    build(overrides?: Partial<Record<string, unknown>>): Record<string, unknown>;
+    buildMany(count: number, overrides?: Partial<Record<string, unknown>>): Record<string, unknown>[];
+}
+export declare function defineFactory<T extends Entity>(cls: new () => T, generators: EntityGenerators<T>): EntityFactory<T>;
+//# sourceMappingURL=entity-factory.d.ts.map

package/dist/esm/testing/entity-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-factory.d.ts","sourceRoot":"","sources":["../../../src/testing/entity-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAkB,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAsB,MAAM,oBAAoB,CAAC;AAE1E,qBAAa,aAAa,CAAC,CAAC,SAAS,MAAM;IACzC,OAAO,CAAC,GAAG,CAAc;IACzB,OAAO,CAAC,UAAU,CAA2C;IAC7D,OAAO,CAAC,GAAG,CAAmB;gBAElB,GAAG,EAAE,UAAU,CAAC,EAAE,UAAU,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,gBAAgB;IAOrF,KAAK,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAI5E,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;CAOlG;AAED,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,UAAU,CAAC,EAAE,UAAU,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAEnH"}

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

@@ -0,0 +1,6 @@
+export { MockClient, MockQueryBuilder } from './MockClient.js';
+export { generateEntityData as entity } from './auto-generate.js';
+export { GeneratorContext } from './auto-generate.js';
+export { defineFactory, EntityFactory } from './entity-factory.js';
+export type { DotPaths, VaryableFields, MockFetchCall, FieldGenerator, EntityGenerators, ResponseTransform, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAG/D,OAAO,EAAE,kBAAkB,IAAI,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGnE,YAAY,EACV,QAAQ,EACR,cAAc,EACd,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,YAAY,CAAC"}

package/dist/esm/testing/types.d.ts

@@ -0,0 +1,37 @@
+import type { Query } from '../query.js';
+import type { Entity } from '../proxy.js';
+import type { ExtractType, TypeDefShape } from '../types.js';
+type Primitive = string | number | boolean | null | undefined | Date;
+type DataKeys<T> = {
+    [K in keyof T & string]: K extends `__${string}` ? never : T[K] extends (...args: any[]) => any ? never : K;
+}[keyof T & string];
+export type DotPaths<T, Depth extends unknown[] = []> = Depth['length'] extends 5 ? never : T extends Primitive ? never : T extends (infer U)[] ? DotPaths<U, Depth> : T extends object ? {
+    [K in DataKeys<T>]: K | `${K}.${DotPaths<NonNullable<T[K]>, [...Depth, unknown]>}`;
+}[DataKeys<T>] : never;
+export type VaryableFields<T extends Query> = DotPaths<ExtractType<T['result']>>;
+export type MockQueryResponse<T extends Query> = T['result'] extends TypeDefShape ? RawResponseData<ExtractType<T['result']>> : unknown;
+export type RawResponseData<T> = T extends Entity ? RawEntityData<T> : T extends (infer U)[] ? RawResponseData<U>[] : T extends object ? {
+    [K in keyof T]?: RawResponseData<T[K]>;
+} : T;
+export type RawEntityData<T extends Entity> = {
+    [K in keyof T as K extends `__${string}` ? K : K]?: T[K] extends Entity ? RawEntityData<T[K]> : T[K] extends Entity[] ? RawEntityData<T[K][number]>[] : T[K];
+};
+export type FieldGenerator<T = unknown> = (seq: number, fields: Record<string, unknown>) => T;
+export type EntityGenerators<T extends Entity> = {
+    [K in keyof T as K extends `__${string}` ? never : K]?: unknown | FieldGenerator;
+};
+export interface MockFetchCall {
+    url: string;
+    method: string;
+    body?: unknown;
+    options: RequestInit;
+}
+export interface MockFetchOptions {
+    status?: number;
+    headers?: Record<string, string>;
+    delay?: number;
+    error?: Error;
+}
+export type ResponseTransform = (data: unknown) => unknown;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/testing/types.d.ts.map

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

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

@@ -0,0 +1,10 @@
+import { Query } from '../query.js';
+import type { TopicQueryController } from './TopicQueryController.js';
+import type { QueryConfigOptions } from '../query-types.js';
+export declare abstract class TopicQuery extends Query {
+    static controller: typeof TopicQueryController;
+    abstract topic: string;
+    getIdentityKey(): string;
+    getConfig(): QueryConfigOptions;
+}
+//# sourceMappingURL=TopicQuery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TopicQuery.d.ts","sourceRoot":"","sources":["../../../src/topic/TopicQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAM5D,8BAAsB,UAAW,SAAQ,KAAK;IAC5C,OAAgB,UAAU,EAAE,OAAO,oBAAoB,CAAC;IAExD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,cAAc,IAAI,MAAM;IAIxB,SAAS,IAAI,kBAAkB;CAWhC"}

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

@@ -0,0 +1,43 @@
+import { QueryController } from '../QueryController.js';
+import type { Query } from '../query.js';
+import type { MutationEvent } from '../types.js';
+export declare abstract class TopicQueryController extends QueryController {
+    private _topics;
+    /**
+     * Called when a query activates for a given topic.
+     * Implementations should start delivering data for this topic,
+     * calling `fulfillTopic()` when initial data is available and
+     * `sendMutationEvent()` for ongoing updates.
+     */
+    abstract subscribe(topic: string): void;
+    /**
+     * Called when the query deactivates. Implementations should
+     * tear down any resources for this topic.
+     */
+    abstract unsubscribe(topic: string): void;
+    /**
+     * 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.
+     */
+    protected fulfillTopic(topic: string, data: unknown): void;
+    /**
+     * Reject the pending promise for a topic.
+     * Can be called before `send()` — the error will be propagated
+     * when the query activates.
+     */
+    protected rejectTopic(topic: string, error: unknown): void;
+    /**
+     * Clears internal state for a topic. Called automatically by
+     * `unsubscribe` — subclasses generally don't need to call this.
+     */
+    protected clearTopic(topic: string): void;
+    protected clearAll(): void;
+    send(ctx: Query, _signal: AbortSignal): Promise<unknown>;
+    /**
+     * Convenience wrapper — pushes a mutation event through the QueryClient
+     * so that entities and live collections are updated reactively.
+     */
+    protected sendMutationEvent(event: MutationEvent): void;
+}
+//# sourceMappingURL=TopicQueryController.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TopicQueryController.d.ts","sourceRoot":"","sources":["../../../src/topic/TopicQueryController.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAoBjD,8BAAsB,oBAAqB,SAAQ,eAAe;IAChE,OAAO,CAAC,OAAO,CAAiC;IAEhD;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAEvC;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAEzC;;;;OAIG;IACH,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAe1D;;;;OAIG;IACH,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAe1D;;;OAGG;IACH,SAAS,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIzC,SAAS,CAAC,QAAQ,IAAI,IAAI;IAIX,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAgCvE;;;OAGG;IACH,SAAS,CAAC,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;CAGxD"}

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

@@ -0,0 +1,3 @@
+export { TopicQuery } from './TopicQuery.js';
+export { TopicQueryController } from './TopicQueryController.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/topic/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/esm/typeDefs.d.ts

@@ -27,7 +27,7 @@ export declare class ValidatorDef<T> {
         gcTime?: number;
     } | undefined;
     /**
-     * Live collection configuration (shared by LiveArray and LiveValue).
+     * Live data configuration (shared by LiveArray and LiveValue).
      */
     _liveConfig: LiveFieldConfig | undefined;
     constructor(mask: Mask, shape: InternalTypeDef | InternalObjectShape | UnionTypeDefs | ComplexTypeDef[] | undefined, values?: Set<string | boolean | number>, typenameField?: string, typenameValue?: string, idField?: string | symbol);

package/dist/esm/types.d.ts

@@ -98,14 +98,17 @@ export interface CaseInsensitiveEnumSet<T extends string | boolean | number> ext
      */
     get(value: unknown): T | undefined;
 }
-declare const TypeDefSymbol: unique symbol;
 /**
  * Branded phantom type representing a type definition in the public API.
  * At runtime, values are Masks, Sets, ValidatorDefs, etc. but the type system
  * sees them as TypeDef<T> where T is the extracted TypeScript type.
+ *
+ * Uses a string brand instead of unique symbol to avoid TS4029 errors
+ * during declaration emit in downstream packages.
+ * See: https://github.com/microsoft/TypeScript/issues/56107
  */
 export type TypeDef<T = unknown> = T & {
-    readonly [TypeDefSymbol]: T;
+    readonly __fetchiumTypeDef: T;
 };
 export type SimpleTypeDef = Set<string | boolean | number> | CaseInsensitiveEnumSet<string | boolean | number> | Mask;
 export type ComplexTypeDef = ObjectDef | EntityDef | ArrayDef | RecordDef | UnionDef | ParseResultDef;
@@ -206,9 +209,9 @@ export type ExtractType<T> = IsAny<T> extends true ? any : T extends TypeDef<inf
 export type TypeDefShape = Record<string, TypeDef> | TypeDef;
 export type QueryResult<T extends Query> = ExtractType<T['result']> & {
     __refetch(): DiscriminatedReactivePromise<QueryResult<T>>;
-    __loadNext(): Promise<QueryResult<T>>;
+    __fetchNext(): Promise<QueryResult<T>>;
     __hasNext: boolean;
-    __isLoadingNext: boolean;
+    __isFetchingNext: boolean;
 };
 export type QueryPromise<T extends Query> = DiscriminatedReactivePromise<QueryResult<T>>;
 export interface CreateEvent {
@@ -263,10 +266,12 @@ export declare class LiveFieldConfig {
     static value(entityDefs: import('./typeDefs.js').ValidatorDef<any>[], constraintFieldRefs: Map<string, Array<[string, unknown]>> | undefined, valueType: InternalTypeDef, onCreate: (value: unknown, entity: unknown) => unknown, onUpdate: (value: unknown, entity: unknown) => unknown, onDelete: (value: unknown, entity: unknown) => unknown): LiveFieldConfig;
 }
 export type EntityClassOrTypename = string | (new () => import('./proxy.js').Entity);
+export type InvalidateTarget = (new () => import('./query.js').Query) | readonly [new () => import('./query.js').Query, Record<string, unknown>];
 export interface MutationEffects {
     readonly creates?: ReadonlyArray<readonly [EntityClassOrTypename, unknown]>;
     readonly updates?: ReadonlyArray<readonly [EntityClassOrTypename, unknown]>;
     readonly deletes?: ReadonlyArray<readonly [EntityClassOrTypename, unknown]>;
+    readonly invalidates?: ReadonlyArray<InvalidateTarget>;
 }
 export {};
 //# sourceMappingURL=types.d.ts.map