@tanstack/lit-query 0.0.1 → 0.2.0

package/dist/controllers/BaseController.d.ts

@@ -0,0 +1,38 @@
+import type { QueryClient } from '@tanstack/query-core';
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+export declare abstract class BaseController<TResult> implements ReactiveController {
+    protected readonly host: ReactiveControllerHost;
+    protected result: TResult;
+    private readonly explicitClient?;
+    private contextClient;
+    private contextUnsubscribe;
+    private connected;
+    private destroyed;
+    private updateQueued;
+    private clientChangeQueued;
+    private connectionAttempt;
+    private queryClientResolutionState;
+    protected constructor(host: ReactiveControllerHost, initialResult: TResult, queryClient?: QueryClient);
+    hostConnected(): void;
+    hostDisconnected(): void;
+    hostUpdate(): void;
+    destroy(): void;
+    protected tryGetQueryClient(): QueryClient | undefined;
+    protected getQueryClient(): QueryClient;
+    protected setResult(next: TResult): void;
+    get current(): TResult;
+    protected get connectedState(): boolean;
+    protected queueUpdate(): void;
+    private queueQueryClientChanged;
+    private beginContextResolution;
+    private queueContextResolution;
+    private dispatchContextRequest;
+    private queueInitialContextResolutionCompletion;
+    private clearContextClient;
+    private updateQueryClientResolutionState;
+    protected abstract onConnected(): void;
+    protected abstract onDisconnected(): void;
+    protected abstract onHostUpdate(): void;
+    protected abstract onQueryClientChanged(): void;
+}
+//# sourceMappingURL=BaseController.d.ts.map

package/dist/controllers/BaseController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseController.d.ts","sourceRoot":"","sources":["../../src/controllers/BaseController.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,KAAK,CAAA;AAYrE,8BAAsB,cAAc,CAAC,OAAO,CAAE,YAAW,kBAAkB;IAevE,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,sBAAsB;IAdjD,SAAS,CAAC,MAAM,EAAE,OAAO,CAAA;IAEzB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAa;IAC7C,OAAO,CAAC,aAAa,CAAyB;IAC9C,OAAO,CAAC,kBAAkB,CAA0B;IAEpD,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,kBAAkB,CAAQ;IAClC,OAAO,CAAC,iBAAiB,CAAI;IAC7B,OAAO,CAAC,0BAA0B,CAA4B;IAE9D,SAAS,aACY,IAAI,EAAE,sBAAsB,EAC/C,aAAa,EAAE,OAAO,EACtB,WAAW,CAAC,EAAE,WAAW;IAS3B,aAAa,IAAI,IAAI;IAiCrB,gBAAgB,IAAI,IAAI;IAgBxB,UAAU,IAAI,IAAI;IAQlB,OAAO,IAAI,IAAI;IAmBf,SAAS,CAAC,iBAAiB,IAAI,WAAW,GAAG,SAAS;IAItD,SAAS,CAAC,cAAc,IAAI,WAAW;IASvC,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IASxC,IAAI,OAAO,IAAI,OAAO,CAMrB;IAED,SAAS,KAAK,cAAc,IAAI,OAAO,CAEtC;IAED,SAAS,CAAC,WAAW,IAAI,IAAI;IAc7B,OAAO,CAAC,uBAAuB;IAc/B,OAAO,CAAC,sBAAsB;IAK9B,OAAO,CAAC,sBAAsB;IAgB9B,OAAO,CAAC,sBAAsB;IA6C9B,OAAO,CAAC,uCAAuC;IAkB/C,OAAO,CAAC,kBAAkB;IAM1B,OAAO,CAAC,gCAAgC;IAWxC,SAAS,CAAC,QAAQ,CAAC,WAAW,IAAI,IAAI;IACtC,SAAS,CAAC,QAAQ,CAAC,cAAc,IAAI,IAAI;IACzC,SAAS,CAAC,QAAQ,CAAC,YAAY,IAAI,IAAI;IACvC,SAAS,CAAC,QAAQ,CAAC,oBAAoB,IAAI,IAAI;CAChD"}

