@navios/react-query 0.7.0 → 1.0.0-alpha.1

package/src/query/prefetch.mts

@@ -0,0 +1,326 @@
+import type {
+  FetchQueryOptions,
+  QueryClient,
+  QueryKey,
+} from '@tanstack/react-query'
+
+/**
+ * Type for a query options creator function that returns TanStack Query options.
+ *
+ * This matches the return type of `client.query()` from the navios react-query client.
+ */
+export type QueryOptionsCreator<TParams, TData, TError = Error> = (
+  params: TParams,
+) => FetchQueryOptions<TData, TError, TData, QueryKey>
+
+/**
+ * Helper utilities for prefetching queries.
+ *
+ * @template TParams - The query parameters type
+ * @template TData - The query data type
+ * @template TError - The error type (defaults to Error)
+ */
+export interface PrefetchHelper<TParams, TData, TError = Error> {
+  /**
+   * Prefetch query data on the server.
+   *
+   * Use this in server components or getServerSideProps to
+   * prefetch data before rendering.
+   *
+   * @param queryClient - The QueryClient instance
+   * @param params - Parameters for the query
+   * @returns Promise that resolves when prefetch is complete
+   *
+   * @example
+   * ```tsx
+   * // In a Next.js Server Component
+   * const queryClient = new QueryClient()
+   * await prefetch.prefetch(queryClient, { urlParams: { userId: '1' } })
+   * return (
+   *   <HydrationBoundary state={dehydrate(queryClient)}>
+   *     <UserProfile userId="1" />
+   *   </HydrationBoundary>
+   * )
+   * ```
+   */
+  prefetch: (queryClient: QueryClient, params: TParams) => Promise<void>
+
+  /**
+   * Ensure query data exists in cache. Fetches only if not cached.
+   *
+   * Returns the cached or fetched data.
+   *
+   * @param queryClient - The QueryClient instance
+   * @param params - Parameters for the query
+   * @returns Promise that resolves to the query data
+   *
+   * @example
+   * ```tsx
+   * // Ensure data exists before rendering
+   * const userData = await prefetch.ensureData(queryClient, {
+   *   urlParams: { userId: '1' },
+   * })
+   * console.log('User:', userData.name)
+   * ```
+   */
+  ensureData: (queryClient: QueryClient, params: TParams) => Promise<TData>
+
+  /**
+   * Get the query options for a given set of parameters.
+   *
+   * Useful for advanced use cases or when you need to
+   * customize the prefetch behavior.
+   *
+   * @param params - Parameters for the query
+   * @returns The query options object
+   *
+   * @example
+   * ```tsx
+   * const options = prefetch.getQueryOptions({ urlParams: { userId: '1' } })
+   * await queryClient.prefetchQuery({
+   *   ...options,
+   *   staleTime: 60000, // Override stale time for prefetch
+   * })
+   * ```
+   */
+  getQueryOptions: (
+    params: TParams,
+  ) => FetchQueryOptions<TData, TError, TData, QueryKey>
+
+  /**
+   * Prefetch multiple queries in parallel.
+   *
+   * @param queryClient - The QueryClient instance
+   * @param paramsList - Array of parameters for multiple queries
+   * @returns Promise that resolves when all prefetches complete
+   *
+   * @example
+   * ```tsx
+   * // Prefetch multiple users in parallel
+   * await prefetch.prefetchMany(queryClient, [
+   *   { urlParams: { userId: '1' } },
+   *   { urlParams: { userId: '2' } },
+   *   { urlParams: { userId: '3' } },
+   * ])
+   * ```
+   */
+  prefetchMany: (
+    queryClient: QueryClient,
+    paramsList: TParams[],
+  ) => Promise<void>
+}
+
+/**
+ * Creates a type-safe prefetch helper for SSR/RSC.
+ *
+ * This utility wraps a query options creator to provide convenient
+ * methods for server-side data fetching and hydration.
+ *
+ * @param queryOptionsCreator - A function that creates query options (from client.query())
+ * @returns A prefetch helper object with prefetch, ensureData, and getQueryOptions methods
+ *
+ * @example
+ * ```tsx
+ * // 1. Create your query
+ * const getUserQuery = client.query({
+ *   method: 'GET',
+ *   url: '/users/$userId',
+ *   responseSchema: userSchema,
+ * })
+ *
+ * // 2. Create prefetch helper
+ * const userPrefetch = createPrefetchHelper(getUserQuery)
+ *
+ * // 3. Use in server component
+ * async function UserPage({ userId }: { userId: string }) {
+ *   const queryClient = new QueryClient()
+ *
+ *   await userPrefetch.prefetch(queryClient, {
+ *     urlParams: { userId },
+ *   })
+ *
+ *   return (
+ *     <HydrationBoundary state={dehydrate(queryClient)}>
+ *       <UserProfile userId={userId} />
+ *     </HydrationBoundary>
+ *   )
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // With Next.js App Router
+ * import { dehydrate, HydrationBoundary, QueryClient } from '@tanstack/react-query'
+ * import { createPrefetchHelper } from '@navios/react-query'
+ *
+ * // Define queries
+ * const getPostsQuery = client.query({
+ *   method: 'GET',
+ *   url: '/posts',
+ *   querySchema: z.object({ page: z.number() }),
+ *   responseSchema: postsSchema,
+ * })
+ *
+ * const postsPrefetch = createPrefetchHelper(getPostsQuery)
+ *
+ * // Server Component
+ * export default async function PostsPage() {
+ *   const queryClient = new QueryClient()
+ *
+ *   await postsPrefetch.prefetch(queryClient, {
+ *     params: { page: 1 },
+ *   })
+ *
+ *   return (
+ *     <HydrationBoundary state={dehydrate(queryClient)}>
+ *       <PostsList />
+ *     </HydrationBoundary>
+ *   )
+ * }
+ * ```
+ */
+export function createPrefetchHelper<TParams, TData, TError = Error>(
+  queryOptionsCreator: QueryOptionsCreator<TParams, TData, TError>,
+): PrefetchHelper<TParams, TData, TError> {
+  return {
+    prefetch: async (queryClient: QueryClient, params: TParams) => {
+      const options = queryOptionsCreator(params)
+      await queryClient.prefetchQuery(options)
+    },
+
+    ensureData: async (queryClient: QueryClient, params: TParams) => {
+      const options = queryOptionsCreator(params)
+      return queryClient.ensureQueryData(options)
+    },
+
+    getQueryOptions: (params: TParams) => {
+      return queryOptionsCreator(params)
+    },
+
+    prefetchMany: async (queryClient: QueryClient, paramsList: TParams[]) => {
+      await Promise.all(
+        paramsList.map((params) => {
+          const options = queryOptionsCreator(params)
+          return queryClient.prefetchQuery(options)
+        }),
+      )
+    },
+  }
+}
+
+/**
+ * Creates multiple prefetch helpers from a record of query options creators.
+ *
+ * Useful when you have multiple queries that need to be prefetched together.
+ *
+ * @param queries - Record of query options creator functions
+ * @returns Record of prefetch helpers with the same keys
+ *
+ * @example
+ * ```tsx
+ * // Define all your queries
+ * const queries = {
+ *   user: client.query({
+ *     method: 'GET',
+ *     url: '/users/$userId',
+ *     responseSchema: userSchema,
+ *   }),
+ *   posts: client.query({
+ *     method: 'GET',
+ *     url: '/users/$userId/posts',
+ *     responseSchema: postsSchema,
+ *   }),
+ * }
+ *
+ * // Create all prefetch helpers at once
+ * const prefetchers = createPrefetchHelpers(queries)
+ *
+ * // Use in server component
+ * async function UserPage({ userId }: { userId: string }) {
+ *   const queryClient = new QueryClient()
+ *
+ *   await Promise.all([
+ *     prefetchers.user.prefetch(queryClient, { urlParams: { userId } }),
+ *     prefetchers.posts.prefetch(queryClient, { urlParams: { userId } }),
+ *   ])
+ *
+ *   return (
+ *     <HydrationBoundary state={dehydrate(queryClient)}>
+ *       <UserProfileWithPosts userId={userId} />
+ *     </HydrationBoundary>
+ *   )
+ * }
+ * ```
+ */
+export function createPrefetchHelpers<
+  T extends Record<string, QueryOptionsCreator<any, any, any>>,
+>(
+  queries: T,
+): {
+  [K in keyof T]: T[K] extends QueryOptionsCreator<
+    infer TParams,
+    infer TData,
+    infer TError
+  >
+    ? PrefetchHelper<TParams, TData, TError>
+    : never
+} {
+  const result = {} as {
+    [K in keyof T]: T[K] extends QueryOptionsCreator<
+      infer TParams,
+      infer TData,
+      infer TError
+    >
+      ? PrefetchHelper<TParams, TData, TError>
+      : never
+  }
+
+  for (const key of Object.keys(queries) as Array<keyof T>) {
+    // @ts-expect-error - TypeScript can't infer this properly
+    result[key] = createPrefetchHelper(queries[key])
+  }
+
+  return result
+}
+
+/**
+ * Prefetch multiple queries from different query creators in parallel.
+ *
+ * @param queryClient - The QueryClient instance
+ * @param prefetches - Array of { helper, params } objects
+ * @returns Promise that resolves when all prefetches complete
+ *
+ * @example
+ * ```tsx
+ * const userPrefetch = createPrefetchHelper(getUserQuery)
+ * const postsPrefetch = createPrefetchHelper(getPostsQuery)
+ *
+ * async function DashboardPage({ userId }: { userId: string }) {
+ *   const queryClient = new QueryClient()
+ *
+ *   await prefetchAll(queryClient, [
+ *     { helper: userPrefetch, params: { urlParams: { userId } } },
+ *     { helper: postsPrefetch, params: { urlParams: { userId }, params: { limit: 10 } } },
+ *   ])
+ *
+ *   return (
+ *     <HydrationBoundary state={dehydrate(queryClient)}>
+ *       <Dashboard userId={userId} />
+ *     </HydrationBoundary>
+ *   )
+ * }
+ * ```
+ */
+export async function prefetchAll(
+  queryClient: QueryClient,
+  prefetches: Array<{
+    helper: PrefetchHelper<any, any, any>
+    params: unknown
+  }>,
+): Promise<void> {
+  await Promise.all(
+    prefetches.map(({ helper, params }) =>
+      helper.prefetch(queryClient, params),
+    ),
+  )
+}

