@richie-rpc/core 1.1.0 → 1.2.1

package/README.md

@@ -86,8 +86,14 @@ import { buildUrl } from '@richie-rpc/core';
 
 buildUrl('http://api.example.com', '/users', { limit: '10', offset: '0' });
 // => 'http://api.example.com/users?limit=10&offset=0'
+
+// With basePath in baseUrl
+buildUrl('http://api.example.com/api', '/users');
+// => 'http://api.example.com/api/users'
 ```
 
+The `buildUrl` function properly concatenates the baseUrl with the path, supporting basePath prefixes in the baseUrl.
+
 ## Status Codes
 
 Use the `Status` const object for type-safe status codes:

package/dist/cjs/index.cjs

@@ -88,7 +88,10 @@ function interpolatePath(pattern, params) {
   return result;
 }
 function buildUrl(baseUrl, path, query) {
-  const url = new URL(path, baseUrl);
+  const normalizedBase = baseUrl.endsWith("/") ? baseUrl.slice(0, -1) : baseUrl;
+  const normalizedPath = path.startsWith("/") ? path : `/${path}`;
+  const fullPath = normalizedBase + normalizedPath;
+  const url = new URL(fullPath);
   if (query) {
     for (const [key, value] of Object.entries(query)) {
       if (value !== undefined && value !== null) {
@@ -125,4 +128,4 @@ function defineContract(contract) {
 }
 })
 
-//# debugId=7EDDE5B0280C976B64756E2164756E21
+//# debugId=ACC9A49236395C2D64756E2164756E21

package/dist/cjs/index.cjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../index.ts"],
   "sourcesContent": [
-    "import type { z } from 'zod';\n\n// HTTP methods supported\nexport type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';\n\n// HTTP status codes as const object for type-safe responses without 'as const'\nexport const Status = {\n  // Success responses\n  OK: 200 as const,\n  Created: 201 as const,\n  Accepted: 202 as const,\n  NoContent: 204 as const,\n\n  // Redirection\n  MovedPermanently: 301 as const,\n  Found: 302 as const,\n  NotModified: 304 as const,\n\n  // Client errors\n  BadRequest: 400 as const,\n  Unauthorized: 401 as const,\n  Forbidden: 403 as const,\n  NotFound: 404 as const,\n  MethodNotAllowed: 405 as const,\n  Conflict: 409 as const,\n  UnprocessableEntity: 422 as const,\n  TooManyRequests: 429 as const,\n\n  // Server errors\n  InternalServerError: 500 as const,\n  NotImplemented: 501 as const,\n  BadGateway: 502 as const,\n  ServiceUnavailable: 503 as const,\n  GatewayTimeout: 504 as const,\n} as const;\n\n// Endpoint definition structure\nexport interface EndpointDefinition {\n  method: HttpMethod;\n  path: string;\n  params?: z.ZodTypeAny;\n  query?: z.ZodTypeAny;\n  headers?: z.ZodTypeAny;\n  body?: z.ZodTypeAny;\n  responses: Record<number, z.ZodTypeAny>;\n}\n\n// Contract is a collection of named endpoints\nexport type Contract = Record<string, EndpointDefinition>;\n\n// Extract the Zod type from a schema\nexport type InferZodType<T> = T extends z.ZodTypeAny ? z.infer<T> : never;\n\n// Extract params type from endpoint\nexport type ExtractParams<T extends EndpointDefinition> = T['params'] extends z.ZodTypeAny\n  ? InferZodType<T['params']>\n  : never;\n\n// Extract query type from endpoint\nexport type ExtractQuery<T extends EndpointDefinition> = T['query'] extends z.ZodTypeAny\n  ? InferZodType<T['query']>\n  : never;\n\n// Extract headers type from endpoint\nexport type ExtractHeaders<T extends EndpointDefinition> = T['headers'] extends z.ZodTypeAny\n  ? InferZodType<T['headers']>\n  : never;\n\n// Extract body type from endpoint\nexport type ExtractBody<T extends EndpointDefinition> = T['body'] extends z.ZodTypeAny\n  ? InferZodType<T['body']>\n  : never;\n\n// Extract response types for all status codes\nexport type ExtractResponses<T extends EndpointDefinition> = {\n  [K in keyof T['responses']]: T['responses'][K] extends z.ZodTypeAny\n    ? InferZodType<T['responses'][K]>\n    : never;\n};\n\n// Extract a specific response type by status code\nexport type ExtractResponse<\n  T extends EndpointDefinition,\n  Status extends number,\n> = Status extends keyof T['responses']\n  ? T['responses'][Status] extends z.ZodTypeAny\n    ? InferZodType<T['responses'][Status]>\n    : never\n  : never;\n\n// Path parameter extraction utilities\nexport type ExtractPathParams<T extends string> =\n  T extends `${infer _Start}:${infer Param}/${infer Rest}`\n    ? Param | ExtractPathParams<`/${Rest}`>\n    : T extends `${infer _Start}:${infer Param}`\n      ? Param\n      : never;\n\n// Convert path params to object type\nexport type PathParamsObject<T extends string> = {\n  [K in ExtractPathParams<T>]: string;\n};\n\n/**\n * Parse path parameters from a URL path pattern\n * e.g., \"/users/:id/posts/:postId\" => [\"id\", \"postId\"]\n */\nexport function parsePathParams(path: string): string[] {\n  const matches = path.match(/:([^/]+)/g);\n  if (!matches) return [];\n  return matches.map((match) => match.slice(1));\n}\n\n/**\n * Match a URL path against a pattern and extract parameters\n * e.g., matchPath(\"/users/:id\", \"/users/123\") => { id: \"123\" }\n */\nexport function matchPath(pattern: string, path: string): Record<string, string> | null {\n  const paramNames = parsePathParams(pattern);\n\n  // Convert pattern to regex\n  const regexPattern = pattern.replace(/:[^/]+/g, '([^/]+)').replace(/\\//g, '\\\\/');\n\n  const regex = new RegExp(`^${regexPattern}$`);\n  const match = path.match(regex);\n\n  if (!match) return null;\n\n  const params: Record<string, string> = {};\n  paramNames.forEach((name, index) => {\n    params[name] = match[index + 1] ?? '';\n  });\n\n  return params;\n}\n\n/**\n * Interpolate path parameters into a URL pattern\n * e.g., interpolatePath(\"/users/:id\", { id: \"123\" }) => \"/users/123\"\n */\nexport function interpolatePath(pattern: string, params: Record<string, string | number>): string {\n  let result = pattern;\n  for (const [key, value] of Object.entries(params)) {\n    result = result.replace(`:${key}`, String(value));\n  }\n  return result;\n}\n\n/**\n * Build a complete URL with query parameters\n */\nexport function buildUrl(\n  baseUrl: string,\n  path: string,\n  query?: Record<string, string | number | boolean | string[]>,\n): string {\n  const url = new URL(path, baseUrl);\n\n  if (query) {\n    for (const [key, value] of Object.entries(query)) {\n      if (value !== undefined && value !== null) {\n        if (Array.isArray(value)) {\n          for (const v of value) {\n            url.searchParams.append(key, String(v));\n          }\n        } else {\n          url.searchParams.append(key, String(value));\n        }\n      }\n    }\n  }\n\n  return url.toString();\n}\n\n/**\n * Parse query parameters from URLSearchParams\n */\nexport function parseQuery(searchParams: URLSearchParams): Record<string, string | string[]> {\n  const result: Record<string, string | string[]> = {};\n\n  for (const [key, value] of searchParams.entries()) {\n    const existing = result[key];\n    if (existing) {\n      if (Array.isArray(existing)) {\n        existing.push(value);\n      } else {\n        result[key] = [existing, value];\n      }\n    } else {\n      result[key] = value;\n    }\n  }\n\n  return result;\n}\n\n// Type helper to ensure a value is a valid contract\nexport function defineContract<T extends Contract>(contract: T): T {\n  return contract;\n}\n"
+    "import type { z } from 'zod';\n\n// HTTP methods supported\nexport type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';\n\n// HTTP status codes as const object for type-safe responses without 'as const'\nexport const Status = {\n  // Success responses\n  OK: 200 as const,\n  Created: 201 as const,\n  Accepted: 202 as const,\n  NoContent: 204 as const,\n\n  // Redirection\n  MovedPermanently: 301 as const,\n  Found: 302 as const,\n  NotModified: 304 as const,\n\n  // Client errors\n  BadRequest: 400 as const,\n  Unauthorized: 401 as const,\n  Forbidden: 403 as const,\n  NotFound: 404 as const,\n  MethodNotAllowed: 405 as const,\n  Conflict: 409 as const,\n  UnprocessableEntity: 422 as const,\n  TooManyRequests: 429 as const,\n\n  // Server errors\n  InternalServerError: 500 as const,\n  NotImplemented: 501 as const,\n  BadGateway: 502 as const,\n  ServiceUnavailable: 503 as const,\n  GatewayTimeout: 504 as const,\n} as const;\n\n// Endpoint definition structure\nexport interface EndpointDefinition {\n  method: HttpMethod;\n  path: string;\n  params?: z.ZodTypeAny;\n  query?: z.ZodTypeAny;\n  headers?: z.ZodTypeAny;\n  body?: z.ZodTypeAny;\n  responses: Record<number, z.ZodTypeAny>;\n}\n\n// Contract is a collection of named endpoints\nexport type Contract = Record<string, EndpointDefinition>;\n\n// Extract the Zod type from a schema\nexport type InferZodType<T> = T extends z.ZodTypeAny ? z.infer<T> : never;\n\n// Extract params type from endpoint\nexport type ExtractParams<T extends EndpointDefinition> = T['params'] extends z.ZodTypeAny\n  ? InferZodType<T['params']>\n  : never;\n\n// Extract query type from endpoint\nexport type ExtractQuery<T extends EndpointDefinition> = T['query'] extends z.ZodTypeAny\n  ? InferZodType<T['query']>\n  : never;\n\n// Extract headers type from endpoint\nexport type ExtractHeaders<T extends EndpointDefinition> = T['headers'] extends z.ZodTypeAny\n  ? InferZodType<T['headers']>\n  : never;\n\n// Extract body type from endpoint\nexport type ExtractBody<T extends EndpointDefinition> = T['body'] extends z.ZodTypeAny\n  ? InferZodType<T['body']>\n  : never;\n\n// Extract response types for all status codes\nexport type ExtractResponses<T extends EndpointDefinition> = {\n  [K in keyof T['responses']]: T['responses'][K] extends z.ZodTypeAny\n    ? InferZodType<T['responses'][K]>\n    : never;\n};\n\n// Extract a specific response type by status code\nexport type ExtractResponse<\n  T extends EndpointDefinition,\n  Status extends number,\n> = Status extends keyof T['responses']\n  ? T['responses'][Status] extends z.ZodTypeAny\n    ? InferZodType<T['responses'][Status]>\n    : never\n  : never;\n\n// Path parameter extraction utilities\nexport type ExtractPathParams<T extends string> =\n  T extends `${infer _Start}:${infer Param}/${infer Rest}`\n    ? Param | ExtractPathParams<`/${Rest}`>\n    : T extends `${infer _Start}:${infer Param}`\n      ? Param\n      : never;\n\n// Convert path params to object type\nexport type PathParamsObject<T extends string> = {\n  [K in ExtractPathParams<T>]: string;\n};\n\n/**\n * Parse path parameters from a URL path pattern\n * e.g., \"/users/:id/posts/:postId\" => [\"id\", \"postId\"]\n */\nexport function parsePathParams(path: string): string[] {\n  const matches = path.match(/:([^/]+)/g);\n  if (!matches) return [];\n  return matches.map((match) => match.slice(1));\n}\n\n/**\n * Match a URL path against a pattern and extract parameters\n * e.g., matchPath(\"/users/:id\", \"/users/123\") => { id: \"123\" }\n */\nexport function matchPath(pattern: string, path: string): Record<string, string> | null {\n  const paramNames = parsePathParams(pattern);\n\n  // Convert pattern to regex\n  const regexPattern = pattern.replace(/:[^/]+/g, '([^/]+)').replace(/\\//g, '\\\\/');\n\n  const regex = new RegExp(`^${regexPattern}$`);\n  const match = path.match(regex);\n\n  if (!match) return null;\n\n  const params: Record<string, string> = {};\n  paramNames.forEach((name, index) => {\n    params[name] = match[index + 1] ?? '';\n  });\n\n  return params;\n}\n\n/**\n * Interpolate path parameters into a URL pattern\n * e.g., interpolatePath(\"/users/:id\", { id: \"123\" }) => \"/users/123\"\n */\nexport function interpolatePath(pattern: string, params: Record<string, string | number>): string {\n  let result = pattern;\n  for (const [key, value] of Object.entries(params)) {\n    result = result.replace(`:${key}`, String(value));\n  }\n  return result;\n}\n\n/**\n * Build a complete URL with query parameters\n */\nexport function buildUrl(\n  baseUrl: string,\n  path: string,\n  query?: Record<string, string | number | boolean | string[]>,\n): string {\n  // Normalize baseUrl - remove trailing slash\n  const normalizedBase = baseUrl.endsWith('/') ? baseUrl.slice(0, -1) : baseUrl;\n\n  // Ensure path starts with /\n  const normalizedPath = path.startsWith('/') ? path : `/${path}`;\n\n  // Concatenate base and path\n  const fullPath = normalizedBase + normalizedPath;\n\n  const url = new URL(fullPath);\n\n  if (query) {\n    for (const [key, value] of Object.entries(query)) {\n      if (value !== undefined && value !== null) {\n        if (Array.isArray(value)) {\n          for (const v of value) {\n            url.searchParams.append(key, String(v));\n          }\n        } else {\n          url.searchParams.append(key, String(value));\n        }\n      }\n    }\n  }\n\n  return url.toString();\n}\n\n/**\n * Parse query parameters from URLSearchParams\n */\nexport function parseQuery(searchParams: URLSearchParams): Record<string, string | string[]> {\n  const result: Record<string, string | string[]> = {};\n\n  for (const [key, value] of searchParams.entries()) {\n    const existing = result[key];\n    if (existing) {\n      if (Array.isArray(existing)) {\n        existing.push(value);\n      } else {\n        result[key] = [existing, value];\n      }\n    } else {\n      result[key] = value;\n    }\n  }\n\n  return result;\n}\n\n// Type helper to ensure a value is a valid contract\nexport function defineContract<T extends Contract>(contract: T): T {\n  return contract;\n}\n"
   ],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMO,IAAM,SAAS;AAAA,EAEpB,IAAI;AAAA,EACJ,SAAS;AAAA,EACT,UAAU;AAAA,EACV,WAAW;AAAA,EAGX,kBAAkB;AAAA,EAClB,OAAO;AAAA,EACP,aAAa;AAAA,EAGb,YAAY;AAAA,EACZ,cAAc;AAAA,EACd,WAAW;AAAA,EACX,UAAU;AAAA,EACV,kBAAkB;AAAA,EAClB,UAAU;AAAA,EACV,qBAAqB;AAAA,EACrB,iBAAiB;AAAA,EAGjB,qBAAqB;AAAA,EACrB,gBAAgB;AAAA,EAChB,YAAY;AAAA,EACZ,oBAAoB;AAAA,EACpB,gBAAgB;AAClB;AAyEO,SAAS,eAAe,CAAC,MAAwB;AAAA,EACtD,MAAM,UAAU,KAAK,MAAM,WAAW;AAAA,EACtC,IAAI,CAAC;AAAA,IAAS,OAAO,CAAC;AAAA,EACtB,OAAO,QAAQ,IAAI,CAAC,UAAU,MAAM,MAAM,CAAC,CAAC;AAAA;AAOvC,SAAS,SAAS,CAAC,SAAiB,MAA6C;AAAA,EACtF,MAAM,aAAa,gBAAgB,OAAO;AAAA,EAG1C,MAAM,eAAe,QAAQ,QAAQ,WAAW,SAAS,EAAE,QAAQ,OAAO,KAAK;AAAA,EAE/E,MAAM,QAAQ,IAAI,OAAO,IAAI,eAAe;AAAA,EAC5C,MAAM,QAAQ,KAAK,MAAM,KAAK;AAAA,EAE9B,IAAI,CAAC;AAAA,IAAO,OAAO;AAAA,EAEnB,MAAM,SAAiC,CAAC;AAAA,EACxC,WAAW,QAAQ,CAAC,MAAM,UAAU;AAAA,IAClC,OAAO,QAAQ,MAAM,QAAQ,MAAM;AAAA,GACpC;AAAA,EAED,OAAO;AAAA;AAOF,SAAS,eAAe,CAAC,SAAiB,QAAiD;AAAA,EAChG,IAAI,SAAS;AAAA,EACb,YAAY,KAAK,UAAU,OAAO,QAAQ,MAAM,GAAG;AAAA,IACjD,SAAS,OAAO,QAAQ,IAAI,OAAO,OAAO,KAAK,CAAC;AAAA,EAClD;AAAA,EACA,OAAO;AAAA;AAMF,SAAS,QAAQ,CACtB,SACA,MACA,OACQ;AAAA,EACR,MAAM,MAAM,IAAI,IAAI,MAAM,OAAO;AAAA,EAEjC,IAAI,OAAO;AAAA,IACT,YAAY,KAAK,UAAU,OAAO,QAAQ,KAAK,GAAG;AAAA,MAChD,IAAI,UAAU,aAAa,UAAU,MAAM;AAAA,QACzC,IAAI,MAAM,QAAQ,KAAK,GAAG;AAAA,UACxB,WAAW,KAAK,OAAO;AAAA,YACrB,IAAI,aAAa,OAAO,KAAK,OAAO,CAAC,CAAC;AAAA,UACxC;AAAA,QACF,EAAO;AAAA,UACL,IAAI,aAAa,OAAO,KAAK,OAAO,KAAK,CAAC;AAAA;AAAA,MAE9C;AAAA,IACF;AAAA,EACF;AAAA,EAEA,OAAO,IAAI,SAAS;AAAA;AAMf,SAAS,UAAU,CAAC,cAAkE;AAAA,EAC3F,MAAM,SAA4C,CAAC;AAAA,EAEnD,YAAY,KAAK,UAAU,aAAa,QAAQ,GAAG;AAAA,IACjD,MAAM,WAAW,OAAO;AAAA,IACxB,IAAI,UAAU;AAAA,MACZ,IAAI,MAAM,QAAQ,QAAQ,GAAG;AAAA,QAC3B,SAAS,KAAK,KAAK;AAAA,MACrB,EAAO;AAAA,QACL,OAAO,OAAO,CAAC,UAAU,KAAK;AAAA;AAAA,IAElC,EAAO;AAAA,MACL,OAAO,OAAO;AAAA;AAAA,EAElB;AAAA,EAEA,OAAO;AAAA;AAIF,SAAS,cAAkC,CAAC,UAAgB;AAAA,EACjE,OAAO;AAAA;",
-  "debugId": "7EDDE5B0280C976B64756E2164756E21",
+  "mappings": "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",
+  "debugId": "ACC9A49236395C2D64756E2164756E21",
   "names": []
 }

package/dist/cjs/package.json

@@ -1,5 +1,5 @@
 {
   "name": "@richie-rpc/core",
-  "version": "1.1.0",
+  "version": "1.2.1",
   "type": "commonjs"
 }

package/dist/mjs/index.mjs

@@ -49,7 +49,10 @@ function interpolatePath(pattern, params) {
   return result;
 }
 function buildUrl(baseUrl, path, query) {
-  const url = new URL(path, baseUrl);
+  const normalizedBase = baseUrl.endsWith("/") ? baseUrl.slice(0, -1) : baseUrl;
+  const normalizedPath = path.startsWith("/") ? path : `/${path}`;
+  const fullPath = normalizedBase + normalizedPath;
+  const url = new URL(fullPath);
   if (query) {
     for (const [key, value] of Object.entries(query)) {
       if (value !== undefined && value !== null) {
@@ -94,4 +97,4 @@ export {
   Status
 };
 
-//# debugId=18B3B3C290F2487664756E2164756E21
+//# debugId=6A3EE2DEC11404CC64756E2164756E21

package/dist/mjs/index.mjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../index.ts"],
   "sourcesContent": [
-    "import type { z } from 'zod';\n\n// HTTP methods supported\nexport type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';\n\n// HTTP status codes as const object for type-safe responses without 'as const'\nexport const Status = {\n  // Success responses\n  OK: 200 as const,\n  Created: 201 as const,\n  Accepted: 202 as const,\n  NoContent: 204 as const,\n\n  // Redirection\n  MovedPermanently: 301 as const,\n  Found: 302 as const,\n  NotModified: 304 as const,\n\n  // Client errors\n  BadRequest: 400 as const,\n  Unauthorized: 401 as const,\n  Forbidden: 403 as const,\n  NotFound: 404 as const,\n  MethodNotAllowed: 405 as const,\n  Conflict: 409 as const,\n  UnprocessableEntity: 422 as const,\n  TooManyRequests: 429 as const,\n\n  // Server errors\n  InternalServerError: 500 as const,\n  NotImplemented: 501 as const,\n  BadGateway: 502 as const,\n  ServiceUnavailable: 503 as const,\n  GatewayTimeout: 504 as const,\n} as const;\n\n// Endpoint definition structure\nexport interface EndpointDefinition {\n  method: HttpMethod;\n  path: string;\n  params?: z.ZodTypeAny;\n  query?: z.ZodTypeAny;\n  headers?: z.ZodTypeAny;\n  body?: z.ZodTypeAny;\n  responses: Record<number, z.ZodTypeAny>;\n}\n\n// Contract is a collection of named endpoints\nexport type Contract = Record<string, EndpointDefinition>;\n\n// Extract the Zod type from a schema\nexport type InferZodType<T> = T extends z.ZodTypeAny ? z.infer<T> : never;\n\n// Extract params type from endpoint\nexport type ExtractParams<T extends EndpointDefinition> = T['params'] extends z.ZodTypeAny\n  ? InferZodType<T['params']>\n  : never;\n\n// Extract query type from endpoint\nexport type ExtractQuery<T extends EndpointDefinition> = T['query'] extends z.ZodTypeAny\n  ? InferZodType<T['query']>\n  : never;\n\n// Extract headers type from endpoint\nexport type ExtractHeaders<T extends EndpointDefinition> = T['headers'] extends z.ZodTypeAny\n  ? InferZodType<T['headers']>\n  : never;\n\n// Extract body type from endpoint\nexport type ExtractBody<T extends EndpointDefinition> = T['body'] extends z.ZodTypeAny\n  ? InferZodType<T['body']>\n  : never;\n\n// Extract response types for all status codes\nexport type ExtractResponses<T extends EndpointDefinition> = {\n  [K in keyof T['responses']]: T['responses'][K] extends z.ZodTypeAny\n    ? InferZodType<T['responses'][K]>\n    : never;\n};\n\n// Extract a specific response type by status code\nexport type ExtractResponse<\n  T extends EndpointDefinition,\n  Status extends number,\n> = Status extends keyof T['responses']\n  ? T['responses'][Status] extends z.ZodTypeAny\n    ? InferZodType<T['responses'][Status]>\n    : never\n  : never;\n\n// Path parameter extraction utilities\nexport type ExtractPathParams<T extends string> =\n  T extends `${infer _Start}:${infer Param}/${infer Rest}`\n    ? Param | ExtractPathParams<`/${Rest}`>\n    : T extends `${infer _Start}:${infer Param}`\n      ? Param\n      : never;\n\n// Convert path params to object type\nexport type PathParamsObject<T extends string> = {\n  [K in ExtractPathParams<T>]: string;\n};\n\n/**\n * Parse path parameters from a URL path pattern\n * e.g., \"/users/:id/posts/:postId\" => [\"id\", \"postId\"]\n */\nexport function parsePathParams(path: string): string[] {\n  const matches = path.match(/:([^/]+)/g);\n  if (!matches) return [];\n  return matches.map((match) => match.slice(1));\n}\n\n/**\n * Match a URL path against a pattern and extract parameters\n * e.g., matchPath(\"/users/:id\", \"/users/123\") => { id: \"123\" }\n */\nexport function matchPath(pattern: string, path: string): Record<string, string> | null {\n  const paramNames = parsePathParams(pattern);\n\n  // Convert pattern to regex\n  const regexPattern = pattern.replace(/:[^/]+/g, '([^/]+)').replace(/\\//g, '\\\\/');\n\n  const regex = new RegExp(`^${regexPattern}$`);\n  const match = path.match(regex);\n\n  if (!match) return null;\n\n  const params: Record<string, string> = {};\n  paramNames.forEach((name, index) => {\n    params[name] = match[index + 1] ?? '';\n  });\n\n  return params;\n}\n\n/**\n * Interpolate path parameters into a URL pattern\n * e.g., interpolatePath(\"/users/:id\", { id: \"123\" }) => \"/users/123\"\n */\nexport function interpolatePath(pattern: string, params: Record<string, string | number>): string {\n  let result = pattern;\n  for (const [key, value] of Object.entries(params)) {\n    result = result.replace(`:${key}`, String(value));\n  }\n  return result;\n}\n\n/**\n * Build a complete URL with query parameters\n */\nexport function buildUrl(\n  baseUrl: string,\n  path: string,\n  query?: Record<string, string | number | boolean | string[]>,\n): string {\n  const url = new URL(path, baseUrl);\n\n  if (query) {\n    for (const [key, value] of Object.entries(query)) {\n      if (value !== undefined && value !== null) {\n        if (Array.isArray(value)) {\n          for (const v of value) {\n            url.searchParams.append(key, String(v));\n          }\n        } else {\n          url.searchParams.append(key, String(value));\n        }\n      }\n    }\n  }\n\n  return url.toString();\n}\n\n/**\n * Parse query parameters from URLSearchParams\n */\nexport function parseQuery(searchParams: URLSearchParams): Record<string, string | string[]> {\n  const result: Record<string, string | string[]> = {};\n\n  for (const [key, value] of searchParams.entries()) {\n    const existing = result[key];\n    if (existing) {\n      if (Array.isArray(existing)) {\n        existing.push(value);\n      } else {\n        result[key] = [existing, value];\n      }\n    } else {\n      result[key] = value;\n    }\n  }\n\n  return result;\n}\n\n// Type helper to ensure a value is a valid contract\nexport function defineContract<T extends Contract>(contract: T): T {\n  return contract;\n}\n"
+    "import type { z } from 'zod';\n\n// HTTP methods supported\nexport type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';\n\n// HTTP status codes as const object for type-safe responses without 'as const'\nexport const Status = {\n  // Success responses\n  OK: 200 as const,\n  Created: 201 as const,\n  Accepted: 202 as const,\n  NoContent: 204 as const,\n\n  // Redirection\n  MovedPermanently: 301 as const,\n  Found: 302 as const,\n  NotModified: 304 as const,\n\n  // Client errors\n  BadRequest: 400 as const,\n  Unauthorized: 401 as const,\n  Forbidden: 403 as const,\n  NotFound: 404 as const,\n  MethodNotAllowed: 405 as const,\n  Conflict: 409 as const,\n  UnprocessableEntity: 422 as const,\n  TooManyRequests: 429 as const,\n\n  // Server errors\n  InternalServerError: 500 as const,\n  NotImplemented: 501 as const,\n  BadGateway: 502 as const,\n  ServiceUnavailable: 503 as const,\n  GatewayTimeout: 504 as const,\n} as const;\n\n// Endpoint definition structure\nexport interface EndpointDefinition {\n  method: HttpMethod;\n  path: string;\n  params?: z.ZodTypeAny;\n  query?: z.ZodTypeAny;\n  headers?: z.ZodTypeAny;\n  body?: z.ZodTypeAny;\n  responses: Record<number, z.ZodTypeAny>;\n}\n\n// Contract is a collection of named endpoints\nexport type Contract = Record<string, EndpointDefinition>;\n\n// Extract the Zod type from a schema\nexport type InferZodType<T> = T extends z.ZodTypeAny ? z.infer<T> : never;\n\n// Extract params type from endpoint\nexport type ExtractParams<T extends EndpointDefinition> = T['params'] extends z.ZodTypeAny\n  ? InferZodType<T['params']>\n  : never;\n\n// Extract query type from endpoint\nexport type ExtractQuery<T extends EndpointDefinition> = T['query'] extends z.ZodTypeAny\n  ? InferZodType<T['query']>\n  : never;\n\n// Extract headers type from endpoint\nexport type ExtractHeaders<T extends EndpointDefinition> = T['headers'] extends z.ZodTypeAny\n  ? InferZodType<T['headers']>\n  : never;\n\n// Extract body type from endpoint\nexport type ExtractBody<T extends EndpointDefinition> = T['body'] extends z.ZodTypeAny\n  ? InferZodType<T['body']>\n  : never;\n\n// Extract response types for all status codes\nexport type ExtractResponses<T extends EndpointDefinition> = {\n  [K in keyof T['responses']]: T['responses'][K] extends z.ZodTypeAny\n    ? InferZodType<T['responses'][K]>\n    : never;\n};\n\n// Extract a specific response type by status code\nexport type ExtractResponse<\n  T extends EndpointDefinition,\n  Status extends number,\n> = Status extends keyof T['responses']\n  ? T['responses'][Status] extends z.ZodTypeAny\n    ? InferZodType<T['responses'][Status]>\n    : never\n  : never;\n\n// Path parameter extraction utilities\nexport type ExtractPathParams<T extends string> =\n  T extends `${infer _Start}:${infer Param}/${infer Rest}`\n    ? Param | ExtractPathParams<`/${Rest}`>\n    : T extends `${infer _Start}:${infer Param}`\n      ? Param\n      : never;\n\n// Convert path params to object type\nexport type PathParamsObject<T extends string> = {\n  [K in ExtractPathParams<T>]: string;\n};\n\n/**\n * Parse path parameters from a URL path pattern\n * e.g., \"/users/:id/posts/:postId\" => [\"id\", \"postId\"]\n */\nexport function parsePathParams(path: string): string[] {\n  const matches = path.match(/:([^/]+)/g);\n  if (!matches) return [];\n  return matches.map((match) => match.slice(1));\n}\n\n/**\n * Match a URL path against a pattern and extract parameters\n * e.g., matchPath(\"/users/:id\", \"/users/123\") => { id: \"123\" }\n */\nexport function matchPath(pattern: string, path: string): Record<string, string> | null {\n  const paramNames = parsePathParams(pattern);\n\n  // Convert pattern to regex\n  const regexPattern = pattern.replace(/:[^/]+/g, '([^/]+)').replace(/\\//g, '\\\\/');\n\n  const regex = new RegExp(`^${regexPattern}$`);\n  const match = path.match(regex);\n\n  if (!match) return null;\n\n  const params: Record<string, string> = {};\n  paramNames.forEach((name, index) => {\n    params[name] = match[index + 1] ?? '';\n  });\n\n  return params;\n}\n\n/**\n * Interpolate path parameters into a URL pattern\n * e.g., interpolatePath(\"/users/:id\", { id: \"123\" }) => \"/users/123\"\n */\nexport function interpolatePath(pattern: string, params: Record<string, string | number>): string {\n  let result = pattern;\n  for (const [key, value] of Object.entries(params)) {\n    result = result.replace(`:${key}`, String(value));\n  }\n  return result;\n}\n\n/**\n * Build a complete URL with query parameters\n */\nexport function buildUrl(\n  baseUrl: string,\n  path: string,\n  query?: Record<string, string | number | boolean | string[]>,\n): string {\n  // Normalize baseUrl - remove trailing slash\n  const normalizedBase = baseUrl.endsWith('/') ? baseUrl.slice(0, -1) : baseUrl;\n\n  // Ensure path starts with /\n  const normalizedPath = path.startsWith('/') ? path : `/${path}`;\n\n  // Concatenate base and path\n  const fullPath = normalizedBase + normalizedPath;\n\n  const url = new URL(fullPath);\n\n  if (query) {\n    for (const [key, value] of Object.entries(query)) {\n      if (value !== undefined && value !== null) {\n        if (Array.isArray(value)) {\n          for (const v of value) {\n            url.searchParams.append(key, String(v));\n          }\n        } else {\n          url.searchParams.append(key, String(value));\n        }\n      }\n    }\n  }\n\n  return url.toString();\n}\n\n/**\n * Parse query parameters from URLSearchParams\n */\nexport function parseQuery(searchParams: URLSearchParams): Record<string, string | string[]> {\n  const result: Record<string, string | string[]> = {};\n\n  for (const [key, value] of searchParams.entries()) {\n    const existing = result[key];\n    if (existing) {\n      if (Array.isArray(existing)) {\n        existing.push(value);\n      } else {\n        result[key] = [existing, value];\n      }\n    } else {\n      result[key] = value;\n    }\n  }\n\n  return result;\n}\n\n// Type helper to ensure a value is a valid contract\nexport function defineContract<T extends Contract>(contract: T): T {\n  return contract;\n}\n"
   ],
-  "mappings": ";;AAMO,IAAM,SAAS;AAAA,EAEpB,IAAI;AAAA,EACJ,SAAS;AAAA,EACT,UAAU;AAAA,EACV,WAAW;AAAA,EAGX,kBAAkB;AAAA,EAClB,OAAO;AAAA,EACP,aAAa;AAAA,EAGb,YAAY;AAAA,EACZ,cAAc;AAAA,EACd,WAAW;AAAA,EACX,UAAU;AAAA,EACV,kBAAkB;AAAA,EAClB,UAAU;AAAA,EACV,qBAAqB;AAAA,EACrB,iBAAiB;AAAA,EAGjB,qBAAqB;AAAA,EACrB,gBAAgB;AAAA,EAChB,YAAY;AAAA,EACZ,oBAAoB;AAAA,EACpB,gBAAgB;AAClB;AAyEO,SAAS,eAAe,CAAC,MAAwB;AAAA,EACtD,MAAM,UAAU,KAAK,MAAM,WAAW;AAAA,EACtC,IAAI,CAAC;AAAA,IAAS,OAAO,CAAC;AAAA,EACtB,OAAO,QAAQ,IAAI,CAAC,UAAU,MAAM,MAAM,CAAC,CAAC;AAAA;AAOvC,SAAS,SAAS,CAAC,SAAiB,MAA6C;AAAA,EACtF,MAAM,aAAa,gBAAgB,OAAO;AAAA,EAG1C,MAAM,eAAe,QAAQ,QAAQ,WAAW,SAAS,EAAE,QAAQ,OAAO,KAAK;AAAA,EAE/E,MAAM,QAAQ,IAAI,OAAO,IAAI,eAAe;AAAA,EAC5C,MAAM,QAAQ,KAAK,MAAM,KAAK;AAAA,EAE9B,IAAI,CAAC;AAAA,IAAO,OAAO;AAAA,EAEnB,MAAM,SAAiC,CAAC;AAAA,EACxC,WAAW,QAAQ,CAAC,MAAM,UAAU;AAAA,IAClC,OAAO,QAAQ,MAAM,QAAQ,MAAM;AAAA,GACpC;AAAA,EAED,OAAO;AAAA;AAOF,SAAS,eAAe,CAAC,SAAiB,QAAiD;AAAA,EAChG,IAAI,SAAS;AAAA,EACb,YAAY,KAAK,UAAU,OAAO,QAAQ,MAAM,GAAG;AAAA,IACjD,SAAS,OAAO,QAAQ,IAAI,OAAO,OAAO,KAAK,CAAC;AAAA,EAClD;AAAA,EACA,OAAO;AAAA;AAMF,SAAS,QAAQ,CACtB,SACA,MACA,OACQ;AAAA,EACR,MAAM,MAAM,IAAI,IAAI,MAAM,OAAO;AAAA,EAEjC,IAAI,OAAO;AAAA,IACT,YAAY,KAAK,UAAU,OAAO,QAAQ,KAAK,GAAG;AAAA,MAChD,IAAI,UAAU,aAAa,UAAU,MAAM;AAAA,QACzC,IAAI,MAAM,QAAQ,KAAK,GAAG;AAAA,UACxB,WAAW,KAAK,OAAO;AAAA,YACrB,IAAI,aAAa,OAAO,KAAK,OAAO,CAAC,CAAC;AAAA,UACxC;AAAA,QACF,EAAO;AAAA,UACL,IAAI,aAAa,OAAO,KAAK,OAAO,KAAK,CAAC;AAAA;AAAA,MAE9C;AAAA,IACF;AAAA,EACF;AAAA,EAEA,OAAO,IAAI,SAAS;AAAA;AAMf,SAAS,UAAU,CAAC,cAAkE;AAAA,EAC3F,MAAM,SAA4C,CAAC;AAAA,EAEnD,YAAY,KAAK,UAAU,aAAa,QAAQ,GAAG;AAAA,IACjD,MAAM,WAAW,OAAO;AAAA,IACxB,IAAI,UAAU;AAAA,MACZ,IAAI,MAAM,QAAQ,QAAQ,GAAG;AAAA,QAC3B,SAAS,KAAK,KAAK;AAAA,MACrB,EAAO;AAAA,QACL,OAAO,OAAO,CAAC,UAAU,KAAK;AAAA;AAAA,IAElC,EAAO;AAAA,MACL,OAAO,OAAO;AAAA;AAAA,EAElB;AAAA,EAEA,OAAO;AAAA;AAIF,SAAS,cAAkC,CAAC,UAAgB;AAAA,EACjE,OAAO;AAAA;",
-  "debugId": "18B3B3C290F2487664756E2164756E21",
+  "mappings": "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",
+  "debugId": "6A3EE2DEC11404CC64756E2164756E21",
   "names": []
 }

package/dist/mjs/package.json

@@ -1,5 +1,5 @@
 {
   "name": "@richie-rpc/core",
-  "version": "1.1.0",
+  "version": "1.2.1",
   "type": "module"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@richie-rpc/core",
-  "version": "1.1.0",
+  "version": "1.2.1",
   "main": "./dist/cjs/index.cjs",
   "exports": {
     ".": {