@teamlearners/clawops 0.27.0 → 0.28.0

package/dist/index.d.ts

@@ -56,12 +56,30 @@ declare class APIClient {
         extraQuery?: Record<string, unknown>;
         timeout?: number;
     }): Promise<T>;
+    _patch<T>(path: string, options: {
+        body?: Record<string, unknown> | null;
+        castTo: z.ZodType<T>;
+        extraHeaders?: Record<string, string>;
+        extraQuery?: Record<string, unknown>;
+        timeout?: number;
+    }): Promise<T>;
     _getRaw(path: string, options?: {
         query?: Record<string, unknown> | null;
         extraHeaders?: Record<string, string>;
         extraQuery?: Record<string, unknown>;
         timeout?: number;
     }): Promise<Response>;
+    /**
+     * 본문을 돌려주는 DELETE. 기존 `_delete` 는 void 라 응답을 버리는데, soft delete 처럼
+     * 삭제 결과 리소스를 그대로 반환하는 endpoint 가 있어서 따로 둔다.
+     */
+    _deleteWithResponse<T>(path: string, options: {
+        body?: Record<string, unknown> | null;
+        castTo: z.ZodType<T>;
+        extraHeaders?: Record<string, string>;
+        extraQuery?: Record<string, unknown>;
+        timeout?: number;
+    }): Promise<T>;
     _delete(path: string, options?: {
         extraHeaders?: Record<string, string>;
         timeout?: number;
@@ -212,7 +230,7 @@ type AssignmentLink = z.infer<typeof AssignmentLinkSchema>;
 type AssignmentLinkCreateResponse = z.infer<typeof AssignmentLinkCreateResponseSchema>;
 type AssignmentLinkStatus = AssignmentLink['status'];
 
-type RequestOptions = {
+type RequestOptions$1 = {
     extraHeaders?: Record<string, string>;
     extraQuery?: Record<string, unknown>;
     timeout?: number;
@@ -228,19 +246,142 @@ declare class AssignmentLinks extends APIResource {
         webhookUrl?: string;
         webhookMethod?: 'POST' | 'GET';
         note?: string;
-    }, options?: RequestOptions): Promise<AssignmentLinkCreateResponse>;
+    }, options?: RequestOptions$1): Promise<AssignmentLinkCreateResponse>;
     list(params?: {
         status?: AssignmentLinkStatus;
         page?: number;
         pageSize?: number;
-    }, options?: RequestOptions): Promise<Page<AssignmentLink>>;
-    retrieve(linkId: string, options?: RequestOptions): Promise<AssignmentLink>;
+    }, options?: RequestOptions$1): Promise<Page<AssignmentLink>>;
+    retrieve(linkId: string, options?: RequestOptions$1): Promise<AssignmentLink>;
     revoke(linkId: string, options?: {
         extraHeaders?: Record<string, string>;
         timeout?: number;
     }): Promise<void>;
 }
 
