ebely 0.0.7 → 0.1.0

package/dist/index.d.ts

@@ -230,6 +230,57 @@ type SwaggerSource = {
     pathToFile?: never;
 };
 
+/**
+ * Как кодируются ИМЕНА полей формы для МАССИВА файлов (для одного файла не
+ * важно — всегда одно поле без скобок). Сам wire-формат multipart (RFC 7578)
+ * везде одинаков; различается только именование при массиве:
+ *  - 'repeat'        — files, files, …      (busboy: Express/Nest/Fastify, Go, Rust) — ДЕФОЛТ
+ *  - 'bracket-index' — files[0], files[1]   (oRPC OpenAPI-хендлер, PHP, Rails)
+ *  - 'bracket-empty' — files[], files[]     (PHP/Rails вариант)
+ *  - функция         — кастомная кодировка (escape hatch)
+ */
+type FileEncoding = 'repeat' | 'bracket-index' | 'bracket-empty' | ((args: {
+    form: FormData;
+    field: string;
+    blobs: Blob[];
+}) => void);
+/**
+ * Способы передать файл в типизированный метод клиента. В 90% случаев это
+ * строка-путь или URL (в тестах); во фронтенде — готовый File/Blob.
+ */
+type FileInput = string | URL | {
+    path: string;
+    name?: string;
+    type?: string;
+} | {
+    content: Uint8Array | ArrayBuffer;
+    name: string;
+    type?: string;
+} | Blob | File;
+/** Плоское файловое поле тела: имя свойства + это массив файлов или один. */
+type FileFieldMeta = {
+    name: string;
+    array: boolean;
+};
+/** mime по расширению имени/пути; дефолт — application/octet-stream. */
+declare function mimeFromName(name: string): string;
+/**
+ * Преобразует один {@link FileInput} в Blob (File). Путь читается с диска
+ * через `fs` (Node); готовый File/Blob возвращается как есть (браузер).
+ */
+declare function toBlob(input: FileInput): Promise<Blob>;
+/**
+ * Собирает FormData из тела-объекта: файловые поля кодируются по конвенции
+ * (`encoding`), остальные (скалярные) поля добавляются строками (объекты —
+ * через JSON.stringify). Вызывается уже ПОСЛЕ before-хуков, когда тело —
+ * обычный объект.
+ */
+declare function toMultipartFormData(args: {
+    body: Record<string, unknown>;
+    fileFields: FileFieldMeta[];
+    encoding: FileEncoding;
+}): Promise<FormData>;
+
 /**
  * Режим генерируемого клиента (решается на этапе генерации, влияет на
  * форму сгенерированного файла):
@@ -306,6 +357,25 @@ type EbelyConfig = {
      * @default undefined
      */
     hooks?: HooksRegistrar;
