@btst/stack 2.12.2 → 3.0.0-rc.1

package/dist/shared/{stack.BnSAhKJi.d.ts → stack.CRelKJfH.d.ts}

@@ -1,7 +1,8 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
-import { S as SerializedPost, a as SerializedTag } from './stack.Dsatjh0B.js';
 import { z } from 'zod';
-import { c as createPostSchema, u as updatePostSchema } from './stack.CuhcFsAx.js';
+import { ResourceFormConfig, ResourceFormResult } from '@btst/stack/plugins/client/hooks';
+import { S as SerializedPost, a as SerializedTag } from './stack.Dsatjh0B.js';
+import { c as createPostSchema, u as updatePostSchema } from './stack.B0muOwUF.js';
 
 /**
  * Options for the usePosts hook
@@ -127,8 +128,18 @@ declare function useSuspenseTags(): {
     tags: SerializedTag[];
     refetch: () => Promise<unknown>;
 };
+/**
+ * Form lifecycle hook for creating/editing posts, built on the core
+ * resource `useForm`: submits the right mutation, awaits invalidation,
+ * notifies, redirects, and maps server validation issues to `fieldErrors`.
+ */
+declare function usePostForm<TValues>(config: ResourceFormConfig<TValues, SerializedPost | null, SerializedPost | null>): ResourceFormResult<TValues, SerializedPost | null, SerializedPost | null>;
 /** Create a new post */
 declare function useCreatePost(): _tanstack_react_query.UseMutationResult<SerializedPost | null, Error, {
+    title: string;
+    content: string;
+    excerpt: string;
+    published: boolean;
     tags: ({
         name: string;
     } | {
@@ -136,27 +147,41 @@ declare function useCreatePost(): _tanstack_react_query.UseMutationResult<Serial
         name: string;
         slug: string;
     })[];
-    published: boolean;
-    title: string;
-    content: string;
-    excerpt: string;
     slug?: string | undefined;
     publishedAt?: Date | undefined;
     createdAt?: Date | undefined;
     updatedAt?: Date | undefined;
     image?: string | undefined;
-}, unknown>;
+}>;
 /** Update an existing post by id */
 declare function useUpdatePost(): _tanstack_react_query.UseMutationResult<SerializedPost | null, Error, {
     id: string;
-    data: PostUpdateInput;
-}, unknown>;
+    data: {
+        title: string;
+        content: string;
+        excerpt: string;
+        published: boolean;
+        slug: string;
+        tags: ({
+            name: string;
+        } | {
+            id: string;
+            name: string;
+            slug: string;
+        })[];
+        id: string;
+        publishedAt?: Date | undefined;
+        createdAt?: Date | undefined;
+        updatedAt?: Date | undefined;
+        image?: string | undefined;
+    };
+}>;
 /** Delete a post by id */
 declare function useDeletePost(): _tanstack_react_query.UseMutationResult<{
     success: boolean;
 }, Error, {
     id: string;
-}, unknown>;
+}>;
 /**
  * Hook for searching posts by a free-text query. Uses `usePosts` under the hood.
  * Debounces the query and preserves last successful results to avoid flicker.
@@ -219,5 +244,5 @@ interface UseRecentPostsResult {
  */
 declare function useRecentPosts(options?: UseRecentPostsOptions): UseRecentPostsResult;
 
-export { useSuspensePosts as f, usePost as g, useSuspensePost as h, useTags as i, useSuspenseTags as j, useCreatePost as k, useUpdatePost as l, useDeletePost as m, usePostSearch as n, useNextPreviousPosts as q, useRecentPosts as t, usePosts as u };
-export type { PostCreateInput as P, UsePostsOptions as U, UsePostsResult as a, UsePostSearchOptions as b, UsePostSearchResult as c, UsePostResult as d, PostUpdateInput as e, UseNextPreviousPostsOptions as o, UseNextPreviousPostsResult as p, UseRecentPostsOptions as r, UseRecentPostsResult as s };
+export { useSuspensePosts as f, usePost as g, useSuspensePost as h, useTags as i, useSuspenseTags as j, usePostForm as k, useCreatePost as l, useUpdatePost as m, useDeletePost as n, usePostSearch as o, useNextPreviousPosts as r, usePosts as u, useRecentPosts as v };
+export type { PostCreateInput as P, UsePostsOptions as U, UsePostsResult as a, UsePostSearchOptions as b, UsePostSearchResult as c, UsePostResult as d, PostUpdateInput as e, UseNextPreviousPostsOptions as p, UseNextPreviousPostsResult as q, UseRecentPostsOptions as s, UseRecentPostsResult as t };

