@coventia/softphone 0.2.1 → 0.4.0

package/dist/{engine-BlQBo2Ys.d.cts → engine-CDdaSojx.d.cts}

@@ -1,4 +1,4 @@
-import { e as CallOptions, b as CallDirection, H as HangupReason, i as HoldOriginator, o as SoftphoneState, k as SoftphoneError } from './call-VKq1I8yP.cjs';
+import { e as CallOptions, b as CallDirection, H as HangupReason, i as HoldOriginator, w as SoftphoneState, s as SoftphoneError } from './call-C6YpT6uR.cjs';
 
 /**
  * The `CallEngine` seam — INTERNAL, not exported from src/index.ts.

package/dist/{engine-C0BOkIcW.d.ts → engine-DPft99Wj.d.ts}

@@ -1,4 +1,4 @@
-import { e as CallOptions, b as CallDirection, H as HangupReason, i as HoldOriginator, o as SoftphoneState, k as SoftphoneError } from './call-VKq1I8yP.js';
+import { e as CallOptions, b as CallDirection, H as HangupReason, i as HoldOriginator, w as SoftphoneState, s as SoftphoneError } from './call-C6YpT6uR.js';
 
 /**
  * The `CallEngine` seam — INTERNAL, not exported from src/index.ts.

package/dist/index.cjs

@@ -110,9 +110,9 @@ function createRequest(config, method) {
     });
     const body = await res.json().catch(() => null);
     const message = body?.message ?? `${path} \u2014 HTTP ${res.status}`;
-    if (!res.ok) throw new ApiError(res.status, message);
+    if (!res.ok) throw new ApiError(res.status, message, body);
     if (body?.success === false) {
-      throw new ApiError(res.status, message);
+      throw new ApiError(res.status, message, body);
     }
     return body;
   }
@@ -138,15 +138,32 @@ var init_api = __esm({
     init_token_cache();
     ApiError = class extends Error {
       status;
-      constructor(status, message) {
+      body;
+      constructor(status, message, body = null) {
         super(message);
         this.name = "ApiError";
         this.status = status;
+        this.body = body;
       }
     };
   }
 });
 
+// src/core/outbound-numbers.ts
+function isOutboundNumberRefused(value) {
+  const refusal = value?.refusal;
+  return value instanceof Error && !!refusal && (refusal.reason === "platform" || refusal.reason === "user") && typeof refusal.retryAfterSeconds === "number";
+}
+function outboundNumberRefused(refusal) {
+  const error = new Error(`Outbound number change refused (${refusal.reason}); retry in ${refusal.retryAfterSeconds}s`);
+  error.name = "OutboundNumberRefused";
+  return Object.assign(error, { refusal });
+}
+var init_outbound_numbers = __esm({
+  "src/core/outbound-numbers.ts"() {
+  }
+});
+
 // src/coventia/sources.ts
 var sources_exports = {};
 __export(sources_exports, {
@@ -228,6 +245,8 @@ function coventiaSources(config) {
         // row's `called_did` is the OTHER party (already `number` above); showing it again as "DID"
         // would just repeat the row under a wrong label.
         ...toDirection(row.direction) === "inbound" && row.called_did ? { did: row.called_did } : {},
+        // And the other way round: which of the org's numbers an outbound call showed.
+        ...toDirection(row.direction) === "outbound" && row.from_number ? { from: row.from_number } : {},
         recorded,
         handledBy,
         // The detail page's one enrichment fetch — signed recording URLs, plus this SAME chain with
@@ -331,6 +350,118 @@ function coventiaSources(config) {
       })();
     });
   };
+  const fileBase = config.baseUrl.replace(/\/+$/, "");
+  const toLoop = (l) => l && Number.isFinite(l.start) && Number.isFinite(l.end) && l.start >= 0 && l.end > l.start ? { start: l.start, end: l.end } : null;
+  const toRingtoneSettings = (body) => {
+    const catalogue = (body.catalogue ?? []).map((r) => ({
+      id: r.id,
+      name: r.name,
+      url: r.path ? `${fileBase}${r.path}` : null,
+      loop: r.path ? toLoop(r.loop) : null
+    }));
+    const builtIn = catalogue.find((r) => r.url === null)?.id ?? "clasico";
+    const effective = catalogue.some((r) => r.id === body.effective) ? body.effective : builtIn;
+    return { catalogue, orgDefault: body.orgDefault ?? null, mine: body.user ?? null, effective };
+  };
+  const CACHE_PREFIX = "coventia-softphone:ringtones:";
+  const cacheKey = async (prefix = CACHE_PREFIX) => {
+    try {
+      const { identity } = await config.tokenSource.getToken();
+      return `${prefix}${fileBase}|${config.organizationId ?? "-"}|${identity}`;
+    } catch {
+      return null;
+    }
+  };
+  const remember = async (settings) => {
+    const key = await cacheKey();
+    try {
+      if (key) globalThis.localStorage?.setItem(key, JSON.stringify(settings));
+    } catch {
+    }
+    return settings;
+  };
+  const recall = async () => {
+    const key = await cacheKey();
+    try {
+      const raw = key ? globalThis.localStorage?.getItem(key) : null;
+      const s = raw ? JSON.parse(raw) : null;
+      const ok = s && Array.isArray(s.catalogue) && s.catalogue.every((r) => typeof r?.id === "string" && typeof r.name === "string" && (r.url === null || typeof r.url === "string")) && s.catalogue.some((r) => r.id === s.effective);
+      return ok ? { ...s, catalogue: s.catalogue.map((r) => ({ ...r, loop: toLoop(r.loop) })) } : null;
+    } catch {
+      return null;
+    }
+  };
+  const ringtones = {
+    get: async (signal) => remember(toRingtoneSettings(await get(`${base}/ringtones`, org, signal))),
+    // `null` clears: the empty id is dropped from the query by the request helper, and the backend reads a
+    // missing `ringtone_id` as "clear".
+    setMine: async (id) => remember(
+      toRingtoneSettings(await post(`${base}/ringtones/user`, { ...org, ringtone_id: id ?? "" }))
+    ),
+    cached: recall
+  };
+  const KINDS = /* @__PURE__ */ new Set(["landline", "mobile", "commercial", "other"]);
+  const STATES = /* @__PURE__ */ new Set(["applied", "pending", "failed", "unassigned"]);
+  const toOutboundSettings = (body) => {
+    const numbers = (body.numbers ?? []).map((n) => ({
+      id: n.id,
+      number: n.number,
+      label: n.label ?? null,
+      kind: KINDS.has(n.kind ?? "") ? n.kind : "other"
+    }));
+    const known = (id) => id && numbers.some((n) => n.id === id) ? id : null;
+    return {
+      numbers,
+      orgDefault: body.orgDefault ?? null,
+      mine: known(body.mine),
+      // Defensive: a malformed answer naming a number that is not in the list reads as the org default.
+      effective: known(body.effective) ?? known(body.orgDefault),
+      extension: body.extension ?? null,
+      state: STATES.has(body.state ?? "") ? body.state : "applied",
+      changeAvailableInSeconds: Math.max(0, Math.ceil(Number(body.changeAvailableInSeconds) || 0))
+    };
+  };
+  const OUTBOUND_PREFIX = "coventia-softphone:outbound-number:";
+  const rememberOutbound = async (settings) => {
+    const key = await cacheKey(OUTBOUND_PREFIX);
+    try {
+      if (key) globalThis.localStorage?.setItem(key, JSON.stringify(settings));
+    } catch {
+    }
+    return settings;
+  };
+  const recallOutbound = async () => {
+    const key = await cacheKey(OUTBOUND_PREFIX);
+    try {
+      const raw = key ? globalThis.localStorage?.getItem(key) : null;
+      const s = raw ? JSON.parse(raw) : null;
+      const ok = s && Array.isArray(s.numbers) && s.numbers.every((n) => typeof n?.id === "string" && typeof n.number === "string") && (s.effective === null || s.numbers.some((n) => n.id === s.effective));
+      return ok ? { ...s, changeAvailableInSeconds: 0 } : null;
+    } catch {
+      return null;
+    }
+  };
+  const outboundNumbers = {
+    get: async (signal) => rememberOutbound(toOutboundSettings(await get(`${base}/outbound-numbers`, org, signal))),
+    // `null` = back to the org default: the empty id is dropped from the query, which the backend reads that way.
+    setMine: async (id) => {
+      try {
+        return rememberOutbound(
+          toOutboundSettings(await post(`${base}/outbound-numbers/user`, { ...org, did_id: id ?? "" }))
+        );
+      } catch (error) {
+        const body = error instanceof ApiError ? error.body : null;
+        if (error instanceof ApiError && error.status === 429 && body?.code === "rate_limited") {
+          throw outboundNumberRefused({
+            reason: body.reason === "user" ? "user" : "platform",
+            retryAfterSeconds: Math.max(1, Math.ceil(Number(body.retryAfterSeconds) || 1))
+          });
+        }
+        throw error;
+      }
+    },
+    cached: recallOutbound
+  };
   const contacts = config.contacts ?? coventiaContacts;
   const resolve = config.resolveContact ?? (config.contacts ? resolverFromContacts(config.contacts) : coventiaResolve);
   const history = withNameResolution(rawHistory, resolve);
