@reopt-ai/brandapp-sdk 3.4.0 → 3.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (44) hide show
  1. package/CHANGELOG.md +48 -0
  2. package/dist/ai/index.js +1 -1
  3. package/dist/ai-provider/index.js +1 -1
  4. package/dist/auth/index.js +1 -1
  5. package/dist/better-auth/index.js +2 -2
  6. package/dist/{client-DsdakibF.js → client-61ldOHMz.js} +3 -3
  7. package/dist/{client-D-yNxNfk.js → client-7PCoxVhZ.js} +2 -2
  8. package/dist/client-B7rZQ8Zi.d.ts +272 -0
  9. package/dist/client-BoIuyx4S.js +273 -0
  10. package/dist/{client-DPmoKuR9.js → client-BxtZt405.js} +4 -4
  11. package/dist/{client-B1q5P8rv.js → client-ByN3EQdk.js} +2 -2
  12. package/dist/{client-EbhUIhHq.js → client-CAghoGD_.js} +2 -2
  13. package/dist/{client-B9QHVhdM.js → client-C_pHsPlj.js} +11 -7
  14. package/dist/{client-D3RHHUUW.d.ts → client-aMR4CRB8.d.ts} +10 -6
  15. package/dist/{client-Beivhucf.js → client-wEVKLdly.js} +3 -3
  16. package/dist/{client-DBnK7ooQ.js → client-zF1RG2uA.js} +2 -2
  17. package/dist/cms/index.js +1 -1
  18. package/dist/{config-Cw0a3-C8.js → config-aml9oQpX.js} +2 -2
  19. package/dist/dev/index.d.ts +1 -1
  20. package/dist/dev/index.js +318 -2
  21. package/dist/eav/index.js +2 -2
  22. package/dist/feedback/index.js +1 -1
  23. package/dist/files/index.d.ts +2 -2
  24. package/dist/files/index.js +1 -1
  25. package/dist/{http-client-QKUvvirs.js → http-client-BZc2mngq.js} +2 -2
  26. package/dist/{index-DrVaKfhs.d.ts → index-1j_738qk.d.ts} +15 -1
  27. package/dist/{index-Z6OGcurJ.d.ts → index-CeOLGdyL.d.ts} +3 -3
  28. package/dist/index.d.ts +1 -1
  29. package/dist/index.js +11 -11
  30. package/dist/logout/index.js +1 -1
  31. package/dist/plans/index.d.ts +1 -1
  32. package/dist/plans/index.js +1 -1
  33. package/dist/push/index.js +1 -1
  34. package/dist/{query-BvbCiGWb.js → query-xWqtfkvR.js} +2 -2
  35. package/dist/react/hooks.d.ts +62 -3
  36. package/dist/react/hooks.js +121 -3
  37. package/dist/terms/index.js +1 -1
  38. package/dist/testing/index.d.ts +2 -2
  39. package/docs/api-reference.md +34 -2
  40. package/docs/errors.md +19 -0
  41. package/docs/files.md +165 -7
  42. package/package.json +2 -2
  43. package/dist/client-BJcy1V1a.js +0 -140
  44. package/dist/client-p49ol9pg.d.ts +0 -124
package/docs/files.md CHANGED
@@ -1,6 +1,7 @@
1
1
  # File Management API
2
2
 
3
- BrandApp SDK의 파일 관리 모듈로, 파일 목록 조회, 단건 조회, 업로드, 삭제를 지원합니다.
3
+ BrandApp SDK의 파일 관리 모듈로, 파일 목록 조회, 단건 조회, 업로드, 이름 변경·폴더
4
+ 이동, 텍스트 내용 읽기, 삭제와 폴더 CRUD(3.5+), 저장공간 사용량 조회를 지원합니다.
4
5
 
5
6
  ## Entry Point
6
7
 
