@teamlearners/clawops 0.39.0 → 0.41.0

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 chunkWTG2QGQU_cjs = require('./chunk-WTG2QGQU.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/${chunkWTG2QGQU_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;
   }
@@ -324,9 +332,22 @@ var AssignmentLinks = class extends APIResource {
 };
 var BlockedRecipientSchema = zod.z.object({
   id: zod.z.string(),
-  /** 국내 표기로 정규화된 번호 (예 '01012345678'). */
-  number: zod.z.string(),
-  channel: zod.z.enum(["call", "message"]),
+  /**
+   * 수신거부한 상대. **채널과 무관하게 항상 이 칸에 들어갑니다** —
+   * `call`·`message` 면 국내 표기로 정규화된 전화번호(예 `'01012345678'`),
+   * `email` 이면 소문자로 정규화된 이메일 주소(예 `'kim@example.com'`).
+   *
+   * 채널이 늘어도 이 칸 하나만 읽으면 됩니다.
+   */
+  recipient: zod.z.string(),
+  /**
+   * ⚠️ `email` 이 2026-09-07 에 추가됐습니다. 이 값을 **enum 으로 좁히지 마세요** —
+   * 서버가 채널을 늘리면 옛 SDK 가 파싱 단계에서 통째로 실패합니다. 실제로 그 일이
+   * 있었습니다: `['call','message']` 로 굳혀 둔 탓에, 이메일 항목이 하나라도 섞이면
+   * 목록 조회 전체가 깨졌습니다. 알려진 값은 `BlockedChannel` 로 노출하되 파싱은
+   * 열어 둡니다.
+   */
+  channel: zod.z.string(),
   /** 지금 차단 중인지. 해제분도 이력으로 조회되므로 이 값으로 구분한다. */
   active: zod.z.boolean(),
   source: zod.z.string(),
@@ -344,16 +365,17 @@ var BlockedRecipientSchema = zod.z.object({
 // src/resources/blocked-recipients.ts
 var BlockedRecipients = class extends APIResource {
   /**
-   * 번호를 수신거부 명단에 등록합니다.
+   * 수신거부 명단에 등록합니다.
    *
-   * 하이픈·`+82` 표기 모두 허용되며 국내 표기로 정규화되어 저장됩니다.
+   * `recipient` 의 형식은 `channel` 이 정합니다 — `call`·`message` 는 **전화번호**(하이픈·`+82`
+   * 표기 모두 허용, 국내 표기로 정규화되어 저장), `email` 은 **이메일 주소**(소문자로 정규화).
    *
-   * **멱등입니다** — 이미 차단 중인 (번호, 채널)을 다시 등록해도 에러가 아니라 기존 항목을
+   * **멱등입니다** — 이미 차단 중인 (대상, 채널)을 다시 등록해도 에러가 아니라 기존 항목을
    * 돌려줍니다. 같은 사람이 수신거부를 두 번 요청하는 것은 정상 상황이기 때문입니다.
    */
   async create(params, options = {}) {
     const body = stripNotGiven({
-      number: params.number,
+      recipient: params.recipient,
       channel: params.channel,
       source: params.source,
       sourceRef: params.sourceRef,
@@ -372,7 +394,7 @@ var BlockedRecipients = class extends APIResource {
   async list(params = {}, options = {}) {
     const query = stripNotGiven({
       channel: params.channel,
-      number: params.number,
+      recipient: params.recipient,
       status: params.status,
       page: params.page,
       pageSize: params.pageSize
@@ -418,14 +440,11 @@ var BlockedRecipients = class extends APIResource {
    */
   async release(blockId, params = {}, options = {}) {
     const body = stripNotGiven({ note: params.note });
-    return this._client._deleteWithResponse(
-      `${this._basePath}/blocked-recipients/${blockId}`,
-      {
-        body: Object.keys(body).length ? body : void 0,
-        castTo: BlockedRecipientSchema,
-        ...options
-      }
-    );
+    return this._client._deleteWithResponse(`${this._basePath}/blocked-recipients/${blockId}`, {
+      body: Object.keys(body).length ? body : void 0,
+      castTo: BlockedRecipientSchema,
+      ...options
+    });
   }
 };
 var CallSchema = zod.z.object({
@@ -712,6 +731,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 +912,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 +980,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 +1026,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 +1070,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 +1390,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 +1420,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 +1481,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 chunkWTG2QGQU_cjs.VERSION; }
 });
 exports.APIClient = APIClient;
 exports.AccountContext = AccountContext;
@@ -1467,6 +1562,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;