package/src/query/types.mts

@@ -1,10 +1,15 @@
 import type {
   AnyEndpointConfig,
   BaseEndpointConfig,
+  EndpointOptions,
+  ErrorSchemaRecord,
   HttpMethod,
+  InferEndpointReturn,
+  InferErrorSchemaOutput,
+  RequestArgs,
+  Simplify,
   UrlHasParams,
   UrlParams,
-  Util_FlatObject,
 } from '@navios/builder'
 import type {
   DataTag,
@@ -17,31 +22,76 @@ import type { z, ZodObject, ZodType } from 'zod/v4'
 
 import type { Split } from '../common/types.mjs'
 
+/**
+ * Compute the response input type based on discriminator and error schema.
+ * When UseDiscriminator=true and errorSchema is present, errors are included as a union.
+ * When UseDiscriminator=false, only the success type is returned (errors are thrown).
+ *
+ * @template UseDiscriminator - Whether to include error types in the response union
+ * @template ResponseSchema - The success response schema
+ * @template ErrorSchema - The error schema record (optional)
+ */
+type ComputeResponseInput<
+  UseDiscriminator extends boolean,
+  ResponseSchema extends ZodType,
+  ErrorSchema extends ErrorSchemaRecord | undefined,
+> = UseDiscriminator extends true
+  ? ErrorSchema extends ErrorSchemaRecord
+    ? z.output<ResponseSchema> | InferErrorSchemaOutput<ErrorSchema>
+    : z.output<ResponseSchema>
+  : z.output<ResponseSchema>
+
+/**
+ * Helper type to extract the result type from processResponse.
+ */
+export type QueryResult<
+  Options extends EndpointOptions,
+  UseDiscriminator extends boolean = false,
+> = Options extends {
+  processResponse: (data: any) => infer Result
+}
+  ? Result
+  : InferEndpointReturn<Options, UseDiscriminator>
+
 /**
  * Arguments for query functions based on URL params and query schema.
+ * Uses RequestArgs from builder for consistency.
  */
 export type QueryArgs<
   Url extends string = string,
-  QuerySchema = ZodObject,
-  RequestSchema = undefined,
-> = (UrlHasParams<Url> extends true ? { urlParams: UrlParams<Url> } : {}) &
-  (QuerySchema extends ZodObject ? { params: z.input<QuerySchema> } : {}) &
-  (RequestSchema extends ZodType ? { data: z.input<RequestSchema> } : {})
+  QuerySchema extends ZodObject | undefined = undefined,
+  RequestSchema extends ZodType | undefined = undefined,
+> = RequestArgs<Url, QuerySchema, RequestSchema>
 
 /**
  * Arguments containing only URL params (for invalidateAll operations).
  */
 export type QueryUrlParamsArgs<Url extends string = string> =
-  UrlHasParams<Url> extends true ? { urlParams: UrlParams<Url> } : {} | undefined
+  UrlHasParams<Url> extends true
+    ? { urlParams: UrlParams<Url> }
+    : {} | undefined
 
 /**
  * Base parameters for query configuration.
+ *
+ * @template UseDiscriminator - When `true`, errors are returned as union types in processResponse.
+ *   When `false` (default), errors are thrown and not included in the response type.
  */
-export type QueryParams<Config extends AnyEndpointConfig, Res = any> = {
+export type QueryParams<
+  Config extends AnyEndpointConfig,
+  Res = any,
+  UseDiscriminator extends boolean = false,
+> = {
   keyPrefix?: string[]
   keySuffix?: string[]
   onFail?: (err: unknown) => void
-  processResponse: (data: z.output<Config['responseSchema']>) => Res
+  processResponse: (
+    data: ComputeResponseInput<
+      UseDiscriminator,
+      Config['responseSchema'],
+      Config['errorSchema']
+    >,
+  ) => Res
 }
 
 /**
@@ -88,31 +138,41 @@ export type QueryHelpers<
 > = {
   queryKey: QueryKeyCreatorResult<QuerySchema, Url, Result, IsInfinite>
   use: (
-    params: Util_FlatObject<QueryArgs<Url, QuerySchema, RequestSchema>>,
+    params: Simplify<QueryArgs<Url, QuerySchema, RequestSchema>>,
   ) => UseQueryResult<Result, Error>
   useSuspense: (
-    params: Util_FlatObject<QueryArgs<Url, QuerySchema, RequestSchema>>,
+    params: Simplify<QueryArgs<Url, QuerySchema, RequestSchema>>,
   ) => UseSuspenseQueryResult<Result, Error>
   invalidate: (
     queryClient: QueryClient,
-    params: Util_FlatObject<QueryArgs<Url, QuerySchema, RequestSchema>>,
+    params: Simplify<QueryArgs<Url, QuerySchema, RequestSchema>>,
   ) => () => Promise<void>
   invalidateAll: (
     queryClient: QueryClient,
-    params: Util_FlatObject<QueryUrlParamsArgs<Url>>,
+    params: Simplify<QueryUrlParamsArgs<Url>>,
   ) => () => Promise<void>
 }
 
 /**
  * Options for infinite query configuration.
+ *
+ * @template UseDiscriminator - When `true`, errors are returned as union types in processResponse.
+ *   When `false` (default), errors are thrown and not included in the response type.
  */
 export type InfiniteQueryOptions<
   Config extends BaseEndpointConfig<HttpMethod, string, ZodObject>,
   Res = any,
+  UseDiscriminator extends boolean = false,
 > = {
   keyPrefix?: string[]
   keySuffix?: string[]
-  processResponse: (data: z.infer<Config['responseSchema']>) => Res
+  processResponse: (
+    data: ComputeResponseInput<
+      UseDiscriminator,
+      Config['responseSchema'],
+      Config['errorSchema']
+    >,
+  ) => Res
   onFail?: (err: unknown) => void
   getNextPageParam: (
     lastPage: Res,
@@ -138,8 +198,8 @@ export type InfiniteQueryOptions<
 /** @deprecated Use QueryArgs instead */
 export type ClientQueryArgs<
   Url extends string = string,
-  QuerySchema = ZodObject,
-  RequestSchema = undefined,
+  QuerySchema extends ZodObject = ZodObject,
+  RequestSchema extends ZodType | undefined = undefined,
 > = QueryArgs<Url, QuerySchema, RequestSchema>
 
 /** @deprecated Use QueryUrlParamsArgs instead */

package/dist/src/declare-client.d.mts

@@ -1,31 +0,0 @@
-import type { HttpMethod, Util_FlatObject } from '@navios/builder';
-import type { InfiniteData, QueryClient } from '@tanstack/react-query';
-import type { z, ZodObject, ZodType } from 'zod/v4';
-import type { ClientOptions, ProcessResponseFunction } from './types.mjs';
-import type { ClientInstance, ClientMutationArgs } from './types/index.mjs';
-export interface ClientEndpointDefinition<Method = HttpMethod, Url = string, QuerySchema = unknown, Response = ZodType> {
-    method: Method;
-    url: Url;
-    querySchema?: QuerySchema;
-    responseSchema: Response;
-}
-export interface ClientQueryConfig<Method = HttpMethod, Url = string, QuerySchema = ZodObject, Response extends ZodType = ZodType, Result = z.output<Response>> extends ClientEndpointDefinition<Method, Url, QuerySchema, Response> {
-    processResponse?: (data: z.output<Response>) => Result;
-}
-export type ClientInfiniteQueryConfig<Method = HttpMethod, Url = string, QuerySchema extends ZodObject = ZodObject, Response extends ZodType = ZodType, PageResult = z.output<Response>, Result = InfiniteData<PageResult>> = Required<ClientEndpointDefinition<Method, Url, QuerySchema, Response>> & {
-    processResponse?: (data: z.output<Response>) => PageResult;
-    select?: (data: InfiniteData<PageResult>) => Result;
-    getNextPageParam: (lastPage: PageResult, allPages: PageResult[], lastPageParam: z.infer<QuerySchema> | undefined, allPageParams: z.infer<QuerySchema>[] | undefined) => z.input<QuerySchema> | undefined;
-    getPreviousPageParam?: (firstPage: PageResult, allPages: PageResult[], lastPageParam: z.infer<QuerySchema> | undefined, allPageParams: z.infer<QuerySchema>[] | undefined) => z.input<QuerySchema>;
-    initialPageParam?: z.input<QuerySchema>;
-};
-export interface ClientMutationDataConfig<Method extends 'POST' | 'PUT' | 'PATCH' | 'DELETE' = 'POST' | 'PUT' | 'PATCH' | 'DELETE', Url extends string = string, RequestSchema = Method extends 'DELETE' ? never : ZodObject, QuerySchema = unknown, Response extends ZodType = ZodType, ReqResult = z.output<Response>, Result = unknown, Context = unknown, UseKey extends boolean = false> extends ClientEndpointDefinition<Method, Url, QuerySchema, Response> {
-    requestSchema?: RequestSchema;
-    processResponse: ProcessResponseFunction<Result, ReqResult>;
-    useContext?: () => Context;
-    onSuccess?: (queryClient: QueryClient, data: NoInfer<Result>, variables: Util_FlatObject<ClientMutationArgs<Url, RequestSchema, QuerySchema>>, context: Context) => void | Promise<void>;
-    onError?: (queryClient: QueryClient, error: Error, variables: Util_FlatObject<ClientMutationArgs<Url, RequestSchema, QuerySchema>>, context: Context) => void | Promise<void>;
-    useKey?: UseKey;
-}
-export declare function declareClient<Options extends ClientOptions>({ api, defaults, }: Options): ClientInstance;
-//# sourceMappingURL=declare-client.d.mts.map

package/dist/src/declare-client.d.mts.map

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

package/dist/src/make-infinite-query-options.d.mts

@@ -1,13 +0,0 @@
-import type { AbstractEndpoint, AnyEndpointConfig } from '@navios/builder';
-import type { InfiniteData, QueryClient, UseInfiniteQueryOptions, UseSuspenseInfiniteQueryOptions } from '@tanstack/react-query';
-import type { InfiniteQueryOptions } from './types.mjs';
-import type { ClientQueryArgs } from './types/index.mjs';
-export declare function makeInfiniteQueryOptions<Config extends AnyEndpointConfig, Options extends InfiniteQueryOptions<Config>, BaseQuery extends Omit<UseInfiniteQueryOptions<ReturnType<Options['processResponse']>, Error, any>, 'queryKey' | 'queryFn' | 'getNextPageParam' | 'initialPageParam' | 'placeholderData' | 'throwOnError'>>(endpoint: AbstractEndpoint<Config>, options: Options, baseQuery?: BaseQuery): {
-    (params: ClientQueryArgs): Options["processResponse"] extends (...args: any[]) => infer Result ? UseSuspenseInfiniteQueryOptions<Result, Error, BaseQuery["select"] extends (...args: any[]) => infer T ? T : InfiniteData<Result>> : never;
-    queryKey: import("./utils/query-key-creator.mjs").QueryKeyCreatorResult<Config["querySchema"], Config["url"], Options["processResponse"] extends (...args: any[]) => infer Result ? Result : never, true, import("@navios/builder").UrlHasParams<Config["url"]>>;
-    use(params: ClientQueryArgs): import("@tanstack/react-query").UseInfiniteQueryResult<BaseQuery["select"] extends (...args: any[]) => infer T ? T : InfiniteData<unknown, unknown>, Error>;
-    useSuspense(params: ClientQueryArgs): import("@tanstack/react-query").UseSuspenseInfiniteQueryResult<BaseQuery["select"] extends (...args: any[]) => infer T ? T : InfiniteData<unknown, unknown>, Error>;
-    invalidate(queryClient: QueryClient, params: ClientQueryArgs): Promise<void>;
-    invalidateAll(queryClient: QueryClient, params: ClientQueryArgs): Promise<void>;
-};
-//# sourceMappingURL=make-infinite-query-options.d.mts.map

package/dist/src/make-infinite-query-options.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"make-infinite-query-options.d.mts","sourceRoot":"","sources":["../../src/make-infinite-query-options.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EAElB,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,uBAAuB,EACvB,+BAA+B,EAChC,MAAM,uBAAuB,CAAA;AAS9B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAIxD,wBAAgB,wBAAwB,CACtC,MAAM,SAAS,iBAAiB,EAChC,OAAO,SAAS,oBAAoB,CAAC,MAAM,CAAC,EAC5C,SAAS,SAAS,IAAI,CACpB,uBAAuB,CAAC,UAAU,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,EACzE,UAAU,GACV,SAAS,GACT,kBAAkB,GAClB,kBAAkB,GAClB,iBAAiB,GACjB,cAAc,CACjB,EAED,QAAQ,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAClC,OAAO,EAAE,OAAO,EAChB,SAAS,GAAE,SAA2B;aAO5B,eAAe,GACtB,OAAO,CAAC,iBAAiB,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,MAAM,GAClE,+BAA+B,CAC7B,MAAM,EACN,KAAK,EACL,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,CAAC,GACnD,CAAC,GACD,YAAY,CAAC,MAAM,CAAC,CACzB,GACD,KAAK;;gBAmCU,eAAe,gGAvCU,GAAG,EAAE,KAAK,MAAM,CAAC;wBA2ClC,eAAe,wGA3CE,GAAG,EAAE,KAAK,MAAM,CAAC;4BA+C9B,WAAW,UAAU,eAAe;+BAOjC,WAAW,UAAU,eAAe;EASvE"}

package/dist/src/make-mutation.d.mts

@@ -1,15 +0,0 @@
-import type { AbstractEndpoint, AnyEndpointConfig, UrlHasParams, UrlParams } from '@navios/builder';
-import type { UseMutationResult } from '@tanstack/react-query';
-import type { z } from 'zod/v4';
-import type { BaseMutationArgs, BaseMutationParams } from './types.mjs';
-export declare function makeMutation<Config extends AnyEndpointConfig, TData = unknown, TVariables extends BaseMutationArgs<Config> = BaseMutationArgs<Config>, TResponse = z.output<Config['responseSchema']>, TContext = unknown, UseKey extends boolean = false>(endpoint: AbstractEndpoint<Config>, options: BaseMutationParams<Config, TData, TVariables, TResponse, TContext, UseKey>): {
-    (keyParams: UseKey extends true ? UrlHasParams<Config["url"]> extends true ? UrlParams<Config["url"]> : never : never): UseMutationResult<TData, Error, BaseMutationArgs<Config>>;
-    useIsMutating(keyParams: UseKey extends true ? UrlHasParams<Config["url"]> extends true ? UrlParams<Config["url"]> : never : never): boolean;
-    mutationKey: (params: UrlHasParams<Config["url"]> extends infer T ? T extends UrlHasParams<Config["url"]> ? T extends true ? {
-        urlParams: UrlParams<Config["url"]>;
-    } : {} : never : never) => [Config["url"]] & {
-        [dataTagSymbol]: TData | Promise<TData>;
-        [dataTagErrorSymbol]: Error;
-    };
-};
-//# sourceMappingURL=make-mutation.d.mts.map

package/dist/src/make-mutation.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"make-mutation.d.mts","sourceRoot":"","sources":["../../src/make-mutation.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,SAAS,EACV,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAQ/B,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAIvE,wBAAgB,YAAY,CAC1B,MAAM,SAAS,iBAAiB,EAChC,KAAK,GAAG,OAAO,EACf,UAAU,SAAS,gBAAgB,CAAC,MAAM,CAAC,GAAG,gBAAgB,CAAC,MAAM,CAAC,EACtE,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,EAC9C,QAAQ,GAAG,OAAO,EAClB,MAAM,SAAS,OAAO,GAAG,KAAK,EAE9B,QAAQ,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAClC,OAAO,EAAE,kBAAkB,CACzB,MAAM,EACN,KAAK,EACL,UAAU,EACV,SAAS,EACT,QAAQ,EACR,MAAM,CACP;gBAMY,MAAM,SAAS,IAAI,GAC1B,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,IAAI,GACtC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GACxB,KAAK,GACP,KAAK,GACR,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;6BAqD/C,MAAM,SAAS,IAAI,GAC1B,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,IAAI,GACtC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GACxB,KAAK,GACP,KAAK,GACR,OAAO;;;;;;;EAgBX"}

package/dist/src/make-query-options.d.mts

@@ -1,15 +0,0 @@
-import type { AbstractEndpoint, AnyEndpointConfig } from '@navios/builder';
-import type { DataTag, QueryClient, UseQueryOptions, UseSuspenseQueryOptions } from '@tanstack/react-query';
-import type { BaseQueryArgs, BaseQueryParams } from './types.mjs';
-import type { ClientQueryArgs } from './types/index.mjs';
-type Split<S extends string, D extends string> = string extends S ? string[] : S extends '' ? [] : S extends `${infer T}${D}${infer U}` ? [T, ...Split<U, D>] : [S];
-export declare function makeQueryOptions<Config extends AnyEndpointConfig, Options extends BaseQueryParams<Config>, BaseQuery extends Omit<UseQueryOptions<ReturnType<Options['processResponse']>, Error, any>, 'queryKey' | 'queryFn' | 'getNextPageParam' | 'initialPageParam' | 'enabled' | 'throwOnError' | 'placeholderData'>>(endpoint: AbstractEndpoint<Config>, options: Options, baseQuery?: BaseQuery): {
-    (params: BaseQueryArgs<Config>): Options["processResponse"] extends (...args: any[]) => infer Result ? UseSuspenseQueryOptions<Result, Error, BaseQuery["select"] extends (...args: any[]) => infer T ? T : Result, DataTag<Split<Config["url"], "/">, Result, Error>> : never;
-    queryKey: import("./utils/query-key-creator.mjs").QueryKeyCreatorResult<Config["querySchema"], Config["url"], Options["processResponse"] extends (...args: any[]) => infer Result ? Result : never, false, import("@navios/builder").UrlHasParams<Config["url"]>>;
-    use(params: ClientQueryArgs): import("@tanstack/react-query").UseQueryResult<import("@tanstack/react-query").NoInfer<BaseQuery["select"] extends (...args: any[]) => infer T ? T : unknown>, Error>;
-    useSuspense(params: ClientQueryArgs): import("@tanstack/react-query").UseSuspenseQueryResult<BaseQuery["select"] extends (...args: any[]) => infer T ? T : unknown, Error>;
-    invalidate(queryClient: QueryClient, params: ClientQueryArgs): Promise<void>;
-    invalidateAll(queryClient: QueryClient, params: ClientQueryArgs): Promise<void>;
-};
-export {};
-//# sourceMappingURL=make-query-options.d.mts.map

package/dist/src/make-query-options.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"make-query-options.d.mts","sourceRoot":"","sources":["../../src/make-query-options.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAC1E,OAAO,KAAK,EACV,OAAO,EACP,WAAW,EACX,eAAe,EACf,uBAAuB,EACxB,MAAM,uBAAuB,CAAA;AAI9B,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAIxD,KAAK,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,IAAI,MAAM,SAAS,CAAC,GAC7D,MAAM,EAAE,GACR,CAAC,SAAS,EAAE,GACV,EAAE,GACF,CAAC,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,EAAE,GAClC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GACnB,CAAC,CAAC,CAAC,CAAA;AAEX,wBAAgB,gBAAgB,CAC9B,MAAM,SAAS,iBAAiB,EAChC,OAAO,SAAS,eAAe,CAAC,MAAM,CAAC,EACvC,SAAS,SAAS,IAAI,CACpB,eAAe,CAAC,UAAU,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,EACjE,UAAU,GACV,SAAS,GACT,kBAAkB,GAClB,kBAAkB,GAClB,SAAS,GACT,cAAc,GACd,iBAAiB,CACpB,EAED,QAAQ,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAClC,OAAO,EAAE,OAAO,EAChB,SAAS,GAAE,SAA2B;aAQ5B,aAAa,CAAC,MAAM,CAAC,GAC5B,OAAO,CAAC,iBAAiB,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,MAAM,GAClE,uBAAuB,CACrB,MAAM,EACN,KAAK,EACL,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,EACpE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAClD,GACD,KAAK;;gBAwBa,eAAe,gIA3BO,GAAG,EAAE,KAAK,MAAM,CAAC;wBAgC/B,eAAe,gGAhCD,GAAG,EAAE,KAAK,MAAM,CAAC;4BAqC3B,WAAW,UAAU,eAAe;+BAQvD,WAAW,UAChB,eAAe;EAU1B"}

package/dist/src/types/client-endpoint-helper.d.mts

@@ -1,8 +0,0 @@
-import type { BaseEndpointConfig, EndpointFunctionArgs, HttpMethod, Util_FlatObject } from '@navios/builder';
-import type { z } from 'zod/v4';
-export type ClientEndpointHelper<Method extends HttpMethod = HttpMethod, Url extends string = string, RequestSchema = unknown, ResponseSchema extends z.ZodType = z.ZodType, QuerySchema = unknown> = {
-    endpoint: ((params: Util_FlatObject<EndpointFunctionArgs<Url, QuerySchema, RequestSchema>>) => Promise<z.output<ResponseSchema>>) & {
-        config: BaseEndpointConfig<Method, Url, QuerySchema, ResponseSchema, RequestSchema>;
-    };
-};
-//# sourceMappingURL=client-endpoint-helper.d.mts.map

package/dist/src/types/client-endpoint-helper.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"client-endpoint-helper.d.mts","sourceRoot":"","sources":["../../../src/types/client-endpoint-helper.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACpB,UAAU,EACV,eAAe,EAChB,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE/B,MAAM,MAAM,oBAAoB,CAC9B,MAAM,SAAS,UAAU,GAAG,UAAU,EACtC,GAAG,SAAS,MAAM,GAAG,MAAM,EAC3B,aAAa,GAAG,OAAO,EACvB,cAAc,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,EAC5C,WAAW,GAAG,OAAO,IACnB;IACF,QAAQ,EAAE,CAAC,CACT,MAAM,EAAE,eAAe,CACrB,oBAAoB,CAAC,GAAG,EAAE,WAAW,EAAE,aAAa,CAAC,CACtD,KACE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG;QACxC,MAAM,EAAE,kBAAkB,CACxB,MAAM,EACN,GAAG,EACH,WAAW,EACX,cAAc,EACd,aAAa,CACd,CAAA;KACF,CAAA;CACF,CAAA"}