@teamlearners/clawops 0.39.0 → 0.40.0

package/dist/{client-B_GblPxW.d.ts → client-DOMZ2phc.d.ts}

@@ -18,14 +18,16 @@ declare class APIClient {
     constructor(options: APIClientOptions);
     private _buildHeaders;
     protected _send(method: string, path: string, options?: {
-        body?: Record<string, unknown> | null;
+        /** `FormData` 면 그대로 보낸다(multipart) — 직렬화도 Content-Type 도 건드리지 않는다. */
+        body?: Record<string, unknown> | FormData | null;
         query?: Record<string, unknown> | null;
         extraHeaders?: Record<string, string>;
         extraQuery?: Record<string, unknown>;
         timeout?: number;
     }): Promise<Response>;
     protected _request<T>(method: string, path: string, options?: {
-        body?: Record<string, unknown> | null;
+        /** `FormData` 면 그대로 보낸다(multipart) — 직렬화도 Content-Type 도 건드리지 않는다. */
+        body?: Record<string, unknown> | FormData | null;
         query?: Record<string, unknown> | null;
         castTo?: z.ZodType<T>;
         extraHeaders?: Record<string, string>;
@@ -43,7 +45,8 @@ declare class APIClient {
         timeout?: number;
     }): Promise<T>;
     _post<T>(path: string, options: {
-        body?: Record<string, unknown> | null;
+        /** `FormData` 면 그대로 보낸다(multipart) — 직렬화도 Content-Type 도 건드리지 않는다. */
+        body?: Record<string, unknown> | FormData | null;
         castTo: z.ZodType<T>;
         extraHeaders?: Record<string, string>;
         extraQuery?: Record<string, unknown>;
@@ -1117,6 +1120,41 @@ declare const KakaoBrandTemplateSchema: z.ZodObject<{
     updatedAt: z.ZodString;
 }, z.ZodTypeAny, "passthrough">>;
 type KakaoBrandTemplate = z.infer<typeof KakaoBrandTemplateSchema>;
+/**
+ * 자유형 말풍선에 실을 이미지.
+ *
+ * ⭐ `id` 는 **ClawOps 리소스 ID** 다 — 벤더 파일 식별자가 아니다. 발송의
+ * `brand.free.imageId` 에 이 값을 넣으면 서버가 벤더 값으로 바꿔 보낸다.
+ */
+declare const KakaoBrandImageSchema: z.ZodObject<{
+    id: z.ZodString;
+    /** 업로드할 때 지정한 말풍선 유형. 규격이 유형마다 달라 다른 유형엔 재사용할 수 없다. */
+    bubbleType: z.ZodType<BrandBubbleType>;
+    /** `'main'` | `'sub'`. 서브는 와이드리스트형에만 있다(메인 2:1, 서브 1:1). */
+    slot: z.ZodString;
+    /** 업로드한 원본 파일 이름. */
+    name: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    id: z.ZodString;
+    /** 업로드할 때 지정한 말풍선 유형. 규격이 유형마다 달라 다른 유형엔 재사용할 수 없다. */
+    bubbleType: z.ZodType<BrandBubbleType>;
+    /** `'main'` | `'sub'`. 서브는 와이드리스트형에만 있다(메인 2:1, 서브 1:1). */
+    slot: z.ZodString;
+    /** 업로드한 원본 파일 이름. */
+    name: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    id: z.ZodString;
+    /** 업로드할 때 지정한 말풍선 유형. 규격이 유형마다 달라 다른 유형엔 재사용할 수 없다. */
+    bubbleType: z.ZodType<BrandBubbleType>;
+    /** `'main'` | `'sub'`. 서브는 와이드리스트형에만 있다(메인 2:1, 서브 1:1). */
+    slot: z.ZodString;
+    /** 업로드한 원본 파일 이름. */
+    name: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+}, z.ZodTypeAny, "passthrough">>;
+type KakaoBrandImage = z.infer<typeof KakaoBrandImageSchema>;
 /** 채널 업종 카테고리. **열린 집합이므로 코드에 하드코딩하지 말 것** — 이 응답이 정본이다. */
 declare const KakaoChannelCategorySchema: z.ZodObject<{
     /** 채널 연결의 `categoryCode` 에 그대로 보내는 값. */
@@ -1381,6 +1419,58 @@ declare class KakaoBrandTemplates extends APIResource {
      */
     list(params: KakaoBrandTemplateListParams, options?: RequestOptions$1): Promise<Page<KakaoBrandTemplate>>;
 }
+/**
+ * 자유형 말풍선에 실을 이미지.
+ *
+ * ⭐ **업로드 한 번, 발송 여러 번.** 캠페인 하나에 수천 건이 같은 그림을 쓰므로 받은 `id` 를
+ * 재사용한다 — 발송마다 다시 올릴 필요가 없다.
+ *
+ * ⚠️ **규격이 말풍선 유형마다 다르다.** 업로드할 때 준 `bubbleType` 과 다른 유형에 쓰면
+ * 카카오가 발송 단계에서 거절한다 — 그 유형으로 다시 올려야 한다.
+ */
+declare class KakaoBrandImages extends APIResource {
+    private get _path();
+    /**
+     * 이미지를 올리고 발송에 쓸 `id` 를 받는다.
+     *
+     * ```ts
+     * const image = await client.kakao.brandImages.upload({
+     *   file: readFileSync('banner.png'),
+     *   filename: 'banner.png',
+     *   bubbleType: 'WIDE',
+     * });
+     * await client.messages.create({
+     *   to: '01012345678',
+     *   from: '07012345678',
+     *   brand: {
+     *     channelId,
+     *     free: { chatBubbleType: 'WIDE', content: '신메뉴가 나왔어요.', imageId: image.id },
+     *   },
+     * });
+     * ```
+     *
+     * ⚠️ `TEXT` 는 이미지 자리가 없어 `400` 이다. 자동완성에 뜨지만 쓸 수 없다.
+     *
+     * ⚠️ **상한은 5MB 다.** 넘으면 `400`, 10MB 를 넘으면 업로드 검증기가 먼저 끊어 `413` 이고
+     *    **`code` 가 없다** — 즉 "너무 크다" 가 두 모양으로 온다.
+     *
+     * @param params.filename 원본 파일 이름. 목록에서 사람이 알아볼 유일한 단서다.
+     * @param params.slot 와이드리스트형에서 작은 항목에 쓸 이미지면 `'sub'`. 기본은 `'main'`.
+     */
+    upload(params: {
+        file: Blob | Uint8Array;
+        filename: string;
+        bubbleType: BrandBubbleType;
+        slot?: string;
+    }, options?: RequestOptions$1): Promise<{
+        id: string;
+    }>;
+    /** 올려 둔 이미지 목록. **`id` 를 잃었을 때 되찾는 경로다.** */
+    list(params?: {
+        page?: number;
+        pageSize?: number;
+    }, options?: RequestOptions$1): Promise<Page<KakaoBrandImage>>;
+}
 /**
  * 카카오 알림톡·브랜드 메시지 관련 리소스.
  *
@@ -1392,6 +1482,8 @@ declare class Kakao extends APIResource {
     get templates(): KakaoTemplates;
     /** 브랜드 메시지 템플릿. 알림톡 템플릿(`templates`)과 **다른 표**다. */
     get brandTemplates(): KakaoBrandTemplates;
+    /** 자유형 말풍선에 실을 이미지. 템플릿형은 이미지가 템플릿에 들어 있어 필요 없다. */
+    get brandImages(): KakaoBrandImages;
     /**
      * 채널 연결 시 지정할 업종 카테고리 목록.
      *
@@ -1540,6 +1632,8 @@ interface KakaoSendParams {
      * 채워야 할 이름은 `kakao.templates.list()` 응답의 `variables` 가 알려준다.
      */
     variables?: Record<string, string>;
+    /** 알림톡엔 자유형이 없다 — 브랜드와 한 조립 함수를 쓰기 위한 스탬프이기도 하다. */
+    free?: never;
 }
 /** 알림톡이 발송 실패했을 때 대신 나갈 문자. */
 interface KakaoFallbackParams {
@@ -1569,10 +1663,12 @@ interface KakaoMessageCreateParams extends MessageCreateBaseParams {
     subject?: never;
     mediaUrl?: never;
 }
-/** 브랜드 메시지 템플릿 지정. 구조(본문·버튼·이미지)는 등록한 템플릿이 정한다. */
-interface BrandSendParams {
+interface BrandSendBaseParams {
     /** `kakao.channels.list()` 의 `data[].id` (ClawOps 리소스 ID). */
     channelId: string;
+}
+/** 템플릿형 — 구조(본문·버튼·이미지)는 등록한 템플릿이 정하고 요청은 값만 채운다. */
+interface BrandTemplateSendParams extends BrandSendBaseParams {
     /**
      * `kakao.brandTemplates.list()` 의 `data[].id` (ClawOps 리소스 ID).
      */
@@ -1583,7 +1679,43 @@ interface BrandSendParams {
      * 채워야 할 이름은 `kakao.brandTemplates.list()` 응답의 `variables` 가 알려준다.
      */
     variables?: Record<string, string>;
+    free?: never;
+}
+/**
+ * 자유형 — 말풍선을 요청이 직접 들고 간다. 템플릿을 등록하지 않아도 된다.
+ *
+ * 종료된 친구톡을 대신하는 방식이다.
+ *
+ * ⛔ **변수를 쓸 수 없다.** 치환해 줄 템플릿이 없어 `#{…}` 가 그대로 톡에 렌더되므로
+ *    서버가 `400` 으로 막는다. 값을 채우려면 템플릿형을 쓴다.
+ */
+interface BrandFreeSendParams extends BrandSendBaseParams {
+    /**
+     * 말풍선 몸통. **불투명 오브젝트다 — SDK 는 안을 검사하지 않는다.**
+     *
+     * ⛔ 칸마다 타이핑하지 않는 것이 의도다. 말풍선 규격표는 서버에 한 벌만 있고, SDK 가
+     *    사본을 들면 카카오가 칸을 늘린 날 **SDK 가 조용히 깎는다.** 잘못된 몸통은
+     *    `400 VALIDATION`(도메인) 또는 `400`+`errors`(스펙)로 돌아온다.
+     *
+     * `chatBubbleType` 이 규격을 정한다. 이미지가 필요한 유형은
+     * `kakao.brandImages.upload()` 로 먼저 올리고 받은 `id` 를 `imageId` 에 넣는다.
+     *
+     * ⚠️ `interface` 로 선언한 값은 `Record<string, unknown>` 에 대입되지 않는다(암묵 인덱스
+     *    시그니처가 없다). `free: { ...myBubble }` 로 펼치거나 `type` 으로 선언할 것.
+     */
+    free: Record<string, unknown>;
+    templateId?: never;
+    variables?: never;
 }
+/**
+ * 브랜드 메시지 발송 지정. **템플릿형(`templateId`)과 자유형(`free`)은 정확히 하나만**
+ * 성립한다 — 둘 다 실으면 어느 쪽으로 나갈지 정해 줄 수 없고, 둘 다 없으면 보낼 말풍선이
+ * 없다. 서버도 `400 invalid_input` 이다.
+ *
+ * ⛔ **평평한 optional 로 합치지 말 것.** `templateId?`·`free?` 로 두면 `{ channelId }`
+ *    하나만 준 오타가 컴파일을 통과해 **운영 트래픽의 런타임 400** 이 된다.
+ */
+type BrandSendParams = BrandTemplateSendParams | BrandFreeSendParams;
 /**
  * 카카오 브랜드 메시지 발송 파라미터.
  *
@@ -2059,7 +2191,16 @@ type ClawOpsErrorCode = 'invalid_phone' | 'invalid_type' | 'invalid_input' | 'fr
 /** 광고성이라 20:50~08:00(KST)에는 접수되지 않는다. 하루 11시간 동안 나오므로 재시도 스케줄링이 이 분기에 달린다. */
  | 'kakao_brand_night_blocked'
 /** 브랜드는 대체발송이 없다 — `fallback` 을 실으면 이 코드다. */
- | 'kakao_fallback_not_allowed' | 'KAKAO_TOKEN_INVALID' | 'KAKAO_CHANNEL_ALREADY_LINKED' | 'KAKAO_CHANNEL_REJECTED' | 'KAKAO_RATE_LIMITED' | 'KAKAO_PROVIDER_UNAVAILABLE' | 'VALIDATION' | 'NOT_FOUND' | (string & {});
+ | 'kakao_fallback_not_allowed'
+/** 자유형 몸통에서 본문을 뽑지 못했다. 벤더는 최상위 `text` 가 비면 접수 뒤 실패시킨다. */
+ | 'kakao_brand_body_empty'
+/**
+ * 자유형 `imageId` 가 이 계정의 이미지가 아니다.
+ *
+ * ⚠️ 벤더 fileId 를 직접 실어도 이 코드다 — 공개 API 는 `kakao.brandImages.upload()` 가
+ *    준 우리 id 만 받는다(그게 남의 이미지를 막는 유일한 관문이다).
+ */
+ | 'kakao_brand_image_not_found' | 'KAKAO_TOKEN_INVALID' | 'KAKAO_CHANNEL_ALREADY_LINKED' | 'KAKAO_CHANNEL_REJECTED' | 'KAKAO_RATE_LIMITED' | 'KAKAO_PROVIDER_UNAVAILABLE' | 'VALIDATION' | 'NOT_FOUND' | (string & {});
 declare class ClawOpsError extends Error {
     constructor(message: string);
 }
@@ -2263,4 +2404,4 @@ declare class ClawOps extends APIClient {
     accounts(accountId: string): AccountContext;
 }
 
-export { type KakaoTemplateListParams as $, APIClient as A, BadRequestError as B, type Call as C, type CallListParams as D, type CallUpdateParams as E, Calls as F, ClawOps as G, ClawOpsError as H, type ClawOpsErrorCode as I, type ClawOpsOptions as J, ConflictError as K, InternalServerError as L, Kakao as M, type KakaoBrandTemplate as N, type KakaoBrandTemplateListParams as O, KakaoBrandTemplates as P, type KakaoChannel as Q, type KakaoChannelCategory as R, type KakaoChannelCategoryList as S, type KakaoChannelConnectParams as T, type KakaoChannelListParams as U, type KakaoChannelStatus as V, KakaoChannels as W, type KakaoFallbackParams as X, type KakaoMessageCreateParams as Y, type KakaoSendParams as Z, type KakaoTemplate as _, type APIClientOptions as a, KakaoTemplates as a0, type KakaoTokenRequest as a1, type KakaoTokenRequestParams as a2, type Message as a3, type MessageCreateParams as a4, type MessageListParams as a5, Messages as a6, NotFoundError as a7, type NumberCreateParams as a8, type NumberListItem as a9, type NumberUpdateParams as aa, type NumberUpdateResponse as ab, Numbers as ac, Page as ad, PermissionDeniedError as ae, type PhoneNumber as af, RateLimitError as ag, type RecordingDownload as ah, Recordings as ai, type RoutingType as aj, ServiceUnavailableError as ak, type SipCredential as al, SipCredentials as am, type SipEndpoint as an, SipEndpoints as ao, SolapiBridgeError as ap, type TextMessageCreateParams as aq, UnprocessableEntityError as ar, type WebhookLog as as, WebhookLogs as at, WebhookVerificationError as au, Webhooks as av, APIConnectionError as b, APIError as c, APIResponseValidationError as d, APIStatusError as e, APITimeoutError as f, AccountContext as g, AgentConnectionError as h, AgentError as i, type AssignmentLink as j, type AssignmentLinkAssignment as k, type AssignmentLinkCreateResponse as l, type AssignmentLinkStatus as m, AssignmentLinks as n, AuthenticationError as o, type BlockedChannel as p, type BlockedRecipient as q, type BlockedRecipientSource as r, type BlockedRecipientStatus as s, BlockedRecipients as t, type BrandBubbleType as u, type BrandMessageCreateParams as v, type BrandSendParams as w, type CallContextParam as x, type CallControlResponse as y, type CallCreateParams as z };
+export { type KakaoFallbackParams as $, APIClient as A, BadRequestError as B, type Call as C, type CallControlResponse as D, type CallCreateParams as E, type CallListParams as F, type CallUpdateParams as G, Calls as H, ClawOps as I, ClawOpsError as J, type ClawOpsErrorCode as K, type ClawOpsOptions as L, ConflictError as M, InternalServerError as N, Kakao as O, type KakaoBrandImage as P, KakaoBrandImages as Q, type KakaoBrandTemplate as R, type KakaoBrandTemplateListParams as S, KakaoBrandTemplates as T, type KakaoChannel as U, type KakaoChannelCategory as V, type KakaoChannelCategoryList as W, type KakaoChannelConnectParams as X, type KakaoChannelListParams as Y, type KakaoChannelStatus as Z, KakaoChannels as _, type APIClientOptions as a, type KakaoMessageCreateParams as a0, type KakaoSendParams as a1, type KakaoTemplate as a2, type KakaoTemplateListParams as a3, KakaoTemplates as a4, type KakaoTokenRequest as a5, type KakaoTokenRequestParams as a6, type Message as a7, type MessageCreateParams as a8, type MessageListParams as a9, Messages as aa, NotFoundError as ab, type NumberCreateParams as ac, type NumberListItem as ad, type NumberUpdateParams as ae, type NumberUpdateResponse as af, Numbers as ag, Page as ah, PermissionDeniedError as ai, type PhoneNumber as aj, RateLimitError as ak, type RecordingDownload as al, Recordings as am, type RoutingType as an, ServiceUnavailableError as ao, type SipCredential as ap, SipCredentials as aq, type SipEndpoint as ar, SipEndpoints as as, SolapiBridgeError as at, type TextMessageCreateParams as au, UnprocessableEntityError as av, type WebhookLog as aw, WebhookLogs as ax, WebhookVerificationError as ay, Webhooks as az, APIConnectionError as b, APIError as c, APIResponseValidationError as d, APIStatusError as e, APITimeoutError as f, AccountContext as g, AgentConnectionError as h, AgentError as i, type AssignmentLink as j, type AssignmentLinkAssignment as k, type AssignmentLinkCreateResponse as l, type AssignmentLinkStatus as m, AssignmentLinks as n, AuthenticationError as o, type BlockedChannel as p, type BlockedRecipient as q, type BlockedRecipientSource as r, type BlockedRecipientStatus as s, BlockedRecipients as t, type BrandBubbleType as u, type BrandFreeSendParams as v, type BrandMessageCreateParams as w, type BrandSendParams as x, type BrandTemplateSendParams as y, type CallContextParam as z };

package/dist/index.cjs

@@ -3,8 +3,8 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var chunkLLPMUDNE_cjs = require('./chunk-LLPMUDNE.cjs');
-var chunkOBGKLTIN_cjs = require('./chunk-OBGKLTIN.cjs');
-var chunkFI2WH67N_cjs = require('./chunk-FI2WH67N.cjs');
+var chunkMXEZQRIL_cjs = require('./chunk-MXEZQRIL.cjs');
+var chunkIEFCBBKV_cjs = require('./chunk-IEFCBBKV.cjs');
 var zod = require('zod');
 var crypto = require('crypto');
 
@@ -15,14 +15,19 @@ function validateBaseUrl(url) {
   try {
     parsed = new URL(url);
   } catch {
-    throw new chunkOBGKLTIN_cjs.ClawOpsError(`Invalid base_url: ${url}`);
+    throw new chunkMXEZQRIL_cjs.ClawOpsError(`Invalid base_url: ${url}`);
   }
   if (parsed.protocol === "https:") return url;
   if (parsed.protocol === "http:" && LOCALHOST_HOSTS.has(parsed.hostname)) return url;
-  throw new chunkOBGKLTIN_cjs.ClawOpsError(
+  throw new chunkMXEZQRIL_cjs.ClawOpsError(
     `base_url\uC740 HTTPS\uB97C \uC0AC\uC6A9\uD574\uC57C \uD569\uB2C8\uB2E4 (\uBC1B\uC740 \uAC12: '${url}'). \uB85C\uCEEC \uAC1C\uBC1C \uC2DC\uC5D0\uB294 http://localhost\uB97C \uC0AC\uC6A9\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4.`
   );
 }
+function serializeBody(body) {
+  if (body instanceof FormData) return { payload: body, contentType: null };
+  if (!body) return { payload: void 0, contentType: "application/json" };
+  return { payload: JSON.stringify(body), contentType: "application/json" };
+}
 var APIClient = class {
   _apiKey;
   _baseURL;
@@ -43,7 +48,7 @@ var APIClient = class {
       Authorization: `Bearer ${this._apiKey}`,
       "Content-Type": "application/json",
       Accept: "application/json",
-      "User-Agent": `claw-ops-node/${chunkFI2WH67N_cjs.VERSION}`,
+      "User-Agent": `claw-ops-node/${chunkIEFCBBKV_cjs.VERSION}`,
       ...this._defaultHeaders
     };
     if (extra) Object.assign(headers, extra);
@@ -51,6 +56,9 @@ var APIClient = class {
   }
   async _send(method2, path, options = {}) {
     const headers = this._buildHeaders(options.extraHeaders);
+    const { payload, contentType } = serializeBody(options.body);
+    if (contentType === null) delete headers["Content-Type"];
+    else headers["Content-Type"] = contentType;
     const params = new URLSearchParams();
     const queryObj = { ...options.query, ...options.extraQuery };
     for (const [k, v] of Object.entries(queryObj)) {
@@ -68,7 +76,7 @@ var APIClient = class {
         response = await this._fetch(url, {
           method: method2,
           headers,
-          body: options.body ? JSON.stringify(options.body) : void 0,
+          body: payload,
           signal: controller.signal
         });
       } catch (err) {
@@ -79,14 +87,14 @@ var APIClient = class {
             await this._sleep(this._retryDelay(this._maxRetries - retriesLeft));
             continue;
           }
-          throw new chunkOBGKLTIN_cjs.APITimeoutError({ method: method2, url });
+          throw new chunkMXEZQRIL_cjs.APITimeoutError({ method: method2, url });
         }
         if (retriesLeft > 0) {
           retriesLeft--;
           await this._sleep(this._retryDelay(this._maxRetries - retriesLeft));
           continue;
         }
-        throw new chunkOBGKLTIN_cjs.APIConnectionError({ method: method2, url });
+        throw new chunkMXEZQRIL_cjs.APIConnectionError({ method: method2, url });
       } finally {
         clearTimeout(timeoutId);
       }
@@ -102,7 +110,7 @@ var APIClient = class {
       } catch {
         body = null;
       }
-      throw chunkOBGKLTIN_cjs.makeStatusError(response.status, body, response.headers, { method: method2, url });
+      throw chunkMXEZQRIL_cjs.makeStatusError(response.status, body, response.headers, { method: method2, url });
     }
   }
   async _request(method2, path, options = {}) {
@@ -113,11 +121,11 @@ var APIClient = class {
     try {
       json = await response.json();
     } catch {
-      throw new chunkOBGKLTIN_cjs.APIResponseValidationError({ status: response.status }, { method: method2, url });
+      throw new chunkMXEZQRIL_cjs.APIResponseValidationError({ status: response.status }, { method: method2, url });
     }
     const parsed = options.castTo.safeParse(json);
     if (!parsed.success) {
-      throw new chunkOBGKLTIN_cjs.APIResponseValidationError({ status: response.status }, { method: method2, url });
+      throw new chunkMXEZQRIL_cjs.APIResponseValidationError({ status: response.status }, { method: method2, url });
     }
     return parsed.data;
   }
@@ -712,6 +720,16 @@ var KakaoBrandTemplateSchema = zod.z.object({
   createdAt: zod.z.string(),
   updatedAt: zod.z.string()
 }).passthrough();
+var KakaoBrandImageSchema = zod.z.object({
+  id: zod.z.string(),
+  /** 업로드할 때 지정한 말풍선 유형. 규격이 유형마다 달라 다른 유형엔 재사용할 수 없다. */
+  bubbleType: zod.z.string(),
+  /** `'main'` | `'sub'`. 서브는 와이드리스트형에만 있다(메인 2:1, 서브 1:1). */
+  slot: zod.z.string(),
+  /** 업로드한 원본 파일 이름. */
+  name: zod.z.string().nullable(),
+  createdAt: zod.z.string()
+}).passthrough();
 var KakaoChannelCategorySchema = zod.z.object({
   /** 채널 연결의 `categoryCode` 에 그대로 보내는 값. */
   code: zod.z.string(),
@@ -883,6 +901,63 @@ var KakaoBrandTemplates = class extends APIResource {
     return page;
   }
 };
+var KakaoBrandImages = class extends APIResource {
+  get _path() {
+    return `${this._basePath}/kakao/brand-images`;
+  }
+  /**
+   * 이미지를 올리고 발송에 쓸 `id` 를 받는다.
+   *
+   * ```ts
+   * const image = await client.kakao.brandImages.upload({
+   *   file: readFileSync('banner.png'),
+   *   filename: 'banner.png',
+   *   bubbleType: 'WIDE',
+   * });
+   * await client.messages.create({
+   *   to: '01012345678',
+   *   from: '07012345678',
+   *   brand: {
+   *     channelId,
+   *     free: { chatBubbleType: 'WIDE', content: '신메뉴가 나왔어요.', imageId: image.id },
+   *   },
+   * });
+   * ```
+   *
+   * ⚠️ `TEXT` 는 이미지 자리가 없어 `400` 이다. 자동완성에 뜨지만 쓸 수 없다.
+   *
+   * ⚠️ **상한은 5MB 다.** 넘으면 `400`, 10MB 를 넘으면 업로드 검증기가 먼저 끊어 `413` 이고
+   *    **`code` 가 없다** — 즉 "너무 크다" 가 두 모양으로 온다.
+   *
+   * @param params.filename 원본 파일 이름. 목록에서 사람이 알아볼 유일한 단서다.
+   * @param params.slot 와이드리스트형에서 작은 항목에 쓸 이미지면 `'sub'`. 기본은 `'main'`.
+   */
+  async upload(params, options = {}) {
+    const form = new FormData();
+    const blob = params.file instanceof Blob ? params.file : new Blob([params.file]);
+    form.append("image", blob, params.filename);
+    form.append("bubbleType", params.bubbleType);
+    if (params.slot) form.append("slot", params.slot);
+    return this._client._post(this._path, {
+      body: form,
+      castTo: zod.z.object({ id: zod.z.string() }).passthrough(),
+      ...options
+    });
+  }
+  /** 올려 둔 이미지 목록. **`id` 를 잃었을 때 되찾는 경로다.** */
+  async list(params = {}, options = {}) {
+    const query = stripNotGiven({ page: params.page, pageSize: params.pageSize });
+    const path = this._path;
+    const raw = await this._client._get(path, {
+      castTo: PageSchema(KakaoBrandImageSchema),
+      query: Object.keys(query).length ? query : void 0,
+      ...options
+    });
+    const page = new Page(raw.data, raw.meta);
+    page._setClient(this._client, path, KakaoBrandImageSchema, query);
+    return page;
+  }
+};
 var Kakao = class extends APIResource {
   get channels() {
     return new KakaoChannels(this._client, this._accountId);
@@ -894,6 +969,10 @@ var Kakao = class extends APIResource {
   get brandTemplates() {
     return new KakaoBrandTemplates(this._client, this._accountId);
   }
+  /** 자유형 말풍선에 실을 이미지. 템플릿형은 이미지가 템플릿에 들어 있어 필요 없다. */
+  get brandImages() {
+    return new KakaoBrandImages(this._client, this._accountId);
+  }
   /**
    * 채널 연결 시 지정할 업종 카테고리 목록.
    *
@@ -936,7 +1015,12 @@ var MessageSchema = zod.z.object({
 }).passthrough();
 
 // src/resources/messages.ts
-var templateBlock = (p) => p && stripNotGiven({ ChannelId: p.channelId, TemplateId: p.templateId, Variables: p.variables });
+var sendBlock = (p) => p && stripNotGiven({
+  ChannelId: p.channelId,
+  TemplateId: p.templateId,
+  Variables: p.variables,
+  Free: p.free
+});
 var Messages = class extends APIResource {
   /**
    * 문자(SMS/LMS/MMS) 또는 카카오 알림톡·브랜드 메시지를 발송합니다.
@@ -975,8 +1059,8 @@ var Messages = class extends APIResource {
       MediaUrl: params.mediaUrl,
       IdempotencyKey: params.idempotencyKey,
       // 중첩 객체는 손으로 조립한다 — stripNotGiven 은 한 겹만 훑는다.
-      Kakao: templateBlock(params.kakao),
-      Brand: templateBlock(params.brand),
+      Kakao: sendBlock(params.kakao),
+      Brand: sendBlock(params.brand),
       Fallback: params.fallback && stripNotGiven({
         Type: params.fallback.type,
         Subject: params.fallback.subject,
@@ -1295,7 +1379,7 @@ var AccountContext = class {
     return new Kakao(this._client, this._accountId);
   }
 };
-var WebhookVerificationError = class extends chunkOBGKLTIN_cjs.ClawOpsError {
+var WebhookVerificationError = class extends chunkMXEZQRIL_cjs.ClawOpsError {
   constructor(message = "Webhook \uC11C\uBA85\uC774 \uC77C\uCE58\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.") {
     super(message);
     this.name = "WebhookVerificationError";
@@ -1325,11 +1409,11 @@ var ClawOps = class extends APIClient {
   constructor(options = {}) {
     let apiKey = options.apiKey ?? process.env.CLAWOPS_API_KEY;
     if (!apiKey) {
-      throw new chunkOBGKLTIN_cjs.ClawOpsError("apiKey\uB97C \uC9C0\uC815\uD558\uAC70\uB098 CLAWOPS_API_KEY \uD658\uACBD\uBCC0\uC218\uB97C \uC124\uC815\uD558\uC138\uC694.");
+      throw new chunkMXEZQRIL_cjs.ClawOpsError("apiKey\uB97C \uC9C0\uC815\uD558\uAC70\uB098 CLAWOPS_API_KEY \uD658\uACBD\uBCC0\uC218\uB97C \uC124\uC815\uD558\uC138\uC694.");
     }
     let accountId = options.accountId ?? process.env.CLAWOPS_ACCOUNT_ID;
     if (!accountId) {
-      throw new chunkOBGKLTIN_cjs.ClawOpsError("accountId\uB97C \uC9C0\uC815\uD558\uAC70\uB098 CLAWOPS_ACCOUNT_ID \uD658\uACBD\uBCC0\uC218\uB97C \uC124\uC815\uD558\uC138\uC694.");
+      throw new chunkMXEZQRIL_cjs.ClawOpsError("accountId\uB97C \uC9C0\uC815\uD558\uAC70\uB098 CLAWOPS_ACCOUNT_ID \uD658\uACBD\uBCC0\uC218\uB97C \uC124\uC815\uD558\uC138\uC694.");
     }
     const baseURL = options.baseURL ?? process.env.CLAWOPS_BASE_URL ?? chunkLLPMUDNE_cjs.DEFAULT_BASE_URL;
     super({
@@ -1386,79 +1470,79 @@ var client_default_default = ClawOps;
 
 Object.defineProperty(exports, "APIConnectionError", {
   enumerable: true,
-  get: function () { return chunkOBGKLTIN_cjs.APIConnectionError; }
+  get: function () { return chunkMXEZQRIL_cjs.APIConnectionError; }
 });
 Object.defineProperty(exports, "APIError", {
   enumerable: true,
-  get: function () { return chunkOBGKLTIN_cjs.APIError; }
+  get: function () { return chunkMXEZQRIL_cjs.APIError; }
 });
 Object.defineProperty(exports, "APIResponseValidationError", {
   enumerable: true,
-  get: function () { return chunkOBGKLTIN_cjs.APIResponseValidationError; }
+  get: function () { return chunkMXEZQRIL_cjs.APIResponseValidationError; }
 });
 Object.defineProperty(exports, "APIStatusError", {
   enumerable: true,
-  get: function () { return chunkOBGKLTIN_cjs.APIStatusError; }
+  get: function () { return chunkMXEZQRIL_cjs.APIStatusError; }
 });
 Object.defineProperty(exports, "APITimeoutError", {
   enumerable: true,
-  get: function () { return chunkOBGKLTIN_cjs.APITimeoutError; }
+  get: function () { return chunkMXEZQRIL_cjs.APITimeoutError; }
 });
 Object.defineProperty(exports, "AgentConnectionError", {
   enumerable: true,
-  get: function () { return chunkOBGKLTIN_cjs.AgentConnectionError; }
+  get: function () { return chunkMXEZQRIL_cjs.AgentConnectionError; }
 });
 Object.defineProperty(exports, "AgentError", {
   enumerable: true,
-  get: function () { return chunkOBGKLTIN_cjs.AgentError; }
+  get: function () { return chunkMXEZQRIL_cjs.AgentError; }
 });
 Object.defineProperty(exports, "AuthenticationError", {
   enumerable: true,
-  get: function () { return chunkOBGKLTIN_cjs.AuthenticationError; }
+  get: function () { return chunkMXEZQRIL_cjs.AuthenticationError; }
 });
 Object.defineProperty(exports, "BadRequestError", {
   enumerable: true,
-  get: function () { return chunkOBGKLTIN_cjs.BadRequestError; }
+  get: function () { return chunkMXEZQRIL_cjs.BadRequestError; }
 });
 Object.defineProperty(exports, "ClawOpsError", {
   enumerable: true,
-  get: function () { return chunkOBGKLTIN_cjs.ClawOpsError; }
+  get: function () { return chunkMXEZQRIL_cjs.ClawOpsError; }
 });
 Object.defineProperty(exports, "ConflictError", {
   enumerable: true,
-  get: function () { return chunkOBGKLTIN_cjs.ConflictError; }
+  get: function () { return chunkMXEZQRIL_cjs.ConflictError; }
 });
 Object.defineProperty(exports, "InternalServerError", {
   enumerable: true,
-  get: function () { return chunkOBGKLTIN_cjs.InternalServerError; }
+  get: function () { return chunkMXEZQRIL_cjs.InternalServerError; }
 });
 Object.defineProperty(exports, "NotFoundError", {
   enumerable: true,
-  get: function () { return chunkOBGKLTIN_cjs.NotFoundError; }
+  get: function () { return chunkMXEZQRIL_cjs.NotFoundError; }
 });
 Object.defineProperty(exports, "PermissionDeniedError", {
   enumerable: true,
-  get: function () { return chunkOBGKLTIN_cjs.PermissionDeniedError; }
+  get: function () { return chunkMXEZQRIL_cjs.PermissionDeniedError; }
 });
 Object.defineProperty(exports, "RateLimitError", {
   enumerable: true,
-  get: function () { return chunkOBGKLTIN_cjs.RateLimitError; }
+  get: function () { return chunkMXEZQRIL_cjs.RateLimitError; }
 });
 Object.defineProperty(exports, "ServiceUnavailableError", {
   enumerable: true,
-  get: function () { return chunkOBGKLTIN_cjs.ServiceUnavailableError; }
+  get: function () { return chunkMXEZQRIL_cjs.ServiceUnavailableError; }
 });
 Object.defineProperty(exports, "SolapiBridgeError", {
   enumerable: true,
-  get: function () { return chunkOBGKLTIN_cjs.SolapiBridgeError; }
+  get: function () { return chunkMXEZQRIL_cjs.SolapiBridgeError; }
 });
 Object.defineProperty(exports, "UnprocessableEntityError", {
   enumerable: true,
-  get: function () { return chunkOBGKLTIN_cjs.UnprocessableEntityError; }
+  get: function () { return chunkMXEZQRIL_cjs.UnprocessableEntityError; }
 });
 Object.defineProperty(exports, "VERSION", {
   enumerable: true,
-  get: function () { return chunkFI2WH67N_cjs.VERSION; }
+  get: function () { return chunkIEFCBBKV_cjs.VERSION; }
 });
 exports.APIClient = APIClient;
 exports.AccountContext = AccountContext;
@@ -1467,6 +1551,7 @@ exports.BlockedRecipients = BlockedRecipients;
 exports.Calls = Calls;
 exports.ClawOps = ClawOps;
 exports.Kakao = Kakao;
+exports.KakaoBrandImages = KakaoBrandImages;
 exports.KakaoBrandTemplates = KakaoBrandTemplates;
 exports.KakaoChannels = KakaoChannels;
 exports.KakaoTemplates = KakaoTemplates;