package/dist/controllers/BaseController.js

@@ -0,0 +1,204 @@
+import { ContextEvent } from '@lit/context';
+import { createMissingQueryClientError, queryClientContext, } from '../context.js';
+export class BaseController {
+    host;
+    result;
+    explicitClient;
+    contextClient;
+    contextUnsubscribe;
+    connected = false;
+    destroyed = false;
+    updateQueued = false;
+    clientChangeQueued = false;
+    connectionAttempt = 0;
+    queryClientResolutionState;
+    constructor(host, initialResult, queryClient) {
+        this.host = host;
+        this.explicitClient = queryClient;
+        this.result = initialResult;
+        this.queryClientResolutionState = queryClient ? 'bound' : 'pre-connect';
+        host.addController(this);
+    }
+    hostConnected() {
+        if (this.connected || this.destroyed) {
+            return;
+        }
+        this.connected = true;
+        let contextResolutionAttempt;
+        if (this.explicitClient) {
+            this.queryClientResolutionState = 'bound';
+        }
+        else {
+            contextResolutionAttempt = ++this.connectionAttempt;
+            this.beginContextResolution();
+        }
+        // Defer onConnected to ensure subclass constructors complete before
+        // lifecycle callbacks access subclass state. This handles the case where
+        // addController is called on an already-connected host (e.g., during
+        // willUpdate), which synchronously triggers hostConnected before
+        // subclass field initialization.
+        queueMicrotask(() => {
+            if (this.connected && !this.destroyed) {
+                this.onConnected();
+            }
+        });
+        if (contextResolutionAttempt !== undefined) {
+            // Provider-backed controllers on already-connected hosts should finish
+            // their deferred onConnected pass before a context client binds.
+            this.queueContextResolution(contextResolutionAttempt);
+        }
+    }
+    hostDisconnected() {
+        if (!this.connected) {
+            return;
+        }
+        this.connected = false;
+        if (!this.explicitClient) {
+            this.connectionAttempt += 1;
+            this.clearContextClient();
+            this.updateQueryClientResolutionState('pre-connect');
+        }
+        this.onDisconnected();
+    }
+    hostUpdate() {
+        if (this.destroyed) {
+            return;
+        }
+        this.onHostUpdate();
+    }
+    destroy() {
+        if (this.destroyed) {
+            return;
+        }
+        this.destroyed = true;
+        this.connected = false;
+        this.connectionAttempt += 1;
+        this.clearContextClient();
+        this.queryClientResolutionState = this.explicitClient
+            ? 'bound'
+            : 'pre-connect';
+        this.onDisconnected();
+        if ('removeController' in this.host) {
+            this.host.removeController(this);
+        }
+    }
+    tryGetQueryClient() {
+        return this.explicitClient ?? this.contextClient;
+    }
+    getQueryClient() {
+        const client = this.tryGetQueryClient();
+        if (!client) {
+            throw createMissingQueryClientError();
+        }
+        return client;
+    }
+    setResult(next) {
+        if (Object.is(this.result, next)) {
+            return;
+        }
+        this.result = next;
+        this.queueUpdate();
+    }
+    get current() {
+        if (this.queryClientResolutionState === 'missing') {
+            throw createMissingQueryClientError();
+        }
+        return this.result;
+    }
+    get connectedState() {
+        return this.connected;
+    }
+    queueUpdate() {
+        if (this.updateQueued) {
+            return;
+        }
+        this.updateQueued = true;
+        queueMicrotask(() => {
+            this.updateQueued = false;
+            if (!this.destroyed) {
+                this.host.requestUpdate();
+            }
+        });
+    }
+    queueQueryClientChanged() {
+        if (this.clientChangeQueued) {
+            return;
+        }
+        this.clientChangeQueued = true;
+        queueMicrotask(() => {
+            this.clientChangeQueued = false;
+            if (!this.destroyed) {
+                this.onQueryClientChanged();
+            }
+        });
+    }
+    beginContextResolution() {
+        this.clearContextClient();
+        this.updateQueryClientResolutionState('awaiting-context');
+    }
+    queueContextResolution(attempt) {
+        queueMicrotask(() => {
+            if (this.destroyed ||
+                !this.connected ||
+                attempt !== this.connectionAttempt ||
+                this.queryClientResolutionState !== 'awaiting-context') {
+                return;
+            }
+            this.dispatchContextRequest(attempt);
+            this.queueInitialContextResolutionCompletion(attempt);
+        });
+    }
+    dispatchContextRequest(attempt) {
+        if (!('dispatchEvent' in this.host)) {
+            return;
+        }
+        const contextTarget = this.host;
+        contextTarget.dispatchEvent(new ContextEvent(queryClientContext, contextTarget, (value, unsubscribe) => {
+            if (this.destroyed ||
+                !this.connected ||
+                attempt !== this.connectionAttempt) {
+                unsubscribe?.();
+                return;
+            }
+            if (this.contextUnsubscribe &&
+                this.contextUnsubscribe !== unsubscribe) {
+                this.contextUnsubscribe();
+            }
+            const resolutionChanged = this.updateQueryClientResolutionState(value === undefined ? 'missing' : 'bound');
+            const clientChanged = this.contextClient !== value;
+            this.contextClient = value;
+            this.contextUnsubscribe = unsubscribe;
+            if (resolutionChanged || clientChanged) {
+                this.queueUpdate();
+                this.queueQueryClientChanged();
+            }
+        }, true));
+    }
+    queueInitialContextResolutionCompletion(attempt) {
+        queueMicrotask(() => {
+            if (this.destroyed ||
+                !this.connected ||
+                attempt !== this.connectionAttempt ||
+                this.queryClientResolutionState !== 'awaiting-context') {
+                return;
+            }
+            if (this.updateQueryClientResolutionState('missing')) {
+                this.queueUpdate();
+                this.queueQueryClientChanged();
+            }
+        });
+    }
+    clearContextClient() {
+        this.contextUnsubscribe?.();
+        this.contextUnsubscribe = undefined;
+        this.contextClient = undefined;
+    }
+    updateQueryClientResolutionState(nextState) {
+        if (this.queryClientResolutionState === nextState) {
+            return false;
+        }
+        this.queryClientResolutionState = nextState;
+        return true;
+    }
+}
+//# sourceMappingURL=BaseController.js.map

