@ikatec/digisac-api-sdk 4.12.0 → 4.13.0

package/dist/apis/stickers/StickersApi.mjs

@@ -2,9 +2,10 @@ import { BaseCrudApi } from "../../core/BaseCrudApi.mjs";
 
 //#region src/apis/stickers/StickersApi.ts
 /**
-* Stickers of the account. The backend serves `GET /stickers` and `POST /stickers` (plus
-* `GET /stickers/exist`, `POST /stickers/add` and `DELETE /stickers/remove/:stickerId`); there is
-* no read by id, update nor `DELETE /stickers/:id`.
+* Stickers of the account: every user of the account sees them. The backend serves `GET /stickers`,
+* `POST /stickers`, `GET /stickers/exist`, `POST /stickers/add` and `DELETE /stickers/remove/:stickerId`;
+* there is no read by id, update nor `DELETE /stickers/:id`. The list accepts only the `file` include.
+* @permissions stickers.send (list) · stickers.management (create, exist, add, remove)
 */
 var StickersApi = class extends BaseCrudApi {
 	constructor(client) {
@@ -25,6 +26,29 @@ var StickersApi = class extends BaseCrudApi {
 	deleteById(id, headers) {
 		return super.deleteById(id, headers);
 	}
+	/**
+	* Finds the sticker of the account that came from the message, or from the file of `fileChecksum` or
+	* `filehash`. Resolves `{ stickerId }`, or `{}` when there is none; without `messageId` it answers 500
+	* `Invalid message ID`.
+	*/
+	exist(query, headers) {
+		return this.client.get(`${this.basePath}/exist${this.toQueryString(query)}`, headers);
+	}
+	/**
+	* Turns the file of a message of the account into a sticker (`type: 'added'`). Idempotent: a sticker that
+	* already came from the message (or its file) is answered as is, and a removed one is restored. A message
+	* without file answers 500 `Message or file not found`.
+	*/
+	add(messageId, headers) {
+		return this.client.post(`${this.basePath}/add`, { messageId }, headers);
+	}
+	/**
+	* Removes a sticker of the account (soft delete; its file stays in the storage) and clears it from the
+	* recent stickers of every user. Resolves the text `'OK'`, or `false` when there is no such sticker.
+	*/
+	remove(stickerId, headers) {
+		return this.client.delete(`${this.basePath}/remove/${stickerId}`, headers);
+	}
 };
 
 //#endregion

package/dist/apis/stickers/StickersApi.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"StickersApi.mjs","names":[],"sources":["../../../src/apis/stickers/StickersApi.ts"],"sourcesContent":["import type { ApiClient } from '../../core/ApiClient'\nimport { BaseCrudApi } from '../../core/BaseCrudApi'\nimport type { GetByIdQuery } from '../../core/types'\nimport type { Sticker, CreateStickerPayload, UpdateStickerPayload } from './types'\n\n/**\n * Stickers of the account. The backend serves `GET /stickers` and `POST /stickers` (plus\n * `GET /stickers/exist`, `POST /stickers/add` and `DELETE /stickers/remove/:stickerId`); there is\n * no read by id, update nor `DELETE /stickers/:id`.\n */\nexport class StickersApi extends BaseCrudApi<Sticker, CreateStickerPayload, UpdateStickerPayload> {\n  constructor(client: ApiClient) {\n    super(client, '/stickers')\n  }\n\n  /** @deprecated Not served: the backend has no GET /stickers/:id, so this route answers 404. */\n  override getById(\n    id: string,\n    query?: GetByIdQuery<Sticker>,\n    headers?: Record<string, string>,\n  ): Promise<Sticker> {\n    return super.getById(id, query, headers)\n  }\n\n  /** @deprecated Not served: the backend has no PUT /stickers/:id, so this route answers 404. */\n  override updateById(\n    id: string,\n    body: UpdateStickerPayload,\n    headers?: Record<string, string>,\n  ): Promise<Sticker> {\n    return super.updateById(id, body, headers)\n  }\n\n  /**\n   * @deprecated Not served: the backend has no DELETE /stickers/:id (it removes a sticker by\n   * `DELETE /stickers/remove/:stickerId`), so this route answers 404.\n   */\n  override deleteById(id: string, headers?: Record<string, string>): Promise<Sticker> {\n    return super.deleteById(id, headers)\n  }\n}\n"],"mappings":";;;;;;;;AAUA,IAAa,cAAb,cAAiC,YAAiE;CAChG,YAAY,QAAmB;AAC7B,QAAM,QAAQ,YAAY;;;CAI5B,AAAS,QACP,IACA,OACA,SACkB;AAClB,SAAO,MAAM,QAAQ,IAAI,OAAO,QAAQ;;;CAI1C,AAAS,WACP,IACA,MACA,SACkB;AAClB,SAAO,MAAM,WAAW,IAAI,MAAM,QAAQ;;;;;;CAO5C,AAAS,WAAW,IAAY,SAAoD;AAClF,SAAO,MAAM,WAAW,IAAI,QAAQ"}
+{"version":3,"file":"StickersApi.mjs","names":[],"sources":["../../../src/apis/stickers/StickersApi.ts"],"sourcesContent":["import type { ApiClient } from '../../core/ApiClient'\nimport { BaseCrudApi } from '../../core/BaseCrudApi'\nimport type { GetByIdQuery } from '../../core/types'\nimport type {\n  Sticker,\n  CreateStickerPayload,\n  UpdateStickerPayload,\n  StickerExistQuery,\n} from './types'\n\n/**\n * Stickers of the account: every user of the account sees them. The backend serves `GET /stickers`,\n * `POST /stickers`, `GET /stickers/exist`, `POST /stickers/add` and `DELETE /stickers/remove/:stickerId`;\n * there is no read by id, update nor `DELETE /stickers/:id`. The list accepts only the `file` include.\n * @permissions stickers.send (list) · stickers.management (create, exist, add, remove)\n */\nexport class StickersApi extends BaseCrudApi<Sticker, CreateStickerPayload, UpdateStickerPayload> {\n  constructor(client: ApiClient) {\n    super(client, '/stickers')\n  }\n\n  /** @deprecated Not served: the backend has no GET /stickers/:id, so this route answers 404. */\n  override getById(\n    id: string,\n    query?: GetByIdQuery<Sticker>,\n    headers?: Record<string, string>,\n  ): Promise<Sticker> {\n    return super.getById(id, query, headers)\n  }\n\n  /** @deprecated Not served: the backend has no PUT /stickers/:id, so this route answers 404. */\n  override updateById(\n    id: string,\n    body: UpdateStickerPayload,\n    headers?: Record<string, string>,\n  ): Promise<Sticker> {\n    return super.updateById(id, body, headers)\n  }\n\n  /**\n   * @deprecated Not served: the backend has no DELETE /stickers/:id (it removes a sticker by\n   * `DELETE /stickers/remove/:stickerId`), so this route answers 404.\n   */\n  override deleteById(id: string, headers?: Record<string, string>): Promise<Sticker> {\n    return super.deleteById(id, headers)\n  }\n\n  /**\n   * Finds the sticker of the account that came from the message, or from the file of `fileChecksum` or\n   * `filehash`. Resolves `{ stickerId }`, or `{}` when there is none; without `messageId` it answers 500\n   * `Invalid message ID`.\n   */\n  exist(\n    query: StickerExistQuery,\n    headers?: Record<string, string>,\n  ): Promise<{ stickerId?: string }> {\n    return this.client.get<{ stickerId?: string }>(\n      `${this.basePath}/exist${this.toQueryString(query)}`,\n      headers,\n    )\n  }\n\n  /**\n   * Turns the file of a message of the account into a sticker (`type: 'added'`). Idempotent: a sticker that\n   * already came from the message (or its file) is answered as is, and a removed one is restored. A message\n   * without file answers 500 `Message or file not found`.\n   */\n  add(messageId: string, headers?: Record<string, string>): Promise<Sticker> {\n    return this.client.post<Sticker, { messageId: string }>(\n      `${this.basePath}/add`,\n      { messageId },\n      headers,\n    )\n  }\n\n  /**\n   * Removes a sticker of the account (soft delete; its file stays in the storage) and clears it from the\n   * recent stickers of every user. Resolves the text `'OK'`, or `false` when there is no such sticker.\n   */\n  remove(stickerId: string, headers?: Record<string, string>): Promise<'OK' | false> {\n    return this.client.delete<'OK' | false>(`${this.basePath}/remove/${stickerId}`, headers)\n  }\n}\n"],"mappings":";;;;;;;;;AAgBA,IAAa,cAAb,cAAiC,YAAiE;CAChG,YAAY,QAAmB;AAC7B,QAAM,QAAQ,YAAY;;;CAI5B,AAAS,QACP,IACA,OACA,SACkB;AAClB,SAAO,MAAM,QAAQ,IAAI,OAAO,QAAQ;;;CAI1C,AAAS,WACP,IACA,MACA,SACkB;AAClB,SAAO,MAAM,WAAW,IAAI,MAAM,QAAQ;;;;;;CAO5C,AAAS,WAAW,IAAY,SAAoD;AAClF,SAAO,MAAM,WAAW,IAAI,QAAQ;;;;;;;CAQtC,MACE,OACA,SACiC;AACjC,SAAO,KAAK,OAAO,IACjB,GAAG,KAAK,SAAS,QAAQ,KAAK,cAAc,MAAM,IAClD,QACD;;;;;;;CAQH,IAAI,WAAmB,SAAoD;AACzE,SAAO,KAAK,OAAO,KACjB,GAAG,KAAK,SAAS,OACjB,EAAE,WAAW,EACb,QACD;;;;;;CAOH,OAAO,WAAmB,SAAyD;AACjF,SAAO,KAAK,OAAO,OAAqB,GAAG,KAAK,SAAS,UAAU,aAAa,QAAQ"}

package/dist/apis/stickers/types.d.ts

@@ -1,7 +1,10 @@
+import type { File } from '../files/types';
 import type { User } from '../users/types';
+/** A sticker of the account (every user of the account sees it). */
 export type Sticker = {
     id: string;
-    type: string;
+    /** `'created'` (uploaded with `create`) or `'added'` (taken from a message with `add`). */
+    type: 'created' | 'added' | (string & {});
     originFileChecksum: string | null;
     originFilehash: string | null;
     originMessageId: string | null;
@@ -9,17 +12,38 @@ export type Sticker = {
     accountId: string;
     createdAt: string;
     updatedAt: string;
-    deletedAt: string | null;
+    deletedAt?: string | null;
+    /** @deprecated Not served: the backend only serves the `file` include. */
     user?: User;
+    /** The image (webp) of the sticker. */
+    file?: File;
 };
-export type StickerRelationships = 'user';
+/** The backend serves only `file` (`user` is dropped). */
+export type StickerRelationships = 'user' | 'file';
+/**
+ * Uploads an image as a sticker: the backend converts it to a 512x512 webp (413 when it ends up too large:
+ * 100KB static, 500KB animated). `base64` without the `data:...;base64,` prefix.
+ */
 export type CreateStickerPayload = {
-    type: string;
+    base64: string;
+    /** The name of the file (`<name>.webp`). */
+    name: string;
+    /** @deprecated Ignored by the backend: a created sticker is always `'created'`. */
+    type?: string;
+    /** @deprecated Ignored by the backend: use `add` to take a sticker from a message. */
     originMessageId?: string;
+    /** @deprecated Ignored by the backend. */
     originFileChecksum?: string;
+    /** @deprecated Ignored by the backend. */
     originFilehash?: string;
 };
 export type UpdateStickerPayload = {
     type?: string;
 };
+/** Query of `exist`: finds a sticker of the account by the message or by the file it came from. */
+export type StickerExistQuery = {
+    messageId: string;
+    fileChecksum?: string;
+    filehash?: string;
+};
 //# sourceMappingURL=types.d.ts.map

package/dist/apis/stickers/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/apis/stickers/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAA;AAE1C,MAAM,MAAM,OAAO,GAAG;IACpB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IAExB,IAAI,CAAC,EAAE,IAAI,CAAA;CACZ,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAA;AAEzC,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/apis/stickers/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAA;AAE1C,oEAAoE;AACpE,MAAM,MAAM,OAAO,GAAG;IACpB,EAAE,EAAE,MAAM,CAAA;IACV,2FAA2F;IAC3F,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;IACzC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAEzB,0EAA0E;IAC1E,IAAI,CAAC,EAAE,IAAI,CAAA;IACX,uCAAuC;IACvC,IAAI,CAAC,EAAE,IAAI,CAAA;CACZ,CAAA;AAED,0DAA0D;AAC1D,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,MAAM,CAAA;AAElD;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAA;IACZ,mFAAmF;IACnF,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,sFAAsF;IACtF,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,0CAA0C;IAC1C,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,0CAA0C;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,mGAAmG;AACnG,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA"}

package/dist/apis/whatsappBusinessTemplates/WhatsappBusinessTemplatesApi.cjs

@@ -51,8 +51,7 @@ var WhatsappBusinessTemplatesApi = class extends require_core_BaseCrudApi.BaseCr
 		return this.client.post(`${this.basePath}/refresh-templates`, void 0, headers);
 	}
 	/**
-	* Reads the template balance from 360Dialog. The backend looks for the 360Dialog connection on the whole platform,
-	* not only in the account, and calls 360Dialog when it finds one.
+	* Reads the template balance from 360Dialog (an external call, when there is a 360Dialog connection).
 	* @permissions hsm.view
 	*/
 	resume(headers) {

package/dist/apis/whatsappBusinessTemplates/WhatsappBusinessTemplatesApi.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"WhatsappBusinessTemplatesApi.cjs","names":["BaseCrudApi"],"sources":["../../../src/apis/whatsappBusinessTemplates/WhatsappBusinessTemplatesApi.ts"],"sourcesContent":["import type { ApiClient } from '../../core/ApiClient'\nimport type { ListQuery } from '../../core/types'\nimport { BaseCrudApi } from '../../core/BaseCrudApi'\nimport type {\n  WhatsappBusinessTemplate,\n  CreateWhatsappBusinessTemplatePayload,\n  UpdateWhatsappBusinessTemplatePayload,\n  WhatsappBusinessTemplateHsmLimit,\n} from './types'\n\n/**\n * WhatsApp Business templates. Create, update, reads and count are local; `sendToReview`, `refreshTemplates`,\n * `resume` and the delete of a template of a `whatsapp-business` connection call the provider (Meta, 360Dialog).\n * `getById` answers `null` for an unknown id.\n */\nexport class WhatsappBusinessTemplatesApi extends BaseCrudApi<\n  WhatsappBusinessTemplate,\n  CreateWhatsappBusinessTemplatePayload,\n  UpdateWhatsappBusinessTemplatePayload,\n  ListQuery<WhatsappBusinessTemplate>,\n  unknown\n> {\n  constructor(client: ApiClient) {\n    super(client, '/whatsapp-business-templates')\n  }\n\n  /**\n   * Counts the templates matching the query.\n   * @permissions hsm.view\n   */\n  count(\n    query?: ListQuery<WhatsappBusinessTemplate>,\n    headers?: Record<string, string>,\n  ): Promise<{ count: number }> {\n    return this.client.get<{ count: number }>(\n      `${this.basePath}/count${this.toQueryString(query)}`,\n      headers,\n    )\n  }\n\n  /**\n   * Reads the template limit of the plan of the account. Send the `accountId` of the current user: the route is\n   * outside the error handler of the backend, so an unknown id gets no answer (the request waits for the timeout).\n   * @permissions hsm.view\n   */\n  getHsmLimit(\n    accountId: string,\n    headers?: Record<string, string>,\n  ): Promise<WhatsappBusinessTemplateHsmLimit> {\n    return this.client.get<WhatsappBusinessTemplateHsmLimit>(\n      `${this.basePath}/${accountId}/hsmLimit`,\n      headers,\n    )\n  }\n\n  /**\n   * Deletes a template. On a `whatsapp-business` connection it goes to the provider (and answers what it answers);\n   * a draft of another connection type is deleted locally (answers the stored template). An unknown id answers 500.\n   * @permissions hsm.view OR hsm.destroy\n   */\n  override deleteById(id: string, headers?: Record<string, string>): Promise<unknown> {\n    return super.deleteById(id, headers)\n  }\n\n  /**\n   * SENDS the template to Meta for approval (through the provider of the connection). An unknown or archived\n   * template answers 500 before anything is sent.\n   * @permissions hsm.view OR hsm.send OR hsm.send.before.expire\n   */\n  sendToReview(id: string, headers?: Record<string, string>): Promise<unknown> {\n    return this.client.post<unknown>(`${this.basePath}/${id}/send-to-review`, undefined, headers)\n  }\n\n  /**\n   * Reads the templates of the connected `whatsapp-business` connections from the provider and syncs them (it may\n   * archive the local templates the provider no longer has). Resolves the text `'OK'`.\n   * @permissions hsm.view\n   */\n  refreshTemplates(headers?: Record<string, string>): Promise<'OK'> {\n    return this.client.post<'OK'>(`${this.basePath}/refresh-templates`, undefined, headers)\n  }\n\n  /**\n   * Reads the template balance from 360Dialog. The backend looks for the 360Dialog connection on the whole platform,\n   * not only in the account, and calls 360Dialog when it finds one.\n   * @permissions hsm.view\n   */\n  resume(headers?: Record<string, string>): Promise<Record<string, unknown>[]> {\n    return this.client.get<Record<string, unknown>[]>(`${this.basePath}/resume`, headers)\n  }\n}\n"],"mappings":";;;;;;;;;AAeA,IAAa,+BAAb,cAAkDA,qCAMhD;CACA,YAAY,QAAmB;AAC7B,QAAM,QAAQ,+BAA+B;;;;;;CAO/C,MACE,OACA,SAC4B;AAC5B,SAAO,KAAK,OAAO,IACjB,GAAG,KAAK,SAAS,QAAQ,KAAK,cAAc,MAAM,IAClD,QACD;;;;;;;CAQH,YACE,WACA,SAC2C;AAC3C,SAAO,KAAK,OAAO,IACjB,GAAG,KAAK,SAAS,GAAG,UAAU,YAC9B,QACD;;;;;;;CAQH,AAAS,WAAW,IAAY,SAAoD;AAClF,SAAO,MAAM,WAAW,IAAI,QAAQ;;;;;;;CAQtC,aAAa,IAAY,SAAoD;AAC3E,SAAO,KAAK,OAAO,KAAc,GAAG,KAAK,SAAS,GAAG,GAAG,kBAAkB,QAAW,QAAQ;;;;;;;CAQ/F,iBAAiB,SAAiD;AAChE,SAAO,KAAK,OAAO,KAAW,GAAG,KAAK,SAAS,qBAAqB,QAAW,QAAQ;;;;;;;CAQzF,OAAO,SAAsE;AAC3E,SAAO,KAAK,OAAO,IAA+B,GAAG,KAAK,SAAS,UAAU,QAAQ"}
+{"version":3,"file":"WhatsappBusinessTemplatesApi.cjs","names":["BaseCrudApi"],"sources":["../../../src/apis/whatsappBusinessTemplates/WhatsappBusinessTemplatesApi.ts"],"sourcesContent":["import type { ApiClient } from '../../core/ApiClient'\nimport type { ListQuery } from '../../core/types'\nimport { BaseCrudApi } from '../../core/BaseCrudApi'\nimport type {\n  WhatsappBusinessTemplate,\n  CreateWhatsappBusinessTemplatePayload,\n  UpdateWhatsappBusinessTemplatePayload,\n  WhatsappBusinessTemplateHsmLimit,\n} from './types'\n\n/**\n * WhatsApp Business templates. Create, update, reads and count are local; `sendToReview`, `refreshTemplates`,\n * `resume` and the delete of a template of a `whatsapp-business` connection call the provider (Meta, 360Dialog).\n * `getById` answers `null` for an unknown id.\n */\nexport class WhatsappBusinessTemplatesApi extends BaseCrudApi<\n  WhatsappBusinessTemplate,\n  CreateWhatsappBusinessTemplatePayload,\n  UpdateWhatsappBusinessTemplatePayload,\n  ListQuery<WhatsappBusinessTemplate>,\n  unknown\n> {\n  constructor(client: ApiClient) {\n    super(client, '/whatsapp-business-templates')\n  }\n\n  /**\n   * Counts the templates matching the query.\n   * @permissions hsm.view\n   */\n  count(\n    query?: ListQuery<WhatsappBusinessTemplate>,\n    headers?: Record<string, string>,\n  ): Promise<{ count: number }> {\n    return this.client.get<{ count: number }>(\n      `${this.basePath}/count${this.toQueryString(query)}`,\n      headers,\n    )\n  }\n\n  /**\n   * Reads the template limit of the plan of the account. Send the `accountId` of the current user: the route is\n   * outside the error handler of the backend, so an unknown id gets no answer (the request waits for the timeout).\n   * @permissions hsm.view\n   */\n  getHsmLimit(\n    accountId: string,\n    headers?: Record<string, string>,\n  ): Promise<WhatsappBusinessTemplateHsmLimit> {\n    return this.client.get<WhatsappBusinessTemplateHsmLimit>(\n      `${this.basePath}/${accountId}/hsmLimit`,\n      headers,\n    )\n  }\n\n  /**\n   * Deletes a template. On a `whatsapp-business` connection it goes to the provider (and answers what it answers);\n   * a draft of another connection type is deleted locally (answers the stored template). An unknown id answers 500.\n   * @permissions hsm.view OR hsm.destroy\n   */\n  override deleteById(id: string, headers?: Record<string, string>): Promise<unknown> {\n    return super.deleteById(id, headers)\n  }\n\n  /**\n   * SENDS the template to Meta for approval (through the provider of the connection). An unknown or archived\n   * template answers 500 before anything is sent.\n   * @permissions hsm.view OR hsm.send OR hsm.send.before.expire\n   */\n  sendToReview(id: string, headers?: Record<string, string>): Promise<unknown> {\n    return this.client.post<unknown>(`${this.basePath}/${id}/send-to-review`, undefined, headers)\n  }\n\n  /**\n   * Reads the templates of the connected `whatsapp-business` connections from the provider and syncs them (it may\n   * archive the local templates the provider no longer has). Resolves the text `'OK'`.\n   * @permissions hsm.view\n   */\n  refreshTemplates(headers?: Record<string, string>): Promise<'OK'> {\n    return this.client.post<'OK'>(`${this.basePath}/refresh-templates`, undefined, headers)\n  }\n\n  /**\n   * Reads the template balance from 360Dialog (an external call, when there is a 360Dialog connection).\n   * @permissions hsm.view\n   */\n  resume(headers?: Record<string, string>): Promise<Record<string, unknown>[]> {\n    return this.client.get<Record<string, unknown>[]>(`${this.basePath}/resume`, headers)\n  }\n}\n"],"mappings":";;;;;;;;;AAeA,IAAa,+BAAb,cAAkDA,qCAMhD;CACA,YAAY,QAAmB;AAC7B,QAAM,QAAQ,+BAA+B;;;;;;CAO/C,MACE,OACA,SAC4B;AAC5B,SAAO,KAAK,OAAO,IACjB,GAAG,KAAK,SAAS,QAAQ,KAAK,cAAc,MAAM,IAClD,QACD;;;;;;;CAQH,YACE,WACA,SAC2C;AAC3C,SAAO,KAAK,OAAO,IACjB,GAAG,KAAK,SAAS,GAAG,UAAU,YAC9B,QACD;;;;;;;CAQH,AAAS,WAAW,IAAY,SAAoD;AAClF,SAAO,MAAM,WAAW,IAAI,QAAQ;;;;;;;CAQtC,aAAa,IAAY,SAAoD;AAC3E,SAAO,KAAK,OAAO,KAAc,GAAG,KAAK,SAAS,GAAG,GAAG,kBAAkB,QAAW,QAAQ;;;;;;;CAQ/F,iBAAiB,SAAiD;AAChE,SAAO,KAAK,OAAO,KAAW,GAAG,KAAK,SAAS,qBAAqB,QAAW,QAAQ;;;;;;CAOzF,OAAO,SAAsE;AAC3E,SAAO,KAAK,OAAO,IAA+B,GAAG,KAAK,SAAS,UAAU,QAAQ"}

package/dist/apis/whatsappBusinessTemplates/WhatsappBusinessTemplatesApi.d.ts

@@ -41,8 +41,7 @@ export declare class WhatsappBusinessTemplatesApi extends BaseCrudApi<WhatsappBu
      */
     refreshTemplates(headers?: Record<string, string>): Promise<'OK'>;
     /**
-     * Reads the template balance from 360Dialog. The backend looks for the 360Dialog connection on the whole platform,
-     * not only in the account, and calls 360Dialog when it finds one.
+     * Reads the template balance from 360Dialog (an external call, when there is a 360Dialog connection).
      * @permissions hsm.view
      */
     resume(headers?: Record<string, string>): Promise<Record<string, unknown>[]>;

package/dist/apis/whatsappBusinessTemplates/WhatsappBusinessTemplatesApi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WhatsappBusinessTemplatesApi.d.ts","sourceRoot":"","sources":["../../../src/apis/whatsappBusinessTemplates/WhatsappBusinessTemplatesApi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACpD,OAAO,KAAK,EACV,wBAAwB,EACxB,qCAAqC,EACrC,qCAAqC,EACrC,gCAAgC,EACjC,MAAM,SAAS,CAAA;AAEhB;;;;GAIG;AACH,qBAAa,4BAA6B,SAAQ,WAAW,CAC3D,wBAAwB,EACxB,qCAAqC,EACrC,qCAAqC,EACrC,SAAS,CAAC,wBAAwB,CAAC,EACnC,OAAO,CACR;gBACa,MAAM,EAAE,SAAS;IAI7B;;;OAGG;IACH,KAAK,CACH,KAAK,CAAC,EAAE,SAAS,CAAC,wBAAwB,CAAC,EAC3C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAO7B;;;;OAIG;IACH,WAAW,CACT,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,gCAAgC,CAAC;IAO5C;;;;OAIG;IACM,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAInF;;;;OAIG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAI5E;;;;OAIG;IACH,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjE;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CAG7E"}
+{"version":3,"file":"WhatsappBusinessTemplatesApi.d.ts","sourceRoot":"","sources":["../../../src/apis/whatsappBusinessTemplates/WhatsappBusinessTemplatesApi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACpD,OAAO,KAAK,EACV,wBAAwB,EACxB,qCAAqC,EACrC,qCAAqC,EACrC,gCAAgC,EACjC,MAAM,SAAS,CAAA;AAEhB;;;;GAIG;AACH,qBAAa,4BAA6B,SAAQ,WAAW,CAC3D,wBAAwB,EACxB,qCAAqC,EACrC,qCAAqC,EACrC,SAAS,CAAC,wBAAwB,CAAC,EACnC,OAAO,CACR;gBACa,MAAM,EAAE,SAAS;IAI7B;;;OAGG;IACH,KAAK,CACH,KAAK,CAAC,EAAE,SAAS,CAAC,wBAAwB,CAAC,EAC3C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAO7B;;;;OAIG;IACH,WAAW,CACT,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,gCAAgC,CAAC;IAO5C;;;;OAIG;IACM,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAInF;;;;OAIG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAI5E;;;;OAIG;IACH,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjE;;;OAGG;IACH,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CAG7E"}

package/dist/apis/whatsappBusinessTemplates/WhatsappBusinessTemplatesApi.mjs

@@ -50,8 +50,7 @@ var WhatsappBusinessTemplatesApi = class extends BaseCrudApi {
 		return this.client.post(`${this.basePath}/refresh-templates`, void 0, headers);
 	}
 	/**
-	* Reads the template balance from 360Dialog. The backend looks for the 360Dialog connection on the whole platform,
-	* not only in the account, and calls 360Dialog when it finds one.
+	* Reads the template balance from 360Dialog (an external call, when there is a 360Dialog connection).
 	* @permissions hsm.view
 	*/
 	resume(headers) {

package/dist/apis/whatsappBusinessTemplates/WhatsappBusinessTemplatesApi.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"WhatsappBusinessTemplatesApi.mjs","names":[],"sources":["../../../src/apis/whatsappBusinessTemplates/WhatsappBusinessTemplatesApi.ts"],"sourcesContent":["import type { ApiClient } from '../../core/ApiClient'\nimport type { ListQuery } from '../../core/types'\nimport { BaseCrudApi } from '../../core/BaseCrudApi'\nimport type {\n  WhatsappBusinessTemplate,\n  CreateWhatsappBusinessTemplatePayload,\n  UpdateWhatsappBusinessTemplatePayload,\n  WhatsappBusinessTemplateHsmLimit,\n} from './types'\n\n/**\n * WhatsApp Business templates. Create, update, reads and count are local; `sendToReview`, `refreshTemplates`,\n * `resume` and the delete of a template of a `whatsapp-business` connection call the provider (Meta, 360Dialog).\n * `getById` answers `null` for an unknown id.\n */\nexport class WhatsappBusinessTemplatesApi extends BaseCrudApi<\n  WhatsappBusinessTemplate,\n  CreateWhatsappBusinessTemplatePayload,\n  UpdateWhatsappBusinessTemplatePayload,\n  ListQuery<WhatsappBusinessTemplate>,\n  unknown\n> {\n  constructor(client: ApiClient) {\n    super(client, '/whatsapp-business-templates')\n  }\n\n  /**\n   * Counts the templates matching the query.\n   * @permissions hsm.view\n   */\n  count(\n    query?: ListQuery<WhatsappBusinessTemplate>,\n    headers?: Record<string, string>,\n  ): Promise<{ count: number }> {\n    return this.client.get<{ count: number }>(\n      `${this.basePath}/count${this.toQueryString(query)}`,\n      headers,\n    )\n  }\n\n  /**\n   * Reads the template limit of the plan of the account. Send the `accountId` of the current user: the route is\n   * outside the error handler of the backend, so an unknown id gets no answer (the request waits for the timeout).\n   * @permissions hsm.view\n   */\n  getHsmLimit(\n    accountId: string,\n    headers?: Record<string, string>,\n  ): Promise<WhatsappBusinessTemplateHsmLimit> {\n    return this.client.get<WhatsappBusinessTemplateHsmLimit>(\n      `${this.basePath}/${accountId}/hsmLimit`,\n      headers,\n    )\n  }\n\n  /**\n   * Deletes a template. On a `whatsapp-business` connection it goes to the provider (and answers what it answers);\n   * a draft of another connection type is deleted locally (answers the stored template). An unknown id answers 500.\n   * @permissions hsm.view OR hsm.destroy\n   */\n  override deleteById(id: string, headers?: Record<string, string>): Promise<unknown> {\n    return super.deleteById(id, headers)\n  }\n\n  /**\n   * SENDS the template to Meta for approval (through the provider of the connection). An unknown or archived\n   * template answers 500 before anything is sent.\n   * @permissions hsm.view OR hsm.send OR hsm.send.before.expire\n   */\n  sendToReview(id: string, headers?: Record<string, string>): Promise<unknown> {\n    return this.client.post<unknown>(`${this.basePath}/${id}/send-to-review`, undefined, headers)\n  }\n\n  /**\n   * Reads the templates of the connected `whatsapp-business` connections from the provider and syncs them (it may\n   * archive the local templates the provider no longer has). Resolves the text `'OK'`.\n   * @permissions hsm.view\n   */\n  refreshTemplates(headers?: Record<string, string>): Promise<'OK'> {\n    return this.client.post<'OK'>(`${this.basePath}/refresh-templates`, undefined, headers)\n  }\n\n  /**\n   * Reads the template balance from 360Dialog. The backend looks for the 360Dialog connection on the whole platform,\n   * not only in the account, and calls 360Dialog when it finds one.\n   * @permissions hsm.view\n   */\n  resume(headers?: Record<string, string>): Promise<Record<string, unknown>[]> {\n    return this.client.get<Record<string, unknown>[]>(`${this.basePath}/resume`, headers)\n  }\n}\n"],"mappings":";;;;;;;;AAeA,IAAa,+BAAb,cAAkD,YAMhD;CACA,YAAY,QAAmB;AAC7B,QAAM,QAAQ,+BAA+B;;;;;;CAO/C,MACE,OACA,SAC4B;AAC5B,SAAO,KAAK,OAAO,IACjB,GAAG,KAAK,SAAS,QAAQ,KAAK,cAAc,MAAM,IAClD,QACD;;;;;;;CAQH,YACE,WACA,SAC2C;AAC3C,SAAO,KAAK,OAAO,IACjB,GAAG,KAAK,SAAS,GAAG,UAAU,YAC9B,QACD;;;;;;;CAQH,AAAS,WAAW,IAAY,SAAoD;AAClF,SAAO,MAAM,WAAW,IAAI,QAAQ;;;;;;;CAQtC,aAAa,IAAY,SAAoD;AAC3E,SAAO,KAAK,OAAO,KAAc,GAAG,KAAK,SAAS,GAAG,GAAG,kBAAkB,QAAW,QAAQ;;;;;;;CAQ/F,iBAAiB,SAAiD;AAChE,SAAO,KAAK,OAAO,KAAW,GAAG,KAAK,SAAS,qBAAqB,QAAW,QAAQ;;;;;;;CAQzF,OAAO,SAAsE;AAC3E,SAAO,KAAK,OAAO,IAA+B,GAAG,KAAK,SAAS,UAAU,QAAQ"}
+{"version":3,"file":"WhatsappBusinessTemplatesApi.mjs","names":[],"sources":["../../../src/apis/whatsappBusinessTemplates/WhatsappBusinessTemplatesApi.ts"],"sourcesContent":["import type { ApiClient } from '../../core/ApiClient'\nimport type { ListQuery } from '../../core/types'\nimport { BaseCrudApi } from '../../core/BaseCrudApi'\nimport type {\n  WhatsappBusinessTemplate,\n  CreateWhatsappBusinessTemplatePayload,\n  UpdateWhatsappBusinessTemplatePayload,\n  WhatsappBusinessTemplateHsmLimit,\n} from './types'\n\n/**\n * WhatsApp Business templates. Create, update, reads and count are local; `sendToReview`, `refreshTemplates`,\n * `resume` and the delete of a template of a `whatsapp-business` connection call the provider (Meta, 360Dialog).\n * `getById` answers `null` for an unknown id.\n */\nexport class WhatsappBusinessTemplatesApi extends BaseCrudApi<\n  WhatsappBusinessTemplate,\n  CreateWhatsappBusinessTemplatePayload,\n  UpdateWhatsappBusinessTemplatePayload,\n  ListQuery<WhatsappBusinessTemplate>,\n  unknown\n> {\n  constructor(client: ApiClient) {\n    super(client, '/whatsapp-business-templates')\n  }\n\n  /**\n   * Counts the templates matching the query.\n   * @permissions hsm.view\n   */\n  count(\n    query?: ListQuery<WhatsappBusinessTemplate>,\n    headers?: Record<string, string>,\n  ): Promise<{ count: number }> {\n    return this.client.get<{ count: number }>(\n      `${this.basePath}/count${this.toQueryString(query)}`,\n      headers,\n    )\n  }\n\n  /**\n   * Reads the template limit of the plan of the account. Send the `accountId` of the current user: the route is\n   * outside the error handler of the backend, so an unknown id gets no answer (the request waits for the timeout).\n   * @permissions hsm.view\n   */\n  getHsmLimit(\n    accountId: string,\n    headers?: Record<string, string>,\n  ): Promise<WhatsappBusinessTemplateHsmLimit> {\n    return this.client.get<WhatsappBusinessTemplateHsmLimit>(\n      `${this.basePath}/${accountId}/hsmLimit`,\n      headers,\n    )\n  }\n\n  /**\n   * Deletes a template. On a `whatsapp-business` connection it goes to the provider (and answers what it answers);\n   * a draft of another connection type is deleted locally (answers the stored template). An unknown id answers 500.\n   * @permissions hsm.view OR hsm.destroy\n   */\n  override deleteById(id: string, headers?: Record<string, string>): Promise<unknown> {\n    return super.deleteById(id, headers)\n  }\n\n  /**\n   * SENDS the template to Meta for approval (through the provider of the connection). An unknown or archived\n   * template answers 500 before anything is sent.\n   * @permissions hsm.view OR hsm.send OR hsm.send.before.expire\n   */\n  sendToReview(id: string, headers?: Record<string, string>): Promise<unknown> {\n    return this.client.post<unknown>(`${this.basePath}/${id}/send-to-review`, undefined, headers)\n  }\n\n  /**\n   * Reads the templates of the connected `whatsapp-business` connections from the provider and syncs them (it may\n   * archive the local templates the provider no longer has). Resolves the text `'OK'`.\n   * @permissions hsm.view\n   */\n  refreshTemplates(headers?: Record<string, string>): Promise<'OK'> {\n    return this.client.post<'OK'>(`${this.basePath}/refresh-templates`, undefined, headers)\n  }\n\n  /**\n   * Reads the template balance from 360Dialog (an external call, when there is a 360Dialog connection).\n   * @permissions hsm.view\n   */\n  resume(headers?: Record<string, string>): Promise<Record<string, unknown>[]> {\n    return this.client.get<Record<string, unknown>[]>(`${this.basePath}/resume`, headers)\n  }\n}\n"],"mappings":";;;;;;;;AAeA,IAAa,+BAAb,cAAkD,YAMhD;CACA,YAAY,QAAmB;AAC7B,QAAM,QAAQ,+BAA+B;;;;;;CAO/C,MACE,OACA,SAC4B;AAC5B,SAAO,KAAK,OAAO,IACjB,GAAG,KAAK,SAAS,QAAQ,KAAK,cAAc,MAAM,IAClD,QACD;;;;;;;CAQH,YACE,WACA,SAC2C;AAC3C,SAAO,KAAK,OAAO,IACjB,GAAG,KAAK,SAAS,GAAG,UAAU,YAC9B,QACD;;;;;;;CAQH,AAAS,WAAW,IAAY,SAAoD;AAClF,SAAO,MAAM,WAAW,IAAI,QAAQ;;;;;;;CAQtC,aAAa,IAAY,SAAoD;AAC3E,SAAO,KAAK,OAAO,KAAc,GAAG,KAAK,SAAS,GAAG,GAAG,kBAAkB,QAAW,QAAQ;;;;;;;CAQ/F,iBAAiB,SAAiD;AAChE,SAAO,KAAK,OAAO,KAAW,GAAG,KAAK,SAAS,qBAAqB,QAAW,QAAQ;;;;;;CAOzF,OAAO,SAAsE;AAC3E,SAAO,KAAK,OAAO,IAA+B,GAAG,KAAK,SAAS,UAAU,QAAQ"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ikatec/digisac-api-sdk",
-  "version": "4.12.0",
+  "version": "4.13.0",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",

package/src/apis/absence/AbsenceApi.test.ts

@@ -0,0 +1,65 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest'
+import { AbsenceApi } from './AbsenceApi'
+import type { ApiClient } from '../../core/ApiClient'
+
+// ── Mock client factory ──────────────────────────────────────────────
+
+function createMockClient(): ApiClient {
+  return {
+    setAccessToken: vi.fn().mockReturnThis(),
+    request: vi.fn(),
+    requestRaw: vi.fn(),
+    get: vi.fn(),
+    post: vi.fn(),
+    put: vi.fn(),
+    patch: vi.fn(),
+    delete: vi.fn(),
+  }
+}
+
+// ── Tests ────────────────────────────────────────────────────────────
+
+describe('AbsenceApi', () => {
+  let client: ReturnType<typeof createMockClient>
+  let api: AbsenceApi
+
+  beforeEach(() => {
+    client = createMockClient()
+    api = new AbsenceApi(client)
+  })
+
+  it('report serializes the query of the report', async () => {
+    vi.mocked(client.get).mockResolvedValue({ data: [] })
+    await api.report({
+      filters: { reason: 'Almoço' },
+      sort: 'createdAt',
+      order: 'ASC',
+      perPage: 50,
+    })
+    const url = vi.mocked(client.get).mock.calls[0]?.[0] as string
+    expect(url).toMatch(/^\/absence\?/)
+    expect(decodeURIComponent(url)).toContain('"filters":{"reason":"Almoço"}')
+  })
+
+  it('findOpenAbsence calls client.get with /absence/find-open-absence', async () => {
+    vi.mocked(client.get).mockResolvedValue(null)
+    await expect(api.findOpenAbsence()).resolves.toBeNull()
+    expect(client.get).toHaveBeenCalledWith('/absence/find-open-absence', undefined)
+  })
+
+  it('unlock posts the body to /absence/unlock', async () => {
+    vi.mocked(client.post).mockResolvedValue({ success: false, message: 'INVALID_REASON' })
+    await expect(api.unlock({ reason: 'Voltei' })).resolves.toEqual({
+      success: false,
+      message: 'INVALID_REASON',
+    })
+    expect(client.post).toHaveBeenCalledWith('/absence/unlock', { reason: 'Voltei' }, undefined)
+  })
+
+  it('exportCsv calls client.get with /absence/export-csv and the query', async () => {
+    vi.mocked(client.get).mockResolvedValue('Usuário,De,Até,Motivo')
+    await api.exportCsv({ timezone: 'America/Sao_Paulo' })
+    const url = vi.mocked(client.get).mock.calls[0]?.[0] as string
+    expect(url).toMatch(/^\/absence\/export-csv\?/)
+  })
+})

package/src/apis/absence/AbsenceApi.ts

@@ -1,17 +1,90 @@
 import type { ApiClient } from '../../core/ApiClient'
 import { BaseCrudApi } from '../../core/BaseCrudApi'
-import type { GetByIdQuery } from '../../core/types'
-import type { Absence, CreateAbsencePayload, UpdateAbsencePayload } from './types'
+import type { GetByIdQuery, Paginated } from '../../core/types'
+import type {
+  Absence,
+  AbsenceReportItem,
+  AbsenceReportQuery,
+  CreateAbsencePayload,
+  UnlockAbsencePayload,
+  UnlockAbsenceResponse,
+  UpdateAbsencePayload,
+} from './types'
 
 /**
- * Absences of the users. The backend serves the report (`GET /absence`), `POST /absence` and
- * `PUT /absence/:id`; there is no read by id nor delete.
+ * Absences of the users. The backend serves the report (`GET /absence`, `GET /absence/export-csv`),
+ * `GET /absence/find-open-absence`, `POST /absence`, `POST /absence/unlock` and `PUT /absence/:id`; there is
+ * no read by id nor delete. Creating an absence sets the status of the user to `away` and `unlock` sets it
+ * back to `online` (both emit `user.updated` to the webhooks).
  */
 export class AbsenceApi extends BaseCrudApi<Absence, CreateAbsencePayload, UpdateAbsencePayload> {
   constructor(client: ApiClient) {
     super(client, '/absence')
   }
 
+  /**
+   * The absence report of the account (`GET /absence`), always paginated, with its own query (the rows are
+   * raw: see `AbsenceReportItem`). Prefer it to `getMany`, whose `where`/`include`/`paginate` the backend
+   * ignores. Requires both permissions, always: without them it answers 403
+   * `MISSING_ABSENCE_REPORT_PERMISSION`.
+   * @permissions overview.absence.view AND myAccount.absence
+   */
+  report(
+    query?: AbsenceReportQuery,
+    headers?: Record<string, string>,
+  ): Promise<Paginated<AbsenceReportItem>> {
+    return this.client.get<Paginated<AbsenceReportItem>>(
+      `${this.basePath}${this.toQueryString(query)}`,
+      headers,
+    )
+  }
+
+  /**
+   * Creates an absence for the current user (whatever `userId` says) and sets the user `away`. Resolves the
+   * stored absence (raw, without `user`).
+   * @permissions myAccount.absence
+   */
+  override create(body: CreateAbsencePayload, headers?: Record<string, string>): Promise<Absence> {
+    return super.create(body, headers)
+  }
+
+  /**
+   * The open absence of the current user, or `null` — also `null` while `settings.absence.enabled` is off.
+   * @permissions myAccount.absence
+   */
+  findOpenAbsence(headers?: Record<string, string>): Promise<AbsenceReportItem | null> {
+    return this.client.get<AbsenceReportItem | null>(`${this.basePath}/find-open-absence`, headers)
+  }
+
+  /**
+   * Ends an absence (the open one of the user when `id` is absent) and sets the user `online`. The refusals
+   * of `settings.absence` come with status 200 (`INVALID_REASON`, `INVALID_PASSWORD`); without an open
+   * absence it answers 500.
+   * @permissions myAccount.absence
+   */
+  unlock(
+    body: UnlockAbsencePayload,
+    headers?: Record<string, string>,
+  ): Promise<UnlockAbsenceResponse> {
+    return this.client.post<UnlockAbsenceResponse, UnlockAbsencePayload>(
+      `${this.basePath}/unlock`,
+      body,
+      headers,
+    )
+  }
+
+  /**
+   * Exports the report as CSV (`Usuário, De, Até, Motivo`; an open absence shows `Em andamento`), sent as
+   * the attachment `<yyyy-MM-dd>_absence-control.csv`.
+   * @permissions overview.absence.view AND myAccount.absence
+   */
+  exportCsv(query?: AbsenceReportQuery, headers?: Record<string, string>): Promise<string> {
+    return this.client.get<string>(
+      `${this.basePath}/export-csv${this.toQueryString(query)}`,
+      headers,
+    )
+  }
+
   /** @deprecated Not served: the backend has no GET /absence/:id, so this route answers 404. */
   override getById(
     id: string,

package/src/apis/absence/types.ts

@@ -1,5 +1,6 @@
 import type { User } from '../users'
 
+/** An absence as `PUT /absence/:id` answers it (the transformer of the backend). */
 export type Absence = {
   id: string
   accountId: string
@@ -8,7 +9,8 @@ export type Absence = {
   endedAt: string | null
   createdAt: string
   updatedAt: string
-  deletedAt: string | null
+  /** @deprecated Not a field of the backend: the model has no soft delete. */
+  deletedAt?: string | null
   // relationships
   user?: User
 }
@@ -16,7 +18,9 @@ export type Absence = {
 export type AbsenceRelationships = 'user'
 
 export type CreateAbsencePayload = {
-  userId: string
+  /** Ignored: the backend creates the absence for the current user. */
+  userId?: string
+  /** Up to 255 characters. */
   reason?: string
 }
 
@@ -24,3 +28,50 @@ export type UpdateAbsencePayload = {
   reason?: string
   endedAt?: string | null
 }
+
+/** Columns the report can be sorted by (an unknown one falls back to the default order). */
+export type AbsenceReportSortField = 'user' | 'createdAt' | 'endedAt'
+
+/**
+ * Query of the absence report (`GET /absence` and `GET /absence/export-csv`). The backend ignores
+ * `where` and `include`: it reads only these fields.
+ */
+export type AbsenceReportQuery = {
+  filters?: {
+    userId?: string
+    reason?: string
+    /** Absences created at or after this date. An invalid date answers 400 `Invalid date.`. */
+    createdAt?: string
+    /** Absences ended at or before this date. */
+    endedAt?: string
+  }
+  sort?: AbsenceReportSortField
+  /** Only `'ASC'` sorts ascending: any other value sorts descending. */
+  order?: 'ASC' | 'DESC'
+  page?: number
+  /** Up to 200 (a larger value is clamped, not refused). Defaults to 15. */
+  perPage?: number
+  /** IANA zone of the dates of the CSV export (e.g. `America/Sao_Paulo`). */
+  timezone?: string
+}
+
+/**
+ * A row of the report: the stored absence with its user, both raw (not transformed).
+ */
+export type AbsenceReportItem = Omit<Absence, 'deletedAt' | 'user'> & {
+  user?: Record<string, unknown>
+}
+
+/** The body of `unlock`: the absence to end (the open one of the user when `id` is absent). */
+export type UnlockAbsencePayload = {
+  id?: string
+  /** Required when `settings.absence.reason_required` is on. */
+  reason?: string
+  /** Required when `settings.absence.password_required` is on: the password of the user. */
+  password?: string
+}
+
+/** What `unlock` answers: the business refusals come with status 200. */
+export type UnlockAbsenceResponse =
+  | { success: true }
+  | { success: false; message: 'INVALID_REASON' | 'INVALID_PASSWORD' }

package/src/apis/activityLog/ActivityLogApi.test.ts

@@ -0,0 +1,44 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest'
+import { ActivityLogApi } from './ActivityLogApi'
+import type { ApiClient } from '../../core/ApiClient'
+
+// ── Mock client factory ──────────────────────────────────────────────
+
+function createMockClient(): ApiClient {
+  return {
+    setAccessToken: vi.fn().mockReturnThis(),
+    request: vi.fn(),
+    requestRaw: vi.fn(),
+    get: vi.fn(),
+    post: vi.fn(),
+    put: vi.fn(),
+    patch: vi.fn(),
+    delete: vi.fn(),
+  }
+}
+
+// ── Tests ────────────────────────────────────────────────────────────
+
+describe('ActivityLogApi', () => {
+  let client: ReturnType<typeof createMockClient>
+  let api: ActivityLogApi
+
+  beforeEach(() => {
+    client = createMockClient()
+    api = new ActivityLogApi(client)
+  })
+
+  it('exportCsv calls client.get with /log/export-csv and the period', async () => {
+    vi.mocked(client.get).mockResolvedValue('csv')
+    await api.exportCsv({ filters: { from: '2026-10-01', to: '2026-10-17' } })
+    const url = vi.mocked(client.get).mock.calls[0]?.[0] as string
+    expect(url).toMatch(/^\/log\/export-csv\?/)
+    expect(decodeURIComponent(url)).toContain('"from":"2026-10-01"')
+  })
+
+  it('create posts the stored fields of the log', async () => {
+    const body = { resourceType: 'contact', resourceId: 'c-1', event: 'update', data: { a: 1 } }
+    await api.create(body)
+    expect(client.post).toHaveBeenCalledWith('/log', body, undefined)
+  })
+})

package/src/apis/activityLog/ActivityLogApi.ts

@@ -1,20 +1,39 @@
 import type { ApiClient } from '../../core/ApiClient'
 import { BaseCrudApi } from '../../core/BaseCrudApi'
-import type { ActivityLog, CreateActivityLogPayload, UpdateActivityLogPayload } from './types'
+import type {
+  ActivityLog,
+  ActivityLogListQuery,
+  CreateActivityLogPayload,
+  UpdateActivityLogPayload,
+} from './types'
 
 /**
  * Activity log of the account (stored in MongoDB: the routes answer 503 when it is unavailable).
- * The backend serves `GET /log`, `GET /log/:id` and `POST /log`; there is no update or delete.
+ * The backend serves `GET /log`, `GET /log/export-csv`, `GET /log/:id` and `POST /log`; there is no update
+ * or delete, so an entry created is permanent. `GET /log/:id` takes a MongoDB
+ * id (an UUID answers 500).
  */
 export class ActivityLogApi extends BaseCrudApi<
   ActivityLog,
   CreateActivityLogPayload,
-  UpdateActivityLogPayload
+  UpdateActivityLogPayload,
+  ActivityLogListQuery
 > {
   constructor(client: ApiClient) {
     super(client, '/log')
   }
 
+  /**
+   * Exports the entries of the period (`filters.from`/`filters.to`) as CSV, sent as the attachment
+   * `exportation.csv`.
+   */
+  exportCsv(query: ActivityLogListQuery, headers?: Record<string, string>): Promise<string> {
+    return this.client.get<string>(
+      `${this.basePath}/export-csv${this.toQueryString(query)}`,
+      headers,
+    )
+  }
+
   /** @deprecated Not served: the backend has no PUT /log/:id, so this route answers 404. */
   override updateById(
     id: string,

package/src/apis/activityLog/types.ts

@@ -1,22 +1,61 @@
+import type { ListQuery } from '../../core/types'
+
+/**
+ * An entry of the activity log (MongoDB). The stored fields are `resourceType`, `resourceId`, `event`,
+ * `userId`, `accessTokenId` and `data`. `create` and `getById` answer through a transformer that keeps only
+ * `id`, `accountId`, `createdAt` and `updatedAt`; the list answers every stored field plus `user`.
+ */
 export type ActivityLog = {
   id: string
   accountId: string
-  userId: string | null
-  action: string
-  entity: string
-  entityId: string | null
-  data: Record<string, unknown>
+  resourceType?: string
+  resourceId?: string | null
+  event?: string
+  userId?: string | null
+  accessTokenId?: string | null
+  data?: Record<string, unknown>
   createdAt: string
   updatedAt: string
+  /** On the list: the user of the entry. */
+  user?: { id: string; name: string }
+  /** @deprecated Not a field of the backend (it is dropped on create): use `event`. */
+  action?: string
+  /** @deprecated Not a field of the backend (it is dropped on create): use `resourceType`. */
+  entity?: string
+  /** @deprecated Not a field of the backend (it is dropped on create): use `resourceId`. */
+  entityId?: string | null
 }
 
 export type CreateActivityLogPayload = {
-  action: string
-  entity: string
-  entityId?: string
+  resourceType?: string
+  resourceId?: string
+  event?: string
+  userId?: string
+  accessTokenId?: string
   data?: Record<string, unknown>
+  /** @deprecated Dropped by the backend (not a field of the log): use `event`. */
+  action?: string
+  /** @deprecated Dropped by the backend (not a field of the log): use `resourceType`. */
+  entity?: string
+  /** @deprecated Dropped by the backend (not a field of the log): use `resourceId`. */
+  entityId?: string
 }
 
 export type UpdateActivityLogPayload = {
   data?: Record<string, unknown>
 }
+
+/**
+ * Query of the list and of the CSV export. The backend requires `filters.from` and `filters.to` (the
+ * period of `createdAt`); the other `filters` match the stored fields.
+ */
+export type ActivityLogListQuery = ListQuery<ActivityLog> & {
+  filters?: {
+    from?: string
+    to?: string
+    resourceType?: string
+    resourceId?: string
+    event?: string
+    userId?: string
+  }
+}