routesync 1.0.28 → 1.0.30

package/dist/cli.js

@@ -8751,7 +8751,7 @@ var SDKGenerator = class {
     lines.push(`// Auto-generated by routesync. Do not edit manually.`);
     lines.push(`// Generated at: ${manifest.generatedAt}`);
     lines.push(``);
-    lines.push(`import { defineApi${usesTypes ? ", endpoint" : ""} } from 'routesync'`);
+    lines.push(`import { defineApi, endpoint } from 'routesync'`);
     if (usesZod) {
       lines.push(`import { z } from 'zod'`);
       lines.push(`import * as Schemas from './schemas'`);
@@ -9116,16 +9116,18 @@ var NextActionGenerator = class {
         const hasParams = pathParams.length > 0;
         const hasBody = ["POST", "PUT", "PATCH", "DELETE"].includes(route.method) && route.schema?.rules && Object.keys(route.schema.rules).length > 0;
         const hasQuery = route.method === "GET" || route.method === "DELETE";
-        usedContracts.add(ContractName);
         const sigParts = [];
         if (hasParams) sigParts.push(`params: ${ContractName}['request']['params']`);
         if (hasQuery) sigParts.push(`query?: ${ContractName}['request']['query']`);
-        if (hasBody) sigParts.push(`body?: ${ContractName}['request']['body']`);
-        const fnParam = sigParts.length > 0 ? `payload${hasParams ? "" : "?"}: { ${sigParts.join(", ")} }` : "";
+        if (hasBody) sigParts.push(`body: ${ContractName}['request']['body']`);
+        const needsContract = sigParts.length > 0;
+        if (needsContract) usedContracts.add(ContractName);
+        const payloadRequired = hasParams || hasBody;
+        const fnParam = sigParts.length > 0 ? `payload${payloadRequired ? "" : "?"}: { ${sigParts.join(", ")} }` : "";
         const callArgs = [];
         if (hasParams) callArgs.push(`params: payload.params`);
         if (hasQuery) callArgs.push(`query: payload?.query`);
-        if (hasBody) callArgs.push(`body: payload?.body`);
+        if (hasBody) callArgs.push(`body: payload.body`);
         if (route.auth) callArgs.push(`headers: await getAuthHeaders()`);
         const argsStr = callArgs.length > 0 ? `{ ${callArgs.join(", ")} }` : "";
         lines.push(`export async function ${actionFnName}(${fnParam}) {`);

package/dist/react.d.mts

@@ -45,6 +45,12 @@ interface RouteDefinition<TResponse = unknown, TParams = unknown, TBody = unknow
     _typeBody?: TBody;
 }
 
+type CallOptions<TParams = unknown, TBody = unknown> = {
+    params?: TParams;
+    query?: Record<string, any>;
+    body?: TBody;
+    headers?: Record<string, string>;
+};
 type EndpointCallableOptions<TParams, TBody> = (unknown extends TParams ? {} : {
     params: TParams;
 }) & (unknown extends TBody ? {
@@ -55,7 +61,10 @@ type EndpointCallableOptions<TParams, TBody> = (unknown extends TParams ? {} : {
     query?: Record<string, any>;
     headers?: Record<string, string>;
 };
-type OptionalIfEmpty<T> = keyof Omit<T, 'query' | 'headers'> extends never ? [options?: T] : [options: T];
+type RequiredKeys<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? never : K;
+}[keyof T];
+type OptionalIfEmpty<T> = RequiredKeys<Omit<T, 'query' | 'headers'>> extends never ? [options?: T] : [options: T];
 interface ApiError {
     message: string;
     status?: number;
@@ -63,36 +72,25 @@ interface ApiError {
 }
 interface EndpointCallable<TResponse = unknown, TParams = unknown, TBody = unknown> {
     (...args: OptionalIfEmpty<EndpointCallableOptions<TParams, TBody>>): Promise<TResponse>;
+    (options: EndpointCallableOptions<TParams, TBody> | undefined): Promise<TResponse>;
+    (options: CallOptions<TParams, TBody>): Promise<TResponse>;
     /** Original RouteDefinition — used by useApiQuery / useApiMutation */
     $def: RouteDefinition<TResponse, TParams, TBody>;
     /** Stable TanStack query key: [group, action] */
     $key: string[];
     /** Consistent query key builder that incorporates params/query if provided */
-    $queryKey: (...args: OptionalIfEmpty<EndpointCallableOptions<TParams, TBody>>) => unknown[];
+    $queryKey: (options?: EndpointCallableOptions<TParams, TBody>) => unknown[];
 }
 
-/**
- * useApiQuery — accepts an endpoint callable directly.
- *
- * Usage:
- *   const { data, isLoading } = useApiQuery(api.produk.list)
- *   const { data } = useApiQuery(api.produk.detail, { params: { id: 10 } })
- */
 type ApiQueryOptions<TResponse, TError = ApiError, TData = TResponse> = Omit<UseQueryOptions<TResponse, TError, TData>, 'queryKey' | 'queryFn'>;
 declare function useApiQuery<TResponse = unknown, TParams = unknown, TBody = unknown, TError = ApiError, TData = TResponse>(endpoint: EndpointCallable<TResponse, TParams, TBody>, ...args: [
     ...OptionalIfEmpty<EndpointCallableOptions<TParams, TBody>>,
-    queryOptions?: Omit<UseQueryOptions<TResponse, TError, TData>, 'queryKey' | 'queryFn'>
+    queryOptions?: ApiQueryOptions<TResponse, TError, TData>
 ]): _tanstack_react_query.UseQueryResult<NoInfer<TData>, TError>;
-/**
- * useApiSuspenseQuery — generic wrapper for Suspense-enabled data fetching (TanStack v5).
- */
 declare function useApiSuspenseQuery<TResponse = unknown, TParams = unknown, TBody = unknown, TError = ApiError, TData = TResponse>(endpoint: EndpointCallable<TResponse, TParams, TBody>, ...args: [
     ...OptionalIfEmpty<EndpointCallableOptions<TParams, TBody>>,
     queryOptions?: Omit<UseSuspenseQueryOptions<TResponse, TError, TData>, 'queryKey' | 'queryFn'>
 ]): _tanstack_react_query.UseSuspenseQueryResult<TData, TError>;
-/**
- * useApiInfiniteQuery — framework agnostic paginated fetching.
- */
 declare function useApiInfiniteQuery<TResponse = unknown, TParams = unknown, TBody = unknown, TError = ApiError, TData = InfiniteData<TResponse>, TPageParam = unknown>(endpoint: EndpointCallable<TResponse, TParams, TBody>, ...args: [
     ...OptionalIfEmpty<EndpointCallableOptions<TParams, TBody>>,
     queryOptions: Omit<UseInfiniteQueryOptions<TResponse, TError, TData, any, TPageParam>, 'queryKey' | 'queryFn'>
@@ -117,32 +115,11 @@ interface ApiMutationOptions<TData, TError, TVariables, TContext = unknown> exte
 }
 declare function useApiMutation<TResponse = unknown, TParams = unknown, TBody = unknown, TError = ApiError, TContext = unknown>(endpoint: EndpointCallable<TResponse, TParams, TBody>, options?: ApiMutationOptions<TResponse, TError, EndpointCallableOptions<TParams, TBody>, TContext>): _tanstack_react_query.UseMutationResult<TResponse, TError, EndpointCallableOptions<TParams, TBody>, TContext>;
 
-/**
- * useApiQueryClient — a typed wrapper over TanStack's QueryClient
- *
- * Provides ergonomic helpers like invalidateEndpoint and prefetchEndpoint
- * with strong typing based on the RouteSync SDK contracts.
- */
 declare function useApiQueryClient(): {
     queryClient: QueryClient;
-    /**
-     * Invalidate specific queries related to an endpoint.
-     * Optionally pass parameters to invalidate a more specific cache entry.
-     */
     invalidateEndpoint: <TResponse, TParams, TBody>(endpoint: EndpointCallable<TResponse, TParams, TBody>, options?: EndpointCallableOptions<TParams, TBody>) => Promise<void>;
-    /**
-     * Prefetch data for an endpoint into the cache.
-     * Useful for SSR, RSC hydration, or proactive prefetching.
-     */
     prefetchEndpoint: <TResponse, TParams, TBody>(endpoint: EndpointCallable<TResponse, TParams, TBody>, options?: EndpointCallableOptions<TParams, TBody>) => Promise<void>;
-    /**
-     * Manually update the cache for a specific endpoint.
-     * Often used for optimistic updates in mutations.
-     */
     setEndpointData: <TResponse, TParams, TBody>(endpoint: EndpointCallable<TResponse, TParams, TBody>, options: EndpointCallableOptions<TParams, TBody> | undefined, updater: TResponse | ((oldData: TResponse | undefined) => TResponse)) => unknown;
-    /**
-     * Retrieve the current cached data for a specific endpoint.
-     */
     getEndpointData: <TResponse, TParams, TBody>(endpoint: EndpointCallable<TResponse, TParams, TBody>, options?: EndpointCallableOptions<TParams, TBody>) => TResponse | undefined;
 };
 

package/dist/react.d.ts

@@ -45,6 +45,12 @@ interface RouteDefinition<TResponse = unknown, TParams = unknown, TBody = unknow
     _typeBody?: TBody;
 }
 
+type CallOptions<TParams = unknown, TBody = unknown> = {
+    params?: TParams;
+    query?: Record<string, any>;
+    body?: TBody;
+    headers?: Record<string, string>;
+};
 type EndpointCallableOptions<TParams, TBody> = (unknown extends TParams ? {} : {
     params: TParams;
 }) & (unknown extends TBody ? {
@@ -55,7 +61,10 @@ type EndpointCallableOptions<TParams, TBody> = (unknown extends TParams ? {} : {
     query?: Record<string, any>;
     headers?: Record<string, string>;
 };
-type OptionalIfEmpty<T> = keyof Omit<T, 'query' | 'headers'> extends never ? [options?: T] : [options: T];
+type RequiredKeys<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? never : K;
+}[keyof T];
+type OptionalIfEmpty<T> = RequiredKeys<Omit<T, 'query' | 'headers'>> extends never ? [options?: T] : [options: T];
 interface ApiError {
     message: string;
     status?: number;
@@ -63,36 +72,25 @@ interface ApiError {
 }
 interface EndpointCallable<TResponse = unknown, TParams = unknown, TBody = unknown> {
     (...args: OptionalIfEmpty<EndpointCallableOptions<TParams, TBody>>): Promise<TResponse>;
+    (options: EndpointCallableOptions<TParams, TBody> | undefined): Promise<TResponse>;
+    (options: CallOptions<TParams, TBody>): Promise<TResponse>;
     /** Original RouteDefinition — used by useApiQuery / useApiMutation */
     $def: RouteDefinition<TResponse, TParams, TBody>;
     /** Stable TanStack query key: [group, action] */
     $key: string[];
     /** Consistent query key builder that incorporates params/query if provided */
-    $queryKey: (...args: OptionalIfEmpty<EndpointCallableOptions<TParams, TBody>>) => unknown[];
+    $queryKey: (options?: EndpointCallableOptions<TParams, TBody>) => unknown[];
 }
 
-/**
- * useApiQuery — accepts an endpoint callable directly.
- *
- * Usage:
- *   const { data, isLoading } = useApiQuery(api.produk.list)
- *   const { data } = useApiQuery(api.produk.detail, { params: { id: 10 } })
- */
 type ApiQueryOptions<TResponse, TError = ApiError, TData = TResponse> = Omit<UseQueryOptions<TResponse, TError, TData>, 'queryKey' | 'queryFn'>;
 declare function useApiQuery<TResponse = unknown, TParams = unknown, TBody = unknown, TError = ApiError, TData = TResponse>(endpoint: EndpointCallable<TResponse, TParams, TBody>, ...args: [
     ...OptionalIfEmpty<EndpointCallableOptions<TParams, TBody>>,
-    queryOptions?: Omit<UseQueryOptions<TResponse, TError, TData>, 'queryKey' | 'queryFn'>
+    queryOptions?: ApiQueryOptions<TResponse, TError, TData>
 ]): _tanstack_react_query.UseQueryResult<NoInfer<TData>, TError>;
-/**
- * useApiSuspenseQuery — generic wrapper for Suspense-enabled data fetching (TanStack v5).
- */
 declare function useApiSuspenseQuery<TResponse = unknown, TParams = unknown, TBody = unknown, TError = ApiError, TData = TResponse>(endpoint: EndpointCallable<TResponse, TParams, TBody>, ...args: [
     ...OptionalIfEmpty<EndpointCallableOptions<TParams, TBody>>,
     queryOptions?: Omit<UseSuspenseQueryOptions<TResponse, TError, TData>, 'queryKey' | 'queryFn'>
 ]): _tanstack_react_query.UseSuspenseQueryResult<TData, TError>;
-/**
- * useApiInfiniteQuery — framework agnostic paginated fetching.
- */
 declare function useApiInfiniteQuery<TResponse = unknown, TParams = unknown, TBody = unknown, TError = ApiError, TData = InfiniteData<TResponse>, TPageParam = unknown>(endpoint: EndpointCallable<TResponse, TParams, TBody>, ...args: [
     ...OptionalIfEmpty<EndpointCallableOptions<TParams, TBody>>,
     queryOptions: Omit<UseInfiniteQueryOptions<TResponse, TError, TData, any, TPageParam>, 'queryKey' | 'queryFn'>
@@ -117,32 +115,11 @@ interface ApiMutationOptions<TData, TError, TVariables, TContext = unknown> exte
 }
 declare function useApiMutation<TResponse = unknown, TParams = unknown, TBody = unknown, TError = ApiError, TContext = unknown>(endpoint: EndpointCallable<TResponse, TParams, TBody>, options?: ApiMutationOptions<TResponse, TError, EndpointCallableOptions<TParams, TBody>, TContext>): _tanstack_react_query.UseMutationResult<TResponse, TError, EndpointCallableOptions<TParams, TBody>, TContext>;
 
-/**
- * useApiQueryClient — a typed wrapper over TanStack's QueryClient
- *
- * Provides ergonomic helpers like invalidateEndpoint and prefetchEndpoint
- * with strong typing based on the RouteSync SDK contracts.
- */
 declare function useApiQueryClient(): {
     queryClient: QueryClient;
-    /**
-     * Invalidate specific queries related to an endpoint.
-     * Optionally pass parameters to invalidate a more specific cache entry.
-     */
     invalidateEndpoint: <TResponse, TParams, TBody>(endpoint: EndpointCallable<TResponse, TParams, TBody>, options?: EndpointCallableOptions<TParams, TBody>) => Promise<void>;
-    /**
-     * Prefetch data for an endpoint into the cache.
-     * Useful for SSR, RSC hydration, or proactive prefetching.
-     */
     prefetchEndpoint: <TResponse, TParams, TBody>(endpoint: EndpointCallable<TResponse, TParams, TBody>, options?: EndpointCallableOptions<TParams, TBody>) => Promise<void>;
-    /**
-     * Manually update the cache for a specific endpoint.
-     * Often used for optimistic updates in mutations.
-     */
     setEndpointData: <TResponse, TParams, TBody>(endpoint: EndpointCallable<TResponse, TParams, TBody>, options: EndpointCallableOptions<TParams, TBody> | undefined, updater: TResponse | ((oldData: TResponse | undefined) => TResponse)) => unknown;
-    /**
-     * Retrieve the current cached data for a specific endpoint.
-     */
     getEndpointData: <TResponse, TParams, TBody>(endpoint: EndpointCallable<TResponse, TParams, TBody>, options?: EndpointCallableOptions<TParams, TBody>) => TResponse | undefined;
 };
 

package/dist/react.js

@@ -59,11 +59,11 @@ function useApiInfiniteQuery(endpoint, ...args) {
   return (0, import_react_query.useInfiniteQuery)({
     queryKey,
     queryFn: ({ pageParam }) => {
-      const fetchOptions = { ...options };
-      if (pageParam !== void 0) {
-        fetchOptions.query = { ...fetchOptions.query || {}, page: pageParam };
-      }
-      return endpoint(fetchOptions);
+      const callOptions = {
+        ...options,
+        query: { ...options?.query, page: pageParam }
+      };
+      return endpoint(callOptions);
     },
     ...queryOptions
   });
@@ -93,35 +93,20 @@ function useApiQueryClient() {
   const queryClient = (0, import_react_query3.useQueryClient)();
   return {
     queryClient,
-    /**
-     * Invalidate specific queries related to an endpoint.
-     * Optionally pass parameters to invalidate a more specific cache entry.
-     */
     invalidateEndpoint: (endpoint, options) => {
       return queryClient.invalidateQueries({
         queryKey: endpoint.$queryKey(options)
       });
     },
-    /**
-     * Prefetch data for an endpoint into the cache.
-     * Useful for SSR, RSC hydration, or proactive prefetching.
-     */
     prefetchEndpoint: (endpoint, options) => {
       return queryClient.prefetchQuery({
         queryKey: endpoint.$queryKey(options),
         queryFn: () => endpoint(options)
       });
     },
-    /**
-     * Manually update the cache for a specific endpoint.
-     * Often used for optimistic updates in mutations.
-     */
     setEndpointData: (endpoint, options, updater) => {
       return queryClient.setQueryData(endpoint.$queryKey(options), updater);
     },
-    /**
-     * Retrieve the current cached data for a specific endpoint.
-     */
     getEndpointData: (endpoint, options) => {
       return queryClient.getQueryData(endpoint.$queryKey(options));
     }

package/dist/react.mjs

@@ -27,11 +27,11 @@ function useApiInfiniteQuery(endpoint, ...args) {
   return useInfiniteQuery({
     queryKey,
     queryFn: ({ pageParam }) => {
-      const fetchOptions = { ...options };
-      if (pageParam !== void 0) {
-        fetchOptions.query = { ...fetchOptions.query || {}, page: pageParam };
-      }
-      return endpoint(fetchOptions);
+      const callOptions = {
+        ...options,
+        query: { ...options?.query, page: pageParam }
+      };
+      return endpoint(callOptions);
     },
     ...queryOptions
   });
@@ -61,35 +61,20 @@ function useApiQueryClient() {
   const queryClient = useQueryClient2();
   return {
     queryClient,
-    /**
-     * Invalidate specific queries related to an endpoint.
-     * Optionally pass parameters to invalidate a more specific cache entry.
-     */
     invalidateEndpoint: (endpoint, options) => {
       return queryClient.invalidateQueries({
         queryKey: endpoint.$queryKey(options)
       });
     },
-    /**
-     * Prefetch data for an endpoint into the cache.
-     * Useful for SSR, RSC hydration, or proactive prefetching.
-     */
     prefetchEndpoint: (endpoint, options) => {
       return queryClient.prefetchQuery({
         queryKey: endpoint.$queryKey(options),
         queryFn: () => endpoint(options)
       });
     },
-    /**
-     * Manually update the cache for a specific endpoint.
-     * Often used for optimistic updates in mutations.
-     */
     setEndpointData: (endpoint, options, updater) => {
       return queryClient.setQueryData(endpoint.$queryKey(options), updater);
     },
-    /**
-     * Retrieve the current cached data for a specific endpoint.
-     */
     getEndpointData: (endpoint, options) => {
       return queryClient.getQueryData(endpoint.$queryKey(options));
     }

package/dist/sdk.d.mts

@@ -131,7 +131,10 @@ type EndpointCallableOptions<TParams, TBody> = (unknown extends TParams ? {} : {
     query?: Record<string, any>;
     headers?: Record<string, string>;
 };
-type OptionalIfEmpty<T> = keyof Omit<T, 'query' | 'headers'> extends never ? [options?: T] : [options: T];
+type RequiredKeys<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? never : K;
+}[keyof T];
+type OptionalIfEmpty<T> = RequiredKeys<Omit<T, 'query' | 'headers'>> extends never ? [options?: T] : [options: T];
 interface ApiError {
     message: string;
     status?: number;
@@ -139,12 +142,14 @@ interface ApiError {
 }
 interface EndpointCallable<TResponse = unknown, TParams = unknown, TBody = unknown> {
     (...args: OptionalIfEmpty<EndpointCallableOptions<TParams, TBody>>): Promise<TResponse>;
+    (options: EndpointCallableOptions<TParams, TBody> | undefined): Promise<TResponse>;
+    (options: CallOptions<TParams, TBody>): Promise<TResponse>;
     /** Original RouteDefinition — used by useApiQuery / useApiMutation */
     $def: RouteDefinition<TResponse, TParams, TBody>;
     /** Stable TanStack query key: [group, action] */
     $key: string[];
     /** Consistent query key builder that incorporates params/query if provided */
-    $queryKey: (...args: OptionalIfEmpty<EndpointCallableOptions<TParams, TBody>>) => unknown[];
+    $queryKey: (options?: EndpointCallableOptions<TParams, TBody>) => unknown[];
 }
 type ApiGroupProxy<G extends Record<string, RouteDefinition<any, any, any>>> = {
     [K in keyof G]: EndpointCallable<G[K] extends RouteDefinition<infer R, any, any> ? R : unknown, G[K] extends RouteDefinition<any, infer P, any> ? P : unknown, G[K] extends RouteDefinition<any, any, infer B> ? B : unknown>;

package/dist/sdk.d.ts

@@ -131,7 +131,10 @@ type EndpointCallableOptions<TParams, TBody> = (unknown extends TParams ? {} : {
     query?: Record<string, any>;
     headers?: Record<string, string>;
 };
-type OptionalIfEmpty<T> = keyof Omit<T, 'query' | 'headers'> extends never ? [options?: T] : [options: T];
+type RequiredKeys<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? never : K;
+}[keyof T];
+type OptionalIfEmpty<T> = RequiredKeys<Omit<T, 'query' | 'headers'>> extends never ? [options?: T] : [options: T];
 interface ApiError {
     message: string;
     status?: number;
@@ -139,12 +142,14 @@ interface ApiError {
 }
 interface EndpointCallable<TResponse = unknown, TParams = unknown, TBody = unknown> {
     (...args: OptionalIfEmpty<EndpointCallableOptions<TParams, TBody>>): Promise<TResponse>;
+    (options: EndpointCallableOptions<TParams, TBody> | undefined): Promise<TResponse>;
+    (options: CallOptions<TParams, TBody>): Promise<TResponse>;
     /** Original RouteDefinition — used by useApiQuery / useApiMutation */
     $def: RouteDefinition<TResponse, TParams, TBody>;
     /** Stable TanStack query key: [group, action] */
     $key: string[];
     /** Consistent query key builder that incorporates params/query if provided */
-    $queryKey: (...args: OptionalIfEmpty<EndpointCallableOptions<TParams, TBody>>) => unknown[];
+    $queryKey: (options?: EndpointCallableOptions<TParams, TBody>) => unknown[];
 }
 type ApiGroupProxy<G extends Record<string, RouteDefinition<any, any, any>>> = {
     [K in keyof G]: EndpointCallable<G[K] extends RouteDefinition<infer R, any, any> ? R : unknown, G[K] extends RouteDefinition<any, infer P, any> ? P : unknown, G[K] extends RouteDefinition<any, any, infer B> ? B : unknown>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "routesync",
-  "version": "1.0.28",
+  "version": "1.0.30",
   "description": "Laravel routes to typed frontend SDKs.",
   "main": "./dist/sdk.js",
   "module": "./dist/sdk.mjs",