@babelforce/manager-sdk 0.17.0 → 0.39.0

package/CHANGELOG.md

@@ -3,6 +3,146 @@
 All notable changes to `@babelforce/manager-sdk` are documented here. This project adheres to
 [Semantic Versioning](https://semver.org/).
 
+## 0.39.0
+
+- Refreshed the vendored manager API spec (richer endpoint descriptions/examples) and regenerated
+  the client. No operations added or removed — coverage stays at 397/397.
+- Schema corrections carried over from the refresh: the routing `number` field is now typed as a
+  phone-number reference (it previously aliased the application schema), agent-outbound telephony
+  settings have their own request-data type, and session-variable bodies are typed as string→value
+  maps.
+
+## 0.38.0
+
+- **BREAKING:** Removed the `apiKey` auth mode (the `X-Auth-Access-Id` / `X-Auth-Access-Token`
+  header pair). The babelforce API no longer accepts those headers.
+- Added a `clientCredentials` OAuth2 auth mode (`grant_type=client_credentials` against
+  `/oauth/token`, fetched lazily and refreshed transparently) as the server-to-server replacement.
+
+## 0.37.0
+
+- Complete manager API parity (356/356 operations; 397/397 across all specs). Final operations:
+  `users.me`/`users.getByEmail`, `prompts.uses`, `metrics.definitions`, `babeldesk.widgetSettings`,
+  and `applications.allLocalAutomations`. Re-enabled the `full` coverage gate. (`getMe` is
+  deprecated upstream but wrapped for completeness.)
+
+## 0.36.0
+
+- Add a new `system` resource for system/reference endpoints: `echo`, `ping`, `apiStatus`,
+  `serverTime`, `timezones`, `pushToken`, `tags`, `tagsByCategory`, `exportTemplates` — 9 new
+  operations.
+
+## 0.35.0
+
+- Extend `integrations` with the action catalog and execution: `listActions`, `listActionParams`,
+  `executeAction`, and `dispatchActionGet` — 4 new operations.
+
+## 0.34.0
+
+- Extend `queues` (`bulkUpdate`, `globalSelections`, `selections.setPriority`), `outbound`
+  (`getLead`, `listLeads`), `phonebook` (`bulkDelete`), and `numbers` (`update`) — 7 new
+  operations.
+
+## 0.33.0
+
+- Extend `calls` (`cancel`, `listQueued`, `queueCallback`, and `reporting.inboundSimpleAll`) and
+  `logs` (`enableLive`, `disableLive`, `write`) — 7 new operations.
+
+## 0.32.0
+
+- Extend `settings` with generic scope/key operations (`listAll`, `listInScope`, `clear`,
+  `clearInScope`, `clearAll`) and `applications` (`clone`, `bulkUpdate`, `listActions`,
+  `listErrors`) — 9 new operations.
+
+## 0.31.0
+
+- Extend `conversations` (`addEvent`, `open`, `close`, `firstEvent`, `latestEvent`, `allEvents`)
+  and `sms` (`send`, `delete`, `report`, `testInbound`) — 10 new operations.
+
+## 0.30.0
+
+- Extend `businesshours` (range `addRanges`/`listRanges`/`getRange`/`removeRange`,
+  `bulkUpdate`/`bulkDelete`) and `calendars` (individual-date `getDate`/`updateDate`/`removeDate`,
+  `testDate`, `bulkUpdate`/`bulkDelete`) — 12 new operations.
+
+## 0.29.0
+
+- Extend `agents` with bulk actions (`bulkAction`), CSV `export`/`import`/`validateImport` +
+  `getImportJob`, per-agent and global activity `logs`/`allLogs`, `push`, `updatePassword`, and
+  group membership (`groups.removeAgent`, `groups.listAgents`, `groups.bulkDelete`) — 12 new
+  operations.
+
+## 0.28.0
+
+- Extend `agents` with named presence CRUD (`presences`, `getPresence`, `createPresence`,
+  `updatePresence`, `deletePresence`), status reads (`getStatus`, `availableStatuses`), and
+  lifecycle controls (`enable`, `disable`, `hangupCall`) — 10 new operations.
+
+## 0.27.0
+
+- Extend `triggers` (expression/operator catalogs, `conditions`/`setConditions`, `uses`,
+  `bulkAction`), `automations` (`clone`, `dispatch`, `bulkUpdate`/`bulkDelete` of event triggers),
+  and `queues` (`listTriggers`) — 11 new operations.
+
+## 0.26.0
+
+- Extend `outbound` with outbound-list management (`getList`/`updateList`/`deleteList`),
+  lead/attempt browsing (`leads`/`processedLeads`/`attempts` + simple reporting),
+  `createAgentCall`, bulk lead deletion, and CSV lead uploads (11 new operations).
+
+## 0.25.0
+
+- Extend `campaigns` with realtime `status`/`statistics`, `hopper`, `leads`/`processedLeads`,
+  `attempts`, lead-list assignment (`getList`/`setList`/`setListById`/`unsetList`), and
+  `logoutAllAgents` (11 new operations).
+
+## 0.24.0
+
+- Extend `integrations` with the provider catalog, OAuth token management (`listTokens`,
+  `getToken`, `refreshToken`, `deleteToken`), `clone`, `authorize`, `integrate`, type actions
+  (`typeActions`, `dispatchTypeAction`), the API proxy (`apiProxyGet`/`apiProxyPost`), templates,
+  and bulk update/delete (16 new operations).
+
+## 0.23.0
+
+- Add the `recordings` resource (v2 manager API): `list`/`listAll`, `start`, `get`, `update`,
+  `delete`, `bulkAction`, plus recording flags (`getFlag`, `flag`, `unflag`, `toggleFlag`).
+
+## 0.22.0
+
+- Add the `dialer` resource (v2 manager API): `info`, `flush`, `simpleReporting` /
+  `simpleReportingAll` (auto-paginated dialer call report), plus a nested `dialer.behaviours`
+  sub-resource (CRUD).
+
+## 0.21.0
+
+- Add the `files` resource (v2 manager API): `list`/`listAll` (auto-paginated), `listByType`,
+  `backups`, `recordings`, `prompts`, `get`, `delete`, `download`, `bulkDelete`, `bulkDownload`,
+  `bulkDownloadPost`.
+
+## 0.20.0
+
+- Add the `dashboards` resource (v2 manager API): `list` / `listAll` (auto-paginated), `create`,
+  `get`, `update`, `delete`, plus dashboard-user access (`listUsers`, `addUser`, `removeUser`).
+
+## 0.19.0
+
+- Add the `auth` resource — the **OAuth 2.0** endpoints (`/oauth/authorize`, `/oauth/token`,
+  `/oauth/revoke`): `mgr.auth.token`, `mgr.auth.revoke`, `mgr.auth.authorize`. These authenticate
+  via client credentials in the request, independent of the SDK's api-key/bearer auth.
+
+## 0.18.0
+
+- **Refreshed the manager OpenAPI spec** (a large upstream expansion: 187 → 356 operations) and
+  **vendored the new `auth` (OAuth 2.0) spec**. The low-level generated clients now cover the new
+  surface; ergonomic facade methods for the new operations land in follow-up releases.
+- **Breaking — removed operations no longer in the spec:** `conversations.getEvent`,
+  `calls.reporting.simpleByType` / `simpleAllByType`, `metrics.push`, `metrics.reset`.
+- **Breaking — changed signatures:** `calendars.addDate(id, body)` now takes a `CalendarDateBody`
+  and returns `CalendarDateItemResponse`; `calendars.getDates` returns `CalendarDateListResponse`.
+- Coverage is tracked against the new 397-operation scope; the SDK currently wraps ~56% while the
+  newly-added operations are wrapped over the coming releases.
+
 ## 0.17.0
 
 - Extend `tasks` with `tasks.metrics` (task journal, agent journal, agent interaction durations),

package/README.md

@@ -22,7 +22,7 @@ ESM, ships with types. Node 18+ (for global `fetch`).
 import { ManagerClient } from "@babelforce/manager-sdk";
 
 const mgr = await ManagerClient.connect({
-  auth: { kind: "apiKey", accessId, accessToken }, // or { kind: "password", user, pass }
+  auth: { kind: "clientCredentials", clientId, clientSecret }, // or { kind: "password", user, pass }
   // baseUrl defaults to https://services.babelforce.com
 });
 
@@ -37,7 +37,8 @@ await mgr.users.enable(["new.user@acme.com"]);
 
 ### Authentication
 
-- `{ kind: "apiKey", accessId, accessToken }` — sends `X-Auth-Access-Id` / `X-Auth-Access-Token`.
+- `{ kind: "clientCredentials", clientId, clientSecret }` — recommended for server-to-server use;
+  OAuth2 client_credentials grant against `/oauth/token` with transparent refresh.
 - `{ kind: "bearer", token }` — a token you already hold.
 - `{ kind: "password", user, pass }` — OAuth2 password grant with transparent refresh.