@teamlearners/clawops 0.38.0 → 0.40.0

package/dist/{client-ZOgpzAPe.d.cts → client-DOMZ2phc.d.cts}

@@ -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>;
@@ -1042,6 +1045,116 @@ declare const KakaoTemplateSchema: z.ZodObject<{
     updatedAt: z.ZodString;
 }, z.ZodTypeAny, "passthrough">>;
 type KakaoTemplate = z.infer<typeof KakaoTemplateSchema>;
+/**
+ * 브랜드 메시지 말풍선 유형. **이 값이 단가를 정한다** — 텍스트형이 가장 싸고
+ * 와이드리스트·캐러셀·커머스가 가장 비싸다.
+ *
+ * `MessageType` 과 같은 이유로 열어 둔 유니온이다.
+ */
+type BrandBubbleType = 'TEXT' | 'IMAGE' | 'WIDE' | 'WIDE_ITEM_LIST' | 'CAROUSEL_FEED' | 'COMMERCE' | 'CAROUSEL_COMMERCE' | (string & {});
+/**
+ * 브랜드 메시지 템플릿.
+ *
+ * ⭐ **알림톡과 달리 검수가 없다** — `status`·`dormant`·`sendable` 이 없는 이유이고,
+ * 목록에 있으면 곧 발송할 수 있다.
+ */
+declare const KakaoBrandTemplateSchema: z.ZodObject<{
+    /** ClawOps 템플릿 리소스 ID. 발송의 `brand.templateId` 에 이 값을 쓴다. */
+    id: z.ZodString;
+    /** ClawOps 채널 리소스 ID. 발송의 `brand.channelId` 와 같은 값이다. */
+    channelId: z.ZodString;
+    name: z.ZodString;
+    chatBubbleType: z.ZodType<BrandBubbleType>;
+    /**
+     * 말풍선 본문.
+     *
+     * ⚠️ **유형에 따라 `null` 이다.** 본문이 담기는 자리가 유형마다 달라 `TEXT`·`IMAGE`·
+     * `WIDE` 에만 채워진다 — 나머지는 헤더·카드·상품명이 그 자리를 대신한다.
+     */
+    content: z.ZodNullable<z.ZodString>;
+    /** 와이드리스트형의 머리말. 다른 유형에서는 `null`. */
+    header: z.ZodNullable<z.ZodString>;
+    /** 발송 시 `brand.variables` 에 모두 채워야 하는 변수 이름. */
+    variables: z.ZodArray<z.ZodString, "many">;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    /** ClawOps 템플릿 리소스 ID. 발송의 `brand.templateId` 에 이 값을 쓴다. */
+    id: z.ZodString;
+    /** ClawOps 채널 리소스 ID. 발송의 `brand.channelId` 와 같은 값이다. */
+    channelId: z.ZodString;
+    name: z.ZodString;
+    chatBubbleType: z.ZodType<BrandBubbleType>;
+    /**
+     * 말풍선 본문.
+     *
+     * ⚠️ **유형에 따라 `null` 이다.** 본문이 담기는 자리가 유형마다 달라 `TEXT`·`IMAGE`·
+     * `WIDE` 에만 채워진다 — 나머지는 헤더·카드·상품명이 그 자리를 대신한다.
+     */
+    content: z.ZodNullable<z.ZodString>;
+    /** 와이드리스트형의 머리말. 다른 유형에서는 `null`. */
+    header: z.ZodNullable<z.ZodString>;
+    /** 발송 시 `brand.variables` 에 모두 채워야 하는 변수 이름. */
+    variables: z.ZodArray<z.ZodString, "many">;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    /** ClawOps 템플릿 리소스 ID. 발송의 `brand.templateId` 에 이 값을 쓴다. */
+    id: z.ZodString;
+    /** ClawOps 채널 리소스 ID. 발송의 `brand.channelId` 와 같은 값이다. */
+    channelId: z.ZodString;
+    name: z.ZodString;
+    chatBubbleType: z.ZodType<BrandBubbleType>;
+    /**
+     * 말풍선 본문.
+     *
+     * ⚠️ **유형에 따라 `null` 이다.** 본문이 담기는 자리가 유형마다 달라 `TEXT`·`IMAGE`·
+     * `WIDE` 에만 채워진다 — 나머지는 헤더·카드·상품명이 그 자리를 대신한다.
+     */
+    content: z.ZodNullable<z.ZodString>;
+    /** 와이드리스트형의 머리말. 다른 유형에서는 `null`. */
+    header: z.ZodNullable<z.ZodString>;
+    /** 발송 시 `brand.variables` 에 모두 채워야 하는 변수 이름. */
+    variables: z.ZodArray<z.ZodString, "many">;
+    createdAt: z.ZodString;
+    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` 에 그대로 보내는 값. */
@@ -1213,6 +1326,13 @@ interface KakaoTemplateListParams {
     page?: number;
     pageSize?: number;
 }
+/** 브랜드 메시지 템플릿 목록. 알림톡과 같은 축(채널 필수)이다. */
+interface KakaoBrandTemplateListParams {
+    /** ClawOps 채널 리소스 ID. **필수다** — 없으면 `400` 이다. */
+    channelId: string;
+    page?: number;
+    pageSize?: number;
+}
 
 type RequestOptions$1 = {
     extraHeaders?: Record<string, string>;
@@ -1288,14 +1408,82 @@ declare class KakaoTemplates extends APIResource {
      */
     list(params: KakaoTemplateListParams, options?: RequestOptions$1): Promise<Page<KakaoTemplate>>;
 }
+declare class KakaoBrandTemplates extends APIResource {
+    /**
+     * 한 채널의 브랜드 메시지 템플릿 목록.
+     *
+     * 응답의 `data[].id` 를 발송의 `brand.templateId` 로, `data[].channelId` 를
+     * `brand.channelId` 로 쓴다. `variables` 의 모든 항목을 `brand.variables` 에 채워야 한다.
+     *
+     * ⭐ **알림톡과 달리 검수가 없어** `sendable` 같은 칸이 없다 — 목록에 있으면 곧 보낼 수 있다.
+     */
+    list(params: KakaoBrandTemplateListParams, options?: RequestOptions$1): Promise<Page<KakaoBrandTemplate>>;
+}
 /**
- * 카카오 알림톡 관련 리소스.
+ * 자유형 말풍선에 실을 이미지.
+ *
+ * ⭐ **업로드 한 번, 발송 여러 번.** 캠페인 하나에 수천 건이 같은 그림을 쓰므로 받은 `id` 를
+ * 재사용한다 — 발송마다 다시 올릴 필요가 없다.
  *
- * 발송 자체는 `client.messages.create({ kakao: … })` 다 — 여기서 얻은 채널·템플릿 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>>;
+}
+/**
+ * 카카오 알림톡·브랜드 메시지 관련 리소스.
+ *
+ * 발송 자체는 `client.messages.create({ kakao: … })` 또는 `({ brand: … })` 다 —
+ * 여기서 얻은 채널·템플릿 ID 를 그대로 쓴다.
  */
 declare class Kakao extends APIResource {
     get channels(): KakaoChannels;
     get templates(): KakaoTemplates;
+    /** 브랜드 메시지 템플릿. 알림톡 템플릿(`templates`)과 **다른 표**다. */
+    get brandTemplates(): KakaoBrandTemplates;
+    /** 자유형 말풍선에 실을 이미지. 템플릿형은 이미지가 템플릿에 들어 있어 필요 없다. */
+    get brandImages(): KakaoBrandImages;
     /**
      * 채널 연결 시 지정할 업종 카테고리 목록.
      *
@@ -1426,6 +1614,7 @@ interface TextMessageCreateParams extends MessageCreateBaseParams {
     /** MMS 첨부 (최대 3개). jpg·jpeg·png·bmp, 장당 300KB 이하. */
     mediaUrl?: string[];
     kakao?: never;
+    brand?: never;
     fallback?: never;
 }
 /** 알림톡 템플릿 지정. 구조(본문·버튼·아이템·강조)는 검수된 템플릿이 정하고, 요청은 값만 채운다. */
@@ -1443,6 +1632,8 @@ interface KakaoSendParams {
      * 채워야 할 이름은 `kakao.templates.list()` 응답의 `variables` 가 알려준다.
      */
     variables?: Record<string, string>;
+    /** 알림톡엔 자유형이 없다 — 브랜드와 한 조립 함수를 쓰기 위한 스탬프이기도 하다. */
+    free?: never;
 }
 /** 알림톡이 발송 실패했을 때 대신 나갈 문자. */
 interface KakaoFallbackParams {
@@ -1464,6 +1655,7 @@ interface KakaoFallbackParams {
  */
 interface KakaoMessageCreateParams extends MessageCreateBaseParams {
     kakao: KakaoSendParams;
+    brand?: never;
     fallback?: KakaoFallbackParams;
     /** `kakao` 를 실으면 알림톡이다. 명시할 필요가 없고, 명시한다면 `'ata'` 뿐이다. */
     type?: 'ata';
@@ -1471,12 +1663,87 @@ interface KakaoMessageCreateParams extends MessageCreateBaseParams {
     subject?: never;
     mediaUrl?: never;
 }
+interface BrandSendBaseParams {
+    /** `kakao.channels.list()` 의 `data[].id` (ClawOps 리소스 ID). */
+    channelId: string;
+}
+/** 템플릿형 — 구조(본문·버튼·이미지)는 등록한 템플릿이 정하고 요청은 값만 채운다. */
+interface BrandTemplateSendParams extends BrandSendBaseParams {
+    /**
+     * `kakao.brandTemplates.list()` 의 `data[].id` (ClawOps 리소스 ID).
+     */
+    templateId: string;
+    /**
+     * 템플릿 변수. 키는 `고객명` 과 `#{고객명}` 을 모두 받는다.
+     *
+     * 채워야 할 이름은 `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;
+/**
+ * 카카오 브랜드 메시지 발송 파라미터.
+ *
+ * 채널을 **추가한 친구**에게 나가는 광고성 메시지다. 알림톡과 갈리는 점 둘:
+ *
+ * - **야간에 못 보낸다.** 20:50~08:00(KST)은 `422 kakao_brand_night_blocked` 다.
+ * - **대체발송이 없다.** `fallback` 을 실으면 `400 kakao_fallback_not_allowed` 라서
+ *   타입에서도 막는다.
+ *
+ * `(광고)` 표기와 수신거부 안내는 카카오가 붙이므로 본문에 넣지 않는다.
+ */
+interface BrandMessageCreateParams extends MessageCreateBaseParams {
+    brand: BrandSendParams;
+    /** `brand` 를 실으면 브랜드 메시지다. 명시할 필요가 없고, 명시한다면 `'bms'` 뿐이다. */
+    type?: 'bms';
+    body?: never;
+    subject?: never;
+    mediaUrl?: never;
+    kakao?: never;
+    fallback?: never;
+}
 /**
- * 발송 파라미터. 문자와 알림톡은 **서로 배타적**이다 — 서버 규칙이 그렇고, 섞으면 컴파일 에러다.
+ * 발송 파라미터. 문자·알림톡·브랜드 메시지는 **서로 배타적**이다 — 서버 규칙이 그렇고,
+ * 섞으면 컴파일 에러다.
  */
-type MessageCreateParams = TextMessageCreateParams | KakaoMessageCreateParams;
+type MessageCreateParams = TextMessageCreateParams | KakaoMessageCreateParams | BrandMessageCreateParams;
 interface MessageListParams {
-    type?: TextMessageType | 'ata';
+    type?: TextMessageType | 'ata' | 'bms';
     status?: 'queued' | 'sent' | 'failed' | 'received';
     /** 발신 또는 수신 번호. 하이픈 유무를 모두 매칭한다. */
     number?: string;
@@ -1486,10 +1753,10 @@ interface MessageListParams {
 
 declare class Messages extends APIResource {
     /**
-     * 문자(SMS/LMS/MMS) 또는 카카오 알림톡을 발송합니다.
+     * 문자(SMS/LMS/MMS) 또는 카카오 알림톡·브랜드 메시지를 발송합니다.
      *
-     * 둘은 배타적입니다 — `kakao` 를 실으면 알림톡이고, 이때 `body`·`subject`·`mediaUrl` 은
-     * 실을 수 없습니다(본문은 검수된 템플릿이 정합니다).
+     * 셋은 배타적입니다 — `kakao` 를 실으면 알림톡, `brand` 를 실으면 브랜드 메시지이고,
+     * 이때 `body`·`subject`·`mediaUrl` 은 실을 수 없습니다(본문은 템플릿이 정합니다).
      *
      * ```ts
      * // 문자
@@ -1502,6 +1769,14 @@ declare class Messages extends APIResource {
      *   kakao: { channelId, templateId, variables: { 고객명: '홍길동' } },
      *   fallback: { body: '주문이 접수되었습니다.' },
      * });
