@nano_kit/query 1.0.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 - present, TrigenSoftware
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,95 @@
+# @nano_kit/query
+
+[![ESM-only package][package]][package-url]
+[![NPM version][npm]][npm-url]
+[![Dependencies status][deps]][deps-url]
+[![Install size][size]][size-url]
+[![Build status][build]][build-url]
+[![Coverage status][coverage]][coverage-url]
+
+[package]: https://img.shields.io/badge/package-ESM--only-ffe536.svg
+[package-url]: https://nodejs.org/api/esm.html
+
+[npm]: https://img.shields.io/npm/v/@nano_kit/query.svg
+[npm-url]: https://npmjs.com/package/@nano_kit/query
+
+[deps]: https://img.shields.io/librariesio/release/npm/@nano_kit/query
+[deps-url]: https://libraries.io/npm/@nano_kit/query/tree
+
+[size]: https://deno.bundlejs.com/badge?q=@nano_kit/query
+[size-url]: https://bundlejs.com/?q=@nano_kit/query
+
+[build]: https://img.shields.io/github/actions/workflow/status/TrigenSoftware/nano_kit/tests.yml?branch=main
+[build-url]: https://github.com/TrigenSoftware/nano_kit/actions
+
+[coverage]: https://img.shields.io/codecov/c/github/TrigenSoftware/nano_kit.svg
+[coverage-url]: https://app.codecov.io/gh/TrigenSoftware/nano_kit
+
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="../../website/src/assets/pulsar_white.svg">
+  <img alt="Four-pointed pulsar star logo" src="../../website/src/assets/pulsar_black.svg" width="100" height="100" align="right">
+</picture>
+
+A small and powerful remote data manager for [@nano_kit/store](../store) state manager.
+
+- **Small**. Minimal footprint with tree-shakable architecture.
+- **Type-safe**. Full TypeScript support with type inference for queries and mutations.
+- **Signal-based**. Built on top of [@nano_kit/store](../store)'s reactive signals for automatic UI updates.
+- **Flexible**. Supports queries, infinite queries, mutations, and operations with cache management.
+- **Extensible**. Customizable with settings and extensions.
+
+## Installation
+
+```bash
+pnpm add @nano_kit/store @nano_kit/query
+# or
+npm install @nano_kit/store @nano_kit/query
+# or
+yarn add @nano_kit/store @nano_kit/query
+```
+
+## Quick Start
+
+Here is a minimal example demonstrating reactive data fetching with automatic cache management:
+
+```ts
+import { signal, effect } from '@nano_kit/store'
+import { queryKey, client } from '@nano_kit/query'
+
+/* Define a cache key for your data */
+const PostKey = queryKey<[postId: number], Post | null>('post')
+
+/* Create a signal with the post ID to fetch */
+const $postId = signal(1)
+
+/* Create a query client */
+const { query } = client()
+
+/* Create a reactive query */
+const [$post, $postError, $postLoading] = query(PostKey, [$postId], postId => fetch(`/api/posts/${postId}`).then(r => r.json()))
+
+/* React to data changes (mounting $post triggers data fetching) */
+const unsub = effect(() => {
+  if ($postLoading()) {
+    console.log('Loading...')
+  } else if ($postError()) {
+    console.log('Error:', $postError())
+  } else {
+    console.log('Post:', $post())
+  }
+})
+// Output: Loading...
+// Output: Post: { id: 1, title: 'First Post', ... }
+
+/* Update triggers automatic refetch */
+$postId(2)
+// Output: Loading...
+// Output: Post: { id: 2, title: 'Second Post', ... }
+
+/* Cleanup: removes listener and stops data fetching */
+unsub()
+```
+
+## Documentation
+
+For comprehensive guides, advanced patterns, and API reference, visit the [documentation website](https://nano_kit.js.org/query).

package/dist/CacheStorage.d.ts

@@ -0,0 +1,39 @@
+import type { NewValue } from '@nano_kit/store';
+import type { CacheMap, CacheShardKey, CacheKey, CacheEntry } from './CacheStorage.types.js';
+export * from './CacheStorage.types.js';
+export declare const DEFAULT_DEDUPE_TIME = 4000;
+export declare const DEFAULT_CACHE_TIME: number;
+export declare const UNSET_REV: number;
+export declare function revLock(rev: number): number;
+export declare function revLocked(rev: number): boolean;
+export declare class CacheStorage {
+    dedupeTime: number;
+    cacheTime: number;
+    cache: CacheMap;
+    initial(): {
+        rev: number;
+        dedupes: number;
+        expires: number;
+        data: null;
+        error: null;
+        loading: boolean;
+    };
+    $get(key: CacheKey): CacheEntry<unknown>;
+    set(key: CacheShardKey | CacheKey, entry: NewValue<CacheEntry | undefined>): void;
+    /**
+     * Invalidate cache entry for the given key.
+     * If shard key is used, invalidate all entries in the shard.
+     * @param key - The cache key to invalidate.
+     */
+    invalidate(key: CacheShardKey | CacheKey): void;
+    /**
+     * Revalidate cache entry for the given key.
+     * If shard key is used, revalidate all entries in the shard.
+     * @param key - The cache key to revalidate.
+     */
+    revalidate(key: CacheShardKey | CacheKey): void;
+    mute(entry: CacheEntry, loadingDedupe?: boolean, timeDedupe?: boolean): boolean;
+    loading(key: CacheKey): number;
+    settled(key: CacheKey, data: unknown, error: string | null, rev?: number): void;
+}
+//# sourceMappingURL=CacheStorage.d.ts.map

package/dist/CacheStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheStorage.d.ts","sourceRoot":"","sources":["../src/CacheStorage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,KAAK,EACV,QAAQ,EACR,aAAa,EACb,QAAQ,EACR,UAAU,EACX,MAAM,yBAAyB,CAAA;AAQhC,cAAc,yBAAyB,CAAA;AAEvC,eAAO,MAAM,mBAAmB,OAAQ,CAAA;AACxC,eAAO,MAAM,kBAAkB,QAAW,CAAA;AAC1C,eAAO,MAAM,SAAS,QAAW,CAAA;AAUjC,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,UAElC;AAGD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,WAEpC;AAID,qBAAa,YAAY;IACvB,UAAU,SAAsB;IAChC,SAAS,SAAqB;IAC9B,KAAK,EAAE,QAAQ,CAAY;IAE3B,OAAO;;;;;;;;IAWP,IAAI,CAAC,GAAG,EAAE,QAAQ;IAYlB,GAAG,CACD,GAAG,EAAE,aAAa,GAAG,QAAQ,EAC7B,KAAK,EAAE,QAAQ,CAAC,UAAU,GAAG,SAAS,CAAC;IAKzC;;;;OAIG;IACH,UAAU,CAAC,GAAG,EAAE,aAAa,GAAG,QAAQ;IAIxC;;;;OAIG;IACH,UAAU,CAAC,GAAG,EAAE,aAAa,GAAG,QAAQ;IAUxC,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,aAAa,UAAO,EAAE,UAAU,UAAO;IAQ/D,OAAO,CAAC,GAAG,EAAE,QAAQ;IAcrB,OAAO,CACL,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,GAAG,CAAC,EAAE,MAAM;CAiBf"}

package/dist/CacheStorage.types.d.ts

@@ -0,0 +1,19 @@
+import type { ShardedSignalsMap, ShardKey, ShardedKey } from './map.js';
+export interface CacheEntry<T = unknown> {
+    rev: number;
+    dedupes: number;
+    expires: number;
+    data: T | null;
+    error: string | null;
+    loading: boolean;
+}
+export type CacheMap = ShardedSignalsMap<string, string, CacheEntry>;
+export interface CacheShardKey<P extends unknown[] = unknown[], R = unknown> extends ShardKey<string> {
+    P: P;
+    R: R;
+}
+export interface CacheKey<P extends unknown[] = unknown[], R = unknown> extends ShardedKey<string, string> {
+    P: P;
+    R: R;
+}
+//# sourceMappingURL=CacheStorage.types.d.ts.map

package/dist/CacheStorage.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheStorage.types.d.ts","sourceRoot":"","sources":["../src/CacheStorage.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,QAAQ,EACR,UAAU,EACX,MAAM,UAAU,CAAA;AAEjB,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,OAAO;IACrC,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,CAAC,GAAG,IAAI,CAAA;IACd,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,CAAA;AAEpE,MAAM,WAAW,aAAa,CAC5B,CAAC,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE,EAC/B,CAAC,GAAG,OAAO,CACX,SAAQ,QAAQ,CAAC,MAAM,CAAC;IAExB,CAAC,EAAE,CAAC,CAAA;IACJ,CAAC,EAAE,CAAC,CAAA;CACL;AAED,MAAM,WAAW,QAAQ,CACvB,CAAC,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE,EAC/B,CAAC,GAAG,OAAO,CACX,SAAQ,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC;IAElC,CAAC,EAAE,CAAC,CAAA;IACJ,CAAC,EAAE,CAAC,CAAA;CACL"}

package/dist/ClientContext.d.ts

@@ -0,0 +1,80 @@
+import { type ReadableSignal, type TasksRunner, type Task } from '@nano_kit/store';
+import type { ClientSetting } from './client.types.js';
+import type { RequestContext } from './RequestContext.js';
+import { type CacheKey, type CacheEntry, CacheStorage } from './CacheStorage.js';
+export type OnEveryError = (error: unknown, stopped: boolean) => void;
+export declare class ClientContext<T = unknown> extends CacheStorage {
+    $key?: ReadableSignal<CacheKey>;
+    $disabled?: ReadableSignal<boolean>;
+    loadingDedupe: boolean;
+    timeDedupe: boolean;
+    onEveryError: OnEveryError | undefined;
+    task<T>(task: Task<T>): Promise<T>;
+    mapData(data: T): T;
+    mapComputedData(data: T | null): T | null;
+    mapError(error: unknown): string;
+    mounted(): void;
+    mute(entry: CacheEntry): boolean;
+    run(requestCtx: RequestContext<T>, start: () => Promise<T>, onSettled: (data: T | null, error: string | null) => void, interrupt?: (error: unknown) => boolean): Promise<readonly [T | undefined, unknown] | undefined>;
+    handleError(error: unknown, stopped: boolean): void;
+}
+export interface QueryClientContext<T = unknown> extends ClientContext<T> {
+    $key: ReadableSignal<CacheKey>;
+    Q: true;
+}
+export interface MutationClientContext<T = unknown> extends ClientContext<T> {
+    $key: never;
+    M: true;
+}
+export declare function forkMutationClient<T>(ctx: ClientContext, settings?: ClientSetting<MutationClientContext<T>>[]): MutationClientContext<T>;
+export declare function forkQueryClient<T>(ctx: ClientContext, $key: ReadableSignal<CacheKey>, settings?: ClientSetting<QueryClientContext<T>>[]): QueryClientContext<T>;
+/**
+ * Set dedupe time in which identical requests are deduped.
+ * @param time - Dedupe time in milliseconds.
+ * @returns The client setting function.
+ */
+export declare function dedupeTime(time: number): ClientSetting<QueryClientContext>;
+/**
+ * Set cache time for cached query results.
+ * @param time - Cache time in milliseconds.
+ * @returns The client setting function.
+ */
+export declare function cacheTime(time: number): ClientSetting<QueryClientContext>;
+/**
+ * Map error object to string.
+ * @param fn - Function to map error to string.
+ * @returns The client setting function.
+ */
+export declare function mapError(fn: (error: unknown) => string): ClientSetting;
+/**
+ * Register a callback to be called on every error.
+ * @param fn - The error callback.
+ * @returns The client setting function.
+ */
+export declare function onEveryError(fn: OnEveryError): ClientSetting;
+/**
+ * Disable requests when the signal is true.
+ * @param $disabled - Readable signal indicating whether requests are disabled.
+ * @returns The client setting function.
+ */
+export declare function disabled($disabled: ReadableSignal<boolean>): ClientSetting;
+/**
+ * Enable or disable deduplication of requests (by loading state and dedupe time).
+ * @param enabled - Whether deduplication is enabled.
+ * @returns The client setting function.
+ */
+export declare function dedupe(dedupe: boolean): ClientSetting;
+/**
+ * Enable or disable deduplication of requests (by loading state and dedupe time).
+ * @param loading - Whether loading state deduplication is enabled.
+ * @param time - Whether time-based deduplication is enabled.
+ * @returns The client setting function.
+ */
+export declare function dedupe(loading: boolean, time: boolean): ClientSetting<QueryClientContext>;
+/**
+ * Set task runner for handling tasks.
+ * @param runner - The tasks runner function.
+ * @returns The client setting function.
+ */
+export declare function tasks(runner: TasksRunner): ClientSetting;
+//# sourceMappingURL=ClientContext.d.ts.map

package/dist/ClientContext.d.ts.map

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

package/dist/RequestContext.d.ts

@@ -0,0 +1,44 @@
+import type { CacheKey } from './CacheStorage.types.js';
+export type OnSuccess<T> = (data: T) => void;
+export type OnError = (error: unknown) => void;
+export type OnSettled<T> = (data: T | undefined, error: unknown) => void;
+export declare class RequestContext<T> {
+    onSuccess: OnSuccess<T> | undefined;
+    onError: OnError | undefined;
+    onSettled: OnSettled<T> | undefined;
+    stopErrorPropagation: boolean;
+    prevCtx: RequestContext<T> | undefined;
+    constructor(prevCtx?: RequestContext<T>);
+    settled(data: T | undefined, error: unknown): void;
+}
+export declare class QueryContext<P extends unknown[], R> extends RequestContext<R> implements CacheKey<P, R> {
+    shard: string;
+    key: string;
+    P: P;
+    R: R;
+    constructor(key: CacheKey<P, R>, prevCtx?: QueryContext<P, R>);
+}
+/**
+ * Add a success callback to the query context.
+ * @param ctx - The query context.
+ * @param fn - The success callback.
+ */
+export declare function onSuccess<T>(ctx: RequestContext<T>, fn: OnSuccess<T>): void;
+/**
+ * Add an error callback to the query context.
+ * @param ctx - The query context.
+ * @param fn - The error callback.
+ */
+export declare function onError<T>(ctx: RequestContext<T>, fn: OnError): void;
+/**
+ * Add a settled callback to the query context.
+ * @param ctx - The query context.
+ * @param fn - The settled callback.
+ */
+export declare function onSettled<T>(ctx: RequestContext<T>, fn: OnSettled<T>): void;
+/**
+ * Mark error as "stopped", so error will be passed to onEveryError with stopped=true.
+ * @param ctx - The query context.
+ */
+export declare function stopErrorPropagation<T>(ctx: RequestContext<T>): void;
+//# sourceMappingURL=RequestContext.d.ts.map

package/dist/RequestContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestContext.d.ts","sourceRoot":"","sources":["../src/RequestContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAGvD,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAA;AAE5C,MAAM,MAAM,OAAO,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;AAE9C,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,SAAS,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;AAExE,qBAAa,cAAc,CAAC,CAAC;IAC3B,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,CAAY;IAC/C,OAAO,EAAE,OAAO,GAAG,SAAS,CAAY;IACxC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,CAAY;IAC/C,oBAAoB,UAAQ;IAC5B,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,SAAS,CAAY;gBAEtC,OAAO,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC;IAMvC,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,SAAS,EAAE,KAAK,EAAE,OAAO;CAS5C;AAED,qBAAa,YAAY,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,CAAC,CAC9C,SAAQ,cAAc,CAAC,CAAC,CACxB,YAAW,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,CAAC,EAAG,CAAC,CAAA;IACL,CAAC,EAAG,CAAC,CAAA;gBAGH,GAAG,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,EACnB,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC;CAO/B;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,QAEpE;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,QAE7D;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,QAEpE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC,QAE7D"}

package/dist/cache.d.ts

@@ -0,0 +1,36 @@
+import type { CacheKeyBuilder, CacheDataFacade, CacheKey, ExtrasCacheKeyBuilder } from './cache.types.js';
+import type { CacheStorage } from './CacheStorage.js';
+export * from './cache.types.js';
+/**
+ * Create a query cache key builder.
+ * @param name - The cache shard name.
+ * @param filter - Optional filter to process parameters before building the key.
+ * @returns The cache key builder.
+ */
+export declare function queryKey<P extends unknown[], R>(name: string, filter?: (params: Partial<P>) => unknown[]): CacheKeyBuilder<P, R>;
+/**
+ * Create an operation cache key builder with extra parameters.
+ * @param name - The cache shard name.
+ * @param filter - Optional filter to process parameters before building the key.
+ * @returns The extras cache key builder.
+ */
+export declare function operationKey<P extends unknown[], E extends unknown[], R>(name: string, filter?: (params: Partial<P>) => unknown[]): ExtrasCacheKeyBuilder<P, E, R>;
+/**
+ * Create cache getter/setter for data.
+ * @param cache - The cache map.
+ * @returns The data getter/setter.
+ */
+export declare function dataCacheFacade(cache: CacheStorage): CacheDataFacade;
+/**
+ * Create cache getter for loading state.
+ * @param cache - The cache map.
+ * @returns The loading state getter.
+ */
+export declare function loadingCacheFacade(cache: CacheStorage): (key: CacheKey) => boolean;
+/**
+ * Create cache getter for error state.
+ * @param cache - The cache map.
+ * @returns The error state getter.
+ */
+export declare function errorCacheFacade(cache: CacheStorage): (key: CacheKey) => string | null;
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,QAAQ,EACR,qBAAqB,EACtB,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD,cAAc,kBAAkB,CAAA;AAEhC;;;;;GAKG;AAEH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,CAAC,EAC7C,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,EAAqB,yBAW7D;AAED;;;;;GAKG;AAEH,wBAAgB,YAAY,CAC1B,CAAC,SAAS,OAAO,EAAE,EACnB,CAAC,SAAS,OAAO,EAAE,EACnB,CAAC,EAED,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,GAEH,qBAAqB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CACtE;AAED;;;;GAIG;AAEH,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GACL,eAAe,CAC5D;AAqBD;;;;GAIG;AAEH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,IAC5C,KAAK,QAAQ,aACtB;AAED;;;;GAIG;AAEH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,IAC1C,KAAK,QAAQ,mBACtB"}

package/dist/cache.types.d.ts

@@ -0,0 +1,13 @@
+import type { NewValue } from '@nano_kit/store';
+import type { CacheKey, CacheShardKey } from './CacheStorage.types.js';
+export type { CacheKey, CacheShardKey };
+export interface ExtrasCacheKey<P extends unknown[] = unknown[], E extends unknown[] = unknown[], R = unknown> extends CacheKey<P, R> {
+    E: E;
+}
+export type CacheKeyBuilder<P extends unknown[], R> = ((...params: Partial<P>) => CacheKey<P, R>) & CacheShardKey<P, R>;
+export type ExtrasCacheKeyBuilder<P extends unknown[], E extends unknown[], R> = ((...params: Partial<P>) => ExtrasCacheKey<P, E, R>) & CacheShardKey<P, R>;
+export interface CacheDataFacade {
+    <P extends unknown[], R>(key: CacheKey<P, R>): R | null;
+    <P extends unknown[], R>(key: CacheShardKey<P, R> | CacheKey<P, R>, value: NewValue<R | null>): void;
+}
+//# sourceMappingURL=cache.types.d.ts.map

package/dist/cache.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.types.d.ts","sourceRoot":"","sources":["../src/cache.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,KAAK,EACV,QAAQ,EACR,aAAa,EACd,MAAM,yBAAyB,CAAA;AAEhC,YAAY,EACV,QAAQ,EACR,aAAa,EACd,CAAA;AAED,MAAM,WAAW,cAAc,CAC7B,CAAC,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE,EAC/B,CAAC,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE,EAC/B,CAAC,GAAG,OAAO,CACX,SAAQ,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;IAEtB,CAAC,EAAE,CAAC,CAAA;CACL;AAED,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,CAAC,IAAI,CACpD,CAAC,GAAG,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAC1C,GAAG,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AAEvB,MAAM,MAAM,qBAAqB,CAC/B,CAAC,SAAS,OAAO,EAAE,EACnB,CAAC,SAAS,OAAO,EAAE,EACnB,CAAC,IACC,CACF,CAAC,GAAG,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CACnD,GAAG,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AAEvB,MAAM,WAAW,eAAe;IAC9B,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAAA;IACvD,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAA;CACrG"}

package/dist/client.d.ts

@@ -0,0 +1,41 @@
+import type { ClientExtension, ExtendedClient, AnyClientSetting, AnyClientExtension } from './client.types.js';
+import { query, infinite, operation, mutation } from './queries/index.js';
+export * from './client.types.js';
+/**
+ * Create a query client with optional settings and extensions.
+ * @param settings - The client settings and extensions.
+ * @returns The query client.
+ */
+export declare function client<S extends (AnyClientSetting | AnyClientExtension)[]>(...settings: S): ExtendedClient<{
+    query: typeof query;
+    invalidate: (key: import("./CacheStorage.types.js").CacheShardKey | import("./CacheStorage.types.js").CacheKey) => void;
+    revalidate: (key: import("./CacheStorage.types.js").CacheShardKey | import("./CacheStorage.types.js").CacheKey) => void;
+    $data: import("./cache.types.js").CacheDataFacade;
+    $error: (key: import("./CacheStorage.types.js").CacheKey) => string | null;
+    $loading: (key: import("./CacheStorage.types.js").CacheKey) => boolean;
+}, S>;
+interface InfinitesExtension {
+    infinite: typeof infinite;
+}
+/**
+ * Extend client with infinite query capability.
+ * @returns The client extension.
+ */
+export declare function infinites(): ClientExtension<InfinitesExtension>;
+interface OperationsExtension {
+    operation: typeof operation;
+}
+/**
+ * Extend client with operation capability.
+ * @returns The client extension.
+ */
+export declare function operations(): ClientExtension<OperationsExtension>;
+interface MutationsExtension {
+    mutation: typeof mutation;
+}
+/**
+ * Extend client with mutation capability.
+ * @returns The client extension.
+ */
+export declare function mutations(): ClientExtension<MutationsExtension>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,mBAAmB,CAAA;AAW1B,OAAO,EACL,KAAK,EACL,QAAQ,EACR,SAAS,EACT,QAAQ,EACT,MAAM,oBAAoB,CAAA;AAE3B,cAAc,mBAAmB,CAAA;AAEjC;;;;GAIG;AAEH,wBAAgB,MAAM,CAAC,CAAC,SAAS,CAAC,gBAAgB,GAAG,kBAAkB,CAAC,EAAE,EAAE,GAAG,QAAQ,EAAE,CAAC,GAgBvE,cAAc;WAZH,OAAO,KAAK;;;;;;GAYO,CAAC,CAAC,CAClD;AAED,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,OAAO,QAAQ,CAAA;CAC1B;AAED;;;GAGG;AAEH,wBAAgB,SAAS,IAKjB,eAAe,CAAC,kBAAkB,CAAC,CAC1C;AAED,UAAU,mBAAmB;IAC3B,SAAS,EAAE,OAAO,SAAS,CAAA;CAC5B;AAED;;;GAGG;AAEH,wBAAgB,UAAU,IAKlB,eAAe,CAAC,mBAAmB,CAAC,CAC3C;AAED,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,OAAO,QAAQ,CAAA;CAC1B;AAED;;;GAGG;AAEH,wBAAgB,SAAS,IAKjB,eAAe,CAAC,kBAAkB,CAAC,CAC1C"}

package/dist/client.mock.d.ts

@@ -0,0 +1,24 @@
+export interface Post {
+    id: number;
+    title: string;
+    content: string;
+}
+export interface PostsPage {
+    posts: Post[];
+    nextCursor: number | null;
+}
+export interface CreatePostParams {
+    title: string;
+    content: string;
+}
+export interface UpdatePostParams {
+    title?: string;
+    content?: string;
+}
+export declare function resetMockData(): void;
+export declare function getPost(id: number): Promise<Post | null>;
+export declare function getPosts(cursor?: number | null): Promise<PostsPage>;
+export declare function createPost(params: CreatePostParams): Promise<Post>;
+export declare function updatePost(id: number, params: UpdatePostParams): Promise<Post | null>;
+export declare function deletePost(id: number): Promise<boolean>;
+//# sourceMappingURL=client.mock.d.ts.map

package/dist/client.mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.mock.d.ts","sourceRoot":"","sources":["../src/client.mock.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,IAAI,EAAE,CAAA;IACb,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AASD,wBAAgB,aAAa,SAmB5B;AAED,wBAAsB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAI9D;AAED,wBAAsB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC,CAYzE;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAUxE;AAED,wBAAsB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAa3F;AAED,wBAAsB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAU7D"}

package/dist/client.types.d.ts

@@ -0,0 +1,12 @@
+import type { ClientContext, QueryClientContext, MutationClientContext } from './ClientContext.js';
+export type ClientSetting<T extends QueryClientContext | MutationClientContext = QueryClientContext | MutationClientContext> = (ctx: T) => void;
+export type AnyClientSetting = ClientSetting<QueryClientContext> | ClientSetting<MutationClientContext> | ClientSetting;
+export type ClientExtension<E> = <T>(ctx: ClientContext, client: T) => T & E;
+export type AnyClientExtension = ClientExtension<{}>;
+type Extension<S extends (AnyClientSetting | AnyClientExtension)[]> = S extends [infer First, ...infer Rest] ? First extends ClientExtension<infer E> ? Rest extends (AnyClientSetting | AnyClientExtension)[] ? Extension<Rest> & E : E : Rest extends (AnyClientSetting | AnyClientExtension)[] ? Extension<Rest> : {} : {};
+type Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+export type ExtendedClient<T, S extends (AnyClientSetting | AnyClientExtension)[]> = Prettify<T & Extension<S>>;
+export {};
+//# sourceMappingURL=client.types.d.ts.map

package/dist/client.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.types.d.ts","sourceRoot":"","sources":["../src/client.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,oBAAoB,CAAA;AAE3B,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,kBAAkB,GAAG,qBAAqB,GAAG,kBAAkB,GAAG,qBAAqB,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,CAAA;AAE/I,MAAM,MAAM,gBAAgB,GAAG,aAAa,CAAC,kBAAkB,CAAC,GAAG,aAAa,CAAC,qBAAqB,CAAC,GAAG,aAAa,CAAA;AAEvH,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;AAE5E,MAAM,MAAM,kBAAkB,GAAG,eAAe,CAAC,EAAE,CAAC,CAAA;AAEpD,KAAK,SAAS,CAAC,CAAC,SAAS,CAAC,gBAAgB,GAAG,kBAAkB,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,GACxG,KAAK,SAAS,eAAe,CAAC,MAAM,CAAC,CAAC,GACpC,IAAI,SAAS,CAAC,gBAAgB,GAAG,kBAAkB,CAAC,EAAE,GACpD,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,GACnB,CAAC,GACH,IAAI,SAAS,CAAC,gBAAgB,GAAG,kBAAkB,CAAC,EAAE,GACpD,SAAS,CAAC,IAAI,CAAC,GACf,EAAE,GACN,EAAE,CAAA;AAEN,KAAK,QAAQ,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG,EAAE,CAAA;AAEhD,MAAM,MAAM,cAAc,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,gBAAgB,GAAG,kBAAkB,CAAC,EAAE,IAAI,QAAQ,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from './settings/index.js';
+export { queryKey, operationKey } from './cache.js';
+export { DEFAULT_DEDUPE_TIME, DEFAULT_CACHE_TIME } from './CacheStorage.js';
+export { ClientContext, type QueryClientContext, type MutationClientContext, dedupeTime, cacheTime, mapError, onEveryError, disabled, dedupe, tasks } from './ClientContext.js';
+export * from './RequestContext.js';
+export * from './client.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,OAAO,EACL,QAAQ,EACR,YAAY,EACb,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACL,aAAa,EACb,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,UAAU,EACV,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,QAAQ,EACR,MAAM,EACN,KAAK,EACN,MAAM,oBAAoB,CAAA;AAC3B,cAAc,qBAAqB,CAAA;AACnC,cAAc,aAAa,CAAA"}