package/dist/controllers/BaseController.js.map

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

package/dist/createInfiniteQueryController.d.ts

@@ -0,0 +1,76 @@
+import { type DefaultError, type InfiniteData, type InfiniteQueryObserverOptions, type InfiniteQueryObserverResult, type QueryKey } from '@tanstack/query-core';
+import type { QueryClient } from '@tanstack/query-core';
+import type { ReactiveControllerHost } from 'lit';
+import { type Accessor, type ValueAccessor } from './accessor.js';
+/**
+ * Options accepted by `createInfiniteQueryController`.
+ *
+ * This is the Lit adapter shape for `InfiniteQueryObserverOptions`. Pass it
+ * directly or through an `Accessor` when the options depend on Lit host state.
+ */
+export type CreateInfiniteQueryOptions<TQueryFnData = unknown, TError = DefaultError, TData = InfiniteData<TQueryFnData>, TQueryKey extends QueryKey = QueryKey, TPageParam = unknown> = InfiniteQueryObserverOptions<TQueryFnData, TError, TData, TQueryKey, TPageParam>;
+/**
+ * Accessor returned by `createInfiniteQueryController`.
+ *
+ * Call the accessor or read its `current` property to get the latest infinite
+ * query result. The attached methods delegate to the active infinite query
+ * observer.
+ */
+export type InfiniteQueryResultAccessor<TData, TError> = ValueAccessor<InfiniteQueryObserverResult<TData, TError>> & {
+    /** Refetches the current infinite query. */
+    refetch: InfiniteQueryObserverResult<TData, TError>['refetch'];
+    /** Fetches the next page for the current infinite query. */
+    fetchNextPage: InfiniteQueryObserverResult<TData, TError>['fetchNextPage'];
+    /** Fetches the previous page for the current infinite query. */
+    fetchPreviousPage: InfiniteQueryObserverResult<TData, TError>['fetchPreviousPage'];
+    /** Removes the controller from its Lit host and unsubscribes observers. */
+    destroy: () => void;
+};
+/**
+ * Creates a Lit reactive controller that subscribes the host to an infinite
+ * query.
+ *
+ * The returned accessor is callable and also exposes `current`, `refetch`,
+ * `fetchNextPage`, `fetchPreviousPage`, and `destroy`. When `options` is a
+ * function, it is re-read during host updates so query keys and options can
+ * follow reactive host state.
+ *
+ * If `queryClient` is omitted, the controller resolves the client from the
+ * nearest connected `QueryClientProvider`.
+ *
+ * @param host - The Lit reactive controller host that owns the infinite query
+ * subscription.
+ * @param options - Infinite query observer options, or a getter that returns
+ * options.
+ * @param queryClient - Optional explicit query client. Provide this for
+ * controllers that should not resolve a client from Lit context.
+ * @returns An accessor for the latest infinite query result with page helper
+ * methods.
+ *
+ * @example
+ * ```ts
+ * import { LitElement, html } from 'lit'
+ * import { createInfiniteQueryController } from '@tanstack/lit-query'
+ *
+ * class ProjectsView extends LitElement {
+ *   private readonly projects = createInfiniteQueryController(this, {
+ *     queryKey: ['projects'],
+ *     queryFn: ({ pageParam }) => fetchProjects(pageParam),
+ *     initialPageParam: 0,
+ *     getNextPageParam: (lastPage) => lastPage.nextCursor,
+ *   })
+ *
+ *   render() {
+ *     const query = this.projects()
+ *
+ *     return html`
+ *       <button ?disabled=${!query.hasNextPage} @click=${() => this.projects.fetchNextPage()}>
+ *         Load more
+ *       </button>
+ *     `
+ *   }
+ * }
+ * ```
+ */
+export declare function createInfiniteQueryController<TQueryFnData = unknown, TError = DefaultError, TData = InfiniteData<TQueryFnData>, TQueryKey extends QueryKey = QueryKey, TPageParam = unknown>(host: ReactiveControllerHost, options: Accessor<CreateInfiniteQueryOptions<TQueryFnData, TError, TData, TQueryKey, TPageParam>>, queryClient?: QueryClient): InfiniteQueryResultAccessor<TData, TError>;
+//# sourceMappingURL=createInfiniteQueryController.d.ts.map