+     *
+     * // 브랜드 메시지 — 채널을 추가한 친구에게 나가는 광고성 메시지
+     * // ⚠️ 야간 제한과 대체발송 없음 — 제약은 `BrandMessageCreateParams` 참고.
+     * await client.messages.create({
+     *   to: '010…',
+     *   from: '070…',
+     *   brand: { channelId, templateId, variables: { 고객명: '홍길동' } },
+     * });
      * ```
      */
     create(params: MessageCreateParams, options?: {
@@ -1912,7 +2187,20 @@ declare class AccountContext {
  * 그렇게 보내므로 SDK 가 임의로 정규화하지 않는다. 열린 유니온이라 목록에 없는 코드도
  * 그대로 실린다(자동완성만 돕는다).
  */
-type ClawOpsErrorCode = 'invalid_phone' | 'invalid_type' | 'invalid_input' | 'from_not_registered' | 'body_too_long' | 'sms_no_subject' | 'sms_no_media' | 'lms_no_media' | 'too_many_media' | 'invalid_media_ext' | 'media_download_failed' | 'type_not_supported' | 'messaging_blocked' | 'recipient_blocked' | 'quota_exceeded' | 'override_quota_exceeded' | 'no_active_subscription' | 'kakao_required' | 'kakao_type_conflict' | 'kakao_body_not_allowed' | 'kakao_subject_not_allowed' | 'kakao_media_not_allowed' | 'kakao_channel_not_found' | 'kakao_template_not_found' | 'kakao_template_not_approved' | 'kakao_template_dormant' | 'kakao_variable_missing' | 'kakao_variable_unknown' | 'kakao_send_failed' | 'kakao_unavailable' | 'invalid_fallback_type' | 'KAKAO_TOKEN_INVALID' | 'KAKAO_CHANNEL_ALREADY_LINKED' | 'KAKAO_CHANNEL_REJECTED' | 'KAKAO_RATE_LIMITED' | 'KAKAO_PROVIDER_UNAVAILABLE' | 'VALIDATION' | 'NOT_FOUND' | (string & {});
+type ClawOpsErrorCode = 'invalid_phone' | 'invalid_type' | 'invalid_input' | 'from_not_registered' | 'body_too_long' | 'sms_no_subject' | 'sms_no_media' | 'lms_no_media' | 'too_many_media' | 'invalid_media_ext' | 'media_download_failed' | 'type_not_supported' | 'messaging_blocked' | 'recipient_blocked' | 'quota_exceeded' | 'override_quota_exceeded' | 'no_active_subscription' | 'kakao_required' | 'kakao_type_conflict' | 'kakao_body_not_allowed' | 'kakao_subject_not_allowed' | 'kakao_media_not_allowed' | 'kakao_channel_not_found' | 'kakao_template_not_found' | 'kakao_template_not_approved' | 'kakao_template_dormant' | 'kakao_variable_missing' | 'kakao_variable_unknown' | 'kakao_send_failed' | 'kakao_unavailable' | 'invalid_fallback_type' | 'kakao_brand_required' | 'kakao_brand_template_not_found'
+/** 광고성이라 20:50~08:00(KST)에는 접수되지 않는다. 하루 11시간 동안 나오므로 재시도 스케줄링이 이 분기에 달린다. */
+ | 'kakao_brand_night_blocked'
+/** 브랜드는 대체발송이 없다 — `fallback` 을 실으면 이 코드다. */
+ | '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);
 }
@@ -2116,4 +2404,4 @@ declare class ClawOps extends APIClient {
     accounts(accountId: string): AccountContext;
 }
 
-export { type MessageListParams as $, APIClient as A, BadRequestError as B, type Call as C, ClawOps as D, ClawOpsError as E, type ClawOpsErrorCode as F, type ClawOpsOptions as G, ConflictError as H, InternalServerError as I, type KakaoChannel as J, Kakao as K, type KakaoChannelCategory as L, type KakaoChannelCategoryList as M, type KakaoChannelConnectParams as N, type KakaoChannelListParams as O, type KakaoChannelStatus as P, KakaoChannels as Q, type KakaoFallbackParams as R, type KakaoMessageCreateParams as S, type KakaoSendParams as T, type KakaoTemplate as U, type KakaoTemplateListParams as V, KakaoTemplates as W, type KakaoTokenRequest as X, type KakaoTokenRequestParams as Y, type Message as Z, type MessageCreateParams as _, type APIClientOptions as a, Messages as a0, NotFoundError as a1, type NumberCreateParams as a2, type NumberListItem as a3, type NumberUpdateParams as a4, type NumberUpdateResponse as a5, Numbers as a6, Page as a7, PermissionDeniedError as a8, type PhoneNumber as a9, RateLimitError as aa, type RecordingDownload as ab, Recordings as ac, type RoutingType as ad, ServiceUnavailableError as ae, type SipCredential as af, SipCredentials as ag, type SipEndpoint as ah, SipEndpoints as ai, SolapiBridgeError as aj, type TextMessageCreateParams as ak, UnprocessableEntityError as al, type WebhookLog as am, WebhookLogs as an, WebhookVerificationError as ao, Webhooks as ap, 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 CallContextParam as u, type CallControlResponse as v, type CallCreateParams as w, type CallListParams as x, type CallUpdateParams as y, Calls 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 };