package/dist/shared/stack.CbZenbej.d.cts

@@ -0,0 +1,251 @@
+/**
+ * Shared error contract and React Query config for all data plugins.
+ *
+ * Every plugin used to copy-paste `isErrorResponse` / `toError` /
+ * `SHARED_QUERY_CONFIG` into its own `query-keys.ts` / hooks files. These now
+ * live in core and are exported once from `@btst/stack/plugins/client`.
+ */
+/**
+ * Standardized error shape thrown by resource queries and mutations.
+ *
+ * `errors` maps field names to validation message(s), preserving Zod
+ * field-level issues from better-call endpoint validation errors so form
+ * hooks can map them onto per-field error state.
+ */
+interface StackError extends Error {
+    statusCode?: number;
+    errors?: Record<string, string | string[]>;
+}
+/**
+ * Shared React Query configuration for all plugin queries.
+ * Prevents automatic refetching to avoid hydration mismatches in SSR.
+ */
+declare const SHARED_QUERY_CONFIG: {
+    readonly retry: false;
+    readonly refetchOnWindowFocus: false;
+    readonly refetchOnMount: false;
+    readonly refetchOnReconnect: false;
+    readonly staleTime: number;
+    readonly gcTime: number;
+};
+/**
+ * Type guard for better-call error responses.
+ * better-call client returns `Error$1<unknown> | Data<T>` — we check if
+ * `error` exists and is not null/undefined to determine it's an error response.
+ */
+declare function isErrorResponse(response: unknown): response is {
+    error: unknown;
+    data?: never;
+};
+/**
+ * Converts an unknown error (typically a better-call / better-fetch error
+ * response body) into a proper `StackError` with a meaningful message.
+ *
+ * Normalizes to `{ message, statusCode?, errors? }` where `errors` maps
+ * field names to validation messages (preserved from Zod issues in
+ * better-call endpoint validation error responses).
+ */
+declare function toError(error: unknown): StackError;
+
+/**
+ * Server-safe resource declaration types and query-key/queryFn builder.
+ *
+ * A plugin declares its resources once (paths, query mappings, unwrapping,
+ * key discriminators) and gets:
+ *
+ * - `createResourceQueryKeys(client, resources, headers?)` — a query-key
+ *   factory usable from SSR loaders and `query-keys.ts` (no React), with the
+ *   same `_def` / `queryKey` shapes as `@lukemorales/query-key-factory`, so
+ *   existing SSG `prefetchForRoute` / `query-key-defs.ts` keys keep matching.
+ * - `createResource(...)` (see `./hooks`) — generated React Query hooks.
+ */
+/**
+ * Minimal better-call client shape the resource layer needs.
+ * Any `createApiClient<TRouter>()` result is assignable.
+ */
+type ResourceClient = (path: any, options?: any) => Promise<unknown>;
+/**
+ * Declaration for a single query on a resource.
+ *
+ * Query-key shape: `[resourceName, queryName, ...key(...args)]` where `key`
+ * defaults to the args themselves. Share discriminator functions with
+ * `api/query-key-defs.ts` to keep SSG prefetch keys in sync.
+ */
+interface ResourceQueryDef<TArgs extends readonly unknown[] = readonly any[], TData = unknown> {
+    /** better-call endpoint path, e.g. `"/posts"` or `"/content/:typeSlug"` */
+    path: string;
+    /** Maps hook args to the endpoint path params (for `:param` segments) */
+    params?: (...args: TArgs) => Record<string, string>;
+    /** Maps hook args to the HTTP query object */
+    query?: (...args: TArgs) => Record<string, unknown> | undefined;
+    /**
+     * Maps hook args to the queryKey discriminator cells appended after
+     * `[resourceName, queryName]`. Defaults to the args themselves.
+     */
+    key?: (...args: TArgs) => readonly unknown[];
+    /** Unwraps/selects data from the raw response data */
+    select?: (data: any, ...args: TArgs) => TData;
+    /**
+     * Offset-paginated infinite query. The queryFn receives `pageParam` and
+     * injects it into the HTTP query as `offsetParam`. `select` must return
+     * an array (one page of items).
+     */
+    infinite?: boolean;
+    /** HTTP query param carrying the page offset (default `"offset"`) */
+    offsetParam?: string;
+    /**
+     * Page size used to derive `getNextPageParam` for infinite queries
+     * (default 10). A function form derives it from the hook args.
+     */
+    pageSize?: number | ((...args: TArgs) => number);
+    /**
+     * Custom `getNextPageParam` for infinite queries whose pages are not
+     * plain item arrays (e.g. `{ items, total }` envelopes). Overrides the
+     * default page-size heuristic. Return `undefined` when there is no
+     * next page.
+     */
+    nextPageParam?: (lastPage: TData, allPages: TData[], ...args: TArgs) => unknown | undefined;
+    /** When true, skip fetching and resolve `null` (e.g. missing id) */
+    skip?: (...args: TArgs) => boolean;
+}
+/**
+ * Declaration for a single mutation on a resource.
+ */
+interface ResourceMutationDef<TVars = any, TResult = unknown> {
+    /** better-call endpoint path, e.g. `"@post/posts"` or `"@put/posts/:id"` */
+    path: string;
+    method: "POST" | "PUT" | "PATCH" | "DELETE";
+    /**
+     * Maps mutation variables to better-call call options.
+     * Defaults to `{ body: vars }`.
+     */
+    input?: (vars: TVars) => {
+        body?: unknown;
+        params?: Record<string, string>;
+        query?: Record<string, unknown>;
+    };
+    /** Unwraps the mutation result from the raw response data */
+    select?: (data: any) => TResult;
+    /**
+     * Query-key prefixes invalidated (awaited, in order) after success.
+     * `"posts"` invalidates the whole resource, `"posts.list"` one query.
+     */
+    invalidates?: readonly string[];
+    /**
+     * Which matching queries to refetch during invalidation. Defaults to
+     * React Query's `"active"`; use `"all"` when an inactive view must be
+     * refreshed before it remounts.
+     */
+    refetchType?: "active" | "inactive" | "all" | "none";
+    /**
+     * Seed a query cache entry from the mutation result (e.g. the detail
+     * entry for a created/updated record). `args` returns the key args for
+     * the target query, or `null` to skip seeding.
+     */
+    setData?: {
+        /** Target query name on the same resource (default `"detail"`) */
+        query?: string;
+        args: (result: TResult) => readonly unknown[] | null;
+        /**
+         * Optionally merge the mutation result with the existing cache value.
+         * Defaults to replacing the cached value with `result`.
+         */
+        updater?: (previous: unknown, result: TResult) => unknown;
+    };
+    /**
+     * Remove a query cache entry after success (e.g. the deleted record's
+     * detail query). `args` may derive the target key from both the result and
+     * the submitted variables, or return `null` to skip removal.
+     */
+    removeData?: {
+        /** Target query name on the same resource (default `"detail"`) */
+        query?: string;
+        args: (result: TResult, variables: TVars) => readonly unknown[] | null;
+    };
+    /**
+     * Whether to call the router `refresh` override after success (default
+     * `true`). Set `false` for mutations that must not reload server-rendered
+     * state — e.g. public submissions whose success UI lives in client state.
+     */
+    refresh?: boolean;
+}
+/** Declaration for one resource: its queries and (optionally) mutations. */
+interface ResourceDef {
+    queries: Record<string, ResourceQueryDef<any, any>>;
+    mutations?: Record<string, ResourceMutationDef<any, any>>;
+}
+/** A plugin's full resource declaration, keyed by resource name. */
+type ResourcesDeclaration = Record<string, ResourceDef>;
+/** Extracts the hook args tuple from a query declaration. */
+type ResourceQueryArgs<TDef> = TDef extends {
+    query: (...args: infer A) => any;
+} ? A : TDef extends {
+    params: (...args: infer A) => any;
+} ? A : TDef extends {
+    key: (...args: infer A) => any;
+} ? A : TDef extends {
+    select: (data: any, ...args: infer A) => any;
+} ? A : [];
+/** Extracts the (per-page, for infinite queries) data type from a query declaration. */
+type ResourceQueryData<TDef> = TDef extends {
+    select: (data: any, ...args: any[]) => infer D;
+} ? D : unknown;
+/** Extracts the variables type from a mutation declaration. */
+type ResourceMutationVars<TDef> = TDef extends {
+    input: (vars: infer V) => any;
+} ? V : unknown;
+/** Extracts the result type from a mutation declaration. */
+type ResourceMutationResult<TDef> = TDef extends {
+    select: (data: any) => infer R;
+} ? R : unknown;
+/**
+ * A query-key factory entry: call with args to get `{ queryKey, queryFn }`,
+ * read `_def` for the `[resourceName, queryName]` prefix.
+ */
+interface ResourceQueryEntry<TArgs extends readonly unknown[] = readonly any[], TData = unknown> {
+    (...args: TArgs): {
+        queryKey: readonly unknown[];
+        queryFn: (context?: {
+            pageParam?: unknown;
+        }) => Promise<TData>;
+    };
+    _def: readonly [string, string];
+}
+/** The query-key factory produced from a resources declaration. */
+type ResourceQueryKeys<TResources extends ResourcesDeclaration> = {
+    [R in keyof TResources]: {
+        [Q in keyof TResources[R]["queries"]]: ResourceQueryEntry<ResourceQueryArgs<TResources[R]["queries"][Q]>, ResourceQueryData<TResources[R]["queries"][Q]>>;
+    } & {
+        _def: readonly [R];
+    };
+};
+/** Resolves the effective page size for an infinite query declaration. */
+declare function resolvePageSize(def: ResourceQueryDef<any, any>, args: readonly unknown[]): number;
+/** Builds the full query key for a query declaration and args. */
+declare function buildQueryKey(resourceName: string, queryName: string, def: ResourceQueryDef<any, any>, args: readonly unknown[]): readonly unknown[];
+/**
+ * Executes the fetch → error-check → unwrap dance for a query declaration.
+ */
+declare function runResourceQuery(client: ResourceClient, def: ResourceQueryDef<any, any>, args: readonly unknown[], pageParam?: unknown, headers?: HeadersInit): Promise<unknown>;
+/**
+ * Executes a mutation declaration: fetch → error-check → unwrap.
+ *
+ * `headers` supports plugins whose public hooks take an explicit client
+ * config (e.g. embeddable components) instead of resolving it from
+ * `usePluginOverrides` — same as the `headers` parameter on
+ * `createResourceQueryKeys`.
+ */
+declare function runResourceMutation(client: ResourceClient, def: ResourceMutationDef<any, any>, vars: unknown, headers?: HeadersInit): Promise<unknown>;
+/**
+ * Builds a query-key factory from a resources declaration.
+ *
+ * Compatible with the shapes `@lukemorales/query-key-factory` produces:
+ * `store.posts.list(params)` → `{ queryKey: ["posts", "list", ...], queryFn }`,
+ * `store.posts.list._def` → `["posts", "list"]`, `store.posts._def` → `["posts"]`.
+ *
+ * Server-safe (no React) — usable from SSR loaders and `query-keys.ts`.
+ */
+declare function createResourceQueryKeys<const TResources extends ResourcesDeclaration>(client: ResourceClient, resources: TResources, headers?: HeadersInit): ResourceQueryKeys<TResources>;
+
+export { SHARED_QUERY_CONFIG as S, buildQueryKey as b, createResourceQueryKeys as c, runResourceMutation as d, runResourceQuery as e, isErrorResponse as i, resolvePageSize as r, toError as t };
+export type { ResourceClient as R, StackError as a, ResourceDef as f, ResourceMutationDef as g, ResourceMutationResult as h, ResourceMutationVars as j, ResourceQueryArgs as k, ResourceQueryData as l, ResourceQueryDef as m, ResourceQueryEntry as n, ResourceQueryKeys as o, ResourcesDeclaration as p };

