@qualisero/openapi-endpoint 0.12.3 → 0.14.0

package/dist/index.d.ts

@@ -1,214 +1,10 @@
-import type { MaybeRefOrGetter } from 'vue';
-import { EndpointQueryReturn } from './openapi-query';
-import { EndpointMutationReturn } from './openapi-mutation';
-import { Operations, GetPathParameters, OpenApiConfig, QQueryOptions, QMutationOptions, IsQueryOperation } from './types';
-export type { OpenApiConfig, OpenApiInstance, GetResponseData, QueryClientLike, GetQueryParameters, GetPathParameters, GetRequestBody, } from './types';
-export type { QQueryOptions, QMutationOptions, EndpointQueryReturn, EndpointMutationReturn, } from './types-documentation';
-export { queryClient } from './openapi-helpers';
-/** @internal */
-export { type useEndpointQuery } from './openapi-query';
-/** @internal */
-export { type useEndpointMutation } from './openapi-mutation';
-/**
- * Creates a type-safe OpenAPI client for Vue applications.
- *
- * This is the main entry point for the library. It provides reactive composables
- * for API operations with full TypeScript type safety based on your OpenAPI specification.
- *
- * @group Setup
- * @template Ops - The operations type, typically generated from your OpenAPI spec
- * @param config - Configuration object containing operations metadata and axios instance
- * @returns {OpenApiInstance<Ops>} API instance with useQuery, useMutation, useEndpoint, and debug methods
- *
- * @example
- * ```typescript
- * import { useOpenApi } from '@qualisero/openapi-endpoint'
- * // See documentation on how to generate types and operations automatically:
- * import { openApiOperations, type OpenApiOperations } from './generated/api-operations'
- * import axios from 'axios'
- *
- * const api = useOpenApi<OpenApiOperations>({
- *   operations: openApiOperations,
- *   axios: axios.create({ baseURL: 'https://api.example.com' })
- * })
- *
- * // Use in components
- * const { data, isLoading } = api.useQuery('listPets', {})
- * const createPet = api.useMutation('createPet', {})
- * ```
- */
-export declare function useOpenApi<Ops extends Operations<Ops>>(config: OpenApiConfig<Ops>): {
-    /**
-     * Debug utility to inspect operation metadata.
-     *
-     * @param operationId - The operation ID to debug
-     * @returns Information about whether the operation is a query operation
-     */
-    _debugIsQueryOperation: <Op extends keyof Ops>(operationId: Op) => IsQueryOperation<Ops, Op>;
-    /**
-     * Creates a reactive query for GET operations.
-     *
-     * This composable wraps TanStack Query for read-only operations with automatic
-     * type inference, caching, and reactive updates.
-     *
-     * @template Op - The operation key from your operations type
-     * @param operationId - Operation ID (must be a GET operation)
-     * @param pathParamsOrOptions - Path parameters or query options
-     * @param optionsOrNull - Additional query options when path params are provided
-     * @returns Reactive query result with data, loading state, error handling, etc.
-     *
-     * @example
-     * ```typescript
-     * // Query without path parameters
-     * const { data: pets, isLoading } = api.useQuery(OperationId.listPets, {
-     *   enabled: true,
-     *   onLoad: (data) => console.log('Loaded:', data)
-     * })
-     *
-     * // Query with path parameters
-     * const { data: pet } = api.useQuery(OperationId.getPet, { petId: '123' }, {
-     *   enabled: computed(() => Boolean(petId.value))
-     * })
-     * ```
-     */
-    useQuery: <Op extends keyof Ops>(operationId: IsQueryOperation<Ops, Op> extends true ? Op : never, pathParamsOrOptions?: GetPathParameters<Ops, Op> extends Record<string, never> ? QQueryOptions<Ops, Op> : MaybeRefOrGetter<GetPathParameters<Ops, Op> | null | undefined> | QQueryOptions<Ops, Op>, optionsOrNull?: QQueryOptions<Ops, Op>) => EndpointQueryReturn<Ops, Op>;
-    /**
-     * Creates a reactive mutation for POST/PUT/PATCH/DELETE operations.
-     *
-     * This composable wraps TanStack Query's useMutation for data-modifying operations
-     * with automatic cache invalidation and optimistic updates.
-     *
-     * @template Op - The operation key from your operations type
-     * @param operationId - Operation ID (must be a mutation operation)
-     * @param pathParamsOrOptions - Path parameters or mutation options
-     * @param optionsOrNull - Additional mutation options when path params are provided
-     * @returns Reactive mutation result with mutate, mutateAsync, status, etc.
-     *
-     * @example
-     * ```typescript
-     * // Mutation without path parameters
-     * const createPet = api.useMutation(OperationId.createPet, {
-     *   onSuccess: (data) => console.log('Created:', data),
-     *   onError: (error) => console.error('Failed:', error)
-     * })
-     *
-     * // Mutation with path parameters
-     * const updatePet = api.useMutation(OperationId.updatePet, { petId: '123' }, {
-     *   onSuccess: async () => {
-     *     // Automatically invalidates related queries
-     *   }
-     * })
-     *
-     * // Execute the mutation
-     * await createPet.mutateAsync({ data: { name: 'Fluffy' } })
-     * ```
-     */
-    useMutation: <Op extends keyof Ops>(operationId: IsQueryOperation<Ops, Op> extends false ? Op : never, pathParamsOrOptions?: GetPathParameters<Ops, Op> extends Record<string, never> ? QMutationOptions<Ops, Op> : MaybeRefOrGetter<GetPathParameters<Ops, Op> | null | undefined> | QMutationOptions<Ops, Op>, optionsOrNull?: QMutationOptions<Ops, Op>) => {
-        data: import("vue").ComputedRef<import("axios").AxiosResponse<import("./types").GetResponseData<Ops, Op>, any, {}> | undefined>;
-        isEnabled: import("vue").ComputedRef<boolean>;
-        extraPathParams: import("vue").Ref<GetPathParameters<Ops, Op>, GetPathParameters<Ops, Op>>;
-        pathParams: import("vue").ComputedRef<GetPathParameters<Ops, Op>>;
-        context: import("vue").Ref<unknown, unknown>;
-        error: import("vue").Ref<null, null>;
-        isError: import("vue").Ref<false, false>;
-        isPending: import("vue").Ref<false, false>;
-        isSuccess: import("vue").Ref<false, false>;
-        status: import("vue").Ref<"idle", "idle">;
-        failureCount: import("vue").Ref<number, number>;
-        failureReason: import("vue").Ref<Error | null, Error | null>;
-        isPaused: import("vue").Ref<boolean, boolean>;
-        variables: import("vue").Ref<undefined, undefined>;
-        isIdle: import("vue").Ref<true, true>;
-        submittedAt: import("vue").Ref<number, number>;
-        mutate: (variables: import("./types").GetRequestBody<Ops, Op> extends never ? void | import("./types").QMutationVars<Ops, Op> : import("./types").QMutationVars<Ops, Op>, options?: import("@tanstack/query-core").MutateOptions<import("axios").AxiosResponse<any, any, {}>, Error, import("./types").GetRequestBody<Ops, Op> extends never ? void | import("./types").QMutationVars<Ops, Op> : import("./types").QMutationVars<Ops, Op>, unknown> | undefined) => void;
-        mutateAsync: import("@tanstack/query-core").MutateFunction<import("axios").AxiosResponse<any, any, {}>, Error, import("./types").GetRequestBody<Ops, Op> extends never ? void | import("./types").QMutationVars<Ops, Op> : import("./types").QMutationVars<Ops, Op>, unknown>;
-        reset: import("@tanstack/query-core").MutationObserverResult<TData, TError, TVariables, TOnMutateResult>["reset"];
-    } | {
-        data: import("vue").ComputedRef<import("axios").AxiosResponse<import("./types").GetResponseData<Ops, Op>, any, {}> | undefined>;
-        isEnabled: import("vue").ComputedRef<boolean>;
-        extraPathParams: import("vue").Ref<GetPathParameters<Ops, Op>, GetPathParameters<Ops, Op>>;
-        pathParams: import("vue").ComputedRef<GetPathParameters<Ops, Op>>;
-        context: import("vue").Ref<unknown, unknown>;
-        error: import("vue").Ref<null, null>;
-        isError: import("vue").Ref<false, false>;
-        isPending: import("vue").Ref<true, true>;
-        isSuccess: import("vue").Ref<false, false>;
-        status: import("vue").Ref<"pending", "pending">;
-        failureCount: import("vue").Ref<number, number>;
-        failureReason: import("vue").Ref<Error | null, Error | null>;
-        isPaused: import("vue").Ref<boolean, boolean>;
-        variables: import("@vue/shared").IfAny<import("./types").GetRequestBody<Ops, Op> extends never ? void | import("./types").QMutationVars<Ops, Op> : import("./types").QMutationVars<Ops, Op>, import("vue").Ref<import("./types").GetRequestBody<Ops, Op> extends never ? void | import("./types").QMutationVars<Ops, Op> : import("./types").QMutationVars<Ops, Op>, import("./types").GetRequestBody<Ops, Op> extends never ? void | import("./types").QMutationVars<Ops, Op> : import("./types").QMutationVars<Ops, Op>>, [import("./types").GetRequestBody<Ops, Op> extends never ? void | import("./types").QMutationVars<Ops, Op> : import("./types").QMutationVars<Ops, Op>] extends [import("vue").Ref<any, any>] ? import("vue").Ref<any, any> & (import("./types").GetRequestBody<Ops, Op> extends never ? void | import("./types").QMutationVars<Ops, Op> : import("./types").QMutationVars<Ops, Op>) : import("vue").Ref<import("./types").GetRequestBody<Ops, Op> extends never ? void | import("./types").QMutationVars<Ops, Op> : import("./types").QMutationVars<Ops, Op>, import("./types").GetRequestBody<Ops, Op> extends never ? void | import("./types").QMutationVars<Ops, Op> : import("./types").QMutationVars<Ops, Op>>>;
-        isIdle: import("vue").Ref<false, false>;
-        submittedAt: import("vue").Ref<number, number>;
-        mutate: (variables: import("./types").GetRequestBody<Ops, Op> extends never ? void | import("./types").QMutationVars<Ops, Op> : import("./types").QMutationVars<Ops, Op>, options?: import("@tanstack/query-core").MutateOptions<import("axios").AxiosResponse<any, any, {}>, Error, import("./types").GetRequestBody<Ops, Op> extends never ? void | import("./types").QMutationVars<Ops, Op> : import("./types").QMutationVars<Ops, Op>, unknown> | undefined) => void;
-        mutateAsync: import("@tanstack/query-core").MutateFunction<import("axios").AxiosResponse<any, any, {}>, Error, import("./types").GetRequestBody<Ops, Op> extends never ? void | import("./types").QMutationVars<Ops, Op> : import("./types").QMutationVars<Ops, Op>, unknown>;
-        reset: import("@tanstack/query-core").MutationObserverResult<TData, TError, TVariables, TOnMutateResult>["reset"];
-    } | {
-        data: import("vue").ComputedRef<import("axios").AxiosResponse<import("./types").GetResponseData<Ops, Op>, any, {}> | undefined>;
-        isEnabled: import("vue").ComputedRef<boolean>;
-        extraPathParams: import("vue").Ref<GetPathParameters<Ops, Op>, GetPathParameters<Ops, Op>>;
-        pathParams: import("vue").ComputedRef<GetPathParameters<Ops, Op>>;
-        context: import("vue").Ref<unknown, unknown>;
-        error: import("vue").Ref<Error, Error>;
-        isError: import("vue").Ref<true, true>;
-        isPending: import("vue").Ref<false, false>;
-        isSuccess: import("vue").Ref<false, false>;
-        status: import("vue").Ref<"error", "error">;
-        failureCount: import("vue").Ref<number, number>;
-        failureReason: import("vue").Ref<Error | null, Error | null>;
-        isPaused: import("vue").Ref<boolean, boolean>;
-        variables: import("@vue/shared").IfAny<import("./types").GetRequestBody<Ops, Op> extends never ? void | import("./types").QMutationVars<Ops, Op> : import("./types").QMutationVars<Ops, Op>, import("vue").Ref<import("./types").GetRequestBody<Ops, Op> extends never ? void | import("./types").QMutationVars<Ops, Op> : import("./types").QMutationVars<Ops, Op>, import("./types").GetRequestBody<Ops, Op> extends never ? void | import("./types").QMutationVars<Ops, Op> : import("./types").QMutationVars<Ops, Op>>, [import("./types").GetRequestBody<Ops, Op> extends never ? void | import("./types").QMutationVars<Ops, Op> : import("./types").QMutationVars<Ops, Op>] extends [import("vue").Ref<any, any>] ? import("vue").Ref<any, any> & (import("./types").GetRequestBody<Ops, Op> extends never ? void | import("./types").QMutationVars<Ops, Op> : import("./types").QMutationVars<Ops, Op>) : import("vue").Ref<import("./types").GetRequestBody<Ops, Op> extends never ? void | import("./types").QMutationVars<Ops, Op> : import("./types").QMutationVars<Ops, Op>, import("./types").GetRequestBody<Ops, Op> extends never ? void | import("./types").QMutationVars<Ops, Op> : import("./types").QMutationVars<Ops, Op>>>;
-        isIdle: import("vue").Ref<false, false>;
-        submittedAt: import("vue").Ref<number, number>;
-        mutate: (variables: import("./types").GetRequestBody<Ops, Op> extends never ? void | import("./types").QMutationVars<Ops, Op> : import("./types").QMutationVars<Ops, Op>, options?: import("@tanstack/query-core").MutateOptions<import("axios").AxiosResponse<any, any, {}>, Error, import("./types").GetRequestBody<Ops, Op> extends never ? void | import("./types").QMutationVars<Ops, Op> : import("./types").QMutationVars<Ops, Op>, unknown> | undefined) => void;
-        mutateAsync: import("@tanstack/query-core").MutateFunction<import("axios").AxiosResponse<any, any, {}>, Error, import("./types").GetRequestBody<Ops, Op> extends never ? void | import("./types").QMutationVars<Ops, Op> : import("./types").QMutationVars<Ops, Op>, unknown>;
-        reset: import("@tanstack/query-core").MutationObserverResult<TData, TError, TVariables, TOnMutateResult>["reset"];
-    } | {
-        data: import("vue").ComputedRef<import("axios").AxiosResponse<import("./types").GetResponseData<Ops, Op>, any, {}> | undefined>;
-        isEnabled: import("vue").ComputedRef<boolean>;
-        extraPathParams: import("vue").Ref<GetPathParameters<Ops, Op>, GetPathParameters<Ops, Op>>;
-        pathParams: import("vue").ComputedRef<GetPathParameters<Ops, Op>>;
-        context: import("vue").Ref<unknown, unknown>;
-        error: import("vue").Ref<null, null>;
-        isError: import("vue").Ref<false, false>;
-        isPending: import("vue").Ref<false, false>;
-        isSuccess: import("vue").Ref<true, true>;
-        status: import("vue").Ref<"success", "success">;
-        failureCount: import("vue").Ref<number, number>;
-        failureReason: import("vue").Ref<Error | null, Error | null>;
-        isPaused: import("vue").Ref<boolean, boolean>;
-        variables: import("@vue/shared").IfAny<import("./types").GetRequestBody<Ops, Op> extends never ? void | import("./types").QMutationVars<Ops, Op> : import("./types").QMutationVars<Ops, Op>, import("vue").Ref<import("./types").GetRequestBody<Ops, Op> extends never ? void | import("./types").QMutationVars<Ops, Op> : import("./types").QMutationVars<Ops, Op>, import("./types").GetRequestBody<Ops, Op> extends never ? void | import("./types").QMutationVars<Ops, Op> : import("./types").QMutationVars<Ops, Op>>, [import("./types").GetRequestBody<Ops, Op> extends never ? void | import("./types").QMutationVars<Ops, Op> : import("./types").QMutationVars<Ops, Op>] extends [import("vue").Ref<any, any>] ? import("vue").Ref<any, any> & (import("./types").GetRequestBody<Ops, Op> extends never ? void | import("./types").QMutationVars<Ops, Op> : import("./types").QMutationVars<Ops, Op>) : import("vue").Ref<import("./types").GetRequestBody<Ops, Op> extends never ? void | import("./types").QMutationVars<Ops, Op> : import("./types").QMutationVars<Ops, Op>, import("./types").GetRequestBody<Ops, Op> extends never ? void | import("./types").QMutationVars<Ops, Op> : import("./types").QMutationVars<Ops, Op>>>;
-        isIdle: import("vue").Ref<false, false>;
-        submittedAt: import("vue").Ref<number, number>;
-        mutate: (variables: import("./types").GetRequestBody<Ops, Op> extends never ? void | import("./types").QMutationVars<Ops, Op> : import("./types").QMutationVars<Ops, Op>, options?: import("@tanstack/query-core").MutateOptions<import("axios").AxiosResponse<any, any, {}>, Error, import("./types").GetRequestBody<Ops, Op> extends never ? void | import("./types").QMutationVars<Ops, Op> : import("./types").QMutationVars<Ops, Op>, unknown> | undefined) => void;
-        mutateAsync: import("@tanstack/query-core").MutateFunction<import("axios").AxiosResponse<any, any, {}>, Error, import("./types").GetRequestBody<Ops, Op> extends never ? void | import("./types").QMutationVars<Ops, Op> : import("./types").QMutationVars<Ops, Op>, unknown>;
-        reset: import("@tanstack/query-core").MutationObserverResult<TData, TError, TVariables, TOnMutateResult>["reset"];
-    };
-    /**
-     * Generic endpoint composable that automatically detects operation type.
-     *
-     * This is a universal composable that returns either a query or mutation based
-     * on the operation's HTTP method. Use this when you want unified handling.
-     *
-     * @template Op - The operation key from your operations type
-     * @param operationId - Any operation ID
-     * @param pathParamsOrOptions - Path parameters or operation options
-     * @param optionsOrNull - Additional options when path params are provided
-     * @returns Query result for GET operations, mutation result for others
-     *
-     * @example
-     * ```typescript
-     * // Automatically becomes a query for GET operations
-     * const listEndpoint = api.useEndpoint(OperationId.listPets)
-     *
-     * // Automatically becomes a mutation for POST operations
-     * const createEndpoint = api.useEndpoint(OperationId.createPet)
-     *
-     * // TypeScript knows the correct return type based on the operation
-     * const data = listEndpoint.data // Query data
-     * await createEndpoint.mutateAsync({ data: petData }) // Mutation execution
-     * ```
-     */
-    useEndpoint: <Op extends keyof Ops>(operationId: Op, pathParamsOrOptions?: GetPathParameters<Ops, Op> extends Record<string, never> ? IsQueryOperation<Ops, Op> extends true ? QQueryOptions<Ops, Op> : QMutationOptions<Ops, Op> : MaybeRefOrGetter<GetPathParameters<Ops, Op> | null | undefined> | (IsQueryOperation<Ops, Op> extends true ? QQueryOptions<Ops, Op> : QMutationOptions<Ops, Op>), optionsOrNull?: IsQueryOperation<Ops, Op> extends true ? QQueryOptions<Ops, Op> : QMutationOptions<Ops, Op>) => IsQueryOperation<Ops, Op> extends true ? EndpointQueryReturn<Ops, Op> : EndpointMutationReturn<Ops, Op>;
-};
+export { useEndpointQuery } from './openapi-query';
+export { useEndpointMutation } from './openapi-mutation';
+export { defaultQueryClient } from './openapi-helpers';
+export type { QueryReturn } from './openapi-query';
+export type { MutationReturn } from './openapi-mutation';
+export type { EndpointConfig, QueryOptions, MutationOptions, MutationVars, CacheInvalidationOptions, Refetchable, MutateFn, MutateAsyncFn, MutateAsyncReturn, ReactiveOr, NoExcessReturn, AxiosRequestConfigExtended, QueryClientLike, ApiResponse, ApiResponseSafe, ApiRequest, ApiPathParams, ApiPathParamsInput, ApiQueryParams, } from './types';
+export { HttpMethod, QUERY_METHODS, MUTATION_METHODS, isQueryMethod, isMutationMethod } from './types';
+export type { Ref, ComputedRef } from 'vue';
+export type { MaybeRefOrGetter } from '@vue/reactivity';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAKtD,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAClD,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAKxD,YAAY,EAEV,cAAc,EAGd,YAAY,EACZ,eAAe,EACf,YAAY,EAGZ,wBAAwB,EACxB,WAAW,EAGX,QAAQ,EACR,aAAa,EACb,iBAAiB,EAGjB,UAAU,EACV,cAAc,EAGd,0BAA0B,EAG1B,eAAe,EAGf,WAAW,EACX,eAAe,EACf,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,cAAc,GACf,MAAM,SAAS,CAAA;AAKhB,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,gBAAgB,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAKtG,YAAY,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,KAAK,CAAA;AAC3C,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/index.js

