@ikatec/digisac-api-sdk 4.3.0 → 4.4.1

package/src/apis/contacts/types.ts

@@ -4,7 +4,7 @@ import type { Service } from '../services/types'
 import type { Tag } from '../tags/types'
 import type { Ticket } from '../tickets/types'
 import type { User } from '../users/types'
-import type { ListQuery } from '../../core/types'
+import type { IncludeItem, ListQuery, WhereClause } from '../../core/types'
 
 export type ContactStatus = 'online' | 'offline' | 'absent'
 export type ContactOrigin = 'api' | 'app' | 'campaign' | 'driver' | 'import' | 'web'
@@ -204,3 +204,156 @@ export type TransferTicketPayload = {
   kanbanCardSubject?: string
   initialMessage?: string
 }
+
+/**
+ * One item of `POST /contacts/many`. The backend matches existing contacts by service and
+ * number (or e-mail) and updates them; the others are created. Items repeating a number of
+ * the same batch are dropped (the first one wins).
+ */
+export type CreateManyContactsItem = {
+  serviceId: string
+  name: string
+  /** Phone number with country code, or the e-mail address for e-mail connections. */
+  number: string
+  internalName?: string
+  personId?: string
+  defaultDepartmentId?: string
+  defaultUserId?: string
+  tagIds?: string[]
+  /** When `true`, the given `tagIds` are merged into the existing ones instead of replacing them. */
+  mergeRelations?: boolean
+  /**
+   * Only `data.number` is read, as a fallback when `number` is empty; the backend rebuilds
+   * `data` from the number.
+   */
+  data?: {
+    number: string
+  }
+}
+
+/**
+ * Selects a set of contacts by filter. Used by `DELETE /contacts/many` and by the tag
+ * attach/detach routes. The backend always scopes the filter to the current account.
+ *
+ * `where` is required on purpose: the backend applies the operation to every contact the
+ * filter matches, so an empty filter would reach every contact of the account.
+ */
+export type ContactsSelection = {
+  where: WhereClause<Contact>
+  include?: IncludeItem<Contact>[]
+  customFilter?: Record<string, unknown>
+}
+
+/**
+ * CSV layout of the contact export and import, as in `exportTemplate`:
+ * - `'colon'`: `;` as the column delimiter (any other value uses `,`);
+ * - `'google'`: phone columns as DDI + Phone ("Telefone") instead of DDI + Number.
+ *
+ * E-mail and webchat connections ignore it for the contact columns (Email / Email + Number).
+ */
+export type ContactsCsvType = 'colon' | 'google' | (string & {})
+
+/** Body for `POST /contacts/export/csv`. */
+export type ExportCsvPayload = Omit<ListQuery<Contact>, 'page' | 'perPage'> & {
+  serviceType: string
+  type: ContactsCsvType
+}
+
+/**
+ * Body for `POST /contacts/import-contacts`. The CSV must be uploaded first (see `FilesApi`);
+ * the header line is checked against the template of the service type and language.
+ */
+export type ImportContactsPayload = {
+  service: Pick<Service, 'id' | 'accountId' | 'type'>
+  file: {
+    id: string
+    name: string
+    mimetype: string
+    /** Sent by the web app; the backend reads only `id`. */
+    urlToUpload?: string
+  }
+  csvHeaderLine: string[]
+  type: ContactsCsvType
+  tagsIds?: string[]
+  defaultDepartmentId?: string
+  defaultUserId?: string
+}
+
+/** Body for `POST /contacts/:id/block`. Blocking a contact closes its open ticket. */
+export type BlockContactPayload = {
+  block: boolean
+  byUserId?: string
+  description?: string
+}
+
+/** Body for `POST /contacts/:id/sync`. */
+export type SyncContactPayload = {
+  forceSync?: boolean
+}
+
+export type ContactMediaType = 'media' | 'document' | 'link'
+
+/**
+ * Query for `GET /contacts/:id/media`. Cursor-based: pass the previous page's `nextCursor`
+ * as `where.cursor`.
+ */
+export type ContactMediaQuery = {
+  where?: {
+    /** `'media'` = images and videos. Omitted = images, videos and documents. */
+    type?: ContactMediaType
+    /** Case-insensitive filter by file name (ignored for links). */
+    name?: string
+    cursor?: string
+  }
+  perPage?: number
+  order?: [string, 'ASC' | 'DESC' | 'asc' | 'desc'][]
+}
+
+/**
+ * One item of `GET /contacts/:id/media`. When the user cannot see the message, the
+ * identifying fields come as `'UNAUTHORIZED_MESSAGE'` and `isAuthorized` is `false`.
+ */
+export type ContactMediaItem = {
+  id: string
+  /** ID of the message that carries the file or link. */
+  attachedId: string
+  /** File name; absent for links. */
+  name?: string | null
+  /** Only for files. */
+  mimetype?: string
+  createdAt: string
+  updatedAt: string
+  accountId: string
+  url: string | null
+  /** Only for files (filled for videos). */
+  previewUrl?: string | null
+  isAuthorized: boolean
+  /** Only for `type: 'link'`. */
+  links?: string[]
+}
+
+export type ContactMediaPage = {
+  data: ContactMediaItem[]
+  limit: number
+  hasNextPage: boolean
+  nextCursor: string | null
+}
+
+/** Body for `POST /contacts/ticket/bulk-transfer`. */
+export type BulkTransferTicketsPayload = {
+  departmentId?: string
+  /** `null` removes the assigned user. */
+  userId?: string | null
+  comments?: string
+  /** IDs of the tickets to transfer. Ignored when `allContactsSelected` is `true`. */
+  ticketsSelectedId?: string[]
+  allContactsSelected?: boolean
+  /** Contact filter used with `allContactsSelected`. */
+  query?: ListQuery<Contact>
+}
+
+export type BulkTransferTicketsResult = {
+  message: string
+  /** IDs of the tickets actually transferred (the ones the target user can access). */
+  ticketsSelectedId: string[]
+}