package/dist/createInfiniteQueryController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createInfiniteQueryController.d.ts","sourceRoot":"","sources":["../src/createInfiniteQueryController.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,YAAY,EAEjB,KAAK,YAAY,EACjB,KAAK,4BAA4B,EACjC,KAAK,2BAA2B,EAChC,KAAK,QAAQ,EACd,MAAM,sBAAsB,CAAA;AAC7B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,KAAK,CAAA;AACjD,OAAO,EAGL,KAAK,QAAQ,EACb,KAAK,aAAa,EACnB,MAAM,eAAe,CAAA;AAItB;;;;;GAKG;AACH,MAAM,MAAM,0BAA0B,CACpC,YAAY,GAAG,OAAO,EACtB,MAAM,GAAG,YAAY,EACrB,KAAK,GAAG,YAAY,CAAC,YAAY,CAAC,EAClC,SAAS,SAAS,QAAQ,GAAG,QAAQ,EACrC,UAAU,GAAG,OAAO,IAClB,4BAA4B,CAC9B,YAAY,EACZ,MAAM,EACN,KAAK,EACL,SAAS,EACT,UAAU,CACX,CAAA;AAED;;;;;;GAMG;AACH,MAAM,MAAM,2BAA2B,CAAC,KAAK,EAAE,MAAM,IAAI,aAAa,CACpE,2BAA2B,CAAC,KAAK,EAAE,MAAM,CAAC,CAC3C,GAAG;IACF,4CAA4C;IAC5C,OAAO,EAAE,2BAA2B,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,SAAS,CAAC,CAAA;IAC9D,4DAA4D;IAC5D,aAAa,EAAE,2BAA2B,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,eAAe,CAAC,CAAA;IAC1E,gEAAgE;IAChE,iBAAiB,EAAE,2BAA2B,CAC5C,KAAK,EACL,MAAM,CACP,CAAC,mBAAmB,CAAC,CAAA;IACtB,2EAA2E;IAC3E,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB,CAAA;AAgQD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,wBAAgB,6BAA6B,CAC3C,YAAY,GAAG,OAAO,EACtB,MAAM,GAAG,YAAY,EACrB,KAAK,GAAG,YAAY,CAAC,YAAY,CAAC,EAClC,SAAS,SAAS,QAAQ,GAAG,QAAQ,EACrC,UAAU,GAAG,OAAO,EAEpB,IAAI,EAAE,sBAAsB,EAC5B,OAAO,EAAE,QAAQ,CACf,0BAA0B,CACxB,YAAY,EACZ,MAAM,EACN,KAAK,EACL,SAAS,EACT,UAAU,CACX,CACF,EACD,WAAW,CAAC,EAAE,WAAW,GACxB,2BAA2B,CAAC,KAAK,EAAE,MAAM,CAAC,CAY5C"}

