@teamlearners/clawops 0.38.0 → 0.39.0

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

@@ -1042,6 +1042,81 @@ 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>;
 /** 채널 업종 카테고리. **열린 집합이므로 코드에 하드코딩하지 말 것** — 이 응답이 정본이다. */
 declare const KakaoChannelCategorySchema: z.ZodObject<{
     /** 채널 연결의 `categoryCode` 에 그대로 보내는 값. */
@@ -1213,6 +1288,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 +1370,28 @@ 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>>;
+}
 /**
- * 카카오 알림톡 관련 리소스.
+ * 카카오 알림톡·브랜드 메시지 관련 리소스.
  *
- * 발송 자체는 `client.messages.create({ kakao: … })` 다 — 여기서 얻은 채널·템플릿 ID 를 그대로 쓴다.
+ * 발송 자체는 `client.messages.create({ kakao: … })` 또는 `({ brand: … })` 다 —
+ * 여기서 얻은 채널·템플릿 ID 를 그대로 쓴다.
  */
 declare class Kakao extends APIResource {
     get channels(): KakaoChannels;
     get templates(): KakaoTemplates;
+    /** 브랜드 메시지 템플릿. 알림톡 템플릿(`templates`)과 **다른 표**다. */
+    get brandTemplates(): KakaoBrandTemplates;
     /**
      * 채널 연결 시 지정할 업종 카테고리 목록.
      *
@@ -1426,6 +1522,7 @@ interface TextMessageCreateParams extends MessageCreateBaseParams {
     /** MMS 첨부 (최대 3개). jpg·jpeg·png·bmp, 장당 300KB 이하. */
     mediaUrl?: string[];
     kakao?: never;
+    brand?: never;
     fallback?: never;
 }
 /** 알림톡 템플릿 지정. 구조(본문·버튼·아이템·강조)는 검수된 템플릿이 정하고, 요청은 값만 채운다. */
