@teamlearners/clawops 0.15.0 → 0.16.0

package/dist/index.cjs

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var chunkENZ4B3I7_cjs = require('./chunk-ENZ4B3I7.cjs');
+var chunkD25IRY5V_cjs = require('./chunk-D25IRY5V.cjs');
 var zod = require('zod');
 var crypto = require('crypto');
 
@@ -13,11 +13,11 @@ function validateBaseUrl(url) {
   try {
     parsed = new URL(url);
   } catch {
-    throw new chunkENZ4B3I7_cjs.ClawOpsError(`Invalid base_url: ${url}`);
+    throw new chunkD25IRY5V_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 chunkENZ4B3I7_cjs.ClawOpsError(
+  throw new chunkD25IRY5V_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 ?? chunkENZ4B3I7_cjs.DEFAULT_BASE_URL).replace(/\/+$/, ""));
-    this._maxRetries = options.maxRetries ?? chunkENZ4B3I7_cjs.DEFAULT_MAX_RETRIES;
-    this._timeout = options.timeout ?? chunkENZ4B3I7_cjs.DEFAULT_TIMEOUT;
+    this._baseURL = validateBaseUrl((options.baseURL ?? chunkD25IRY5V_cjs.DEFAULT_BASE_URL).replace(/\/+$/, ""));
+    this._maxRetries = options.maxRetries ?? chunkD25IRY5V_cjs.DEFAULT_MAX_RETRIES;
+    this._timeout = options.timeout ?? chunkD25IRY5V_cjs.DEFAULT_TIMEOUT;
     this._fetch = options.fetch ?? globalThis.fetch;
     this._defaultHeaders = options.defaultHeaders ?? {};
   }
@@ -41,13 +41,13 @@ var APIClient = class {
       Authorization: `Bearer ${this._apiKey}`,
       "Content-Type": "application/json",
       Accept: "application/json",
-      "User-Agent": `claw-ops-node/${chunkENZ4B3I7_cjs.VERSION}`,
+      "User-Agent": `claw-ops-node/${chunkD25IRY5V_cjs.VERSION}`,
       ...this._defaultHeaders
     };
     if (extra) Object.assign(headers, extra);
     return headers;
   }
-  async _request(method2, path, options = {}) {
+  async _send(method2, path, options = {}) {
     const headers = this._buildHeaders(options.extraHeaders);
     const params = new URLSearchParams();
     const queryObj = { ...options.query, ...options.extraQuery };
@@ -77,33 +77,18 @@ var APIClient = class {
             await this._sleep(this._retryDelay(this._maxRetries - retriesLeft));
             continue;
           }
-          throw new chunkENZ4B3I7_cjs.APITimeoutError({ method: method2, url });
+          throw new chunkD25IRY5V_cjs.APITimeoutError({ method: method2, url });
         }
         if (retriesLeft > 0) {
           retriesLeft--;
           await this._sleep(this._retryDelay(this._maxRetries - retriesLeft));
           continue;
         }
-        throw new chunkENZ4B3I7_cjs.APIConnectionError({ method: method2, url });
+        throw new chunkD25IRY5V_cjs.APIConnectionError({ method: method2, url });
       } finally {
         clearTimeout(timeoutId);
       }
-      if (response.ok) {
-        if (response.status === 204 || !options.castTo) {
-          return null;
-        }
-        let json;
-        try {
-          json = await response.json();
-        } catch {
-          throw new chunkENZ4B3I7_cjs.APIResponseValidationError({ status: response.status }, { method: method2, url });
-        }
-        const parsed = options.castTo.safeParse(json);
-        if (!parsed.success) {
-          throw new chunkENZ4B3I7_cjs.APIResponseValidationError({ status: response.status }, { method: method2, url });
-        }
-        return parsed.data;
-      }
+      if (response.ok) return response;
       if (retriesLeft > 0 && this._shouldRetry(response.status)) {
         retriesLeft--;
         await this._sleep(this._retryDelay(this._maxRetries - retriesLeft));
@@ -115,14 +100,30 @@ var APIClient = class {
       } catch {
         body = null;
       }
-      throw chunkENZ4B3I7_cjs.makeStatusError(response.status, body, response.headers, { method: method2, url });
+      throw chunkD25IRY5V_cjs.makeStatusError(response.status, body, response.headers, { method: method2, url });
     }
   }
