@richie-rpc/core 1.2.0 → 1.2.2

package/README.md

@@ -47,6 +47,7 @@ Each endpoint can have:
 - `query` (optional): Zod schema for query parameters
 - `headers` (optional): Zod schema for request headers
 - `body` (optional): Zod schema for request body
+- `contentType` (optional): Request content type (`'application/json'` or `'multipart/form-data'`)
 - `responses` (required): Object mapping status codes to Zod schemas
 
 ## Features
@@ -58,6 +59,8 @@ Each endpoint can have:
 - ✅ Multiple response types per endpoint
 - ✅ Full TypeScript inference
 - ✅ Status code constants for cleaner code
+- ✅ File uploads with `multipart/form-data` support
+- ✅ Nested file structures in request bodies
 
 ## Utilities
 
@@ -86,6 +89,75 @@ 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.
+
+### File Upload / FormData Utilities
+
+The core package provides utilities for handling `multipart/form-data` requests with nested file structures.
+
+#### Defining File Upload Endpoints
+
+Use `contentType: 'multipart/form-data'` and `z.instanceof(File)` in your body schema:
+
+```typescript
+import { defineContract, Status } from '@richie-rpc/core';
+import { z } from 'zod';
+
+const contract = defineContract({
+  uploadDocuments: {
+    method: 'POST',
+    path: '/upload',
+    contentType: 'multipart/form-data',
+    body: z.object({
+      documents: z.array(z.object({
+        file: z.instanceof(File),
+        name: z.string(),
+        tags: z.array(z.string()).optional(),
+      })),
+      category: z.string(),
+    }),
+    responses: {
+      [Status.Created]: z.object({
+        uploadedCount: z.number(),
+        filenames: z.array(z.string()),
+      }),
+    },
+  },
+});
+```
+
+#### How It Works
+
+FormData is inherently flat, but Richie RPC supports nested structures using a hybrid JSON + Files approach:
+
+1. **Client-side**: Files are extracted from the object and replaced with `{ __fileRef__: "path" }` placeholders. The JSON structure is sent as `__json__` and files are sent as separate FormData entries.
+
+2. **Server-side**: The JSON is parsed, and `__fileRef__` placeholders are replaced with actual File objects from the FormData.
+
+#### Utility Functions
+
+```typescript
+import { objectToFormData, formDataToObject } from '@richie-rpc/core';
+
+// Client-side: Convert object with Files to FormData
+const formData = objectToFormData({
+  documents: [
+    { file: file1, name: 'doc1.pdf' },
+    { file: file2, name: 'doc2.pdf' },
+  ],
+  category: 'reports',
+});
+// Result: FormData with __json__ + files at "documents.0.file", "documents.1.file"
+
+// Server-side: Convert FormData back to object with Files
+const obj = formDataToObject(formData);
+// Result: { documents: [{ file: File, name: 'doc1.pdf' }, ...], category: 'reports' }
 ```
 
 ## Status Codes

package/dist/cjs/index.cjs