package/src/apis/me/MeApi.test.ts

@@ -34,15 +34,15 @@ const user: User = {
   email: 'alice@example.com',
   phoneNumber: null,
   branch: null,
-  isSuperAdmin: false,
   isClientUser: false,
-  active: true,
   language: 'en',
   isFirstLogin: false,
   status: 'online',
   clientsStatus: null,
-  offlineAt: null,
   isActiveInternalChat: true,
+  internalChatToken: null,
+  noteReference: false,
+  data: {},
   passwordExpiresAt: null,
   otpAuthActive: false,
   preferences: {},

package/src/apis/messages/MessagesApi.test.ts

@@ -45,6 +45,17 @@ const message: Message = {
   obfuscated: false,
   reactionParentMessageId: null,
   hsmId: null,
+  isFromBot: false,
+  accountId: 'acc-1',
+  serviceId: 'svc-1',
+  contactId: 'ctt-1',
+  fromId: null,
+  toId: 'ctt-1',
+  userId: 'usr-1',
+  ticketId: 'tkt-1',
+  ticketUserId: 'usr-1',
+  ticketDepartmentId: 'dep-1',
+  quotedMessageId: null,
   createdAt: '2024-01-01T00:00:00Z',
   updatedAt: '2024-01-01T00:00:00Z',
   deletedAt: null,
@@ -85,7 +96,7 @@ describe('MessagesApi', () => {
     it('serializes query parameters', async () => {
       vi.mocked(client.get).mockResolvedValue(paginated)
       await api.getMany({ page: 2, perPage: 5 })
-      const url = vi.mocked(client.get).mock.calls[0][0] as string
+      const url = vi.mocked(client.get).mock.calls[0]?.[0] as string
       expect(url).toContain('/messages?')
       expect(decodeURIComponent(url)).toContain('"page":2')
       expect(decodeURIComponent(url)).toContain('"perPage":5')
@@ -382,7 +393,7 @@ describe('MessagesApi', () => {
     it('appends limit query parameter when provided', async () => {
       vi.mocked(client.get).mockResolvedValue({ outOfRange: true })
       await api.outOfRange('msg-1', 50)
-      const url = vi.mocked(client.get).mock.calls[0][0] as string
+      const url = vi.mocked(client.get).mock.calls[0]?.[0] as string
       expect(url).toContain('/messages/msg-1/out-of-range?')
       expect(url).toContain('limit=50')
     })
@@ -426,7 +437,7 @@ describe('MessagesApi', () => {
     it('appends limit query parameter when provided', async () => {
       vi.mocked(client.get).mockResolvedValue([])
       await api.around('msg-1', { limit: 10 })
-      const url = vi.mocked(client.get).mock.calls[0][0] as string
+      const url = vi.mocked(client.get).mock.calls[0]?.[0] as string
       expect(url).toContain('/messages/msg-1/around?')
       expect(url).toContain('limit=10')
     })

package/src/apis/messages/MessagesApi.ts

@@ -101,9 +101,12 @@ export class MessagesApi extends BaseCrudApi<Message, CreateMessagePayload, Upda
     )
   }
 
-  /** Triggers an AI-generated summary for the conversation associated with the given message. */
-  summarize(id: string, headers?: Record<string, string>): Promise<void> {
-    return this.client.post<void>(`${this.basePath}/${id}/summarize`, undefined, headers)
+  /**
+   * Triggers an AI-generated summary for the conversation associated with the given message.
+   * Resolves to `'OK'`.
+   */
+  summarize(id: string, headers?: Record<string, string>): Promise<string> {
+    return this.client.post<string>(`${this.basePath}/${id}/summarize`, undefined, headers)
   }
 
   /** Checks whether a message is out of the visible range (i.e. there are more than `limit` messages after it). */

package/src/apis/messages/types.ts

@@ -113,6 +113,19 @@ export type Message = {
   transcribeError?: boolean
   reactionParentMessageId: string | null
   hsmId: string | null
+  isFromBot: boolean
+  accountId: string
+  serviceId: string
+  contactId: string
+  /** The contact that sent the message; `null` when it is from the account. */
+  fromId: string | null
+  toId: string | null
+  /** The user that sent the message; `null` for a received one. */
+  userId: string | null
+  ticketId: string | null
+  ticketUserId: string | null
+  ticketDepartmentId: string | null
+  quotedMessageId: string | null
   createdAt: string
   updatedAt: string
   deletedAt: string | null

package/src/apis/payloads.test-d.ts

@@ -1,8 +1,11 @@
 import { expectError } from 'tsd'
 import type { ApiClient } from '../core/ApiClient'
+import { ContactsApi } from './contacts/ContactsApi'
 import { PersonalAccessTokensApi } from './personalAccessTokens/PersonalAccessTokensApi'
 import { RolesApi } from './roles/RolesApi'
+import { TagsApi } from './tags/TagsApi'
 import { TimetableApi } from './timetable/TimetableApi'
+import { UsersApi } from './users/UsersApi'
 
 declare const client: ApiClient
 
@@ -37,3 +40,26 @@ tokens.create({ name: 'CI', expiresIn: '90d' })
 expectError(tokens.create({ name: 'CI', accessTokenExpiresAt: '2030-01-01T00:00:00Z' }))
 expectError(tokens.create({ name: 'CI', expiresIn: '7d' }))
 expectError(tokens.updateById('t-1', { scope: '*' }))
+
+// ── users: the dedicated archive route takes a boolean, not a date ──
+
+const users = new UsersApi(client)
+users.archiveWithValidation('u-1', { archive: true })
+expectError(users.archiveWithValidation('u-1', { archivedAt: '2030-01-01T00:00:00Z' }))
+expectError(users.exportCsv({ filter: 'deleted' }))
+
+// ── contacts: /many takes an array, the bulk delete a selection ─────
+
+const contacts = new ContactsApi(client)
+contacts.createMany([{ serviceId: 's-1', name: 'Alice', number: '5511999990001' }])
+expectError(contacts.createMany({ serviceId: 's-1', name: 'Alice', number: '5511999990001' }))
+expectError(contacts.getMedia('c-1', { where: { type: 'audio' } }))
+
+// ── contact selections: an empty filter would reach every contact of the account ─
+
+contacts.deleteMany({ where: { id: 'c-1' } })
+expectError(contacts.deleteMany({}))
+const tags = new TagsApi(client)
+tags.attachContacts('t-1', { where: { id: { $in: ['c-1', 'c-2'] } } })
+expectError(tags.attachContacts('t-1', {}))
+expectError(tags.detachContacts('t-1', { include: ['tags'] }))

package/src/apis/queryFormat.test.ts

@@ -32,6 +32,8 @@ function createMockClient(queryFormat?: QueryFormat): ApiClient {
 
 const listQuery = { where: { name: 'x' }, page: 2, perPage: 5 }
 const getQuery = { attributes: ['id'] }
+/** `Permission.name` is a union of the catalog names, so the permissions case filters by a real one. */
+const permissionsQuery = { where: { name: 'chat' as const }, page: 2, perPage: 5 }
 
 type Case = {
   name: string
@@ -69,6 +71,27 @@ const cases: Case[] = [
       return (f ? api.withQueryFormat(f) : api).count(listQuery)
     },
   },
+  {
+    name: 'ContactsApi.getMedia',
+    path: '/contacts/c1/media',
+    query: { where: { type: 'document' }, perPage: 10 },
+    call: (client, f) => {
+      const api = new ContactsApi(client)
+      return (f ? api.withQueryFormat(f) : api).getMedia('c1', {
+        where: { type: 'document' },
+        perPage: 10,
+      })
+    },
+  },
+  {
+    name: 'ContactsApi.createMany',
+    path: '/contacts/many',
+    query: { include: ['tags'] },
+    call: (client, f) => {
+      const api = new ContactsApi(client)
+      return (f ? api.withQueryFormat(f) : api).createMany([], { include: ['tags'] })
+    },
+  },
   {
     name: 'ContactsApi.forward',
     path: '/contacts/forward',
@@ -199,10 +222,10 @@ const cases: Case[] = [
   {
     name: 'PermissionsApi.getMany',
     path: '/permissions',
-    query: listQuery,
+    query: permissionsQuery,
     call: (client, f) => {
       const api = new PermissionsApi(client)
-      return (f ? api.withQueryFormat(f) : api).getMany(listQuery)
+      return (f ? api.withQueryFormat(f) : api).getMany(permissionsQuery)
     },
   },
   {
@@ -255,7 +278,8 @@ const cases: Case[] = [
 const jsonUrl = (path: string, query: object) =>
   `${path}?query=${encodeURIComponent(JSON.stringify(query))}`
 const qsUrl = (path: string, query: object) => `${path}?${qs.stringify(query)}`
-const calledUrl = (client: ApiClient) => vi.mocked(client.get).mock.calls.at(0)?.at(0)
+const calledUrl = (client: ApiClient) =>
+  vi.mocked(client.get).mock.calls.at(0)?.at(0) ?? vi.mocked(client.post).mock.calls.at(0)?.at(0)
 
 describe.each(cases)('$name', ({ path, query, call }) => {
   it("sends JSON with the default client format ('json')", async () => {

package/src/apis/serviceAccessManagement/ServiceAccessManagementApi.test.ts

@@ -61,7 +61,7 @@ describe('ServiceAccessManagementApi', () => {
     it('serializes query parameters', async () => {
       vi.mocked(client.get).mockResolvedValue(paginated)
       await api.getMany({ page: 2, perPage: 5 })
-      const url = vi.mocked(client.get).mock.calls[0][0] as string
+      const url = vi.mocked(client.get).mock.calls[0]?.[0] as string
       expect(url).toContain('/service-access-management?')
       expect(decodeURIComponent(url)).toContain('"page":2')
     })
@@ -76,7 +76,7 @@ describe('ServiceAccessManagementApi', () => {
     it('returns unpaginated array when paginate: false', async () => {
       vi.mocked(client.get).mockResolvedValue([record])
       const result = await api.getMany({ paginate: false })
-      const url = vi.mocked(client.get).mock.calls[0][0] as string
+      const url = vi.mocked(client.get).mock.calls[0]?.[0] as string
       expect(decodeURIComponent(url)).toContain('"paginate":false')
       expect(result).toEqual([record])
     })

package/src/apis/services/ServicesApi.test.ts

@@ -0,0 +1,49 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest'
+import { ServicesApi } from './ServicesApi'
+import type { ApiClient } from '../../core/ApiClient'
+import type { ServiceLimits } from './types'
+
+// ── Mock client factory ──────────────────────────────────────────────
+
+function createMockClient(): ApiClient {
+  return {
+    setAccessToken: vi.fn().mockReturnThis(),
+    request: vi.fn(),
+    get: vi.fn(),
+    post: vi.fn(),
+    put: vi.fn(),
+    patch: vi.fn(),
+    delete: vi.fn(),
+  }
+}
+
+// ── Tests ────────────────────────────────────────────────────────────
+
+describe('ServicesApi', () => {
+  let client: ReturnType<typeof createMockClient>
+  let api: ServicesApi
+
+  beforeEach(() => {
+    client = createMockClient()
+    api = new ServicesApi(client)
+  })
+
+  describe('getLimits', () => {
+    it('calls client.get with /services/limits', async () => {
+      const limits: ServiceLimits = {
+        whatsapp: { used: 1, total: 80, available: 79 },
+        telegram: { used: 0, total: 0, available: 0 },
+      }
+      vi.mocked(client.get).mockResolvedValue(limits)
+      const result = await api.getLimits()
+      expect(client.get).toHaveBeenCalledWith('/services/limits', undefined)
+      expect(result).toEqual(limits)
+    })
+
+    it('forwards custom headers', async () => {
+      const headers = { 'X-Custom': 'value' }
+      await api.getLimits(headers)
+      expect(client.get).toHaveBeenCalledWith('/services/limits', headers)
+    })
+  })
+})

package/src/apis/services/ServicesApi.ts

@@ -1,6 +1,6 @@
 import type { ApiClient } from '../../core/ApiClient'
 import { ArchivableCrudApi } from '../../core/ArchivableCrudApi'
-import type { Service, CreateServicePayload, UpdateServicePayload } from './types'
+import type { Service, CreateServicePayload, ServiceLimits, UpdateServicePayload } from './types'
 
 export class ServicesApi extends ArchivableCrudApi<
   Service,
@@ -10,4 +10,13 @@ export class ServicesApi extends ArchivableCrudApi<
   constructor(client: ApiClient) {
     super(client, '/services')
   }
+
+  /**
+   * Returns, for each connection type of the account plan, how many connections are used,
+   * allowed and still available.
+   * @permissions services.view
+   */
+  getLimits(headers?: Record<string, string>): Promise<ServiceLimits> {
+    return this.client.get<ServiceLimits>(`${this.basePath}/limits`, headers)
+  }
 }

package/src/apis/services/types.ts

@@ -221,3 +221,12 @@ export type UpdateServicePayload = {
   botId?: string | null
   archivedAt?: string | null
 }
+
+export type ServiceLimit = {
+  used: number
+  total: number
+  available: number
+}
+
+/** Connections used and allowed by the account plan, by connection type. */
+export type ServiceLimits = Partial<Record<ServiceType, ServiceLimit>>

package/src/apis/stickerUsers/StickerUsersApi.test.ts

@@ -64,7 +64,7 @@ describe('StickerUsersApi', () => {
     it('serializes query parameters', async () => {
       vi.mocked(client.get).mockResolvedValue(paginated)
       await api.getMany({ page: 2, perPage: 5 })
-      const url = vi.mocked(client.get).mock.calls[0][0] as string
+      const url = vi.mocked(client.get).mock.calls[0]?.[0] as string
       expect(url).toContain('/sticker-users?')
       expect(decodeURIComponent(url)).toContain('"page":2')
     })

package/src/apis/tags/TagsApi.test.ts

@@ -0,0 +1,84 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest'
+import { TagsApi } from './TagsApi'
+import type { ApiClient } from '../../core/ApiClient'
+
+// ── Mock client factory ──────────────────────────────────────────────
+
+function createMockClient(): ApiClient {
+  return {
+    setAccessToken: vi.fn().mockReturnThis(),
+    request: vi.fn(),
+    get: vi.fn(),
+    post: vi.fn(),
+    put: vi.fn(),
+    patch: vi.fn(),
+    delete: vi.fn(),
+  }
+}
+
+const headers = { 'X-Custom': 'value' }
+
+// ── Tests ────────────────────────────────────────────────────────────
+
+describe('TagsApi', () => {
+  let client: ReturnType<typeof createMockClient>
+  let api: TagsApi
+
+  beforeEach(() => {
+    client = createMockClient()
+    api = new TagsApi(client)
+  })
+
+  describe('attachContacts', () => {
+    it('calls client.post with /tags/:id/contacts and the selection', async () => {
+      vi.mocked(client.post).mockResolvedValue('OK')
+      const body = { where: { id: { $in: ['c1', 'c2'] } } }
+      const result = await api.attachContacts('t1', body)
+      expect(client.post).toHaveBeenCalledWith('/tags/t1/contacts', body, undefined)
+      expect(result).toBe('OK')
+    })
+
+    it('resolves to false when no link changed', async () => {
+      vi.mocked(client.post).mockResolvedValue(false)
+      await expect(api.attachContacts('t1', { where: { id: 'c1' } })).resolves.toBe(false)
+    })
+
+    it('forwards custom headers', async () => {
+      await api.attachContacts('t1', { where: { id: 'c1' } }, headers)
+      expect(client.post).toHaveBeenCalledWith(
+        '/tags/t1/contacts',
+        { where: { id: 'c1' } },
+        headers,
+      )
+    })
+  })
+
+  describe('detachContacts', () => {
+    it('calls client.request with DELETE /tags/:id/contacts and the selection', async () => {
+      vi.mocked(client.request).mockResolvedValue('OK')
+      const body = { where: { id: 'c1' } }
+      const result = await api.detachContacts('t1', body, headers)
+      expect(client.request).toHaveBeenCalledWith('DELETE', '/tags/t1/contacts', body, headers)
+      expect(result).toBe('OK')
+    })
+  })
+
+  describe('attachManyToDepartments', () => {
+    it('calls client.post with /tags/attach-many-departments and body', async () => {
+      vi.mocked(client.post).mockResolvedValue('OK')
+      const body = { ids: ['t1', 't2'], departmentIds: ['d1'] }
+      const result = await api.attachManyToDepartments(body)
+      expect(client.post).toHaveBeenCalledWith('/tags/attach-many-departments', body, undefined)
+      expect(result).toBe('OK')
+    })
+  })
+
+  describe('error propagation', () => {
+    it('propagates errors from attachManyToDepartments', async () => {
+      vi.mocked(client.post).mockRejectedValue(new Error('Invalid tag ids'))
+      await expect(api.attachManyToDepartments({ ids: [], departmentIds: [] })).rejects.toThrow(
+        'Invalid tag ids',
+      )
+    })
+  })
+})

package/src/apis/tags/TagsApi.ts

@@ -1,9 +1,67 @@
 import type { ApiClient } from '../../core/ApiClient'
 import { BaseCrudApi } from '../../core/BaseCrudApi'
-import type { Tag, CreateTagPayload, UpdateTagPayload } from './types'
+import type { ContactsSelection } from '../contacts/types'
+import type {
+  AttachTagsToDepartmentsPayload,
+  CreateTagPayload,
+  Tag,
+  TagContactsLinkResult,
+  UpdateTagPayload,
+} from './types'
 
 export class TagsApi extends BaseCrudApi<Tag, CreateTagPayload, UpdateTagPayload> {
   constructor(client: ApiClient) {
     super(client, '/tags')
   }
+
+  /**
+   * Adds the tag to every contact of the account that matches the selection. Resolves to `'OK'`,
+   * or `false` when every contact already had the tag.
+   * @permissions tags.view
+   */
+  attachContacts(
+    id: string,
+    body: ContactsSelection,
+    headers?: Record<string, string>,
+  ): Promise<TagContactsLinkResult> {
+    return this.client.post<TagContactsLinkResult, ContactsSelection>(
+      `${this.basePath}/${id}/contacts`,
+      body,
+      headers,
+    )
+  }
+
+  /**
+   * Removes the tag from every contact of the account that matches the selection. Resolves to
+   * `'OK'`, or `false` when no contact had the tag.
+   * @permissions tags.view OR tags.destroy
+   */
+  detachContacts(
+    id: string,
+    body: ContactsSelection,
+    headers?: Record<string, string>,
+  ): Promise<TagContactsLinkResult> {
+    return this.client.request<TagContactsLinkResult, ContactsSelection>(
+      'DELETE',
+      `${this.basePath}/${id}/contacts`,
+      body,
+      headers,
+    )
+  }
+
+  /**
+   * Links several tags to the given departments. Resolves to `'OK'`. A tag without departments
+   * is already available to all of them and is left unchanged.
+   * @permissions tags.view
+   */
+  attachManyToDepartments(
+    body: AttachTagsToDepartmentsPayload,
+    headers?: Record<string, string>,
+  ): Promise<string> {
+    return this.client.post<string, AttachTagsToDepartmentsPayload>(
+      `${this.basePath}/attach-many-departments`,
+      body,
+      headers,
+    )
+  }
 }

package/src/apis/tags/types.ts

@@ -27,3 +27,18 @@ export type UpdateTagPayload = {
   label?: string
   backgroundColor?: string | null
 }
+
+/**
+ * Result of linking or unlinking a tag and the contacts of a selection: `'OK'` when at least one
+ * link changed, `false` when nothing changed (every contact already had, or did not have, the tag).
+ */
+export type TagContactsLinkResult = 'OK' | false
+
+/**
+ * Body for `POST /tags/attach-many-departments`. An empty `departmentIds` makes the tags
+ * available to every department.
+ */
+export type AttachTagsToDepartmentsPayload = {
+  ids: string[]
+  departmentIds: string[]
+}

package/src/apis/terms/TermsApi.test.ts

@@ -66,7 +66,7 @@ describe('TermsApi', () => {
     it('serializes the query', async () => {
       vi.mocked(client.get).mockResolvedValue(term)
       await api.getById('term-1', { attributes: ['id', 'version'] })
-      const url = vi.mocked(client.get).mock.calls[0][0] as string
+      const url = vi.mocked(client.get).mock.calls[0]?.[0] as string
       expect(url).toContain('/terms/term-1?')
       expect(url).toContain('attributes')
     })