package/dist/createInfiniteQueryController.js

@@ -0,0 +1,221 @@
+import { InfiniteQueryObserver, } from '@tanstack/query-core';
+import { createValueAccessor, readAccessor, } from './accessor.js';
+import { createMissingQueryClientError } from './context.js';
+import { BaseController } from './controllers/BaseController.js';
+function createPendingInfiniteQueryResult() {
+    return {
+        data: undefined,
+        dataUpdatedAt: 0,
+        error: null,
+        errorUpdatedAt: 0,
+        failureCount: 0,
+        failureReason: null,
+        errorUpdateCount: 0,
+        isError: false,
+        isFetched: false,
+        isFetchedAfterMount: false,
+        isFetching: false,
+        isInitialLoading: false,
+        isLoading: false,
+        isLoadingError: false,
+        isPaused: false,
+        isPending: true,
+        isPlaceholderData: false,
+        isRefetchError: false,
+        isRefetching: false,
+        isStale: true,
+        isEnabled: true,
+        isSuccess: false,
+        fetchStatus: 'idle',
+        status: 'pending',
+        refetch: (() => Promise.reject(createMissingQueryClientError())),
+        fetchNextPage: (() => Promise.reject(createMissingQueryClientError())),
+        fetchPreviousPage: (() => Promise.reject(createMissingQueryClientError())),
+        hasNextPage: false,
+        hasPreviousPage: false,
+        isFetchNextPageError: false,
+        isFetchingNextPage: false,
+        isFetchPreviousPageError: false,
+        isFetchingPreviousPage: false,
+        promise: Promise.resolve(undefined),
+    };
+}
+class InfiniteQueryController extends BaseController {
+    options;
+    observer;
+    unsubscribe;
+    queryClient;
+    constructor(host, options, queryClient) {
+        super(host, createPendingInfiniteQueryResult(), queryClient);
+        this.options = options;
+        if (!queryClient) {
+            return;
+        }
+        if (typeof options === 'function') {
+            return;
+        }
+        const defaulted = this.defaultOptions(queryClient);
+        const observer = new InfiniteQueryObserver(queryClient, defaulted);
+        this.queryClient = queryClient;
+        this.observer = observer;
+        this.result = observer.getOptimisticResult(defaulted);
+    }
+    onConnected() {
+        if (!this.syncClient()) {
+            return;
+        }
+        this.refreshOptions();
+        this.subscribe();
+        this.observer?.updateResult();
+        if (this.observer) {
+            this.setResult(this.observer.getCurrentResult());
+        }
+    }
+    onDisconnected() {
+        this.unsubscribeObserver();
+        this.syncClient();
+    }
+    onHostUpdate() {
+        if (typeof this.options !== 'function') {
+            return;
+        }
+        this.refreshOptions();
+    }
+    onQueryClientChanged() {
+        if (!this.syncClient() || !this.connectedState) {
+            return;
+        }
+        this.refreshOptions();
+        this.subscribe();
+        this.observer?.updateResult();
+        if (this.observer) {
+            this.setResult(this.observer.getCurrentResult());
+        }
+    }
+    refetch = (...args) => {
+        if (!this.refreshOptions()) {
+            return Promise.reject(createMissingQueryClientError());
+        }
+        return this.result.refetch(...args);
+    };
+    fetchNextPage = (...args) => {
+        if (!this.refreshOptions()) {
+            return Promise.reject(createMissingQueryClientError());
+        }
+        return this.result.fetchNextPage(...args);
+    };
+    fetchPreviousPage = (...args) => {
+        if (!this.refreshOptions()) {
+            return Promise.reject(createMissingQueryClientError());
+        }
+        return this.result.fetchPreviousPage(...args);
+    };
+    subscribe() {
+        if (!this.observer) {
+            return;
+        }
+        if (this.unsubscribe) {
+            return;
+        }
+        this.unsubscribe = this.observer.subscribe((next) => {
+            this.setResult(next);
+        });
+    }
+    unsubscribeObserver() {
+        this.unsubscribe?.();
+        this.unsubscribe = undefined;
+    }
+    syncClient() {
+        const nextClient = this.tryGetQueryClient();
+        if (!nextClient) {
+            this.unsubscribeObserver();
+            this.queryClient = undefined;
+            this.observer = undefined;
+            this.setResult(createPendingInfiniteQueryResult());
+            return false;
+        }
+        if (nextClient === this.queryClient) {
+            return true;
+        }
+        this.unsubscribeObserver();
+        this.queryClient = nextClient;
+        const options = this.defaultOptions(this.queryClient);
+        this.observer = new InfiniteQueryObserver(this.queryClient, options);
+        this.setResult(this.observer.getOptimisticResult(options));
+        return true;
+    }
+    refreshOptions() {
+        if (!this.syncClient() || !this.observer || !this.queryClient) {
+            return false;
+        }
+        const options = this.defaultOptions(this.queryClient);
+        this.observer.setOptions(options);
+        this.setResult(this.observer.getOptimisticResult(options));
+        return true;
+    }
+    defaultOptions(client = this.queryClient) {
+        if (!client) {
+            throw createMissingQueryClientError();
+        }
+        const defaulted = client.defaultQueryOptions(readAccessor(this.options));
+        defaulted._optimisticResults =
+            'optimistic';
+        return defaulted;
+    }
+}
+/**
+ * Creates a Lit reactive controller that subscribes the host to an infinite
+ * query.
+ *
+ * The returned accessor is callable and also exposes `current`, `refetch`,
+ * `fetchNextPage`, `fetchPreviousPage`, and `destroy`. When `options` is a
+ * function, it is re-read during host updates so query keys and options can
+ * follow reactive host state.
+ *
+ * If `queryClient` is omitted, the controller resolves the client from the
+ * nearest connected `QueryClientProvider`.
+ *
+ * @param host - The Lit reactive controller host that owns the infinite query
+ * subscription.
+ * @param options - Infinite query observer options, or a getter that returns
+ * options.
+ * @param queryClient - Optional explicit query client. Provide this for
+ * controllers that should not resolve a client from Lit context.
+ * @returns An accessor for the latest infinite query result with page helper
+ * methods.
+ *
+ * @example
+ * ```ts
+ * import { LitElement, html } from 'lit'
+ * import { createInfiniteQueryController } from '@tanstack/lit-query'
+ *
+ * class ProjectsView extends LitElement {
+ *   private readonly projects = createInfiniteQueryController(this, {
+ *     queryKey: ['projects'],
+ *     queryFn: ({ pageParam }) => fetchProjects(pageParam),
+ *     initialPageParam: 0,
+ *     getNextPageParam: (lastPage) => lastPage.nextCursor,
+ *   })
+ *
+ *   render() {
+ *     const query = this.projects()
+ *
+ *     return html`
+ *       <button ?disabled=${!query.hasNextPage} @click=${() => this.projects.fetchNextPage()}>
+ *         Load more
+ *       </button>
+ *     `
+ *   }
+ * }
+ * ```
+ */
+export function createInfiniteQueryController(host, options, queryClient) {
+    const controller = new InfiniteQueryController(host, options, queryClient);
+    return Object.assign(createValueAccessor(() => controller.current), {
+        refetch: controller.refetch,
+        fetchNextPage: controller.fetchNextPage,
+        fetchPreviousPage: controller.fetchPreviousPage,
+        destroy: () => controller.destroy(),
+    });
+}
+//# sourceMappingURL=createInfiniteQueryController.js.map

