@teamlearners/clawops 0.38.0 → 0.40.0

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-export { A as APIClient, a as APIClientOptions, b as APIConnectionError, c as APIError, d as APIResponseValidationError, e as APIStatusError, f as APITimeoutError, g as AccountContext, h as AgentConnectionError, i as AgentError, j as AssignmentLink, k as AssignmentLinkAssignment, l as AssignmentLinkCreateResponse, m as AssignmentLinkStatus, n as AssignmentLinks, o as AuthenticationError, B as BadRequestError, p as BlockedChannel, q as BlockedRecipient, r as BlockedRecipientSource, s as BlockedRecipientStatus, t as BlockedRecipients, C as Call, u as CallContextParam, v as CallControlResponse, w as CallCreateParams, x as CallListParams, y as CallUpdateParams, z as Calls, D as ClawOps, E as ClawOpsError, F as ClawOpsErrorCode, G as ClawOpsOptions, H as ConflictError, I as InternalServerError, K as Kakao, J as KakaoChannel, L as KakaoChannelCategory, M as KakaoChannelCategoryList, N as KakaoChannelConnectParams, O as KakaoChannelListParams, P as KakaoChannelStatus, Q as KakaoChannels, R as KakaoFallbackParams, S as KakaoMessageCreateParams, T as KakaoSendParams, U as KakaoTemplate, V as KakaoTemplateListParams, W as KakaoTemplates, X as KakaoTokenRequest, Y as KakaoTokenRequestParams, Z as Message, _ as MessageCreateParams, $ as MessageListParams, a0 as Messages, a1 as NotFoundError, a2 as NumberCreateParams, a3 as NumberListItem, a4 as NumberUpdateParams, a5 as NumberUpdateResponse, a6 as Numbers, a7 as Page, a8 as PermissionDeniedError, a9 as PhoneNumber, aa as RateLimitError, ab as RecordingDownload, ac as Recordings, ad as RoutingType, ae as ServiceUnavailableError, af as SipCredential, ag as SipCredentials, ah as SipEndpoint, ai as SipEndpoints, aj as SolapiBridgeError, ak as TextMessageCreateParams, al as UnprocessableEntityError, am as WebhookLog, an as WebhookLogs, ao as WebhookVerificationError, ap as Webhooks, D as default } from './client-ZOgpzAPe.cjs';
+export { A as APIClient, a as APIClientOptions, b as APIConnectionError, c as APIError, d as APIResponseValidationError, e as APIStatusError, f as APITimeoutError, g as AccountContext, h as AgentConnectionError, i as AgentError, j as AssignmentLink, k as AssignmentLinkAssignment, l as AssignmentLinkCreateResponse, m as AssignmentLinkStatus, n as AssignmentLinks, o as AuthenticationError, B as BadRequestError, p as BlockedChannel, q as BlockedRecipient, r as BlockedRecipientSource, s as BlockedRecipientStatus, t as BlockedRecipients, u as BrandBubbleType, v as BrandFreeSendParams, w as BrandMessageCreateParams, x as BrandSendParams, y as BrandTemplateSendParams, C as Call, z as CallContextParam, D as CallControlResponse, E as CallCreateParams, F as CallListParams, G as CallUpdateParams, H as Calls, I as ClawOps, J as ClawOpsError, K as ClawOpsErrorCode, L as ClawOpsOptions, M as ConflictError, N as InternalServerError, O as Kakao, P as KakaoBrandImage, Q as KakaoBrandImages, R as KakaoBrandTemplate, S as KakaoBrandTemplateListParams, T as KakaoBrandTemplates, U as KakaoChannel, V as KakaoChannelCategory, W as KakaoChannelCategoryList, X as KakaoChannelConnectParams, Y as KakaoChannelListParams, Z as KakaoChannelStatus, _ as KakaoChannels, $ as KakaoFallbackParams, a0 as KakaoMessageCreateParams, a1 as KakaoSendParams, a2 as KakaoTemplate, a3 as KakaoTemplateListParams, a4 as KakaoTemplates, a5 as KakaoTokenRequest, a6 as KakaoTokenRequestParams, a7 as Message, a8 as MessageCreateParams, a9 as MessageListParams, aa as Messages, ab as NotFoundError, ac as NumberCreateParams, ad as NumberListItem, ae as NumberUpdateParams, af as NumberUpdateResponse, ag as Numbers, ah as Page, ai as PermissionDeniedError, aj as PhoneNumber, ak as RateLimitError, al as RecordingDownload, am as Recordings, an as RoutingType, ao as ServiceUnavailableError, ap as SipCredential, aq as SipCredentials, ar as SipEndpoint, as as SipEndpoints, at as SolapiBridgeError, au as TextMessageCreateParams, av as UnprocessableEntityError, aw as WebhookLog, ax as WebhookLogs, ay as WebhookVerificationError, az as Webhooks, I as default } from './client-DOMZ2phc.cjs';
 import { z } from 'zod';
 
 declare const VERSION: string;

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { A as APIClient, a as APIClientOptions, b as APIConnectionError, c as APIError, d as APIResponseValidationError, e as APIStatusError, f as APITimeoutError, g as AccountContext, h as AgentConnectionError, i as AgentError, j as AssignmentLink, k as AssignmentLinkAssignment, l as AssignmentLinkCreateResponse, m as AssignmentLinkStatus, n as AssignmentLinks, o as AuthenticationError, B as BadRequestError, p as BlockedChannel, q as BlockedRecipient, r as BlockedRecipientSource, s as BlockedRecipientStatus, t as BlockedRecipients, C as Call, u as CallContextParam, v as CallControlResponse, w as CallCreateParams, x as CallListParams, y as CallUpdateParams, z as Calls, D as ClawOps, E as ClawOpsError, F as ClawOpsErrorCode, G as ClawOpsOptions, H as ConflictError, I as InternalServerError, K as Kakao, J as KakaoChannel, L as KakaoChannelCategory, M as KakaoChannelCategoryList, N as KakaoChannelConnectParams, O as KakaoChannelListParams, P as KakaoChannelStatus, Q as KakaoChannels, R as KakaoFallbackParams, S as KakaoMessageCreateParams, T as KakaoSendParams, U as KakaoTemplate, V as KakaoTemplateListParams, W as KakaoTemplates, X as KakaoTokenRequest, Y as KakaoTokenRequestParams, Z as Message, _ as MessageCreateParams, $ as MessageListParams, a0 as Messages, a1 as NotFoundError, a2 as NumberCreateParams, a3 as NumberListItem, a4 as NumberUpdateParams, a5 as NumberUpdateResponse, a6 as Numbers, a7 as Page, a8 as PermissionDeniedError, a9 as PhoneNumber, aa as RateLimitError, ab as RecordingDownload, ac as Recordings, ad as RoutingType, ae as ServiceUnavailableError, af as SipCredential, ag as SipCredentials, ah as SipEndpoint, ai as SipEndpoints, aj as SolapiBridgeError, ak as TextMessageCreateParams, al as UnprocessableEntityError, am as WebhookLog, an as WebhookLogs, ao as WebhookVerificationError, ap as Webhooks, D as default } from './client-ZOgpzAPe.js';
+export { A as APIClient, a as APIClientOptions, b as APIConnectionError, c as APIError, d as APIResponseValidationError, e as APIStatusError, f as APITimeoutError, g as AccountContext, h as AgentConnectionError, i as AgentError, j as AssignmentLink, k as AssignmentLinkAssignment, l as AssignmentLinkCreateResponse, m as AssignmentLinkStatus, n as AssignmentLinks, o as AuthenticationError, B as BadRequestError, p as BlockedChannel, q as BlockedRecipient, r as BlockedRecipientSource, s as BlockedRecipientStatus, t as BlockedRecipients, u as BrandBubbleType, v as BrandFreeSendParams, w as BrandMessageCreateParams, x as BrandSendParams, y as BrandTemplateSendParams, C as Call, z as CallContextParam, D as CallControlResponse, E as CallCreateParams, F as CallListParams, G as CallUpdateParams, H as Calls, I as ClawOps, J as ClawOpsError, K as ClawOpsErrorCode, L as ClawOpsOptions, M as ConflictError, N as InternalServerError, O as Kakao, P as KakaoBrandImage, Q as KakaoBrandImages, R as KakaoBrandTemplate, S as KakaoBrandTemplateListParams, T as KakaoBrandTemplates, U as KakaoChannel, V as KakaoChannelCategory, W as KakaoChannelCategoryList, X as KakaoChannelConnectParams, Y as KakaoChannelListParams, Z as KakaoChannelStatus, _ as KakaoChannels, $ as KakaoFallbackParams, a0 as KakaoMessageCreateParams, a1 as KakaoSendParams, a2 as KakaoTemplate, a3 as KakaoTemplateListParams, a4 as KakaoTemplates, a5 as KakaoTokenRequest, a6 as KakaoTokenRequestParams, a7 as Message, a8 as MessageCreateParams, a9 as MessageListParams, aa as Messages, ab as NotFoundError, ac as NumberCreateParams, ad as NumberListItem, ae as NumberUpdateParams, af as NumberUpdateResponse, ag as Numbers, ah as Page, ai as PermissionDeniedError, aj as PhoneNumber, ak as RateLimitError, al as RecordingDownload, am as Recordings, an as RoutingType, ao as ServiceUnavailableError, ap as SipCredential, aq as SipCredentials, ar as SipEndpoint, as as SipEndpoints, at as SolapiBridgeError, au as TextMessageCreateParams, av as UnprocessableEntityError, aw as WebhookLog, ax as WebhookLogs, ay as WebhookVerificationError, az as Webhooks, I as default } from './client-DOMZ2phc.js';
 import { z } from 'zod';
 
 declare const VERSION: string;