package/dist/shared/stack.CbZenbej.d.mts

@@ -0,0 +1,251 @@
+/**
+ * Shared error contract and React Query config for all data plugins.
+ *
+ * Every plugin used to copy-paste `isErrorResponse` / `toError` /
+ * `SHARED_QUERY_CONFIG` into its own `query-keys.ts` / hooks files. These now
+ * live in core and are exported once from `@btst/stack/plugins/client`.
+ */
+/**
+ * Standardized error shape thrown by resource queries and mutations.
+ *
+ * `errors` maps field names to validation message(s), preserving Zod
+ * field-level issues from better-call endpoint validation errors so form
+ * hooks can map them onto per-field error state.
+ */
+interface StackError extends Error {
+    statusCode?: number;
+    errors?: Record<string, string | string[]>;
+}
+/**
+ * Shared React Query configuration for all plugin queries.
+ * Prevents automatic refetching to avoid hydration mismatches in SSR.
+ */
+declare const SHARED_QUERY_CONFIG: {
+    readonly retry: false;
+    readonly refetchOnWindowFocus: false;
+    readonly refetchOnMount: false;
+    readonly refetchOnReconnect: false;
+    readonly staleTime: number;
+    readonly gcTime: number;
+};
+/**
+ * Type guard for better-call error responses.
+ * better-call client returns `Error$1<unknown> | Data<T>` — we check if
+ * `error` exists and is not null/undefined to determine it's an error response.
+ */
+declare function isErrorResponse(response: unknown): response is {
+    error: unknown;
+    data?: never;
+};
+/**
+ * Converts an unknown error (typically a better-call / better-fetch error
+ * response body) into a proper `StackError` with a meaningful message.
+ *
+ * Normalizes to `{ message, statusCode?, errors? }` where `errors` maps
+ * field names to validation messages (preserved from Zod issues in
+ * better-call endpoint validation error responses).
+ */
+declare function toError(error: unknown): StackError;
+
+/**
+ * Server-safe resource declaration types and query-key/queryFn builder.
+ *
+ * A plugin declares its resources once (paths, query mappings, unwrapping,
+ * key discriminators) and gets:
+ *
+ * - `createResourceQueryKeys(client, resources, headers?)` — a query-key
+ *   factory usable from SSR loaders and `query-keys.ts` (no React), with the
+ *   same `_def` / `queryKey` shapes as `@lukemorales/query-key-factory`, so
+ *   existing SSG `prefetchForRoute` / `query-key-defs.ts` keys keep matching.
+ * - `createResource(...)` (see `./hooks`) — generated React Query hooks.
+ */
+/**
+ * Minimal better-call client shape the resource layer needs.
+ * Any `createApiClient<TRouter>()` result is assignable.
+ */
+type ResourceClient = (path: any, options?: any) => Promise<unknown>;
+/**
+ * Declaration for a single query on a resource.
+ *
+ * Query-key shape: `[resourceName, queryName, ...key(...args)]` where `key`
+ * defaults to the args themselves. Share discriminator functions with
+ * `api/query-key-defs.ts` to keep SSG prefetch keys in sync.
+ */
+interface ResourceQueryDef<TArgs extends readonly unknown[] = readonly any[], TData = unknown> {
+    /** better-call endpoint path, e.g. `"/posts"` or `"/content/:typeSlug"` */
+    path: string;
+    /** Maps hook args to the endpoint path params (for `:param` segments) */
+    params?: (...args: TArgs) => Record<string, string>;
+    /** Maps hook args to the HTTP query object */
+    query?: (...args: TArgs) => Record<string, unknown> | undefined;
+    /**
+     * Maps hook args to the queryKey discriminator cells appended after
+     * `[resourceName, queryName]`. Defaults to the args themselves.
+     */
+    key?: (...args: TArgs) => readonly unknown[];
+    /** Unwraps/selects data from the raw response data */
+    select?: (data: any, ...args: TArgs) => TData;
+    /**
+     * Offset-paginated infinite query. The queryFn receives `pageParam` and
+     * injects it into the HTTP query as `offsetParam`. `select` must return
+     * an array (one page of items).
+     */
+    infinite?: boolean;
+    /** HTTP query param carrying the page offset (default `"offset"`) */
+    offsetParam?: string;
+    /**
+     * Page size used to derive `getNextPageParam` for infinite queries
+     * (default 10). A function form derives it from the hook args.
+     */
+    pageSize?: number | ((...args: TArgs) => number);
+    /**
+     * Custom `getNextPageParam` for infinite queries whose pages are not
+     * plain item arrays (e.g. `{ items, total }` envelopes). Overrides the
+     * default page-size heuristic. Return `undefined` when there is no
+     * next page.
+     */
+    nextPageParam?: (lastPage: TData, allPages: TData[], ...args: TArgs) => unknown | undefined;
+    /** When true, skip fetching and resolve `null` (e.g. missing id) */
+    skip?: (...args: TArgs) => boolean;
+}
+/**
+ * Declaration for a single mutation on a resource.
+ */
+interface ResourceMutationDef<TVars = any, TResult = unknown> {
+    /** better-call endpoint path, e.g. `"@post/posts"` or `"@put/posts/:id"` */
+    path: string;
+    method: "POST" | "PUT" | "PATCH" | "DELETE";
+    /**
+     * Maps mutation variables to better-call call options.
+     * Defaults to `{ body: vars }`.
+     */
+    input?: (vars: TVars) => {
+        body?: unknown;
+        params?: Record<string, string>;
+        query?: Record<string, unknown>;
+    };
+    /** Unwraps the mutation result from the raw response data */
+    select?: (data: any) => TResult;
+    /**
+     * Query-key prefixes invalidated (awaited, in order) after success.
+     * `"posts"` invalidates the whole resource, `"posts.list"` one query.
+     */
+    invalidates?: readonly string[];
+    /**
+     * Which matching queries to refetch during invalidation. Defaults to
+     * React Query's `"active"`; use `"all"` when an inactive view must be
+     * refreshed before it remounts.
+     */
+    refetchType?: "active" | "inactive" | "all" | "none";
+    /**
+     * Seed a query cache entry from the mutation result (e.g. the detail
+     * entry for a created/updated record). `args` returns the key args for
+     * the target query, or `null` to skip seeding.
+     */
+    setData?: {
+        /** Target query name on the same resource (default `"detail"`) */
+        query?: string;
+        args: (result: TResult) => readonly unknown[] | null;
+        /**
+         * Optionally merge the mutation result with the existing cache value.
+         * Defaults to replacing the cached value with `result`.
+         */
+        updater?: (previous: unknown, result: TResult) => unknown;
+    };
+    /**
+     * Remove a query cache entry after success (e.g. the deleted record's
+     * detail query). `args` may derive the target key from both the result and
+     * the submitted variables, or return `null` to skip removal.
+     */
+    removeData?: {
+        /** Target query name on the same resource (default `"detail"`) */
+        query?: string;
+        args: (result: TResult, variables: TVars) => readonly unknown[] | null;
+    };
+    /**
+     * Whether to call the router `refresh` override after success (default
+     * `true`). Set `false` for mutations that must not reload server-rendered
+     * state — e.g. public submissions whose success UI lives in client state.
+     */
+    refresh?: boolean;
+}
+/** Declaration for one resource: its queries and (optionally) mutations. */
+interface ResourceDef {
+    queries: Record<string, ResourceQueryDef<any, any>>;
+    mutations?: Record<string, ResourceMutationDef<any, any>>;
+}
+/** A plugin's full resource declaration, keyed by resource name. */
+type ResourcesDeclaration = Record<string, ResourceDef>;
+/** Extracts the hook args tuple from a query declaration. */
+type ResourceQueryArgs<TDef> = TDef extends {
+    query: (...args: infer A) => any;
+} ? A : TDef extends {
+    params: (...args: infer A) => any;
+} ? A : TDef extends {
+    key: (...args: infer A) => any;
+} ? A : TDef extends {
+    select: (data: any, ...args: infer A) => any;
+} ? A : [];
+/** Extracts the (per-page, for infinite queries) data type from a query declaration. */
+type ResourceQueryData<TDef> = TDef extends {
+    select: (data: any, ...args: any[]) => infer D;
+} ? D : unknown;
+/** Extracts the variables type from a mutation declaration. */
+type ResourceMutationVars<TDef> = TDef extends {
+    input: (vars: infer V) => any;
+} ? V : unknown;
+/** Extracts the result type from a mutation declaration. */
+type ResourceMutationResult<TDef> = TDef extends {
+    select: (data: any) => infer R;
+} ? R : unknown;
+/**
+ * A query-key factory entry: call with args to get `{ queryKey, queryFn }`,
+ * read `_def` for the `[resourceName, queryName]` prefix.
+ */
+interface ResourceQueryEntry<TArgs extends readonly unknown[] = readonly any[], TData = unknown> {
+    (...args: TArgs): {
+        queryKey: readonly unknown[];
+        queryFn: (context?: {
+            pageParam?: unknown;
+        }) => Promise<TData>;
+    };
+    _def: readonly [string, string];
+}
+/** The query-key factory produced from a resources declaration. */
+type ResourceQueryKeys<TResources extends ResourcesDeclaration> = {
+    [R in keyof TResources]: {
+        [Q in keyof TResources[R]["queries"]]: ResourceQueryEntry<ResourceQueryArgs<TResources[R]["queries"][Q]>, ResourceQueryData<TResources[R]["queries"][Q]>>;
+    } & {
+        _def: readonly [R];
+    };
+};
+/** Resolves the effective page size for an infinite query declaration. */
+declare function resolvePageSize(def: ResourceQueryDef<any, any>, args: readonly unknown[]): number;
+/** Builds the full query key for a query declaration and args. */
+declare function buildQueryKey(resourceName: string, queryName: string, def: ResourceQueryDef<any, any>, args: readonly unknown[]): readonly unknown[];
+/**
+ * Executes the fetch → error-check → unwrap dance for a query declaration.
+ */
+declare function runResourceQuery(client: ResourceClient, def: ResourceQueryDef<any, any>, args: readonly unknown[], pageParam?: unknown, headers?: HeadersInit): Promise<unknown>;
+/**
+ * Executes a mutation declaration: fetch → error-check → unwrap.
+ *
+ * `headers` supports plugins whose public hooks take an explicit client
+ * config (e.g. embeddable components) instead of resolving it from
+ * `usePluginOverrides` — same as the `headers` parameter on
+ * `createResourceQueryKeys`.
+ */
+declare function runResourceMutation(client: ResourceClient, def: ResourceMutationDef<any, any>, vars: unknown, headers?: HeadersInit): Promise<unknown>;
+/**
+ * Builds a query-key factory from a resources declaration.
+ *
+ * Compatible with the shapes `@lukemorales/query-key-factory` produces:
+ * `store.posts.list(params)` → `{ queryKey: ["posts", "list", ...], queryFn }`,
+ * `store.posts.list._def` → `["posts", "list"]`, `store.posts._def` → `["posts"]`.
+ *
+ * Server-safe (no React) — usable from SSR loaders and `query-keys.ts`.
+ */
+declare function createResourceQueryKeys<const TResources extends ResourcesDeclaration>(client: ResourceClient, resources: TResources, headers?: HeadersInit): ResourceQueryKeys<TResources>;
+
+export { SHARED_QUERY_CONFIG as S, buildQueryKey as b, createResourceQueryKeys as c, runResourceMutation as d, runResourceQuery as e, isErrorResponse as i, resolvePageSize as r, toError as t };
+export type { ResourceClient as R, StackError as a, ResourceDef as f, ResourceMutationDef as g, ResourceMutationResult as h, ResourceMutationVars as j, ResourceQueryArgs as k, ResourceQueryData as l, ResourceQueryDef as m, ResourceQueryEntry as n, ResourceQueryKeys as o, ResourcesDeclaration as p };