fetchium 0.0.0 → 0.1.1

package/dist/esm/NetworkManager.d.ts

@@ -0,0 +1,62 @@
+/**
+ * NetworkManager - Tracks network connectivity status
+ *
+ * Features:
+ * - Signal-based reactivity for online/offline status
+ * - Automatic detection using navigator.onLine and events
+ * - Manual override capability for testing and custom scenarios
+ * - Platform-agnostic (works in browser and React Native)
+ */
+import { Signal, Context } from 'signalium';
+export declare class NetworkManager {
+    private onlineSignal;
+    private manualOverride;
+    private eventListenersAttached;
+    constructor(initialStatus?: boolean);
+    /**
+     * Returns true if the network is currently online
+     */
+    get isOnline(): boolean;
+    /**
+     * Manually set the network status (useful for testing)
+     */
+    setNetworkStatus(online: boolean): void;
+    /**
+     * Clear manual override and return to automatic detection
+     */
+    clearManualOverride(): void;
+    /**
+     * Get the reactive signal for online status
+     * This allows reactive functions to depend on network status
+     */
+    getOnlineSignal(): Signal<boolean>;
+    /**
+     * Detect current online status from the environment
+     */
+    private detectOnlineStatus;
+    /**
+     * Check if we can attach event listeners (browser or React Native)
+     */
+    private canAttachListeners;
+    /**
+     * Remove event listeners and clean up resources.
+     */
+    destroy(): void;
+    private handleOnline;
+    private handleOffline;
+    /**
+     * Attach event listeners for online/offline events
+     */
+    private attachEventListeners;
+}
+export declare class NoOpNetworkManager {
+    private static readonly onlineSignal;
+    get isOnline(): boolean;
+    setNetworkStatus(_online: boolean): void;
+    clearManualOverride(): void;
+    getOnlineSignal(): Signal<boolean>;
+    destroy(): void;
+}
+export declare const defaultNetworkManager: NetworkManager;
+export declare const NetworkManagerContext: Context<NetworkManager>;
+//# sourceMappingURL=NetworkManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NetworkManager.d.ts","sourceRoot":"","sources":["../../src/NetworkManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAU,MAAM,EAAW,OAAO,EAAE,MAAM,WAAW,CAAC;AAE7D,qBAAa,cAAc;IACzB,OAAO,CAAC,YAAY,CAAkB;IACtC,OAAO,CAAC,cAAc,CAAkC;IACxD,OAAO,CAAC,sBAAsB,CAAS;gBAE3B,aAAa,CAAC,EAAE,OAAO;IAWnC;;OAEG;IACH,IAAI,QAAQ,IAAI,OAAO,CAOtB;IAED;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAKvC;;OAEG;IACH,mBAAmB,IAAI,IAAI;IAK3B;;;OAGG;IACH,eAAe,IAAI,MAAM,CAAC,OAAO,CAAC;IAIlC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAU1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAI1B;;OAEG;IACH,OAAO,IAAI,IAAI;IAQf,OAAO,CAAC,YAAY,CAAuC;IAC3D,OAAO,CAAC,aAAa,CAAuC;IAE5D;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAsB7B;AAGD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAiC;IAErE,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIxC,mBAAmB,IAAI,IAAI;IAI3B,eAAe,IAAI,MAAM,CAAC,OAAO,CAAC;IAIlC,OAAO,IAAI,IAAI;CAGhB;AAGD,eAAO,MAAM,qBAAqB,gBAAuB,CAAC;AAG1D,eAAO,MAAM,qBAAqB,EAAE,OAAO,CAAC,cAAc,CAAkD,CAAC"}

package/dist/esm/QueryClient.d.ts