+  async _request(method2, path, options = {}) {
+    const response = await this._send(method2, path, options);
+    if (response.status === 204 || !options.castTo) return null;
+    const url = `${this._baseURL}${path}`;
+    let json;
+    try {
+      json = await response.json();
+    } catch {
+      throw new chunkD25IRY5V_cjs.APIResponseValidationError({ status: response.status }, { method: method2, url });
+    }
+    const parsed = options.castTo.safeParse(json);
+    if (!parsed.success) {
+      throw new chunkD25IRY5V_cjs.APIResponseValidationError({ status: response.status }, { method: method2, url });
+    }
+    return parsed.data;
+  }
   _shouldRetry(status) {
     return status === 408 || status === 409 || status === 429 || status >= 500;
   }
   _retryDelay(retriesTaken) {
-    const delay = Math.min(chunkENZ4B3I7_cjs.INITIAL_RETRY_DELAY * 2 ** retriesTaken, chunkENZ4B3I7_cjs.MAX_RETRY_DELAY);
+    const delay = Math.min(chunkD25IRY5V_cjs.INITIAL_RETRY_DELAY * 2 ** retriesTaken, chunkD25IRY5V_cjs.MAX_RETRY_DELAY);
     return delay * (1 + Math.random());
   }
   _sleep(ms) {
@@ -140,6 +141,9 @@ var APIClient = class {
     const result = await this._request("PUT", path, options);
     return result;
   }
+  async _getRaw(path, options = {}) {
+    return this._send("GET", path, options);
+  }
   async _delete(path, options = {}) {
     await this._request("DELETE", path, options);
   }
@@ -236,6 +240,74 @@ var Page = class _Page {
     }
   }
 };