+declare const BlockedRecipientSchema: z.ZodObject<{
+    id: z.ZodString;
+    /** 국내 표기로 정규화된 번호 (예 '01012345678'). */
+    number: z.ZodString;
+    channel: z.ZodEnum<["call", "message"]>;
+    /** 지금 차단 중인지. 해제분도 이력으로 조회되므로 이 값으로 구분한다. */
+    active: z.ZodBoolean;
+    source: z.ZodString;
+    sourceRef: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    note: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    unblockedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    unblockedSource: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    unblockedBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    unblockedNote: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    id: z.ZodString;
+    /** 국내 표기로 정규화된 번호 (예 '01012345678'). */
+    number: z.ZodString;
+    channel: z.ZodEnum<["call", "message"]>;
+    /** 지금 차단 중인지. 해제분도 이력으로 조회되므로 이 값으로 구분한다. */
+    active: z.ZodBoolean;
+    source: z.ZodString;
+    sourceRef: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    note: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    unblockedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    unblockedSource: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    unblockedBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    unblockedNote: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    id: z.ZodString;
+    /** 국내 표기로 정규화된 번호 (예 '01012345678'). */
+    number: z.ZodString;
+    channel: z.ZodEnum<["call", "message"]>;
+    /** 지금 차단 중인지. 해제분도 이력으로 조회되므로 이 값으로 구분한다. */
+    active: z.ZodBoolean;
+    source: z.ZodString;
+    sourceRef: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    note: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    unblockedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    unblockedSource: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    unblockedBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    unblockedNote: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.ZodTypeAny, "passthrough">>;
+type BlockedRecipient = z.infer<typeof BlockedRecipientSchema>;
+type BlockedChannel = BlockedRecipient['channel'];
+type BlockedRecipientStatus = 'active' | 'released' | 'all';
+type BlockedRecipientSource = 'api' | 'console' | 'import';
+
+type RequestOptions = {
+    extraHeaders?: Record<string, string>;
+    extraQuery?: Record<string, unknown>;
+    timeout?: number;
+};
+/**
+ * 수신거부(DNC) 명단 리소스.
+ *
+ * 등록된 번호는 이 계정의 **발신**(전화·문자)에서 제외됩니다. 착신은 막지 않습니다 —
+ * 그 번호에서 걸려오는 전화는 그대로 받습니다.
+ *
+ * 전화와 문자는 각각 따로 차단합니다. 같은 번호라도 채널마다 별개 항목이므로,
+ * 둘 다 막으려면 `channel` 을 바꿔 두 번 등록합니다.
+ */
+declare class BlockedRecipients extends APIResource {
+    /**
+     * 번호를 수신거부 명단에 등록합니다.
+     *
+     * 하이픈·`+82` 표기 모두 허용되며 국내 표기로 정규화되어 저장됩니다.
+     *
+     * **멱등입니다** — 이미 차단 중인 (번호, 채널)을 다시 등록해도 에러가 아니라 기존 항목을
+     * 돌려줍니다. 같은 사람이 수신거부를 두 번 요청하는 것은 정상 상황이기 때문입니다.
+     */
+    create(params: {
+        number: string;
+        channel: BlockedChannel;
+        source?: BlockedRecipientSource;
+        sourceRef?: string;
+        note?: string;
+    }, options?: RequestOptions): Promise<BlockedRecipient>;
+    /**
+     * 수신거부 목록을 조회합니다. 기본은 **현재 차단 중인 항목만** 이며,
+     * 해제 이력까지 보려면 `status` 를 `'released'` 또는 `'all'` 로 지정합니다.
+     */
+    list(params?: {
+        channel?: BlockedChannel;
+        number?: string;
+        status?: BlockedRecipientStatus;
+        page?: number;
+        pageSize?: number;
+    }, options?: RequestOptions): Promise<Page<BlockedRecipient>>;
+    /** 항목 상세를 조회합니다. 해제된 항목도 이력으로 남아 조회됩니다(`active: false`). */
+    retrieve(blockId: string, options?: RequestOptions): Promise<BlockedRecipient>;
+    /**
+     * 메모를 수정합니다.
+     *
+     * 번호와 채널은 바꿀 수 없습니다 — 바꾸면 "누가 무엇을 언제 거부했는가"라는 증빙이
+     * 뒤틀립니다. 잘못 등록했다면 해제한 뒤 올바른 번호로 새로 등록하세요.
+     */
+    update(blockId: string, params?: {
+        note?: string | null;
+    }, options?: RequestOptions): Promise<BlockedRecipient>;
+    /**
+     * 수신거부를 해제해 다시 발신할 수 있게 합니다.
+     *
+     * **항목은 삭제되지 않습니다.** `active` 가 false 가 되고 `unblockedAt` 이 기록될 뿐,
+     * 행은 이력으로 남습니다 — 언제 거부했고 언제 풀렸는지가 곧 증빙이기 때문입니다.
+     * 해제분은 `list({ status: 'released' })` 로 볼 수 있습니다.
+     *
+     * 이미 해제된 항목에 다시 호출해도 성공하며, 최초 해제 시각은 덮어쓰지 않습니다.
+     */
+    release(blockId: string, params?: {
+        note?: string;
+    }, options?: RequestOptions): Promise<BlockedRecipient>;
+}
+
 declare const CallSchema: z.ZodObject<{
     callId: z.ZodString;
     /**
@@ -989,6 +1130,7 @@ declare class AccountContext {
     get recordings(): Recordings;
     get webhookLogs(): WebhookLogs;
     get assignmentLinks(): AssignmentLinks;
+    get blockedRecipients(): BlockedRecipients;
 }
 
 declare class ClawOpsError extends Error {
@@ -1173,6 +1315,7 @@ declare class ClawOps extends APIClient {
     get recordings(): Recordings;
     get webhookLogs(): WebhookLogs;
     get assignmentLinks(): AssignmentLinks;
+    get blockedRecipients(): BlockedRecipients;
     get webhooks(): Webhooks;
     accounts(accountId: string): AccountContext;
 }
@@ -1194,4 +1337,4 @@ declare const PaginationMetaSchema: z.ZodObject<{
 }, z.ZodTypeAny, "passthrough">>;
 type PaginationMeta = z.infer<typeof PaginationMetaSchema>;
 
-export { APIClient, type APIClientOptions, APIConnectionError, APIError, APIResponseValidationError, APIStatusError, APITimeoutError, AccountContext, AgentConnectionError, AgentError, type AssignmentLink, type AssignmentLinkAssignment, type AssignmentLinkCreateResponse, type AssignmentLinkStatus, AssignmentLinks, AuthenticationError, BadRequestError, type Call, type CallControlResponse, type CallCreateParams, type CallListParams, type CallUpdateParams, Calls, ClawOps, ClawOpsError, type ClawOpsOptions, ConflictError, InternalServerError, type Message, type MessageCreateParams, type MessageListParams, Messages, NotFoundError, type NumberCreateParams, type NumberListItem, type NumberUpdateParams, type NumberUpdateResponse, Numbers, Page, type PaginationMeta, PermissionDeniedError, type PhoneNumber, RateLimitError, type RecordingDownload, Recordings, ServiceUnavailableError, type SipCredential, SipCredentials, type SipEndpoint, SipEndpoints, UnprocessableEntityError, VERSION, type WebhookLog, WebhookLogs, WebhookVerificationError, Webhooks, ClawOps as default };
+export { APIClient, type APIClientOptions, APIConnectionError, APIError, APIResponseValidationError, APIStatusError, APITimeoutError, AccountContext, AgentConnectionError, AgentError, type AssignmentLink, type AssignmentLinkAssignment, type AssignmentLinkCreateResponse, type AssignmentLinkStatus, AssignmentLinks, AuthenticationError, BadRequestError, type BlockedChannel, type BlockedRecipient, type BlockedRecipientSource, type BlockedRecipientStatus, BlockedRecipients, type Call, type CallControlResponse, type CallCreateParams, type CallListParams, type CallUpdateParams, Calls, ClawOps, ClawOpsError, type ClawOpsOptions, ConflictError, InternalServerError, type Message, type MessageCreateParams, type MessageListParams, Messages, NotFoundError, type NumberCreateParams, type NumberListItem, type NumberUpdateParams, type NumberUpdateResponse, Numbers, Page, type PaginationMeta, PermissionDeniedError, type PhoneNumber, RateLimitError, type RecordingDownload, Recordings, ServiceUnavailableError, type SipCredential, SipCredentials, type SipEndpoint, SipEndpoints, UnprocessableEntityError, VERSION, type WebhookLog, WebhookLogs, WebhookVerificationError, Webhooks, ClawOps as default };

package/dist/index.js

@@ -1,5 +1,5 @@
-import { DEFAULT_BASE_URL, DEFAULT_MAX_RETRIES, DEFAULT_TIMEOUT, VERSION, APITimeoutError, APIConnectionError, makeStatusError, APIResponseValidationError, ClawOpsError, INITIAL_RETRY_DELAY, MAX_RETRY_DELAY } from './chunk-AAU26CX6.js';
-export { APIConnectionError, APIError, APIResponseValidationError, APIStatusError, APITimeoutError, AgentConnectionError, AgentError, AuthenticationError, BadRequestError, ClawOpsError, ConflictError, InternalServerError, NotFoundError, PermissionDeniedError, RateLimitError, ServiceUnavailableError, UnprocessableEntityError, VERSION } from './chunk-AAU26CX6.js';
+import { DEFAULT_BASE_URL, DEFAULT_MAX_RETRIES, DEFAULT_TIMEOUT, VERSION, APITimeoutError, APIConnectionError, makeStatusError, APIResponseValidationError, ClawOpsError, INITIAL_RETRY_DELAY, MAX_RETRY_DELAY } from './chunk-5MCVFEXW.js';
+export { APIConnectionError, APIError, APIResponseValidationError, APIStatusError, APITimeoutError, AgentConnectionError, AgentError, AuthenticationError, BadRequestError, ClawOpsError, ConflictError, InternalServerError, NotFoundError, PermissionDeniedError, RateLimitError, ServiceUnavailableError, UnprocessableEntityError, VERSION } from './chunk-5MCVFEXW.js';
 import { z } from 'zod';
 import { timingSafeEqual, createHmac } from 'crypto';
 
@@ -138,9 +138,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);
   }
@@ -305,6 +317,112 @@ var AssignmentLinks = class extends APIResource {
     );
   }
 };
+var BlockedRecipientSchema = z.object({
+  id: z.string(),
+  /** 국내 표기로 정규화된 번호 (예 '01012345678'). */
+  number: z.string(),
+  channel: z.enum(["call", "message"]),
+  /** 지금 차단 중인지. 해제분도 이력으로 조회되므로 이 값으로 구분한다. */
+  active: z.boolean(),
+  source: z.string(),
+  sourceRef: z.string().nullable().optional(),
+  note: z.string().nullable().optional(),
+  createdBy: z.string().nullable().optional(),
+  createdAt: z.string(),
+  updatedAt: z.string(),
+  unblockedAt: z.string().nullable().optional(),
+  unblockedSource: z.string().nullable().optional(),
+  unblockedBy: z.string().nullable().optional(),
+  unblockedNote: 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 = z.object({
   callId: z.string(),
   /**
@@ -773,6 +891,9 @@ 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 ClawOpsError {
   constructor(message = "Webhook \uC11C\uBA85\uC774 \uC77C\uCE58\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.") {
@@ -845,6 +966,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();
   }
@@ -856,6 +980,6 @@ var ClawOps = class extends APIClient {
 // src/client-default.ts
 var client_default_default = ClawOps;
 
-export { APIClient, AccountContext, AssignmentLinks, Calls, ClawOps, Messages, Numbers, Page, Recordings, SipCredentials, SipEndpoints, WebhookLogs, WebhookVerificationError, Webhooks, client_default_default as default };
+export { APIClient, AccountContext, AssignmentLinks, BlockedRecipients, Calls, ClawOps, Messages, Numbers, Page, Recordings, SipCredentials, SipEndpoints, WebhookLogs, WebhookVerificationError, Webhooks, client_default_default as default };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map