@@ -0,0 +1,98 @@
+import { ReactiveTask, type Context } from 'signalium';
+import { EntityDef, MutationEvent, QueryPromise, InternalTypeDef, InvalidateTarget } from './types.js';
+import { EntityStore } from './EntityStore.js';
+import { EntityInstance } from './EntityInstance.js';
+import { NetworkManager } from './NetworkManager.js';
+import { QueryInstance } from './QueryResult.js';
+import { MutationResultImpl } from './MutationResult.js';
+import { MutationDefinition } from './mutation.js';
+import { GcManager, NoOpGcManager } from './GcManager.js';
+import { Query, QueryDefinition } from './query.js';
+import { type ParseResult } from './parseEntities.js';
+import { type ApplyResult } from './applyEntities.js';
+import { ValidatorDef } from './typeDefs.js';
+import { ConstraintMatcher } from './ConstraintMatcher.js';
+import { LiveCollectionBinding } from './LiveCollection.js';
+import { QueryController } from './QueryController.js';
+import { type QueryContext, type QueryStore, type QueryParams, type PreloadedEntityMap } from './query-types.js';
+export interface QueryClientConfig {
+    store?: QueryStore;
+    controllers?: QueryController[];
+    networkManager?: NetworkManager;
+    gcManager?: GcManager | NoOpGcManager;
+    log?: {
+        error?: (message: string, error?: unknown) => void;
+        warn?: (message: string, error?: unknown) => void;
+        info?: (message: string) => void;
+        debug?: (message: string) => void;
+    };
+    evictionMultiplier?: number;
+}
+export { type QueryContext, type QueryCacheOptions, type QueryConfigOptions, type FetchNextConfig, type QueryParams, type QueryStore, type CachedQuery, type PreloadedEntityMap, type MaybePromise, resolveBaseUrl, extractParamsForKey, queryKeyFor, } from './query-types.js';
+export declare class QueryClient {
+    entityMap: EntityStore;
+    queryInstances: Map<number, QueryInstance<any>>;
+    mutationInstances: Map<string, MutationResultImpl<unknown, unknown>>;
+    gcManager: GcManager | NoOpGcManager;
+    networkManager: NetworkManager;
+    isServer: boolean;
+    store: QueryStore;
+    currentParseId: number;
+    private context;
+    private typenameRegistry;
+    private constraintRegistry;
+    private mergedDefCache;
+    private controllers;
+    private networkUnsubscribe;
+    constructor(config?: QueryClientConfig);
+    /**
+     * Returns the registered controller instance for the given controller class.
+     * Throws if no controller of that class has been registered.
+     */
+    getController(controllerClass: typeof QueryController): QueryController;
+    getContext(): QueryContext;
+    private registerEntityDef;
+    getEntityDefsForTypename(typename: string): ValidatorDef<any>[] | undefined;
+    getMergedDef(typename: string): ValidatorDef<any> | undefined;
+    saveQueryData(queryDef: QueryDefinition<QueryParams | undefined, unknown, unknown>, queryKey: number, data: unknown, updatedAt: number, entityRefs?: Map<EntityInstance, number>): void;
+    activateQuery(queryInstance: QueryInstance<any>): void;
+    loadCachedQuery(queryDef: QueryDefinition<QueryParams | undefined, unknown, unknown>, queryKey: number): import("./query-types.js").MaybePromise<import("./query-types.js").CachedQuery | undefined>;
+    /**
+     * Loads a query from the document store and returns a QueryResult
+     * that triggers fetches and prepopulates with cached data
+     */
+    getQuery<T extends Query>(queryDef: QueryDefinition<any, any, any>, params: QueryParams | undefined): QueryPromise<T>;
+    /**
+     * Gets or creates a MutationResult for the given mutation definition.
+     * Mutations are cached by their definition ID.
+     */
+    getMutation<Request, Response>(mutationDef: MutationDefinition<Request, Response>): ReactiveTask<Response, [Request]>;
+    /**
+     * Parse data: validates, formats, produces parsed entity data objects.
+     * Does NOT touch the entity store. Call applyRefs() after to commit entities.
+     */
+    parseData(obj: unknown, shape: InternalTypeDef, preloadedEntities?: PreloadedEntityMap): ParseResult;
+    /**
+     * Apply entities from parseData() via a single depth-first walk: creates/
+     * updates EntityInstances, replaces parsed data with proxies, counts child
+     * refs. Returns the reified data and root-level entity refs.
+     */
+    applyRefs(parseResult: ParseResult, persist?: boolean, appendMode?: boolean): ApplyResult;
+    /**
+     * Parse and apply data as a root entity. For non-entity results, injects
+     * QUERY_ID onto the payload. Returns the root EntityInstance (created or
+     * found in the store by the standard entity pipeline).
+     */
+    parseAndApplyRootEntity(obj: unknown, queryId: number, rootEntityShape: ValidatorDef<any>, persist: boolean, appendMode?: boolean, preloadedEntities?: PreloadedEntityMap): EntityInstance;
+    prepareEntity(key: number, obj: Record<string, unknown>, shape: EntityDef): EntityInstance;
+    applyMutationEvent(event: MutationEvent): void;
+    invalidateQueries(targets: ReadonlyArray<InvalidateTarget>): void;
+    private handleEviction;
+    getOrCreateMatcher(typename: string): ConstraintMatcher;
+    registerLiveCollection(binding: LiveCollectionBinding): void;
+    unregisterLiveCollection(binding: LiveCollectionBinding): void;
+    private routeEvent;
+    destroy(): void;
+}
+export declare const QueryClientContext: Context<QueryClient | undefined>;
+//# sourceMappingURL=QueryClient.d.ts.map

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

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

