@b3-business/cherry 0.3.0 → 0.3.2

package/README.md

@@ -10,12 +10,9 @@ A tree-shakeable, minimal API client factory. Import only the routes you need
 
 ---
 
-## Latest Changelog - 0.3.0
+## Latest Changelog - 0.3.2
 
-- Fix: Simplify type inference for void params using the same technique as event-bus-core
-- Fix: Allow omitting empty object for calls that don't require params (e.g., `client.listPosts()` instead of `client.listPosts({})`)
-- Fix: Autocomplete for routes now works correctly in IDE
-- Add comprehensive JSDoc comments to types.ts
+- Fix: Ship TypeScript source files in npm package to fix module resolution
 
 See [CHANGELOG.md](https://github.com/b3-business/cherry/blob/main/packages/cherry/CHANGELOG.md) for full history.
 

package/dist/index.d.ts

@@ -54,6 +54,7 @@ declare function isCherryError(error: unknown): error is CherryError;
 declare function cherryErr<T>(error: CherryError): ResultAsync<T, CherryError>;
 //#endregion
 //#region src/types.d.ts
+type AnySchema = BaseSchema<any, any, any>;
 /** HTTP methods supported by Cherry */
 type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
 /** Path template result from path() tagged template */
@@ -62,7 +63,7 @@ type PathTemplate = {
   paramNames: string[];
 };
 /** Route definition with separated parameter schemas */
-type CherryRoute<TPathParams extends BaseSchema<any, any, any> | undefined = undefined, TQueryParams extends BaseSchema<any, any, any> | undefined = undefined, TBodyParams extends BaseSchema<any, any, any> | undefined = undefined, TResponse extends BaseSchema<any, any, any> = BaseSchema<any, any, any>> = {
+type CherryRoute<TPathParams extends AnySchema | undefined = undefined, TQueryParams extends AnySchema | undefined = undefined, TBodyParams extends AnySchema | undefined = undefined, TResponse extends AnySchema = AnySchema> = {
   method: HttpMethod;
   path: PathTemplate;
   pathParams?: TPathParams;
@@ -77,17 +78,18 @@ type QueryParamOptions = {
   arrayFormat?: "repeat" | "comma" | "brackets" | "json";
   customSerializer?: (params: Record<string, unknown>) => string;
 };
+type AnyCherryRoute = CherryRoute<any, any, any, any>;
 type Prettify<T> = { [K in keyof T]: T[K] } & {};
-type HasRequiredKeys<T> = keyof T extends never ? false : true;
-type InferSchemaInput<T> = [T] extends [undefined] ? {} : [NonNullable<T>] extends [never] ? {} : [NonNullable<T>] extends [BaseSchema<any, any, any>] ? InferInput<NonNullable<T>> : {};
+type IsEmptyObject<T> = keyof T extends never ? true : false;
+type InferSchemaInput<T> = T extends AnySchema ? InferInput<T> : {};
 type BuildRouteInputFromProps<TPathParams, TQueryParams, TBodyParams> = InferSchemaInput<TPathParams> & InferSchemaInput<TQueryParams> & InferSchemaInput<TBodyParams>;
 type InferRouteInput<T> = T extends {
   pathParams?: infer TPath;
   queryParams?: infer TQuery;
   bodyParams?: infer TBody;
-} ? HasRequiredKeys<BuildRouteInputFromProps<TPath, TQuery, TBody>> extends true ? Prettify<BuildRouteInputFromProps<TPath, TQuery, TBody>> : void : never;
+} ? IsEmptyObject<BuildRouteInputFromProps<TPath, TQuery, TBody>> extends true ? void : Prettify<BuildRouteInputFromProps<TPath, TQuery, TBody>> : never;
 /** Infer response output from a route */
-type InferRouteOutput<T extends CherryRoute<any, any, any, any>> = T["response"] extends BaseSchema<any, any, any> ? InferOutput<T["response"]> : never;
+type InferRouteOutput<T extends AnyCherryRoute> = T["response"] extends AnySchema ? InferOutput<T["response"]> : never;
 /** Cherry result type - always ResultAsync */
 type CherryResult<T> = ResultAsync<T, CherryError>;
 /** Fetcher request shape (extensible for middleware) */
@@ -99,7 +101,7 @@ type FetchRequest = {
 type Fetcher = (req: FetchRequest) => Promise<Response>;
 /** Route tree (supports namespacing via nested objects) */
 type RouteTree = {
-  [key: string]: CherryRoute<any, any, any, any> | RouteTree;
+  [key: string]: AnyCherryRoute | RouteTree;
 };
 /** Client configuration */
 type ClientConfig<TRoutes extends RouteTree | undefined = undefined> = {
@@ -109,27 +111,17 @@ type ClientConfig<TRoutes extends RouteTree | undefined = undefined> = {
   routes?: TRoutes;
 };
 type Client<TRoutes extends RouteTree | undefined = undefined> = {
-  call: <T extends CherryRoute<any, any, any, any>>(route: T, ...args: InferRouteInput<T> extends void ? [] : [params: InferRouteInput<T>]) => CherryResult<InferRouteOutput<T>>;
+  call: <T extends AnyCherryRoute>(route: T, ...args: InferRouteInput<T> extends void ? [] : [params: InferRouteInput<T>]) => CherryResult<InferRouteOutput<T>>;
 } & (TRoutes extends RouteTree ? RoutesToClient<TRoutes> : {});
 /** Convert a nested route tree into a nested client method tree */
-type RoutesToClient<TRoutes extends RouteTree> = { [K in keyof TRoutes]: TRoutes[K] extends CherryRoute<any, any, any, any> ? InferRouteInput<TRoutes[K]> extends void ? () => CherryResult<InferRouteOutput<TRoutes[K]>> : (params: InferRouteInput<TRoutes[K]>) => CherryResult<InferRouteOutput<TRoutes[K]>> : TRoutes[K] extends RouteTree ? RoutesToClient<TRoutes[K]> : never };
+type RoutesToClient<TRoutes extends RouteTree> = { [K in keyof TRoutes]: TRoutes[K] extends AnyCherryRoute ? InferRouteInput<TRoutes[K]> extends void ? () => CherryResult<InferRouteOutput<TRoutes[K]>> : (params: InferRouteInput<TRoutes[K]>) => CherryResult<InferRouteOutput<TRoutes[K]>> : TRoutes[K] extends RouteTree ? RoutesToClient<TRoutes[K]> : never };
 //#endregion
 //#region src/cherry_client.d.ts
 declare function serializeQueryParams(params: Record<string, unknown>, options?: QueryParamOptions): string;
 declare function createCherryClient<TRoutes extends RouteTree | undefined = undefined>(config: ClientConfig<TRoutes>): Client<TRoutes>;
 //#endregion
 //#region src/route.d.ts
-type RouteConfig<TPathParams extends v.BaseSchema<any, any, any> | undefined = undefined, TQueryParams extends v.BaseSchema<any, any, any> | undefined = undefined, TBodyParams extends v.BaseSchema<any, any, any> | undefined = undefined, TResponse extends v.BaseSchema<any, any, any> = v.BaseSchema<any, any, any>> = {
-  method: HttpMethod;
-  path: PathTemplate;
-  pathParams?: TPathParams;
-  queryParams?: TQueryParams;
-  bodyParams?: TBodyParams;
-  response: TResponse;
-  queryParamOptions?: QueryParamOptions;
-  description?: string;
-};
-declare function route<TPathParams extends v.BaseSchema<any, any, any> | undefined = undefined, TQueryParams extends v.BaseSchema<any, any, any> | undefined = undefined, TBodyParams extends v.BaseSchema<any, any, any> | undefined = undefined, TResponse extends v.BaseSchema<any, any, any> = v.BaseSchema<any, any, any>>(config: RouteConfig<TPathParams, TQueryParams, TBodyParams, TResponse>): CherryRoute<TPathParams, TQueryParams, TBodyParams, TResponse>;
+declare function route<TPathParams extends v.BaseSchema<any, any, any> | undefined = undefined, TQueryParams extends v.BaseSchema<any, any, any> | undefined = undefined, TBodyParams extends v.BaseSchema<any, any, any> | undefined = undefined, TResponse extends v.BaseSchema<any, any, any> = v.BaseSchema<any, any, any>>(config: CherryRoute<TPathParams, TQueryParams, TBodyParams, TResponse>): CherryRoute<TPathParams, TQueryParams, TBodyParams, TResponse>;
 //#endregion
 //#region src/path.d.ts
 /** Branded type for path parameter markers */
@@ -172,5 +164,5 @@ declare function optional<T extends string>(name: T): OptionalParam<T>;
  */
 declare function path(strings: TemplateStringsArray, ...params: AnyPathParam[]): PathTemplate;
 //#endregion
-export { type AnyPathParam, CherryError, type CherryResult, type CherryRoute, type Client, type ClientConfig, type FetchRequest, type Fetcher, HttpError, type HttpMethod, type InferRouteInput, type InferRouteOutput, NetworkError, type OptionalParam, type PathParam, type PathTemplate, type QueryParamOptions, type RouteConfig, type RouteTree, type RoutesToClient, SerializationError, UnknownCherryError, ValidationError, cherryErr, createCherryClient, isCherryError, optional, param, path, route, serializeQueryParams };
+export { type AnyPathParam, CherryError, type CherryResult, type CherryRoute, type Client, type ClientConfig, type FetchRequest, type Fetcher, HttpError, type HttpMethod, type InferRouteInput, type InferRouteOutput, NetworkError, type OptionalParam, type PathParam, type PathTemplate, type QueryParamOptions, type RouteTree, type RoutesToClient, SerializationError, UnknownCherryError, ValidationError, cherryErr, createCherryClient, isCherryError, optional, param, path, route, serializeQueryParams };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/errors.ts","../src/types.ts","../src/cherry_client.ts","../src/route.ts","../src/path.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/errors.ts","../src/types.ts","../src/cherry_client.ts","../src/route.ts","../src/path.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["route","result"],"sources":["../src/errors.ts","../src/cherry_client.ts","../src/route.ts","../src/path.ts"],"sourcesContent":["import { errAsync, ResultAsync } from \"neverthrow\";\n\n/** Base error class for all Cherry errors */\nexport abstract class CherryError extends Error {\n  abstract readonly type: string;\n  abstract readonly retryable: boolean;\n\n  constructor(message: string, options?: { cause?: unknown }) {\n    super(message, options);\n    this.name = this.constructor.name;\n  }\n}\n\n/** HTTP response errors (4xx, 5xx) */\nexport class HttpError extends CherryError {\n  readonly type = \"HttpError\";\n  readonly retryable: boolean;\n\n  constructor(\n    public readonly status: number,\n    public readonly statusText: string,\n    public readonly body?: unknown,\n    cause?: unknown,\n  ) {\n    super(`HTTP ${status}: ${statusText}`, { cause });\n    this.retryable = status >= 500 || status === 429;\n  }\n}\n\n/** Valibot validation errors */\nexport class ValidationError extends CherryError {\n  readonly type = \"ValidationError\";\n  readonly retryable = false;\n\n  constructor(\n    public readonly target: \"request\" | \"response\",\n    public readonly issues: unknown[],\n    cause?: unknown,\n  ) {\n    super(`Validation failed for ${target}`, { cause });\n  }\n}\n\n/** Network/fetch errors */\nexport class NetworkError extends CherryError {\n  readonly type = \"NetworkError\";\n  readonly retryable = true;\n\n  constructor(cause?: unknown) {\n    super(`Network error`, { cause });\n  }\n}\n\n/** Serialization errors (e.g., circular references, BigInt in JSON) */\nexport class SerializationError extends CherryError {\n  readonly type = \"SerializationError\";\n  readonly retryable = false;\n\n  constructor(\n    public readonly target: \"query\" | \"body\",\n    public readonly key: string,\n    cause?: unknown,\n  ) {\n    super(`Failed to serialize ${target} parameter \"${key}\"`, { cause });\n  }\n}\n\n/** Catch-all for unexpected errors */\nexport class UnknownCherryError extends CherryError {\n  readonly type = \"UnknownCherryError\";\n  readonly retryable = false;\n\n  constructor(cause?: unknown) {\n    super(`Unknown error`, { cause });\n  }\n}\n\n/** Type guard for CherryError */\nexport function isCherryError(error: unknown): error is CherryError {\n  return error instanceof CherryError;\n}\n\n/** Helper to create error ResultAsync */\nexport function cherryErr<T>(error: CherryError): ResultAsync<T, CherryError> {\n  return errAsync(error);\n}\n","import { ResultAsync } from \"neverthrow\";\nimport * as v from \"valibot\";\nimport type {\n  CherryRoute,\n  CherryResult,\n  InferRouteInput,\n  InferRouteOutput,\n  Fetcher,\n  FetchRequest,\n  ClientConfig,\n  Client,\n  RouteTree,\n  RoutesToClient,\n  QueryParamOptions,\n} from \"./types\";\nimport { HttpError, ValidationError, NetworkError, SerializationError, UnknownCherryError } from \"./errors\";\n\nconst defaultFetcher: Fetcher = (req) => fetch(req.url, req.init);\n\nexport function serializeQueryParams(\n  params: Record<string, unknown>,\n  options?: QueryParamOptions,\n): string {\n  if (options?.customSerializer) {\n    return options.customSerializer(params);\n  }\n\n  const searchParams = new URLSearchParams();\n\n  for (const [key, value] of Object.entries(params)) {\n    if (value === undefined || value === null) continue;\n\n    if (Array.isArray(value)) {\n      switch (options?.arrayFormat ?? \"repeat\") {\n        case \"repeat\":\n          for (const item of value) {\n            searchParams.append(key, String(item));\n          }\n          break;\n        case \"comma\":\n          searchParams.set(key, value.join(\",\"));\n          break;\n        case \"brackets\":\n          for (const item of value) {\n            searchParams.append(`${key}[]`, String(item));\n          }\n          break;\n        case \"json\":\n          try {\n            searchParams.set(key, JSON.stringify(value));\n          } catch (error) {\n            throw new SerializationError(\"query\", key, error);\n          }\n          break;\n      }\n    } else {\n      searchParams.set(key, String(value));\n    }\n  }\n\n  return searchParams.toString();\n}\n\nexport function createCherryClient<TRoutes extends RouteTree | undefined = undefined>(\n  config: ClientConfig<TRoutes>,\n): Client<TRoutes> {\n  const fetcher = config.fetcher ?? defaultFetcher;\n\n  function call<T extends CherryRoute<any, any, any, any>>(\n    route: T,\n    params: InferRouteInput<T>,\n  ): CherryResult<InferRouteOutput<T>> {\n    return ResultAsync.fromPromise(executeRoute(route, params), (error) => {\n      if (error instanceof HttpError) return error;\n      if (error instanceof ValidationError) return error;\n      if (error instanceof NetworkError) return error;\n      if (error instanceof SerializationError) return error;\n      return new UnknownCherryError(error);\n    });\n  }\n\n  async function executeRoute<T extends CherryRoute<any, any, any, any>>(\n    route: T,\n    params: InferRouteInput<T>,\n  ): Promise<InferRouteOutput<T>> {\n    let pathParams: Record<string, unknown> = {};\n    if (route.pathParams) {\n      const result = v.safeParse(route.pathParams, params);\n      if (!result.success) throw new ValidationError(\"request\", result.issues);\n      pathParams = result.output;\n    }\n\n    let queryParams: Record<string, unknown> = {};\n    if (route.queryParams) {\n      const result = v.safeParse(route.queryParams, params);\n      if (!result.success) throw new ValidationError(\"request\", result.issues);\n      queryParams = result.output;\n    }\n\n    let bodyParams: Record<string, unknown> | undefined;\n    if (route.bodyParams) {\n      const result = v.safeParse(route.bodyParams, params);\n      if (!result.success) throw new ValidationError(\"request\", result.issues);\n      bodyParams = result.output;\n    }\n\n    let url = route.path.template;\n    for (const [key, value] of Object.entries(pathParams)) {\n      url = url.replace(`:${key}`, encodeURIComponent(String(value)));\n    }\n\n    const fullUrl = new URL(url, config.baseUrl);\n\n    if (Object.keys(queryParams).length > 0) {\n      fullUrl.search = serializeQueryParams(queryParams, route.queryParamOptions);\n    }\n\n    const headers: Record<string, string> = {\n      \"Content-Type\": \"application/json\",\n      ...(await config.headers?.()),\n    };\n\n    const init: RequestInit = {\n      method: route.method,\n      headers,\n    };\n\n    if (bodyParams && route.method !== \"GET\") {\n      init.body = JSON.stringify(bodyParams);\n    }\n\n    const req: FetchRequest = {\n      url: fullUrl.toString(),\n      init,\n    };\n\n    let response: Response;\n    try {\n      response = await fetcher(req);\n    } catch (error) {\n      throw new NetworkError(error);\n    }\n\n    if (!response.ok) {\n      const body = await response.text().catch(() => undefined);\n      throw new HttpError(response.status, response.statusText, body);\n    }\n\n    const json = await response.json();\n    const result = v.safeParse(route.response, json);\n    if (!result.success) throw new ValidationError(\"response\", result.issues);\n\n    return result.output;\n  }\n\n  function forgeRouteMethods<T extends RouteTree>(routes: T): RoutesToClient<T> {\n    const out: any = {};\n\n    for (const [key, value] of Object.entries(routes)) {\n      if (value && typeof value === \"object\" && \"method\" in value && \"path\" in value) {\n        out[key] = (params: any) => call(value as any, params);\n      } else if (value && typeof value === \"object\") {\n        out[key] = forgeRouteMethods(value as RouteTree);\n      }\n    }\n\n    return out;\n  }\n\n  const routes = config.routes ? forgeRouteMethods(config.routes) : {};\n  return { call, ...routes } as Client<TRoutes>;\n}\n","import * as v from \"valibot\";\nimport type {\n  CherryRoute,\n  HttpMethod,\n  PathTemplate,\n  QueryParamOptions,\n} from \"./types\";\n\nconst HttpMethodSchema = v.picklist([\"GET\", \"POST\", \"PUT\", \"PATCH\", \"DELETE\"]);\n\nexport type RouteConfig<\n  TPathParams extends v.BaseSchema<any, any, any> | undefined = undefined,\n  TQueryParams extends v.BaseSchema<any, any, any> | undefined = undefined,\n  TBodyParams extends v.BaseSchema<any, any, any> | undefined = undefined,\n  TResponse extends v.BaseSchema<any, any, any> = v.BaseSchema<any, any, any>,\n> = {\n  method: HttpMethod;\n  path: PathTemplate;\n  pathParams?: TPathParams;\n  queryParams?: TQueryParams;\n  bodyParams?: TBodyParams;\n  response: TResponse;\n  queryParamOptions?: QueryParamOptions;\n  description?: string;\n};\n\nexport function route<\n  TPathParams extends v.BaseSchema<any, any, any> | undefined = undefined,\n  TQueryParams extends v.BaseSchema<any, any, any> | undefined = undefined,\n  TBodyParams extends v.BaseSchema<any, any, any> | undefined = undefined,\n  TResponse extends v.BaseSchema<any, any, any> = v.BaseSchema<any, any, any>,\n>(\n  config: RouteConfig<TPathParams, TQueryParams, TBodyParams, TResponse>,\n): CherryRoute<TPathParams, TQueryParams, TBodyParams, TResponse> {\n  // validate HTTP method\n  v.parse(HttpMethodSchema, config.method);\n\n  // validate availability and content of pathParams schema, if needed\n  if (config.path.paramNames.length > 0) {\n    if (!config.pathParams) {\n      throw new Error(\n        `Route has path params [${config.path.paramNames.join(\", \")}] but no pathParams schema`,\n      );\n    }\n\n    const schemaKeys = getSchemaKeys(config.pathParams);\n\n    for (const paramName of config.path.paramNames) {\n      if (!schemaKeys.includes(paramName)) {\n        throw new Error(\n          `Path param \":${paramName}\" not found in pathParams schema. ` +\n            `Available: [${schemaKeys.join(\", \")}]`,\n        );\n      }\n    }\n\n    for (const schemaKey of schemaKeys) {\n      if (!config.path.paramNames.includes(schemaKey)) {\n        throw new Error(\n          `pathParams schema key \"${schemaKey}\" not present in path template. ` +\n            `Template params: [${config.path.paramNames.join(\", \")}]`,\n        );\n      }\n    }\n  }\n\n  return config as CherryRoute<\n    TPathParams,\n    TQueryParams,\n    TBodyParams,\n    TResponse\n  >;\n}\n\nfunction getSchemaKeys(schema: v.BaseSchema<any, any, any>): string[] {\n  if (\n    \"entries\" in schema &&\n    typeof (schema as any).entries === \"object\" &&\n    (schema as any).entries !== null\n  ) {\n    return Object.keys((schema as any).entries);\n  }\n  return [];\n}\n","// path.ts - Tagged template functions for type-safe path building\nimport type { PathTemplate } from \"./types\";\n\n/** Branded type for path parameter markers */\ndeclare const PathParamBrand: unique symbol;\nexport type PathParam<T extends string = string> = string & {\n  readonly [PathParamBrand]: T;\n};\n\n/** Branded type for optional path parameter markers */\ndeclare const OptionalParamBrand: unique symbol;\nexport type OptionalParam<T extends string = string> = string & {\n  readonly [OptionalParamBrand]: T;\n};\n\n/** Union type for any path param marker */\nexport type AnyPathParam = PathParam<string> | OptionalParam<string>;\n\n/** Create a path parameter marker */\nexport function param<T extends string>(name: T): PathParam<T> {\n  return `:${name}` as PathParam<T>;\n}\n\n/** Create an optional path parameter marker */\nexport function optional<T extends string>(name: T): OptionalParam<T> {\n  return `(:${name})` as OptionalParam<T>;\n}\n\n/**\n * Tagged template for building path templates.\n *\n * @example\n * ```ts\n * // Simple path with one param\n * const userPath = path`/users/${param(\"id\")}`;\n * // { template: \"/users/:id\", paramNames: [\"id\"] }\n *\n * // Multiple params\n * const postPath = path`/users/${param(\"userId\")}/posts/${param(\"postId\")}`;\n * // { template: \"/users/:userId/posts/:postId\", paramNames: [\"userId\", \"postId\"] }\n *\n * // Optional params\n * const versionedPath = path`/api${optional(\"version\")}/users`;\n * // { template: \"/api(:version)/users\", paramNames: [\"version\"] }\n *\n * // No params\n * const staticPath = path`/health`;\n * // { template: \"/health\", paramNames: [] }\n * ```\n */\nexport function path(\n  strings: TemplateStringsArray,\n  ...params: AnyPathParam[]\n): PathTemplate {\n  const paramNames: string[] = [];\n  let template = strings[0];\n\n  for (let i = 0; i < params.length; i++) {\n    const p = params[i];\n    template += p + strings[i + 1];\n\n    // Extract param name from `:name` or `(:name)`\n    const match = p.match(/^\\(?:(\\w+)\\)?$/);\n    if (match) {\n      paramNames.push(match[1]);\n    }\n  }\n\n  return { template, paramNames };\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["route","result"],"sources":["../src/errors.ts","../src/cherry_client.ts","../src/route.ts","../src/path.ts"],"sourcesContent":["import { errAsync, ResultAsync } from \"neverthrow\";\n\n/** Base error class for all Cherry errors */\nexport abstract class CherryError extends Error {\n  abstract readonly type: string;\n  abstract readonly retryable: boolean;\n\n  constructor(message: string, options?: { cause?: unknown }) {\n    super(message, options);\n    this.name = this.constructor.name;\n  }\n}\n\n/** HTTP response errors (4xx, 5xx) */\nexport class HttpError extends CherryError {\n  readonly type = \"HttpError\";\n  readonly retryable: boolean;\n\n  constructor(\n    public readonly status: number,\n    public readonly statusText: string,\n    public readonly body?: unknown,\n    cause?: unknown,\n  ) {\n    super(`HTTP ${status}: ${statusText}`, { cause });\n    this.retryable = status >= 500 || status === 429;\n  }\n}\n\n/** Valibot validation errors */\nexport class ValidationError extends CherryError {\n  readonly type = \"ValidationError\";\n  readonly retryable = false;\n\n  constructor(\n    public readonly target: \"request\" | \"response\",\n    public readonly issues: unknown[],\n    cause?: unknown,\n  ) {\n    super(`Validation failed for ${target}`, { cause });\n  }\n}\n\n/** Network/fetch errors */\nexport class NetworkError extends CherryError {\n  readonly type = \"NetworkError\";\n  readonly retryable = true;\n\n  constructor(cause?: unknown) {\n    super(`Network error`, { cause });\n  }\n}\n\n/** Serialization errors (e.g., circular references, BigInt in JSON) */\nexport class SerializationError extends CherryError {\n  readonly type = \"SerializationError\";\n  readonly retryable = false;\n\n  constructor(\n    public readonly target: \"query\" | \"body\",\n    public readonly key: string,\n    cause?: unknown,\n  ) {\n    super(`Failed to serialize ${target} parameter \"${key}\"`, { cause });\n  }\n}\n\n/** Catch-all for unexpected errors */\nexport class UnknownCherryError extends CherryError {\n  readonly type = \"UnknownCherryError\";\n  readonly retryable = false;\n\n  constructor(cause?: unknown) {\n    super(`Unknown error`, { cause });\n  }\n}\n\n/** Type guard for CherryError */\nexport function isCherryError(error: unknown): error is CherryError {\n  return error instanceof CherryError;\n}\n\n/** Helper to create error ResultAsync */\nexport function cherryErr<T>(error: CherryError): ResultAsync<T, CherryError> {\n  return errAsync(error);\n}\n","import { ResultAsync } from \"neverthrow\";\nimport * as v from \"valibot\";\nimport type {\n  CherryRoute,\n  CherryResult,\n  InferRouteInput,\n  InferRouteOutput,\n  Fetcher,\n  FetchRequest,\n  ClientConfig,\n  Client,\n  RouteTree,\n  RoutesToClient,\n  QueryParamOptions,\n} from \"./types\";\nimport { HttpError, ValidationError, NetworkError, SerializationError, UnknownCherryError } from \"./errors\";\n\nconst defaultFetcher: Fetcher = (req) => fetch(req.url, req.init);\n\nexport function serializeQueryParams(\n  params: Record<string, unknown>,\n  options?: QueryParamOptions,\n): string {\n  if (options?.customSerializer) {\n    return options.customSerializer(params);\n  }\n\n  const searchParams = new URLSearchParams();\n\n  for (const [key, value] of Object.entries(params)) {\n    if (value === undefined || value === null) continue;\n\n    if (Array.isArray(value)) {\n      switch (options?.arrayFormat ?? \"repeat\") {\n        case \"repeat\":\n          for (const item of value) {\n            searchParams.append(key, String(item));\n          }\n          break;\n        case \"comma\":\n          searchParams.set(key, value.join(\",\"));\n          break;\n        case \"brackets\":\n          for (const item of value) {\n            searchParams.append(`${key}[]`, String(item));\n          }\n          break;\n        case \"json\":\n          try {\n            searchParams.set(key, JSON.stringify(value));\n          } catch (error) {\n            throw new SerializationError(\"query\", key, error);\n          }\n          break;\n      }\n    } else {\n      searchParams.set(key, String(value));\n    }\n  }\n\n  return searchParams.toString();\n}\n\nexport function createCherryClient<TRoutes extends RouteTree | undefined = undefined>(\n  config: ClientConfig<TRoutes>,\n): Client<TRoutes> {\n  const fetcher = config.fetcher ?? defaultFetcher;\n\n  function call<T extends CherryRoute<any, any, any, any>>(\n    route: T,\n    params: InferRouteInput<T>,\n  ): CherryResult<InferRouteOutput<T>> {\n    return ResultAsync.fromPromise(executeRoute(route, params), (error) => {\n      if (error instanceof HttpError) return error;\n      if (error instanceof ValidationError) return error;\n      if (error instanceof NetworkError) return error;\n      if (error instanceof SerializationError) return error;\n      return new UnknownCherryError(error);\n    });\n  }\n\n  async function executeRoute<T extends CherryRoute<any, any, any, any>>(\n    route: T,\n    params: InferRouteInput<T>,\n  ): Promise<InferRouteOutput<T>> {\n    let pathParams: Record<string, unknown> = {};\n    if (route.pathParams) {\n      const result = v.safeParse(route.pathParams, params);\n      if (!result.success) throw new ValidationError(\"request\", result.issues);\n      pathParams = result.output;\n    }\n\n    let queryParams: Record<string, unknown> = {};\n    if (route.queryParams) {\n      const result = v.safeParse(route.queryParams, params);\n      if (!result.success) throw new ValidationError(\"request\", result.issues);\n      queryParams = result.output;\n    }\n\n    let bodyParams: Record<string, unknown> | undefined;\n    if (route.bodyParams) {\n      const result = v.safeParse(route.bodyParams, params);\n      if (!result.success) throw new ValidationError(\"request\", result.issues);\n      bodyParams = result.output;\n    }\n\n    let url = route.path.template;\n    for (const [key, value] of Object.entries(pathParams)) {\n      url = url.replace(`:${key}`, encodeURIComponent(String(value)));\n    }\n\n    const fullUrl = new URL(url, config.baseUrl);\n\n    if (Object.keys(queryParams).length > 0) {\n      fullUrl.search = serializeQueryParams(queryParams, route.queryParamOptions);\n    }\n\n    const headers: Record<string, string> = {\n      \"Content-Type\": \"application/json\",\n      ...(await config.headers?.()),\n    };\n\n    const init: RequestInit = {\n      method: route.method,\n      headers,\n    };\n\n    if (bodyParams && route.method !== \"GET\") {\n      init.body = JSON.stringify(bodyParams);\n    }\n\n    const req: FetchRequest = {\n      url: fullUrl.toString(),\n      init,\n    };\n\n    let response: Response;\n    try {\n      response = await fetcher(req);\n    } catch (error) {\n      throw new NetworkError(error);\n    }\n\n    if (!response.ok) {\n      const body = await response.text().catch(() => undefined);\n      throw new HttpError(response.status, response.statusText, body);\n    }\n\n    const json = await response.json();\n    const result = v.safeParse(route.response, json);\n    if (!result.success) throw new ValidationError(\"response\", result.issues);\n\n    return result.output;\n  }\n\n  function forgeRouteMethods<T extends RouteTree>(routes: T): RoutesToClient<T> {\n    const out: any = {};\n\n    for (const [key, value] of Object.entries(routes)) {\n      if (value && typeof value === \"object\" && \"method\" in value && \"path\" in value) {\n        out[key] = (params: any) => call(value as any, params);\n      } else if (value && typeof value === \"object\") {\n        out[key] = forgeRouteMethods(value as RouteTree);\n      }\n    }\n\n    return out;\n  }\n\n  const routes = config.routes ? forgeRouteMethods(config.routes) : {};\n  return { call, ...routes } as Client<TRoutes>;\n}\n","import * as v from \"valibot\";\nimport type { CherryRoute } from \"./types\";\n\nconst HttpMethodSchema = v.picklist([\"GET\", \"POST\", \"PUT\", \"PATCH\", \"DELETE\"]);\n\nexport function route<\n  TPathParams extends v.BaseSchema<any, any, any> | undefined = undefined,\n  TQueryParams extends v.BaseSchema<any, any, any> | undefined = undefined,\n  TBodyParams extends v.BaseSchema<any, any, any> | undefined = undefined,\n  TResponse extends v.BaseSchema<any, any, any> = v.BaseSchema<any, any, any>,\n>(\n  config: CherryRoute<TPathParams, TQueryParams, TBodyParams, TResponse>,\n): CherryRoute<TPathParams, TQueryParams, TBodyParams, TResponse> {\n  // validate HTTP method\n  v.parse(HttpMethodSchema, config.method);\n\n  // validate availability and content of pathParams schema, if needed\n  if (config.path.paramNames.length > 0) {\n    if (!config.pathParams) {\n      throw new Error(\n        `Route has path params [${config.path.paramNames.join(\", \")}] but no pathParams schema`,\n      );\n    }\n\n    const schemaKeys = getSchemaKeys(config.pathParams);\n\n    for (const paramName of config.path.paramNames) {\n      if (!schemaKeys.includes(paramName)) {\n        throw new Error(\n          `Path param \":${paramName}\" not found in pathParams schema. ` +\n            `Available: [${schemaKeys.join(\", \")}]`,\n        );\n      }\n    }\n\n    for (const schemaKey of schemaKeys) {\n      if (!config.path.paramNames.includes(schemaKey)) {\n        throw new Error(\n          `pathParams schema key \"${schemaKey}\" not present in path template. ` +\n            `Template params: [${config.path.paramNames.join(\", \")}]`,\n        );\n      }\n    }\n  }\n\n  return config as CherryRoute<\n    TPathParams,\n    TQueryParams,\n    TBodyParams,\n    TResponse\n  >;\n}\n\nfunction getSchemaKeys(schema: v.BaseSchema<any, any, any>): string[] {\n  if (\n    \"entries\" in schema &&\n    typeof (schema as any).entries === \"object\" &&\n    (schema as any).entries !== null\n  ) {\n    return Object.keys((schema as any).entries);\n  }\n  return [];\n}\n","// path.ts - Tagged template functions for type-safe path building\nimport type { PathTemplate } from \"./types\";\n\n/** Branded type for path parameter markers */\ndeclare const PathParamBrand: unique symbol;\nexport type PathParam<T extends string = string> = string & {\n  readonly [PathParamBrand]: T;\n};\n\n/** Branded type for optional path parameter markers */\ndeclare const OptionalParamBrand: unique symbol;\nexport type OptionalParam<T extends string = string> = string & {\n  readonly [OptionalParamBrand]: T;\n};\n\n/** Union type for any path param marker */\nexport type AnyPathParam = PathParam<string> | OptionalParam<string>;\n\n/** Create a path parameter marker */\nexport function param<T extends string>(name: T): PathParam<T> {\n  return `:${name}` as PathParam<T>;\n}\n\n/** Create an optional path parameter marker */\nexport function optional<T extends string>(name: T): OptionalParam<T> {\n  return `(:${name})` as OptionalParam<T>;\n}\n\n/**\n * Tagged template for building path templates.\n *\n * @example\n * ```ts\n * // Simple path with one param\n * const userPath = path`/users/${param(\"id\")}`;\n * // { template: \"/users/:id\", paramNames: [\"id\"] }\n *\n * // Multiple params\n * const postPath = path`/users/${param(\"userId\")}/posts/${param(\"postId\")}`;\n * // { template: \"/users/:userId/posts/:postId\", paramNames: [\"userId\", \"postId\"] }\n *\n * // Optional params\n * const versionedPath = path`/api${optional(\"version\")}/users`;\n * // { template: \"/api(:version)/users\", paramNames: [\"version\"] }\n *\n * // No params\n * const staticPath = path`/health`;\n * // { template: \"/health\", paramNames: [] }\n * ```\n */\nexport function path(\n  strings: TemplateStringsArray,\n  ...params: AnyPathParam[]\n): PathTemplate {\n  const paramNames: string[] = [];\n  let template = strings[0];\n\n  for (let i = 0; i < params.length; i++) {\n    const p = params[i];\n    template += p + strings[i + 1];\n\n    // Extract param name from `:name` or `(:name)`\n    const match = p.match(/^\\(?:(\\w+)\\)?$/);\n    if (match) {\n      paramNames.push(match[1]);\n    }\n  }\n\n  return { template, paramNames };\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@b3-business/cherry",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "A tree-shakeable, minimal API client factory. Import only the routes you need — nothing more.",
   "repository": {
     "type": "git",
@@ -14,12 +14,12 @@
     "./package.json": "./package.json"
   },
   "files": [
-    "dist"
+    "dist",
+    "src"
   ],
   "scripts": {
     "build": "tsdown",
-    "check": "run-s lint typecheck",
-    "lint": "oxlint src test",
+    "check": "oxlint --type-aware --type-check src test",
     "typecheck": "tsc --noEmit -p .",
     "test": "bun test",
     "prepublishOnly": "npm run check && npm run test && npm run build",
@@ -34,8 +34,6 @@
     "@types/bun": "^1.3.5",
     "expect-type": "^1.3.0",
     "jsr": "^0.13.5",
-    "npm-run-all": "^4.1.5",
-    "oxlint": "^1.36.0",
     "tsdown": "^0.19.0-beta.2",
     "typescript": "^5.9.3"
   },

package/src/cherry_client.ts

@@ -0,0 +1,172 @@
+import { ResultAsync } from "neverthrow";
+import * as v from "valibot";
+import type {
+  CherryRoute,
+  CherryResult,
+  InferRouteInput,
+  InferRouteOutput,
+  Fetcher,
+  FetchRequest,
+  ClientConfig,
+  Client,
+  RouteTree,
+  RoutesToClient,
+  QueryParamOptions,
+} from "./types";
+import { HttpError, ValidationError, NetworkError, SerializationError, UnknownCherryError } from "./errors";
+
+const defaultFetcher: Fetcher = (req) => fetch(req.url, req.init);
+
+export function serializeQueryParams(
+  params: Record<string, unknown>,
+  options?: QueryParamOptions,
+): string {
+  if (options?.customSerializer) {
+    return options.customSerializer(params);
+  }
+
+  const searchParams = new URLSearchParams();
+
+  for (const [key, value] of Object.entries(params)) {
+    if (value === undefined || value === null) continue;
+
+    if (Array.isArray(value)) {
+      switch (options?.arrayFormat ?? "repeat") {
+        case "repeat":
+          for (const item of value) {
+            searchParams.append(key, String(item));
+          }
+          break;
+        case "comma":
+          searchParams.set(key, value.join(","));
+          break;
+        case "brackets":
+          for (const item of value) {
+            searchParams.append(`${key}[]`, String(item));
+          }
+          break;
+        case "json":
+          try {
+            searchParams.set(key, JSON.stringify(value));
+          } catch (error) {
+            throw new SerializationError("query", key, error);
+          }
+          break;
+      }
+    } else {
+      searchParams.set(key, String(value));
+    }
+  }
+
+  return searchParams.toString();
+}
+
+export function createCherryClient<TRoutes extends RouteTree | undefined = undefined>(
+  config: ClientConfig<TRoutes>,
+): Client<TRoutes> {
+  const fetcher = config.fetcher ?? defaultFetcher;
+
+  function call<T extends CherryRoute<any, any, any, any>>(
+    route: T,
+    params: InferRouteInput<T>,
+  ): CherryResult<InferRouteOutput<T>> {
+    return ResultAsync.fromPromise(executeRoute(route, params), (error) => {
+      if (error instanceof HttpError) return error;
+      if (error instanceof ValidationError) return error;
+      if (error instanceof NetworkError) return error;
+      if (error instanceof SerializationError) return error;
+      return new UnknownCherryError(error);
+    });
+  }
+
+  async function executeRoute<T extends CherryRoute<any, any, any, any>>(
+    route: T,
+    params: InferRouteInput<T>,
+  ): Promise<InferRouteOutput<T>> {
+    let pathParams: Record<string, unknown> = {};
+    if (route.pathParams) {
+      const result = v.safeParse(route.pathParams, params);
+      if (!result.success) throw new ValidationError("request", result.issues);
+      pathParams = result.output;
+    }
+
+    let queryParams: Record<string, unknown> = {};
+    if (route.queryParams) {
+      const result = v.safeParse(route.queryParams, params);
+      if (!result.success) throw new ValidationError("request", result.issues);
+      queryParams = result.output;
+    }
+
+    let bodyParams: Record<string, unknown> | undefined;
+    if (route.bodyParams) {
+      const result = v.safeParse(route.bodyParams, params);
+      if (!result.success) throw new ValidationError("request", result.issues);
+      bodyParams = result.output;
+    }
+
+    let url = route.path.template;
+    for (const [key, value] of Object.entries(pathParams)) {
+      url = url.replace(`:${key}`, encodeURIComponent(String(value)));
+    }
+
+    const fullUrl = new URL(url, config.baseUrl);
+
+    if (Object.keys(queryParams).length > 0) {
+      fullUrl.search = serializeQueryParams(queryParams, route.queryParamOptions);
+    }
+
+    const headers: Record<string, string> = {
+      "Content-Type": "application/json",
+      ...(await config.headers?.()),
+    };
+
+    const init: RequestInit = {
+      method: route.method,
+      headers,
+    };
+
+    if (bodyParams && route.method !== "GET") {
+      init.body = JSON.stringify(bodyParams);
+    }
+
+    const req: FetchRequest = {
+      url: fullUrl.toString(),
+      init,
+    };
+
+    let response: Response;
+    try {
+      response = await fetcher(req);
+    } catch (error) {
+      throw new NetworkError(error);
+    }
+
+    if (!response.ok) {
+      const body = await response.text().catch(() => undefined);
+      throw new HttpError(response.status, response.statusText, body);
+    }
+
+    const json = await response.json();
+    const result = v.safeParse(route.response, json);
+    if (!result.success) throw new ValidationError("response", result.issues);
+
+    return result.output;
+  }
+
+  function forgeRouteMethods<T extends RouteTree>(routes: T): RoutesToClient<T> {
+    const out: any = {};
+
+    for (const [key, value] of Object.entries(routes)) {
+      if (value && typeof value === "object" && "method" in value && "path" in value) {
+        out[key] = (params: any) => call(value as any, params);
+      } else if (value && typeof value === "object") {
+        out[key] = forgeRouteMethods(value as RouteTree);
+      }
+    }
+
+    return out;
+  }
+
+  const routes = config.routes ? forgeRouteMethods(config.routes) : {};
+  return { call, ...routes } as Client<TRoutes>;
+}

package/src/errors.ts

@@ -0,0 +1,86 @@
+import { errAsync, ResultAsync } from "neverthrow";
+
+/** Base error class for all Cherry errors */
+export abstract class CherryError extends Error {
+  abstract readonly type: string;
+  abstract readonly retryable: boolean;
+
+  constructor(message: string, options?: { cause?: unknown }) {
+    super(message, options);
+    this.name = this.constructor.name;
+  }
+}
+
+/** HTTP response errors (4xx, 5xx) */
+export class HttpError extends CherryError {
+  readonly type = "HttpError";
+  readonly retryable: boolean;
+
+  constructor(
+    public readonly status: number,
+    public readonly statusText: string,
+    public readonly body?: unknown,
+    cause?: unknown,
+  ) {
+    super(`HTTP ${status}: ${statusText}`, { cause });
+    this.retryable = status >= 500 || status === 429;
+  }
+}
+
+/** Valibot validation errors */
+export class ValidationError extends CherryError {
+  readonly type = "ValidationError";
+  readonly retryable = false;
+
+  constructor(
+    public readonly target: "request" | "response",
+    public readonly issues: unknown[],
+    cause?: unknown,
+  ) {
+    super(`Validation failed for ${target}`, { cause });
+  }
+}
+
+/** Network/fetch errors */
+export class NetworkError extends CherryError {
+  readonly type = "NetworkError";
+  readonly retryable = true;
+
+  constructor(cause?: unknown) {
+    super(`Network error`, { cause });
+  }
+}
+
+/** Serialization errors (e.g., circular references, BigInt in JSON) */
+export class SerializationError extends CherryError {
+  readonly type = "SerializationError";
+  readonly retryable = false;
+
+  constructor(
+    public readonly target: "query" | "body",
+    public readonly key: string,
+    cause?: unknown,
+  ) {
+    super(`Failed to serialize ${target} parameter "${key}"`, { cause });
+  }
+}
+
+/** Catch-all for unexpected errors */
+export class UnknownCherryError extends CherryError {
+  readonly type = "UnknownCherryError";
+  readonly retryable = false;
+
+  constructor(cause?: unknown) {
+    super(`Unknown error`, { cause });
+  }
+}
+
+/** Type guard for CherryError */
+export function isCherryError(error: unknown): error is CherryError {
+  return error instanceof CherryError;
+}
+
+/** Helper to create error ResultAsync */
+export function cherryErr<T>(error: CherryError): ResultAsync<T, CherryError> {
+  return errAsync(error);
+}

package/src/index.ts

@@ -0,0 +1,32 @@
+export { createCherryClient, serializeQueryParams } from "./cherry_client";
+
+export { route } from "./route";
+
+export { path, param, optional, type PathParam, type OptionalParam, type AnyPathParam } from "./path";
+
+export {
+  CherryError,
+  HttpError,
+  ValidationError,
+  NetworkError,
+  SerializationError,
+  UnknownCherryError,
+  isCherryError,
+  cherryErr,
+} from "./errors";
+
+export type {
+  HttpMethod,
+  PathTemplate,
+  CherryRoute,
+  QueryParamOptions,
+  InferRouteInput,
+  InferRouteOutput,
+  CherryResult,
+  FetchRequest,
+  Fetcher,
+  RouteTree,
+  ClientConfig,
+  Client,
+  RoutesToClient,
+} from "./types";

package/src/path.ts

@@ -0,0 +1,70 @@
+// path.ts - Tagged template functions for type-safe path building
+import type { PathTemplate } from "./types";
+
+/** Branded type for path parameter markers */
+declare const PathParamBrand: unique symbol;
+export type PathParam<T extends string = string> = string & {
+  readonly [PathParamBrand]: T;
+};
+
+/** Branded type for optional path parameter markers */
+declare const OptionalParamBrand: unique symbol;
+export type OptionalParam<T extends string = string> = string & {
+  readonly [OptionalParamBrand]: T;
+};
+
+/** Union type for any path param marker */
+export type AnyPathParam = PathParam<string> | OptionalParam<string>;
+
+/** Create a path parameter marker */
+export function param<T extends string>(name: T): PathParam<T> {
+  return `:${name}` as PathParam<T>;
+}
+
+/** Create an optional path parameter marker */
+export function optional<T extends string>(name: T): OptionalParam<T> {
+  return `(:${name})` as OptionalParam<T>;
+}
+
+/**
+ * Tagged template for building path templates.
+ *
+ * @example
+ * ```ts
+ * // Simple path with one param
+ * const userPath = path`/users/${param("id")}`;
+ * // { template: "/users/:id", paramNames: ["id"] }
+ *
+ * // Multiple params
+ * const postPath = path`/users/${param("userId")}/posts/${param("postId")}`;
+ * // { template: "/users/:userId/posts/:postId", paramNames: ["userId", "postId"] }
+ *
+ * // Optional params
+ * const versionedPath = path`/api${optional("version")}/users`;
+ * // { template: "/api(:version)/users", paramNames: ["version"] }
+ *
+ * // No params
+ * const staticPath = path`/health`;
+ * // { template: "/health", paramNames: [] }
+ * ```
+ */
+export function path(
+  strings: TemplateStringsArray,
+  ...params: AnyPathParam[]
+): PathTemplate {
+  const paramNames: string[] = [];
+  let template = strings[0];
+
+  for (let i = 0; i < params.length; i++) {
+    const p = params[i];
+    template += p + strings[i + 1];
+
+    // Extract param name from `:name` or `(:name)`
+    const match = p.match(/^\(?:(\w+)\)?$/);
+    if (match) {
+      paramNames.push(match[1]);
+    }
+  }
+
+  return { template, paramNames };
+}

package/src/route.ts

@@ -0,0 +1,63 @@
+import * as v from "valibot";
+import type { CherryRoute } from "./types";
+
+const HttpMethodSchema = v.picklist(["GET", "POST", "PUT", "PATCH", "DELETE"]);
+
+export function route<
+  TPathParams extends v.BaseSchema<any, any, any> | undefined = undefined,
+  TQueryParams extends v.BaseSchema<any, any, any> | undefined = undefined,
+  TBodyParams extends v.BaseSchema<any, any, any> | undefined = undefined,
+  TResponse extends v.BaseSchema<any, any, any> = v.BaseSchema<any, any, any>,
+>(
+  config: CherryRoute<TPathParams, TQueryParams, TBodyParams, TResponse>,
+): CherryRoute<TPathParams, TQueryParams, TBodyParams, TResponse> {
+  // validate HTTP method
+  v.parse(HttpMethodSchema, config.method);
+
+  // validate availability and content of pathParams schema, if needed
+  if (config.path.paramNames.length > 0) {
+    if (!config.pathParams) {
+      throw new Error(
+        `Route has path params [${config.path.paramNames.join(", ")}] but no pathParams schema`,
+      );
+    }
+
+    const schemaKeys = getSchemaKeys(config.pathParams);
+
+    for (const paramName of config.path.paramNames) {
+      if (!schemaKeys.includes(paramName)) {
+        throw new Error(
+          `Path param ":${paramName}" not found in pathParams schema. ` +
+            `Available: [${schemaKeys.join(", ")}]`,
+        );
+      }
+    }
+
+    for (const schemaKey of schemaKeys) {
+      if (!config.path.paramNames.includes(schemaKey)) {
+        throw new Error(
+          `pathParams schema key "${schemaKey}" not present in path template. ` +
+            `Template params: [${config.path.paramNames.join(", ")}]`,
+        );
+      }
+    }
+  }
+
+  return config as CherryRoute<
+    TPathParams,
+    TQueryParams,
+    TBodyParams,
+    TResponse
+  >;
+}
+
+function getSchemaKeys(schema: v.BaseSchema<any, any, any>): string[] {
+  if (
+    "entries" in schema &&
+    typeof (schema as any).entries === "object" &&
+    (schema as any).entries !== null
+  ) {
+    return Object.keys((schema as any).entries);
+  }
+  return [];
+}

package/src/types.ts

@@ -0,0 +1,107 @@
+import type { BaseSchema, InferInput, InferOutput } from "valibot";
+import type { ResultAsync } from "neverthrow";
+import type { CherryError } from "./errors";
+
+type AnySchema = BaseSchema<any, any, any>;
+
+/** HTTP methods supported by Cherry */
+export type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+
+/** Path template result from path() tagged template */
+export type PathTemplate = {
+  template: string; // "/users/:id/posts/:postId"
+  paramNames: string[]; // ["id", "postId"]
+};
+
+/** Route definition with separated parameter schemas */
+export type CherryRoute<
+  TPathParams extends AnySchema | undefined = undefined,
+  TQueryParams extends AnySchema | undefined = undefined,
+  TBodyParams extends AnySchema | undefined = undefined,
+  TResponse extends AnySchema = AnySchema,
+> = {
+  method: HttpMethod;
+  path: PathTemplate;
+  pathParams?: TPathParams;
+  queryParams?: TQueryParams;
+  bodyParams?: TBodyParams;
+  response: TResponse;
+  queryParamOptions?: QueryParamOptions;
+  description?: string;
+};
+
+/** Options for query parameter serialization */
+export type QueryParamOptions = {
+  arrayFormat?: "repeat" | "comma" | "brackets" | "json";
+  customSerializer?: (params: Record<string, unknown>) => string;
+};
+
+type AnyCherryRoute = CherryRoute<any, any, any, any>;
+
+type Prettify<T> = { [K in keyof T]: T[K] } & {};
+
+type IsEmptyObject<T> = keyof T extends never ? true : false;
+
+type InferSchemaInput<T> = T extends AnySchema ? InferInput<T> : {};
+
+type BuildRouteInputFromProps<
+  TPathParams,
+  TQueryParams,
+  TBodyParams
+> = InferSchemaInput<TPathParams> &
+    InferSchemaInput<TQueryParams> &
+    InferSchemaInput<TBodyParams>;
+
+export type InferRouteInput<T> = 
+  T extends { pathParams?: infer TPath; queryParams?: infer TQuery; bodyParams?: infer TBody }
+    ? IsEmptyObject<BuildRouteInputFromProps<TPath, TQuery, TBody>> extends true
+      ? void
+      : Prettify<BuildRouteInputFromProps<TPath, TQuery, TBody>>
+    : never;
+
+/** Infer response output from a route */
+export type InferRouteOutput<T extends AnyCherryRoute> =
+  T["response"] extends AnySchema ? InferOutput<T["response"]> : never;
+
+/** Cherry result type - always ResultAsync */
+export type CherryResult<T> = ResultAsync<T, CherryError>;
+
+/** Fetcher request shape (extensible for middleware) */
+export type FetchRequest = {
+  url: string;
+  init: RequestInit;
+};
+
+/** Fetcher function signature */
+export type Fetcher = (req: FetchRequest) => Promise<Response>;
+
+/** Route tree (supports namespacing via nested objects) */
+export type RouteTree = {
+  [key: string]: AnyCherryRoute | RouteTree;
+};
+
+/** Client configuration */
+export type ClientConfig<TRoutes extends RouteTree | undefined = undefined> = {
+  baseUrl: string;
+  headers?: () => Record<string, string> | Promise<Record<string, string>>;
+  fetcher?: Fetcher;
+  routes?: TRoutes;
+};
+
+export type Client<TRoutes extends RouteTree | undefined = undefined> = {
+  call: <T extends AnyCherryRoute>(
+    route: T,
+    ...args: InferRouteInput<T> extends void ? [] : [params: InferRouteInput<T>]
+  ) => CherryResult<InferRouteOutput<T>>;
+} & (TRoutes extends RouteTree ? RoutesToClient<TRoutes> : {});
+
+/** Convert a nested route tree into a nested client method tree */
+export type RoutesToClient<TRoutes extends RouteTree> = {
+  [K in keyof TRoutes]: TRoutes[K] extends AnyCherryRoute
+    ? InferRouteInput<TRoutes[K]> extends void
+      ? () => CherryResult<InferRouteOutput<TRoutes[K]>>
+      : (params: InferRouteInput<TRoutes[K]>) => CherryResult<InferRouteOutput<TRoutes[K]>>
+    : TRoutes[K] extends RouteTree
+      ? RoutesToClient<TRoutes[K]>
+      : never;
+};