package/dist/createInfiniteQueryController.js.map

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

package/dist/createMutationController.d.ts

@@ -0,0 +1,79 @@
+import { type DefaultError, type MutateOptions, type MutationObserverOptions, type MutationObserverResult } from '@tanstack/query-core';
+import type { QueryClient } from '@tanstack/query-core';
+import type { ReactiveControllerHost } from 'lit';
+import { type Accessor, type ValueAccessor } from './accessor.js';
+/**
+ * Options accepted by `createMutationController`.
+ *
+ * This is the Lit adapter shape for `MutationObserverOptions`. Pass it directly
+ * or through an `Accessor` when the options depend on Lit host state.
+ */
+export type CreateMutationOptions<TData = unknown, TError = DefaultError, TVariables = void, TOnMutateResult = unknown> = MutationObserverOptions<TData, TError, TVariables, TOnMutateResult>;
+/**
+ * Accessor returned by `createMutationController`.
+ *
+ * Call the accessor or read its `current` property to get the latest mutation
+ * result. The attached methods delegate to the active mutation observer.
+ */
+export type MutationResultAccessor<TData, TError, TVariables, TOnMutateResult> = ValueAccessor<MutationObserverResult<TData, TError, TVariables, TOnMutateResult>> & {
+    /**
+     * Starts the mutation and swallows the returned promise.
+     *
+     * Throws synchronously if no `QueryClient` can be resolved.
+     */
+    mutate: (variables: TVariables, options?: MutateOptions<TData, TError, TVariables, TOnMutateResult>) => void;
+    /**
+     * Starts the mutation and returns the observer promise.
+     *
+     * Rejects if no `QueryClient` can be resolved.
+     */
+    mutateAsync: MutationObserverResult<TData, TError, TVariables, TOnMutateResult>['mutate'];
+    /** Resets the mutation observer to its idle state. */
+    reset: MutationObserverResult<TData, TError, TVariables, TOnMutateResult>['reset'];
+    /** Removes the controller from its Lit host and unsubscribes observers. */
+    destroy: () => void;
+};
+/**
+ * Creates a Lit reactive controller that subscribes the host to a mutation.
+ *
+ * The returned accessor is callable and also exposes `current`, `mutate`,
+ * `mutateAsync`, `reset`, and `destroy`. When `options` is a function, it is
+ * re-read during host updates so mutation options can follow reactive host
+ * state.
+ *
+ * If `queryClient` is omitted, the controller resolves the client from the
+ * nearest connected `QueryClientProvider`.
+ *
+ * @param host - The Lit reactive controller host that owns the mutation
+ * subscription.
+ * @param options - Mutation observer options, or a getter that returns options.
+ * @param queryClient - Optional explicit query client. Provide this for
+ * controllers that should not resolve a client from Lit context.
+ * @returns An accessor for the latest mutation result with mutation helper
+ * methods.
+ *
+ * @example
+ * ```ts
+ * import { LitElement, html } from 'lit'
+ * import { createMutationController } from '@tanstack/lit-query'
+ *
+ * class AddTodoForm extends LitElement {
+ *   private readonly addTodo = createMutationController(this, {
+ *     mutationFn: (title: string) =>
+ *       fetch('/api/todos', { method: 'POST', body: JSON.stringify({ title }) }),
+ *   })
+ *
+ *   render() {
+ *     const mutation = this.addTodo()
+ *
+ *     return html`
+ *       <button ?disabled=${mutation.isPending} @click=${() => this.addTodo.mutate('Ship docs')}>
+ *         Add todo
+ *       </button>
+ *     `
+ *   }
+ * }
+ * ```
+ */
+export declare function createMutationController<TData = unknown, TError = DefaultError, TVariables = void, TOnMutateResult = unknown>(host: ReactiveControllerHost, options: Accessor<CreateMutationOptions<TData, TError, TVariables, TOnMutateResult>>, queryClient?: QueryClient): MutationResultAccessor<TData, TError, TVariables, TOnMutateResult>;
+//# sourceMappingURL=createMutationController.d.ts.map