@@ -23,7 +24,8 @@ import {
23
24
  const { data: files, meta } = await sdk.files.list({
24
25
  page: 1,
25
26
  limit: 20,
26
- contentType: "image/*", // MIME 타입 필터
27
+ contentType: "image/*", // MIME 타입 필터 — 정확 일치 또는 "type/*" 와일드카드
28
+ folderId: folder.id, // 폴더 필터 — 미지정=전체, null=루트만, id=해당 폴더 직속
27
29
  sortBy: "createdAt", // "createdAt" | "name" | "size"
28
30
  sortOrder: "desc", // "asc" | "desc"
29
31
  });
@@ -32,6 +34,10 @@ console.log(`Total files: ${meta.total}`);
32
34
  files.forEach((f) => console.log(f.name, f.url));
33
35
  ```
34
36
 
37
+ > `contentType` 와일드카드는 서버 3.5+에서 prefix 매치로 동작한다
38
+ > (`"image/*"` → `image/`로 시작하는 모든 타입). 구버전 서버는 정확 일치만
39
+ > 지원했다.
40
+
35
41
  ### `sdk.files.get(fileId)`
36
42
 
37
43
  단일 파일 정보를 조회합니다.
@@ -73,6 +79,45 @@ const uploaded = await sdk.files.upload(buf, {
73
79
  | ------------- | -------- | ----------------------------------- |
74
80
  | `name` | `string` | 파일명 (미지정 시 원본 파일명 사용) |
75
81
  | `contentType` | `string` | MIME 타입 (미지정 시 자동 감지) |
82
+ | `folderId` | `string` | 업로드할 폴더 (미지정 시 루트) |
83
+
84
+ ### `sdk.files.update(fileId, input)` (3.5+)
85
+
86
+ 파일 이름을 바꾸거나 폴더로 이동합니다. `name`은 표시명만 바꾸며 저장 경로
87
+ (`pathname`)와 URL은 불변입니다.
88
+
89
+ ```typescript
90
+ await sdk.files.update(fileId, { name: "renamed.png" });
91
+ await sdk.files.update(fileId, { folderId: folder.id }); // 폴더로 이동
92
+ await sdk.files.update(fileId, { folderId: null }); // 루트로 이동
93
+ ```
94
+
95
+ ### `sdk.files.readContent(fileId)` (3.5+)
96
+
97
+ 텍스트 파일의 내용을 문자열로 읽습니다 (미리보기용). 텍스트 계열
98
+ (`text/*`, `application/json`, `application/yaml` 등)만 지원하며, 그 외 타입은
99
+ 415(`UNSUPPORTED_CONTENT_TYPE`), 1MB 초과 파일은 413(`CONTENT_TOO_LARGE`)으로
100
+ 거부됩니다.
101
+
102
+ ```typescript
103
+ const text = await sdk.files.readContent(fileId);
104
+ ```
105
+
106
+ ### `sdk.files.usage()` (3.5+)
107
+
108
+ 저장공간 사용량을 조회합니다 — 파일 매니저의 사용량 미터·"한도 임박" 경고용.
109
+
110
+ ```typescript
111
+ const { usedBytes, limitBytes, fileCount } = await sdk.files.usage();
112
+ if (limitBytes != null && usedBytes / limitBytes > 0.9) {
113
+ console.warn("저장공간이 거의 찼습니다");
114
+ }
115
+ ```
116
+
117
+ - `usedBytes` / `limitBytes`는 **워크스페이스 단위** — 초과 업로드를 거부하는
118
+ 402 `STORAGE_LIMIT` 판정과 동일한 소스를 읽으므로 미터와 실제 거부가 어긋나지
119
+ 않습니다. `limitBytes: null`은 무제한 플랜.
120
+ - `fileCount`는 이 brandapp 스코프의 파일 수.
76
121
 
77
122
  ### `sdk.files.delete(fileId)`
78
123
 
@@ -82,6 +127,56 @@ const uploaded = await sdk.files.upload(buf, {
82
127
  await sdk.files.delete("file-uuid");
83
128
  ```
84
129
 
130
+ 파일이 브랜드프론트 페이지·이메일 등에서 사용 중이면 409 `FILE_IN_USE`로
131
+ 거부되며, 메시지에 사용처가 담깁니다 (UI에 그대로 표면화 가능).
132
+
133
+ ## Folders (3.5+)
134
+
135
+ 폴더 계층으로 파일을 정리할 수 있습니다. 폴더는 brandapp 스코프에 격리됩니다.
136
+
137
+ ### `sdk.files.listFolders(query?)`
138
+
139
+ 직속 자식 폴더 목록을 조회합니다. `parentId` 미지정(또는 `null`)이면 루트.
140
+
141
+ ```typescript
142
+ const rootFolders = await sdk.files.listFolders();
143
+ const children = await sdk.files.listFolders({ parentId: folder.id });
144
+ // FolderInfo: { id, name, parentId, childCount, fileCount, createdAt, updatedAt }
145
+ ```
146
+
147
+ ### `sdk.files.createFolder(input)`
148
+
149
+ ```typescript
150
+ const folder = await sdk.files.createFolder({ name: "invoices" });
151
+ const child = await sdk.files.createFolder({
152
+ name: "2026",
153
+ parentId: folder.id,
154
+ });
155
+ ```
156
+
157
+ 같은 위치에 동명 폴더가 있으면 409 `CONFLICT`.
158
+
159
+ ### `sdk.files.updateFolder(folderId, input)`
160
+
161
+ 이름 변경 + 이동을 겸합니다. 폴더를 자기 자신 또는 자손 밑으로 옮기는 요청은
162
+ 400으로 거부됩니다 (cycle 방지).
163
+
164
+ ```typescript
165
+ await sdk.files.updateFolder(folderId, { name: "archive" });
166
+ await sdk.files.updateFolder(folderId, { parentId: otherFolder.id });
167
+ await sdk.files.updateFolder(folderId, { parentId: null }); // 루트로
168
+ ```
169
+
170
+ ### `sdk.files.deleteFolder(folderId)`
171
+
172
+ 폴더를 삭제합니다. **비어있어야 합니다** — 파일이나 하위 폴더가 남아 있으면
173
+ 409 `FOLDER_NOT_EMPTY`(메시지에 남은 개수 포함)로 거부되므로, 내용물을 먼저
174
+ 이동/삭제하세요.
175
+
176
+ ```typescript
177
+ await sdk.files.deleteFolder(folderId);
178
+ ```
179
+
85
180
  ## Image Generation + File Management Workflow
86
181
 
87
182
  AI 이미지 생성 결과를 파일로 관리하는 워크플로우:
@@ -123,22 +218,44 @@ import {
123
218
  useFiles,
124
219
  useFile,
125
220
  useUploadFile,
221
+ useUpdateFile,
126
222
  useDeleteFile,
223
+ useFolders,
224
+ useCreateFolder,
225
+ useUpdateFolder,
226
+ useDeleteFolder,
227
+ useFileUsage,
127
228
  } from "@reopt-ai/brandapp-sdk/react/hooks";
128
229
 
129
- // 파일 목록 조회
130
- const { data } = useFiles(sdk, { contentType: "image/*" });
230
+ // 파일 목록 조회 (폴더별)
231
+ const { data } = useFiles(sdk, { folderId: folder.id });
131
232
 
132
233
  // 단일 파일 조회
133
234
  const { data: file } = useFile(sdk, fileId);
134
235
 
135
- // 파일 업로드
236
+ // 파일 업로드 (성공 시 files/folders/usage 캐시 자동 무효화)
136
237
  const upload = useUploadFile(sdk);
137
- await upload.mutateAsync({ file: blob, options: { name: "banner.png" } });
238
+ await upload.mutateAsync({
239
+ file: blob,
240
+ options: { name: "banner.png", folderId: folder.id },
241
+ });
242
+
243
+ // 파일 rename/move
244
+ const update = useUpdateFile(sdk);
245
+ await update.mutateAsync({ fileId, input: { name: "renamed.png" } });
138
246
 
139
247
  // 파일 삭제
140
248
  const deleteFile = useDeleteFile(sdk);
141
249
  await deleteFile.mutateAsync("file-uuid");
250
+
251
+ // 폴더
252
+ const { data: folders } = useFolders(sdk); // 루트
253
+ const createFolder = useCreateFolder(sdk);
254
+ const updateFolder = useUpdateFolder(sdk);
255
+ const deleteFolder = useDeleteFolder(sdk);
256
+
257
+ // 저장공간 사용량
258
+ const { data: usage } = useFileUsage(sdk);
142
259
  ```
143
260
 
144
261
  ## Error Handling
@@ -157,6 +274,9 @@ try {
157
274
  case "FILE_TOO_LARGE":
158
275
  console.log("파일 크기 제한 초과");
159
276
  break;
277
+ case "STORAGE_LIMIT":
278
+ console.log("저장공간 한도 초과 (402) — usage()로 사전 확인 가능");
279
+ break;
160
280
  case "UPLOAD_FAILED":
161
281
  console.log("업로드 실패:", e.message);
162
282
  break;
@@ -168,6 +288,20 @@ try {
168
288
  }
169
289
  ```
170
290
 
291
+ 주요 도메인 에러 코드:
292
+
293
+ | Code | Status | 발생 지점 |
294
+ | -------------------------- | ------ | ---------------------------------------------------------------- |
295
+ | `STORAGE_LIMIT` | 402 | 업로드 — 플랜 저장공간 한도 초과 (`usage()`로 사전 확인) |
296
+ | `FILE_IN_USE` | 409 | 파일 삭제 — 브랜드프론트·이메일 등에서 사용 중 (메시지에 사용처) |
297
+ | `FOLDER_NOT_EMPTY` | 409 | 폴더 삭제 — 파일/하위 폴더가 남아 있음 |
298
+ | `CONFLICT` | 409 | 폴더 생성/이동 — 같은 위치에 동명 폴더 존재 |
299
+ | `UNSUPPORTED_CONTENT_TYPE` | 415 | `readContent` — 텍스트 계열이 아닌 파일 |
300
+ | `CONTENT_TOO_LARGE` | 413 | `readContent` — 1MB 초과 |
301
+
302
+ `STORAGE_LIMIT`·`FILE_IN_USE`의 메시지는 사람이 읽을 수 있는 형태라 UI에 그대로
303
+ 표면화해도 됩니다.
304
+
171
305
  ## Types
172
306
 
173
307
  ```typescript
@@ -178,6 +312,7 @@ type FileInfo = {
178
312
  size: number;
179
313
  contentType: string | null;
180
314
  pathname: string;
315
+ folderId?: string | null; // 3.5+ — 루트면 null
181
316
  createdAt: string;
182
317
  updatedAt: string;
183
318
  };
@@ -185,7 +320,8 @@ type FileInfo = {
185
320
  type FileListQuery = {
186
321
  page?: number;
187
322
  limit?: number;
188
- contentType?: string;
323
+ contentType?: string; // "image/png" | "image/*"
324
+ folderId?: string | null; // 미지정=전체, null=루트만
189
325
  sortBy?: "createdAt" | "name" | "size";
190
326
  sortOrder?: "asc" | "desc";
191
327
  };
@@ -198,6 +334,28 @@ type FileListResponse = {
198
334
  type UploadOptions = {
199
335
  name?: string;
200
336
  contentType?: string;
337
+ folderId?: string;
338
+ };
339
+
340
+ type UpdateFileInput = {
341
+ name?: string;
342
+ folderId?: string | null;
343
+ };
344
+
345
+ type FolderInfo = {
346
+ id: string;
347
+ name: string;
348
+ parentId: string | null;
349
+ childCount: number;
350
+ fileCount: number;
351
+ createdAt: string;
352
+ updatedAt: string;
353
+ };
354
+
355
+ type FileUsageInfo = {
356
+ usedBytes: number; // 워크스페이스 전체
357
+ limitBytes: number | null; // null = 무제한
358
+ fileCount: number; // 이 brandapp 스코프
201
359
  };
202
360
  ```
203
361
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@reopt-ai/brandapp-sdk",
3
- "version": "3.4.0",
3
+ "version": "3.5.0",
4
4
  "description": "Reopt Brandapp SDK — Better Auth adapter, OAuth login, and EAV client",
5
5
  "author": "Reopt",
6
6
  "license": "MIT",
@@ -136,7 +136,7 @@
136
136
  }
137
137
  },
138
138
  "devDependencies": {
139
- "@ai-sdk/provider": "4.0.0",
139
+ "@ai-sdk/provider": "4.0.4",
140
140
  "@reopt-ai/opt-editor": "1.1.2",
141
141
  "@testing-library/react": "^16.3.2",
142
142
  "@types/node": "22.13.9",
@@ -1,140 +0,0 @@
1
- import { A as mapHttpStatusToError, n as SDK_VERSION, o as validateConfig, x as ReoptSDKError } from "./config-Cw0a3-C8.js";
2
- import { t as createManagedAbort } from "./abort--nOBFN4M.js";
3
- import { n as parseFieldErrors, t as BaseHttpClient } from "./http-client-QKUvvirs.js";
4
-
5
- //#region src/files/client.ts
6
- var ReoptFileClient = class {
7
- http;
8
- timeout;
9
- constructor(config) {
10
- validateConfig(config);
11
- const pathPrefix = `/api/v1/brandapp/${config.brandappId}/files`;
12
- this.http = new BaseHttpClient(config, pathPrefix);
13
- this.timeout = config.timeout ?? 3e4;
14
- }
15
- /**
16
- * 파일 목록 조회
17
- *
18
- * @example
19
- * ```ts
20
- * const { data: files, meta } = await sdk.files.list({
21
- * page: 1,
22
- * limit: 20,
23
- * contentType: "image/*",
24
- * sortBy: "createdAt",
25
- * sortOrder: "desc",
26
- * });
27
- * console.log(`Total: ${meta.total}`);
28
- * ```
29
- */
30
- async list(query) {
31
- const params = new URLSearchParams();
32
- if (query?.page != null) params.set("page", String(query.page));
33
- if (query?.limit != null) params.set("limit", String(query.limit));
34
- if (query?.contentType) params.set("contentType", query.contentType);
35
- if (query?.sortBy) params.set("sortBy", query.sortBy);
36
- if (query?.sortOrder) params.set("sortOrder", query.sortOrder);
37
- const qs = params.toString();
38
- const path = qs ? `?${qs}` : "";
39
- return this.http.fetch("GET", path);
40
- }
41
- /**
42
- * 단일 파일 조회
43
- *
44
- * @example
45
- * ```ts
46
- * const file = await sdk.files.get("file-uuid");
47
- * console.log(file.name, file.url);
48
- * ```
49
- */
50
- async get(fileId) {
51
- return (await this.http.fetch("GET", `/${encodeURIComponent(fileId)}`)).data;
52
- }
53
- /**
54
- * 파일 삭제
55
- *
56
- * @example
57
- * ```ts
58
- * await sdk.files.delete("file-uuid");
59
- * ```
60
- */
61
- async delete(fileId) {
62
- await this.http.fetch("DELETE", `/${encodeURIComponent(fileId)}`);
63
- }
64
- /**
65
- * 파일 업로드
66
- *
67
- * FormData(multipart)로 파일을 전송합니다.
68
- * BaseHttpClient는 JSON 전용이므로 globalThis.fetch를 직접 사용합니다.
69
- *
70
- * @example
71
- * ```ts
72
- * // Blob 업로드
73
- * const blob = new Blob(["hello"], { type: "text/plain" });
74
- * const file = await sdk.files.upload(blob, { name: "hello.txt" });
75
- *
76
- * // File 업로드 (브라우저)
77
- * const file = await sdk.files.upload(inputEl.files[0]);
78
- *
79
- * // Buffer 업로드 (Node.js)
80
- * const buf = fs.readFileSync("image.png");
81
- * const file = await sdk.files.upload(buf, {
82
- * name: "image.png",
83
- * contentType: "image/png",
84
- * });
85
- * ```
86
- */
87
- async upload(file, options) {
88
- const formData = new FormData();
89
- if (file instanceof Blob) {
90
- const fileName = options?.name ?? ("name" in file ? file.name : "upload");
91
- formData.append("file", file, fileName);
92
- } else {
93
- const arrayBuffer = file.buffer.slice(file.byteOffset, file.byteOffset + file.byteLength);
94
- const blob = new Blob([arrayBuffer], { type: options?.contentType ?? "application/octet-stream" });
95
- formData.append("file", blob, options?.name ?? "upload");
96
- }
97
- if (options?.name) formData.append("name", options.name);
98
- if (options?.contentType) formData.append("contentType", options.contentType);
99
- const url = `${this.http.requestBaseUrl}/upload`;
100
- const managed = createManagedAbort({
101
- timeoutMs: options?.timeout ?? this.timeout,
102
- external: options?.signal
103
- });
104
- try {
105
- const response = await globalThis.fetch(url, {
106
- method: "POST",
107
- headers: {
108
- Authorization: this.http.authorizationHeader,
109
- "X-SDK-Version": `brandapp-sdk/${SDK_VERSION}`
110
- },
111
- body: formData,
112
- signal: managed.signal
113
- });
114
- if (!response.ok) {
115
- const body = await response.json().catch(() => ({}));
116
- const errObj = typeof body.error === "object" ? body.error : void 0;
117
- const msg = errObj?.message ?? (typeof body.error === "string" ? body.error : void 0) ?? `Upload failed with status ${response.status}`;
118
- const fieldErrors = response.status === 422 ? parseFieldErrors(body) : [];
119
- throw mapHttpStatusToError(response.status, errObj?.code, msg, {
120
- method: "POST",
121
- url
122
- }, fieldErrors);
123
- }
124
- return (await response.json()).data;
125
- } catch (e) {
126
- if (e instanceof ReoptSDKError) throw e;
127
- if (e instanceof Error && e.name === "AbortError") throw new ReoptSDKError("Upload request timed out", 408, "TIMEOUT");
128
- throw e;
129
- } finally {
130
- managed.cleanup();
131
- }
132
- }
133
- };
134
- function createReoptFileClient(config) {
135
- return new ReoptFileClient(config);
136
- }
137
-
138
- //#endregion
139
- export { createReoptFileClient as n, ReoptFileClient as t };
140
- //# sourceMappingURL=client-BJcy1V1a.js.map
@@ -1,124 +0,0 @@
1
- import { n as ReoptSDKConfig } from "./config-CRytOPPl.js";
2
- //#region src/files/types.d.ts
3
- /** 파일 정보 */
4
- type FileInfo = {
5
- /** 파일 ID */
6
- id: string;
7
- /** 파일명 */
8
- name: string;
9
- /** 파일 URL (Vercel Blob) */
10
- url: string | null;
11
- /** 파일 크기 (bytes) */
12
- size: number;
13
- /** MIME 타입 */
14
- contentType: string | null;
15
- /** 저장 경로 */
16
- pathname: string;
17
- /** 생성일 (ISO 8601) */
18
- createdAt: string;
19
- /** 수정일 (ISO 8601) */
20
- updatedAt: string;
21
- };
22
- /** 파일 목록 조회 쿼리 */
23
- type FileListQuery = {
24
- /** 페이지 번호 (기본 1) */
25
- page?: number;
26
- /** 페이지 당 항목 수 (기본 20) */
27
- limit?: number;
28
- /** MIME 타입 필터 (e.g. "image/png", "image/*") */
29
- contentType?: string;
30
- /** 정렬 기준 */
31
- sortBy?: "createdAt" | "name" | "size";
32
- /** 정렬 순서 */
33
- sortOrder?: "asc" | "desc";
34
- };
35
- /** 파일 목록 응답 */
36
- type FileListResponse = {
37
- data: FileInfo[];
38
- meta: {
39
- page: number;
40
- limit: number;
41
- total: number;
42
- };
43
- };
44
- /** 파일 업로드 옵션 */
45
- type UploadOptions = {
46
- /** 파일명 (미지정 시 원본 파일명 또는 자동 생성) */
47
- name?: string;
48
- /** MIME 타입 (미지정 시 자동 감지) */
49
- contentType?: string;
50
- /** 외부 AbortSignal — 업로드 중도 취소용. SDK 타임아웃과 병합됨. */
51
- signal?: AbortSignal;
52
- /** 이 호출에만 적용할 타임아웃 (ms). 미지정 시 SDK 기본값. */
53
- timeout?: number;
54
- };
55
- //#endregion
56
- //#region src/files/client.d.ts
57
- declare class ReoptFileClient {
58
- private readonly http;
59
- private readonly timeout;
60
- constructor(config: ReoptSDKConfig);
61
- /**
62
- * 파일 목록 조회
63
- *
64
- * @example
65
- * ```ts
66
- * const { data: files, meta } = await sdk.files.list({
67
- * page: 1,
68
- * limit: 20,
69
- * contentType: "image/*",
70
- * sortBy: "createdAt",
71
- * sortOrder: "desc",
72
- * });
73
- * console.log(`Total: ${meta.total}`);
74
- * ```
75
- */
76
- list(query?: FileListQuery): Promise<FileListResponse>;
77
- /**
78
- * 단일 파일 조회
79
- *
80
- * @example
81
- * ```ts
82
- * const file = await sdk.files.get("file-uuid");
83
- * console.log(file.name, file.url);
84
- * ```
85
- */
86
- get(fileId: string): Promise<FileInfo>;
87
- /**
88
- * 파일 삭제
89
- *
90
- * @example
91
- * ```ts
92
- * await sdk.files.delete("file-uuid");
93
- * ```
94
- */
95
- delete(fileId: string): Promise<void>;
96
- /**
97
- * 파일 업로드
98
- *
99
- * FormData(multipart)로 파일을 전송합니다.
100
- * BaseHttpClient는 JSON 전용이므로 globalThis.fetch를 직접 사용합니다.
101
- *
102
- * @example
103
- * ```ts
104
- * // Blob 업로드
105
- * const blob = new Blob(["hello"], { type: "text/plain" });
106
- * const file = await sdk.files.upload(blob, { name: "hello.txt" });
107
- *
108
- * // File 업로드 (브라우저)
109
- * const file = await sdk.files.upload(inputEl.files[0]);
110
- *
111
- * // Buffer 업로드 (Node.js)
112
- * const buf = fs.readFileSync("image.png");
113
- * const file = await sdk.files.upload(buf, {
114
- * name: "image.png",
115
- * contentType: "image/png",
116
- * });
117
- * ```
118
- */
119
- upload(file: Blob | Uint8Array | File, options?: UploadOptions): Promise<FileInfo>;
120
- }
121
- declare function createReoptFileClient(config: ReoptSDKConfig): ReoptFileClient;
122
- //#endregion
123
- export { FileListResponse as a, FileListQuery as i, createReoptFileClient as n, UploadOptions as o, FileInfo as r, ReoptFileClient as t };
124
- //# sourceMappingURL=client-p49ol9pg.d.ts.map