@teamlearners/clawops 0.37.0 → 0.39.0

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 chunkEYI3ULDU_cjs = require('./chunk-EYI3ULDU.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/${chunkEYI3ULDU_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;
   }
@@ -490,7 +490,11 @@ var CallControlResponseSchema = zod.z.object({
   status: zod.z.string()
 }).passthrough();
 var TranscriptSegmentSchema = zod.z.object({
-  speaker: zod.z.enum(["CUSTOMER", "AGENT"]),
+  /**
+   * ⛔ **닫힌 enum 으로 두지 않는다.** 서버는 이미 `speaker_0` 을 보내고 있고, 세그먼트
+   * 하나가 어긋나면 `segments` 배열 때문에 **전사 응답 전체**가 실패한다.
+   */
+  speaker: zod.z.string(),
   start: zod.z.number(),
   end: zod.z.number(),
   text: zod.z.string()
@@ -501,7 +505,15 @@ var TranscriptStatusSchema = zod.z.object({
   segmentCount: zod.z.number().optional(),
   segments: zod.z.array(TranscriptSegmentSchema).optional(),
   startedAt: zod.z.string().optional(),
-  stage: zod.z.enum(["download", "runtime", "trigger"]).nullable().optional(),
+  /**
+   * ⛔ **실패 단계는 서버 코드가 만든다** — 전사 파이프라인이 `download`·`runtime`·
+   * `transcription`·`recover` 를 내보내고, 영구 실패는 예외 객체의 속성을 그대로 싣는다.
+   * 어휘가 열려 있어 스펙의 enum 조차 스냅샷일 뿐이다.
+   *
+   * ⚠️ 여기가 닫혀 있으면 **전사가 실패했을 때 그 이유를 물으면 던진다** — 고객이 가장
+   * 답을 필요로 하는 순간이다.
+   */
+  stage: zod.z.string().nullable().optional(),
   error: zod.z.string().nullable().optional()
 }).passthrough();
 var TranscriptRequestAcceptedSchema = zod.z.object({
@@ -679,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(),
@@ -824,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);
@@ -831,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);
+  }
   /**
    * 채널 연결 시 지정할 업종 카테고리 목록.
    *
@@ -849,12 +912,17 @@ var Kakao = class extends APIResource {
 };
 var MessageSchema = zod.z.object({
   messageId: zod.z.string(),
-  status: zod.z.enum(["queued", "sending", "sent", "failed", "received"]),
+  status: zod.z.string(),
   /**
-   * `'ata'` 는 카카오 알림톡이다. `body` 에는 템플릿에 변수를 치환한 결과가 담기고,
-   * 버튼·아이템 리스트·강조 문구는 템플릿에 검수된 대로 발송되어 이 값에는 담기지 않는다.
+   * `'ata'`(알림톡)·`'bms'`(브랜드 메시지)는 카카오로 나간다. `body` 에는 템플릿에 변수를
+   * 치환한 결과가 담기고, 버튼·아이템 리스트·강조 문구는 템플릿에 담긴 대로 발송되어
+   * 이 값에는 담기지 않는다.
+   *
+   * ⛔ **닫힌 enum 으로 두지 않는다.** 어휘는 서버가 소유하므로, 유형이 하나 늘면 닫힌
+   * enum 은 **목록을 통째로** 실패시킨다(`list()` 는 페이지를 한 번에 파싱한다). 실제로
+   * 두 번 그렇게 터졌다 — `'ata'` 가 나왔을 때, 그리고 `'bms'` 가 나왔을 때.
    */
-  type: zod.z.enum(["sms", "lms", "mms", "rcs", "ata"]),
+  type: zod.z.string(),
   to: zod.z.string(),
   from: zod.z.string(),
   body: zod.z.string().nullable().optional(),
@@ -868,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
    * // 문자
@@ -886,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 = {}) {
@@ -898,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,
@@ -1221,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";
@@ -1251,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({
@@ -1312,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 chunkEYI3ULDU_cjs.VERSION; }
+  get: function () { return chunkFI2WH67N_cjs.VERSION; }
 });
 exports.APIClient = APIClient;
 exports.AccountContext = AccountContext;
@@ -1393,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;