@@ -1,143 +1,10 @@
-import { useEndpoint } from './openapi-endpoint.js';
-import { useEndpointQuery } from './openapi-query.js';
-import { useEndpointMutation } from './openapi-mutation.js';
-import { getHelpers } from './openapi-helpers.js';
-export { queryClient } from './openapi-helpers.js';
-/**
- * Creates a type-safe OpenAPI client for Vue applications.
- *
- * This is the main entry point for the library. It provides reactive composables
- * for API operations with full TypeScript type safety based on your OpenAPI specification.
- *
- * @group Setup
- * @template Ops - The operations type, typically generated from your OpenAPI spec
- * @param config - Configuration object containing operations metadata and axios instance
- * @returns {OpenApiInstance<Ops>} API instance with useQuery, useMutation, useEndpoint, and debug methods
- *
- * @example
- * ```typescript
- * import { useOpenApi } from '@qualisero/openapi-endpoint'
- * // See documentation on how to generate types and operations automatically:
- * import { openApiOperations, type OpenApiOperations } from './generated/api-operations'
- * import axios from 'axios'
- *
- * const api = useOpenApi<OpenApiOperations>({
- *   operations: openApiOperations,
- *   axios: axios.create({ baseURL: 'https://api.example.com' })
- * })
- *
- * // Use in components
- * const { data, isLoading } = api.useQuery('listPets', {})
- * const createPet = api.useMutation('createPet', {})
- * ```
- */
-export function useOpenApi(config) {
-    return {
-        /**
-         * Debug utility to inspect operation metadata.
-         *
-         * @param operationId - The operation ID to debug
-         * @returns Information about whether the operation is a query operation
-         */
-        _debugIsQueryOperation: function (operationId) {
-            const helpers = getHelpers(config);
-            const info = helpers.getOperationInfo(operationId);
-            console.log('Operation Info:', info);
-            return {};
-        },
-        /**
-         * Creates a reactive query for GET operations.
-         *
-         * This composable wraps TanStack Query for read-only operations with automatic
-         * type inference, caching, and reactive updates.
-         *
-         * @template Op - The operation key from your operations type
-         * @param operationId - Operation ID (must be a GET operation)
-         * @param pathParamsOrOptions - Path parameters or query options
-         * @param optionsOrNull - Additional query options when path params are provided
-         * @returns Reactive query result with data, loading state, error handling, etc.
-         *
-         * @example
-         * ```typescript
-         * // Query without path parameters
-         * const { data: pets, isLoading } = api.useQuery(OperationId.listPets, {
-         *   enabled: true,
-         *   onLoad: (data) => console.log('Loaded:', data)
-         * })
-         *
-         * // Query with path parameters
-         * const { data: pet } = api.useQuery(OperationId.getPet, { petId: '123' }, {
-         *   enabled: computed(() => Boolean(petId.value))
-         * })
-         * ```
-         */
-        useQuery: function (operationId, pathParamsOrOptions, optionsOrNull) {
-            const helpers = getHelpers(config);
-            return useEndpointQuery(operationId, helpers, pathParamsOrOptions, optionsOrNull);
-        },
-        /**
-         * Creates a reactive mutation for POST/PUT/PATCH/DELETE operations.
-         *
-         * This composable wraps TanStack Query's useMutation for data-modifying operations
-         * with automatic cache invalidation and optimistic updates.
-         *
-         * @template Op - The operation key from your operations type
-         * @param operationId - Operation ID (must be a mutation operation)
-         * @param pathParamsOrOptions - Path parameters or mutation options
-         * @param optionsOrNull - Additional mutation options when path params are provided
-         * @returns Reactive mutation result with mutate, mutateAsync, status, etc.
-         *
-         * @example
-         * ```typescript
-         * // Mutation without path parameters
-         * const createPet = api.useMutation(OperationId.createPet, {
-         *   onSuccess: (data) => console.log('Created:', data),
-         *   onError: (error) => console.error('Failed:', error)
-         * })
-         *
-         * // Mutation with path parameters
-         * const updatePet = api.useMutation(OperationId.updatePet, { petId: '123' }, {
-         *   onSuccess: async () => {
-         *     // Automatically invalidates related queries
-         *   }
-         * })
-         *
-         * // Execute the mutation
-         * await createPet.mutateAsync({ data: { name: 'Fluffy' } })
-         * ```
-         */
-        useMutation: function (operationId, pathParamsOrOptions, optionsOrNull) {
-            const helpers = getHelpers(config);
-            return useEndpointMutation(operationId, helpers, pathParamsOrOptions, optionsOrNull);
-        },
-        /**
-         * Generic endpoint composable that automatically detects operation type.
-         *
-         * This is a universal composable that returns either a query or mutation based
-         * on the operation's HTTP method. Use this when you want unified handling.
-         *
-         * @template Op - The operation key from your operations type
-         * @param operationId - Any operation ID
-         * @param pathParamsOrOptions - Path parameters or operation options
-         * @param optionsOrNull - Additional options when path params are provided
-         * @returns Query result for GET operations, mutation result for others
-         *
-         * @example
-         * ```typescript
-         * // Automatically becomes a query for GET operations
-         * const listEndpoint = api.useEndpoint(OperationId.listPets)
-         *
-         * // Automatically becomes a mutation for POST operations
-         * const createEndpoint = api.useEndpoint(OperationId.createPet)
-         *
-         * // TypeScript knows the correct return type based on the operation
-         * const data = listEndpoint.data // Query data
-         * await createEndpoint.mutateAsync({ data: petData }) // Mutation execution
-         * ```
-         */
-        useEndpoint: function (operationId, pathParamsOrOptions, optionsOrNull) {
-            const helpers = getHelpers(config);
-            return useEndpoint(operationId, helpers, pathParamsOrOptions, optionsOrNull);
-        },
-    };
-}
+// ============================================================================
+// Core primitives (called by generated api-client.ts)
+// ============================================================================
+export { useEndpointQuery } from './openapi-query.js';
+export { useEndpointMutation } from './openapi-mutation.js';
+export { defaultQueryClient } from './openapi-helpers.js';
+// ============================================================================
+// HTTP method utilities
+// ============================================================================
+export { HttpMethod, QUERY_METHODS, MUTATION_METHODS, isQueryMethod, isMutationMethod } from './types.js';