package/dist/createMutationController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createMutationController.d.ts","sourceRoot":"","sources":["../src/createMutationController.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC5B,MAAM,sBAAsB,CAAA;AAC7B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,KAAK,CAAA;AACjD,OAAO,EAGL,KAAK,QAAQ,EACb,KAAK,aAAa,EACnB,MAAM,eAAe,CAAA;AAItB;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,CAC/B,KAAK,GAAG,OAAO,EACf,MAAM,GAAG,YAAY,EACrB,UAAU,GAAG,IAAI,EACjB,eAAe,GAAG,OAAO,IACvB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,CAAC,CAAA;AAEvE;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,IAC3E,aAAa,CACX,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,CAAC,CACnE,GAAG;IACF;;;;OAIG;IACH,MAAM,EAAE,CACN,SAAS,EAAE,UAAU,EACrB,OAAO,CAAC,EAAE,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,CAAC,KAChE,IAAI,CAAA;IACT;;;;OAIG;IACH,WAAW,EAAE,sBAAsB,CACjC,KAAK,EACL,MAAM,EACN,UAAU,EACV,eAAe,CAChB,CAAC,QAAQ,CAAC,CAAA;IACX,sDAAsD;IACtD,KAAK,EAAE,sBAAsB,CAC3B,KAAK,EACL,MAAM,EACN,UAAU,EACV,eAAe,CAChB,CAAC,OAAO,CAAC,CAAA;IACV,2EAA2E;IAC3E,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB,CAAA;AAiOH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,GAAG,OAAO,EACf,MAAM,GAAG,YAAY,EACrB,UAAU,GAAG,IAAI,EACjB,eAAe,GAAG,OAAO,EAEzB,IAAI,EAAE,sBAAsB,EAC5B,OAAO,EAAE,QAAQ,CACf,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,CAAC,CAClE,EACD,WAAW,CAAC,EAAE,WAAW,GACxB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,CAAC,CAYpE"}