@kubb/plugin-swr 5.0.0-alpha.8 → 5.0.0-beta.33

package/src/resolvers/resolverSwr.ts

@@ -0,0 +1,56 @@
+import { camelCase } from '@internals/utils'
+import { defineResolver } from '@kubb/core'
+import type { PluginSwr } from '../types.ts'
+
+function capitalize(name: string): string {
+  return `${name.charAt(0).toUpperCase()}${name.slice(1)}`
+}
+
+/**
+ * Naming convention resolver for the SWR plugin.
+ *
+ * Provides default naming helpers using camelCase for functions and file paths.
+ *
+ * @example
+ * `resolverSwr.default('list pets', 'function')  // → 'listPets'`
+ */
+export const resolverSwr = defineResolver<PluginSwr>(() => ({
+  name: 'default',
+  pluginName: 'plugin-swr',
+  default(name, type) {
+    return camelCase(name, { isFile: type === 'file' })
+  },
+  resolveName(name) {
+    return this.default(name, 'function')
+  },
+  resolvePathName(name, type) {
+    return this.default(name, type)
+  },
+  resolveQueryName(node) {
+    return `use${capitalize(this.resolveName(node.operationId))}`
+  },
+  resolveMutationName(node) {
+    return `use${capitalize(this.resolveName(node.operationId))}`
+  },
+  resolveQueryOptionsName(node) {
+    return `${this.resolveName(node.operationId)}QueryOptions`
+  },
+  resolveQueryKeyName(node) {
+    return `${this.resolveName(node.operationId)}QueryKey`
+  },
+  resolveMutationKeyName(node) {
+    return `${this.resolveName(node.operationId)}MutationKey`
+  },
+  resolveQueryKeyTypeName(node) {
+    return `${capitalize(this.resolveName(node.operationId))}QueryKey`
+  },
+  resolveMutationKeyTypeName(node) {
+    return `${capitalize(this.resolveName(node.operationId))}MutationKey`
+  },
+  resolveMutationArgTypeName(node) {
+    return `${capitalize(this.resolveName(node.operationId))}MutationArg`
+  },
+  resolveClientName(node) {
+    return this.resolveName(node.operationId)
+  },
+}))

package/src/types.ts

@@ -1,31 +1,82 @@
 import type { Transformer } from '@internals/tanstack-query'
-import type { Group, Output, PluginFactoryOptions, ResolveNameParams } from '@kubb/core'
-import type { contentType, HttpMethod, Oas } from '@kubb/oas'
+import type { ast, Exclude, Generator, Group, Include, Output, Override, PluginFactoryOptions, Resolver } from '@kubb/core'
 import type { ClientImportPath, PluginClient } from '@kubb/plugin-client'