package/dist/openapi-helpers.d.ts

@@ -1,20 +1,7 @@
-import { type OperationInfo, OpenApiConfig, Operations, QueryClientLike } from './types';
+import type { QueryClientLike } from './types';
 /**
- * Default QueryClient instance with pre-configured options.
- *
- * This client is used by default when no custom QueryClient is provided to useOpenApi.
- * It includes sensible defaults like 5-minute stale time for queries.
+ * Default QueryClient with sensible defaults (5-minute stale time).
+ * Used when no custom QueryClient is provided to the generated `createApiClient`.
  */
-declare const defaultQueryClient: QueryClientLike;
-export declare function getHelpers<Ops extends Operations<Ops>, Op extends keyof Ops>(config: OpenApiConfig<Ops>): {
-    getOperationInfo: (operationId: Op) => OperationInfo;
-    getListOperationPath: (operationId: Op) => string | null;
-    getCrudListPathPrefix: (operationId: Op) => string | null;
-    isQueryOperation: (operationId: Op) => boolean;
-    isMutationOperation: (operationId: Op) => boolean;
-    axios: import("axios").AxiosInstance;
-    queryClient: QueryClientLike;
-};
-export type OpenApiHelpers<Ops extends Operations<Ops>, Op extends keyof Ops> = ReturnType<typeof getHelpers<Ops, Op>>;
-export { defaultQueryClient as queryClient };
+export declare const defaultQueryClient: QueryClientLike;
 //# sourceMappingURL=openapi-helpers.d.ts.map

