@osmapi/osmtalk-sdk 0.2.0

package/dist/index.js

@@ -0,0 +1,450 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Osmtalk: () => Osmtalk,
+  OsmtalkError: () => OsmtalkError,
+  default: () => index_default,
+  verifyWebhookSignature: () => verifyWebhookSignature,
+  verifyWebhookSignatureAsync: () => verifyWebhookSignatureAsync
+});
+module.exports = __toCommonJS(index_exports);
+var OsmtalkError = class extends Error {
+  status;
+  body;
+  constructor(status, body) {
+    super(body?.error || body?.message || `osmTalk API error: ${status}`);
+    this.name = "OsmtalkError";
+    this.status = status;
+    this.body = body;
+  }
+};
+var HttpClient = class {
+  baseUrl;
+  apiKey;
+  timeoutMs;
+  fetchImpl;
+  constructor(opts) {
+    this.apiKey = opts.apiKey;
+    this.baseUrl = (opts.baseUrl ?? "https://api.osmtalk.com").replace(/\/$/, "");
+    this.timeoutMs = opts.timeoutMs ?? 3e4;
+    this.fetchImpl = opts.fetch ?? (typeof fetch !== "undefined" ? fetch.bind(globalThis) : void 0);
+    if (!this.fetchImpl) throw new Error("No fetch implementation available \u2014 provide one in OsmtalkOptions.fetch");
+    if (!opts.apiKey) throw new Error("apiKey is required");
+  }
+  async request(method, path, body, extraHeaders, idempotencyKey) {
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(), this.timeoutMs);
+    const headers = {
+      Authorization: `Bearer ${this.apiKey}`,
+      ...body !== void 0 ? { "Content-Type": "application/json" } : {},
+      ...idempotencyKey ? { "Idempotency-Key": idempotencyKey } : {},
+      ...extraHeaders ?? {}
+    };
+    let res;
+    try {
+      res = await this.fetchImpl(`${this.baseUrl}${path}`, {
+        method,
+        headers,
+        body: body === void 0 ? void 0 : typeof body === "string" ? body : JSON.stringify(body),
+        signal: ctrl.signal
+      });
+    } finally {
+      clearTimeout(timer);
+    }
+    const text = await res.text();
+    const parsed = text ? (() => {
+      try {
+        return JSON.parse(text);
+      } catch {
+        return text;
+      }
+    })() : null;
+    if (!res.ok) {
+      throw new OsmtalkError(res.status, parsed ?? { error: text });
+    }
+    return parsed;
+  }
+};
+var AgentsResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  list() {
+    return this.http.request("GET", "/api/agents");
+  }
+  get(id) {
+    return this.http.request("GET", `/api/agents/${id}`);
+  }
+  create(input) {
+    return this.http.request("POST", "/api/agents", input);
+  }
+  update(id, input) {
+    return this.http.request("PUT", `/api/agents/${id}`, input);
+  }
+  delete(id) {
+    return this.http.request("DELETE", `/api/agents/${id}`);
+  }
+  // Versioning
+  publishVersion(id, opts) {
+    return this.http.request(
+      "POST",
+      `/api/agents/${id}/versions`,
+      opts ?? {}
+    );
+  }
+  listVersions(id) {
+    return this.http.request(
+      "GET",
+      `/api/agents/${id}/versions`
+    );
+  }
+  getVersion(id, version) {
+    return this.http.request(
+      "GET",
+      `/api/agents/${id}/versions/${version}`
+    );
+  }
+  rollbackToVersion(id, version) {
+    return this.http.request(
+      "POST",
+      `/api/agents/${id}/versions/${version}/rollback`
+    );
+  }
+  // Connect (start a web voice session)
+  connect(id, opts) {
+    return this.http.request(
+      "POST",
+      `/api/agents/${id}/connect`,
+      opts ?? {}
+    );
+  }
+};
+var CallsResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  list() {
+    return this.http.request("GET", "/api/calls");
+  }
+  get(id) {
+    return this.http.request("GET", `/api/calls/${id}`);
+  }
+  /**
+   * Place an outbound call. Optionally pass `idempotencyKey` so retries
+   * within 24h return the same response instead of placing a duplicate call.
+   */
+  outbound(input, opts) {
+    return this.http.request(
+      "POST",
+      "/api/calls/outbound",
+      input,
+      void 0,
+      opts?.idempotencyKey
+    );
+  }
+  end(id) {
+    return this.http.request("POST", `/api/calls/${id}/end`);
+  }
+  transfer(id, destination, summary) {
+    return this.http.request("POST", `/api/calls/${id}/transfer`, { destination, summary });
+  }
+};
+var PlatformResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /** Live platform constants — USD-to-INR rate and the minimum charge per call. */
+  getRates() {
+    return this.http.request("GET", "/api/providers/rates");
+  }
+  /** Catalog of available LLM/STT/TTS providers + models. */
+  listProviders() {
+    return this.http.request("GET", "/api/providers");
+  }
+  /**
+   * Quality presets (Fast / Balanced / Premium) with live per-minute
+   * cost estimates derived from the same rate tables we bill with.
+   * `costEstimate.{low, typical, high}` are INR per minute and account
+   * for typical 250 / 900 / 2500 prompt-token usage patterns.
+   *
+   * @param channel "phone" (default) includes SIP minutes; "web" or
+   *                "chat" exclude SIP for cheaper web-only deployments.
+   */
+  getPresets(channel = "phone") {
+    return this.http.request("GET", `/api/providers/presets?channel=${channel}`);
+  }
+  /**
+   * Per-provider health snapshot. Cached server-side for 60s.
+   * Use this before launching a call to detect "sometimes works"
+   * provider issues (key revoked, region outage, ToS not accepted).
+   */
+  getModelHealth() {
+    return this.http.request(
+      "GET",
+      "/api/health/models"
+    );
+  }
+  /**
+   * Industry-organized agent templates (support, sales, healthcare,
+   * real-estate, etc.). When called with a valid session/API key, the
+   * response includes your org's custom-saved templates merged ahead
+   * of the built-ins; anonymous calls return built-ins only.
+   */
+  getTemplates(params) {
+    const qs = new URLSearchParams();
+    if (params?.category) qs.set("category", params.category);
+    if (params?.q) qs.set("q", params.q);
+    const suffix = qs.toString();
+    return this.http.request("GET", `/api/templates${suffix ? `?${suffix}` : ""}`);
+  }
+  getTemplate(id) {
+    return this.http.request("GET", `/api/templates/${encodeURIComponent(id)}`);
+  }
+  /** Save a custom template (org-scoped, requires auth). */
+  saveTemplate(data) {
+    return this.http.request("POST", "/api/templates", data);
+  }
+  deleteTemplate(id) {
+    return this.http.request(
+      "DELETE",
+      `/api/templates/${encodeURIComponent(id)}`
+    );
+  }
+};
+function verifyWebhookSignature(rawBody, signatureHeader, secret) {
+  if (!signatureHeader || !secret) return false;
+  const sig = Array.isArray(signatureHeader) ? signatureHeader[0] : signatureHeader;
+  if (typeof sig !== "string") return false;
+  const m = /^sha256=([0-9a-f]{64})$/i.exec(sig);
+  if (!m) return false;
+  const providedHex = m[1].toLowerCase();
+  try {
+    const isNode = !!globalThis.process?.versions?.node;
+    if (isNode) {
+      const req = new Function("return require")();
+      const nodeCrypto = req("node:crypto");
+      const expected = nodeCrypto.createHmac("sha256", secret).update(rawBody).digest("hex");
+      return timingSafeEqualHex(providedHex, expected);
+    }
+  } catch {
+  }
+  throw new Error(
+    "verifyWebhookSignature: node:crypto unavailable in this runtime; use verifyWebhookSignatureAsync() instead"
+  );
+}
+async function verifyWebhookSignatureAsync(rawBody, signatureHeader, secret) {
+  if (!signatureHeader || !secret) return false;
+  const sig = Array.isArray(signatureHeader) ? signatureHeader[0] : signatureHeader;
+  if (typeof sig !== "string") return false;
+  const m = /^sha256=([0-9a-f]{64})$/i.exec(sig);
+  if (!m) return false;
+  const providedHex = m[1].toLowerCase();
+  const enc = new TextEncoder();
+  const keyBytes = new Uint8Array(enc.encode(secret));
+  const key = await crypto.subtle.importKey(
+    "raw",
+    keyBytes,
+    { name: "HMAC", hash: "SHA-256" },
+    false,
+    ["sign"]
+  );
+  const body = typeof rawBody === "string" ? new Uint8Array(enc.encode(rawBody)) : new Uint8Array(rawBody);
+  const macBuf = await crypto.subtle.sign("HMAC", key, body);
+  const expected = Array.from(new Uint8Array(macBuf)).map((b) => b.toString(16).padStart(2, "0")).join("");
+  return timingSafeEqualHex(providedHex, expected);
+}
+function timingSafeEqualHex(a, b) {
+  if (a.length !== b.length) return false;
+  let diff = 0;
+  for (let i = 0; i < a.length; i++) diff |= a.charCodeAt(i) ^ b.charCodeAt(i);
+  return diff === 0;
+}
+var CampaignsResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  list(opts) {
+    const q = opts?.status ? `?status=${encodeURIComponent(opts.status)}` : "";
+    return this.http.request("GET", `/api/campaigns${q}`);
+  }
+  get(id) {
+    return this.http.request("GET", `/api/campaigns/${id}`);
+  }
+  create(input) {
+    return this.http.request("POST", "/api/campaigns", input);
+  }
+  update(id, input) {
+    return this.http.request("PUT", `/api/campaigns/${id}`, input);
+  }
+  delete(id) {
+    return this.http.request("DELETE", `/api/campaigns/${id}`);
+  }
+  start(id) {
+    return this.http.request("POST", `/api/campaigns/${id}/start`);
+  }
+  pause(id) {
+    return this.http.request("POST", `/api/campaigns/${id}/pause`);
+  }
+  resume(id) {
+    return this.http.request("POST", `/api/campaigns/${id}/resume`);
+  }
+  stop(id) {
+    return this.http.request("POST", `/api/campaigns/${id}/stop`);
+  }
+  report(id) {
+    return this.http.request("GET", `/api/campaigns/${id}/report`);
+  }
+  // Lead uploads
+  uploadLeadsCsv(id, csv) {
+    return this.http.request(
+      "POST",
+      `/api/campaigns/${id}/leads`,
+      csv,
+      { "Content-Type": "text/csv" }
+    );
+  }
+  uploadLeads(id, leads) {
+    return this.http.request(
+      "POST",
+      `/api/campaigns/${id}/leads`,
+      { leads }
+    );
+  }
+  listLeads(id, opts) {
+    const q = new URLSearchParams();
+    if (opts?.status) q.set("status", opts.status);
+    if (opts?.limit) q.set("limit", String(opts.limit));
+    if (opts?.offset) q.set("offset", String(opts.offset));
+    const suffix = q.toString() ? `?${q}` : "";
+    return this.http.request("GET", `/api/campaigns/${id}/leads${suffix}`);
+  }
+};
+var DncResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  list() {
+    return this.http.request("GET", "/api/campaigns/dnc");
+  }
+  add(phoneNumber, opts) {
+    return this.http.request("POST", "/api/campaigns/dnc", { phoneNumber, ...opts });
+  }
+  bulkAdd(entries) {
+    return this.http.request("POST", "/api/campaigns/dnc/bulk", { entries });
+  }
+  remove(id) {
+    return this.http.request("DELETE", `/api/campaigns/dnc/${id}`);
+  }
+};
+var EvalResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  simulate(agentId, mockTurns, opts) {
+    return this.http.request(
+      "POST",
+      `/api/agents/${agentId}/simulate`,
+      { mockTurns, ...opts }
+    );
+  }
+  createTestCase(agentId, input) {
+    return this.http.request("POST", `/api/agents/${agentId}/test-cases`, input);
+  }
+  listTestCases(agentId) {
+    return this.http.request("GET", `/api/agents/${agentId}/test-cases`);
+  }
+  runTestCase(agentId, testCaseId) {
+    return this.http.request("POST", `/api/agents/${agentId}/test-cases/${testCaseId}/run`);
+  }
+  runAll(agentId) {
+    return this.http.request(
+      "POST",
+      `/api/agents/${agentId}/eval`
+    );
+  }
+  listRuns(agentId) {
+    return this.http.request("GET", `/api/agents/${agentId}/eval/runs`);
+  }
+  getRun(runId) {
+    return this.http.request("GET", `/api/eval/runs/${runId}`);
+  }
+};
+var SettingsResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  get() {
+    return this.http.request("GET", "/api/settings");
+  }
+  getStorage() {
+    return this.http.request("GET", "/api/settings/storage");
+  }
+  updateStorage(input) {
+    return this.http.request("PUT", "/api/settings/storage", input);
+  }
+  getWebhook() {
+    return this.http.request("GET", "/api/settings/webhook");
+  }
+  updateWebhook(input) {
+    return this.http.request("PUT", "/api/settings/webhook", input);
+  }
+  getCompliance() {
+    return this.http.request("GET", "/api/settings/compliance");
+  }
+  updateCompliance(input) {
+    return this.http.request("PUT", "/api/settings/compliance", input);
+  }
+};
+var Osmtalk = class {
+  agents;
+  calls;
+  campaigns;
+  dnc;
+  eval;
+  settings;
+  platform;
+  constructor(opts) {
+    const http = new HttpClient(opts);
+    this.agents = new AgentsResource(http);
+    this.calls = new CallsResource(http);
+    this.campaigns = new CampaignsResource(http);
+    this.dnc = new DncResource(http);
+    this.eval = new EvalResource(http);
+    this.settings = new SettingsResource(http);
+    this.platform = new PlatformResource(http);
+  }
+};
+var index_default = Osmtalk;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Osmtalk,
+  OsmtalkError,
+  verifyWebhookSignature,
+  verifyWebhookSignatureAsync
+});