@spoosh/core 0.8.2 → 0.9.0

package/README.md

@@ -50,6 +50,9 @@ import { createClient } from "@spoosh/core";
 const api = createClient<ApiSchema>({
   baseUrl: "/api",
 });
+
+// Import body wrappers for explicit serialization
+import { json, form, urlencoded } from "@spoosh/core";
 ```
 
 ### Make API Calls
@@ -79,14 +82,14 @@ const { data: updated } = await api("users/:id").PUT({
 // DELETE /api/users/123
 await api("users/:id").DELETE({ params: { id: 123 } });
 
-// POST with file upload (auto FormData when File detected)
+// POST with file upload (using form() wrapper for multipart/form-data)
 const { data: uploaded } = await api("upload").POST({
-  body: { file: myFile },
+  body: form({ file: myFile }),
 });
 
-// POST with form data
+// POST with form data (using urlencoded() wrapper)
 const { data: payment } = await api("payments").POST({
-  body: { amount: 1000, currency: "usd" },
+  body: urlencoded({ amount: 1000, currency: "usd" }),
 });
 ```
 
@@ -172,12 +175,12 @@ const updatedContext = await applyMiddlewares(context, middlewares, "before");
 
 ## Schema Types
 
-| Field   | Description                             | Example                                          |
-| ------- | --------------------------------------- | ------------------------------------------------ |
-| `data`  | Response data type                      | `GET: { data: User[] }`                          |
-| `body`  | Request body type (files auto-detected) | `POST: { data: User; body: CreateUserBody }`     |
-| `query` | Query parameters type                   | `GET: { data: User[]; query: { page: number } }` |
-| `error` | Typed error type                        | `GET: { data: User; error: ApiError }`           |
+| Field   | Description           | Example                                          |
+| ------- | --------------------- | ------------------------------------------------ |
+| `data`  | Response data type    | `GET: { data: User[] }`                          |
+| `body`  | Request body type     | `POST: { data: User; body: CreateUserBody }`     |
+| `query` | Query parameters type | `GET: { data: User[]; query: { page: number } }` |
+| `error` | Typed error type      | `GET: { data: User; error: ApiError }`           |
 
 Path parameters are defined using `:param` syntax in the path key (e.g., `"users/:id"`).
 

package/dist/index.d.mts

@@ -1,4 +1,8 @@
 type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+type WriteMethod = "POST" | "PUT" | "PATCH" | "DELETE";
