@teamlearners/clawops 0.27.0 → 0.29.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$2 = {
     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$2): Promise<AssignmentLinkCreateResponse>;
     list(params?: {
         status?: AssignmentLinkStatus;
         page?: number;
         pageSize?: number;
-    }, options?: RequestOptions): Promise<Page<AssignmentLink>>;
-    retrieve(linkId: string, options?: RequestOptions): Promise<AssignmentLink>;
+    }, options?: RequestOptions$2): Promise<Page<AssignmentLink>>;
+    retrieve(linkId: string, options?: RequestOptions$2): 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$1 = {
+    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$1): Promise<BlockedRecipient>;
+    /**
+     * 수신거부 목록을 조회합니다. 기본은 **현재 차단 중인 항목만** 이며,
+     * 해제 이력까지 보려면 `status` 를 `'released'` 또는 `'all'` 로 지정합니다.
+     */
+    list(params?: {
+        channel?: BlockedChannel;
+        number?: string;
+        status?: BlockedRecipientStatus;
+        page?: number;
+        pageSize?: number;
+    }, options?: RequestOptions$1): Promise<Page<BlockedRecipient>>;
+    /** 항목 상세를 조회합니다. 해제된 항목도 이력으로 남아 조회됩니다(`active: false`). */
+    retrieve(blockId: string, options?: RequestOptions$1): Promise<BlockedRecipient>;
+    /**
+     * 메모를 수정합니다.
+     *
+     * 번호와 채널은 바꿀 수 없습니다 — 바꾸면 "누가 무엇을 언제 거부했는가"라는 증빙이
+     * 뒤틀립니다. 잘못 등록했다면 해제한 뒤 올바른 번호로 새로 등록하세요.
+     */
+    update(blockId: string, params?: {
+        note?: string | null;
+    }, options?: RequestOptions$1): Promise<BlockedRecipient>;
+    /**
+     * 수신거부를 해제해 다시 발신할 수 있게 합니다.
+     *
+     * **항목은 삭제되지 않습니다.** `active` 가 false 가 되고 `unblockedAt` 이 기록될 뿐,
+     * 행은 이력으로 남습니다 — 언제 거부했고 언제 풀렸는지가 곧 증빙이기 때문입니다.
+     * 해제분은 `list({ status: 'released' })` 로 볼 수 있습니다.
+     *
+     * 이미 해제된 항목에 다시 호출해도 성공하며, 최초 해제 시각은 덮어쓰지 않습니다.
+     */
+    release(blockId: string, params?: {
+        note?: string;
+    }, options?: RequestOptions$1): Promise<BlockedRecipient>;
+}
+
 declare const CallSchema: z.ZodObject<{
     callId: z.ZodString;
     /**
@@ -697,70 +838,156 @@ declare class Messages extends APIResource {
     }): Promise<Message>;
 }
 
+/**
+ * 착신 라우팅 모드.
+ *
+ * - `webhook`   : webhookUrl 의 VoiceML 이 처리.
+ * - `agent`     : agentId 의 매니지드 에이전트가 착신.
+ * - `callflow`  : callFlowId 의 콜 플로우(ARS)가 착신.
+ * - `forward`   : forwardTo(같은 계정 보유 번호)로 내부 착신전환.
+ * - `sip`       : sipEndpointId 의 라우트로 외부 PBX 다이얼.
+ * - `softphone` : sipCredentialId 의 등록 단말로 착신.
+ */
+declare const ROUTING_TYPES: readonly ["webhook", "sip", "softphone", "forward", "agent", "callflow"];
+type RoutingType = (typeof ROUTING_TYPES)[number];
 declare const PhoneNumberSchema: z.ZodObject<{
     number: z.ZodString;
+    numberType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    webhookUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    webhookMethod: z.ZodOptional<z.ZodNullable<z.ZodEnum<["POST", "GET"]>>>;
-    routingType: z.ZodOptional<z.ZodNullable<z.ZodEnum<["webhook", "sip", "softphone"]>>>;
+    routingType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    agentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    callFlowId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    forwardTo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     sipEndpointId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     sipCredentialId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    webhookUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    webhookMethod: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    webhookHeaders: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
+    callContextUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    statusCallback: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    statusCallbackEvents: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    dictionaryId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     createdAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
     number: z.ZodString;
+    numberType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    webhookUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    webhookMethod: z.ZodOptional<z.ZodNullable<z.ZodEnum<["POST", "GET"]>>>;
-    routingType: z.ZodOptional<z.ZodNullable<z.ZodEnum<["webhook", "sip", "softphone"]>>>;
+    routingType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    agentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    callFlowId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    forwardTo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     sipEndpointId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     sipCredentialId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    webhookUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    webhookMethod: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    webhookHeaders: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
+    callContextUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    statusCallback: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    statusCallbackEvents: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    dictionaryId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     createdAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
     number: z.ZodString;
+    numberType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     source: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    webhookUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    webhookMethod: z.ZodOptional<z.ZodNullable<z.ZodEnum<["POST", "GET"]>>>;
-    routingType: z.ZodOptional<z.ZodNullable<z.ZodEnum<["webhook", "sip", "softphone"]>>>;
+    routingType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    agentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    callFlowId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    forwardTo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     sipEndpointId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     sipCredentialId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    webhookUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    webhookMethod: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    webhookHeaders: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
+    callContextUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    statusCallback: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    statusCallbackEvents: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    dictionaryId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     createdAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.ZodTypeAny, "passthrough">>;
-type PhoneNumber = z.infer<typeof PhoneNumberSchema>;
+/**
+ * 전화번호. `routingType` 은 알려진 값에 자동완성이 뜨지만, 서버가 새 라우팅을 추가해도
+ * 파싱이 깨지지 않도록 임의의 문자열을 허용한다.
+ */
+type PhoneNumber = Omit<z.infer<typeof PhoneNumberSchema>, 'routingType'> & {
+    routingType?: RoutingType | (string & {}) | null;
+};
 type NumberListItem = PhoneNumber;
 type NumberUpdateResponse = PhoneNumber;
 
 interface NumberCreateParams {
+    /** 수신 전화 처리용 Webhook URL. */
     webhookUrl?: string;
+    /** Webhook 호출 HTTP 메서드. */
+    webhookMethod?: 'POST' | 'GET';
+    /** Webhook 호출 시 덧붙일 헤더. 키는 'X-' 로 시작해야 한다. */
+    webhookHeaders?: Record<string, string>;
+    /** 수신(inbound) 통화 상태 통지 URL. */
+    statusCallback?: string;
+    /** 구독할 상태 이벤트(공백 구분). 미지정 시 'initiated ringing answered completed'. */
+    statusCallbackEvents?: string;
 }
 interface NumberUpdateParams {
-    webhookUrl?: string;
-    webhookMethod?: 'POST' | 'GET';
-    /** inbound 라우팅: webhook | sip | softphone. */
-    routingType?: 'webhook' | 'sip' | 'softphone';
-    /** routingType='sip' 일 때 라우팅할 SipEndpoint id. */
+    /** 착신 라우팅 모드. */
+    routingType?: RoutingType;
+    /** routingType='agent' 일 때 필수. 같은 계정의 에이전트 id. */
+    agentId?: string | null;
+    /** routingType='callflow' 일 때 필수. 같은 계정의 콜 플로우 id. */
+    callFlowId?: string | null;
+    /** routingType='forward' 일 때 필수. 같은 계정이 보유한 번호. */
+    forwardTo?: string | null;
+    /** routingType='sip' 일 때 필수. SipEndpoint id. */
     sipEndpointId?: string | null;
-    /** routingType='softphone' 일 때 착신할 등록 SIP credential(단말) id. */
+    /** routingType='softphone' 일 때 필수. 등록 단말의 SIP credential id. */
     sipCredentialId?: string | null;
+    /** 수신 전화 처리용 Webhook URL. */
+    webhookUrl?: string;
+    /** Webhook 호출 HTTP 메서드. */
+    webhookMethod?: 'POST' | 'GET';
+    /** Webhook 호출 시 덧붙일 헤더. */
+    webhookHeaders?: Record<string, string> | null;
+    /** routingType='agent' 에서 통화별 컨텍스트를 조회할 endpoint. */
+    callContextUrl?: string | null;
+    /** 수신(inbound) 통화 상태 통지 URL. */
+    statusCallback?: string | null;
+    /** 구독할 상태 이벤트(공백 구분). */
+    statusCallbackEvents?: string | null;
+    /** 이 번호의 통화 전사에 적용할 받아쓰기 사전 id. */
+    dictionaryId?: string | null;
 }
 
+interface RequestOptions {
+    extraHeaders?: Record<string, string>;
+    extraQuery?: Record<string, unknown>;
+    timeout?: number;
+}
 declare class Numbers extends APIResource {
-    create(params?: {
-        webhookUrl?: string;
-    }, options?: {
-        extraHeaders?: Record<string, string>;
-        extraQuery?: Record<string, unknown>;
-        timeout?: number;
-    }): Promise<PhoneNumber>;
-    list(options?: {
-        extraHeaders?: Record<string, string>;
-        extraQuery?: Record<string, unknown>;
-        timeout?: number;
-    }): Promise<NumberListItem[]>;
-    update(number: string, params?: NumberUpdateParams, options?: {
-        extraHeaders?: Record<string, string>;
-        extraQuery?: Record<string, unknown>;
-        timeout?: number;
-    }): Promise<NumberUpdateResponse>;
+    /**
+     * 번호를 발급합니다. 번호 풀에서 자동으로 배정되며 어떤 번호가 나올지는 지정할 수 없습니다.
+     *
+     * 발급 직후 번호는 `routingType: "webhook"` 이고 `webhookUrl` 이 비어 있어, 그대로 두면
+     * 걸려온 전화가 거절됩니다. 이어서 `update()` 로 착신 라우팅을 지정하세요.
+     */
+    create(params?: NumberCreateParams, options?: RequestOptions): Promise<PhoneNumber>;
+    /**
+     * 등록된 번호 목록을 조회합니다. 페이지네이션과 필터가 없으며 보유한 번호가 한 번에 전부
+     * 반환됩니다.
+     */
+    list(options?: RequestOptions): Promise<NumberListItem[]>;
+    /**
+     * 번호 설정을 수정합니다. 착신 라우팅(webhook/agent/callflow/forward/sip/softphone)과
+     * webhook, 상태 통지, 받아쓰기 사전을 변경할 수 있습니다. 보낸 필드만 반영되고 생략한
+     * 필드는 유지됩니다.
+     *
+     * 라우팅을 바꾸면 다른 라우팅 필드는 서버에서 자동으로 비워집니다. `agent` 에서
+     * `webhook` 으로 되돌리면 `agentId` 가 null 이 되므로, 다시 `agent` 로 돌아갈 때
+     * `agentId` 를 새로 지정해야 합니다.
+     */
+    update(number: string, params?: NumberUpdateParams, options?: RequestOptions): Promise<NumberUpdateResponse>;
+    /**
+     * 번호를 반납합니다. 번호는 풀로 복귀하며 되돌릴 수 없습니다. 같은 번호를 다시
+     * 발급받는다는 보장이 없습니다.
+     */
     delete(number: string, options?: {
         extraHeaders?: Record<string, string>;
         timeout?: number;
@@ -989,6 +1216,7 @@ declare class AccountContext {
     get recordings(): Recordings;
     get webhookLogs(): WebhookLogs;
     get assignmentLinks(): AssignmentLinks;
+    get blockedRecipients(): BlockedRecipients;
 }
 
 declare class ClawOpsError extends Error {
@@ -1173,6 +1401,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 +1423,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, type RoutingType, 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-VKZ22VNA.js';
+export { APIConnectionError, APIError, APIResponseValidationError, APIStatusError, APITimeoutError, AgentConnectionError, AgentError, AuthenticationError, BadRequestError, ClawOpsError, ConflictError, InternalServerError, NotFoundError, PermissionDeniedError, RateLimitError, ServiceUnavailableError, UnprocessableEntityError, VERSION } from './chunk-VKZ22VNA.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(),
   /**
@@ -552,25 +670,53 @@ var Messages = class extends APIResource {
 };
 var PhoneNumberSchema = z.object({
   number: z.string(),
+  numberType: z.string().nullable().optional(),
   source: z.string().nullable().optional(),
-  webhookUrl: z.string().nullable().optional(),
-  webhookMethod: z.enum(["POST", "GET"]).nullable().optional(),
-  routingType: z.enum(["webhook", "sip", "softphone"]).nullable().optional(),
+  // routingType 은 enum 으로 좁히지 않는다. 좁히면 서버가 라우팅 종류를 늘렸을 때 그 번호가
+  // 섞인 목록 조회가 통째로 실패한다(0.28.0 까지의 실제 결함: 'agent' 로 라우팅된 번호
+  // 하나가 numbers.list() 전체를 깨뜨렸다).
+  routingType: z.string().nullable().optional(),
+  agentId: z.string().nullable().optional(),
+  callFlowId: z.string().nullable().optional(),
+  forwardTo: z.string().nullable().optional(),
   sipEndpointId: z.string().nullable().optional(),
   sipCredentialId: z.string().nullable().optional(),
+  webhookUrl: z.string().nullable().optional(),
+  webhookMethod: z.string().nullable().optional(),
+  webhookHeaders: z.record(z.string()).nullable().optional(),
+  callContextUrl: z.string().nullable().optional(),
+  statusCallback: z.string().nullable().optional(),
+  statusCallbackEvents: z.string().nullable().optional(),
+  dictionaryId: z.string().nullable().optional(),
   createdAt: 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 = z.object({ data: z.array(PhoneNumberSchema) }).passthrough();
     const result = await this._client._get(`${this._basePath}/numbers`, {
@@ -579,13 +725,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,
@@ -593,6 +756,10 @@ var Numbers = class extends APIResource {
       ...options
     });
   }
+  /**
+   * 번호를 반납합니다. 번호는 풀로 복귀하며 되돌릴 수 없습니다. 같은 번호를 다시
+   * 발급받는다는 보장이 없습니다.
+   */
   async delete(number, options = {}) {
     await this._client._delete(`${this._basePath}/numbers/${number}`, options);
   }
@@ -773,6 +940,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 +1015,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 +1029,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