@kubb/plugin-react-query 3.0.0-alpha.3 → 3.0.0-alpha.30

package/dist/index-C9fwRDH7.d.cts

@@ -1,579 +0,0 @@
-import { URLPath } from '@kubb/core/utils';
-import { HttpMethod } from '@kubb/oas';
-import { ReactNode, ComponentType, ComponentProps } from 'react';
-import { PluginFactoryOptions, ResolveNameParams } from '@kubb/core';
-import * as KubbFile from '@kubb/fs/types';
-import { ResolvePathOptions, Exclude, Include, Override } from '@kubb/plugin-oas';
-import { KubbNode } from '@kubb/react';
-
-type TemplateProps$5 = {
-    /**
-     * Name of the function
-     */
-    name: string;
-    /**
-     * Parameters/options/props that need to be used
-     */
-    params: string;
-    mutateParams: string;
-    /**
-     * Options for JSdocs
-     */
-    JSDoc?: {
-        comments: string[];
-    };
-    hook: {
-        name: string;
-        generics?: string;
-        children?: string;
-    };
-    client: {
-        generics: string;
-        method: HttpMethod;
-        path: URLPath;
-        withQueryParams: boolean;
-        withPathParams: boolean;
-        withData: boolean;
-        withHeaders: boolean;
-        contentType: string;
-    };
-    dataReturnType: NonNullable<PluginReactQuery['options']['dataReturnType']>;
-};
-declare function Template$1({ name, params, mutateParams, JSDoc, client, hook, dataReturnType }: TemplateProps$5): ReactNode;
-type RootTemplateProps$1 = {
-    children?: React.ReactNode;
-};
-declare function RootTemplate$1({ children }: RootTemplateProps$1): JSX.Element;
-declare const defaultTemplates$2: {
-    readonly default: typeof Template$1;
-    readonly root: typeof RootTemplate$1;
-};
-type Templates$2 = Partial<typeof defaultTemplates$2>;
-type MutationProps = {
-    /**
-     * This will make it possible to override the default behaviour.
-     */
-    Template?: ComponentType<ComponentProps<typeof Template$1>>;
-};
-declare function Mutation({ Template }: MutationProps): ReactNode;
-declare namespace Mutation {
-    var File: ({ ...props }: FileProps$2) => ReactNode;
-    var templates: {
-        readonly default: typeof Template$1;
-        readonly root: typeof RootTemplate$1;
-    };
-}
-type FileProps$2 = {
-    /**
-     * This will make it possible to override the default behaviour.
-     */
-    templates?: Templates$2;
-};
-
-type TemplateProps$4 = {};
-declare function Template({}: TemplateProps$4): KubbNode;
-type RootTemplateProps = {
-    children?: React.ReactNode;
-};
-declare function RootTemplate({ children }: RootTemplateProps): JSX.Element;
-declare const defaultTemplates$1: {
-    readonly default: typeof Template;
-    readonly root: typeof RootTemplate;
-};
-type Templates$1 = Partial<typeof defaultTemplates$1>;
-type Props$4 = {
-    /**
-     * This will make it possible to override the default behaviour.
-     */
-    Template?: ComponentType<ComponentProps<typeof Template>>;
-};
-declare function Operations({ Template }: Props$4): KubbNode;
-declare namespace Operations {
-    var File: (props: FileProps$1) => KubbNode;
-    var templates: {
-        readonly default: typeof Template;
-        readonly root: typeof RootTemplate;
-    };
-}
-type FileProps$1 = {
-    /**
-     * This will make it possible to override the default behaviour.
-     */
-    templates?: Templates$1;
-};
-
-type TemplateProps$3 = {
-    /**
-     * Path to @tanstack-query
-     */
-    path: string;
-    /**
-     * Override the path of 'useQuery'
-     * @default 'path'
-     */
-    hookPath: string | undefined;
-    optionsType: string;
-    queryOptions: string | undefined;
-    resultType: string;
-    hookName: string;
-    isInfinite: boolean;
-};
-type FrameworkProps$3 = Partial<TemplateProps$3> & {
-    context: {
-        isInfinite: boolean;
-        isSuspense: boolean;
-    };
-};
-type Props$3 = {
-    hookPath: string | undefined;
-    isInfinite: boolean;
-    /**
-     * Only for React and v5
-     */
-    isSuspense: boolean;
-    /**
-     * This will make it possible to override the default behaviour.
-     */
-    Template?: React.ComponentType<FrameworkProps$3>;
-};
-declare function QueryImports({ hookPath, isInfinite, isSuspense, Template }: Props$3): ReactNode;
-declare namespace QueryImports {
-    var templates: {
-        readonly react: ({ context, hookPath, ...rest }: FrameworkProps$3) => ReactNode;
-        readonly solid: ({ context, hookPath, ...rest }: FrameworkProps$3) => ReactNode;
-        readonly svelte: ({ context, hookPath, ...rest }: FrameworkProps$3) => ReactNode;
-        readonly vue: ({ context, hookPath, ...rest }: FrameworkProps$3) => ReactNode;
-    };
-}
-
-type TemplateProps$2 = {
-    /**
-     * Name of the function
-     */
-    name: string;
-    /**
-     * TypeName of the function in PascalCase
-     */
-    typeName: string;
-    /**
-     * Parameters/options/props that need to be used
-     */
-    params: string;
-    /**
-     * Generics that needs to be added for TypeScript
-     */
-    generics?: string;
-    /**
-     * ReturnType(see async for adding Promise type)
-     */
-    returnType?: string;
-    /**
-     * Options for JSdocs
-     */
-    JSDoc?: {
-        comments: string[];
-    };
-    keys?: string;
-};
-type FrameworkProps$2 = TemplateProps$2 & {
-    context: {
-        factory: {
-            name: string;
-        };
-    };
-};
-type Props$2 = {
-    name: string;
-    typeName: string;
-    keysFn: (keys: unknown[]) => unknown[];
-    factory: {
-        name: string;
-    };
-    /**
-     * This will make it possible to override the default behaviour.
-     */
-    Template?: React.ComponentType<FrameworkProps$2>;
-};
-declare function QueryKey({ name, typeName, factory, keysFn, Template }: Props$2): ReactNode;
-declare namespace QueryKey {
-    var templates: {
-        readonly react: (props: FrameworkProps$2) => ReactNode;
-        readonly solid: (props: FrameworkProps$2) => ReactNode;
-        readonly svelte: (props: FrameworkProps$2) => ReactNode;
-        readonly vue: ({ context, ...rest }: FrameworkProps$2) => ReactNode;
-    };
-}
-
-type TemplateProps$1 = {
-    /**
-     * Name of the function
-     */
-    name: string;
-    /**
-     * Parameters/options/props that need to be used
-     */
-    params: string;
-    /**
-     * Generics that needs to be added for TypeScript
-     */
-    generics?: string;
-    /**
-     * ReturnType(see async for adding Promise type)
-     */
-    returnType?: string;
-    /**
-     * Options for JSdocs
-     */
-    JSDoc?: {
-        comments: string[];
-    };
-    hook: {
-        queryKey: string;
-        children?: string;
-    };
-    client: {
-        generics: string;
-        method: HttpMethod;
-        path: URLPath;
-        withQueryParams: boolean;
-        withPathParams: boolean;
-        withData: boolean;
-        withHeaders: boolean;
-        contentType: string;
-    };
-    infinite: Infinite | false;
-    dataReturnType: NonNullable<PluginReactQuery['options']['dataReturnType']>;
-    parser: string | undefined;
-};
-type FrameworkProps$1 = TemplateProps$1 & {
-    context: {
-        factory: {
-            name: string;
-        };
-        queryKey: string;
-    };
-};
-type Props$1 = {
-    infinite: Infinite | false;
-    suspense: Suspense | false;
-    factory: {
-        name: string;
-    };
-    resultType: string;
-    /**
-     * This will make it possible to override the default behaviour.
-     */
-    Template?: React.ComponentType<FrameworkProps$1>;
-    dataReturnType: NonNullable<PluginReactQuery['options']['dataReturnType']>;
-};
-declare function QueryOptions$1({ factory, infinite, suspense, resultType, dataReturnType, Template }: Props$1): ReactNode;
-declare namespace QueryOptions$1 {
-    var templates: {
-        readonly react: (props: FrameworkProps$1) => ReactNode;
-        readonly solid: (props: FrameworkProps$1) => ReactNode;
-        readonly svelte: (props: FrameworkProps$1) => ReactNode;
-        readonly vue: ({ client, context, ...rest }: FrameworkProps$1) => ReactNode;
-    };
-}
-
-type TemplateProps = {
-    /**
-     * Name of the function
-     */
-    name: string;
-    /**
-     * Parameters/options/props that need to be used
-     */
-    params: string;
-    /**
-     * Generics that needs to be added for TypeScript
-     */
-    generics?: string;
-    /**
-     * ReturnType(see async for adding Promise type)
-     */
-    returnType?: string;
-    /**
-     * Options for JSdocs
-     */
-    JSDoc?: {
-        comments: string[];
-    };
-    hook: {
-        name: string;
-        generics?: string;
-        queryKey: string;
-        queryOptions: string;
-    };
-    infinite: Infinite | false;
-};
-type FrameworkProps = TemplateProps & {
-    context: {
-        factory: {
-            name: string;
-        };
-        queryKey: string;
-    };
-};
-declare const defaultTemplates: {
-    readonly react: (props: FrameworkProps) => ReactNode;
-    readonly solid: (props: FrameworkProps) => ReactNode;
-    readonly svelte: (props: FrameworkProps) => ReactNode;
-    readonly vue: ({ context, hook, ...rest }: FrameworkProps) => ReactNode;
-};
-type Props = {
-    factory: {
-        name: string;
-    };
-    resultType: string;
-    hookName: string;
-    optionsType: string;
-    infinite: Infinite | false;
-    query: Query | false;
-    queryOptions: QueryOptions | false;
-    suspense: Suspense | false;
-    /**
-     * This will make it possible to override the default behaviour.
-     */
-    Template?: React.ComponentType<FrameworkProps>;
-    /**
-     * This will make it possible to override the default behaviour.
-     */
-    QueryKeyTemplate?: React.ComponentType<React.ComponentProps<typeof QueryKey.templates.react>>;
-    /**
-     * This will make it possible to override the default behaviour.
-     */
-    QueryOptionsTemplate?: React.ComponentType<React.ComponentProps<typeof QueryOptions$1.templates.react>>;
-};
-declare function Query$1({ factory, optionsType, hookName, resultType, Template, QueryKeyTemplate, QueryOptionsTemplate, ...props }: Props): ReactNode;
-declare namespace Query$1 {
-    var File: ({ templates }: FileProps) => ReactNode;
-    var templates: {
-        readonly react: (props: FrameworkProps) => ReactNode;
-        readonly solid: (props: FrameworkProps) => ReactNode;
-        readonly svelte: (props: FrameworkProps) => ReactNode;
-        readonly vue: ({ context, hook, ...rest }: FrameworkProps) => ReactNode;
-    };
-}
-type FileProps = {
-    /**
-     * This will make it possible to override the default behaviour.
-     */
-    templates?: {
-        query: typeof defaultTemplates;
-        queryKey: typeof QueryKey.templates;
-        queryOptions: typeof QueryOptions$1.templates;
-        queryImports: typeof QueryImports.templates;
-    };
-};
-
-type Templates = {
-    operations?: typeof Operations.templates | false;
-    mutation?: typeof Mutation.templates | false;
-    query?: typeof Query$1.templates | false;
-    queryOptions?: typeof QueryOptions$1.templates | false;
-    queryKey?: typeof QueryKey.templates | false;
-};
-type Suspense = object;
-type Query = {
-    /**
-     * Customize the queryKey, here you can specify a suffix.
-     */
-    queryKey: (key: unknown[]) => unknown[];
-    /**
-     * Define which HttpMethods can be used for queries
-     * @default ['get']
-     */
-    methods: Array<HttpMethod>;
-    /**
-     * Path to the useQuery that will be used to do the useQuery functionality.
-     * It will be used as `import { useQuery } from '${importPath}'`.
-     * It allows both relative and absolute path.
-     * the path will be applied as is, so relative path should be based on the file being generated.
-     * @default '@tanstack/react-query'
-     */
-    importPath?: string;
-};
-type QueryOptions = object;
-type Mutate = {
-    /**
-     * Define the way of passing through the queryParams, headerParams and data.
-     * @default `'hook'`
-     */
-    variablesType: 'mutate' | 'hook';
-    /**
-     * Define which HttpMethods can be used for mutations
-     * @default ['post', 'put', 'delete']
-     */
-    methods: Array<HttpMethod>;
-    /**
-     * Path to the useQuery that will be used to do the useQuery functionality.
-     * It will be used as `import { useQuery } from '${importPath}'`.
-     * It allows both relative and absolute path.
-     * the path will be applied as is, so relative path should be based on the file being generated.
-     * @default '@tanstack/react-query'
-     */
-    importPath?: string;
-};
-type Infinite = {
-    /**
-     * Specify the params key used for `pageParam`.
-     * Used inside `useInfiniteQuery`, `createInfiniteQueries`, `createInfiniteQuery`
-     * @default `'id'`
-     */
-    queryParam: string;
-    /**
-     * Which field of the data will be used, set it to undefined when no cursor is known.
-     */
-    cursorParam?: string | undefined;
-    /**
-     * The initial value, the value of the first page.
-     * @default `0`
-     */
-    initialPageParam: unknown;
-};
-type Options = {
-    output?: {
-        /**
-         * Output to save the @tanstack/query hooks.
-         * @default `"hooks"`
-         */
-        path: string;
-        /**
-         * Name to be used for the `export * as {{exportAs}} from './'`
-         */
-        exportAs?: string;
-        /**
-         * Add an extension to the generated imports and exports, default it will not use an extension
-         */
-        extName?: KubbFile.Extname;
-        /**
-         * Define what needs to exported, here you can also disable the export of barrel files
-         * @default `'barrel'`
-         */
-        exportType?: 'barrel' | 'barrelNamed' | false;
-    };
-    /**
-     * Group the @tanstack/query hooks based on the provided name.
-     */
-    group?: {
-        /**
-         * Tag will group based on the operation tag inside the Swagger file
-         */
-        type: 'tag';
-        /**
-         * Relative path to save the grouped @tanstack/query hooks.
-         *
-         * `{{tag}}` will be replaced by the current tagName.
-         * @example `${output}/{{tag}}Controller` => `hooks/PetController`
-         * @default `${output}/{{tag}}Controller`
-         */
-        output?: string;
-        /**
-         * Name to be used for the `export * as {{exportAs}} from './`
-         * @default `"{{tag}}Hooks"`
-         */
-        exportAs?: string;
-    };
-    client?: {
-        /**
-         * Path to the client that will be used to do the API calls.
-         * It will be used as `import client from '${client.importPath}'`.
-         * It allows both relative and absolute path.
-         * the path will be applied as is, so relative path should be based on the file being generated.
-         * @default '@kubb/plugin-client/client'
-         */
-        importPath?: string;
-    };
-    /**
-     * ReturnType that needs to be used when calling client().
-     *
-     * `Data` will return ResponseConfig[data].
-     *
-     * `Full` will return ResponseConfig.
-     * @default `'data'`
-     * @private
-     */
-    /**
-     * ReturnType that needs to be used when calling client().
-     *
-     * `Data` will return ResponseConfig[data].
-     *
-     * `Full` will return ResponseConfig.
-     * @default `'data'`
-     * @private
-     */
-    dataReturnType?: 'data' | 'full';
-    /**
-     * How to pass your pathParams.
-     *
-     * `object` will return the pathParams as an object.
-     *
-     * `inline` will return the pathParams as comma separated params.
-     * @default `'inline'`
-     * @private
-     */
-    pathParamsType?: 'object' | 'inline';
-    /**
-     * Which parser can be used before returning the data to `@tanstack/query`.
-     * `'zod'` will use `@kubb/plugin-zod` to parse the data.
-     */
-    parser?: 'zod';
-    /**
-     * Array containing exclude parameters to exclude/skip tags/operations/methods/paths.
-     */
-    exclude?: Array<Exclude>;
-    /**
-     * Array containing include parameters to include tags/operations/methods/paths.
-     */
-    include?: Array<Include>;
-    /**
-     * Array containing override parameters to override `options` based on tags/operations/methods/paths.
-     */
-    override?: Array<Override<ResolvedOptions>>;
-    /**
-     * When set, an infiniteQuery hooks will be added.
-     */
-    infinite?: Partial<Infinite> | false;
-    /**
-     * When set, a suspenseQuery hooks will be added.
-     */
-    suspense?: Partial<Suspense> | false;
-    /**
-     * Override some useQuery behaviours.
-     */
-    query?: Partial<Query> | false;
-    queryOptions?: Partial<QueryOptions> | false;
-    /**
-     * Override some useMutation behaviours.
-     */
-    mutate?: Mutate | false;
-    transformers?: {
-        /**
-         * Customize the names based on the type that is provided by the plugin.
-         */
-        name?: (name: ResolveNameParams['name'], type?: ResolveNameParams['type']) => string;
-    };
-    /**
-     * Make it possible to override one of the templates
-     */
-    templates?: Partial<Templates>;
-};
-type ResolvedOptions = {
-    client: Required<NonNullable<PluginReactQuery['options']['client']>>;
-    dataReturnType: NonNullable<PluginReactQuery['options']['dataReturnType']>;
-    pathParamsType: NonNullable<PluginReactQuery['options']['pathParamsType']>;
-    parser: PluginReactQuery['options']['parser'];
-    /**
-     * Only used of infinite
-     */
-    infinite: Infinite | false;
-    suspense: Suspense | false;
-    query: Query | false;
-    queryOptions: QueryOptions | false;
-    mutate: Mutate | false;
-    templates: NonNullable<Templates>;
-};
-type PluginReactQuery = PluginFactoryOptions<'plugin-react-query', Options, ResolvedOptions, never, ResolvePathOptions>;
-
-export { Mutation as M, type Options as O, type PluginReactQuery as P, Query$1 as Q, Operations as a, QueryKey as b, QueryOptions$1 as c };