@teamlearners/clawops 0.27.0 → 0.29.0

package/dist/index.cjs

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var chunk6ZPYSHP3_cjs = require('./chunk-6ZPYSHP3.cjs');
+var chunkSBK45525_cjs = require('./chunk-SBK45525.cjs');
 var zod = require('zod');
 var crypto = require('crypto');
 
@@ -13,11 +13,11 @@ function validateBaseUrl(url) {
   try {
     parsed = new URL(url);
   } catch {
-    throw new chunk6ZPYSHP3_cjs.ClawOpsError(`Invalid base_url: ${url}`);
+    throw new chunkSBK45525_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 chunk6ZPYSHP3_cjs.ClawOpsError(
+  throw new chunkSBK45525_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.`
   );
 }
@@ -30,9 +30,9 @@ var APIClient = class {
   _defaultHeaders;
   constructor(options) {
     this._apiKey = options.apiKey;
-    this._baseURL = validateBaseUrl((options.baseURL ?? chunk6ZPYSHP3_cjs.DEFAULT_BASE_URL).replace(/\/+$/, ""));
-    this._maxRetries = options.maxRetries ?? chunk6ZPYSHP3_cjs.DEFAULT_MAX_RETRIES;
-    this._timeout = options.timeout ?? chunk6ZPYSHP3_cjs.DEFAULT_TIMEOUT;
+    this._baseURL = validateBaseUrl((options.baseURL ?? chunkSBK45525_cjs.DEFAULT_BASE_URL).replace(/\/+$/, ""));
+    this._maxRetries = options.maxRetries ?? chunkSBK45525_cjs.DEFAULT_MAX_RETRIES;
+    this._timeout = options.timeout ?? chunkSBK45525_cjs.DEFAULT_TIMEOUT;
     this._fetch = options.fetch ?? globalThis.fetch;
     this._defaultHeaders = options.defaultHeaders ?? {};
   }
@@ -41,7 +41,7 @@ var APIClient = class {
       Authorization: `Bearer ${this._apiKey}`,
       "Content-Type": "application/json",
       Accept: "application/json",
-      "User-Agent": `claw-ops-node/${chunk6ZPYSHP3_cjs.VERSION}`,
+      "User-Agent": `claw-ops-node/${chunkSBK45525_cjs.VERSION}`,
       ...this._defaultHeaders
     };
     if (extra) Object.assign(headers, extra);
@@ -77,14 +77,14 @@ var APIClient = class {
             await this._sleep(this._retryDelay(this._maxRetries - retriesLeft));
             continue;
           }
-          throw new chunk6ZPYSHP3_cjs.APITimeoutError({ method: method2, url });
+          throw new chunkSBK45525_cjs.APITimeoutError({ method: method2, url });
         }
         if (retriesLeft > 0) {
           retriesLeft--;
           await this._sleep(this._retryDelay(this._maxRetries - retriesLeft));
           continue;
         }
-        throw new chunk6ZPYSHP3_cjs.APIConnectionError({ method: method2, url });
+        throw new chunkSBK45525_cjs.APIConnectionError({ method: method2, url });
       } finally {
         clearTimeout(timeoutId);
       }
@@ -100,7 +100,7 @@ var APIClient = class {
       } catch {
         body = null;
       }
-      throw chunk6ZPYSHP3_cjs.makeStatusError(response.status, body, response.headers, { method: method2, url });
+      throw chunkSBK45525_cjs.makeStatusError(response.status, body, response.headers, { method: method2, url });
     }
   }
   async _request(method2, path, options = {}) {
@@ -111,11 +111,11 @@ var APIClient = class {
     try {
       json = await response.json();
     } catch {
-      throw new chunk6ZPYSHP3_cjs.APIResponseValidationError({ status: response.status }, { method: method2, url });
+      throw new chunkSBK45525_cjs.APIResponseValidationError({ status: response.status }, { method: method2, url });
     }
     const parsed = options.castTo.safeParse(json);
     if (!parsed.success) {
-      throw new chunk6ZPYSHP3_cjs.APIResponseValidationError({ status: response.status }, { method: method2, url });
+      throw new chunkSBK45525_cjs.APIResponseValidationError({ status: response.status }, { method: method2, url });
     }
     return parsed.data;
   }
@@ -123,7 +123,7 @@ var APIClient = class {
     return status === 408 || status === 409 || status === 429 || status >= 500;
   }
   _retryDelay(retriesTaken) {
-    const delay = Math.min(chunk6ZPYSHP3_cjs.INITIAL_RETRY_DELAY * 2 ** retriesTaken, chunk6ZPYSHP3_cjs.MAX_RETRY_DELAY);
+    const delay = Math.min(chunkSBK45525_cjs.INITIAL_RETRY_DELAY * 2 ** retriesTaken, chunkSBK45525_cjs.MAX_RETRY_DELAY);
     return delay * (1 + Math.random());
   }
   _sleep(ms) {
@@ -141,9 +141,21 @@ var APIClient = class {
     const result = await this._request("PUT", path, options);
     return result;
   }
+  async _patch(path, options) {
+    const result = await this._request("PATCH", path, options);
+    return result;
+  }
   async _getRaw(path, options = {}) {
     return this._send("GET", path, options);
   }
+  /**
+   * 본문을 돌려주는 DELETE. 기존 `_delete` 는 void 라 응답을 버리는데, soft delete 처럼
+   * 삭제 결과 리소스를 그대로 반환하는 endpoint 가 있어서 따로 둔다.
+   */
+  async _deleteWithResponse(path, options) {
+    const result = await this._request("DELETE", path, options);
+    return result;
+  }
   async _delete(path, options = {}) {
     await this._request("DELETE", path, options);
   }
@@ -308,6 +320,112 @@ 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"]),
+  /** 지금 차단 중인지. 해제분도 이력으로 조회되므로 이 값으로 구분한다. */
+  active: zod.z.boolean(),
+  source: zod.z.string(),
+  sourceRef: zod.z.string().nullable().optional(),
+  note: zod.z.string().nullable().optional(),
+  createdBy: zod.z.string().nullable().optional(),
+  createdAt: zod.z.string(),
+  updatedAt: zod.z.string(),
+  unblockedAt: zod.z.string().nullable().optional(),
+  unblockedSource: zod.z.string().nullable().optional(),
+  unblockedBy: zod.z.string().nullable().optional(),
+  unblockedNote: zod.z.string().nullable().optional()
+}).passthrough();
+
+// src/resources/blocked-recipients.ts
+var BlockedRecipients = class extends APIResource {
+  /**
+   * 번호를 수신거부 명단에 등록합니다.
+   *
+   * 하이픈·`+82` 표기 모두 허용되며 국내 표기로 정규화되어 저장됩니다.
+   *
+   * **멱등입니다** — 이미 차단 중인 (번호, 채널)을 다시 등록해도 에러가 아니라 기존 항목을
+   * 돌려줍니다. 같은 사람이 수신거부를 두 번 요청하는 것은 정상 상황이기 때문입니다.
+   */
+  async create(params, options = {}) {
+    const body = stripNotGiven({
+      number: params.number,
+      channel: params.channel,
+      source: params.source,
+      sourceRef: params.sourceRef,
+      note: params.note
+    });
+    return this._client._post(`${this._basePath}/blocked-recipients`, {
+      body,
+      castTo: BlockedRecipientSchema,
+      ...options
+    });
+  }
+  /**
+   * 수신거부 목록을 조회합니다. 기본은 **현재 차단 중인 항목만** 이며,
+   * 해제 이력까지 보려면 `status` 를 `'released'` 또는 `'all'` 로 지정합니다.
+   */
+  async list(params = {}, options = {}) {
+    const query = stripNotGiven({
+      channel: params.channel,
+      number: params.number,
+      status: params.status,
+      page: params.page,
+      pageSize: params.pageSize
+    });
+    const path = `${this._basePath}/blocked-recipients`;
+    const raw = await this._client._get(path, {
+      castTo: PageSchema(BlockedRecipientSchema),
+      query: Object.keys(query).length ? query : void 0,
+      ...options
+    });
+    const page = new Page(raw.data, raw.meta);
+    page._setClient(this._client, path, BlockedRecipientSchema, query);
+    return page;
+  }
+  /** 항목 상세를 조회합니다. 해제된 항목도 이력으로 남아 조회됩니다(`active: false`). */
+  async retrieve(blockId, options = {}) {
+    return this._client._get(`${this._basePath}/blocked-recipients/${blockId}`, {
+      castTo: BlockedRecipientSchema,
+      ...options
+    });
+  }
+  /**
+   * 메모를 수정합니다.
+   *
+   * 번호와 채널은 바꿀 수 없습니다 — 바꾸면 "누가 무엇을 언제 거부했는가"라는 증빙이
+   * 뒤틀립니다. 잘못 등록했다면 해제한 뒤 올바른 번호로 새로 등록하세요.
+   */
+  async update(blockId, params = {}, options = {}) {
+    return this._client._patch(`${this._basePath}/blocked-recipients/${blockId}`, {
+      body: { note: params.note ?? null },
+      castTo: BlockedRecipientSchema,
+      ...options
+    });
+  }
+  /**
+   * 수신거부를 해제해 다시 발신할 수 있게 합니다.
+   *
+   * **항목은 삭제되지 않습니다.** `active` 가 false 가 되고 `unblockedAt` 이 기록될 뿐,
+   * 행은 이력으로 남습니다 — 언제 거부했고 언제 풀렸는지가 곧 증빙이기 때문입니다.
+   * 해제분은 `list({ status: 'released' })` 로 볼 수 있습니다.
+   *
+   * 이미 해제된 항목에 다시 호출해도 성공하며, 최초 해제 시각은 덮어쓰지 않습니다.
+   */
+  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
+      }
+    );
+  }
+};
 var CallSchema = zod.z.object({
   callId: zod.z.string(),
   /**
@@ -555,25 +673,53 @@ var Messages = class extends APIResource {
 };
 var PhoneNumberSchema = zod.z.object({
   number: zod.z.string(),
+  numberType: zod.z.string().nullable().optional(),
   source: zod.z.string().nullable().optional(),
-  webhookUrl: zod.z.string().nullable().optional(),
-  webhookMethod: zod.z.enum(["POST", "GET"]).nullable().optional(),
-  routingType: zod.z.enum(["webhook", "sip", "softphone"]).nullable().optional(),
+  // routingType 은 enum 으로 좁히지 않는다. 좁히면 서버가 라우팅 종류를 늘렸을 때 그 번호가
+  // 섞인 목록 조회가 통째로 실패한다(0.28.0 까지의 실제 결함: 'agent' 로 라우팅된 번호
+  // 하나가 numbers.list() 전체를 깨뜨렸다).
+  routingType: zod.z.string().nullable().optional(),
+  agentId: zod.z.string().nullable().optional(),
+  callFlowId: zod.z.string().nullable().optional(),
+  forwardTo: zod.z.string().nullable().optional(),
   sipEndpointId: zod.z.string().nullable().optional(),
   sipCredentialId: zod.z.string().nullable().optional(),
+  webhookUrl: zod.z.string().nullable().optional(),
+  webhookMethod: zod.z.string().nullable().optional(),
+  webhookHeaders: zod.z.record(zod.z.string()).nullable().optional(),
+  callContextUrl: zod.z.string().nullable().optional(),
+  statusCallback: zod.z.string().nullable().optional(),
+  statusCallbackEvents: zod.z.string().nullable().optional(),
+  dictionaryId: zod.z.string().nullable().optional(),
   createdAt: zod.z.string().nullable().optional()
 }).passthrough();
 
 // src/resources/numbers.ts
 var Numbers = class extends APIResource {
+  /**
+   * 번호를 발급합니다. 번호 풀에서 자동으로 배정되며 어떤 번호가 나올지는 지정할 수 없습니다.
+   *
+   * 발급 직후 번호는 `routingType: "webhook"` 이고 `webhookUrl` 이 비어 있어, 그대로 두면
+   * 걸려온 전화가 거절됩니다. 이어서 `update()` 로 착신 라우팅을 지정하세요.
+   */
   async create(params = {}, options = {}) {
-    const body = stripNotGiven({ webhookUrl: params.webhookUrl });
+    const body = stripNotGiven({
+      webhookUrl: params.webhookUrl,
+      webhookMethod: params.webhookMethod,
+      webhookHeaders: params.webhookHeaders,
+      statusCallback: params.statusCallback,
+      statusCallbackEvents: params.statusCallbackEvents
+    });
     return this._client._post(`${this._basePath}/numbers`, {
       body: Object.keys(body).length ? body : void 0,
       castTo: PhoneNumberSchema,
       ...options
     });
   }
+  /**
+   * 등록된 번호 목록을 조회합니다. 페이지네이션과 필터가 없으며 보유한 번호가 한 번에 전부
+   * 반환됩니다.
+   */
   async list(options = {}) {
     const schema = zod.z.object({ data: zod.z.array(PhoneNumberSchema) }).passthrough();
     const result = await this._client._get(`${this._basePath}/numbers`, {
@@ -582,13 +728,30 @@ var Numbers = class extends APIResource {
     });
     return result.data;
   }
+  /**
+   * 번호 설정을 수정합니다. 착신 라우팅(webhook/agent/callflow/forward/sip/softphone)과
+   * webhook, 상태 통지, 받아쓰기 사전을 변경할 수 있습니다. 보낸 필드만 반영되고 생략한
+   * 필드는 유지됩니다.
+   *
+   * 라우팅을 바꾸면 다른 라우팅 필드는 서버에서 자동으로 비워집니다. `agent` 에서
+   * `webhook` 으로 되돌리면 `agentId` 가 null 이 되므로, 다시 `agent` 로 돌아갈 때
+   * `agentId` 를 새로 지정해야 합니다.
+   */
   async update(number, params = {}, options = {}) {
     const body = stripNotGiven({
-      webhookUrl: params.webhookUrl,
-      webhookMethod: params.webhookMethod,
       routingType: params.routingType,
+      agentId: params.agentId,
+      callFlowId: params.callFlowId,
+      forwardTo: params.forwardTo,
       sipEndpointId: params.sipEndpointId,
-      sipCredentialId: params.sipCredentialId
+      sipCredentialId: params.sipCredentialId,
+      webhookUrl: params.webhookUrl,
+      webhookMethod: params.webhookMethod,
+      webhookHeaders: params.webhookHeaders,
+      callContextUrl: params.callContextUrl,
+      statusCallback: params.statusCallback,
+      statusCallbackEvents: params.statusCallbackEvents,
+      dictionaryId: params.dictionaryId
     });
     return this._client._put(`${this._basePath}/numbers/${number}`, {
       body,
@@ -596,6 +759,10 @@ var Numbers = class extends APIResource {
       ...options
     });
   }
+  /**
+   * 번호를 반납합니다. 번호는 풀로 복귀하며 되돌릴 수 없습니다. 같은 번호를 다시
+   * 발급받는다는 보장이 없습니다.
+   */
   async delete(number, options = {}) {
     await this._client._delete(`${this._basePath}/numbers/${number}`, options);
   }
@@ -776,8 +943,11 @@ var AccountContext = class {
   get assignmentLinks() {
     return new AssignmentLinks(this._client, this._accountId);
   }
+  get blockedRecipients() {
+    return new BlockedRecipients(this._client, this._accountId);
+  }
 };
-var WebhookVerificationError = class extends chunk6ZPYSHP3_cjs.ClawOpsError {
+var WebhookVerificationError = class extends chunkSBK45525_cjs.ClawOpsError {
   constructor(message = "Webhook \uC11C\uBA85\uC774 \uC77C\uCE58\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.") {
     super(message);
     this.name = "WebhookVerificationError";
@@ -807,13 +977,13 @@ var ClawOps = class extends APIClient {
   constructor(options = {}) {
     let apiKey = options.apiKey ?? process.env.CLAWOPS_API_KEY;
     if (!apiKey) {
-      throw new chunk6ZPYSHP3_cjs.ClawOpsError("apiKey\uB97C \uC9C0\uC815\uD558\uAC70\uB098 CLAWOPS_API_KEY \uD658\uACBD\uBCC0\uC218\uB97C \uC124\uC815\uD558\uC138\uC694.");
+      throw new chunkSBK45525_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 chunk6ZPYSHP3_cjs.ClawOpsError("accountId\uB97C \uC9C0\uC815\uD558\uAC70\uB098 CLAWOPS_ACCOUNT_ID \uD658\uACBD\uBCC0\uC218\uB97C \uC124\uC815\uD558\uC138\uC694.");
+      throw new chunkSBK45525_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 ?? chunk6ZPYSHP3_cjs.DEFAULT_BASE_URL;
+    const baseURL = options.baseURL ?? process.env.CLAWOPS_BASE_URL ?? chunkSBK45525_cjs.DEFAULT_BASE_URL;
     super({
       apiKey,
       baseURL,
@@ -848,6 +1018,9 @@ var ClawOps = class extends APIClient {
   get assignmentLinks() {
     return new AssignmentLinks(this, this._defaultAccountId);
   }
+  get blockedRecipients() {
+    return new BlockedRecipients(this, this._defaultAccountId);
+  }
   get webhooks() {
     return new Webhooks();
   }
@@ -861,79 +1034,80 @@ var client_default_default = ClawOps;
 
 Object.defineProperty(exports, "APIConnectionError", {
   enumerable: true,
-  get: function () { return chunk6ZPYSHP3_cjs.APIConnectionError; }
+  get: function () { return chunkSBK45525_cjs.APIConnectionError; }
 });
 Object.defineProperty(exports, "APIError", {
   enumerable: true,
-  get: function () { return chunk6ZPYSHP3_cjs.APIError; }
+  get: function () { return chunkSBK45525_cjs.APIError; }
 });
 Object.defineProperty(exports, "APIResponseValidationError", {
   enumerable: true,
-  get: function () { return chunk6ZPYSHP3_cjs.APIResponseValidationError; }
+  get: function () { return chunkSBK45525_cjs.APIResponseValidationError; }
 });
 Object.defineProperty(exports, "APIStatusError", {
   enumerable: true,
-  get: function () { return chunk6ZPYSHP3_cjs.APIStatusError; }
+  get: function () { return chunkSBK45525_cjs.APIStatusError; }
 });
 Object.defineProperty(exports, "APITimeoutError", {
   enumerable: true,
-  get: function () { return chunk6ZPYSHP3_cjs.APITimeoutError; }
+  get: function () { return chunkSBK45525_cjs.APITimeoutError; }
 });
 Object.defineProperty(exports, "AgentConnectionError", {
   enumerable: true,
-  get: function () { return chunk6ZPYSHP3_cjs.AgentConnectionError; }
+  get: function () { return chunkSBK45525_cjs.AgentConnectionError; }
 });
 Object.defineProperty(exports, "AgentError", {
   enumerable: true,
-  get: function () { return chunk6ZPYSHP3_cjs.AgentError; }
+  get: function () { return chunkSBK45525_cjs.AgentError; }
 });
 Object.defineProperty(exports, "AuthenticationError", {
   enumerable: true,
-  get: function () { return chunk6ZPYSHP3_cjs.AuthenticationError; }
+  get: function () { return chunkSBK45525_cjs.AuthenticationError; }
 });
 Object.defineProperty(exports, "BadRequestError", {
   enumerable: true,
-  get: function () { return chunk6ZPYSHP3_cjs.BadRequestError; }
+  get: function () { return chunkSBK45525_cjs.BadRequestError; }
 });
 Object.defineProperty(exports, "ClawOpsError", {
   enumerable: true,
-  get: function () { return chunk6ZPYSHP3_cjs.ClawOpsError; }
+  get: function () { return chunkSBK45525_cjs.ClawOpsError; }
 });
 Object.defineProperty(exports, "ConflictError", {
   enumerable: true,
-  get: function () { return chunk6ZPYSHP3_cjs.ConflictError; }
+  get: function () { return chunkSBK45525_cjs.ConflictError; }
 });
 Object.defineProperty(exports, "InternalServerError", {
   enumerable: true,
-  get: function () { return chunk6ZPYSHP3_cjs.InternalServerError; }
+  get: function () { return chunkSBK45525_cjs.InternalServerError; }
 });
 Object.defineProperty(exports, "NotFoundError", {
   enumerable: true,
-  get: function () { return chunk6ZPYSHP3_cjs.NotFoundError; }
+  get: function () { return chunkSBK45525_cjs.NotFoundError; }
 });
 Object.defineProperty(exports, "PermissionDeniedError", {
   enumerable: true,
-  get: function () { return chunk6ZPYSHP3_cjs.PermissionDeniedError; }
+  get: function () { return chunkSBK45525_cjs.PermissionDeniedError; }
 });
 Object.defineProperty(exports, "RateLimitError", {
   enumerable: true,
-  get: function () { return chunk6ZPYSHP3_cjs.RateLimitError; }
+  get: function () { return chunkSBK45525_cjs.RateLimitError; }
 });
 Object.defineProperty(exports, "ServiceUnavailableError", {
   enumerable: true,
-  get: function () { return chunk6ZPYSHP3_cjs.ServiceUnavailableError; }
+  get: function () { return chunkSBK45525_cjs.ServiceUnavailableError; }
 });
 Object.defineProperty(exports, "UnprocessableEntityError", {
   enumerable: true,
-  get: function () { return chunk6ZPYSHP3_cjs.UnprocessableEntityError; }
+  get: function () { return chunkSBK45525_cjs.UnprocessableEntityError; }
 });
 Object.defineProperty(exports, "VERSION", {
   enumerable: true,
-  get: function () { return chunk6ZPYSHP3_cjs.VERSION; }
+  get: function () { return chunkSBK45525_cjs.VERSION; }
 });
 exports.APIClient = APIClient;
 exports.AccountContext = AccountContext;
 exports.AssignmentLinks = AssignmentLinks;
+exports.BlockedRecipients = BlockedRecipients;
 exports.Calls = Calls;
 exports.ClawOps = ClawOps;
 exports.Messages = Messages;