package/dist/esm/QueryController.d.ts

@@ -0,0 +1,49 @@
+import { type QueryContext } from './query-types.js';
+import type { Query } from './query.js';
+import type { Mutation } from './mutation.js';
+export interface IQueryClientForController {
+    getContext(): QueryContext;
+    applyMutationEvent(event: import('./types.js').MutationEvent): void;
+}
+export declare abstract class QueryController {
+    protected queryClient: IQueryClientForController | undefined;
+    /**
+     * Called once by QueryClient when this controller is registered.
+     * Subclasses can override to do setup (e.g. open a WebSocket connection).
+     */
+    register(queryClient: IQueryClientForController): void;
+    /**
+     * Called when the network comes online or goes offline.
+     * Subclasses can override to reconnect persistent connections (e.g. WebSocket).
+     */
+    onNetworkStatusChange?(isOnline: boolean): void;
+    /**
+     * Called when the QueryClient is destroyed.
+     * Subclasses can override to clean up connections or timers.
+     */
+    destroy?(): void;
+    /**
+     * Send the query and return the raw response data.
+     * @param ctx  The query execution context (a reified Query instance with params applied).
+     * @param signal  AbortSignal to cancel the in-flight request.
+     */
+    abstract send(ctx: Query, signal: AbortSignal): Promise<unknown>;
+    /**
+     * Fetch the next page of results. Only implement if the controller supports pagination.
+     * @param ctx  The query execution context. `ctx.resultData` contains the current page's data.
+     * @param signal  AbortSignal to cancel the in-flight request.
+     */
+    sendNext?(ctx: Query, signal: AbortSignal): Promise<unknown>;
+    /**
+     * Return true if more pages are available for the current result.
+     * Called reactively — do not perform async work here.
+     */
+    hasNext?(ctx: Query): boolean;
+    /**
+     * Send a mutation and return the raw response data.
+     * @param ctx  The mutation execution context (a reified Mutation instance with params applied).
+     * @param signal  AbortSignal to cancel the in-flight request.
+     */
+    sendMutation?(ctx: Mutation, signal: AbortSignal): Promise<unknown>;
+}
+//# sourceMappingURL=QueryController.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"QueryController.d.ts","sourceRoot":"","sources":["../../src/QueryController.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAO9C,MAAM,WAAW,yBAAyB;IACxC,UAAU,IAAI,YAAY,CAAC;IAC3B,kBAAkB,CAAC,KAAK,EAAE,OAAO,YAAY,EAAE,aAAa,GAAG,IAAI,CAAC;CACrE;AAMD,8BAAsB,eAAe;IACnC,SAAS,CAAC,WAAW,EAAE,yBAAyB,GAAG,SAAS,CAAC;IAE7D;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,yBAAyB,GAAG,IAAI;IAItD;;;OAGG;IACH,qBAAqB,CAAC,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAE/C;;;OAGG;IACH,OAAO,CAAC,IAAI,IAAI;IAEhB;;;;OAIG;IACH,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAEhE;;;;OAIG;IACH,QAAQ,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAE5D;;;OAGG;IACH,OAAO,CAAC,CAAC,GAAG,EAAE,KAAK,GAAG,OAAO;IAE7B;;;;OAIG;IACH,YAAY,CAAC,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;CACpE"}