package/dist/index.js

@@ -1,8 +1,8 @@
 import { DEFAULT_BASE_URL, DEFAULT_MAX_RETRIES, DEFAULT_TIMEOUT, INITIAL_RETRY_DELAY, MAX_RETRY_DELAY } from './chunk-35XJNMFU.js';
-import { APITimeoutError, APIConnectionError, makeStatusError, APIResponseValidationError, ClawOpsError } from './chunk-VYGIWHRU.js';
-export { APIConnectionError, APIError, APIResponseValidationError, APIStatusError, APITimeoutError, AgentConnectionError, AgentError, AuthenticationError, BadRequestError, ClawOpsError, ConflictError, InternalServerError, NotFoundError, PermissionDeniedError, RateLimitError, ServiceUnavailableError, SolapiBridgeError, UnprocessableEntityError } from './chunk-VYGIWHRU.js';
-import { VERSION } from './chunk-J7UIB4EA.js';
-export { VERSION } from './chunk-J7UIB4EA.js';
+import { APITimeoutError, APIConnectionError, makeStatusError, APIResponseValidationError, ClawOpsError } from './chunk-SXXOAPMG.js';
+export { APIConnectionError, APIError, APIResponseValidationError, APIStatusError, APITimeoutError, AgentConnectionError, AgentError, AuthenticationError, BadRequestError, ClawOpsError, ConflictError, InternalServerError, NotFoundError, PermissionDeniedError, RateLimitError, ServiceUnavailableError, SolapiBridgeError, UnprocessableEntityError } from './chunk-SXXOAPMG.js';
+import { VERSION } from './chunk-R6UEIVYE.js';
+export { VERSION } from './chunk-R6UEIVYE.js';
 import { z } from 'zod';
 import { timingSafeEqual, createHmac } from 'crypto';
 