@@ -32,8 +32,10 @@ var exports_core = {};
 __export(exports_core, {
   parseQuery: () => parseQuery,
   parsePathParams: () => parsePathParams,
+  objectToFormData: () => objectToFormData,
   matchPath: () => matchPath,
   interpolatePath: () => interpolatePath,
+  formDataToObject: () => formDataToObject,
   defineContract: () => defineContract,
   buildUrl: () => buildUrl,
   Status: () => Status
@@ -126,6 +128,58 @@ function parseQuery(searchParams) {
 function defineContract(contract) {
   return contract;
 }
+function objectToFormData(obj) {
+  const formData = new FormData;
+  const files = [];
+  function traverse(value, path) {
+    if (value instanceof File) {
+      files.push({ path, file: value });
+      return { __fileRef__: path };
+    }
+    if (Array.isArray(value)) {
+      return value.map((item, i) => traverse(item, `${path}.${i}`));
+    }
+    if (value && typeof value === "object") {
+      const result = {};
+      for (const [k, v] of Object.entries(value)) {
+        result[k] = traverse(v, path ? `${path}.${k}` : k);
+      }
+      return result;
+    }
+    return value;
+  }
+  const jsonWithRefs = traverse(obj, "");
+  formData.append("__json__", JSON.stringify(jsonWithRefs));
+  for (const { path, file } of files) {
+    formData.append(path, file);
+  }
+  return formData;
+}
+function formDataToObject(formData) {
+  const jsonStr = formData.get("__json__");
+  if (typeof jsonStr !== "string") {
+    return Object.fromEntries(formData.entries());
+  }
+  const obj = JSON.parse(jsonStr);
+  function replaceRefs(value) {
+    if (value && typeof value === "object" && "__fileRef__" in value) {
+      const path = value.__fileRef__;
+      return formData.get(path);
+    }
+    if (Array.isArray(value)) {
+      return value.map(replaceRefs);
+    }
+    if (value && typeof value === "object") {
+      const result = {};
+      for (const [k, v] of Object.entries(value)) {
+        result[k] = replaceRefs(v);
+      }
+      return result;
+    }
+    return value;
+  }
+  return replaceRefs(obj);
+}
 })
 
-//# debugId=ACC9A49236395C2D64756E2164756E21
+//# debugId=56D7471C2C96572E64756E2164756E21

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  // 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"
+    "import type { z } from 'zod';\n\n// HTTP methods supported\nexport type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';\n\n// Content types supported for request bodies\nexport type ContentType = 'application/json' | 'multipart/form-data';\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  contentType?: ContentType;\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\n/**\n * Convert an object to FormData using the hybrid JSON + Files approach.\n * Files are extracted and replaced with { __fileRef__: \"path\" } placeholders.\n * The resulting FormData contains __json__ with the serialized structure\n * and individual file entries at their path keys.\n */\nexport function objectToFormData(obj: Record<string, unknown>): FormData {\n  const formData = new FormData();\n  const files: Array<{ path: string; file: File }> = [];\n\n  function traverse(value: unknown, path: string): unknown {\n    if (value instanceof File) {\n      files.push({ path, file: value });\n      return { __fileRef__: path };\n    }\n    if (Array.isArray(value)) {\n      return value.map((item, i) => traverse(item, `${path}.${i}`));\n    }\n    if (value && typeof value === 'object') {\n      const result: Record<string, unknown> = {};\n      for (const [k, v] of Object.entries(value)) {\n        result[k] = traverse(v, path ? `${path}.${k}` : k);\n      }\n      return result;\n    }\n    return value;\n  }\n\n  const jsonWithRefs = traverse(obj, '');\n  formData.append('__json__', JSON.stringify(jsonWithRefs));\n\n  for (const { path, file } of files) {\n    formData.append(path, file);\n  }\n\n  return formData;\n}\n\n/**\n * Parse FormData back to an object, reconstructing the structure with File objects.\n * Expects FormData created by objectToFormData with __json__ and file entries.\n * Falls back to simple Object.fromEntries for FormData without __json__.\n */\nexport function formDataToObject(formData: FormData): Record<string, unknown> {\n  const jsonStr = formData.get('__json__');\n  if (typeof jsonStr !== 'string') {\n    return Object.fromEntries(formData.entries());\n  }\n\n  const obj = JSON.parse(jsonStr);\n\n  function replaceRefs(value: unknown): unknown {\n    if (value && typeof value === 'object' && '__fileRef__' in value) {\n      const path = (value as { __fileRef__: string }).__fileRef__;\n      return formData.get(path);\n    }\n    if (Array.isArray(value)) {\n      return value.map(replaceRefs);\n    }\n    if (value && typeof value === 'object') {\n      const result: Record<string, unknown> = {};\n      for (const [k, v] of Object.entries(value)) {\n        result[k] = replaceRefs(v);\n      }\n      return result;\n    }\n    return value;\n  }\n\n  return replaceRefs(obj) as Record<string, unknown>;\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "ACC9A49236395C2D64756E2164756E21",
+  "mappings": "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",
+  "debugId": "56D7471C2C96572E64756E2164756E21",
   "names": []
 }

package/dist/cjs/package.json

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

package/dist/mjs/index.mjs