+    /**
+     * Настройки отправки файлов (multipart/form-data). `encoding` задаёт, как
+     * кодируются ИМЕНА полей формы для МАССИВА файлов (для одного файла не
+     * важно — всегда одно поле без скобок):
+     *  - `'repeat'`        — files, files, …    (busboy: Express/Nest/Fastify, Go, Rust) — ДЕФОЛТ
+     *  - `'bracket-index'` — files[0], files[1] (oRPC OpenAPI-хендлер, PHP, Rails)
+     *  - `'bracket-empty'` — files[], files[]   (PHP/Rails вариант)
+     *  - функция           — кастомная кодировка (escape hatch)
+     *
+     * Дефолт `'repeat'` — мейнстрим (веб-стандарт). Проектам на oRPC нужно
+     * явно поставить `files: { encoding: 'bracket-index' }`.
+     *
+     * Рантайм-настройка (как `maxRetries`): читается в момент запроса, для
+     * смены перегенерация клиента НЕ нужна.
+     * @default 'repeat'
+     */
+    files?: {
+        encoding?: FileEncoding;
+    };
     /**
      * Из какого модуля СГЕНЕРИРОВАННЫЙ файл импортирует `BaseStore`.
      * По умолчанию `'ebely'` — имя npm-пакета библиотеки. Менять нужно
@@ -334,4 +404,4 @@ declare function generateClient(args: EbelyConfig): Promise<{
     operations: number;
 }>;
 
-export { AfterHook, AfterHookArgs, ApiResponse, BaseStore, BeforeHook, BeforeHookArgs, ClientMode, DeepPartial, EbelyAssertionError, EbelyConfig, HookRegistry, HookRequest, HookResponse, HooksRegistrar, RetryHook, SwaggerSource, generateClient };
+export { AfterHook, AfterHookArgs, ApiResponse, BaseStore, BeforeHook, BeforeHookArgs, ClientMode, DeepPartial, EbelyAssertionError, EbelyConfig, FileEncoding, FileFieldMeta, FileInput, HookRegistry, HookRequest, HookResponse, HooksRegistrar, RetryHook, SwaggerSource, generateClient, mimeFromName, toBlob, toMultipartFormData };

package/dist/index.js

@@ -1,7 +1,9 @@
 "use strict";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -15,6 +17,14 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // index.ts
@@ -24,7 +34,10 @@ __export(evely_exports, {
   BaseStore: () => BaseStore,
   EbelyAssertionError: () => EbelyAssertionError,
   HookRegistry: () => HookRegistry,
-  generateClient: () => generateClient
+  generateClient: () => generateClient,
+  mimeFromName: () => mimeFromName,
+  toBlob: () => toBlob,
+  toMultipartFormData: () => toMultipartFormData
 });
 module.exports = __toCommonJS(evely_exports);
 
@@ -244,6 +257,9 @@ var import_promises2 = require("fs/promises");
 var import_node_path2 = require("path");
 
 // src/generator/schema.ts
+function isFileSchema(schema) {
+  return Boolean(schema) && schema.type === "string" && typeof schema.contentMediaType === "string";
+}
 function schemaToType(args) {
   const { schema, spec, indent = 0 } = args;
   if (!schema)
@@ -252,6 +268,8 @@ function schemaToType(args) {
     const resolved = resolveRef({ ref: schema.$ref, spec });
     return schemaToType({ schema: resolved, spec, indent });
   }
+  if (isFileSchema(schema))
+    return "FileInput";
   for (const key of ["allOf", "oneOf", "anyOf"]) {
     if (Array.isArray(schema[key])) {
       const joiner = key === "allOf" ? " & " : " | ";
@@ -341,7 +359,10 @@ function collectOperations(args) {
       const parameters = op.parameters ?? [];
       const pathParams = parameters.filter((p) => p.in === "path").map((p) => p.name);
       const queryParams = parameters.filter((p) => p.in === "query").map((p) => p.name);
-      const bodySchema = op.requestBody?.content?.["application/json"]?.schema;
+      const content = op.requestBody?.content ?? {};
+      const bodySchema = content["multipart/form-data"]?.schema ?? content["application/json"]?.schema;
+      const fileFields = collectFileFields({ schema: bodySchema, spec });
+      const isMultipart = "multipart/form-data" in content || fileFields.length > 0;
       const responseSchema = pickResponseSchema({ responses: op.responses, spec });
       const responseType = schemaToType({ schema: responseSchema, spec, indent: 3 });
       const declared = collectResponseSchemas({ responses: op.responses, spec });
@@ -358,6 +379,8 @@ function collectOperations(args) {
         queryParams,
         bodyType: bodySchema ? schemaToType({ schema: bodySchema, spec, indent: 4 }) : null,
         bodyRequired: Boolean(op.requestBody?.required),
+        isMultipart,
+        fileFields,
         responseType,
         responses,
         summary: op.summary
@@ -367,6 +390,22 @@ function collectOperations(args) {
   dedupeNames({ operations });
   return operations;
 }
+function collectFileFields(args) {
+  const { schema, spec } = args;
+  const deref = (s) => s && typeof s.$ref === "string" ? resolveRef({ ref: s.$ref, spec }) : s;
+  const root = deref(schema);
+  const props = root?.properties ?? {};
+  const out = [];
+  for (const [name, raw] of Object.entries(props)) {
+    const prop = deref(raw);
+    if (isFileSchema(prop)) {
+      out.push({ name, array: false });
+    } else if (prop?.type === "array" && isFileSchema(deref(prop.items))) {
+      out.push({ name, array: true });
+    }
+  }
+  return out;
+}
 function prefixMethod(args) {
   const { method, name } = args;
   return method + name.charAt(0).toUpperCase() + name.slice(1);
@@ -458,11 +497,23 @@ function renderMethod(args) {
 }
 function renderImports(args) {
   const { mode, userStoreImport, configImport } = args;
-  const values = mode === "frontend" ? "BaseStore, HookRegistry" : "BaseStore, ApiResponse, HookRegistry";
-  return `import { ${values} } from ${JSON.stringify(userStoreImport)}
+  const core = mode === "frontend" ? "BaseStore, HookRegistry" : "BaseStore, ApiResponse, HookRegistry";
+  return `import { ${core}, toMultipartFormData } from ${JSON.stringify(userStoreImport)}
 import type { BeforeHook, AfterHook, RetryHook } from ${JSON.stringify(userStoreImport)}
+import type { FileInput, FileEncoding, FileFieldMeta } from ${JSON.stringify(userStoreImport)}
 import { ebely } from ${JSON.stringify(configImport)}`;
 }
+function renderFileOps(operations) {
+  const entries = operations.filter((op) => op.isMultipart && op.fileFields.length > 0).map((op) => {
+    const fields = op.fileFields.map((f) => `{ name: ${JSON.stringify(f.name)}, array: ${f.array} }`).join(", ");
+    return `  ${JSON.stringify(hookKey(op))}: [${fields}],`;
+  });
+  if (entries.length === 0)
+    return "const FILE_OPS: Record<string, FileFieldMeta[]> = {}";
+  return `const FILE_OPS: Record<string, FileFieldMeta[]> = {
+${entries.join("\n")}
+}`;
+}
 function renderRequestTail(mode) {
   if (mode === "frontend") {
     return {
@@ -578,6 +629,8 @@ function renderClient(args) {
 
 ${renderImports({ mode, userStoreImport, configImport })}
 
+${renderFileOps(operations)}
+
 type RequestInput = {
   path?: Record<string, string>
   query?: Record<string, string | number | boolean | undefined>
@@ -713,13 +766,31 @@ ${renderHookTreeBuilder(groups)}
         }
 
         const hasBody = hookReq.body !== undefined
+        // \u0424\u0430\u0439\u043B\u043E\u0432\u044B\u0435 (multipart) \u043E\u043F\u0435\u0440\u0430\u0446\u0438\u0438: FormData \u0441\u043E\u0431\u0438\u0440\u0430\u0435\u0442\u0441\u044F \u041F\u041E\u0421\u041B\u0415 before-\u0445\u0443\u043A\u043E\u0432
+        // (\u0442\u0435\u043B\u043E \u043A \u044D\u0442\u043E\u043C\u0443 \u043C\u043E\u043C\u0435\u043D\u0442\u0443 \u2014 \u043E\u0431\u044B\u0447\u043D\u044B\u0439 \u043E\u0431\u044A\u0435\u043A\u0442, \u0445\u0443\u043A\u0438 \u0432\u0438\u0434\u044F\u0442/\u043F\u0440\u0430\u0432\u044F\u0442 \u0435\u0433\u043E \u043A\u0430\u043A
+        // JSON). \u041A\u043E\u0434\u0438\u0440\u043E\u0432\u043A\u0430 \u0438\u043C\u0451\u043D \u043F\u043E\u043B\u0435\u0439 \u0434\u043B\u044F \u043C\u0430\u0441\u0441\u0438\u0432\u0430 \u0444\u0430\u0439\u043B\u043E\u0432 \u2014 \u0438\u0437 ebely.files
+        // (\u0434\u0435\u0444\u043E\u043B\u0442 'repeat': \u0432\u0435\u0431-\u0441\u0442\u0430\u043D\u0434\u0430\u0440\u0442 busboy/Go/Rust; oRPC \u0441\u0442\u0430\u0432\u0438\u0442
+        // 'bracket-index'). \u041D\u0430 retry FormData \u043F\u0435\u0440\u0435\u0441\u043E\u0431\u0438\u0440\u0430\u0435\u0442\u0441\u044F \u0437\u0430\u043D\u043E\u0432\u043E.
+        const fileFields = FILE_OPS[opKey]
+        const form =
+          fileFields && fileFields.length > 0 && hasBody
+            ? await toMultipartFormData({
+                body: hookReq.body as Record<string, unknown>,
+                fileFields,
+                encoding:
+                  (ebely as { files?: { encoding?: FileEncoding } }).files?.encoding ?? 'repeat',
+              })
+            : undefined
+        const isMultipart = form !== undefined
+
         const response = await fetch(url, {
           method,
           headers: {
-            ...(hasBody ? { 'content-type': 'application/json' } : {}),
+            // multipart: content-type \u041D\u0415 \u0441\u0442\u0430\u0432\u0438\u043C \u2014 fetch \u0441\u0430\u043C \u0432\u044B\u0441\u0442\u0430\u0432\u0438\u0442 boundary.
+            ...(isMultipart ? {} : hasBody ? { 'content-type': 'application/json' } : {}),
             ...hookReq.headers,
           },
-          body: hasBody ? JSON.stringify(hookReq.body) : undefined,
+          body: isMultipart ? form : hasBody ? JSON.stringify(hookReq.body) : undefined,
         })
 
         const text = await response.text()
@@ -825,11 +896,125 @@ Endpoints: ${operations.length}
 `);
   return { outPath, operations: operations.length };
 }
+
+// src/files.ts
+var MIME_BY_EXT = {
+  jpg: "image/jpeg",
+  jpeg: "image/jpeg",
+  png: "image/png",
+  gif: "image/gif",
+  webp: "image/webp",
+  avif: "image/avif",
+  bmp: "image/bmp",
+  svg: "image/svg+xml",
+  pdf: "application/pdf",
+  txt: "text/plain",
+  csv: "text/csv",
+  json: "application/json",
+  html: "text/html",
+  xml: "application/xml",
+  mp4: "video/mp4",
+  webm: "video/webm",
+  mp3: "audio/mpeg",
+  wav: "audio/wav",
+  zip: "application/zip"
+};
+function basenameOf(p) {
+  const parts = p.split(/[\\/]/);
+  return parts[parts.length - 1] || p;
+}
+function mimeFromName(name) {
+  const base = basenameOf(name);
+  const dot = base.lastIndexOf(".");
+  const ext = dot <= 0 ? "" : base.slice(dot + 1).toLowerCase();
+  return MIME_BY_EXT[ext] ?? "application/octet-stream";
+}
+async function readPathToBlob(args) {
+  const { readFile: readFile2 } = await import("fs/promises");
+  let filePath;
+  if (args.url) {
+    const { fileURLToPath } = await import("url");
+    filePath = fileURLToPath(args.url);
+  } else {
+    const { resolve: resolve3 } = await import("path");
+    filePath = resolve3(process.cwd(), args.path ?? "");
+  }
+  const bytes = await readFile2(filePath);
+  const name = args.name ?? basenameOf(filePath);
+  const type = args.type ?? mimeFromName(filePath);
+  return new File([bytes], name, { type });
+}
+async function toBlob(input) {
+  if (input instanceof Blob)
+    return input;
+  if (input instanceof URL)
+    return readPathToBlob({ url: input });
+  if (typeof input === "object" && "content" in input) {
+    const { content, name, type } = input;
+    return new File([content], name, { type: type ?? mimeFromName(name) });
+  }
+  if (typeof input === "object" && "path" in input) {
+    return readPathToBlob({ path: input.path, name: input.name, type: input.type });
+  }
+  if (input.startsWith("file://"))
+    return readPathToBlob({ url: new URL(input) });
+  return readPathToBlob({ path: input });
+}
+function appendArray(args) {
+  const { form, field, blobs, encoding } = args;
+  if (typeof encoding === "function") {
+    encoding({ form, field, blobs });
+    return;
+  }
+  switch (encoding) {
+    case "bracket-index":
+      blobs.forEach((b, i) => form.append(`${field}[${i}]`, b));
+      return;
+    case "bracket-empty":
+      for (const b of blobs)
+        form.append(`${field}[]`, b);
+      return;
+    case "repeat":
+    default:
+      for (const b of blobs)
+        form.append(field, b);
+      return;
+  }
+}
+async function toMultipartFormData(args) {
+  const { body, fileFields, encoding } = args;
+  const form = new FormData();
+  const fileFieldNames = new Set(fileFields.map((f) => f.name));
+  for (const field of fileFields) {
+    const value = body[field.name];
+    if (value === void 0 || value === null)
+      continue;
+    if (field.array) {
+      const inputs = Array.isArray(value) ? value : [value];
+      const blobs = await Promise.all(inputs.map((i) => toBlob(i)));
+      appendArray({ form, field: field.name, blobs, encoding });
+    } else {
+      const blob = await toBlob(value);
+      form.append(field.name, blob);
+    }
+  }
+  for (const [key, value] of Object.entries(body)) {
+    if (fileFieldNames.has(key))
+      continue;
+    if (value === void 0)
+      continue;
+    form.append(key, typeof value === "object" ? JSON.stringify(value) : String(value));
+  }
+  return form;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ApiResponse,
   BaseStore,
   EbelyAssertionError,
   HookRegistry,
-  generateClient
+  generateClient,
+  mimeFromName,
+  toBlob,
+  toMultipartFormData
 });

package/dist/index.mjs

@@ -214,6 +214,9 @@ import { writeFile } from "fs/promises";
 import { resolve as resolve2 } from "path";
 
 // src/generator/schema.ts
+function isFileSchema(schema) {
+  return Boolean(schema) && schema.type === "string" && typeof schema.contentMediaType === "string";
+}
 function schemaToType(args) {
   const { schema, spec, indent = 0 } = args;
   if (!schema)
@@ -222,6 +225,8 @@ function schemaToType(args) {
     const resolved = resolveRef({ ref: schema.$ref, spec });
     return schemaToType({ schema: resolved, spec, indent });
   }
+  if (isFileSchema(schema))
+    return "FileInput";
   for (const key of ["allOf", "oneOf", "anyOf"]) {
     if (Array.isArray(schema[key])) {
       const joiner = key === "allOf" ? " & " : " | ";
@@ -311,7 +316,10 @@ function collectOperations(args) {
       const parameters = op.parameters ?? [];
       const pathParams = parameters.filter((p) => p.in === "path").map((p) => p.name);
       const queryParams = parameters.filter((p) => p.in === "query").map((p) => p.name);
-      const bodySchema = op.requestBody?.content?.["application/json"]?.schema;
+      const content = op.requestBody?.content ?? {};
+      const bodySchema = content["multipart/form-data"]?.schema ?? content["application/json"]?.schema;
+      const fileFields = collectFileFields({ schema: bodySchema, spec });
+      const isMultipart = "multipart/form-data" in content || fileFields.length > 0;
       const responseSchema = pickResponseSchema({ responses: op.responses, spec });
       const responseType = schemaToType({ schema: responseSchema, spec, indent: 3 });
       const declared = collectResponseSchemas({ responses: op.responses, spec });
@@ -328,6 +336,8 @@ function collectOperations(args) {
         queryParams,
         bodyType: bodySchema ? schemaToType({ schema: bodySchema, spec, indent: 4 }) : null,
         bodyRequired: Boolean(op.requestBody?.required),
+        isMultipart,
+        fileFields,
         responseType,
         responses,
         summary: op.summary
@@ -337,6 +347,22 @@ function collectOperations(args) {
   dedupeNames({ operations });
   return operations;
 }
+function collectFileFields(args) {
+  const { schema, spec } = args;
+  const deref = (s) => s && typeof s.$ref === "string" ? resolveRef({ ref: s.$ref, spec }) : s;
+  const root = deref(schema);
+  const props = root?.properties ?? {};
+  const out = [];
+  for (const [name, raw] of Object.entries(props)) {
+    const prop = deref(raw);
+    if (isFileSchema(prop)) {
+      out.push({ name, array: false });
+    } else if (prop?.type === "array" && isFileSchema(deref(prop.items))) {
+      out.push({ name, array: true });
+    }
+  }
+  return out;
+}
 function prefixMethod(args) {
   const { method, name } = args;
   return method + name.charAt(0).toUpperCase() + name.slice(1);
@@ -428,11 +454,23 @@ function renderMethod(args) {
 }
 function renderImports(args) {
   const { mode, userStoreImport, configImport } = args;
-  const values = mode === "frontend" ? "BaseStore, HookRegistry" : "BaseStore, ApiResponse, HookRegistry";
-  return `import { ${values} } from ${JSON.stringify(userStoreImport)}
+  const core = mode === "frontend" ? "BaseStore, HookRegistry" : "BaseStore, ApiResponse, HookRegistry";
+  return `import { ${core}, toMultipartFormData } from ${JSON.stringify(userStoreImport)}
 import type { BeforeHook, AfterHook, RetryHook } from ${JSON.stringify(userStoreImport)}
+import type { FileInput, FileEncoding, FileFieldMeta } from ${JSON.stringify(userStoreImport)}
 import { ebely } from ${JSON.stringify(configImport)}`;
 }
+function renderFileOps(operations) {
+  const entries = operations.filter((op) => op.isMultipart && op.fileFields.length > 0).map((op) => {
+    const fields = op.fileFields.map((f) => `{ name: ${JSON.stringify(f.name)}, array: ${f.array} }`).join(", ");
+    return `  ${JSON.stringify(hookKey(op))}: [${fields}],`;
+  });
+  if (entries.length === 0)
+    return "const FILE_OPS: Record<string, FileFieldMeta[]> = {}";
+  return `const FILE_OPS: Record<string, FileFieldMeta[]> = {
+${entries.join("\n")}
+}`;
+}
 function renderRequestTail(mode) {
   if (mode === "frontend") {
     return {
@@ -548,6 +586,8 @@ function renderClient(args) {
 
 ${renderImports({ mode, userStoreImport, configImport })}
 
+${renderFileOps(operations)}
+
 type RequestInput = {
   path?: Record<string, string>
   query?: Record<string, string | number | boolean | undefined>
@@ -683,13 +723,31 @@ ${renderHookTreeBuilder(groups)}
         }
 
         const hasBody = hookReq.body !== undefined
+        // \u0424\u0430\u0439\u043B\u043E\u0432\u044B\u0435 (multipart) \u043E\u043F\u0435\u0440\u0430\u0446\u0438\u0438: FormData \u0441\u043E\u0431\u0438\u0440\u0430\u0435\u0442\u0441\u044F \u041F\u041E\u0421\u041B\u0415 before-\u0445\u0443\u043A\u043E\u0432
+        // (\u0442\u0435\u043B\u043E \u043A \u044D\u0442\u043E\u043C\u0443 \u043C\u043E\u043C\u0435\u043D\u0442\u0443 \u2014 \u043E\u0431\u044B\u0447\u043D\u044B\u0439 \u043E\u0431\u044A\u0435\u043A\u0442, \u0445\u0443\u043A\u0438 \u0432\u0438\u0434\u044F\u0442/\u043F\u0440\u0430\u0432\u044F\u0442 \u0435\u0433\u043E \u043A\u0430\u043A
+        // JSON). \u041A\u043E\u0434\u0438\u0440\u043E\u0432\u043A\u0430 \u0438\u043C\u0451\u043D \u043F\u043E\u043B\u0435\u0439 \u0434\u043B\u044F \u043C\u0430\u0441\u0441\u0438\u0432\u0430 \u0444\u0430\u0439\u043B\u043E\u0432 \u2014 \u0438\u0437 ebely.files
+        // (\u0434\u0435\u0444\u043E\u043B\u0442 'repeat': \u0432\u0435\u0431-\u0441\u0442\u0430\u043D\u0434\u0430\u0440\u0442 busboy/Go/Rust; oRPC \u0441\u0442\u0430\u0432\u0438\u0442
+        // 'bracket-index'). \u041D\u0430 retry FormData \u043F\u0435\u0440\u0435\u0441\u043E\u0431\u0438\u0440\u0430\u0435\u0442\u0441\u044F \u0437\u0430\u043D\u043E\u0432\u043E.
+        const fileFields = FILE_OPS[opKey]
+        const form =
+          fileFields && fileFields.length > 0 && hasBody
+            ? await toMultipartFormData({
+                body: hookReq.body as Record<string, unknown>,
+                fileFields,
+                encoding:
+                  (ebely as { files?: { encoding?: FileEncoding } }).files?.encoding ?? 'repeat',
+              })
+            : undefined
+        const isMultipart = form !== undefined
+
         const response = await fetch(url, {
           method,
           headers: {
-            ...(hasBody ? { 'content-type': 'application/json' } : {}),
+            // multipart: content-type \u041D\u0415 \u0441\u0442\u0430\u0432\u0438\u043C \u2014 fetch \u0441\u0430\u043C \u0432\u044B\u0441\u0442\u0430\u0432\u0438\u0442 boundary.
+            ...(isMultipart ? {} : hasBody ? { 'content-type': 'application/json' } : {}),
             ...hookReq.headers,
           },
-          body: hasBody ? JSON.stringify(hookReq.body) : undefined,
+          body: isMultipart ? form : hasBody ? JSON.stringify(hookReq.body) : undefined,
         })
 
         const text = await response.text()
@@ -795,10 +853,124 @@ Endpoints: ${operations.length}
 `);
   return { outPath, operations: operations.length };
 }
+
+// src/files.ts
+var MIME_BY_EXT = {
+  jpg: "image/jpeg",
+  jpeg: "image/jpeg",
+  png: "image/png",
+  gif: "image/gif",
+  webp: "image/webp",
+  avif: "image/avif",
+  bmp: "image/bmp",
+  svg: "image/svg+xml",
+  pdf: "application/pdf",
+  txt: "text/plain",
+  csv: "text/csv",
+  json: "application/json",
+  html: "text/html",
+  xml: "application/xml",
+  mp4: "video/mp4",
+  webm: "video/webm",
+  mp3: "audio/mpeg",
+  wav: "audio/wav",
+  zip: "application/zip"
+};
+function basenameOf(p) {
+  const parts = p.split(/[\\/]/);
+  return parts[parts.length - 1] || p;
+}
+function mimeFromName(name) {
+  const base = basenameOf(name);
+  const dot = base.lastIndexOf(".");
+  const ext = dot <= 0 ? "" : base.slice(dot + 1).toLowerCase();
+  return MIME_BY_EXT[ext] ?? "application/octet-stream";
+}
+async function readPathToBlob(args) {
+  const { readFile: readFile2 } = await import("fs/promises");
+  let filePath;
+  if (args.url) {
+    const { fileURLToPath } = await import("url");
+    filePath = fileURLToPath(args.url);
+  } else {
+    const { resolve: resolve3 } = await import("path");
+    filePath = resolve3(process.cwd(), args.path ?? "");
+  }
+  const bytes = await readFile2(filePath);
+  const name = args.name ?? basenameOf(filePath);
+  const type = args.type ?? mimeFromName(filePath);
+  return new File([bytes], name, { type });
+}
+async function toBlob(input) {
+  if (input instanceof Blob)
+    return input;
+  if (input instanceof URL)
+    return readPathToBlob({ url: input });
+  if (typeof input === "object" && "content" in input) {
+    const { content, name, type } = input;
+    return new File([content], name, { type: type ?? mimeFromName(name) });
+  }
+  if (typeof input === "object" && "path" in input) {
+    return readPathToBlob({ path: input.path, name: input.name, type: input.type });
+  }
+  if (input.startsWith("file://"))
+    return readPathToBlob({ url: new URL(input) });
+  return readPathToBlob({ path: input });
+}
+function appendArray(args) {
+  const { form, field, blobs, encoding } = args;
+  if (typeof encoding === "function") {
+    encoding({ form, field, blobs });
+    return;
+  }
+  switch (encoding) {
+    case "bracket-index":
+      blobs.forEach((b, i) => form.append(`${field}[${i}]`, b));
+      return;
+    case "bracket-empty":
+      for (const b of blobs)
+        form.append(`${field}[]`, b);
+      return;
+    case "repeat":
+    default:
+      for (const b of blobs)
+        form.append(field, b);
+      return;
+  }
+}
+async function toMultipartFormData(args) {
+  const { body, fileFields, encoding } = args;
+  const form = new FormData();
+  const fileFieldNames = new Set(fileFields.map((f) => f.name));
+  for (const field of fileFields) {
+    const value = body[field.name];
+    if (value === void 0 || value === null)
+      continue;
+    if (field.array) {
+      const inputs = Array.isArray(value) ? value : [value];
+      const blobs = await Promise.all(inputs.map((i) => toBlob(i)));
+      appendArray({ form, field: field.name, blobs, encoding });
+    } else {
+      const blob = await toBlob(value);
+      form.append(field.name, blob);
+    }
+  }
+  for (const [key, value] of Object.entries(body)) {
+    if (fileFieldNames.has(key))
+      continue;
+    if (value === void 0)
+      continue;
+    form.append(key, typeof value === "object" ? JSON.stringify(value) : String(value));
+  }
+  return form;
+}
 export {
   ApiResponse,
   BaseStore,
   EbelyAssertionError,
   HookRegistry,
-  generateClient
+  generateClient,
+  mimeFromName,
+  toBlob,
+  toMultipartFormData
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ebely",
   "license": "MIT",
-  "version": "0.0.7",
+  "version": "0.1.0",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
@@ -35,6 +35,6 @@
     "build": "tsup index.ts --format cjs,esm --dts",
     "release": "pnpm run build && changeset publish",
     "lint": "tsc",
-    "test": "tsx --test src/response.test.ts src/hooks.test.ts src/generator/render.test.ts src/generator/operations.test.ts"
+    "test": "tsx --test src/response.test.ts src/hooks.test.ts src/files.test.ts src/generator/render.test.ts src/generator/operations.test.ts src/generator/schema.test.ts"
   }
 }