@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/CHANGELOG.md CHANGED
@@ -7,6 +7,54 @@ This project adheres to [Semantic Versioning](https://semver.org/).
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [3.5.0] — 2026-08-02
11
+
12
+ 파일 매니저를 만들 수 있게 됐다 — 폴더 계층, rename/move, 텍스트 미리보기,
13
+ 저장공간 미터가 추가됐다. 전부 backward-compatible(minor).
14
+ 커넥터 기반 파일 매니저 UI(`@reopt-ai/opt-filemanager`)가 첫 소비자다.
15
+
16
+ ### Added — 폴더 (`sdk.files.*Folder*`)
17
+
18
+ - **`sdk.files.listFolders({ parentId? })`** — 직속 자식 폴더 목록 (미지정/`null` = 루트).
19
+ `FolderInfo`: `{ id, name, parentId, childCount, fileCount, createdAt, updatedAt }`.
20
+ - **`sdk.files.createFolder({ name, parentId? })`** — 같은 위치 동명 폴더는 409 `CONFLICT`.
21
+ - **`sdk.files.updateFolder(folderId, { name?, parentId? })`** — rename + move 겸용.
22
+ 자기 자신/자손으로의 이동은 400 (cycle 방지).
23
+ - **`sdk.files.deleteFolder(folderId)`** — 비어있지 않으면 409 `FOLDER_NOT_EMPTY`
24
+ (메시지에 남은 파일/폴더 수).
25
+
26
+ ### Added — 파일 rename/move·내용 읽기·사용량
27
+
28
+ - **`sdk.files.update(fileId, { name?, folderId? })`** — 이름 변경(+`pathname` 불변)과
29
+ 폴더 이동(`folderId: null` = 루트로).
30
+ - **`sdk.files.readContent(fileId)`** — 텍스트 파일 내용 읽기 (미리보기용).
31
+ 텍스트 계열만 — 그 외 415 `UNSUPPORTED_CONTENT_TYPE`, 1MB 초과 413 `CONTENT_TOO_LARGE`.
32
+ - **`sdk.files.usage()`** — `{ usedBytes, limitBytes, fileCount }`. 402 `STORAGE_LIMIT`
33
+ 판정과 동일 소스(워크스페이스 단위)라 미터와 실제 거부가 정합. `limitBytes: null` = 무제한.
34
+ - **`FileInfo.folderId`** (additive) / **`FileListQuery.folderId`**(미지정=전체,
35
+ `null`=루트만) / **`UploadOptions.folderId`**.
36
+
37
+ ### Added — React hooks
38
+
39
+ - `useFolders` / `useCreateFolder` / `useUpdateFolder` / `useDeleteFolder` /
40
+ `useUpdateFile` / `useFileUsage`. 파일 mutation은 folders/usage 캐시까지 무효화.
41
+ - `reoptQueryKeys.filesPrefix/folders/foldersPrefix/fileUsage` 추가.
42
+
43
+ ### Fixed
44
+
45
+ - **`contentType: "image/*"` 와일드카드가 실제로 동작** — 문서는 와일드카드를
46
+ 광고했지만 서버가 정확 일치만 지원해 조용히 0건을 반환했다. 서버가 prefix
47
+ 매치를 구현했고(구버전 서버는 여전히 정확 일치), dev 서버도 패리티.
48
+ - **파일 mutation 훅의 목록 캐시 무효화 누락** — `useUploadFile`/`useDeleteFile`이
49
+ trailing `undefined`가 붙은 키로 invalidate해 query 객체로 조회된 목록
50
+ (`useFiles(sdk, { … })`)이 갱신되지 않던 것을 length-3 prefix 키로 수정.
51
+
52
+ ### Dev server
53
+
54
+ - `reopt brandapp dev` 인메모리 서버에 위 엔드포인트 전부 구현 (folders CRUD,
55
+ file PATCH/content/usage, folderId·contentType 와일드카드 필터). usage는
56
+ 인메모리 파일 크기 합산(`limitBytes: null`).
57
+
10
58
  ## [3.4.0] — 2026-07-27
11
59
 
12
60
  구독 생애주기를 **서버에서** 따라갈 수 있게 됐다 — 웹훅 4종과 실 결제 해지 결과가
package/dist/ai/index.js CHANGED
@@ -1,3 +1,3 @@
1
- import { n as createReoptAiClient, t as ReoptAiClient } from "../client-DPmoKuR9.js";
1
+ import { n as createReoptAiClient, t as ReoptAiClient } from "../client-BxtZt405.js";
2
2
 
3
3
  export { ReoptAiClient, createReoptAiClient };
@@ -1,4 +1,4 @@
1
- import { A as mapHttpStatusToError, i as resolveBaseUrl, n as SDK_VERSION, o as validateConfig, r as assertBrowserSafe } from "../config-Cw0a3-C8.js";
1
+ import { A as mapHttpStatusToError, i as resolveBaseUrl, n as SDK_VERSION, o as validateConfig, r as assertBrowserSafe } from "../config-aml9oQpX.js";
2
2
  import { t as createManagedAbort } from "../abort--nOBFN4M.js";
3
3
  import { t as createAuthHeader } from "../encoding-Bwfm3iaE.js";
4
4
  import { t as createSSELineProcessor } from "../sse-parser-FMjxM7sY.js";
@@ -1,4 +1,4 @@
1
- import { n as createReoptAuthClient, t as ReoptAuthClient } from "../client-EbhUIhHq.js";
1
+ import { n as createReoptAuthClient, t as ReoptAuthClient } from "../client-CAghoGD_.js";
2
2
 
3
3
  //#region src/auth/session.ts
4
4
  /**
@@ -1,5 +1,5 @@
1
- import { C as ServerError, D as isReoptSDKError, a as resolveIdBaseUrl, b as RateLimitError, s as AuthError, t as REOPT_BASE_URLS, x as ReoptSDKError } from "../config-Cw0a3-C8.js";
2
- import { t as BaseHttpClient } from "../http-client-QKUvvirs.js";
1
+ import { C as ServerError, D as isReoptSDKError, a as resolveIdBaseUrl, b as RateLimitError, s as AuthError, t as REOPT_BASE_URLS, x as ReoptSDKError } from "../config-aml9oQpX.js";
2
+ import { t as BaseHttpClient } from "../http-client-BZc2mngq.js";
3
3
  import { n as REOPT_PROVIDER_ID, t as REOPT_DEFAULT_SCOPES } from "../types-DjDRszNj.js";
4
4
  import { createAdapterFactory } from "better-auth/adapters";
5
5
  import { genericOAuth } from "better-auth/plugins";
@@ -1,5 +1,5 @@
1
- import { t as BaseHttpClient } from "./http-client-QKUvvirs.js";
2
- import { t as buildQuery } from "./query-BvbCiGWb.js";
1
+ import { t as BaseHttpClient } from "./http-client-BZc2mngq.js";
2
+ import { t as buildQuery } from "./query-xWqtfkvR.js";
3
3
 
4
4
  //#region src/eav/cache.ts
5
5
  var SchemaCache = class {
@@ -500,4 +500,4 @@ function createReoptEavClient(config) {
500
500
 
501
501
  //#endregion
502
502
  export { createReoptEavClient as t };
503
- //# sourceMappingURL=client-DsdakibF.js.map
503
+ //# sourceMappingURL=client-61ldOHMz.js.map
@@ -1,4 +1,4 @@
1
- import { t as BaseHttpClient } from "./http-client-QKUvvirs.js";
1
+ import { t as BaseHttpClient } from "./http-client-BZc2mngq.js";
2
2
 
3
3
  //#region src/push/client.ts
4
4
  var ReoptPushClient = class {
@@ -25,4 +25,4 @@ function createReoptPushClient(config) {
25
25
 
26
26
  //#endregion
27
27
  export { createReoptPushClient as n, ReoptPushClient as t };
28
- //# sourceMappingURL=client-D-yNxNfk.js.map
28
+ //# sourceMappingURL=client-7PCoxVhZ.js.map
@@ -0,0 +1,272 @@
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
+ /** 소속 폴더 ID — 루트(폴더 밖)면 null. 서버 1.x(폴더 도입 전) 응답엔 없을 수 있다. */
18
+ folderId?: string | null;
19
+ /** 생성일 (ISO 8601) */
20
+ createdAt: string;
21
+ /** 수정일 (ISO 8601) */
22
+ updatedAt: string;
23
+ };
24
+ /** 파일 목록 조회 쿼리 */
25
+ type FileListQuery = {
26
+ /** 페이지 번호 (기본 1) */
27
+ page?: number;
28
+ /** 페이지 당 항목 수 (기본 20) */
29
+ limit?: number;
30
+ /** MIME 타입 필터 (e.g. "image/png", 와일드카드 "image/*") */
31
+ contentType?: string;
32
+ /**
33
+ * 폴더 필터 — 미지정이면 전체(폴더 무시, 하위 호환), `null`이면 루트(폴더
34
+ * 미소속)만, 폴더 ID면 해당 폴더 직속 파일만.
35
+ */
36
+ folderId?: string | null;
37
+ /** 정렬 기준 */
38
+ sortBy?: "createdAt" | "name" | "size";
39
+ /** 정렬 순서 */
40
+ sortOrder?: "asc" | "desc";
41
+ };
42
+ /** 파일 목록 응답 */
43
+ type FileListResponse = {
44
+ data: FileInfo[];
45
+ meta: {
46
+ page: number;
47
+ limit: number;
48
+ total: number;
49
+ };
50
+ };
51
+ /** 파일 업로드 옵션 */
52
+ type UploadOptions = {
53
+ /** 파일명 (미지정 시 원본 파일명 또는 자동 생성) */
54
+ name?: string;
55
+ /** MIME 타입 (미지정 시 자동 감지) */
56
+ contentType?: string;
57
+ /** 업로드할 폴더 ID (미지정 시 루트) */
58
+ folderId?: string;
59
+ /** 외부 AbortSignal — 업로드 중도 취소용. SDK 타임아웃과 병합됨. */
60
+ signal?: AbortSignal;
61
+ /** 이 호출에만 적용할 타임아웃 (ms). 미지정 시 SDK 기본값. */
62
+ timeout?: number;
63
+ };
64
+ /** 파일 수정 입력 — rename + move (최소 한 필드 필요) */
65
+ type UpdateFileInput = {
66
+ /** 새 파일명 (표시명만 변경 — 저장 경로 pathname은 불변) */
67
+ name?: string;
68
+ /** 이동할 폴더 ID — null이면 루트(폴더 밖)로 이동 */
69
+ folderId?: string | null;
70
+ };
71
+ /** 폴더 정보 */
72
+ type FolderInfo = {
73
+ /** 폴더 ID */
74
+ id: string;
75
+ /** 폴더명 */
76
+ name: string;
77
+ /** 부모 폴더 ID (루트면 null) */
78
+ parentId: string | null;
79
+ /** 직속 하위 폴더 수 */
80
+ childCount: number;
81
+ /** 직속 파일 수 */
82
+ fileCount: number;
83
+ /** 생성일 (ISO 8601) */
84
+ createdAt: string;
85
+ /** 수정일 (ISO 8601) */
86
+ updatedAt: string;
87
+ };
88
+ /** 폴더 목록 조회 쿼리 */
89
+ type FolderListQuery = {
90
+ /** 부모 폴더 ID — 미지정 또는 null이면 루트의 직속 자식 폴더 */
91
+ parentId?: string | null;
92
+ };
93
+ /** 폴더 생성 입력 */
94
+ type CreateFolderInput = {
95
+ name: string;
96
+ /** 부모 폴더 ID (미지정/null = 루트) */
97
+ parentId?: string | null;
98
+ };
99
+ /** 폴더 수정 입력 — rename + move (최소 한 필드 필요) */
100
+ type UpdateFolderInput = {
101
+ name?: string;
102
+ /** 이동할 부모 폴더 ID — null이면 루트로 이동. 자기 자신/자손으로의 이동은 400. */
103
+ parentId?: string | null;
104
+ };
105
+ /**
106
+ * 저장공간 사용량. `usedBytes`/`limitBytes`는 워크스페이스 단위(한도 판정과 동일
107
+ * 소스 — 초과 업로드 402 STORAGE_LIMIT과 정합), `fileCount`는 이 brandapp 스코프.
108
+ */
109
+ type FileUsageInfo = {
110
+ /** 워크스페이스 전체 사용량 (bytes) */
111
+ usedBytes: number;
112
+ /** 플랜 스토리지 한도 (bytes) — null이면 무제한 */
113
+ limitBytes: number | null;
114
+ /** 이 brandapp 파일 수 */
115
+ fileCount: number;
116
+ };
117
+ //#endregion
118
+ //#region src/files/client.d.ts
119
+ declare class ReoptFileClient {
120
+ private readonly http;
121
+ /** 폴더 계열은 형제 리소스(/folders) — 파일과 같은 인증/에러 계약을 공유 */
122
+ private readonly folderHttp;
123
+ private readonly timeout;
124
+ constructor(config: ReoptSDKConfig);
125
+ /**
126
+ * 파일 목록 조회
127
+ *
128
+ * @example
129
+ * ```ts
130
+ * const { data: files, meta } = await sdk.files.list({
131
+ * page: 1,
132
+ * limit: 20,
133
+ * contentType: "image/*",
134
+ * sortBy: "createdAt",
135
+ * sortOrder: "desc",
136
+ * });
137
+ * console.log(`Total: ${meta.total}`);
138
+ * ```
139
+ */
140
+ list(query?: FileListQuery): Promise<FileListResponse>;
141
+ /**
142
+ * 단일 파일 조회
143
+ *
144
+ * @example
145
+ * ```ts
146
+ * const file = await sdk.files.get("file-uuid");
147
+ * console.log(file.name, file.url);
148
+ * ```
149
+ */
150
+ get(fileId: string): Promise<FileInfo>;
151
+ /**
152
+ * 파일 수정 — 이름 변경(rename) + 폴더 이동(move)
153
+ *
154
+ * @example
155
+ * ```ts
156
+ * await sdk.files.update(fileId, { name: "renamed.png" });
157
+ * await sdk.files.update(fileId, { folderId }); // 폴더로 이동
158
+ * await sdk.files.update(fileId, { folderId: null }); // 루트로 이동
159
+ * ```
160
+ */
161
+ update(fileId: string, input: UpdateFileInput): Promise<FileInfo>;
162
+ /**
163
+ * 텍스트 파일 내용 읽기 (미리보기용)
164
+ *
165
+ * 텍스트 계열(`text/*`, `application/json` 등)만 지원 — 그 외는 415
166
+ * (`UNSUPPORTED_CONTENT_TYPE`), 1MB 초과는 413 (`CONTENT_TOO_LARGE`).
167
+ *
168
+ * @example
169
+ * ```ts
170
+ * const text = await sdk.files.readContent(fileId);
171
+ * ```
172
+ */
173
+ readContent(fileId: string, options?: {
174
+ signal?: AbortSignal;
175
+ timeout?: number;
176
+ }): Promise<string>;
177
+ /**
178
+ * 저장공간 사용량 조회 — 사용량 미터·"한도 임박" 경고용
179
+ *
180
+ * `usedBytes`/`limitBytes`는 워크스페이스 단위(초과 업로드 402
181
+ * `STORAGE_LIMIT` 판정과 동일 소스), `fileCount`는 이 brandapp 스코프.
182
+ *
183
+ * @example
184
+ * ```ts
185
+ * const { usedBytes, limitBytes } = await sdk.files.usage();
186
+ * if (limitBytes != null && usedBytes / limitBytes > 0.9) warnAlmostFull();
187
+ * ```
188
+ */
189
+ usage(): Promise<FileUsageInfo>;
190
+ /**
191
+ * 직속 자식 폴더 목록 조회
192
+ *
193
+ * @example
194
+ * ```ts
195
+ * const rootFolders = await sdk.files.listFolders();
196
+ * const children = await sdk.files.listFolders({ parentId: folder.id });
197
+ * ```
198
+ */
199
+ listFolders(query?: FolderListQuery): Promise<FolderInfo[]>;
200
+ /**
201
+ * 폴더 생성
202
+ *
203
+ * @example
204
+ * ```ts
205
+ * const folder = await sdk.files.createFolder({ name: "invoices" });
206
+ * const child = await sdk.files.createFolder({ name: "2026", parentId: folder.id });
207
+ * ```
208
+ */
209
+ createFolder(input: CreateFolderInput): Promise<FolderInfo>;
210
+ /**
211
+ * 폴더 수정 — 이름 변경(rename) + 이동(move)
212
+ *
213
+ * 자기 자신/자손으로의 이동은 400으로 거부된다 (cycle 방지).
214
+ *
215
+ * @example
216
+ * ```ts
217
+ * await sdk.files.updateFolder(folderId, { name: "archive" });
218
+ * await sdk.files.updateFolder(folderId, { parentId: otherFolderId });
219
+ * ```
220
+ */
221
+ updateFolder(folderId: string, input: UpdateFolderInput): Promise<FolderInfo>;
222
+ /**
223
+ * 폴더 삭제 — 비어있어야 한다 (아니면 409 `FOLDER_NOT_EMPTY`)
224
+ *
225
+ * @example
226
+ * ```ts
227
+ * await sdk.files.deleteFolder(folderId);
228
+ * ```
229
+ */
230
+ deleteFolder(folderId: string): Promise<void>;
231
+ /**
232
+ * 파일 삭제
233
+ *
234
+ * @example
235
+ * ```ts
236
+ * await sdk.files.delete("file-uuid");
237
+ * ```
238
+ */
239
+ delete(fileId: string): Promise<void>;
240
+ /**
241
+ * 파일 업로드
242
+ *
243
+ * FormData(multipart)로 파일을 전송합니다.
244
+ * BaseHttpClient는 JSON 전용이므로 globalThis.fetch를 직접 사용합니다.
245
+ *
246
+ * TODO(files): 업로드 진행률(onProgress) 미지원 — fetch 단일 요청이라 진행
247
+ * 이벤트가 없다. XHR 기반 onProgress 또는 presigned 2-step 업로드(10MB 상한
248
+ * 완화 동반)는 서버 계약 변경이 필요해 별도 RFC로 다룬다.
249
+ *
250
+ * @example
251
+ * ```ts
252
+ * // Blob 업로드
253
+ * const blob = new Blob(["hello"], { type: "text/plain" });
254
+ * const file = await sdk.files.upload(blob, { name: "hello.txt" });
255
+ *
256
+ * // File 업로드 (브라우저)
257
+ * const file = await sdk.files.upload(inputEl.files[0]);
258
+ *
259
+ * // Buffer 업로드 (Node.js)
260
+ * const buf = fs.readFileSync("image.png");
261
+ * const file = await sdk.files.upload(buf, {
262
+ * name: "image.png",
263
+ * contentType: "image/png",
264
+ * });
265
+ * ```
266
+ */
267
+ upload(file: Blob | Uint8Array | File, options?: UploadOptions): Promise<FileInfo>;
268
+ }
269
+ declare function createReoptFileClient(config: ReoptSDKConfig): ReoptFileClient;
270
+ //#endregion
271
+ export { FileListQuery as a, FolderInfo as c, UpdateFolderInput as d, UploadOptions as f, FileInfo as i, FolderListQuery as l, createReoptFileClient as n, FileListResponse as o, CreateFolderInput as r, FileUsageInfo as s, ReoptFileClient as t, UpdateFileInput as u };
272
+ //# sourceMappingURL=client-B7rZQ8Zi.d.ts.map
@@ -0,0 +1,273 @@
1
+ import { A as mapHttpStatusToError, n as SDK_VERSION, o as validateConfig, x as ReoptSDKError } from "./config-aml9oQpX.js";
2
+ import { t as createManagedAbort } from "./abort--nOBFN4M.js";
3
+ import { n as parseFieldErrors, t as BaseHttpClient } from "./http-client-BZc2mngq.js";
4
+
5
+ //#region src/files/client.ts
6
+ var ReoptFileClient = class {
7
+ http;
8
+ /** 폴더 계열은 형제 리소스(/folders) — 파일과 같은 인증/에러 계약을 공유 */
9
+ folderHttp;
10
+ timeout;
11
+ constructor(config) {
12
+ validateConfig(config);
13
+ const pathPrefix = `/api/v1/brandapp/${config.brandappId}/files`;
14
+ this.http = new BaseHttpClient(config, pathPrefix);
15
+ this.folderHttp = new BaseHttpClient(config, `/api/v1/brandapp/${config.brandappId}/folders`);
16
+ this.timeout = config.timeout ?? 3e4;
17
+ }
18
+ /**
19
+ * 파일 목록 조회
20
+ *
21
+ * @example
22
+ * ```ts
23
+ * const { data: files, meta } = await sdk.files.list({
24
+ * page: 1,
25
+ * limit: 20,
26
+ * contentType: "image/*",
27
+ * sortBy: "createdAt",
28
+ * sortOrder: "desc",
29
+ * });
30
+ * console.log(`Total: ${meta.total}`);
31
+ * ```
32
+ */
33
+ async list(query) {
34
+ const params = new URLSearchParams();
35
+ if (query?.page != null) params.set("page", String(query.page));
36
+ if (query?.limit != null) params.set("limit", String(query.limit));
37
+ if (query?.contentType) params.set("contentType", query.contentType);
38
+ if (query?.folderId !== void 0) params.set("folderId", query.folderId ?? "");
39
+ if (query?.sortBy) params.set("sortBy", query.sortBy);
40
+ if (query?.sortOrder) params.set("sortOrder", query.sortOrder);
41
+ const qs = params.toString();
42
+ const path = qs ? `?${qs}` : "";
43
+ return this.http.fetch("GET", path);
44
+ }
45
+ /**
46
+ * 단일 파일 조회
47
+ *
48
+ * @example
49
+ * ```ts
50
+ * const file = await sdk.files.get("file-uuid");
51
+ * console.log(file.name, file.url);
52
+ * ```
53
+ */
54
+ async get(fileId) {
55
+ return (await this.http.fetch("GET", `/${encodeURIComponent(fileId)}`)).data;
56
+ }
57
+ /**
58
+ * 파일 수정 — 이름 변경(rename) + 폴더 이동(move)
59
+ *
60
+ * @example
61
+ * ```ts
62
+ * await sdk.files.update(fileId, { name: "renamed.png" });
63
+ * await sdk.files.update(fileId, { folderId }); // 폴더로 이동
64
+ * await sdk.files.update(fileId, { folderId: null }); // 루트로 이동
65
+ * ```
66
+ */
67
+ async update(fileId, input) {
68
+ return (await this.http.fetch("PATCH", `/${encodeURIComponent(fileId)}`, input)).data;
69
+ }
70
+ /**
71
+ * 텍스트 파일 내용 읽기 (미리보기용)
72
+ *
73
+ * 텍스트 계열(`text/*`, `application/json` 등)만 지원 — 그 외는 415
74
+ * (`UNSUPPORTED_CONTENT_TYPE`), 1MB 초과는 413 (`CONTENT_TOO_LARGE`).
75
+ *
76
+ * @example
77
+ * ```ts
78
+ * const text = await sdk.files.readContent(fileId);
79
+ * ```
80
+ */
81
+ async readContent(fileId, options) {
82
+ const url = `${this.http.requestBaseUrl}/${encodeURIComponent(fileId)}/content`;
83
+ const managed = createManagedAbort({
84
+ timeoutMs: options?.timeout ?? this.timeout,
85
+ external: options?.signal
86
+ });
87
+ try {
88
+ const response = await globalThis.fetch(url, {
89
+ method: "GET",
90
+ headers: {
91
+ Authorization: this.http.authorizationHeader,
92
+ "X-SDK-Version": `brandapp-sdk/${SDK_VERSION}`
93
+ },
94
+ signal: managed.signal
95
+ });
96
+ if (!response.ok) {
97
+ const body = await response.json().catch(() => ({}));
98
+ const errObj = typeof body.error === "object" ? body.error : void 0;
99
+ const msg = errObj?.message ?? (typeof body.error === "string" ? body.error : void 0) ?? `Content read failed with status ${response.status}`;
100
+ throw mapHttpStatusToError(response.status, errObj?.code, msg, {
101
+ method: "GET",
102
+ url
103
+ });
104
+ }
105
+ return await response.text();
106
+ } catch (e) {
107
+ if (e instanceof ReoptSDKError) throw e;
108
+ if (e instanceof Error && e.name === "AbortError") throw new ReoptSDKError("Content read timed out", 408, "TIMEOUT");
109
+ throw e;
110
+ } finally {
111
+ managed.cleanup();
112
+ }
113
+ }
114
+ /**
115
+ * 저장공간 사용량 조회 — 사용량 미터·"한도 임박" 경고용
116
+ *
117
+ * `usedBytes`/`limitBytes`는 워크스페이스 단위(초과 업로드 402
118
+ * `STORAGE_LIMIT` 판정과 동일 소스), `fileCount`는 이 brandapp 스코프.
119
+ *
120
+ * @example
121
+ * ```ts
122
+ * const { usedBytes, limitBytes } = await sdk.files.usage();
123
+ * if (limitBytes != null && usedBytes / limitBytes > 0.9) warnAlmostFull();
124
+ * ```
125
+ */
126
+ async usage() {
127
+ return (await this.http.fetch("GET", "/usage")).data;
128
+ }
129
+ /**
130
+ * 직속 자식 폴더 목록 조회
131
+ *
132
+ * @example
133
+ * ```ts
134
+ * const rootFolders = await sdk.files.listFolders();
135
+ * const children = await sdk.files.listFolders({ parentId: folder.id });
136
+ * ```
137
+ */
138
+ async listFolders(query) {
139
+ const params = new URLSearchParams();
140
+ if (query?.parentId) params.set("parentId", query.parentId);
141
+ const qs = params.toString();
142
+ return (await this.folderHttp.fetch("GET", qs ? `?${qs}` : "")).data;
143
+ }
144
+ /**
145
+ * 폴더 생성
146
+ *
147
+ * @example
148
+ * ```ts
149
+ * const folder = await sdk.files.createFolder({ name: "invoices" });
150
+ * const child = await sdk.files.createFolder({ name: "2026", parentId: folder.id });
151
+ * ```
152
+ */
153
+ async createFolder(input) {
154
+ return (await this.folderHttp.fetch("POST", "", input)).data;
155
+ }
156
+ /**
157
+ * 폴더 수정 — 이름 변경(rename) + 이동(move)
158
+ *
159
+ * 자기 자신/자손으로의 이동은 400으로 거부된다 (cycle 방지).
160
+ *
161
+ * @example
162
+ * ```ts
163
+ * await sdk.files.updateFolder(folderId, { name: "archive" });
164
+ * await sdk.files.updateFolder(folderId, { parentId: otherFolderId });
165
+ * ```
166
+ */
167
+ async updateFolder(folderId, input) {
168
+ return (await this.folderHttp.fetch("PATCH", `/${encodeURIComponent(folderId)}`, input)).data;
169
+ }
170
+ /**
171
+ * 폴더 삭제 — 비어있어야 한다 (아니면 409 `FOLDER_NOT_EMPTY`)
172
+ *
173
+ * @example
174
+ * ```ts
175
+ * await sdk.files.deleteFolder(folderId);
176
+ * ```
177
+ */
178
+ async deleteFolder(folderId) {
179
+ await this.folderHttp.fetch("DELETE", `/${encodeURIComponent(folderId)}`);
180
+ }
181
+ /**
182
+ * 파일 삭제
183
+ *
184
+ * @example
185
+ * ```ts
186
+ * await sdk.files.delete("file-uuid");
187
+ * ```
188
+ */
189
+ async delete(fileId) {
190
+ await this.http.fetch("DELETE", `/${encodeURIComponent(fileId)}`);
191
+ }
192
+ /**
193
+ * 파일 업로드
194
+ *
195
+ * FormData(multipart)로 파일을 전송합니다.
196
+ * BaseHttpClient는 JSON 전용이므로 globalThis.fetch를 직접 사용합니다.
197
+ *
198
+ * TODO(files): 업로드 진행률(onProgress) 미지원 — fetch 단일 요청이라 진행
199
+ * 이벤트가 없다. XHR 기반 onProgress 또는 presigned 2-step 업로드(10MB 상한
200
+ * 완화 동반)는 서버 계약 변경이 필요해 별도 RFC로 다룬다.
201
+ *
202
+ * @example
203
+ * ```ts
204
+ * // Blob 업로드
205
+ * const blob = new Blob(["hello"], { type: "text/plain" });
206
+ * const file = await sdk.files.upload(blob, { name: "hello.txt" });
207
+ *
208
+ * // File 업로드 (브라우저)
209
+ * const file = await sdk.files.upload(inputEl.files[0]);
210
+ *
211
+ * // Buffer 업로드 (Node.js)
212
+ * const buf = fs.readFileSync("image.png");
213
+ * const file = await sdk.files.upload(buf, {
214
+ * name: "image.png",
215
+ * contentType: "image/png",
216
+ * });
217
+ * ```
218
+ */
219
+ async upload(file, options) {
220
+ const formData = new FormData();
221
+ if (file instanceof Blob) {
222
+ const fileName = options?.name ?? ("name" in file ? file.name : "upload");
223
+ formData.append("file", file, fileName);
224
+ } else {
225
+ const arrayBuffer = file.buffer.slice(file.byteOffset, file.byteOffset + file.byteLength);
226
+ const blob = new Blob([arrayBuffer], { type: options?.contentType ?? "application/octet-stream" });
227
+ formData.append("file", blob, options?.name ?? "upload");
228
+ }
229
+ if (options?.name) formData.append("name", options.name);
230
+ if (options?.contentType) formData.append("contentType", options.contentType);
231
+ if (options?.folderId) formData.append("folderId", options.folderId);
232
+ const url = `${this.http.requestBaseUrl}/upload`;
233
+ const managed = createManagedAbort({
234
+ timeoutMs: options?.timeout ?? this.timeout,
235
+ external: options?.signal
236
+ });
237
+ try {
238
+ const response = await globalThis.fetch(url, {
239
+ method: "POST",
240
+ headers: {
241
+ Authorization: this.http.authorizationHeader,
242
+ "X-SDK-Version": `brandapp-sdk/${SDK_VERSION}`
243
+ },
244
+ body: formData,
245
+ signal: managed.signal
246
+ });
247
+ if (!response.ok) {
248
+ const body = await response.json().catch(() => ({}));
249
+ const errObj = typeof body.error === "object" ? body.error : void 0;
250
+ const msg = errObj?.message ?? (typeof body.error === "string" ? body.error : void 0) ?? `Upload failed with status ${response.status}`;
251
+ const fieldErrors = response.status === 422 ? parseFieldErrors(body) : [];
252
+ throw mapHttpStatusToError(response.status, errObj?.code, msg, {
253
+ method: "POST",
254
+ url
255
+ }, fieldErrors);
256
+ }
257
+ return (await response.json()).data;
258
+ } catch (e) {
259
+ if (e instanceof ReoptSDKError) throw e;
260
+ if (e instanceof Error && e.name === "AbortError") throw new ReoptSDKError("Upload request timed out", 408, "TIMEOUT");
261
+ throw e;
262
+ } finally {
263
+ managed.cleanup();
264
+ }
265
+ }
266
+ };
267
+ function createReoptFileClient(config) {
268
+ return new ReoptFileClient(config);
269
+ }
270
+
271
+ //#endregion
272
+ export { createReoptFileClient as n, ReoptFileClient as t };
273
+ //# sourceMappingURL=client-BoIuyx4S.js.map
@@ -1,6 +1,6 @@
1
- import { A as mapHttpStatusToError, n as SDK_VERSION, o as validateConfig, x as ReoptSDKError } from "./config-Cw0a3-C8.js";
1
+ import { A as mapHttpStatusToError, n as SDK_VERSION, o as validateConfig, x as ReoptSDKError } from "./config-aml9oQpX.js";
2
2
  import { t as createManagedAbort } from "./abort--nOBFN4M.js";
3
- import { t as BaseHttpClient } from "./http-client-QKUvvirs.js";
3
+ import { t as BaseHttpClient } from "./http-client-BZc2mngq.js";
4
4
  import { n as parseSSEStream } from "./sse-parser-FMjxM7sY.js";
5
5
 
6
6
  //#region src/ai/client.ts
@@ -224,7 +224,7 @@ var ReoptAiClient = class {
224
224
  }
225
225
  async fetchSSE(options) {
226
226
  const url = `${this.http.requestBaseUrl}/chat/completions`;
227
- const requestId = globalThis.crypto?.randomUUID?.() ?? `sdk-${"3.4.0"}-${url.length}`;
227
+ const requestId = globalThis.crypto?.randomUUID?.() ?? `sdk-${"3.5.0"}-${url.length}`;
228
228
  const ctx = {
229
229
  method: "POST",
230
230
  url,
@@ -302,4 +302,4 @@ function createReoptAiClient(config) {
302
302
 
303
303
  //#endregion
304
304
  export { createReoptAiClient as n, ReoptAiClient as t };
305
- //# sourceMappingURL=client-DPmoKuR9.js.map
305
+ //# sourceMappingURL=client-BxtZt405.js.map