+var AssignmentLinkAssignmentSchema = zod.z.object({
+  number: zod.z.string(),
+  name: zod.z.string().nullable().optional(),
+  consumedAt: zod.z.string(),
+  releasedAt: zod.z.string().nullable().optional()
+}).passthrough();
+var AssignmentLinkSchema = zod.z.object({
+  linkId: zod.z.string(),
+  url: zod.z.string(),
+  status: zod.z.enum(["pending", "consumed", "expired", "revoked"]),
+  createdAt: zod.z.string(),
+  expiresAt: zod.z.string(),
+  consumedAt: zod.z.string().nullable().optional(),
+  webhookUrl: zod.z.string().nullable().optional(),
+  webhookMethod: zod.z.enum(["POST", "GET"]).nullable().optional(),
+  note: zod.z.string().nullable().optional(),
+  assignment: AssignmentLinkAssignmentSchema.nullable().optional()
+}).passthrough();
+var AssignmentLinkCreateResponseSchema = zod.z.object({
+  token: zod.z.string(),
+  url: zod.z.string(),
+  expiresAt: zod.z.string()
+}).passthrough();
+
+// src/resources/assignment-links.ts
+var AssignmentLinks = class extends APIResource {
+  async create(params = {}, options = {}) {
+    const body = stripNotGiven({
+      webhookUrl: params.webhookUrl,
+      webhookMethod: params.webhookMethod,
+      note: params.note
+    });
+    return this._client._post(`${this._basePath}/assignment-links`, {
+      body: Object.keys(body).length ? body : void 0,
+      castTo: AssignmentLinkCreateResponseSchema,
+      ...options
+    });
+  }
+  async list(params = {}, options = {}) {
+    const query = stripNotGiven({
+      status: params.status,
+      page: params.page,
+      pageSize: params.pageSize
+    });
+    const path = `${this._basePath}/assignment-links`;
+    const schema = PageSchema(AssignmentLinkSchema);
+    const raw = await this._client._get(path, {
+      castTo: schema,
+      query: Object.keys(query).length ? query : void 0,
+      ...options
+    });
+    const page = new Page(raw.data, raw.meta);
+    page._setClient(this._client, path, AssignmentLinkSchema, query);
+    return page;
+  }
+  async retrieve(linkId, options = {}) {
+    return this._client._get(`${this._basePath}/assignment-links/${linkId}`, {
+      castTo: AssignmentLinkSchema,
+      ...options
+    });
+  }
+  async revoke(linkId, options = {}) {
+    await this._client._delete(
+      `${this._basePath}/assignment-links/${linkId}`,
+      options
+    );
+  }
+};
 var CallSchema = zod.z.object({
   callId: zod.z.string(),
   status: zod.z.enum(["queued", "ringing", "in-progress", "completed", "failed"]),
@@ -243,6 +315,7 @@ var CallSchema = zod.z.object({
   from: zod.z.string(),
   direction: zod.z.enum(["outbound", "inbound"]),
   duration: zod.z.number().nullable().optional(),
+  recordingUrl: zod.z.string().nullable().optional(),
   accountId: zod.z.string(),
   dateCreated: zod.z.string(),
   dateUpdated: zod.z.string().nullable().optional()
@@ -487,6 +560,44 @@ var Numbers = class extends APIResource {
     await this._client._delete(`${this._basePath}/numbers/${number}`, options);
   }
 };
+
+// src/resources/recordings.ts
+function parseFilename(disposition) {
+  if (!disposition) return null;
+  const star = disposition.match(/filename\*=(?:[\w-]+'[^']*')?([^;]+)/i);
+  if (star) {
+    try {
+      return decodeURIComponent(star[1].trim());
+    } catch {
+    }
+  }
+  const quoted = disposition.match(/filename="([^"]+)"/i);
+  if (quoted) return quoted[1].trim();
+  const bare = disposition.match(/filename=([^;]+)/i);
+  return bare ? bare[1].trim() : null;
+}
+var Recordings = class extends APIResource {
+  /**
+   * 통화 녹음(WAV)을 다운로드합니다.
+   *
+   * 콘솔과 동일한 서버측 MixMonitor 원본 (PCM 16bit mono 8kHz).
+   *
+   * @throws NotFoundError (404) — 통화가 없거나 녹음이 없음(`recordingUrl: null`).
+   * @throws PermissionDeniedError (403) — accountId 불일치.
+   */
+  async download(callId, options = {}) {
+    const response = await this._client._getRaw(
+      `${this._basePath}/recordings/${callId}`,
+      options
+    );
+    const data = await response.arrayBuffer();
+    return {
+      data,
+      contentType: response.headers.get("content-type") ?? "audio/wav",
+      filename: parseFilename(response.headers.get("content-disposition"))
+    };
+  }
+};
 var WebhookLogSchema = zod.z.object({
   id: zod.z.string(),
   webhookId: zod.z.string(),
@@ -537,11 +648,17 @@ var AccountContext = class {
   get numbers() {
     return new Numbers(this._client, this._accountId);
   }
+  get recordings() {
+    return new Recordings(this._client, this._accountId);
+  }
   get webhookLogs() {
     return new WebhookLogs(this._client, this._accountId);
   }
+  get assignmentLinks() {
+    return new AssignmentLinks(this._client, this._accountId);
+  }
 };
-var WebhookVerificationError = class extends chunkENZ4B3I7_cjs.ClawOpsError {
+var WebhookVerificationError = class extends chunkD25IRY5V_cjs.ClawOpsError {
   constructor(message = "Webhook \uC11C\uBA85\uC774 \uC77C\uCE58\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.") {
     super(message);
     this.name = "WebhookVerificationError";
@@ -571,13 +688,13 @@ var ClawOps = class extends APIClient {
   constructor(options = {}) {
     let apiKey = options.apiKey ?? process.env.CLAWOPS_API_KEY;
     if (!apiKey) {
-      throw new chunkENZ4B3I7_cjs.ClawOpsError("apiKey\uB97C \uC9C0\uC815\uD558\uAC70\uB098 CLAWOPS_API_KEY \uD658\uACBD\uBCC0\uC218\uB97C \uC124\uC815\uD558\uC138\uC694.");
+      throw new chunkD25IRY5V_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 chunkENZ4B3I7_cjs.ClawOpsError("accountId\uB97C \uC9C0\uC815\uD558\uAC70\uB098 CLAWOPS_ACCOUNT_ID \uD658\uACBD\uBCC0\uC218\uB97C \uC124\uC815\uD558\uC138\uC694.");
+      throw new chunkD25IRY5V_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 ?? chunkENZ4B3I7_cjs.DEFAULT_BASE_URL;
+    const baseURL = options.baseURL ?? process.env.CLAWOPS_BASE_URL ?? chunkD25IRY5V_cjs.DEFAULT_BASE_URL;
     super({
       apiKey,
       baseURL,
@@ -597,9 +714,15 @@ var ClawOps = class extends APIClient {
   get numbers() {
     return new Numbers(this, this._defaultAccountId);
   }
+  get recordings() {
+    return new Recordings(this, this._defaultAccountId);
+  }
   get webhookLogs() {
     return new WebhookLogs(this, this._defaultAccountId);
   }
+  get assignmentLinks() {
+    return new AssignmentLinks(this, this._defaultAccountId);
+  }
   get webhooks() {
     return new Webhooks();
   }
@@ -613,83 +736,85 @@ var client_default_default = ClawOps;
 
 Object.defineProperty(exports, "APIConnectionError", {
   enumerable: true,
-  get: function () { return chunkENZ4B3I7_cjs.APIConnectionError; }
+  get: function () { return chunkD25IRY5V_cjs.APIConnectionError; }
 });
 Object.defineProperty(exports, "APIError", {
   enumerable: true,
-  get: function () { return chunkENZ4B3I7_cjs.APIError; }
+  get: function () { return chunkD25IRY5V_cjs.APIError; }
 });
 Object.defineProperty(exports, "APIResponseValidationError", {
   enumerable: true,
-  get: function () { return chunkENZ4B3I7_cjs.APIResponseValidationError; }
+  get: function () { return chunkD25IRY5V_cjs.APIResponseValidationError; }
 });
 Object.defineProperty(exports, "APIStatusError", {
   enumerable: true,
-  get: function () { return chunkENZ4B3I7_cjs.APIStatusError; }
+  get: function () { return chunkD25IRY5V_cjs.APIStatusError; }
 });
 Object.defineProperty(exports, "APITimeoutError", {
   enumerable: true,
-  get: function () { return chunkENZ4B3I7_cjs.APITimeoutError; }
+  get: function () { return chunkD25IRY5V_cjs.APITimeoutError; }
 });
 Object.defineProperty(exports, "AgentConnectionError", {
   enumerable: true,
-  get: function () { return chunkENZ4B3I7_cjs.AgentConnectionError; }
+  get: function () { return chunkD25IRY5V_cjs.AgentConnectionError; }
 });
 Object.defineProperty(exports, "AgentError", {
   enumerable: true,
-  get: function () { return chunkENZ4B3I7_cjs.AgentError; }
+  get: function () { return chunkD25IRY5V_cjs.AgentError; }
 });
 Object.defineProperty(exports, "AuthenticationError", {
   enumerable: true,
-  get: function () { return chunkENZ4B3I7_cjs.AuthenticationError; }
+  get: function () { return chunkD25IRY5V_cjs.AuthenticationError; }
 });
 Object.defineProperty(exports, "BadRequestError", {
   enumerable: true,
-  get: function () { return chunkENZ4B3I7_cjs.BadRequestError; }
+  get: function () { return chunkD25IRY5V_cjs.BadRequestError; }
 });
 Object.defineProperty(exports, "ClawOpsError", {
   enumerable: true,
-  get: function () { return chunkENZ4B3I7_cjs.ClawOpsError; }
+  get: function () { return chunkD25IRY5V_cjs.ClawOpsError; }
 });
 Object.defineProperty(exports, "ConflictError", {
   enumerable: true,
-  get: function () { return chunkENZ4B3I7_cjs.ConflictError; }
+  get: function () { return chunkD25IRY5V_cjs.ConflictError; }
 });
 Object.defineProperty(exports, "InternalServerError", {
   enumerable: true,
-  get: function () { return chunkENZ4B3I7_cjs.InternalServerError; }
+  get: function () { return chunkD25IRY5V_cjs.InternalServerError; }
 });
 Object.defineProperty(exports, "NotFoundError", {
   enumerable: true,
-  get: function () { return chunkENZ4B3I7_cjs.NotFoundError; }
+  get: function () { return chunkD25IRY5V_cjs.NotFoundError; }
 });
 Object.defineProperty(exports, "PermissionDeniedError", {
   enumerable: true,
-  get: function () { return chunkENZ4B3I7_cjs.PermissionDeniedError; }
+  get: function () { return chunkD25IRY5V_cjs.PermissionDeniedError; }
 });
 Object.defineProperty(exports, "RateLimitError", {
   enumerable: true,
-  get: function () { return chunkENZ4B3I7_cjs.RateLimitError; }
+  get: function () { return chunkD25IRY5V_cjs.RateLimitError; }
 });
 Object.defineProperty(exports, "ServiceUnavailableError", {
   enumerable: true,
-  get: function () { return chunkENZ4B3I7_cjs.ServiceUnavailableError; }
+  get: function () { return chunkD25IRY5V_cjs.ServiceUnavailableError; }
 });
 Object.defineProperty(exports, "UnprocessableEntityError", {
   enumerable: true,
-  get: function () { return chunkENZ4B3I7_cjs.UnprocessableEntityError; }
+  get: function () { return chunkD25IRY5V_cjs.UnprocessableEntityError; }
 });
 Object.defineProperty(exports, "VERSION", {
   enumerable: true,
-  get: function () { return chunkENZ4B3I7_cjs.VERSION; }
+  get: function () { return chunkD25IRY5V_cjs.VERSION; }
 });
 exports.APIClient = APIClient;
 exports.AccountContext = AccountContext;
+exports.AssignmentLinks = AssignmentLinks;
 exports.Calls = Calls;
 exports.ClawOps = ClawOps;
 exports.Messages = Messages;
 exports.Numbers = Numbers;
 exports.Page = Page;
+exports.Recordings = Recordings;
 exports.WebhookLogs = WebhookLogs;
 exports.WebhookVerificationError = WebhookVerificationError;
 exports.Webhooks = Webhooks;