package/dist/openapi-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openapi-helpers.d.ts","sourceRoot":"","sources":["../src/openapi-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAGpG;;;;;GAKG;AACH,QAAA,MAAM,kBAAkB,EAAE,eAIxB,CAAA;AAiBF,wBAAgB,UAAU,CAAC,GAAG,SAAS,UAAU,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,MAAM,GAAG,EAAE,MAAM,EAAE,aAAa,CAAC,GAAG,CAAC;oCAE/D,EAAE,KAAG,aAAa;wCAMd,EAAE,KAAG,MAAM,GAAG,IAAI;yCAiCjB,EAAE,KAAG,MAAM,GAAG,IAAI;oCAevB,EAAE,KAAG,OAAO;uCAMT,EAAE,KAAG,OAAO;;;EAcvD;AAED,MAAM,MAAM,cAAc,CAAC,GAAG,SAAS,UAAU,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,MAAM,GAAG,IAAI,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAA;AAEtH,OAAO,EAAE,kBAAkB,IAAI,WAAW,EAAE,CAAA"}
+{"version":3,"file":"openapi-helpers.d.ts","sourceRoot":"","sources":["../src/openapi-helpers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,eAI/B,CAAA"}

package/dist/openapi-helpers.js

@@ -1,100 +1,10 @@
-import { HttpMethod } from './types.js';
 import { QueryClient } from '@tanstack/vue-query';
 /**
- * Default QueryClient instance with pre-configured options.
- *
- * This client is used by default when no custom QueryClient is provided to useOpenApi.
- * It includes sensible defaults like 5-minute stale time for queries.
+ * Default QueryClient with sensible defaults (5-minute stale time).
+ * Used when no custom QueryClient is provided to the generated `createApiClient`.
  */
-const defaultQueryClient = new QueryClient({
+export const defaultQueryClient = new QueryClient({
     defaultOptions: {
         queries: { staleTime: 1000 * 60 * 5 },
     },
 });
-// Helper returning the operationId prefix given an http method
-function getMethodPrefix(method) {
-    const METHOD_PREFIXES = {
-        [HttpMethod.GET]: 'get', // or 'list' depending on the operationId
-        [HttpMethod.POST]: 'create',
-        [HttpMethod.PUT]: 'update',
-        [HttpMethod.PATCH]: 'update',
-        [HttpMethod.DELETE]: 'delete',
-        [HttpMethod.HEAD]: null,
-        [HttpMethod.OPTIONS]: null,
-        [HttpMethod.TRACE]: null,
-    };
-    return METHOD_PREFIXES[method];
-}
-export function getHelpers(config) {
-    // Helper function to get operation info by ID
-    function getOperationInfo(operationId) {
-        return config.operations[operationId];
-    }
-    // Helper to return a url path for matching list endpoint (e.g. /items/123 -> /items/)
-    // Based on operationId prefix: createItem, updateItem -> listItems
-    function getListOperationPath(operationId) {
-        const opInfo = getOperationInfo(operationId);
-        const operationIdStr = operationId;
-        const operationPrefix = opInfo ? getMethodPrefix(opInfo.method) : null;
-        // Make sure operationId matches `<operationPrefix><upercase resourceName>` pattern
-        if (!operationPrefix || !/^[A-Z]/.test(operationIdStr.charAt(operationPrefix.length)))
-            // If not, fallback to CRUD heuristic
-            return getCrudListPathPrefix(operationId);
-        const resourceName = operationIdStr.substring(operationPrefix.length);
-        const listOperationId = `list${resourceName}`;
-        let listOperationInfo = getOperationInfo(listOperationId);
-        if (!listOperationInfo) {
-            // Try pluralizing the resource name (simple heuristic)
-            let pluralResourceName = resourceName;
-            const addEsSuffixes = ['s', 'x', 'z', 'ch', 'sh', 'o'];
-            if (resourceName.endsWith('y')) {
-                pluralResourceName = resourceName.slice(0, -1) + 'ies';
-            }
-            else if (addEsSuffixes.some((suffix) => resourceName.endsWith(suffix))) {
-                pluralResourceName = resourceName + 'es';
-            }
-            else {
-                pluralResourceName = resourceName + 's';
-            }
-            listOperationInfo = getOperationInfo(`list${pluralResourceName}`);
-        }
-        if (listOperationInfo && listOperationInfo.method === HttpMethod.GET) {
-            return listOperationInfo.path;
-        }
-        return null;
-    }
-    // Fallback to return a url path prefix matching list endpoint (e.g. /items/123 -> /items/)
-    // based on Assumes standard CRUD Restful patterns.
-    function getCrudListPathPrefix(operationId) {
-        const { path } = getOperationInfo(operationId);
-        // for PUT/PATCH/DELETE, strip last segment if it's a path parameter
-        const segments = path.split('/').filter((segment) => segment.length > 0);
-        if (segments.length >= 2 && /^{[^}]+}$/.test(segments.at(-1))) {
-            return '/' + segments.slice(0, -1).join('/') + '/';
-        }
-        return null;
-    }
-    // Constants for HTTP method categorization
-    const QUERY_METHODS = [HttpMethod.GET, HttpMethod.HEAD, HttpMethod.OPTIONS];
-    const MUTATION_METHODS = [HttpMethod.POST, HttpMethod.PUT, HttpMethod.PATCH, HttpMethod.DELETE];
-    // Helper to check if an operation is a query method at runtime
-    function isQueryOperation(operationId) {
-        const { method } = getOperationInfo(operationId);
-        return QUERY_METHODS.includes(method);
-    }
-    // Helper to check if an operation is a mutation method at runtime
-    function isMutationOperation(operationId) {
-        const { method } = getOperationInfo(operationId);
-        return MUTATION_METHODS.includes(method);
-    }
-    return {
-        getOperationInfo,
-        getListOperationPath,
-        getCrudListPathPrefix,
-        isQueryOperation,
-        isMutationOperation,
-        axios: config.axios,
-        queryClient: config.queryClient || defaultQueryClient,
-    };
-}
-export { defaultQueryClient as queryClient };