routesync 1.0.18 → 1.0.20

package/dist/core.d.mts

@@ -12,6 +12,14 @@ interface ServiceConfig {
     timeout?: number;
     retry?: RetryConfig;
     cache?: boolean;
+    validateResponse?: boolean;
+    onValidationError?: (error: unknown, context: {
+        endpoint: string;
+        method: string;
+        path: string;
+        request: unknown;
+        response: unknown;
+    }) => void;
 }
 interface RetryConfig {
     attempts: number;
@@ -27,6 +35,7 @@ interface AuthConfig {
 
 declare class HttpClient {
     private client;
+    readonly config: ServiceConfig;
     constructor(config: ServiceConfig);
     private setupInterceptors;
     setToken(token: string): void;
@@ -73,11 +82,15 @@ interface RequestOptions {
     timeout?: number;
     signal?: AbortSignal;
 }
-interface RouteDefinition {
+interface ResponseSchema<T> {
+    parse(input: unknown): T;
+}
+interface RouteDefinition<TResponse = unknown, TParams = unknown, TBody = unknown> {
     method: HttpMethod;
     path: string;
     auth?: boolean;
     schema?: RouteSchema;
+    responseSchema?: ResponseSchema<TResponse>;
     mapper?: RouteMapper;
     headers?: Record<string, string>;
     cache?: unknown;
@@ -85,10 +98,13 @@ interface RouteDefinition {
     body?: Record<string, any>;
     params?: Record<string, any>;
     query?: Record<string, any>;
+    _typeResponse?: TResponse;
+    _typeParams?: TParams;
+    _typeBody?: TBody;
 }
 interface ApiDefinition {
     [group: string]: {
-        [action: string]: RouteDefinition;
+        [action: string]: RouteDefinition<any, any, any>;
     };
 }
 
@@ -218,6 +234,10 @@ interface ParsedRoute {
     schema?: Record<string, any>;
     group?: string;
     action?: string;
+    response?: {
+        type: string;
+        collection: boolean;
+    };
 }
 interface ParsedColumn {
     name: string;
@@ -233,4 +253,4 @@ interface ParsedModel {
     casts?: Record<string, string>;
 }
 
-export { type ApiDefinition, ApiError, type ApiResponse, type AuthConfig, AuthMiddleware, ErrorHandler, HttpClient, type HttpMethod, Interceptor, type PaginationMeta, type ParsedChannel, type ParsedColumn, type ParsedModel, type ParsedRoute, PathResolver, QueryBuilder, Request, type RequestOptions, Response, type RetryConfig, type RouteDefinition, type RouteManifest, type RouteMapper, type RouteParserSchema, type RouteSchema, type RouteSchemaMap, type RouteSchemaValue, type RouteTransform, type RouteTransformMap, type ServiceConfig, TokenManager, camelCase, camelCaseKeys, snakeCase, snakeCaseKeys };
+export { type ApiDefinition, ApiError, type ApiResponse, type AuthConfig, AuthMiddleware, ErrorHandler, HttpClient, type HttpMethod, Interceptor, type PaginationMeta, type ParsedChannel, type ParsedColumn, type ParsedModel, type ParsedRoute, PathResolver, QueryBuilder, Request, type RequestOptions, Response, type ResponseSchema, type RetryConfig, type RouteDefinition, type RouteManifest, type RouteMapper, type RouteParserSchema, type RouteSchema, type RouteSchemaMap, type RouteSchemaValue, type RouteTransform, type RouteTransformMap, type ServiceConfig, TokenManager, camelCase, camelCaseKeys, snakeCase, snakeCaseKeys };

package/dist/core.d.ts

@@ -12,6 +12,14 @@ interface ServiceConfig {
     timeout?: number;
     retry?: RetryConfig;
     cache?: boolean;
+    validateResponse?: boolean;
+    onValidationError?: (error: unknown, context: {
+        endpoint: string;
+        method: string;
+        path: string;
+        request: unknown;
+        response: unknown;
+    }) => void;
 }
 interface RetryConfig {
     attempts: number;
@@ -27,6 +35,7 @@ interface AuthConfig {
 
 declare class HttpClient {
     private client;
+    readonly config: ServiceConfig;
     constructor(config: ServiceConfig);
     private setupInterceptors;
     setToken(token: string): void;
@@ -73,11 +82,15 @@ interface RequestOptions {
     timeout?: number;
     signal?: AbortSignal;
 }
-interface RouteDefinition {
+interface ResponseSchema<T> {
+    parse(input: unknown): T;
+}
+interface RouteDefinition<TResponse = unknown, TParams = unknown, TBody = unknown> {
     method: HttpMethod;
     path: string;
     auth?: boolean;
     schema?: RouteSchema;
+    responseSchema?: ResponseSchema<TResponse>;
     mapper?: RouteMapper;
     headers?: Record<string, string>;
     cache?: unknown;
@@ -85,10 +98,13 @@ interface RouteDefinition {
     body?: Record<string, any>;
     params?: Record<string, any>;
     query?: Record<string, any>;
+    _typeResponse?: TResponse;
+    _typeParams?: TParams;
+    _typeBody?: TBody;
 }
 interface ApiDefinition {
     [group: string]: {
-        [action: string]: RouteDefinition;
+        [action: string]: RouteDefinition<any, any, any>;
     };
 }
 
@@ -218,6 +234,10 @@ interface ParsedRoute {
     schema?: Record<string, any>;
     group?: string;
     action?: string;
+    response?: {
+        type: string;
+        collection: boolean;
+    };
 }
 interface ParsedColumn {
     name: string;
@@ -233,4 +253,4 @@ interface ParsedModel {
     casts?: Record<string, string>;
 }
 
-export { type ApiDefinition, ApiError, type ApiResponse, type AuthConfig, AuthMiddleware, ErrorHandler, HttpClient, type HttpMethod, Interceptor, type PaginationMeta, type ParsedChannel, type ParsedColumn, type ParsedModel, type ParsedRoute, PathResolver, QueryBuilder, Request, type RequestOptions, Response, type RetryConfig, type RouteDefinition, type RouteManifest, type RouteMapper, type RouteParserSchema, type RouteSchema, type RouteSchemaMap, type RouteSchemaValue, type RouteTransform, type RouteTransformMap, type ServiceConfig, TokenManager, camelCase, camelCaseKeys, snakeCase, snakeCaseKeys };
+export { type ApiDefinition, ApiError, type ApiResponse, type AuthConfig, AuthMiddleware, ErrorHandler, HttpClient, type HttpMethod, Interceptor, type PaginationMeta, type ParsedChannel, type ParsedColumn, type ParsedModel, type ParsedRoute, PathResolver, QueryBuilder, Request, type RequestOptions, Response, type ResponseSchema, type RetryConfig, type RouteDefinition, type RouteManifest, type RouteMapper, type RouteParserSchema, type RouteSchema, type RouteSchemaMap, type RouteSchemaValue, type RouteTransform, type RouteTransformMap, type ServiceConfig, TokenManager, camelCase, camelCaseKeys, snakeCase, snakeCaseKeys };

package/dist/core.js

@@ -87,6 +87,7 @@ function snakeCaseKeys(obj) {
 var import_axios = __toESM(require("axios"));
 var HttpClient = class {
   constructor(config) {
+    this.config = config;
     this.client = import_axios.default.create({
       baseURL: config.baseURL,
       timeout: config.timeout ?? 1e4,

package/dist/core.mjs

@@ -38,6 +38,7 @@ function snakeCaseKeys(obj) {
 import axios from "axios";
 var HttpClient = class {
   constructor(config) {
+    this.config = config;
     this.client = axios.create({
       baseURL: config.baseURL,
       timeout: config.timeout ?? 1e4,

package/dist/react.d.mts

@@ -24,11 +24,15 @@ interface RouteSchemaMap {
 }
 type RouteSchemaValue = RouteTransform | RouteParserSchema;
 type RouteSchema = RouteSchemaValue | RouteSchemaMap;
-interface RouteDefinition {
+interface ResponseSchema<T> {
+    parse(input: unknown): T;
+}
+interface RouteDefinition<TResponse = unknown, TParams = unknown, TBody = unknown> {
     method: HttpMethod;
     path: string;
     auth?: boolean;
     schema?: RouteSchema;
+    responseSchema?: ResponseSchema<TResponse>;
     mapper?: RouteMapper;
     headers?: Record<string, string>;
     cache?: unknown;
@@ -36,20 +40,33 @@ interface RouteDefinition {
     body?: Record<string, any>;
     params?: Record<string, any>;
     query?: Record<string, any>;
+    _typeResponse?: TResponse;
+    _typeParams?: TParams;
+    _typeBody?: TBody;
 }
 
-type CallOptions = {
-    params?: Record<string, any>;
+type EndpointCallableOptions<TParams, TBody> = (unknown extends TParams ? {} : {
+    params: TParams;
+}) & (unknown extends TBody ? {} : {
+    body: TBody;
+}) & {
     query?: Record<string, any>;
-    body?: Record<string, any>;
     headers?: Record<string, string>;
 };
-interface EndpointCallable {
-    <TResponse = unknown>(options?: CallOptions): Promise<TResponse>;
+type OptionalIfEmpty<T> = keyof Omit<T, 'query' | 'headers'> extends never ? [options?: T] : [options: T];
+interface ApiError {
+    message: string;
+    status?: number;
+    errors?: Record<string, string[]>;
+}
+interface EndpointCallable<TResponse = unknown, TParams = unknown, TBody = unknown> {
+    (...args: OptionalIfEmpty<EndpointCallableOptions<TParams, TBody>>): Promise<TResponse>;
     /** Original RouteDefinition — used by useApiQuery / useApiMutation */
-    $def: RouteDefinition;
+    $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[];
 }
 
 /**
@@ -59,7 +76,10 @@ interface EndpointCallable {
  *   const { data, isLoading } = useApiQuery(api.produk.list)
  *   const { data } = useApiQuery(api.produk.detail, { params: { id: 10 } })
  */
-declare function useApiQuery<T = any>(endpoint: EndpointCallable, options?: CallOptions, queryOptions?: Omit<UseQueryOptions<T>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<T>, Error>;
+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'>
+]): _tanstack_react_query.UseQueryResult<NoInfer<TData>, TError>;
 
 /**
  * useApiMutation — accepts an endpoint callable directly.
@@ -74,11 +94,11 @@ declare function useApiQuery<T = any>(endpoint: EndpointCallable, options?: Call
  *     invalidate: [api.cart.list, api.orders.index],
  *   })
  */
-interface ApiMutationOptions<TData, TVariables> extends Omit<UseMutationOptions<TData, unknown, TVariables>, 'mutationFn'> {
+interface ApiMutationOptions<TData, TError, TVariables> extends Omit<UseMutationOptions<TData, TError, TVariables>, 'mutationFn'> {
     /** Extra endpoints to invalidate on success (in addition to the auto group invalidation). */
-    invalidate?: EndpointCallable[];
+    invalidate?: EndpointCallable<any, any, any>[];
 }
-declare function useApiMutation<TData = any, TVariables extends CallOptions = CallOptions>(endpoint: EndpointCallable, options?: ApiMutationOptions<TData, TVariables>): _tanstack_react_query.UseMutationResult<TData, unknown, TVariables, unknown>;
+declare function useApiMutation<TResponse = unknown, TParams = unknown, TBody = unknown, TError = ApiError>(endpoint: EndpointCallable<TResponse, TParams, TBody>, options?: ApiMutationOptions<TResponse, TError, EndpointCallableOptions<TParams, TBody>>): _tanstack_react_query.UseMutationResult<TResponse, TError, EndpointCallableOptions<TParams, TBody>, unknown>;
 
 /**
  * createHooks — generate typed hooks from an api group.

package/dist/react.d.ts

@@ -24,11 +24,15 @@ interface RouteSchemaMap {
 }
 type RouteSchemaValue = RouteTransform | RouteParserSchema;
 type RouteSchema = RouteSchemaValue | RouteSchemaMap;
-interface RouteDefinition {
+interface ResponseSchema<T> {
+    parse(input: unknown): T;
+}
+interface RouteDefinition<TResponse = unknown, TParams = unknown, TBody = unknown> {
     method: HttpMethod;
     path: string;
     auth?: boolean;
     schema?: RouteSchema;
+    responseSchema?: ResponseSchema<TResponse>;
     mapper?: RouteMapper;
     headers?: Record<string, string>;
     cache?: unknown;
@@ -36,20 +40,33 @@ interface RouteDefinition {
     body?: Record<string, any>;
     params?: Record<string, any>;
     query?: Record<string, any>;
+    _typeResponse?: TResponse;
+    _typeParams?: TParams;
+    _typeBody?: TBody;
 }
 
-type CallOptions = {
-    params?: Record<string, any>;
+type EndpointCallableOptions<TParams, TBody> = (unknown extends TParams ? {} : {
+    params: TParams;
+}) & (unknown extends TBody ? {} : {
+    body: TBody;
+}) & {
     query?: Record<string, any>;
-    body?: Record<string, any>;
     headers?: Record<string, string>;
 };
-interface EndpointCallable {
-    <TResponse = unknown>(options?: CallOptions): Promise<TResponse>;
+type OptionalIfEmpty<T> = keyof Omit<T, 'query' | 'headers'> extends never ? [options?: T] : [options: T];
+interface ApiError {
+    message: string;
+    status?: number;
+    errors?: Record<string, string[]>;
+}
+interface EndpointCallable<TResponse = unknown, TParams = unknown, TBody = unknown> {
+    (...args: OptionalIfEmpty<EndpointCallableOptions<TParams, TBody>>): Promise<TResponse>;
     /** Original RouteDefinition — used by useApiQuery / useApiMutation */
-    $def: RouteDefinition;
+    $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[];
 }
 
 /**
@@ -59,7 +76,10 @@ interface EndpointCallable {
  *   const { data, isLoading } = useApiQuery(api.produk.list)
  *   const { data } = useApiQuery(api.produk.detail, { params: { id: 10 } })
  */
-declare function useApiQuery<T = any>(endpoint: EndpointCallable, options?: CallOptions, queryOptions?: Omit<UseQueryOptions<T>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<T>, Error>;
+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'>
+]): _tanstack_react_query.UseQueryResult<NoInfer<TData>, TError>;
 
 /**
  * useApiMutation — accepts an endpoint callable directly.
@@ -74,11 +94,11 @@ declare function useApiQuery<T = any>(endpoint: EndpointCallable, options?: Call
  *     invalidate: [api.cart.list, api.orders.index],
  *   })
  */
-interface ApiMutationOptions<TData, TVariables> extends Omit<UseMutationOptions<TData, unknown, TVariables>, 'mutationFn'> {
+interface ApiMutationOptions<TData, TError, TVariables> extends Omit<UseMutationOptions<TData, TError, TVariables>, 'mutationFn'> {
     /** Extra endpoints to invalidate on success (in addition to the auto group invalidation). */
-    invalidate?: EndpointCallable[];
+    invalidate?: EndpointCallable<any, any, any>[];
 }
-declare function useApiMutation<TData = any, TVariables extends CallOptions = CallOptions>(endpoint: EndpointCallable, options?: ApiMutationOptions<TData, TVariables>): _tanstack_react_query.UseMutationResult<TData, unknown, TVariables, unknown>;
+declare function useApiMutation<TResponse = unknown, TParams = unknown, TBody = unknown, TError = ApiError>(endpoint: EndpointCallable<TResponse, TParams, TBody>, options?: ApiMutationOptions<TResponse, TError, EndpointCallableOptions<TParams, TBody>>): _tanstack_react_query.UseMutationResult<TResponse, TError, EndpointCallableOptions<TParams, TBody>, unknown>;
 
 /**
  * createHooks — generate typed hooks from an api group.

package/dist/react.js

@@ -28,8 +28,10 @@ module.exports = __toCommonJS(src_exports);
 
 // packages/react/src/hooks/useQuery.ts
 var import_react_query = require("@tanstack/react-query");
-function useApiQuery(endpoint, options, queryOptions) {
-  const queryKey = options ? [...endpoint.$key, options] : endpoint.$key;
+function useApiQuery(endpoint, ...args) {
+  const options = args[0];
+  const queryOptions = args[1];
+  const queryKey = endpoint.$queryKey(options);
   return (0, import_react_query.useQuery)({
     queryKey,
     queryFn: () => endpoint(options),

package/dist/react.mjs

@@ -1,7 +1,9 @@
 // packages/react/src/hooks/useQuery.ts
 import { useQuery } from "@tanstack/react-query";
-function useApiQuery(endpoint, options, queryOptions) {
-  const queryKey = options ? [...endpoint.$key, options] : endpoint.$key;
+function useApiQuery(endpoint, ...args) {
+  const options = args[0];
+  const queryOptions = args[1];
+  const queryKey = endpoint.$queryKey(options);
   return useQuery({
     queryKey,
     queryFn: () => endpoint(options),

package/dist/sdk.d.mts

@@ -7,6 +7,14 @@ interface ServiceConfig {
     timeout?: number;
     retry?: RetryConfig;
     cache?: boolean;
+    validateResponse?: boolean;
+    onValidationError?: (error: unknown, context: {
+        endpoint: string;
+        method: string;
+        path: string;
+        request: unknown;
+        response: unknown;
+    }) => void;
 }
 interface RetryConfig {
     attempts: number;
@@ -16,6 +24,7 @@ interface RetryConfig {
 
 declare class HttpClient {
     private client;
+    readonly config: ServiceConfig;
     constructor(config: ServiceConfig);
     private setupInterceptors;
     setToken(token: string): void;
@@ -56,11 +65,15 @@ interface RouteSchemaMap {
 }
 type RouteSchemaValue = RouteTransform | RouteParserSchema;
 type RouteSchema = RouteSchemaValue | RouteSchemaMap;
-interface RouteDefinition {
+interface ResponseSchema<T> {
+    parse(input: unknown): T;
+}
+interface RouteDefinition<TResponse = unknown, TParams = unknown, TBody = unknown> {
     method: HttpMethod;
     path: string;
     auth?: boolean;
     schema?: RouteSchema;
+    responseSchema?: ResponseSchema<TResponse>;
     mapper?: RouteMapper;
     headers?: Record<string, string>;
     cache?: unknown;
@@ -68,10 +81,13 @@ interface RouteDefinition {
     body?: Record<string, any>;
     params?: Record<string, any>;
     query?: Record<string, any>;
+    _typeResponse?: TResponse;
+    _typeParams?: TParams;
+    _typeBody?: TBody;
 }
 interface ApiDefinition {
     [group: string]: {
-        [action: string]: RouteDefinition;
+        [action: string]: RouteDefinition<any, any, any>;
     };
 }
 
@@ -99,21 +115,37 @@ declare class TokenManager {
     exists(): boolean;
 }
 
-type CallOptions = {
-    params?: Record<string, any>;
+type CallOptions<TParams = unknown, TBody = unknown> = {
+    params?: TParams;
     query?: Record<string, any>;
-    body?: Record<string, any>;
+    body?: TBody;
     headers?: Record<string, string>;
 };
-interface EndpointCallable {
-    <TResponse = unknown>(options?: CallOptions): Promise<TResponse>;
+type EndpointCallableOptions<TParams, TBody> = (unknown extends TParams ? {} : {
+    params: TParams;
+}) & (unknown extends TBody ? {} : {
+    body: TBody;
+}) & {
+    query?: Record<string, any>;
+    headers?: Record<string, string>;
+};
+type OptionalIfEmpty<T> = keyof Omit<T, 'query' | 'headers'> extends never ? [options?: T] : [options: T];
+interface ApiError {
+    message: string;
+    status?: number;
+    errors?: Record<string, string[]>;
+}
+interface EndpointCallable<TResponse = unknown, TParams = unknown, TBody = unknown> {
+    (...args: OptionalIfEmpty<EndpointCallableOptions<TParams, TBody>>): Promise<TResponse>;
     /** Original RouteDefinition — used by useApiQuery / useApiMutation */
-    $def: RouteDefinition;
+    $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[];
 }
-type ApiGroupProxy<G extends Record<string, RouteDefinition>> = {
-    [K in keyof G]: EndpointCallable;
+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>;
 };
 type ApiProxy<T extends ApiDefinition> = {
     [G in keyof T]: ApiGroupProxy<T[G]>;
@@ -139,7 +171,7 @@ type EndpointDefinition$1 = RouteDefinition;
  *   const { data } = useApiQuery(api.cart.list)
  *   const mutation = useApiMutation(api.cart.create)
  */
-declare function endpoint(def: RouteDefinition): RouteDefinition;
+declare function endpoint<TResponse = unknown, TParams = unknown, TBody = unknown>(def: RouteDefinition<TResponse, TParams, TBody>): RouteDefinition<TResponse, TParams, TBody>;
 
 type EndpointDefinition = RouteDefinition;
 interface ResourceConfig<TEndpoints extends Record<string, EndpointDefinition>> {
@@ -271,4 +303,4 @@ declare function mapKeysDeep<T>(value: T, keyCase: KeyCase): T;
 declare function toCamelCase<T>(value: T): T;
 declare function toSnakeCase<T>(value: T): T;
 
-export { type ApiDefinition, type ApiResponse, type CallOptions, type CamelCasedPropertiesDeep, type CamelToSnake, type EndpointCallable, type EndpointDefinition$1 as EndpointDefinition, GenericService, type GenericServiceOptions, type HttpMethod, type Id, type KeyCase, type ParseResult, type ParserSchema, type QueryParams, type ResourceConfig, type ResourceDefinition, type RouteDefinition, type RouteMapper, type RouteParserSchema, type RouteSchema, type RouteSchemaMap, type RouteSchemaValue, type RouteTransform, type RouteTransformMap, type SchemaLike, type ServiceConfig, type SnakeCasedPropertiesDeep, type SnakeToCamel, type UnknownRecord, camelToSnakeKey, createClient$1 as createClient, createClient as createHttpClient, createService, defineApi, endpoint, generateHooks, mapKeysDeep, parseWithSchema, resource, snakeToCamelKey, toCamelCase, toSnakeCase };
+export { type ApiDefinition, type ApiError, type ApiResponse, type CallOptions, type CamelCasedPropertiesDeep, type CamelToSnake, type EndpointCallable, type EndpointCallableOptions, type EndpointDefinition$1 as EndpointDefinition, GenericService, type GenericServiceOptions, type HttpMethod, type Id, type KeyCase, type OptionalIfEmpty, type ParseResult, type ParserSchema, type QueryParams, type ResourceConfig, type ResourceDefinition, type RouteDefinition, type RouteMapper, type RouteParserSchema, type RouteSchema, type RouteSchemaMap, type RouteSchemaValue, type RouteTransform, type RouteTransformMap, type SchemaLike, type ServiceConfig, type SnakeCasedPropertiesDeep, type SnakeToCamel, type UnknownRecord, camelToSnakeKey, createClient$1 as createClient, createClient as createHttpClient, createService, defineApi, endpoint, generateHooks, mapKeysDeep, parseWithSchema, resource, snakeToCamelKey, toCamelCase, toSnakeCase };

package/dist/sdk.d.ts

@@ -7,6 +7,14 @@ interface ServiceConfig {
     timeout?: number;
     retry?: RetryConfig;
     cache?: boolean;
+    validateResponse?: boolean;
+    onValidationError?: (error: unknown, context: {
+        endpoint: string;
+        method: string;
+        path: string;
+        request: unknown;
+        response: unknown;
+    }) => void;
 }
 interface RetryConfig {
     attempts: number;
@@ -16,6 +24,7 @@ interface RetryConfig {
 
 declare class HttpClient {
     private client;
+    readonly config: ServiceConfig;
     constructor(config: ServiceConfig);
     private setupInterceptors;
     setToken(token: string): void;
@@ -56,11 +65,15 @@ interface RouteSchemaMap {
 }
 type RouteSchemaValue = RouteTransform | RouteParserSchema;
 type RouteSchema = RouteSchemaValue | RouteSchemaMap;
-interface RouteDefinition {
+interface ResponseSchema<T> {
+    parse(input: unknown): T;
+}
+interface RouteDefinition<TResponse = unknown, TParams = unknown, TBody = unknown> {
     method: HttpMethod;
     path: string;
     auth?: boolean;
     schema?: RouteSchema;
+    responseSchema?: ResponseSchema<TResponse>;
     mapper?: RouteMapper;
     headers?: Record<string, string>;
     cache?: unknown;
@@ -68,10 +81,13 @@ interface RouteDefinition {
     body?: Record<string, any>;
     params?: Record<string, any>;
     query?: Record<string, any>;
+    _typeResponse?: TResponse;
+    _typeParams?: TParams;
+    _typeBody?: TBody;
 }
 interface ApiDefinition {
     [group: string]: {
-        [action: string]: RouteDefinition;
+        [action: string]: RouteDefinition<any, any, any>;
     };
 }
 
@@ -99,21 +115,37 @@ declare class TokenManager {
     exists(): boolean;
 }
 
-type CallOptions = {
-    params?: Record<string, any>;
+type CallOptions<TParams = unknown, TBody = unknown> = {
+    params?: TParams;
     query?: Record<string, any>;
-    body?: Record<string, any>;
+    body?: TBody;
     headers?: Record<string, string>;
 };
-interface EndpointCallable {
-    <TResponse = unknown>(options?: CallOptions): Promise<TResponse>;
+type EndpointCallableOptions<TParams, TBody> = (unknown extends TParams ? {} : {
+    params: TParams;
+}) & (unknown extends TBody ? {} : {
+    body: TBody;
+}) & {
+    query?: Record<string, any>;
+    headers?: Record<string, string>;
+};
+type OptionalIfEmpty<T> = keyof Omit<T, 'query' | 'headers'> extends never ? [options?: T] : [options: T];
+interface ApiError {
+    message: string;
+    status?: number;
+    errors?: Record<string, string[]>;
+}
+interface EndpointCallable<TResponse = unknown, TParams = unknown, TBody = unknown> {
+    (...args: OptionalIfEmpty<EndpointCallableOptions<TParams, TBody>>): Promise<TResponse>;
     /** Original RouteDefinition — used by useApiQuery / useApiMutation */
-    $def: RouteDefinition;
+    $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[];
 }
-type ApiGroupProxy<G extends Record<string, RouteDefinition>> = {
-    [K in keyof G]: EndpointCallable;
+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>;
 };
 type ApiProxy<T extends ApiDefinition> = {
     [G in keyof T]: ApiGroupProxy<T[G]>;
@@ -139,7 +171,7 @@ type EndpointDefinition$1 = RouteDefinition;
  *   const { data } = useApiQuery(api.cart.list)
  *   const mutation = useApiMutation(api.cart.create)
  */
-declare function endpoint(def: RouteDefinition): RouteDefinition;
+declare function endpoint<TResponse = unknown, TParams = unknown, TBody = unknown>(def: RouteDefinition<TResponse, TParams, TBody>): RouteDefinition<TResponse, TParams, TBody>;
 
 type EndpointDefinition = RouteDefinition;
 interface ResourceConfig<TEndpoints extends Record<string, EndpointDefinition>> {
@@ -271,4 +303,4 @@ declare function mapKeysDeep<T>(value: T, keyCase: KeyCase): T;
 declare function toCamelCase<T>(value: T): T;
 declare function toSnakeCase<T>(value: T): T;
 
-export { type ApiDefinition, type ApiResponse, type CallOptions, type CamelCasedPropertiesDeep, type CamelToSnake, type EndpointCallable, type EndpointDefinition$1 as EndpointDefinition, GenericService, type GenericServiceOptions, type HttpMethod, type Id, type KeyCase, type ParseResult, type ParserSchema, type QueryParams, type ResourceConfig, type ResourceDefinition, type RouteDefinition, type RouteMapper, type RouteParserSchema, type RouteSchema, type RouteSchemaMap, type RouteSchemaValue, type RouteTransform, type RouteTransformMap, type SchemaLike, type ServiceConfig, type SnakeCasedPropertiesDeep, type SnakeToCamel, type UnknownRecord, camelToSnakeKey, createClient$1 as createClient, createClient as createHttpClient, createService, defineApi, endpoint, generateHooks, mapKeysDeep, parseWithSchema, resource, snakeToCamelKey, toCamelCase, toSnakeCase };
+export { type ApiDefinition, type ApiError, type ApiResponse, type CallOptions, type CamelCasedPropertiesDeep, type CamelToSnake, type EndpointCallable, type EndpointCallableOptions, type EndpointDefinition$1 as EndpointDefinition, GenericService, type GenericServiceOptions, type HttpMethod, type Id, type KeyCase, type OptionalIfEmpty, type ParseResult, type ParserSchema, type QueryParams, type ResourceConfig, type ResourceDefinition, type RouteDefinition, type RouteMapper, type RouteParserSchema, type RouteSchema, type RouteSchemaMap, type RouteSchemaValue, type RouteTransform, type RouteTransformMap, type SchemaLike, type ServiceConfig, type SnakeCasedPropertiesDeep, type SnakeToCamel, type UnknownRecord, camelToSnakeKey, createClient$1 as createClient, createClient as createHttpClient, createService, defineApi, endpoint, generateHooks, mapKeysDeep, parseWithSchema, resource, snakeToCamelKey, toCamelCase, toSnakeCase };

package/dist/sdk.js

@@ -87,6 +87,7 @@ function snakeCaseKeys(obj) {
 var import_axios = __toESM(require("axios"));
 var HttpClient = class {
   constructor(config) {
+    this.config = config;
     this.client = import_axios.default.create({
       baseURL: config.baseURL,
       timeout: config.timeout ?? 1e4,
@@ -344,14 +345,35 @@ function defineApi(definition, config) {
         } else {
           response = await client[method](resolvedPath, body, requestConfig);
         }
+        if (client.config.validateResponse && route.responseSchema) {
+          try {
+            response = route.responseSchema.parse(response);
+          } catch (error) {
+            if (client.config.onValidationError) {
+              client.config.onValidationError(error, {
+                endpoint: action,
+                method: route.method,
+                path: resolvedPath,
+                request: { params, query, body, headers: requestConfig.headers },
+                response
+              });
+            }
+            throw error;
+          }
+        } else if (client.config.validateResponse) {
+          response = parseRouteSchema(route, "response", response);
+        }
         return applyMapper(
           route,
           "response",
-          parseRouteSchema(route, "response", response)
+          response
         );
       };
       callable.$def = route;
       callable.$key = [group, action];
+      callable.$queryKey = (options) => {
+        return options ? [group, action, options] : [group, action];
+      };
       groupProxy[action] = callable;
     }
     ;