+type Simplify<T> = {
+    [K in keyof T]: T[K];
+} & {};
 
 type MiddlewarePhase = "before" | "after";
 type MiddlewareContext<TData = unknown, TError = unknown> = {
@@ -62,6 +66,20 @@ type SpooshOptionsExtra<TData = unknown, TError = unknown> = {
     middlewares?: SpooshMiddleware<TData, TError>[];
 };
 
+type SpooshBody<T = unknown> = {
+    readonly __spooshBody: true;
+    readonly kind: "form" | "json" | "urlencoded";
+    readonly value: T;
+};
+declare function isSpooshBody(value: unknown): value is SpooshBody;
+declare function form<T>(value: T): SpooshBody<T>;
+declare function json<T>(value: T): SpooshBody<T>;
+declare function urlencoded<T>(value: T): SpooshBody<T>;
+declare function resolveRequestBody(rawBody: unknown): {
+    body: BodyInit;
+    headers?: Record<string, string>;
+} | undefined;
+
 type RetryConfig = {
     retries?: number | false;
     retryDelay?: number;
@@ -76,9 +94,9 @@ type BaseRequestOptions$1 = {
     signal?: AbortSignal;
 };
 type BodyOption$1<TBody> = [TBody] extends [never] ? object : undefined extends TBody ? {
-    body?: Exclude<TBody, undefined>;
+    body?: Exclude<TBody, undefined> | SpooshBody<Exclude<TBody, undefined>>;
 } : {
-    body: TBody;
+    body: TBody | SpooshBody<TBody>;
 };
 type QueryOption$1<TQuery> = [TQuery] extends [never] ? object : undefined extends TQuery ? {
     query?: Exclude<TQuery, undefined>;
@@ -825,10 +843,27 @@ type ExtractParamNames<T extends string> = T extends `${string}:${infer Param}/$
  * ```
  */
 type HasParams<T extends string> = T extends `${string}:${string}` ? true : false;
+/**
+ * Extract paths that have GET methods.
+ */
+type ReadPaths<TSchema> = {
+    [K in keyof TSchema & string]: "GET" extends keyof TSchema[K] ? K : never;
+}[keyof TSchema & string];
+/**
+ * Extract paths that have write methods (POST, PUT, PATCH, DELETE).
+ */
+type WritePaths<TSchema> = {
+    [K in keyof TSchema & string]: Extract<keyof TSchema[K], WriteMethod> extends never ? never : K;
+}[keyof TSchema & string];
+/**
+ * Check if a schema path has a GET method.
+ */
+type HasReadMethod<TSchema, TPath extends string> = FindMatchingKey<TSchema, TPath> extends infer TKey ? TKey extends keyof TSchema ? "GET" extends keyof TSchema[TKey] ? true : false : false : false;
+/**
+ * Check if a schema path has any write methods.
+ */
+type HasWriteMethod<TSchema, TPath extends string> = FindMatchingKey<TSchema, TPath> extends infer TKey ? TKey extends keyof TSchema ? WriteMethod extends never ? false : Extract<keyof TSchema[TKey], WriteMethod> extends never ? false : true : false : false;
 
-type Simplify$1<T> = {
-    [K in keyof T]: T[K];
-} & {};
 type IsNever<T> = [T] extends [never] ? true : false;
 type EndpointRequestOptions<TEndpoint, TPath extends string> = (IsNever<ExtractBody$1<TEndpoint>> extends true ? object : {
     body: ExtractBody$1<TEndpoint>;
@@ -837,14 +872,10 @@ type EndpointRequestOptions<TEndpoint, TPath extends string> = (IsNever<ExtractB
 }) & (HasParams<TPath> extends true ? {
     params: Record<ExtractParamNames<TPath>, string | number>;
 } : object);
-type EndpointMethodFn<TEndpoint, TPath extends string> = (options?: Simplify$1<EndpointRequestOptions<TEndpoint, TPath>>) => Promise<SpooshResponse<ExtractData<TEndpoint>, unknown, EndpointRequestOptions<TEndpoint, TPath>>>;
-type QueryPathMethods<TSchema, TPath extends string> = FindMatchingKey<TSchema, TPath> extends infer TKey ? TKey extends keyof TSchema ? "GET" extends keyof TSchema[TKey] ? Simplify$1<{
+type EndpointMethodFn<TEndpoint, TPath extends string> = (options?: Simplify<EndpointRequestOptions<TEndpoint, TPath>>) => Promise<SpooshResponse<ExtractData<TEndpoint>, unknown, EndpointRequestOptions<TEndpoint, TPath>>>;
+type ReadPathMethods$1<TSchema, TPath extends string> = FindMatchingKey<TSchema, TPath> extends infer TKey ? TKey extends keyof TSchema ? "GET" extends keyof TSchema[TKey] ? Simplify<{
     GET: EndpointMethodFn<TSchema[TKey]["GET"], TPath>;
 }> : never : never : never;
-type ReadPaths$1<TSchema> = {
-    [K in keyof TSchema & string]: "GET" extends keyof TSchema[K] ? K : never;
-}[keyof TSchema & string];
-type HasGetMethod$1<TSchema, TPath extends string> = FindMatchingKey<TSchema, TPath> extends infer TKey ? TKey extends keyof TSchema ? "GET" extends keyof TSchema[TKey] ? true : false : false : false;
 /**
  * Schema navigation helper for plugins that need type-safe API schema access.
  *
@@ -858,7 +889,7 @@ type HasGetMethod$1<TSchema, TPath extends string> = FindMatchingKey<TSchema, TP
  * ```ts
  * // Define your plugin's callback type
  * type MyCallbackFn<TSchema = unknown> = (
- *   api: QuerySchemaHelper<TSchema>
+ *   api: ReadSchemaHelper<TSchema>
  * ) => unknown;
  *
  * // Usage in plugin options
@@ -886,25 +917,17 @@ type HasGetMethod$1<TSchema, TPath extends string> = FindMatchingKey<TSchema, TP
  * });
  * ```
  */
-type QuerySchemaHelper<TSchema> = <TPath extends ReadPaths$1<TSchema> | (string & {})>(path: TPath) => HasGetMethod$1<TSchema, TPath> extends true ? QueryPathMethods<TSchema, TPath> : never;
-type MutationMethod$1 = "POST" | "PUT" | "PATCH" | "DELETE";
-type MutationPathMethods<TSchema, TPath extends string> = FindMatchingKey<TSchema, TPath> extends infer TKey ? TKey extends keyof TSchema ? Simplify$1<{
-    [M in MutationMethod$1 as M extends keyof TSchema[TKey] ? M : never]: M extends keyof TSchema[TKey] ? EndpointMethodFn<TSchema[TKey][M], TPath> : never;
+type ReadSchemaHelper<TSchema> = <TPath extends ReadPaths<TSchema> | (string & {})>(path: TPath) => HasReadMethod<TSchema, TPath> extends true ? ReadPathMethods$1<TSchema, TPath> : never;
+type WritePathMethods$1<TSchema, TPath extends string> = FindMatchingKey<TSchema, TPath> extends infer TKey ? TKey extends keyof TSchema ? Simplify<{
+    [M in WriteMethod as M extends keyof TSchema[TKey] ? M : never]: M extends keyof TSchema[TKey] ? EndpointMethodFn<TSchema[TKey][M], TPath> : never;
 }> : never : never;
-type WritePaths$1<TSchema> = {
-    [K in keyof TSchema & string]: Extract<keyof TSchema[K], MutationMethod$1> extends never ? never : K;
-}[keyof TSchema & string];
-type HasMutationMethod$1<TSchema, TPath extends string> = FindMatchingKey<TSchema, TPath> extends infer TKey ? TKey extends keyof TSchema ? MutationMethod$1 extends never ? false : Extract<keyof TSchema[TKey], MutationMethod$1> extends never ? false : true : false : false;
 /**
  * Schema navigation helper for plugins that need type-safe API schema access for mutations.
  *
- * Similar to QuerySchemaHelper but exposes mutation methods (POST, PUT, PATCH, DELETE).
+ * Similar to ReadSchemaHelper but exposes write methods (POST, PUT, PATCH, DELETE).
  */
-type MutationSchemaHelper<TSchema> = <TPath extends WritePaths$1<TSchema> | (string & {})>(path: TPath) => HasMutationMethod$1<TSchema, TPath> extends true ? MutationPathMethods<TSchema, TPath> : never;
+type WriteSchemaHelper<TSchema> = <TPath extends WritePaths<TSchema> | (string & {})>(path: TPath) => HasWriteMethod<TSchema, TPath> extends true ? WritePathMethods$1<TSchema, TPath> : never;
 
-type Simplify<T> = {
-    [K in keyof T]: T[K];
-} & {};
 /**
  * Base request options available on all methods.
  */
@@ -941,9 +964,9 @@ type IsQueryRequired<T> = T extends {
  * Build the options type for a method.
  */
 type BodyOption<T> = [ExtractBody<T>] extends [never] ? {} : IsBodyRequired<T> extends true ? {
-    body: ExtractBody<T>;
+    body: ExtractBody<T> | SpooshBody<ExtractBody<T>>;
 } : {
-    body?: ExtractBody<T>;
+    body?: ExtractBody<T> | SpooshBody<ExtractBody<T>>;
 };
 type QueryOption<T> = [ExtractQuery<T>] extends [never] ? {} : IsQueryRequired<T> extends true ? {
     query: ExtractQuery<T>;
@@ -1014,47 +1037,23 @@ type SpooshClient<TSchema, TDefaultError = unknown> = <TPath extends SchemaPaths
 type ReadPathMethods<TSchema, TPath extends string, TDefaultError> = FindMatchingKey<TSchema, TPath> extends infer TKey ? TKey extends keyof TSchema ? "GET" extends keyof TSchema[TKey] ? Simplify<{
     GET: MethodFn<TSchema[TKey]["GET"], TDefaultError, TPath>;
 }> : never : never : never;
-/**
- * Check if a schema path has a GET method.
- */
-type HasGetMethod<TSchema, TPath extends string> = FindMatchingKey<TSchema, TPath> extends infer TKey ? TKey extends keyof TSchema ? "GET" extends keyof TSchema[TKey] ? true : false : false : false;
-/**
- * Extract paths that have GET methods.
- */
-type ReadPaths<TSchema> = {
-    [K in keyof TSchema & string]: "GET" extends keyof TSchema[K] ? K : never;
-}[keyof TSchema & string];
 /**
  * A read-only API client that only exposes GET methods.
  * Used by useRead and injectRead hooks.
  */
-type ReadClient<TSchema, TDefaultError = unknown> = <TPath extends ReadPaths<TSchema> | (string & {})>(path: TPath) => HasGetMethod<TSchema, TPath> extends true ? ReadPathMethods<TSchema, TPath, TDefaultError> : never;
-/**
- * Mutation methods (non-GET).
- */
-type MutationMethod = "POST" | "PUT" | "PATCH" | "DELETE";
+type ReadClient<TSchema, TDefaultError = unknown> = <TPath extends ReadPaths<TSchema> | (string & {})>(path: TPath) => HasReadMethod<TSchema, TPath> extends true ? ReadPathMethods<TSchema, TPath, TDefaultError> : never;
 /**
  * Write-only client type that only exposes mutation methods (POST, PUT, PATCH, DELETE).
  * Used by useWrite/injectWrite hooks to ensure only mutation operations are selected.
  */
 type WritePathMethods<TSchema, TPath extends string, TDefaultError> = FindMatchingKey<TSchema, TPath> extends infer TKey ? TKey extends keyof TSchema ? Simplify<{
-    [M in MutationMethod as M extends keyof TSchema[TKey] ? M : never]: M extends keyof TSchema[TKey] ? MethodFn<TSchema[TKey][M], TDefaultError, TPath> : never;
+    [M in WriteMethod as M extends keyof TSchema[TKey] ? M : never]: M extends keyof TSchema[TKey] ? MethodFn<TSchema[TKey][M], TDefaultError, TPath> : never;
 }> : never : never;
-/**
- * Check if a schema path has any mutation methods.
- */
-type HasMutationMethod<TSchema, TPath extends string> = FindMatchingKey<TSchema, TPath> extends infer TKey ? TKey extends keyof TSchema ? MutationMethod extends never ? false : Extract<keyof TSchema[TKey], MutationMethod> extends never ? false : true : false : false;
-/**
- * Extract paths that have mutation methods.
- */
-type WritePaths<TSchema> = {
-    [K in keyof TSchema & string]: Extract<keyof TSchema[K], MutationMethod> extends never ? never : K;
-}[keyof TSchema & string];
 /**
  * A write-only API client that only exposes mutation methods (POST, PUT, PATCH, DELETE).
  * Used by useWrite and injectWrite hooks.
  */
-type WriteClient<TSchema, TDefaultError = unknown> = <TPath extends WritePaths<TSchema> | (string & {})>(path: TPath) => HasMutationMethod<TSchema, TPath> extends true ? WritePathMethods<TSchema, TPath, TDefaultError> : never;
+type WriteClient<TSchema, TDefaultError = unknown> = <TPath extends WritePaths<TSchema> | (string & {})>(path: TPath) => HasWriteMethod<TSchema, TPath> extends true ? WritePathMethods<TSchema, TPath, TDefaultError> : never;
 
 type PluginArray = readonly SpooshPlugin<PluginTypeConfig>[];
 interface SpooshConfig<TPlugins extends PluginArray = PluginArray> {
@@ -1334,6 +1333,8 @@ declare function createClient<TSchema, TDefaultError = unknown>(config: SpooshCl
 
 declare function buildUrl(baseUrl: string, path: string[], query?: Record<string, string | number | boolean | undefined>): string;
 
+declare function __DEV__(): boolean;
+
 /**
  * Generate cache tags from URL path segments.
  * e.g., ['posts', '1'] → ['posts', 'posts/1']
@@ -1608,4 +1609,4 @@ type CreateInfiniteReadOptions<TData, TItem, TError, TRequest> = {
 };
 declare function createInfiniteReadController<TData, TItem, TError, TRequest extends InfiniteRequestOptions = InfiniteRequestOptions>(options: CreateInfiniteReadOptions<TData, TItem, TError, TRequest>): InfiniteReadController<TData, TItem, TError>;
 
-export { type AnyRequestOptions, type ApiSchema, type BuiltInEvents, type CacheEntry, type CacheEntryWithKey, type CapturedCall, type SpooshClientConfig as ClientConfig, type ComputeRequestOptions, type CoreRequestOptionsBase, type CreateInfiniteReadOptions, type CreateOperationOptions, type DataAwareCallback, type DataAwareTransform, type EventEmitter, type ExtractBody$1 as ExtractBody, type ExtractData, type ExtractError, type ExtractMethodOptions, type ExtractParamNames, type ExtractQuery$1 as ExtractQuery, type FetchDirection, type FetchExecutor, type FindMatchingKey, HTTP_METHODS, type HasParams, type HeadersInitOrGetter, type HttpMethod, type HttpMethodKey, type InfiniteReadController, type InfiniteReadState, type InfiniteRequestOptions, type InstanceApiContext, type InstanceApiResolvers, type InstancePluginExecutor, type LifecyclePhase, type MergePluginInstanceApi, type MergePluginOptions, type MergePluginResults, type MethodOptionsMap, type MiddlewareContext, type MiddlewareHandler, type MiddlewarePhase, type MutationSchemaHelper, type OperationController, type OperationState, type OperationType, type PageContext, type PluginAccessor, type PluginArray, type PluginContext, type PluginContextInput, type PluginExecutor, type PluginExportsRegistry, type PluginFactory, type PluginHandler, type PluginLifecycle, type PluginMiddleware, type PluginRegistry, type PluginResolvers, type PluginResponseHandler, type PluginResultResolvers, type PluginTypeConfig, type PluginUpdateHandler, type QuerySchemaHelper, type ReadClient, type RefetchEvent, type RequestOptions$1 as RequestOptions, type ResolveInstanceApi, type ResolveResultTypes, type ResolveSchemaTypes, type ResolveTypes, type ResolverContext, type RetryConfig, type RouteToPath, type SchemaPaths, type SelectedEndpoint, type SelectorFunction, type SelectorResult, Spoosh, type SpooshClient, type SpooshConfig, type SpooshInstance, type SpooshMiddleware, type SpooshOptions, type SpooshOptionsExtra, type SpooshPlugin, type SpooshResponse, type SpooshSchema, type StateManager, type TagMode, type TagOptions, type WriteClient, applyMiddlewares, buildUrl, composeMiddlewares, containsFile, createClient, createEventEmitter, createInfiniteReadController, createInitialState, createMiddleware, createOperationController, createPluginExecutor, createPluginRegistry, createProxyHandler, createSelectorProxy, createStateManager, executeFetch, extractMethodFromSelector, extractPathFromSelector, generateTags, getContentType, isJsonBody, mergeHeaders, objectToFormData, objectToUrlEncoded, resolveHeadersToRecord, resolvePath, resolveTags, setHeaders, sortObjectKeys };
+export { type AnyRequestOptions, type ApiSchema, type BuiltInEvents, type CacheEntry, type CacheEntryWithKey, type CapturedCall, type SpooshClientConfig as ClientConfig, type ComputeRequestOptions, type CoreRequestOptionsBase, type CreateInfiniteReadOptions, type CreateOperationOptions, type DataAwareCallback, type DataAwareTransform, type EventEmitter, type ExtractBody$1 as ExtractBody, type ExtractData, type ExtractError, type ExtractMethodOptions, type ExtractParamNames, type ExtractQuery$1 as ExtractQuery, type FetchDirection, type FetchExecutor, type FindMatchingKey, HTTP_METHODS, type HasParams, type HasReadMethod, type HasWriteMethod, type HeadersInitOrGetter, type HttpMethod, type HttpMethodKey, type InfiniteReadController, type InfiniteReadState, type InfiniteRequestOptions, type InstanceApiContext, type InstanceApiResolvers, type InstancePluginExecutor, type LifecyclePhase, type MergePluginInstanceApi, type MergePluginOptions, type MergePluginResults, type MethodOptionsMap, type MiddlewareContext, type MiddlewareHandler, type MiddlewarePhase, type OperationController, type OperationState, type OperationType, type PageContext, type PluginAccessor, type PluginArray, type PluginContext, type PluginContextInput, type PluginExecutor, type PluginExportsRegistry, type PluginFactory, type PluginHandler, type PluginLifecycle, type PluginMiddleware, type PluginRegistry, type PluginResolvers, type PluginResponseHandler, type PluginResultResolvers, type PluginTypeConfig, type PluginUpdateHandler, type ReadClient, type ReadPaths, type ReadSchemaHelper, type RefetchEvent, type RequestOptions$1 as RequestOptions, type ResolveInstanceApi, type ResolveResultTypes, type ResolveSchemaTypes, type ResolveTypes, type ResolverContext, type RetryConfig, type RouteToPath, type SchemaPaths, type SelectedEndpoint, type SelectorFunction, type SelectorResult, type Simplify, Spoosh, type SpooshBody, type SpooshClient, type SpooshConfig, type SpooshInstance, type SpooshMiddleware, type SpooshOptions, type SpooshOptionsExtra, type SpooshPlugin, type SpooshResponse, type SpooshSchema, type StateManager, type TagMode, type TagOptions, type WriteClient, type WriteMethod, type WritePaths, type WriteSchemaHelper, __DEV__, applyMiddlewares, buildUrl, composeMiddlewares, containsFile, createClient, createEventEmitter, createInfiniteReadController, createInitialState, createMiddleware, createOperationController, createPluginExecutor, createPluginRegistry, createProxyHandler, createSelectorProxy, createStateManager, executeFetch, extractMethodFromSelector, extractPathFromSelector, form, generateTags, getContentType, isJsonBody, isSpooshBody, json, mergeHeaders, objectToFormData, objectToUrlEncoded, resolveHeadersToRecord, resolvePath, resolveRequestBody, resolveTags, setHeaders, sortObjectKeys, urlencoded };

package/dist/index.d.ts

@@ -1,4 +1,8 @@
 type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+type WriteMethod = "POST" | "PUT" | "PATCH" | "DELETE";
+type Simplify<T> = {
+    [K in keyof T]: T[K];
+} & {};
 
 type MiddlewarePhase = "before" | "after";
 type MiddlewareContext<TData = unknown, TError = unknown> = {
@@ -62,6 +66,20 @@ type SpooshOptionsExtra<TData = unknown, TError = unknown> = {
     middlewares?: SpooshMiddleware<TData, TError>[];
 };
 
+type SpooshBody<T = unknown> = {
+    readonly __spooshBody: true;
+    readonly kind: "form" | "json" | "urlencoded";
+    readonly value: T;
+};
+declare function isSpooshBody(value: unknown): value is SpooshBody;
+declare function form<T>(value: T): SpooshBody<T>;
+declare function json<T>(value: T): SpooshBody<T>;
+declare function urlencoded<T>(value: T): SpooshBody<T>;
+declare function resolveRequestBody(rawBody: unknown): {
+    body: BodyInit;
+    headers?: Record<string, string>;
+} | undefined;
+
 type RetryConfig = {
     retries?: number | false;
     retryDelay?: number;
@@ -76,9 +94,9 @@ type BaseRequestOptions$1 = {
     signal?: AbortSignal;
 };
 type BodyOption$1<TBody> = [TBody] extends [never] ? object : undefined extends TBody ? {
-    body?: Exclude<TBody, undefined>;
+    body?: Exclude<TBody, undefined> | SpooshBody<Exclude<TBody, undefined>>;
 } : {
-    body: TBody;
+    body: TBody | SpooshBody<TBody>;
 };
 type QueryOption$1<TQuery> = [TQuery] extends [never] ? object : undefined extends TQuery ? {
     query?: Exclude<TQuery, undefined>;
@@ -825,10 +843,27 @@ type ExtractParamNames<T extends string> = T extends `${string}:${infer Param}/$
  * ```
  */
 type HasParams<T extends string> = T extends `${string}:${string}` ? true : false;
+/**
+ * Extract paths that have GET methods.
+ */
+type ReadPaths<TSchema> = {
+    [K in keyof TSchema & string]: "GET" extends keyof TSchema[K] ? K : never;
+}[keyof TSchema & string];
+/**
+ * Extract paths that have write methods (POST, PUT, PATCH, DELETE).
+ */
+type WritePaths<TSchema> = {
+    [K in keyof TSchema & string]: Extract<keyof TSchema[K], WriteMethod> extends never ? never : K;
+}[keyof TSchema & string];
+/**
+ * Check if a schema path has a GET method.
+ */
+type HasReadMethod<TSchema, TPath extends string> = FindMatchingKey<TSchema, TPath> extends infer TKey ? TKey extends keyof TSchema ? "GET" extends keyof TSchema[TKey] ? true : false : false : false;
+/**
+ * Check if a schema path has any write methods.
+ */
+type HasWriteMethod<TSchema, TPath extends string> = FindMatchingKey<TSchema, TPath> extends infer TKey ? TKey extends keyof TSchema ? WriteMethod extends never ? false : Extract<keyof TSchema[TKey], WriteMethod> extends never ? false : true : false : false;
 
-type Simplify$1<T> = {
-    [K in keyof T]: T[K];
-} & {};
 type IsNever<T> = [T] extends [never] ? true : false;
 type EndpointRequestOptions<TEndpoint, TPath extends string> = (IsNever<ExtractBody$1<TEndpoint>> extends true ? object : {
     body: ExtractBody$1<TEndpoint>;
@@ -837,14 +872,10 @@ type EndpointRequestOptions<TEndpoint, TPath extends string> = (IsNever<ExtractB
 }) & (HasParams<TPath> extends true ? {
     params: Record<ExtractParamNames<TPath>, string | number>;
 } : object);
-type EndpointMethodFn<TEndpoint, TPath extends string> = (options?: Simplify$1<EndpointRequestOptions<TEndpoint, TPath>>) => Promise<SpooshResponse<ExtractData<TEndpoint>, unknown, EndpointRequestOptions<TEndpoint, TPath>>>;
-type QueryPathMethods<TSchema, TPath extends string> = FindMatchingKey<TSchema, TPath> extends infer TKey ? TKey extends keyof TSchema ? "GET" extends keyof TSchema[TKey] ? Simplify$1<{
+type EndpointMethodFn<TEndpoint, TPath extends string> = (options?: Simplify<EndpointRequestOptions<TEndpoint, TPath>>) => Promise<SpooshResponse<ExtractData<TEndpoint>, unknown, EndpointRequestOptions<TEndpoint, TPath>>>;
+type ReadPathMethods$1<TSchema, TPath extends string> = FindMatchingKey<TSchema, TPath> extends infer TKey ? TKey extends keyof TSchema ? "GET" extends keyof TSchema[TKey] ? Simplify<{
     GET: EndpointMethodFn<TSchema[TKey]["GET"], TPath>;
 }> : never : never : never;
-type ReadPaths$1<TSchema> = {
-    [K in keyof TSchema & string]: "GET" extends keyof TSchema[K] ? K : never;
-}[keyof TSchema & string];
-type HasGetMethod$1<TSchema, TPath extends string> = FindMatchingKey<TSchema, TPath> extends infer TKey ? TKey extends keyof TSchema ? "GET" extends keyof TSchema[TKey] ? true : false : false : false;
 /**
  * Schema navigation helper for plugins that need type-safe API schema access.
  *
@@ -858,7 +889,7 @@ type HasGetMethod$1<TSchema, TPath extends string> = FindMatchingKey<TSchema, TP
  * ```ts
  * // Define your plugin's callback type
  * type MyCallbackFn<TSchema = unknown> = (
- *   api: QuerySchemaHelper<TSchema>
+ *   api: ReadSchemaHelper<TSchema>
  * ) => unknown;
  *
  * // Usage in plugin options
@@ -886,25 +917,17 @@ type HasGetMethod$1<TSchema, TPath extends string> = FindMatchingKey<TSchema, TP
  * });
  * ```
  */
-type QuerySchemaHelper<TSchema> = <TPath extends ReadPaths$1<TSchema> | (string & {})>(path: TPath) => HasGetMethod$1<TSchema, TPath> extends true ? QueryPathMethods<TSchema, TPath> : never;
-type MutationMethod$1 = "POST" | "PUT" | "PATCH" | "DELETE";
-type MutationPathMethods<TSchema, TPath extends string> = FindMatchingKey<TSchema, TPath> extends infer TKey ? TKey extends keyof TSchema ? Simplify$1<{
-    [M in MutationMethod$1 as M extends keyof TSchema[TKey] ? M : never]: M extends keyof TSchema[TKey] ? EndpointMethodFn<TSchema[TKey][M], TPath> : never;
+type ReadSchemaHelper<TSchema> = <TPath extends ReadPaths<TSchema> | (string & {})>(path: TPath) => HasReadMethod<TSchema, TPath> extends true ? ReadPathMethods$1<TSchema, TPath> : never;
+type WritePathMethods$1<TSchema, TPath extends string> = FindMatchingKey<TSchema, TPath> extends infer TKey ? TKey extends keyof TSchema ? Simplify<{
+    [M in WriteMethod as M extends keyof TSchema[TKey] ? M : never]: M extends keyof TSchema[TKey] ? EndpointMethodFn<TSchema[TKey][M], TPath> : never;
 }> : never : never;
-type WritePaths$1<TSchema> = {
-    [K in keyof TSchema & string]: Extract<keyof TSchema[K], MutationMethod$1> extends never ? never : K;
-}[keyof TSchema & string];
-type HasMutationMethod$1<TSchema, TPath extends string> = FindMatchingKey<TSchema, TPath> extends infer TKey ? TKey extends keyof TSchema ? MutationMethod$1 extends never ? false : Extract<keyof TSchema[TKey], MutationMethod$1> extends never ? false : true : false : false;
 /**
  * Schema navigation helper for plugins that need type-safe API schema access for mutations.
  *
- * Similar to QuerySchemaHelper but exposes mutation methods (POST, PUT, PATCH, DELETE).
+ * Similar to ReadSchemaHelper but exposes write methods (POST, PUT, PATCH, DELETE).
  */
-type MutationSchemaHelper<TSchema> = <TPath extends WritePaths$1<TSchema> | (string & {})>(path: TPath) => HasMutationMethod$1<TSchema, TPath> extends true ? MutationPathMethods<TSchema, TPath> : never;
+type WriteSchemaHelper<TSchema> = <TPath extends WritePaths<TSchema> | (string & {})>(path: TPath) => HasWriteMethod<TSchema, TPath> extends true ? WritePathMethods$1<TSchema, TPath> : never;
 
-type Simplify<T> = {
-    [K in keyof T]: T[K];
-} & {};
 /**
  * Base request options available on all methods.
  */
@@ -941,9 +964,9 @@ type IsQueryRequired<T> = T extends {
  * Build the options type for a method.
  */
 type BodyOption<T> = [ExtractBody<T>] extends [never] ? {} : IsBodyRequired<T> extends true ? {
-    body: ExtractBody<T>;
+    body: ExtractBody<T> | SpooshBody<ExtractBody<T>>;
 } : {
-    body?: ExtractBody<T>;
+    body?: ExtractBody<T> | SpooshBody<ExtractBody<T>>;
 };
 type QueryOption<T> = [ExtractQuery<T>] extends [never] ? {} : IsQueryRequired<T> extends true ? {
     query: ExtractQuery<T>;
@@ -1014,47 +1037,23 @@ type SpooshClient<TSchema, TDefaultError = unknown> = <TPath extends SchemaPaths
 type ReadPathMethods<TSchema, TPath extends string, TDefaultError> = FindMatchingKey<TSchema, TPath> extends infer TKey ? TKey extends keyof TSchema ? "GET" extends keyof TSchema[TKey] ? Simplify<{
     GET: MethodFn<TSchema[TKey]["GET"], TDefaultError, TPath>;
 }> : never : never : never;
-/**
- * Check if a schema path has a GET method.
- */
-type HasGetMethod<TSchema, TPath extends string> = FindMatchingKey<TSchema, TPath> extends infer TKey ? TKey extends keyof TSchema ? "GET" extends keyof TSchema[TKey] ? true : false : false : false;
-/**
- * Extract paths that have GET methods.
- */
-type ReadPaths<TSchema> = {
-    [K in keyof TSchema & string]: "GET" extends keyof TSchema[K] ? K : never;
-}[keyof TSchema & string];
 /**
  * A read-only API client that only exposes GET methods.
  * Used by useRead and injectRead hooks.
  */
-type ReadClient<TSchema, TDefaultError = unknown> = <TPath extends ReadPaths<TSchema> | (string & {})>(path: TPath) => HasGetMethod<TSchema, TPath> extends true ? ReadPathMethods<TSchema, TPath, TDefaultError> : never;
-/**
- * Mutation methods (non-GET).
- */
-type MutationMethod = "POST" | "PUT" | "PATCH" | "DELETE";
+type ReadClient<TSchema, TDefaultError = unknown> = <TPath extends ReadPaths<TSchema> | (string & {})>(path: TPath) => HasReadMethod<TSchema, TPath> extends true ? ReadPathMethods<TSchema, TPath, TDefaultError> : never;
 /**
  * Write-only client type that only exposes mutation methods (POST, PUT, PATCH, DELETE).
  * Used by useWrite/injectWrite hooks to ensure only mutation operations are selected.
  */
 type WritePathMethods<TSchema, TPath extends string, TDefaultError> = FindMatchingKey<TSchema, TPath> extends infer TKey ? TKey extends keyof TSchema ? Simplify<{
-    [M in MutationMethod as M extends keyof TSchema[TKey] ? M : never]: M extends keyof TSchema[TKey] ? MethodFn<TSchema[TKey][M], TDefaultError, TPath> : never;
+    [M in WriteMethod as M extends keyof TSchema[TKey] ? M : never]: M extends keyof TSchema[TKey] ? MethodFn<TSchema[TKey][M], TDefaultError, TPath> : never;
 }> : never : never;
-/**
- * Check if a schema path has any mutation methods.
- */
-type HasMutationMethod<TSchema, TPath extends string> = FindMatchingKey<TSchema, TPath> extends infer TKey ? TKey extends keyof TSchema ? MutationMethod extends never ? false : Extract<keyof TSchema[TKey], MutationMethod> extends never ? false : true : false : false;
-/**
- * Extract paths that have mutation methods.
- */
-type WritePaths<TSchema> = {
-    [K in keyof TSchema & string]: Extract<keyof TSchema[K], MutationMethod> extends never ? never : K;
-}[keyof TSchema & string];
 /**
  * A write-only API client that only exposes mutation methods (POST, PUT, PATCH, DELETE).
  * Used by useWrite and injectWrite hooks.
  */
-type WriteClient<TSchema, TDefaultError = unknown> = <TPath extends WritePaths<TSchema> | (string & {})>(path: TPath) => HasMutationMethod<TSchema, TPath> extends true ? WritePathMethods<TSchema, TPath, TDefaultError> : never;
+type WriteClient<TSchema, TDefaultError = unknown> = <TPath extends WritePaths<TSchema> | (string & {})>(path: TPath) => HasWriteMethod<TSchema, TPath> extends true ? WritePathMethods<TSchema, TPath, TDefaultError> : never;
 
 type PluginArray = readonly SpooshPlugin<PluginTypeConfig>[];
 interface SpooshConfig<TPlugins extends PluginArray = PluginArray> {
@@ -1334,6 +1333,8 @@ declare function createClient<TSchema, TDefaultError = unknown>(config: SpooshCl
 
 declare function buildUrl(baseUrl: string, path: string[], query?: Record<string, string | number | boolean | undefined>): string;
 
+declare function __DEV__(): boolean;
+
 /**
  * Generate cache tags from URL path segments.
  * e.g., ['posts', '1'] → ['posts', 'posts/1']
@@ -1608,4 +1609,4 @@ type CreateInfiniteReadOptions<TData, TItem, TError, TRequest> = {
 };
 declare function createInfiniteReadController<TData, TItem, TError, TRequest extends InfiniteRequestOptions = InfiniteRequestOptions>(options: CreateInfiniteReadOptions<TData, TItem, TError, TRequest>): InfiniteReadController<TData, TItem, TError>;
 
-export { type AnyRequestOptions, type ApiSchema, type BuiltInEvents, type CacheEntry, type CacheEntryWithKey, type CapturedCall, type SpooshClientConfig as ClientConfig, type ComputeRequestOptions, type CoreRequestOptionsBase, type CreateInfiniteReadOptions, type CreateOperationOptions, type DataAwareCallback, type DataAwareTransform, type EventEmitter, type ExtractBody$1 as ExtractBody, type ExtractData, type ExtractError, type ExtractMethodOptions, type ExtractParamNames, type ExtractQuery$1 as ExtractQuery, type FetchDirection, type FetchExecutor, type FindMatchingKey, HTTP_METHODS, type HasParams, type HeadersInitOrGetter, type HttpMethod, type HttpMethodKey, type InfiniteReadController, type InfiniteReadState, type InfiniteRequestOptions, type InstanceApiContext, type InstanceApiResolvers, type InstancePluginExecutor, type LifecyclePhase, type MergePluginInstanceApi, type MergePluginOptions, type MergePluginResults, type MethodOptionsMap, type MiddlewareContext, type MiddlewareHandler, type MiddlewarePhase, type MutationSchemaHelper, type OperationController, type OperationState, type OperationType, type PageContext, type PluginAccessor, type PluginArray, type PluginContext, type PluginContextInput, type PluginExecutor, type PluginExportsRegistry, type PluginFactory, type PluginHandler, type PluginLifecycle, type PluginMiddleware, type PluginRegistry, type PluginResolvers, type PluginResponseHandler, type PluginResultResolvers, type PluginTypeConfig, type PluginUpdateHandler, type QuerySchemaHelper, type ReadClient, type RefetchEvent, type RequestOptions$1 as RequestOptions, type ResolveInstanceApi, type ResolveResultTypes, type ResolveSchemaTypes, type ResolveTypes, type ResolverContext, type RetryConfig, type RouteToPath, type SchemaPaths, type SelectedEndpoint, type SelectorFunction, type SelectorResult, Spoosh, type SpooshClient, type SpooshConfig, type SpooshInstance, type SpooshMiddleware, type SpooshOptions, type SpooshOptionsExtra, type SpooshPlugin, type SpooshResponse, type SpooshSchema, type StateManager, type TagMode, type TagOptions, type WriteClient, applyMiddlewares, buildUrl, composeMiddlewares, containsFile, createClient, createEventEmitter, createInfiniteReadController, createInitialState, createMiddleware, createOperationController, createPluginExecutor, createPluginRegistry, createProxyHandler, createSelectorProxy, createStateManager, executeFetch, extractMethodFromSelector, extractPathFromSelector, generateTags, getContentType, isJsonBody, mergeHeaders, objectToFormData, objectToUrlEncoded, resolveHeadersToRecord, resolvePath, resolveTags, setHeaders, sortObjectKeys };
+export { type AnyRequestOptions, type ApiSchema, type BuiltInEvents, type CacheEntry, type CacheEntryWithKey, type CapturedCall, type SpooshClientConfig as ClientConfig, type ComputeRequestOptions, type CoreRequestOptionsBase, type CreateInfiniteReadOptions, type CreateOperationOptions, type DataAwareCallback, type DataAwareTransform, type EventEmitter, type ExtractBody$1 as ExtractBody, type ExtractData, type ExtractError, type ExtractMethodOptions, type ExtractParamNames, type ExtractQuery$1 as ExtractQuery, type FetchDirection, type FetchExecutor, type FindMatchingKey, HTTP_METHODS, type HasParams, type HasReadMethod, type HasWriteMethod, type HeadersInitOrGetter, type HttpMethod, type HttpMethodKey, type InfiniteReadController, type InfiniteReadState, type InfiniteRequestOptions, type InstanceApiContext, type InstanceApiResolvers, type InstancePluginExecutor, type LifecyclePhase, type MergePluginInstanceApi, type MergePluginOptions, type MergePluginResults, type MethodOptionsMap, type MiddlewareContext, type MiddlewareHandler, type MiddlewarePhase, type OperationController, type OperationState, type OperationType, type PageContext, type PluginAccessor, type PluginArray, type PluginContext, type PluginContextInput, type PluginExecutor, type PluginExportsRegistry, type PluginFactory, type PluginHandler, type PluginLifecycle, type PluginMiddleware, type PluginRegistry, type PluginResolvers, type PluginResponseHandler, type PluginResultResolvers, type PluginTypeConfig, type PluginUpdateHandler, type ReadClient, type ReadPaths, type ReadSchemaHelper, type RefetchEvent, type RequestOptions$1 as RequestOptions, type ResolveInstanceApi, type ResolveResultTypes, type ResolveSchemaTypes, type ResolveTypes, type ResolverContext, type RetryConfig, type RouteToPath, type SchemaPaths, type SelectedEndpoint, type SelectorFunction, type SelectorResult, type Simplify, Spoosh, type SpooshBody, type SpooshClient, type SpooshConfig, type SpooshInstance, type SpooshMiddleware, type SpooshOptions, type SpooshOptionsExtra, type SpooshPlugin, type SpooshResponse, type SpooshSchema, type StateManager, type TagMode, type TagOptions, type WriteClient, type WriteMethod, type WritePaths, type WriteSchemaHelper, __DEV__, applyMiddlewares, buildUrl, composeMiddlewares, containsFile, createClient, createEventEmitter, createInfiniteReadController, createInitialState, createMiddleware, createOperationController, createPluginExecutor, createPluginRegistry, createProxyHandler, createSelectorProxy, createStateManager, executeFetch, extractMethodFromSelector, extractPathFromSelector, form, generateTags, getContentType, isJsonBody, isSpooshBody, json, mergeHeaders, objectToFormData, objectToUrlEncoded, resolveHeadersToRecord, resolvePath, resolveRequestBody, resolveTags, setHeaders, sortObjectKeys, urlencoded };

package/dist/index.js

@@ -22,6 +22,7 @@ var src_exports = {};
 __export(src_exports, {
   HTTP_METHODS: () => HTTP_METHODS,
   Spoosh: () => Spoosh,
+  __DEV__: () => __DEV__,
   applyMiddlewares: () => applyMiddlewares,
   buildUrl: () => buildUrl,
   composeMiddlewares: () => composeMiddlewares,
@@ -40,17 +41,22 @@ __export(src_exports, {
   executeFetch: () => executeFetch,
   extractMethodFromSelector: () => extractMethodFromSelector,
   extractPathFromSelector: () => extractPathFromSelector,
+  form: () => form,
   generateTags: () => generateTags,
   getContentType: () => getContentType,
   isJsonBody: () => isJsonBody,
+  isSpooshBody: () => isSpooshBody,
+  json: () => json,
   mergeHeaders: () => mergeHeaders,
   objectToFormData: () => objectToFormData,
   objectToUrlEncoded: () => objectToUrlEncoded,
   resolveHeadersToRecord: () => resolveHeadersToRecord,
   resolvePath: () => resolvePath,
+  resolveRequestBody: () => resolveRequestBody,
   resolveTags: () => resolveTags,
   setHeaders: () => setHeaders,
-  sortObjectKeys: () => sortObjectKeys
+  sortObjectKeys: () => sortObjectKeys,
+  urlencoded: () => urlencoded
 });
 module.exports = __toCommonJS(src_exports);
 
@@ -99,6 +105,11 @@ function buildUrl(baseUrl, path, query) {
   return `${cleanBase}${pathStr}${queryStr ? `?${queryStr}` : ""}`;
 }
 
+// src/utils/env.ts
+function __DEV__() {
+  return typeof process !== "undefined" && true;
+}
+
 // src/utils/generateTags.ts
 function generateTags(path) {
   return path.map((_, i) => path.slice(0, i + 1).join("/"));
@@ -122,7 +133,6 @@ function isJsonBody(body) {
   if (body instanceof ReadableStream) return false;
   if (typeof body === "string") return false;
   if (typeof body === "object") {
-    if (containsFile(body)) return false;
     return true;
   }
   return false;
@@ -246,6 +256,67 @@ function sortObjectKeys(obj, seen = /* @__PURE__ */ new WeakSet()) {
   );
 }
 
+// src/utils/body.ts
+function isSpooshBody(value) {
+  return typeof value === "object" && value !== null && "__spooshBody" in value && value.__spooshBody === true;
+}
+function form(value) {
+  return Object.freeze({
+    __spooshBody: true,
+    kind: "form",
+    value
+  });
+}
+function json(value) {
+  return Object.freeze({
+    __spooshBody: true,
+    kind: "json",
+    value
+  });
+}
+function urlencoded(value) {
+  return Object.freeze({
+    __spooshBody: true,
+    kind: "urlencoded",
+    value
+  });
+}
+function resolveRequestBody(rawBody) {
+  if (rawBody === void 0 || rawBody === null) {
+    return void 0;
+  }
+  if (isSpooshBody(rawBody)) {
+    switch (rawBody.kind) {
+      case "form":
+        return {
+          body: objectToFormData(rawBody.value)
+        };
+      case "json":
+        return {
+          body: JSON.stringify(rawBody.value),
+          headers: { "Content-Type": "application/json" }
+        };
+      case "urlencoded":
+        return {
+          body: objectToUrlEncoded(rawBody.value),
+          headers: { "Content-Type": "application/x-www-form-urlencoded" }
+        };
+    }
+  }
+  if (isJsonBody(rawBody)) {
+    if (__DEV__() && containsFile(rawBody)) {
+      console.warn(
+        "[spoosh] Plain object body contains File/Blob. Use form() wrapper for multipart upload."
+      );
+    }
+    return {
+      body: JSON.stringify(rawBody),
+      headers: { "Content-Type": "application/json" }
+    };
+  }
+  return { body: rawBody };
+}
+
 // src/utils/path-utils.ts
 function resolveTagMode(mode, path) {
   switch (mode) {
@@ -391,25 +462,15 @@ async function executeCoreFetch(config) {
     fetchInit.signal = requestOptions.signal;
   }
   if (requestOptions?.body !== void 0) {
-    const contentType = getContentType(headers);
-    if (contentType?.includes("application/x-www-form-urlencoded")) {
-      fetchInit.body = objectToUrlEncoded(
-        requestOptions.body
-      );
-    } else if (contentType?.includes("multipart/form-data") || containsFile(requestOptions.body)) {
-      fetchInit.body = objectToFormData(
-        requestOptions.body
-      );
-    } else if (isJsonBody(requestOptions.body)) {
-      fetchInit.body = JSON.stringify(requestOptions.body);
-      headers = await mergeHeaders(headers, {
-        "Content-Type": "application/json"
-      });
-      if (headers) {
-        fetchInit.headers = headers;
+    const resolved = resolveRequestBody(requestOptions.body);
+    if (resolved) {
+      fetchInit.body = resolved.body;
+      if (resolved.headers) {
+        headers = await mergeHeaders(headers, resolved.headers);
+        if (headers) {
+          fetchInit.headers = headers;
+        }
       }
-    } else {
-      fetchInit.body = requestOptions.body;
     }
   }
   let lastError;

package/dist/index.mjs

@@ -43,6 +43,11 @@ function buildUrl(baseUrl, path, query) {
   return `${cleanBase}${pathStr}${queryStr ? `?${queryStr}` : ""}`;
 }
 
+// src/utils/env.ts
+function __DEV__() {
+  return typeof process !== "undefined" && true;
+}
+
 // src/utils/generateTags.ts
 function generateTags(path) {
   return path.map((_, i) => path.slice(0, i + 1).join("/"));
@@ -66,7 +71,6 @@ function isJsonBody(body) {
   if (body instanceof ReadableStream) return false;
   if (typeof body === "string") return false;
   if (typeof body === "object") {
-    if (containsFile(body)) return false;
     return true;
   }
   return false;
@@ -190,6 +194,67 @@ function sortObjectKeys(obj, seen = /* @__PURE__ */ new WeakSet()) {
   );
 }
 
+// src/utils/body.ts
+function isSpooshBody(value) {
+  return typeof value === "object" && value !== null && "__spooshBody" in value && value.__spooshBody === true;
+}
+function form(value) {
+  return Object.freeze({
+    __spooshBody: true,
+    kind: "form",
+    value
+  });
+}
+function json(value) {
+  return Object.freeze({
+    __spooshBody: true,
+    kind: "json",
+    value
+  });
+}
+function urlencoded(value) {
+  return Object.freeze({
+    __spooshBody: true,
+    kind: "urlencoded",
+    value
+  });
+}
+function resolveRequestBody(rawBody) {
+  if (rawBody === void 0 || rawBody === null) {
+    return void 0;
+  }
+  if (isSpooshBody(rawBody)) {
+    switch (rawBody.kind) {
+      case "form":
+        return {
+          body: objectToFormData(rawBody.value)
+        };
+      case "json":
+        return {
+          body: JSON.stringify(rawBody.value),
+          headers: { "Content-Type": "application/json" }
+        };
+      case "urlencoded":
+        return {
+          body: objectToUrlEncoded(rawBody.value),
+          headers: { "Content-Type": "application/x-www-form-urlencoded" }
+        };
+    }
+  }
+  if (isJsonBody(rawBody)) {
+    if (__DEV__() && containsFile(rawBody)) {
+      console.warn(
+        "[spoosh] Plain object body contains File/Blob. Use form() wrapper for multipart upload."
+      );
+    }
+    return {
+      body: JSON.stringify(rawBody),
+      headers: { "Content-Type": "application/json" }
+    };
+  }
+  return { body: rawBody };
+}
+
 // src/utils/path-utils.ts
 function resolveTagMode(mode, path) {
   switch (mode) {
@@ -335,25 +400,15 @@ async function executeCoreFetch(config) {
     fetchInit.signal = requestOptions.signal;
   }
   if (requestOptions?.body !== void 0) {
-    const contentType = getContentType(headers);
-    if (contentType?.includes("application/x-www-form-urlencoded")) {
-      fetchInit.body = objectToUrlEncoded(
-        requestOptions.body
-      );
-    } else if (contentType?.includes("multipart/form-data") || containsFile(requestOptions.body)) {
-      fetchInit.body = objectToFormData(
-        requestOptions.body
-      );
-    } else if (isJsonBody(requestOptions.body)) {
-      fetchInit.body = JSON.stringify(requestOptions.body);
-      headers = await mergeHeaders(headers, {
-        "Content-Type": "application/json"
-      });
-      if (headers) {
-        fetchInit.headers = headers;
+    const resolved = resolveRequestBody(requestOptions.body);
+    if (resolved) {
+      fetchInit.body = resolved.body;
+      if (resolved.headers) {
+        headers = await mergeHeaders(headers, resolved.headers);
+        if (headers) {
+          fetchInit.headers = headers;
+        }
       }
-    } else {
-      fetchInit.body = requestOptions.body;
     }
   }
   let lastError;
@@ -1607,6 +1662,7 @@ function createInfiniteReadController(options) {
 export {
   HTTP_METHODS,
   Spoosh,
+  __DEV__,
   applyMiddlewares,
   buildUrl,
   composeMiddlewares,
@@ -1625,15 +1681,20 @@ export {
   executeFetch,
   extractMethodFromSelector,
   extractPathFromSelector,
+  form,
   generateTags,
   getContentType,
   isJsonBody,
+  isSpooshBody,
+  json,
   mergeHeaders,
   objectToFormData,
   objectToUrlEncoded,
   resolveHeadersToRecord,
   resolvePath,
+  resolveRequestBody,
   resolveTags,
   setHeaders,
-  sortObjectKeys
+  sortObjectKeys,
+  urlencoded
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spoosh/core",
-  "version": "0.8.2",
+  "version": "0.9.0",
   "license": "MIT",
   "description": "Type-safe API client with plugin middleware system",
   "keywords": [