@@ -342,7 +473,9 @@ function coventiaSources(config) {
     resolveContact: resolve,
     listAgents: coventiaListAgents,
     transferOutcomes,
-    presence
+    presence,
+    ringtones,
+    outboundNumbers
   };
 }
 var toContact, toDirection, otherParty, isMissed, toOutcome, toDate, toTransferOutcome, toPresenceState, toPresenceEntry, toWebSocketUrl;
@@ -350,6 +483,7 @@ var init_sources2 = __esm({
   "src/coventia/sources.ts"() {
     init_sources();
     init_api();
+    init_outbound_numbers();
     toContact = (row) => ({
       id: row.wa_id,
       name: row.name,
@@ -2006,7 +2140,17 @@ function coventiaBackend(config, tokenSource, fallbackBaseUrl) {
     resolveContact: async (number) => (await load()).resolveContact(number),
     listAgents: async () => (await load()).listAgents(),
     transferOutcomes: async (params) => (await load()).transferOutcomes(params),
-    presence: async (callbacks) => (await load()).presence(callbacks)
+    presence: async (callbacks) => (await load()).presence(callbacks),
+    ringtones: {
+      get: async (signal) => (await load()).ringtones.get(signal),
+      setMine: async (id) => (await load()).ringtones.setMine(id),
+      cached: async () => (await load()).ringtones.cached?.() ?? null
+    },
+    outboundNumbers: {
+      get: async (signal) => (await load()).outboundNumbers.get(signal),
+      setMine: async (id) => (await load()).outboundNumbers.setMine(id),
+      cached: async () => (await load()).outboundNumbers.cached?.() ?? null
+    }
   };
 }
 
@@ -2229,13 +2373,30 @@ var BrowserAudioDevices = class {
   outputs = [];
   currentInputId = null;
   currentOutputId = null;
+  currentRingtoneOutputId = null;
   canSelectOutput;
+  canSelectRingtoneOutput;
   #engine;
   #onChange;
+  /**
+   * What the user CHOSE, remembered across reloads — distinct from the `current*` fields, which are
+   * what is usable right now. Keeping them apart is what stops a fresh page load from wiping a saved
+   * choice: until the microphone has been granted, Chrome enumerates every device with a blank id, so
+   * "is the saved device in the list?" is no on every first enumeration. The preference survives
+   * that; `current*` simply reads `null` until the device is really there.
+   */
+  #preferred;
+  /** The input the engine was last told about — it starts on the system default (`null`). */
+  #engineInputId = null;
   constructor(engine, onChange) {
     this.#engine = engine;
     this.#onChange = onChange;
     this.canSelectOutput = isBrowser() && typeof HTMLMediaElement !== "undefined" && "setSinkId" in HTMLMediaElement.prototype;
+    this.canSelectRingtoneOutput = this.canSelectOutput;
+    this.#preferred = readStoredDevices();
+    this.currentInputId = this.#preferred.input;
+    this.currentOutputId = this.#preferred.output;
+    this.currentRingtoneOutputId = this.#preferred.ringtone;
     if (isBrowser() && navigator.mediaDevices) {
       void this.refresh();
       navigator.mediaDevices.addEventListener?.("devicechange", () => void this.refresh());
@@ -2251,26 +2412,63 @@ var BrowserAudioDevices = class {
     }
     this.inputs = all.filter((d) => d.kind === "audioinput");
     this.outputs = all.filter((d) => d.kind === "audiooutput");
-    if (this.currentInputId && !this.inputs.some((d) => d.deviceId === this.currentInputId)) {
-      this.currentInputId = null;
-    }
-    if (this.currentOutputId && !this.outputs.some((d) => d.deviceId === this.currentOutputId)) {
-      this.currentOutputId = null;
-    }
+    this.currentInputId = usable(this.#preferred.input, this.inputs);
+    this.currentOutputId = usable(this.#preferred.output, this.outputs);
+    this.currentRingtoneOutputId = usable(this.#preferred.ringtone, this.outputs);
     this.#onChange();
+    if (this.currentInputId && this.currentInputId !== this.#engineInputId) {
+      await this.#tellEngine(this.currentInputId);
+    }
   }
   async setInput(deviceId) {
     this.currentInputId = deviceId;
+    this.#remember({ input: deviceId });
     this.#onChange();
+    await this.#tellEngine(deviceId);
+  }
+  async #tellEngine(deviceId) {
+    this.#engineInputId = deviceId;
     await this.#engine.setInputDevice?.(deviceId);
   }
   async setOutput(deviceId) {
     this.currentOutputId = deviceId;
+    this.#remember({ output: deviceId });
     this.#onChange();
   }
-  async setRingtoneOutput() {
+  async setRingtoneOutput(deviceId) {
+    this.currentRingtoneOutputId = deviceId;
+    this.#remember({ ringtone: deviceId });
+    this.#onChange();
+  }
+  #remember(patch) {
+    this.#preferred = { ...this.#preferred, ...patch };
+    writeStoredDevices(this.#preferred);
   }
 };
+var DEVICES_KEY = "coventia-softphone:devices";
+var NO_DEVICES = { input: null, output: null, ringtone: null };
+function usable(id, list) {
+  return id && list.some((d) => d.deviceId === id) ? id : null;
+}
+function readStoredDevices() {
+  if (!isBrowser()) return NO_DEVICES;
+  try {
+    const raw = JSON.parse(globalThis.localStorage?.getItem(DEVICES_KEY) ?? "null");
+    if (!raw || typeof raw !== "object") return NO_DEVICES;
+    const pick = (v) => typeof v === "string" && v ? v : null;
+    const r = raw;
+    return { input: pick(r.input), output: pick(r.output), ringtone: pick(r.ringtone) };
+  } catch {
+    return NO_DEVICES;
+  }
+}
+function writeStoredDevices(devices) {
+  if (!isBrowser()) return;
+  try {
+    globalThis.localStorage?.setItem(DEVICES_KEY, JSON.stringify(devices));
+  } catch {
+  }
+}
 var SoftphoneImpl = class extends Emitter {
   #state = "stopped";
   #lastError = null;
@@ -2674,7 +2872,8 @@ function isCallEngine(value) {
 
 // src/index.ts
 init_errors();
-var VERSION = "0.2.1";
+init_outbound_numbers();
+var VERSION = "0.4.0";
 
 exports.CALL_TRANSITIONS = CALL_TRANSITIONS;
 exports.CallEvent = CallEvent;
@@ -2685,6 +2884,7 @@ exports.canTransition = canTransition;
 exports.createSoftphone = createSoftphone;
 exports.isBrowser = isBrowser;
 exports.isFatal = isFatal;
+exports.isOutboundNumberRefused = isOutboundNumberRefused;
 exports.isTerminal = isTerminal;
 exports.isWebRtcSupported = isWebRtcSupported;
 //# sourceMappingURL=index.cjs.map