@@ -87,14 +87,68 @@ function parseQuery(searchParams) {
 function defineContract(contract) {
   return contract;
 }
+function objectToFormData(obj) {
+  const formData = new FormData;
+  const files = [];
+  function traverse(value, path) {
+    if (value instanceof File) {
+      files.push({ path, file: value });
+      return { __fileRef__: path };
+    }
+    if (Array.isArray(value)) {
+      return value.map((item, i) => traverse(item, `${path}.${i}`));
+    }
+    if (value && typeof value === "object") {
+      const result = {};
+      for (const [k, v] of Object.entries(value)) {
+        result[k] = traverse(v, path ? `${path}.${k}` : k);
+      }
+      return result;
+    }
+    return value;
+  }
+  const jsonWithRefs = traverse(obj, "");
+  formData.append("__json__", JSON.stringify(jsonWithRefs));
+  for (const { path, file } of files) {
+    formData.append(path, file);
+  }
+  return formData;
+}
+function formDataToObject(formData) {
+  const jsonStr = formData.get("__json__");
+  if (typeof jsonStr !== "string") {
+    return Object.fromEntries(formData.entries());
+  }
+  const obj = JSON.parse(jsonStr);
+  function replaceRefs(value) {
+    if (value && typeof value === "object" && "__fileRef__" in value) {
+      const path = value.__fileRef__;
+      return formData.get(path);
+    }
+    if (Array.isArray(value)) {
+      return value.map(replaceRefs);
+    }
+    if (value && typeof value === "object") {
+      const result = {};
+      for (const [k, v] of Object.entries(value)) {
+        result[k] = replaceRefs(v);
+      }
+      return result;
+    }
+    return value;
+  }
+  return replaceRefs(obj);
+}
 export {
   parseQuery,
   parsePathParams,
+  objectToFormData,
   matchPath,
   interpolatePath,
+  formDataToObject,
   defineContract,
   buildUrl,
   Status
 };
 
-//# debugId=6A3EE2DEC11404CC64756E2164756E21
+//# debugId=4DAE69D50D8DB01A64756E2164756E21

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  // 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"
+    "import type { z } from 'zod';\n\n// HTTP methods supported\nexport type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';\n\n// Content types supported for request bodies\nexport type ContentType = 'application/json' | 'multipart/form-data';\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  contentType?: ContentType;\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\n/**\n * Convert an object to FormData using the hybrid JSON + Files approach.\n * Files are extracted and replaced with { __fileRef__: \"path\" } placeholders.\n * The resulting FormData contains __json__ with the serialized structure\n * and individual file entries at their path keys.\n */\nexport function objectToFormData(obj: Record<string, unknown>): FormData {\n  const formData = new FormData();\n  const files: Array<{ path: string; file: File }> = [];\n\n  function traverse(value: unknown, path: string): unknown {\n    if (value instanceof File) {\n      files.push({ path, file: value });\n      return { __fileRef__: path };\n    }\n    if (Array.isArray(value)) {\n      return value.map((item, i) => traverse(item, `${path}.${i}`));\n    }\n    if (value && typeof value === 'object') {\n      const result: Record<string, unknown> = {};\n      for (const [k, v] of Object.entries(value)) {\n        result[k] = traverse(v, path ? `${path}.${k}` : k);\n      }\n      return result;\n    }\n    return value;\n  }\n\n  const jsonWithRefs = traverse(obj, '');\n  formData.append('__json__', JSON.stringify(jsonWithRefs));\n\n  for (const { path, file } of files) {\n    formData.append(path, file);\n  }\n\n  return formData;\n}\n\n/**\n * Parse FormData back to an object, reconstructing the structure with File objects.\n * Expects FormData created by objectToFormData with __json__ and file entries.\n * Falls back to simple Object.fromEntries for FormData without __json__.\n */\nexport function formDataToObject(formData: FormData): Record<string, unknown> {\n  const jsonStr = formData.get('__json__');\n  if (typeof jsonStr !== 'string') {\n    return Object.fromEntries(formData.entries());\n  }\n\n  const obj = JSON.parse(jsonStr);\n\n  function replaceRefs(value: unknown): unknown {\n    if (value && typeof value === 'object' && '__fileRef__' in value) {\n      const path = (value as { __fileRef__: string }).__fileRef__;\n      return formData.get(path);\n    }\n    if (Array.isArray(value)) {\n      return value.map(replaceRefs);\n    }\n    if (value && typeof value === 'object') {\n      const result: Record<string, unknown> = {};\n      for (const [k, v] of Object.entries(value)) {\n        result[k] = replaceRefs(v);\n      }\n      return result;\n    }\n    return value;\n  }\n\n  return replaceRefs(obj) as Record<string, unknown>;\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "6A3EE2DEC11404CC64756E2164756E21",
+  "mappings": "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",
+  "debugId": "4DAE69D50D8DB01A64756E2164756E21",
   "names": []
 }

package/dist/mjs/package.json

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

package/dist/types/index.d.ts

@@ -1,5 +1,6 @@
 import type { z } from 'zod';
 export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';
+export type ContentType = 'application/json' | 'multipart/form-data';
 export declare const Status: {
     readonly OK: 200;
     readonly Created: 201;
@@ -29,6 +30,7 @@ export interface EndpointDefinition {
     query?: z.ZodTypeAny;
     headers?: z.ZodTypeAny;
     body?: z.ZodTypeAny;
+    contentType?: ContentType;
     responses: Record<number, z.ZodTypeAny>;
 }
 export type Contract = Record<string, EndpointDefinition>;
@@ -69,3 +71,16 @@ export declare function buildUrl(baseUrl: string, path: string, query?: Record<s
  */
 export declare function parseQuery(searchParams: URLSearchParams): Record<string, string | string[]>;
 export declare function defineContract<T extends Contract>(contract: T): T;
+/**
+ * Convert an object to FormData using the hybrid JSON + Files approach.
+ * Files are extracted and replaced with { __fileRef__: "path" } placeholders.
+ * The resulting FormData contains __json__ with the serialized structure
+ * and individual file entries at their path keys.
+ */
+export declare function objectToFormData(obj: Record<string, unknown>): FormData;
+/**
+ * Parse FormData back to an object, reconstructing the structure with File objects.
+ * Expects FormData created by objectToFormData with __json__ and file entries.
+ * Falls back to simple Object.fromEntries for FormData without __json__.
+ */
+export declare function formDataToObject(formData: FormData): Record<string, unknown>;

package/package.json

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