-import type { Exclude, Include, Override, ResolvePathOptions } from '@kubb/plugin-oas'
-import type { Generator } from '@kubb/plugin-oas/generators'
 
 export type { Transformer } from '@internals/tanstack-query'
 
 /**
- * Customize the queryKey
+ * Resolver for SWR that provides naming methods for hook functions.
+ */
+export type ResolverSwr = Resolver & {
+  /**
+   * Resolves the base function name for an operation.
+   *
+   * @example Resolving base operation names
+   * `resolver.resolveName('show pet by id') // -> 'showPetById'`
+   */
+  resolveName(this: ResolverSwr, name: string): string
+  /**
+   * Resolves the output file name for a hook module.
+   */
+  resolvePathName(this: ResolverSwr, name: string, type?: 'file' | 'function' | 'type' | 'const'): string
+  /**
+   * Resolves a query hook function name.
+   */
+  resolveQueryName(this: ResolverSwr, node: ast.OperationNode): string
+  /**
+   * Resolves a mutation hook function name.
+   */
+  resolveMutationName(this: ResolverSwr, node: ast.OperationNode): string
+  /**
+   * Resolves the query options helper name.
+   */
+  resolveQueryOptionsName(this: ResolverSwr, node: ast.OperationNode): string
+  /**
+   * Resolves the query key helper name.
+   */
+  resolveQueryKeyName(this: ResolverSwr, node: ast.OperationNode): string
+  /**
+   * Resolves the mutation key helper name.
+   */
+  resolveMutationKeyName(this: ResolverSwr, node: ast.OperationNode): string
+  /**
+   * Resolves the query key type name.
+   */
+  resolveQueryKeyTypeName(this: ResolverSwr, node: ast.OperationNode): string
+  /**
+   * Resolves the mutation key type name.
+   */
+  resolveMutationKeyTypeName(this: ResolverSwr, node: ast.OperationNode): string
+  /**
+   * Resolves the mutation argument type name emitted alongside the mutation hook.
+   */
+  resolveMutationArgTypeName(this: ResolverSwr, node: ast.OperationNode): string
+  /**
+   * Resolves the client function name generated inline by query hooks.
+   */
+  resolveClientName(this: ResolverSwr, node: ast.OperationNode): string
+}
+
+/**
+ * Customize the queryKey.
  */
 type QueryKey = Transformer
 
 /**
- * Customize the mutationKey
+ * Customize the mutationKey.
  */
 type MutationKey = Transformer
 
 type Query = {
   /**
-   * Define which HttpMethods can be used for queries
+   * HTTP methods to use for queries.
+   *
    * @default ['get']
    */
-  methods?: Array<HttpMethod>
+  methods?: Array<string>
   /**
-   * Path to the useQuery hook for useQuery functionality.
-   * Used as `import { useQuery } from '${importPath}'`.
+   * Path to the useSWR hook for useSWR functionality.
+   * Used as `import useSWR from '${importPath}'`.
    * Accepts relative and absolute paths.
    * Path is used as-is; relative paths are based on the generated file location.
    * @default 'swr'
@@ -35,25 +86,19 @@ type Query = {
 
 type Mutation = {
   /**
-   * Define which HttpMethods can be used for queries
+   * HTTP methods to use for mutations.
+   *
    * @default ['post', 'put', 'delete', 'patch']
    */
-  methods?: Array<HttpMethod>
+  methods?: Array<string>
   /**
-   * Path to the useQuery hook for useQuery functionality.
-   * Used as `import { useQuery } from '${importPath}'`.
+   * Path to the useSWRMutation hook for useSWRMutation functionality.
+   * Used as `import useSWRMutation from '${importPath}'`.
    * Accepts relative and absolute paths.
    * Path is used as-is; relative paths are based on the generated file location.
    * @default 'swr/mutation'
    */
   importPath?: string
-  /**
-   * When true, mutation parameters (path params, query params, headers, body) is passed via `trigger()` instead of as hook arguments.
-   * This aligns with React Query's mutation pattern where variables are passed when triggering the mutation.
-   * @default false
-   * @deprecated This will become the default behavior in v5. Set to `true` to opt-in early.
-   */
-  paramsToTrigger?: boolean
 }
 
 export type Options = {
@@ -61,81 +106,92 @@ export type Options = {
    * Specify the export location for the files and define the behavior of the output
    * @default { path: 'hooks', barrelType: 'named' }
    */
-  output?: Output<Oas>
-  /**
-   * Define which contentType should be used.
-   * By default, the first JSON valid mediaType is used
-   */
-  contentType?: contentType
+  output?: Output
   /**
    * Group the SWR hooks based on the provided name.
    */
   group?: Group
+  client?: ClientImportPath & Pick<PluginClient['options'], 'clientType' | 'dataReturnType' | 'baseURL' | 'bundle' | 'paramsCasing'>
   /**
-   * Array containing exclude parameters to exclude/skip tags/operations/methods/paths.
+   * Tags, operations, or paths to exclude from generation.
    */
   exclude?: Array<Exclude>
   /**
-   * Array containing include parameters to include tags/operations/methods/paths.
+   * Tags, operations, or paths to include in generation.
    */
   include?: Array<Include>
   /**
-   * Array containing override parameters to override `options` based on tags/operations/methods/paths.
+   * Override options for specific tags, operations, or paths.
    */
   override?: Array<Override<ResolvedOptions>>
-  client?: ClientImportPath & Pick<PluginClient['options'], 'clientType' | 'dataReturnType' | 'baseURL' | 'bundle' | 'paramsCasing'>
-  queryKey?: QueryKey
-  query?: Query | false
-  mutationKey?: MutationKey
-  mutation?: Mutation | false
   /**
-   * How to style your params, by default no casing is applied
-   * - 'camelcase' uses camelcase for the params names
+   * Apply casing to parameter names.
    */
   paramsCasing?: 'camelcase'
   /**
-   * How to pass your params
-   * - 'object' returns the params and pathParams as an object.
-   * - 'inline' returns the params as comma separated params.
+   * How parameters are passed: grouped in an object or spread inline.
+   *
    * @default 'inline'
    */
   paramsType?: 'object' | 'inline'
   /**
-   * How to pass your pathParams.
-   * - 'object' returns the pathParams as an object.
-   * - 'inline': returns the pathParams as comma separated params.
+   * How path parameters are passed: grouped in an object or spread inline.
+   *
    * @default 'inline'
    */
   pathParamsType?: PluginClient['options']['pathParamsType']
+  queryKey?: QueryKey
+  /**
+   * Configure useSWR behavior.
+   */
+  query?: Partial<Query> | false
+  mutationKey?: MutationKey
   /**
-   * Which parser should be used before returning the data to `swr`.
-   * `'zod'` uses `@kubb/plugin-zod` to parse the data.
+   * Configure useSWRMutation behavior.
+   */
+  mutation?: Partial<Mutation> | false
+  /**
+   * Parser to use for validating response data.
    */
   parser?: PluginClient['options']['parser']
-  transformers?: {
-    /**
-     * Customize the names based on the type that is provided by the plugin.
-     */
-    name?: (name: ResolveNameParams['name'], type?: ResolveNameParams['type']) => string
-  }
   /**
-   * Define some generators next to the swr generators
+   * Override naming conventions for function names and types.
+   */
+  resolver?: Partial<ResolverSwr> & ThisType<ResolverSwr>
+  /**
+   * AST visitor to transform generated nodes.
+   */
+  transformer?: ast.Visitor
+  /**
+   * Additional generators alongside the default generators.
    */
   generators?: Array<Generator<PluginSwr>>
 }
 
 type ResolvedOptions = {
-  output: Output<Oas>
+  output: Output
+  group: Group | undefined
+  exclude: NonNullable<Options['exclude']>
+  include: Options['include']
+  override: NonNullable<Options['override']>
   client: Pick<PluginClient['options'], 'client' | 'clientType' | 'dataReturnType' | 'importPath' | 'baseURL' | 'bundle' | 'paramsCasing'>
   parser: Required<NonNullable<Options['parser']>>
+  pathParamsType: NonNullable<Options['pathParamsType']>
+  paramsCasing: Options['paramsCasing']
+  paramsType: NonNullable<Options['paramsType']>
   queryKey: QueryKey | undefined
   query: NonNullable<Required<Query>> | false
   mutationKey: MutationKey | undefined
-  mutation: (Required<Pick<Mutation, 'methods' | 'importPath'>> & Pick<Mutation, 'paramsToTrigger'>) | false
-  paramsCasing: Options['paramsCasing']
-  paramsType: NonNullable<Options['paramsType']>
-  pathParamsType: NonNullable<Options['pathParamsType']>
-  group: Options['group']
+  mutation: NonNullable<Required<Mutation>> | false
+  resolver: ResolverSwr
 }
 
-export type PluginSwr = PluginFactoryOptions<'plugin-swr', Options, ResolvedOptions, never, ResolvePathOptions>
+export type PluginSwr = PluginFactoryOptions<'plugin-swr', Options, ResolvedOptions, ResolverSwr>
+
+declare global {
+  namespace Kubb {
+    interface PluginRegistry {
+      'plugin-swr': PluginSwr
+    }
+  }
+}

package/src/utils.ts

@@ -0,0 +1,10 @@
+export {
+  buildGroupParam,
+  buildQueryKeyParams,
+  resolveHeaderGroupType,
+  resolveOperationOverrides,
+  resolvePathParamType,
+  resolveQueryGroupType,
+  resolveZodSchemaNames,
+} from '@internals/tanstack-query'
+export { buildOperationComments as getComments, buildRequestConfigType, getContentTypeInfo, resolveErrorNames, resolveStatusCodeNames } from '@internals/shared'