api-def 0.13.0 → 0.14.0-alpha.2

package/cjs/ApiTypes.d.ts

@@ -7,7 +7,8 @@ export type AcceptableStatus = number | [min: number, max: number];
 export type RawHeaders = Record<string, string | number | boolean | null | undefined>;
 export type Params = string;
 export type Query = string | undefined | Record<string, any>;
-export type Body = string | number | Record<string, any>;
+export type Body = string | number | Record<string, any> | FormData;
+export type RequestBodyEncoding = "application/json" | "multipart/form-data" | "application/x-www-form-urlencoded";
 export type State = Record<string, any>;
 export interface ApiResponse<T = any> {
     readonly method: RequestMethod;

package/cjs/EndpointBuilder.d.ts

@@ -3,6 +3,7 @@ import type { Api } from "./Api";
 import type { ResponseType } from "./ApiConstants";
 import type { Body, Params, Query, RawHeaders, State } from "./ApiTypes";
 import Endpoint, { type EndpointOptions } from "./Endpoint";
+import type { BodyValidationOptions, ValidationOptions } from "./Validation";
 type DefaultResponseOf<T extends ResponseType | undefined> = T extends "text" ? string : T extends "arraybuffer" ? ArrayBuffer : "stream" extends T ? AsyncIterable<Uint8Array> : unknown;
 export type EndpointBuildOptions<TResponse = unknown, TParams extends Params | undefined = undefined, TQuery extends Query | undefined = undefined, TBody extends Body | undefined = undefined, TState extends State = State, TRequestHeaders extends RawHeaders | undefined = RawHeaders | undefined, TResponseHeaders extends RawHeaders | undefined = RawHeaders | undefined, TPath extends string = string, TResponseType extends ResponseType | undefined = undefined> = Omit<EndpointOptions<TResponse, TParams, TQuery, TBody, TState, TPath, TRequestHeaders, TResponseHeaders>, "validation"> & {
     responseType?: TResponseType;
@@ -11,10 +12,26 @@ export default class EndpointBuilder<TResponse = unknown, TParams extends Params
     private api;
     private readonly validation;
     constructor(api: Api);
+    queryOf<TNewQuery extends Query>(options?: ValidationOptions<TNewQuery>): EndpointBuilder<TResponse, TParams, TNewQuery, TBody, TState, TRequestHeaders, TResponseHeaders>;
+    /**
+     * @deprecated Pass `{ schema }` instead.
+     */
     queryOf<TNewQuery extends Query>(schema?: zod.Schema<TNewQuery>): EndpointBuilder<TResponse, TParams, TNewQuery, TBody, TState, TRequestHeaders, TResponseHeaders>;
     paramsOf<TNewParams extends Params>(): EndpointBuilder<TResponse, TNewParams, TQuery, TBody, TState, TRequestHeaders, TResponseHeaders>;
+    bodyOf<TNewBody extends Body>(options?: BodyValidationOptions<TNewBody>): EndpointBuilder<TResponse, TParams, TQuery, TNewBody, TState, TRequestHeaders, TResponseHeaders>;
+    /**
+     * @deprecated Pass `{ schema }` instead.
+     */
     bodyOf<TNewBody extends Body>(schema?: zod.Schema<TNewBody>): EndpointBuilder<TResponse, TParams, TQuery, TNewBody, TState, TRequestHeaders, TResponseHeaders>;
+    responseOf<TNewResponse>(options?: ValidationOptions<TNewResponse>): EndpointBuilder<TNewResponse, TParams, TQuery, TBody, TState, TRequestHeaders, TResponseHeaders>;
+    /**
+     * @deprecated Pass `{ schema }` instead.
+     */
     responseOf<TNewResponse>(schema?: zod.Schema<TNewResponse>): EndpointBuilder<TNewResponse, TParams, TQuery, TBody, TState, TRequestHeaders, TResponseHeaders>;
+    stateOf<TNewState extends State>(options?: ValidationOptions<TNewState>): EndpointBuilder<TResponse, TParams, TQuery, TBody, TNewState, TRequestHeaders, TResponseHeaders>;
+    /**
+     * @deprecated Pass `{ schema }` instead.
+     */
     stateOf<TNewState extends State>(schema?: zod.Schema<TNewState>): EndpointBuilder<TResponse, TParams, TQuery, TBody, TNewState, TRequestHeaders, TResponseHeaders>;
     requestHeadersOf<TNewRequestHeaders extends RawHeaders>(): EndpointBuilder<TResponse, TParams, TQuery, TBody, TState, TNewRequestHeaders, TResponseHeaders>;
     responseHeadersOf<TNewResponseHeaders extends RawHeaders>(): EndpointBuilder<TResponse, TParams, TQuery, TBody, TState, TRequestHeaders, TNewResponseHeaders>;

package/cjs/EndpointBuilder.js

@@ -4,28 +4,56 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const Endpoint_1 = __importDefault(require("./Endpoint"));
+const isSchema = (value) => {
+    return value !== undefined && "parse" in value;
+};
+const warnDeprecatedSchemaArgument = (methodName) => {
+    console.warn(`[api-def] ${methodName}(schema) is deprecated. Use ${methodName}({ schema }) instead.`);
+};
 class EndpointBuilder {
     constructor(api) {
         this.validation = {};
         this.api = api;
     }
-    queryOf(schema) {
-        this.validation.query = schema;
+    queryOf(optionsOrSchema) {
+        if (optionsOrSchema && isSchema(optionsOrSchema)) {
+            warnDeprecatedSchemaArgument("queryOf");
+            this.validation.query = optionsOrSchema;
+            return this;
+        }
+        this.validation.query = optionsOrSchema?.schema;
         return this;
     }
     paramsOf() {
         return this;
     }
-    bodyOf(schema) {
-        this.validation.body = schema;
+    bodyOf(optionsOrSchema) {
+        if (optionsOrSchema && isSchema(optionsOrSchema)) {
+            warnDeprecatedSchemaArgument("bodyOf");
+            this.validation.body = optionsOrSchema;
+            this.validation.bodyEncoding = "application/json";
+            return this;
+        }
+        this.validation.body = optionsOrSchema?.schema;
+        this.validation.bodyEncoding = optionsOrSchema?.encoding ?? "application/json";
         return this;
     }
-    responseOf(schema) {
-        this.validation.response = schema;
+    responseOf(optionsOrSchema) {
+        if (optionsOrSchema && isSchema(optionsOrSchema)) {
+            warnDeprecatedSchemaArgument("responseOf");
+            this.validation.response = optionsOrSchema;
+            return this;
+        }
+        this.validation.response = optionsOrSchema?.schema;
         return this;
     }
-    stateOf(schema) {
-        this.validation.state = schema;
+    stateOf(optionsOrSchema) {
+        if (optionsOrSchema && isSchema(optionsOrSchema)) {
+            warnDeprecatedSchemaArgument("stateOf");
+            this.validation.state = optionsOrSchema;
+            return this;
+        }
+        this.validation.state = optionsOrSchema?.schema;
         return this;
     }
     requestHeadersOf() {

package/cjs/RequestContext.d.ts

@@ -42,6 +42,7 @@ export default class RequestContext<TResponse = any, TParams extends Params | un
     updateParams(params: Partial<Record<string, string>>): this;
     private parseRequestBody;
     getParsedBody(): any;
+    parseBody(): void;
     updateQuery(newQuery: Partial<TQuery>): this;
     triggerEvent(eventType: RequestEvent): Promise<EventResult<TResponse> | undefined>;
     addCanceller(canceler: () => void): void;

package/cjs/RequestContext.js

@@ -129,6 +129,10 @@ class RequestContext {
         if (this.requestConfig.body && this.requestConfig.headers) {
             const contentTypeKey = Object.keys(this.requestConfig.headers).find((key) => key.toLowerCase() === "content-type");
             const contentType = contentTypeKey && this.requestConfig.headers[contentTypeKey]?.toString().split(";")[0].trim();
+            const bodyEncoding = this.validation.bodyEncoding ?? "application/json";
+            if (!contentTypeKey && bodyEncoding === "application/x-www-form-urlencoded") {
+                this.requestConfig.headers["Content-Type"] = "application/x-www-form-urlencoded";
+            }
             if (contentType === "application/x-www-form-urlencoded") {
                 const searchParams = new URLSearchParams();
                 for (const key of Object.keys(this.requestConfig.body)) {
@@ -137,6 +141,17 @@ class RequestContext {
                 }
                 this.parsedBody = searchParams;
             }
+            else if (bodyEncoding === "application/x-www-form-urlencoded") {
+                const searchParams = new URLSearchParams();
+                for (const key of Object.keys(this.requestConfig.body)) {
+                    const value = this.requestConfig.body[key];
+                    searchParams.append(key, value?.toString());
+                }
+                this.parsedBody = searchParams;
+            }
+            else if (bodyEncoding === "multipart/form-data") {
+                this.parsedBody = Utils.toFormData(this.requestConfig.body);
+            }
             else {
                 this.parsedBody = this.requestConfig.body;
             }
@@ -148,6 +163,9 @@ class RequestContext {
     getParsedBody() {
         return this.parsedBody;
     }
+    parseBody() {
+        this.parseRequestBody();
+    }
     updateQuery(newQuery) {
         this.requestConfig.queryObject = Utils.assign({}, this.requestConfig.queryObject, newQuery);
         this.computedRequestUrl = this.resolveRequestUrl();

package/cjs/Requester.js

@@ -95,6 +95,7 @@ const makeRequest = async (context) => {
             });
         }
     }
+    context.parseBody();
     const retryOptions = parseRetryOptions(context.requestConfig?.retry);
     const internalRetryOptions = {
         retries: retryOptions.maxAttempts,

package/cjs/Utils.d.ts

@@ -14,3 +14,4 @@ export declare const noop: () => void;
 export declare const delayThenReturn: <T>(value: T, delayMs: number) => Promise<T>;
 export declare const randInt: (min: number, max: number) => number;
 export declare const isFormData: (value: any) => value is FormData;
+export declare const toFormData: (body: any) => FormData;

package/cjs/Utils.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isFormData = exports.randInt = exports.delayThenReturn = exports.noop = exports.getGlobalFetch = exports.getGlobal = exports.padNumber = exports.assign = void 0;
+exports.toFormData = exports.isFormData = exports.randInt = exports.delayThenReturn = exports.noop = exports.getGlobalFetch = exports.getGlobal = exports.padNumber = exports.assign = void 0;
 // polyfill from https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/assign
 const hasOwn = (object, key) => Object.prototype.hasOwnProperty.call(object, key);
 exports.assign = Object.assign ||
@@ -73,6 +73,58 @@ const randInt = (min, max) => {
 };
 exports.randInt = randInt;
 const isFormData = (value) => {
-    return value instanceof FormData;
+    return typeof FormData !== "undefined" && value instanceof FormData;
 };
 exports.isFormData = isFormData;
+const isPlainObject = (value) => {
+    return Object.prototype.toString.call(value) === "[object Object]";
+};
+const isBlob = (value) => {
+    return typeof Blob !== "undefined" && value instanceof Blob;
+};
+const isArrayBuffer = (value) => {
+    return typeof ArrayBuffer !== "undefined" && value instanceof ArrayBuffer;
+};
+const isArrayBufferView = (value) => {
+    return typeof ArrayBuffer !== "undefined" && ArrayBuffer.isView(value);
+};
+const toFormDataValue = (value) => {
+    if (isBlob(value)) {
+        return value;
+    }
+    if ((isArrayBuffer(value) || isArrayBufferView(value)) && typeof Blob !== "undefined") {
+        return new Blob([value]);
+    }
+    return String(value);
+};
+const toFormData = (body) => {
+    if ((0, exports.isFormData)(body)) {
+        return body;
+    }
+    const formData = new FormData();
+    const appendValue = (key, value) => {
+        if (value === undefined || value === null) {
+            return;
+        }
+        if (Array.isArray(value)) {
+            for (const [index, item] of value.entries()) {
+                appendValue(`${key}.${index}`, item);
+            }
+            return;
+        }
+        if (isPlainObject(value) && !isBlob(value)) {
+            for (const nestedKey of Object.keys(value)) {
+                appendValue(`${key}.${nestedKey}`, value[nestedKey]);
+            }
+            return;
+        }
+        formData.append(key, toFormDataValue(value));
+    };
+    if (isPlainObject(body)) {
+        for (const key of Object.keys(body)) {
+            appendValue(key, body[key]);
+        }
+    }
+    return formData;
+};
+exports.toFormData = toFormData;

package/cjs/Validation.d.ts

@@ -1,9 +1,16 @@
 import type * as zod from "zod";
-import type { Body, Params, Query, State } from "./ApiTypes";
+import type { Body, Params, Query, RequestBodyEncoding, State } from "./ApiTypes";
+export interface ValidationOptions<TValue> {
+    schema?: zod.Schema<TValue>;
+}
+export interface BodyValidationOptions<TBody extends Body> extends ValidationOptions<TBody> {
+    encoding?: RequestBodyEncoding;
+}
 export interface Validation<TResponse = any, TParams extends Params | undefined = Params | undefined, TQuery extends Query | undefined = Query | undefined, TBody extends Body | undefined = Body | undefined, TState extends State = State> {
     query?: zod.Schema<TQuery>;
     params?: zod.Schema<TParams>;
     body?: zod.Schema<TBody>;
+    bodyEncoding?: RequestBodyEncoding;
     response?: zod.Schema<TResponse>;
     state?: zod.Schema<TState>;
 }

package/cjs/backend/FetchRequestBackend.js

@@ -111,7 +111,7 @@ class FetchRequestBackend {
         let softAbort = false;
         let responded = false;
         const body = context.getParsedBody();
-        const bodyJsonify = body !== null && typeof body === "object" && !Utils.isFormData(body);
+        const bodyJsonify = body !== null && typeof body === "object" && !Utils.isFormData(body) && !(body instanceof URLSearchParams);
         const headers = Utils.assign({
             // logic from axios
             "Content-Type": bodyJsonify ? "application/json;charset=utf-8" : undefined,

package/esm/ApiTypes.d.ts

@@ -7,7 +7,8 @@ export type AcceptableStatus = number | [min: number, max: number];
 export type RawHeaders = Record<string, string | number | boolean | null | undefined>;
 export type Params = string;
 export type Query = string | undefined | Record<string, any>;
-export type Body = string | number | Record<string, any>;
+export type Body = string | number | Record<string, any> | FormData;
+export type RequestBodyEncoding = "application/json" | "multipart/form-data" | "application/x-www-form-urlencoded";
 export type State = Record<string, any>;
 export interface ApiResponse<T = any> {
     readonly method: RequestMethod;

package/esm/EndpointBuilder.d.ts

@@ -3,6 +3,7 @@ import type { Api } from "./Api.js";
 import type { ResponseType } from "./ApiConstants.js";
 import type { Body, Params, Query, RawHeaders, State } from "./ApiTypes.js";
 import Endpoint, { type EndpointOptions } from "./Endpoint.js";
+import type { BodyValidationOptions, ValidationOptions } from "./Validation.js";
 type DefaultResponseOf<T extends ResponseType | undefined> = T extends "text" ? string : T extends "arraybuffer" ? ArrayBuffer : "stream" extends T ? AsyncIterable<Uint8Array> : unknown;
 export type EndpointBuildOptions<TResponse = unknown, TParams extends Params | undefined = undefined, TQuery extends Query | undefined = undefined, TBody extends Body | undefined = undefined, TState extends State = State, TRequestHeaders extends RawHeaders | undefined = RawHeaders | undefined, TResponseHeaders extends RawHeaders | undefined = RawHeaders | undefined, TPath extends string = string, TResponseType extends ResponseType | undefined = undefined> = Omit<EndpointOptions<TResponse, TParams, TQuery, TBody, TState, TPath, TRequestHeaders, TResponseHeaders>, "validation"> & {
     responseType?: TResponseType;
@@ -11,10 +12,26 @@ export default class EndpointBuilder<TResponse = unknown, TParams extends Params
     private api;
     private readonly validation;
     constructor(api: Api);
+    queryOf<TNewQuery extends Query>(options?: ValidationOptions<TNewQuery>): EndpointBuilder<TResponse, TParams, TNewQuery, TBody, TState, TRequestHeaders, TResponseHeaders>;
+    /**
+     * @deprecated Pass `{ schema }` instead.
+     */
     queryOf<TNewQuery extends Query>(schema?: zod.Schema<TNewQuery>): EndpointBuilder<TResponse, TParams, TNewQuery, TBody, TState, TRequestHeaders, TResponseHeaders>;
     paramsOf<TNewParams extends Params>(): EndpointBuilder<TResponse, TNewParams, TQuery, TBody, TState, TRequestHeaders, TResponseHeaders>;
+    bodyOf<TNewBody extends Body>(options?: BodyValidationOptions<TNewBody>): EndpointBuilder<TResponse, TParams, TQuery, TNewBody, TState, TRequestHeaders, TResponseHeaders>;
+    /**
+     * @deprecated Pass `{ schema }` instead.
+     */
     bodyOf<TNewBody extends Body>(schema?: zod.Schema<TNewBody>): EndpointBuilder<TResponse, TParams, TQuery, TNewBody, TState, TRequestHeaders, TResponseHeaders>;
+    responseOf<TNewResponse>(options?: ValidationOptions<TNewResponse>): EndpointBuilder<TNewResponse, TParams, TQuery, TBody, TState, TRequestHeaders, TResponseHeaders>;
+    /**
+     * @deprecated Pass `{ schema }` instead.
+     */
     responseOf<TNewResponse>(schema?: zod.Schema<TNewResponse>): EndpointBuilder<TNewResponse, TParams, TQuery, TBody, TState, TRequestHeaders, TResponseHeaders>;
+    stateOf<TNewState extends State>(options?: ValidationOptions<TNewState>): EndpointBuilder<TResponse, TParams, TQuery, TBody, TNewState, TRequestHeaders, TResponseHeaders>;
+    /**
+     * @deprecated Pass `{ schema }` instead.
+     */
     stateOf<TNewState extends State>(schema?: zod.Schema<TNewState>): EndpointBuilder<TResponse, TParams, TQuery, TBody, TNewState, TRequestHeaders, TResponseHeaders>;
     requestHeadersOf<TNewRequestHeaders extends RawHeaders>(): EndpointBuilder<TResponse, TParams, TQuery, TBody, TState, TNewRequestHeaders, TResponseHeaders>;
     responseHeadersOf<TNewResponseHeaders extends RawHeaders>(): EndpointBuilder<TResponse, TParams, TQuery, TBody, TState, TRequestHeaders, TNewResponseHeaders>;

package/esm/EndpointBuilder.js

@@ -1,26 +1,54 @@
 import Endpoint from "./Endpoint.js";
+const isSchema = (value) => {
+    return value !== undefined && "parse" in value;
+};
+const warnDeprecatedSchemaArgument = (methodName) => {
+    console.warn(`[api-def] ${methodName}(schema) is deprecated. Use ${methodName}({ schema }) instead.`);
+};
 export default class EndpointBuilder {
     constructor(api) {
         this.validation = {};
         this.api = api;
     }
-    queryOf(schema) {
-        this.validation.query = schema;
+    queryOf(optionsOrSchema) {
+        if (optionsOrSchema && isSchema(optionsOrSchema)) {
+            warnDeprecatedSchemaArgument("queryOf");
+            this.validation.query = optionsOrSchema;
+            return this;
+        }
+        this.validation.query = optionsOrSchema?.schema;
         return this;
     }
     paramsOf() {
         return this;
     }
-    bodyOf(schema) {
-        this.validation.body = schema;
+    bodyOf(optionsOrSchema) {
+        if (optionsOrSchema && isSchema(optionsOrSchema)) {
+            warnDeprecatedSchemaArgument("bodyOf");
+            this.validation.body = optionsOrSchema;
+            this.validation.bodyEncoding = "application/json";
+            return this;
+        }
+        this.validation.body = optionsOrSchema?.schema;
+        this.validation.bodyEncoding = optionsOrSchema?.encoding ?? "application/json";
         return this;
     }
-    responseOf(schema) {
-        this.validation.response = schema;
+    responseOf(optionsOrSchema) {
+        if (optionsOrSchema && isSchema(optionsOrSchema)) {
+            warnDeprecatedSchemaArgument("responseOf");
+            this.validation.response = optionsOrSchema;
+            return this;
+        }
+        this.validation.response = optionsOrSchema?.schema;
         return this;
     }
-    stateOf(schema) {
-        this.validation.state = schema;
+    stateOf(optionsOrSchema) {
+        if (optionsOrSchema && isSchema(optionsOrSchema)) {
+            warnDeprecatedSchemaArgument("stateOf");
+            this.validation.state = optionsOrSchema;
+            return this;
+        }
+        this.validation.state = optionsOrSchema?.schema;
         return this;
     }
     requestHeadersOf() {

package/esm/RequestContext.d.ts

@@ -42,6 +42,7 @@ export default class RequestContext<TResponse = any, TParams extends Params | un
     updateParams(params: Partial<Record<string, string>>): this;
     private parseRequestBody;
     getParsedBody(): any;
+    parseBody(): void;
     updateQuery(newQuery: Partial<TQuery>): this;
     triggerEvent(eventType: RequestEvent): Promise<EventResult<TResponse> | undefined>;
     addCanceller(canceler: () => void): void;

package/esm/RequestContext.js

@@ -94,6 +94,10 @@ export default class RequestContext {
         if (this.requestConfig.body && this.requestConfig.headers) {
             const contentTypeKey = Object.keys(this.requestConfig.headers).find((key) => key.toLowerCase() === "content-type");
             const contentType = contentTypeKey && this.requestConfig.headers[contentTypeKey]?.toString().split(";")[0].trim();
+            const bodyEncoding = this.validation.bodyEncoding ?? "application/json";
+            if (!contentTypeKey && bodyEncoding === "application/x-www-form-urlencoded") {
+                this.requestConfig.headers["Content-Type"] = "application/x-www-form-urlencoded";
+            }
             if (contentType === "application/x-www-form-urlencoded") {
                 const searchParams = new URLSearchParams();
                 for (const key of Object.keys(this.requestConfig.body)) {
@@ -102,6 +106,17 @@ export default class RequestContext {
                 }
                 this.parsedBody = searchParams;
             }
+            else if (bodyEncoding === "application/x-www-form-urlencoded") {
+                const searchParams = new URLSearchParams();
+                for (const key of Object.keys(this.requestConfig.body)) {
+                    const value = this.requestConfig.body[key];
+                    searchParams.append(key, value?.toString());
+                }
+                this.parsedBody = searchParams;
+            }
+            else if (bodyEncoding === "multipart/form-data") {
+                this.parsedBody = Utils.toFormData(this.requestConfig.body);
+            }
             else {
                 this.parsedBody = this.requestConfig.body;
             }
@@ -113,6 +128,9 @@ export default class RequestContext {
     getParsedBody() {
         return this.parsedBody;
     }
+    parseBody() {
+        this.parseRequestBody();
+    }
     updateQuery(newQuery) {
         this.requestConfig.queryObject = Utils.assign({}, this.requestConfig.queryObject, newQuery);
         this.computedRequestUrl = this.resolveRequestUrl();

package/esm/Requester.js

@@ -88,6 +88,7 @@ const makeRequest = async (context) => {
             });
         }
     }
+    context.parseBody();
     const retryOptions = parseRetryOptions(context.requestConfig?.retry);
     const internalRetryOptions = {
         retries: retryOptions.maxAttempts,

package/esm/Utils.d.ts

@@ -14,3 +14,4 @@ export declare const noop: () => void;
 export declare const delayThenReturn: <T>(value: T, delayMs: number) => Promise<T>;
 export declare const randInt: (min: number, max: number) => number;
 export declare const isFormData: (value: any) => value is FormData;
+export declare const toFormData: (body: any) => FormData;

package/esm/Utils.js

@@ -64,5 +64,56 @@ export const randInt = (min, max) => {
     return Math.floor(Math.random() * (maxI - minI + 1)) + minI;
 };
 export const isFormData = (value) => {
-    return value instanceof FormData;
+    return typeof FormData !== "undefined" && value instanceof FormData;
+};
+const isPlainObject = (value) => {
+    return Object.prototype.toString.call(value) === "[object Object]";
+};
+const isBlob = (value) => {
+    return typeof Blob !== "undefined" && value instanceof Blob;
+};
+const isArrayBuffer = (value) => {
+    return typeof ArrayBuffer !== "undefined" && value instanceof ArrayBuffer;
+};
+const isArrayBufferView = (value) => {
+    return typeof ArrayBuffer !== "undefined" && ArrayBuffer.isView(value);
+};
+const toFormDataValue = (value) => {
+    if (isBlob(value)) {
+        return value;
+    }
+    if ((isArrayBuffer(value) || isArrayBufferView(value)) && typeof Blob !== "undefined") {
+        return new Blob([value]);
+    }
+    return String(value);
+};
+export const toFormData = (body) => {
+    if (isFormData(body)) {
+        return body;
+    }
+    const formData = new FormData();
+    const appendValue = (key, value) => {
+        if (value === undefined || value === null) {
+            return;
+        }
+        if (Array.isArray(value)) {
+            for (const [index, item] of value.entries()) {
+                appendValue(`${key}.${index}`, item);
+            }
+            return;
+        }
+        if (isPlainObject(value) && !isBlob(value)) {
+            for (const nestedKey of Object.keys(value)) {
+                appendValue(`${key}.${nestedKey}`, value[nestedKey]);
+            }
+            return;
+        }
+        formData.append(key, toFormDataValue(value));
+    };
+    if (isPlainObject(body)) {
+        for (const key of Object.keys(body)) {
+            appendValue(key, body[key]);
+        }
+    }
+    return formData;
 };

package/esm/Validation.d.ts

@@ -1,9 +1,16 @@
 import type * as zod from "zod";
-import type { Body, Params, Query, State } from "./ApiTypes.js";
+import type { Body, Params, Query, RequestBodyEncoding, State } from "./ApiTypes.js";
+export interface ValidationOptions<TValue> {
+    schema?: zod.Schema<TValue>;
+}
+export interface BodyValidationOptions<TBody extends Body> extends ValidationOptions<TBody> {
+    encoding?: RequestBodyEncoding;
+}
 export interface Validation<TResponse = any, TParams extends Params | undefined = Params | undefined, TQuery extends Query | undefined = Query | undefined, TBody extends Body | undefined = Body | undefined, TState extends State = State> {
     query?: zod.Schema<TQuery>;
     params?: zod.Schema<TParams>;
     body?: zod.Schema<TBody>;
+    bodyEncoding?: RequestBodyEncoding;
     response?: zod.Schema<TResponse>;
     state?: zod.Schema<TState>;
 }

package/esm/backend/FetchRequestBackend.js

@@ -76,7 +76,7 @@ export default class FetchRequestBackend {
         let softAbort = false;
         let responded = false;
         const body = context.getParsedBody();
-        const bodyJsonify = body !== null && typeof body === "object" && !Utils.isFormData(body);
+        const bodyJsonify = body !== null && typeof body === "object" && !Utils.isFormData(body) && !(body instanceof URLSearchParams);
         const headers = Utils.assign({
             // logic from axios
             "Content-Type": bodyJsonify ? "application/json;charset=utf-8" : undefined,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "api-def",
-  "version": "0.13.0",
+  "version": "0.14.0-alpha.2",
   "description": "Typed API definitions with middleware support",
   "main": "cjs/index.js",
   "types": "esm/index.d.ts",
@@ -91,6 +91,7 @@
     "commander": "^15.0.0",
     "cross-env": "10.1.0",
     "esbuild": "^0.28.0",
+    "formdata-node": "6.0.3",
     "jest": "30.4.2",
     "kleur": "^4.1.5",
     "lodash": "^4.18.1",