@@ -21,6 +21,11 @@ function validateBaseUrl(url) {
     `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;
@@ -49,6 +54,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)) {
@@ -66,7 +74,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) {
@@ -689,6 +697,37 @@ var KakaoTemplateSchema = z.object({
   createdAt: z.string(),
   updatedAt: z.string()
 }).passthrough();
+var KakaoBrandTemplateSchema = z.object({
+  /** ClawOps 템플릿 리소스 ID. 발송의 `brand.templateId` 에 이 값을 쓴다. */
+  id: z.string(),
+  /** ClawOps 채널 리소스 ID. 발송의 `brand.channelId` 와 같은 값이다. */
+  channelId: z.string(),
+  name: z.string(),
+  chatBubbleType: z.string(),
+  /**
+   * 말풍선 본문.
+   *
+   * ⚠️ **유형에 따라 `null` 이다.** 본문이 담기는 자리가 유형마다 달라 `TEXT`·`IMAGE`·
+   * `WIDE` 에만 채워진다 — 나머지는 헤더·카드·상품명이 그 자리를 대신한다.
+   */
+  content: z.string().nullable(),
+  /** 와이드리스트형의 머리말. 다른 유형에서는 `null`. */
+  header: z.string().nullable(),
+  /** 발송 시 `brand.variables` 에 모두 채워야 하는 변수 이름. */
+  variables: z.array(z.string()),
+  createdAt: z.string(),
+  updatedAt: z.string()
+}).passthrough();
+var KakaoBrandImageSchema = z.object({
+  id: z.string(),
+  /** 업로드할 때 지정한 말풍선 유형. 규격이 유형마다 달라 다른 유형엔 재사용할 수 없다. */
+  bubbleType: z.string(),
+  /** `'main'` | `'sub'`. 서브는 와이드리스트형에만 있다(메인 2:1, 서브 1:1). */
+  slot: z.string(),
+  /** 업로드한 원본 파일 이름. */
+  name: z.string().nullable(),
+  createdAt: z.string()
+}).passthrough();
 var KakaoChannelCategorySchema = z.object({
   /** 채널 연결의 `categoryCode` 에 그대로 보내는 값. */
   code: z.string(),
@@ -834,6 +873,89 @@ 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 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: z.object({ id: 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);
@@ -841,6 +963,14 @@ var Kakao = class extends APIResource {
   get templates() {
     return new KakaoTemplates(this._client, this._accountId);
   }
+  /** 브랜드 메시지 템플릿. 알림톡 템플릿(`templates`)과 **다른 표**다. */
+  get brandTemplates() {
+    return new KakaoBrandTemplates(this._client, this._accountId);
+  }
+  /** 자유형 말풍선에 실을 이미지. 템플릿형은 이미지가 템플릿에 들어 있어 필요 없다. */
+  get brandImages() {
+    return new KakaoBrandImages(this._client, this._accountId);
+  }
   /**
    * 채널 연결 시 지정할 업종 카테고리 목록.
    *
@@ -883,12 +1013,18 @@ var MessageSchema = z.object({
 }).passthrough();
 
 // src/resources/messages.ts
+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) 또는 카카오 알림톡을 발송합니다.
+   * 문자(SMS/LMS/MMS) 또는 카카오 알림톡·브랜드 메시지를 발송합니다.
    *
-   * 둘은 배타적입니다 — `kakao` 를 실으면 알림톡이고, 이때 `body`·`subject`·`mediaUrl` 은
-   * 실을 수 없습니다(본문은 검수된 템플릿이 정합니다).
+   * 셋은 배타적입니다 — `kakao` 를 실으면 알림톡, `brand` 를 실으면 브랜드 메시지이고,
+   * 이때 `body`·`subject`·`mediaUrl` 은 실을 수 없습니다(본문은 템플릿이 정합니다).
    *
    * ```ts
    * // 문자
@@ -901,6 +1037,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 = {}) {
@@ -913,11 +1057,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: sendBlock(params.kakao),
+      Brand: sendBlock(params.brand),
       Fallback: params.fallback && stripNotGiven({
         Type: params.fallback.type,
         Subject: params.fallback.subject,
@@ -1325,6 +1466,6 @@ var ClawOps = class extends APIClient {
 // src/client-default.ts
 var client_default_default = ClawOps;
 
-export { APIClient, AccountContext, AssignmentLinks, BlockedRecipients, Calls, ClawOps, Kakao, KakaoChannels, KakaoTemplates, Messages, Numbers, Page, Recordings, SipCredentials, SipEndpoints, WebhookLogs, WebhookVerificationError, Webhooks, client_default_default as default };
+export { APIClient, AccountContext, AssignmentLinks, BlockedRecipients, Calls, ClawOps, Kakao, KakaoBrandImages, KakaoBrandTemplates, KakaoChannels, KakaoTemplates, Messages, Numbers, Page, Recordings, SipCredentials, SipEndpoints, WebhookLogs, WebhookVerificationError, Webhooks, client_default_default as default };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map