@@ -1464,6 +1561,7 @@ interface KakaoFallbackParams {
  */
 interface KakaoMessageCreateParams extends MessageCreateBaseParams {
     kakao: KakaoSendParams;
+    brand?: never;
     fallback?: KakaoFallbackParams;
     /** `kakao` 를 실으면 알림톡이다. 명시할 필요가 없고, 명시한다면 `'ata'` 뿐이다. */
     type?: 'ata';
@@ -1471,12 +1569,49 @@ interface KakaoMessageCreateParams extends MessageCreateBaseParams {
     subject?: never;
     mediaUrl?: never;
 }
+/** 브랜드 메시지 템플릿 지정. 구조(본문·버튼·이미지)는 등록한 템플릿이 정한다. */
+interface BrandSendParams {
+    /** `kakao.channels.list()` 의 `data[].id` (ClawOps 리소스 ID). */
+    channelId: string;
+    /**
+     * `kakao.brandTemplates.list()` 의 `data[].id` (ClawOps 리소스 ID).
+     */
+    templateId: string;
+    /**
+     * 템플릿 변수. 키는 `고객명` 과 `#{고객명}` 을 모두 받는다.
+     *
+     * 채워야 할 이름은 `kakao.brandTemplates.list()` 응답의 `variables` 가 알려준다.
+     */
+    variables?: Record<string, string>;
+}
+/**
+ * 카카오 브랜드 메시지 발송 파라미터.
+ *
+ * 채널을 **추가한 친구**에게 나가는 광고성 메시지다. 알림톡과 갈리는 점 둘:
+ *
+ * - **야간에 못 보낸다.** 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 +1621,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 +1637,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 +2055,11 @@ 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' | '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 +2263,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 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 };

package/dist/index.cjs

@@ -3,8 +3,8 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var chunkLLPMUDNE_cjs = require('./chunk-LLPMUDNE.cjs');
-var chunkIYSPOOKH_cjs = require('./chunk-IYSPOOKH.cjs');
-var chunkNXCYAYFT_cjs = require('./chunk-NXCYAYFT.cjs');
+var chunkOBGKLTIN_cjs = require('./chunk-OBGKLTIN.cjs');
+var chunkFI2WH67N_cjs = require('./chunk-FI2WH67N.cjs');
 var zod = require('zod');
 var crypto = require('crypto');
 
@@ -15,11 +15,11 @@ function validateBaseUrl(url) {
   try {
     parsed = new URL(url);
   } catch {
-    throw new chunkIYSPOOKH_cjs.ClawOpsError(`Invalid base_url: ${url}`);
+    throw new chunkOBGKLTIN_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 chunkIYSPOOKH_cjs.ClawOpsError(
+  throw new chunkOBGKLTIN_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.`
   );
 }
@@ -43,7 +43,7 @@ var APIClient = class {
       Authorization: `Bearer ${this._apiKey}`,
       "Content-Type": "application/json",
       Accept: "application/json",
-      "User-Agent": `claw-ops-node/${chunkNXCYAYFT_cjs.VERSION}`,
+      "User-Agent": `claw-ops-node/${chunkFI2WH67N_cjs.VERSION}`,
       ...this._defaultHeaders
     };
     if (extra) Object.assign(headers, extra);
@@ -79,14 +79,14 @@ var APIClient = class {
             await this._sleep(this._retryDelay(this._maxRetries - retriesLeft));
             continue;
           }
-          throw new chunkIYSPOOKH_cjs.APITimeoutError({ method: method2, url });
+          throw new chunkOBGKLTIN_cjs.APITimeoutError({ method: method2, url });
         }
         if (retriesLeft > 0) {
           retriesLeft--;
           await this._sleep(this._retryDelay(this._maxRetries - retriesLeft));
           continue;
         }
-        throw new chunkIYSPOOKH_cjs.APIConnectionError({ method: method2, url });
+        throw new chunkOBGKLTIN_cjs.APIConnectionError({ method: method2, url });
       } finally {
         clearTimeout(timeoutId);
       }
@@ -102,7 +102,7 @@ var APIClient = class {
       } catch {
         body = null;
       }
-      throw chunkIYSPOOKH_cjs.makeStatusError(response.status, body, response.headers, { method: method2, url });
+      throw chunkOBGKLTIN_cjs.makeStatusError(response.status, body, response.headers, { method: method2, url });
     }
   }
   async _request(method2, path, options = {}) {
@@ -113,11 +113,11 @@ var APIClient = class {
     try {
       json = await response.json();
     } catch {
-      throw new chunkIYSPOOKH_cjs.APIResponseValidationError({ status: response.status }, { method: method2, url });
+      throw new chunkOBGKLTIN_cjs.APIResponseValidationError({ status: response.status }, { method: method2, url });
     }
     const parsed = options.castTo.safeParse(json);
     if (!parsed.success) {
-      throw new chunkIYSPOOKH_cjs.APIResponseValidationError({ status: response.status }, { method: method2, url });
+      throw new chunkOBGKLTIN_cjs.APIResponseValidationError({ status: response.status }, { method: method2, url });
     }
     return parsed.data;
   }
@@ -691,6 +691,27 @@ var KakaoTemplateSchema = zod.z.object({
   createdAt: zod.z.string(),
   updatedAt: zod.z.string()
 }).passthrough();
+var KakaoBrandTemplateSchema = zod.z.object({
+  /** ClawOps 템플릿 리소스 ID. 발송의 `brand.templateId` 에 이 값을 쓴다. */
+  id: zod.z.string(),
+  /** ClawOps 채널 리소스 ID. 발송의 `brand.channelId` 와 같은 값이다. */
+  channelId: zod.z.string(),
+  name: zod.z.string(),
+  chatBubbleType: zod.z.string(),
+  /**
+   * 말풍선 본문.
+   *
+   * ⚠️ **유형에 따라 `null` 이다.** 본문이 담기는 자리가 유형마다 달라 `TEXT`·`IMAGE`·
+   * `WIDE` 에만 채워진다 — 나머지는 헤더·카드·상품명이 그 자리를 대신한다.
+   */
+  content: zod.z.string().nullable(),
+  /** 와이드리스트형의 머리말. 다른 유형에서는 `null`. */
+  header: zod.z.string().nullable(),
+  /** 발송 시 `brand.variables` 에 모두 채워야 하는 변수 이름. */
+  variables: zod.z.array(zod.z.string()),
+  createdAt: zod.z.string(),
+  updatedAt: zod.z.string()
+}).passthrough();
 var KakaoChannelCategorySchema = zod.z.object({
   /** 채널 연결의 `categoryCode` 에 그대로 보내는 값. */
   code: zod.z.string(),
@@ -836,6 +857,32 @@ var KakaoTemplates = class extends APIResource {
     return page;
   }
 };
+var KakaoBrandTemplates = class extends APIResource {
+  /**
+   * 한 채널의 브랜드 메시지 템플릿 목록.
+   *
+   * 응답의 `data[].id` 를 발송의 `brand.templateId` 로, `data[].channelId` 를
+   * `brand.channelId` 로 쓴다. `variables` 의 모든 항목을 `brand.variables` 에 채워야 한다.
+   *
+   * ⭐ **알림톡과 달리 검수가 없어** `sendable` 같은 칸이 없다 — 목록에 있으면 곧 보낼 수 있다.
+   */
+  async list(params, options = {}) {
+    const query = stripNotGiven({
+      channelId: params.channelId,
+      page: params.page,
+      pageSize: params.pageSize
+    });
+    const path = `${this._basePath}/kakao/brand-templates`;
+    const raw = await this._client._get(path, {
+      castTo: PageSchema(KakaoBrandTemplateSchema),
+      query: Object.keys(query).length ? query : void 0,
+      ...options
+    });
+    const page = new Page(raw.data, raw.meta);
+    page._setClient(this._client, path, KakaoBrandTemplateSchema, query);
+    return page;
+  }
+};
 var Kakao = class extends APIResource {
   get channels() {
     return new KakaoChannels(this._client, this._accountId);
@@ -843,6 +890,10 @@ var Kakao = class extends APIResource {
   get templates() {
     return new KakaoTemplates(this._client, this._accountId);
   }
+  /** 브랜드 메시지 템플릿. 알림톡 템플릿(`templates`)과 **다른 표**다. */
+  get brandTemplates() {
+    return new KakaoBrandTemplates(this._client, this._accountId);
+  }
   /**
    * 채널 연결 시 지정할 업종 카테고리 목록.
    *
@@ -885,12 +936,13 @@ 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 Messages = class extends APIResource {
   /**
-   * 문자(SMS/LMS/MMS) 또는 카카오 알림톡을 발송합니다.
+   * 문자(SMS/LMS/MMS) 또는 카카오 알림톡·브랜드 메시지를 발송합니다.
    *
-   * 둘은 배타적입니다 — `kakao` 를 실으면 알림톡이고, 이때 `body`·`subject`·`mediaUrl` 은
-   * 실을 수 없습니다(본문은 검수된 템플릿이 정합니다).
+   * 셋은 배타적입니다 — `kakao` 를 실으면 알림톡, `brand` 를 실으면 브랜드 메시지이고,
+   * 이때 `body`·`subject`·`mediaUrl` 은 실을 수 없습니다(본문은 템플릿이 정합니다).
    *
    * ```ts
    * // 문자
@@ -903,6 +955,14 @@ var Messages = class extends APIResource {
    *   kakao: { channelId, templateId, variables: { 고객명: '홍길동' } },
    *   fallback: { body: '주문이 접수되었습니다.' },
    * });
+   *
+   * // 브랜드 메시지 — 채널을 추가한 친구에게 나가는 광고성 메시지
+   * // ⚠️ 야간 제한과 대체발송 없음 — 제약은 `BrandMessageCreateParams` 참고.
+   * await client.messages.create({
+   *   to: '010…',
+   *   from: '070…',
+   *   brand: { channelId, templateId, variables: { 고객명: '홍길동' } },
+   * });
    * ```
    */
   async create(params, options = {}) {
@@ -915,11 +975,8 @@ var Messages = class extends APIResource {
       MediaUrl: params.mediaUrl,
       IdempotencyKey: params.idempotencyKey,
       // 중첩 객체는 손으로 조립한다 — stripNotGiven 은 한 겹만 훑는다.
-      Kakao: params.kakao && stripNotGiven({
-        ChannelId: params.kakao.channelId,
-        TemplateId: params.kakao.templateId,
-        Variables: params.kakao.variables
-      }),
+      Kakao: templateBlock(params.kakao),
+      Brand: templateBlock(params.brand),
       Fallback: params.fallback && stripNotGiven({
         Type: params.fallback.type,
         Subject: params.fallback.subject,
@@ -1238,7 +1295,7 @@ var AccountContext = class {
     return new Kakao(this._client, this._accountId);
   }
 };
-var WebhookVerificationError = class extends chunkIYSPOOKH_cjs.ClawOpsError {
+var WebhookVerificationError = class extends chunkOBGKLTIN_cjs.ClawOpsError {
   constructor(message = "Webhook \uC11C\uBA85\uC774 \uC77C\uCE58\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.") {
     super(message);
     this.name = "WebhookVerificationError";
@@ -1268,11 +1325,11 @@ var ClawOps = class extends APIClient {
   constructor(options = {}) {
     let apiKey = options.apiKey ?? process.env.CLAWOPS_API_KEY;
     if (!apiKey) {
-      throw new chunkIYSPOOKH_cjs.ClawOpsError("apiKey\uB97C \uC9C0\uC815\uD558\uAC70\uB098 CLAWOPS_API_KEY \uD658\uACBD\uBCC0\uC218\uB97C \uC124\uC815\uD558\uC138\uC694.");
+      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.");
     }
     let accountId = options.accountId ?? process.env.CLAWOPS_ACCOUNT_ID;
     if (!accountId) {
-      throw new chunkIYSPOOKH_cjs.ClawOpsError("accountId\uB97C \uC9C0\uC815\uD558\uAC70\uB098 CLAWOPS_ACCOUNT_ID \uD658\uACBD\uBCC0\uC218\uB97C \uC124\uC815\uD558\uC138\uC694.");
+      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.");
     }
     const baseURL = options.baseURL ?? process.env.CLAWOPS_BASE_URL ?? chunkLLPMUDNE_cjs.DEFAULT_BASE_URL;
     super({
@@ -1329,79 +1386,79 @@ var client_default_default = ClawOps;
 
 Object.defineProperty(exports, "APIConnectionError", {
   enumerable: true,
-  get: function () { return chunkIYSPOOKH_cjs.APIConnectionError; }
+  get: function () { return chunkOBGKLTIN_cjs.APIConnectionError; }
 });
 Object.defineProperty(exports, "APIError", {
   enumerable: true,
-  get: function () { return chunkIYSPOOKH_cjs.APIError; }
+  get: function () { return chunkOBGKLTIN_cjs.APIError; }
 });
 Object.defineProperty(exports, "APIResponseValidationError", {
   enumerable: true,
-  get: function () { return chunkIYSPOOKH_cjs.APIResponseValidationError; }
+  get: function () { return chunkOBGKLTIN_cjs.APIResponseValidationError; }
 });
 Object.defineProperty(exports, "APIStatusError", {
   enumerable: true,
-  get: function () { return chunkIYSPOOKH_cjs.APIStatusError; }
+  get: function () { return chunkOBGKLTIN_cjs.APIStatusError; }
 });
 Object.defineProperty(exports, "APITimeoutError", {
   enumerable: true,
-  get: function () { return chunkIYSPOOKH_cjs.APITimeoutError; }
+  get: function () { return chunkOBGKLTIN_cjs.APITimeoutError; }
 });
 Object.defineProperty(exports, "AgentConnectionError", {
   enumerable: true,
-  get: function () { return chunkIYSPOOKH_cjs.AgentConnectionError; }
+  get: function () { return chunkOBGKLTIN_cjs.AgentConnectionError; }
 });
 Object.defineProperty(exports, "AgentError", {
   enumerable: true,
-  get: function () { return chunkIYSPOOKH_cjs.AgentError; }
+  get: function () { return chunkOBGKLTIN_cjs.AgentError; }
 });
 Object.defineProperty(exports, "AuthenticationError", {
   enumerable: true,
-  get: function () { return chunkIYSPOOKH_cjs.AuthenticationError; }
+  get: function () { return chunkOBGKLTIN_cjs.AuthenticationError; }
 });
 Object.defineProperty(exports, "BadRequestError", {
   enumerable: true,
-  get: function () { return chunkIYSPOOKH_cjs.BadRequestError; }
+  get: function () { return chunkOBGKLTIN_cjs.BadRequestError; }
 });
 Object.defineProperty(exports, "ClawOpsError", {
   enumerable: true,
-  get: function () { return chunkIYSPOOKH_cjs.ClawOpsError; }
+  get: function () { return chunkOBGKLTIN_cjs.ClawOpsError; }
 });
 Object.defineProperty(exports, "ConflictError", {
   enumerable: true,
-  get: function () { return chunkIYSPOOKH_cjs.ConflictError; }
+  get: function () { return chunkOBGKLTIN_cjs.ConflictError; }
 });
 Object.defineProperty(exports, "InternalServerError", {
   enumerable: true,
-  get: function () { return chunkIYSPOOKH_cjs.InternalServerError; }
+  get: function () { return chunkOBGKLTIN_cjs.InternalServerError; }
 });
 Object.defineProperty(exports, "NotFoundError", {
   enumerable: true,
-  get: function () { return chunkIYSPOOKH_cjs.NotFoundError; }
+  get: function () { return chunkOBGKLTIN_cjs.NotFoundError; }
 });
 Object.defineProperty(exports, "PermissionDeniedError", {
   enumerable: true,
-  get: function () { return chunkIYSPOOKH_cjs.PermissionDeniedError; }
+  get: function () { return chunkOBGKLTIN_cjs.PermissionDeniedError; }
 });
 Object.defineProperty(exports, "RateLimitError", {
   enumerable: true,
-  get: function () { return chunkIYSPOOKH_cjs.RateLimitError; }
+  get: function () { return chunkOBGKLTIN_cjs.RateLimitError; }
 });
 Object.defineProperty(exports, "ServiceUnavailableError", {
   enumerable: true,
-  get: function () { return chunkIYSPOOKH_cjs.ServiceUnavailableError; }
+  get: function () { return chunkOBGKLTIN_cjs.ServiceUnavailableError; }
 });
 Object.defineProperty(exports, "SolapiBridgeError", {
   enumerable: true,
-  get: function () { return chunkIYSPOOKH_cjs.SolapiBridgeError; }
+  get: function () { return chunkOBGKLTIN_cjs.SolapiBridgeError; }
 });
 Object.defineProperty(exports, "UnprocessableEntityError", {
   enumerable: true,
-  get: function () { return chunkIYSPOOKH_cjs.UnprocessableEntityError; }
+  get: function () { return chunkOBGKLTIN_cjs.UnprocessableEntityError; }
 });
 Object.defineProperty(exports, "VERSION", {
   enumerable: true,
-  get: function () { return chunkNXCYAYFT_cjs.VERSION; }
+  get: function () { return chunkFI2WH67N_cjs.VERSION; }
 });
 exports.APIClient = APIClient;
 exports.AccountContext = AccountContext;
@@ -1410,6 +1467,7 @@ exports.BlockedRecipients = BlockedRecipients;
 exports.Calls = Calls;
 exports.ClawOps = ClawOps;
 exports.Kakao = Kakao;
+exports.KakaoBrandTemplates = KakaoBrandTemplates;
 exports.KakaoChannels = KakaoChannels;
 exports.KakaoTemplates = KakaoTemplates;
 exports.Messages = Messages;