package/dist/esm/QueryResult.d.ts

@@ -0,0 +1,67 @@
+import { DiscriminatedReactivePromise } from 'signalium';
+import { type QueryResult } from './types.js';
+import { type QueryClient, type QueryParams, type QueryConfigOptions } from './QueryClient.js';
+import { Query, QueryDefinition, type ResolvedRetryConfig } from './query.js';
+import { EntityInstance } from './EntityInstance.js';
+/**
+ * Thin fetch/relay orchestrator. Data management (proxy, notifier, child refs,
+ * live data) is fully delegated to a root EntityInstance.
+ */
+export declare class QueryInstance<T extends Query> {
+    def: QueryDefinition<any, any, any>;
+    queryKey: number;
+    storageKey: number;
+    /** The public-facing ReactivePromise returned to consumers. */
+    readonly relay: DiscriminatedReactivePromise<QueryResult<T>>;
+    private queryClient;
+    private initialized;
+    private updatedAt;
+    private params;
+    private unsubscribe?;
+    private _relayState;
+    private wasPaused;
+    private currentParams;
+    private debounceTimer;
+    /** Resolved per-instance options (depend on actual params). */
+    config: QueryConfigOptions | undefined;
+    retryConfig: ResolvedRetryConfig;
+    /** Controller for aborting in-flight fetches and retry waits. */
+    private _abortController;
+    /** Cached execution context, recreated only when storageKey (params) changes. */
+    private _executionCtx;
+    private _executionCtxKey;
+    /** Root entity that holds parsed data, proxy, child refs, and bindings.
+     *  For entity results, this is undefined until the first apply discovers it. */
+    rootEntity: EntityInstance | undefined;
+    /** Extra methods (__refetch, __fetchNext) attached to the root entity proxy. */
+    private _extraMethods;
+    /** Query id injected as QUERY_ID on non-entity payloads. */
+    private _queryId;
+    get key(): number;
+    private get relayState();
+    constructor(def: QueryDefinition<any, any, any>, queryClient: QueryClient, queryKey: number, params: QueryParams | undefined);
+    /** Apply raw data (fresh or cached) to the root entity and return the proxy. */
+    private applyData;
+    /** Save query metadata (the __entityRef pointer, updatedAt, ref set). */
+    private saveQueryMetadata;
+    private initialize;
+    private setupSubscription;
+    private getOrCreateExecutionContext;
+    private resolveAndApplyOptions;
+    private runQuery;
+    private runQueryImmediately;
+    private runDebounced;
+    refetch: () => DiscriminatedReactivePromise<QueryResult<T>>;
+    markStale(): void;
+    get resolvedParams(): QueryParams | undefined;
+    /** In-flight fetchNext promise for deduplication. */
+    private _fetchNextPromise;
+    /** Controller for aborting in-flight fetchNext requests. */
+    private _fetchNextAbort;
+    fetchNext: () => Promise<QueryResult<T>>;
+    private get hasNext();
+    private runFetchNext;
+    private get isStale();
+    private get isPaused();
+}
+//# sourceMappingURL=QueryResult.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"QueryResult.d.ts","sourceRoot":"","sources":["../../src/QueryResult.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,4BAA4B,EAAE,MAAM,WAAW,CAAC;AACjF,OAAO,EAAe,KAAK,WAAW,EAAkB,MAAM,YAAY,CAAC;AAC3E,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EAIxB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,mBAAmB,EAAsB,MAAM,YAAY,CAAC;AAClG,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAIrD;;;GAGG;AACH,qBAAa,aAAa,CAAC,CAAC,SAAS,KAAK;IACxC,GAAG,EAAE,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAM;IAExB,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,EAAE,4BAA4B,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IAE7D,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,SAAS,CAAiC;IAClD,OAAO,CAAC,MAAM,CAAsC;IAEpD,OAAO,CAAC,WAAW,CAAC,CAAyB;IAE7C,OAAO,CAAC,WAAW,CAAqD;IACxE,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,aAAa,CAAsC;IAC3D,OAAO,CAAC,aAAa,CAAwD;IAE7E,+DAA+D;IAC/D,MAAM,EAAE,kBAAkB,GAAG,SAAS,CAAa;IACnD,WAAW,EAAE,mBAAmB,CAAiC;IAEjE,iEAAiE;IACjE,OAAO,CAAC,gBAAgB,CAA0C;IAElE,iFAAiF;IACjF,OAAO,CAAC,aAAa,CAAgC;IACrD,OAAO,CAAC,gBAAgB,CAAc;IAEtC;oFACgF;IAChF,UAAU,EAAE,cAAc,GAAG,SAAS,CAAC;IAEvC,gFAAgF;IAChF,OAAO,CAAC,aAAa,CAAuD;IAE5E,4DAA4D;IAC5D,OAAO,CAAC,QAAQ,CAAa;IAE7B,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,OAAO,KAAK,UAAU,GAKrB;gBAGC,GAAG,EAAE,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EACnC,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,WAAW,GAAG,SAAS;IA2FjC,gFAAgF;IAChF,OAAO,CAAC,SAAS;IA4BjB,yEAAyE;IACzE,OAAO,CAAC,iBAAiB;YAaX,UAAU;IAuCxB,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,2BAA2B;IAgBnC,OAAO,CAAC,sBAAsB;YAMhB,QAAQ;IA8BtB,OAAO,CAAC,mBAAmB;IAS3B,OAAO,CAAC,YAAY;IAiBpB,OAAO,QAAO,4BAA4B,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAIxD;IAEF,SAAS,IAAI,IAAI;IAIjB,IAAI,cAAc,IAAI,WAAW,GAAG,SAAS,CAE5C;IAED,qDAAqD;IACrD,OAAO,CAAC,iBAAiB,CAAkD;IAE3E,4DAA4D;IAC5D,OAAO,CAAC,eAAe,CAA0C;IAEjE,SAAS,QAAO,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CA4BrC;IAEF,OAAO,KAAK,OAAO,GAMlB;YAEa,YAAY;IA2B1B,OAAO,KAAK,OAAO,GAOlB;IAED,OAAO,KAAK,QAAQ,GAiBnB;CACF"}

package/dist/esm/applyEntities.d.ts

@@ -0,0 +1,12 @@
+import type { EntityInstance } from './EntityInstance.js';
+import type { ParseContext } from './parseEntities.js';
+export interface ApplyResult {
+    data: unknown;
+    entityRefs: Map<EntityInstance, number>;
+}
+/**
+ * Single depth-first walk from the root that applies entities to the store,
+ * replaces parsed data objects with entity proxies, and counts child refs.
+ */
+export declare function applyEntityRefs(ctx: ParseContext, rootData: unknown, persist: boolean, appendMode?: boolean): ApplyResult;
+//# sourceMappingURL=applyEntities.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"applyEntities.d.ts","sourceRoot":"","sources":["../../src/applyEntities.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAgB,MAAM,oBAAoB,CAAC;AAYrE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,EAAE,GAAG,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;CACzC;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,YAAY,EACjB,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,OAAO,EAChB,UAAU,GAAE,OAAe,GAC1B,WAAW,CASb"}