@ikatec/digisac-api-sdk 4.11.0 → 4.13.0

package/dist/apis/knowledgeBaseItem/KnowledgeBaseItemApi.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"KnowledgeBaseItemApi.cjs","names":["BaseCrudApi"],"sources":["../../../src/apis/knowledgeBaseItem/KnowledgeBaseItemApi.ts"],"sourcesContent":["import type { ApiClient } from '../../core/ApiClient'\nimport type { ListQuery } from '../../core/types'\nimport { BaseCrudApi } from '../../core/BaseCrudApi'\nimport type {\n  KnowledgeBaseItem,\n  CreateKnowledgeBaseItemPayload,\n  UpdateKnowledgeBaseItemPayload,\n} from './types'\n\nexport class KnowledgeBaseItemApi extends BaseCrudApi<\n  KnowledgeBaseItem,\n  CreateKnowledgeBaseItemPayload,\n  UpdateKnowledgeBaseItemPayload,\n  ListQuery<KnowledgeBaseItem>,\n  false\n> {\n  constructor(client: ApiClient) {\n    super(client, '/knowledge-base-item')\n  }\n\n  /**\n   * Deletes a knowledge base item (and its documents in the AI service). Resolves `false` even when\n   * it deleted (the backend answers nothing from the deletion), so do not read it as the result:\n   * check with `getById`.\n   */\n  override deleteById(id: string, headers?: Record<string, string>): Promise<false> {\n    return super.deleteById(id, headers)\n  }\n}\n"],"mappings":";;;;AASA,IAAa,uBAAb,cAA0CA,qCAMxC;CACA,YAAY,QAAmB;AAC7B,QAAM,QAAQ,uBAAuB;;;;;;;CAQvC,AAAS,WAAW,IAAY,SAAkD;AAChF,SAAO,MAAM,WAAW,IAAI,QAAQ"}
+{"version":3,"file":"KnowledgeBaseItemApi.cjs","names":["BaseCrudApi"],"sources":["../../../src/apis/knowledgeBaseItem/KnowledgeBaseItemApi.ts"],"sourcesContent":["import type { ApiClient } from '../../core/ApiClient'\nimport type { ListQuery } from '../../core/types'\nimport { BaseCrudApi } from '../../core/BaseCrudApi'\nimport type {\n  KnowledgeBaseItem,\n  CreateKnowledgeBaseItemPayload,\n  UpdateKnowledgeBaseItemPayload,\n} from './types'\n\n/**\n * Items of the knowledge bases. Creating an item VECTORIZES its content in the AI service; reading the\n * `docs` (include, `fetchMany`) reads them from it.\n */\nexport class KnowledgeBaseItemApi extends BaseCrudApi<\n  KnowledgeBaseItem,\n  CreateKnowledgeBaseItemPayload,\n  UpdateKnowledgeBaseItemPayload,\n  ListQuery<KnowledgeBaseItem>,\n  false\n> {\n  constructor(client: ApiClient) {\n    super(client, '/knowledge-base-item')\n  }\n\n  /**\n   * Deletes a knowledge base item (and its documents in the AI service). Resolves `false` even when\n   * it deleted (the backend answers nothing from the deletion), so do not read it as the result:\n   * check with `getById`.\n   */\n  override deleteById(id: string, headers?: Record<string, string>): Promise<false> {\n    return super.deleteById(id, headers)\n  }\n\n  /**\n   * Reads the items of `ids` with their documents (read from the AI service). Resolves the stored items, raw:\n   * unlike the other reads they carry `knowledgeBaseId`, `fileId` and `deletedAt`. An empty or absent `ids`\n   * answers 400 `Invalid knowledge base item ids`.\n   */\n  fetchMany(ids: string[], headers?: Record<string, string>): Promise<KnowledgeBaseItem[]> {\n    return this.client.post<KnowledgeBaseItem[], { ids: string[] }>(\n      `${this.basePath}/fetch-many`,\n      { ids },\n      headers,\n    )\n  }\n\n  /**\n   * Deletes the items of `ids` of the account (soft delete; their documents stay in the AI service).\n   * Resolves `true`; an empty or absent `ids` answers 400 `Invalid knowledge base item ids`.\n   */\n  deleteMany(ids: string[], headers?: Record<string, string>): Promise<true> {\n    return this.client.request<true, { ids: string[] }>(\n      'DELETE',\n      `${this.basePath}/many`,\n      { ids },\n      headers,\n    )\n  }\n\n  /**\n   * Tells whether the PDF of `fileId` has text to be vectorized (read locally, no AI). Without `fileId` it\n   * resolves `{ hasText: false }`.\n   */\n  checkPdfText(\n    body: { fileId?: string },\n    headers?: Record<string, string>,\n  ): Promise<{ hasText: boolean }> {\n    return this.client.post<{ hasText: boolean }, { fileId?: string }>(\n      `${this.basePath}/check-pdf-text`,\n      body,\n      headers,\n    )\n  }\n}\n"],"mappings":";;;;;;;;AAaA,IAAa,uBAAb,cAA0CA,qCAMxC;CACA,YAAY,QAAmB;AAC7B,QAAM,QAAQ,uBAAuB;;;;;;;CAQvC,AAAS,WAAW,IAAY,SAAkD;AAChF,SAAO,MAAM,WAAW,IAAI,QAAQ;;;;;;;CAQtC,UAAU,KAAe,SAAgE;AACvF,SAAO,KAAK,OAAO,KACjB,GAAG,KAAK,SAAS,cACjB,EAAE,KAAK,EACP,QACD;;;;;;CAOH,WAAW,KAAe,SAAiD;AACzE,SAAO,KAAK,OAAO,QACjB,UACA,GAAG,KAAK,SAAS,QACjB,EAAE,KAAK,EACP,QACD;;;;;;CAOH,aACE,MACA,SAC+B;AAC/B,SAAO,KAAK,OAAO,KACjB,GAAG,KAAK,SAAS,kBACjB,MACA,QACD"}

package/dist/apis/knowledgeBaseItem/KnowledgeBaseItemApi.d.ts

@@ -2,6 +2,10 @@ import type { ApiClient } from '../../core/ApiClient';
 import type { ListQuery } from '../../core/types';
 import { BaseCrudApi } from '../../core/BaseCrudApi';
 import type { KnowledgeBaseItem, CreateKnowledgeBaseItemPayload, UpdateKnowledgeBaseItemPayload } from './types';
+/**
+ * Items of the knowledge bases. Creating an item VECTORIZES its content in the AI service; reading the
+ * `docs` (include, `fetchMany`) reads them from it.
+ */
 export declare class KnowledgeBaseItemApi extends BaseCrudApi<KnowledgeBaseItem, CreateKnowledgeBaseItemPayload, UpdateKnowledgeBaseItemPayload, ListQuery<KnowledgeBaseItem>, false> {
     constructor(client: ApiClient);
     /**
@@ -10,5 +14,25 @@ export declare class KnowledgeBaseItemApi extends BaseCrudApi<KnowledgeBaseItem,
      * check with `getById`.
      */
     deleteById(id: string, headers?: Record<string, string>): Promise<false>;
+    /**
+     * Reads the items of `ids` with their documents (read from the AI service). Resolves the stored items, raw:
+     * unlike the other reads they carry `knowledgeBaseId`, `fileId` and `deletedAt`. An empty or absent `ids`
+     * answers 400 `Invalid knowledge base item ids`.
+     */
+    fetchMany(ids: string[], headers?: Record<string, string>): Promise<KnowledgeBaseItem[]>;
+    /**
+     * Deletes the items of `ids` of the account (soft delete; their documents stay in the AI service).
+     * Resolves `true`; an empty or absent `ids` answers 400 `Invalid knowledge base item ids`.
+     */
+    deleteMany(ids: string[], headers?: Record<string, string>): Promise<true>;
+    /**
+     * Tells whether the PDF of `fileId` has text to be vectorized (read locally, no AI). Without `fileId` it
+     * resolves `{ hasText: false }`.
+     */
+    checkPdfText(body: {
+        fileId?: string;
+    }, headers?: Record<string, string>): Promise<{
+        hasText: boolean;
+    }>;
 }
 //# sourceMappingURL=KnowledgeBaseItemApi.d.ts.map

package/dist/apis/knowledgeBaseItem/KnowledgeBaseItemApi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"KnowledgeBaseItemApi.d.ts","sourceRoot":"","sources":["../../../src/apis/knowledgeBaseItem/KnowledgeBaseItemApi.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,iBAAiB,EACjB,8BAA8B,EAC9B,8BAA8B,EAC/B,MAAM,SAAS,CAAA;AAEhB,qBAAa,oBAAqB,SAAQ,WAAW,CACnD,iBAAiB,EACjB,8BAA8B,EAC9B,8BAA8B,EAC9B,SAAS,CAAC,iBAAiB,CAAC,EAC5B,KAAK,CACN;gBACa,MAAM,EAAE,SAAS;IAI7B;;;;OAIG;IACM,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;CAGlF"}
+{"version":3,"file":"KnowledgeBaseItemApi.d.ts","sourceRoot":"","sources":["../../../src/apis/knowledgeBaseItem/KnowledgeBaseItemApi.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,iBAAiB,EACjB,8BAA8B,EAC9B,8BAA8B,EAC/B,MAAM,SAAS,CAAA;AAEhB;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,WAAW,CACnD,iBAAiB,EACjB,8BAA8B,EAC9B,8BAA8B,EAC9B,SAAS,CAAC,iBAAiB,CAAC,EAC5B,KAAK,CACN;gBACa,MAAM,EAAE,SAAS;IAI7B;;;;OAIG;IACM,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;IAIjF;;;;OAIG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAQxF;;;OAGG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAS1E;;;OAGG;IACH,YAAY,CACV,IAAI,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,EACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;CAOjC"}

package/dist/apis/knowledgeBaseItem/KnowledgeBaseItemApi.mjs

@@ -1,6 +1,10 @@
 import { BaseCrudApi } from "../../core/BaseCrudApi.mjs";
 
 //#region src/apis/knowledgeBaseItem/KnowledgeBaseItemApi.ts
+/**
+* Items of the knowledge bases. Creating an item VECTORIZES its content in the AI service; reading the
+* `docs` (include, `fetchMany`) reads them from it.
+*/
 var KnowledgeBaseItemApi = class extends BaseCrudApi {
 	constructor(client) {
 		super(client, "/knowledge-base-item");
@@ -13,6 +17,28 @@ var KnowledgeBaseItemApi = class extends BaseCrudApi {
 	deleteById(id, headers) {
 		return super.deleteById(id, headers);
 	}
+	/**
+	* Reads the items of `ids` with their documents (read from the AI service). Resolves the stored items, raw:
+	* unlike the other reads they carry `knowledgeBaseId`, `fileId` and `deletedAt`. An empty or absent `ids`
+	* answers 400 `Invalid knowledge base item ids`.
+	*/
+	fetchMany(ids, headers) {
+		return this.client.post(`${this.basePath}/fetch-many`, { ids }, headers);
+	}
+	/**
+	* Deletes the items of `ids` of the account (soft delete; their documents stay in the AI service).
+	* Resolves `true`; an empty or absent `ids` answers 400 `Invalid knowledge base item ids`.
+	*/
+	deleteMany(ids, headers) {
+		return this.client.request("DELETE", `${this.basePath}/many`, { ids }, headers);
+	}
+	/**
+	* Tells whether the PDF of `fileId` has text to be vectorized (read locally, no AI). Without `fileId` it
+	* resolves `{ hasText: false }`.
+	*/
+	checkPdfText(body, headers) {
+		return this.client.post(`${this.basePath}/check-pdf-text`, body, headers);
+	}
 };
 
 //#endregion

package/dist/apis/knowledgeBaseItem/KnowledgeBaseItemApi.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"KnowledgeBaseItemApi.mjs","names":[],"sources":["../../../src/apis/knowledgeBaseItem/KnowledgeBaseItemApi.ts"],"sourcesContent":["import type { ApiClient } from '../../core/ApiClient'\nimport type { ListQuery } from '../../core/types'\nimport { BaseCrudApi } from '../../core/BaseCrudApi'\nimport type {\n  KnowledgeBaseItem,\n  CreateKnowledgeBaseItemPayload,\n  UpdateKnowledgeBaseItemPayload,\n} from './types'\n\nexport class KnowledgeBaseItemApi extends BaseCrudApi<\n  KnowledgeBaseItem,\n  CreateKnowledgeBaseItemPayload,\n  UpdateKnowledgeBaseItemPayload,\n  ListQuery<KnowledgeBaseItem>,\n  false\n> {\n  constructor(client: ApiClient) {\n    super(client, '/knowledge-base-item')\n  }\n\n  /**\n   * Deletes a knowledge base item (and its documents in the AI service). Resolves `false` even when\n   * it deleted (the backend answers nothing from the deletion), so do not read it as the result:\n   * check with `getById`.\n   */\n  override deleteById(id: string, headers?: Record<string, string>): Promise<false> {\n    return super.deleteById(id, headers)\n  }\n}\n"],"mappings":";;;AASA,IAAa,uBAAb,cAA0C,YAMxC;CACA,YAAY,QAAmB;AAC7B,QAAM,QAAQ,uBAAuB;;;;;;;CAQvC,AAAS,WAAW,IAAY,SAAkD;AAChF,SAAO,MAAM,WAAW,IAAI,QAAQ"}
+{"version":3,"file":"KnowledgeBaseItemApi.mjs","names":[],"sources":["../../../src/apis/knowledgeBaseItem/KnowledgeBaseItemApi.ts"],"sourcesContent":["import type { ApiClient } from '../../core/ApiClient'\nimport type { ListQuery } from '../../core/types'\nimport { BaseCrudApi } from '../../core/BaseCrudApi'\nimport type {\n  KnowledgeBaseItem,\n  CreateKnowledgeBaseItemPayload,\n  UpdateKnowledgeBaseItemPayload,\n} from './types'\n\n/**\n * Items of the knowledge bases. Creating an item VECTORIZES its content in the AI service; reading the\n * `docs` (include, `fetchMany`) reads them from it.\n */\nexport class KnowledgeBaseItemApi extends BaseCrudApi<\n  KnowledgeBaseItem,\n  CreateKnowledgeBaseItemPayload,\n  UpdateKnowledgeBaseItemPayload,\n  ListQuery<KnowledgeBaseItem>,\n  false\n> {\n  constructor(client: ApiClient) {\n    super(client, '/knowledge-base-item')\n  }\n\n  /**\n   * Deletes a knowledge base item (and its documents in the AI service). Resolves `false` even when\n   * it deleted (the backend answers nothing from the deletion), so do not read it as the result:\n   * check with `getById`.\n   */\n  override deleteById(id: string, headers?: Record<string, string>): Promise<false> {\n    return super.deleteById(id, headers)\n  }\n\n  /**\n   * Reads the items of `ids` with their documents (read from the AI service). Resolves the stored items, raw:\n   * unlike the other reads they carry `knowledgeBaseId`, `fileId` and `deletedAt`. An empty or absent `ids`\n   * answers 400 `Invalid knowledge base item ids`.\n   */\n  fetchMany(ids: string[], headers?: Record<string, string>): Promise<KnowledgeBaseItem[]> {\n    return this.client.post<KnowledgeBaseItem[], { ids: string[] }>(\n      `${this.basePath}/fetch-many`,\n      { ids },\n      headers,\n    )\n  }\n\n  /**\n   * Deletes the items of `ids` of the account (soft delete; their documents stay in the AI service).\n   * Resolves `true`; an empty or absent `ids` answers 400 `Invalid knowledge base item ids`.\n   */\n  deleteMany(ids: string[], headers?: Record<string, string>): Promise<true> {\n    return this.client.request<true, { ids: string[] }>(\n      'DELETE',\n      `${this.basePath}/many`,\n      { ids },\n      headers,\n    )\n  }\n\n  /**\n   * Tells whether the PDF of `fileId` has text to be vectorized (read locally, no AI). Without `fileId` it\n   * resolves `{ hasText: false }`.\n   */\n  checkPdfText(\n    body: { fileId?: string },\n    headers?: Record<string, string>,\n  ): Promise<{ hasText: boolean }> {\n    return this.client.post<{ hasText: boolean }, { fileId?: string }>(\n      `${this.basePath}/check-pdf-text`,\n      body,\n      headers,\n    )\n  }\n}\n"],"mappings":";;;;;;;AAaA,IAAa,uBAAb,cAA0C,YAMxC;CACA,YAAY,QAAmB;AAC7B,QAAM,QAAQ,uBAAuB;;;;;;;CAQvC,AAAS,WAAW,IAAY,SAAkD;AAChF,SAAO,MAAM,WAAW,IAAI,QAAQ;;;;;;;CAQtC,UAAU,KAAe,SAAgE;AACvF,SAAO,KAAK,OAAO,KACjB,GAAG,KAAK,SAAS,cACjB,EAAE,KAAK,EACP,QACD;;;;;;CAOH,WAAW,KAAe,SAAiD;AACzE,SAAO,KAAK,OAAO,QACjB,UACA,GAAG,KAAK,SAAS,QACjB,EAAE,KAAK,EACP,QACD;;;;;;CAOH,aACE,MACA,SAC+B;AAC/B,SAAO,KAAK,OAAO,KACjB,GAAG,KAAK,SAAS,kBACjB,MACA,QACD"}

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

@@ -1,30 +1,47 @@
 import type { File } from '../files/types';
 import type { KnowledgeBase } from '../knowledgeBase/types';
+/** An item as the transformer answers it (no `knowledgeBaseId`, `fileId` nor `deletedAt`). */
 export type KnowledgeBaseItem = {
     id: string;
     name: string;
-    type: string;
+    type: 'urls' | 'files' | 'messages' | (string & {});
     sourceId: string | null;
     url: string | null;
     accountId: string;
-    knowledgeBaseId: string;
-    fileId: string | null;
+    /** @deprecated Not answered: the transformer of the backend does not send it. */
+    knowledgeBaseId?: string;
+    /** @deprecated Not answered: the transformer of the backend does not send it. */
+    fileId?: string | null;
     createdAt: string;
     updatedAt: string;
-    deletedAt: string | null;
+    /** @deprecated Not answered: the transformer of the backend does not send it. */
+    deletedAt?: string | null;
+    /** @deprecated Not served: the include is dropped by the backend. */
     knowledgeBase?: KnowledgeBase;
     file?: File | null;
+    /** The vectorized documents (the include reads them from the AI service). */
+    docs?: Record<string, unknown>[];
+    account?: Record<string, unknown>;
 };
-export type KnowledgeBaseItemRelationships = 'knowledgeBase' | 'file';
+export type KnowledgeBaseItemRelationships = 'knowledgeBase' | 'file' | 'docs' | 'account';
+/**
+ * Creates an item and VECTORIZES its content in the AI service right away: `text` (type `messages`), `url`
+ * (type `urls`, the service fetches the page) or `fileId` (type `files`). Without any of the three it
+ * answers 400 `You must provide fileId, text, or url`.
+ */
 export type CreateKnowledgeBaseItemPayload = {
     name: string;
-    type: string;
+    type: 'urls' | 'files' | 'messages' | (string & {});
     knowledgeBaseId: string;
+    /** @deprecated Ignored by the backend. */
     sourceId?: string;
+    text?: string;
     url?: string;
     fileId?: string;
 };
+/** The backend requires `name`, `type` and `knowledgeBaseId` on the update too (400 without them). */
 export type UpdateKnowledgeBaseItemPayload = {
+    knowledgeBaseId?: string;
     name?: string;
     type?: string;
     sourceId?: string | null;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/apis/knowledgeBaseItem/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAE3D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,eAAe,EAAE,MAAM,CAAA;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IAExB,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,8BAA8B,GAAG,eAAe,GAAG,MAAM,CAAA;AAErE,MAAM,MAAM,8BAA8B,GAAG;IAC3C,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,eAAe,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,8BAA8B,GAAG;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/apis/knowledgeBaseItem/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAE3D,8FAA8F;AAC9F,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;IACnD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,iFAAiF;IACjF,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,iFAAiF;IACjF,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAEzB,qEAAqE;IACrE,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;IAClB,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC,CAAA;AAED,MAAM,MAAM,8BAA8B,GAAG,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;AAE1F;;;;GAIG;AACH,MAAM,MAAM,8BAA8B,GAAG;IAC3C,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;IACnD,eAAe,EAAE,MAAM,CAAA;IACvB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,sGAAsG;AACtG,MAAM,MAAM,8BAA8B,GAAG;IAC3C,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB,CAAA"}

package/dist/apis/me/MeApi.cjs

@@ -2,62 +2,69 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_core_BaseApi = require('../../core/BaseApi.cjs');
 
 //#region src/apis/me/MeApi.ts
+/**
+* A query object always has an array or an object among its values; the headers only have strings (a header that
+* comes as `undefined` at runtime stays a header). That tells the two apart in the methods that took only the
+* headers before and now take a query first.
+*/
+function splitQueryAndHeaders(queryOrHeaders, headers) {
+	return !!queryOrHeaders && Object.values(queryOrHeaders).some((value) => typeof value === "object" && value !== null) ? [queryOrHeaders, headers] : [void 0, queryOrHeaders];
+}
 var MeApi = class extends require_core_BaseApi.BaseApi {
-	/**
-	* Returns the currently authenticated user, including their roles, departments, and timetable.
-	* @permissions users.view
-	*/
-	getMe(headers) {
-		return this.client.get("/me", headers);
+	getMe(queryOrHeaders, headers) {
+		const [query, sent] = splitQueryAndHeaders(queryOrHeaders, headers);
+		return this.client.get(`/me${this.toQueryString(query)}`, sent);
 	}
-	/** Returns the account associated with the currently authenticated user. */
-	getAccount(headers) {
-		return this.client.get("/me/account", headers);
+	getAccount(queryOrHeaders, headers) {
+		const [query, sent] = splitQueryAndHeaders(queryOrHeaders, headers);
+		return this.client.get(`/me/account${this.toQueryString(query)}`, sent);
 	}
-	/**
-	* Returns credit and usage amounts for the current account.
-	* Excludes Digisac's own internal credit amounts.
-	*/
-	getAccountAmounts(headers) {
-		return this.client.get("/me/get-account-amounts", headers);
+	getAccountAmounts(queryOrHeaders, headers) {
+		const [query, sent] = splitQueryAndHeaders(queryOrHeaders, headers);
+		const queryString = query ? this.toQueryString({ filter: query.filter.join(",") }) : "";
+		return this.client.get(`/me/get-account-amounts${queryString}`, sent);
 	}
 	/**
-	* Returns a URL to the Agnus billing/plan management page for the current account.
+	* Returns a URL to the Agnus billing/plan management page for the current account. Calls Agnus (an external
+	* service) and, for accounts without credits control, reports the consumption to it first.
 	* @permissions myAccount.myPlan
 	*/
 	getAgnusMyPlanUrl(headers) {
 		return this.client.get("/me/account/agnus-my-plan-url", headers);
 	}
 	/**
-	* Updates the current user's profile fields such as name, language, and preferences.
-	* If a new password is provided, it is validated against the last 6 password history entries
-	* and all existing access tokens for the user are revoked.
+	* Updates the current user's profile fields such as name, language, and preferences (`data` and `preferences`
+	* replace the stored objects). A new `password` needs `currentPassword` and a recent login, is validated against
+	* the last 6 passwords, and revokes the access tokens with an expiration — including the one of this request.
 	*/
 	updateMe(body, headers) {
 		return this.client.put("/me", body, headers);
 	}
-	/** Updates account-level settings such as name, settings object, wizard progress, and default department. */
+	/**
+	* Updates account-level settings such as name, settings object, wizard progress, and default department. It
+	* applies to the whole account; the default department is required while the tickets are enabled.
+	*/
 	updateAccount(body, headers) {
 		return this.client.put("/me/account", body, headers);
 	}
 	/**
-	* Updates the presence status of the current user (`online`, `offline`, or `away`).
+	* Updates the presence status of the current user (`online`, `offline`, or `away`) for a `client`.
 	* If setting to `online`, validates the user's timetable first — if outside working hours,
-	* the status is set to `offline` instead.
+	* the status is set to `offline` instead. Resolves the status fields of the user.
 	*/
 	updateStatus(body, headers) {
 		return this.client.put("/me/status", body, headers);
 	}
 	/**
-	* Extends the grace period for the current account when it has expired or is about to expire.
-	* Returns the updated account.
+	* Extends the grace period for the current account when it has expired or is about to expire, and notifies the
+	* billing webhook. Returns the updated account; an account not in a grace period answers 400.
 	*/
 	extendAccountGracePeriod(headers) {
 		return this.client.post("/me/account/extend-grace-period", void 0, headers);
 	}
 	/**
-	* Registers a OneSignal push notification token for the current user.
-	* Used to enable push notifications on mobile/web clients.
+	* Registers the push notification tokens of the current user (`data` replaces the whole `data` of the user).
+	* Resolves with no body.
 	*/
 	registerToken(body, headers) {
 		return this.client.post("/me/one-signal/register-token", body, headers);
@@ -67,8 +74,8 @@ var MeApi = class extends require_core_BaseApi.BaseApi {
 		return this.client.post("/me/report-login", void 0, headers);
 	}
 	/**
-	* Sets the current user's status to `online` for the given client and emits a takeover event,
-	* which signals other connected sessions to yield control to this one.
+	* Sets the current user's status to `online` for the given client (`'web'` by default) and emits a takeover
+	* event, which signals other connected sessions to yield control to this one. Resolves with no body.
 	*/
 	takeover(body, headers) {
 		return this.client.post("/me/takeover", body, headers);
@@ -83,7 +90,7 @@ var MeApi = class extends require_core_BaseApi.BaseApi {
 	/**
 	* Activates OTP (two-factor) authentication for the current user.
 	* Requires the `x-digisac-otp` header with a valid TOTP token generated from the secret key
-	* previously set via `setOtpSecretKey`.
+	* previously set via `setOtpSecretKey`. Resolves the text `'OK'`.
 	*/
 	activateOtpAuth(headers) {
 		return this.client.post("/me/activate-otp-auth", void 0, headers);

package/dist/apis/me/MeApi.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"MeApi.cjs","names":["BaseApi"],"sources":["../../../src/apis/me/MeApi.ts"],"sourcesContent":["import { BaseApi } from '../../core/BaseApi'\nimport type { Account } from '../accounts/types'\nimport type { User } from '../users/types'\nimport type {\n  RegisterTokenPayload,\n  SetOtpSecretKeyPayload,\n  TakeoverPayload,\n  UpdateMeAccountPayload,\n  UpdateMePayload,\n  UpdateMeStatusPayload,\n} from './types'\n\nexport class MeApi extends BaseApi {\n  /**\n   * Returns the currently authenticated user, including their roles, departments, and timetable.\n   * @permissions users.view\n   */\n  getMe(headers?: Record<string, string>): Promise<User> {\n    return this.client.get<User>('/me', headers)\n  }\n\n  /** Returns the account associated with the currently authenticated user. */\n  getAccount(headers?: Record<string, string>): Promise<Account> {\n    return this.client.get<Account>('/me/account', headers)\n  }\n\n  /**\n   * Returns credit and usage amounts for the current account.\n   * Excludes Digisac's own internal credit amounts.\n   */\n  getAccountAmounts(headers?: Record<string, string>): Promise<Record<string, unknown>> {\n    return this.client.get<Record<string, unknown>>('/me/get-account-amounts', headers)\n  }\n\n  /**\n   * Returns a URL to the Agnus billing/plan management page for the current account.\n   * @permissions myAccount.myPlan\n   */\n  getAgnusMyPlanUrl(headers?: Record<string, string>): Promise<{ url: string }> {\n    return this.client.get<{ url: string }>('/me/account/agnus-my-plan-url', headers)\n  }\n\n  /**\n   * Updates the current user's profile fields such as name, language, and preferences.\n   * If a new password is provided, it is validated against the last 6 password history entries\n   * and all existing access tokens for the user are revoked.\n   */\n  updateMe(body: UpdateMePayload, headers?: Record<string, string>): Promise<User> {\n    return this.client.put<User, UpdateMePayload>('/me', body, headers)\n  }\n\n  /** Updates account-level settings such as name, settings object, wizard progress, and default department. */\n  updateAccount(body: UpdateMeAccountPayload, headers?: Record<string, string>): Promise<Account> {\n    return this.client.put<Account, UpdateMeAccountPayload>('/me/account', body, headers)\n  }\n\n  /**\n   * Updates the presence status of the current user (`online`, `offline`, or `away`).\n   * If setting to `online`, validates the user's timetable first — if outside working hours,\n   * the status is set to `offline` instead.\n   */\n  updateStatus(body: UpdateMeStatusPayload, headers?: Record<string, string>): Promise<User> {\n    return this.client.put<User, UpdateMeStatusPayload>('/me/status', body, headers)\n  }\n\n  /**\n   * Extends the grace period for the current account when it has expired or is about to expire.\n   * Returns the updated account.\n   */\n  extendAccountGracePeriod(headers?: Record<string, string>): Promise<Account> {\n    return this.client.post<Account>('/me/account/extend-grace-period', undefined, headers)\n  }\n\n  /**\n   * Registers a OneSignal push notification token for the current user.\n   * Used to enable push notifications on mobile/web clients.\n   */\n  registerToken(body: RegisterTokenPayload, headers?: Record<string, string>): Promise<void> {\n    return this.client.post<void, RegisterTokenPayload>(\n      '/me/one-signal/register-token',\n      body,\n      headers,\n    )\n  }\n\n  /** Marks the current user's first login as complete by setting `isFirstLogin` to `false`. */\n  reportFirstLogin(headers?: Record<string, string>): Promise<User> {\n    return this.client.post<User>('/me/report-login', undefined, headers)\n  }\n\n  /**\n   * Sets the current user's status to `online` for the given client and emits a takeover event,\n   * which signals other connected sessions to yield control to this one.\n   */\n  takeover(body?: TakeoverPayload, headers?: Record<string, string>): Promise<void> {\n    return this.client.post<void, TakeoverPayload>('/me/takeover', body, headers)\n  }\n\n  /**\n   * Stores a 16-character OTP secret key on the current user.\n   * This must be called before activating OTP authentication via `activateOtpAuth`.\n   */\n  setOtpSecretKey(body: SetOtpSecretKeyPayload, headers?: Record<string, string>): Promise<void> {\n    return this.client.patch<void, SetOtpSecretKeyPayload>('/me/set-otp-secret-key', body, headers)\n  }\n\n  /**\n   * Activates OTP (two-factor) authentication for the current user.\n   * Requires the `x-digisac-otp` header with a valid TOTP token generated from the secret key\n   * previously set via `setOtpSecretKey`.\n   */\n  activateOtpAuth(headers?: Record<string, string>): Promise<boolean> {\n    return this.client.post<boolean>('/me/activate-otp-auth', undefined, headers)\n  }\n}\n"],"mappings":";;;;AAYA,IAAa,QAAb,cAA2BA,6BAAQ;;;;;CAKjC,MAAM,SAAiD;AACrD,SAAO,KAAK,OAAO,IAAU,OAAO,QAAQ;;;CAI9C,WAAW,SAAoD;AAC7D,SAAO,KAAK,OAAO,IAAa,eAAe,QAAQ;;;;;;CAOzD,kBAAkB,SAAoE;AACpF,SAAO,KAAK,OAAO,IAA6B,2BAA2B,QAAQ;;;;;;CAOrF,kBAAkB,SAA4D;AAC5E,SAAO,KAAK,OAAO,IAAqB,iCAAiC,QAAQ;;;;;;;CAQnF,SAAS,MAAuB,SAAiD;AAC/E,SAAO,KAAK,OAAO,IAA2B,OAAO,MAAM,QAAQ;;;CAIrE,cAAc,MAA8B,SAAoD;AAC9F,SAAO,KAAK,OAAO,IAAqC,eAAe,MAAM,QAAQ;;;;;;;CAQvF,aAAa,MAA6B,SAAiD;AACzF,SAAO,KAAK,OAAO,IAAiC,cAAc,MAAM,QAAQ;;;;;;CAOlF,yBAAyB,SAAoD;AAC3E,SAAO,KAAK,OAAO,KAAc,mCAAmC,QAAW,QAAQ;;;;;;CAOzF,cAAc,MAA4B,SAAiD;AACzF,SAAO,KAAK,OAAO,KACjB,iCACA,MACA,QACD;;;CAIH,iBAAiB,SAAiD;AAChE,SAAO,KAAK,OAAO,KAAW,oBAAoB,QAAW,QAAQ;;;;;;CAOvE,SAAS,MAAwB,SAAiD;AAChF,SAAO,KAAK,OAAO,KAA4B,gBAAgB,MAAM,QAAQ;;;;;;CAO/E,gBAAgB,MAA8B,SAAiD;AAC7F,SAAO,KAAK,OAAO,MAAoC,0BAA0B,MAAM,QAAQ;;;;;;;CAQjG,gBAAgB,SAAoD;AAClE,SAAO,KAAK,OAAO,KAAc,yBAAyB,QAAW,QAAQ"}
+{"version":3,"file":"MeApi.cjs","names":["BaseApi"],"sources":["../../../src/apis/me/MeApi.ts"],"sourcesContent":["import { BaseApi } from '../../core/BaseApi'\nimport type { Account } from '../accounts/types'\nimport type { User } from '../users/types'\nimport type {\n  AccountAmounts,\n  AccountAmountsQuery,\n  MeAccountQuery,\n  MeQuery,\n  MeStatusResponse,\n  RegisterTokenPayload,\n  SetOtpSecretKeyPayload,\n  TakeoverPayload,\n  UpdateMeAccountPayload,\n  UpdateMePayload,\n  UpdateMeStatusPayload,\n} from './types'\n\n/**\n * A query object always has an array or an object among its values; the headers only have strings (a header that\n * comes as `undefined` at runtime stays a header). That tells the two apart in the methods that took only the\n * headers before and now take a query first.\n */\nfunction splitQueryAndHeaders<TQuery extends object>(\n  queryOrHeaders: TQuery | Record<string, string> | undefined,\n  headers: Record<string, string> | undefined,\n): [TQuery | undefined, Record<string, string> | undefined] {\n  const isQuery =\n    !!queryOrHeaders &&\n    Object.values(queryOrHeaders).some((value) => typeof value === 'object' && value !== null)\n  return isQuery\n    ? [queryOrHeaders as TQuery, headers]\n    : [undefined, queryOrHeaders as Record<string, string> | undefined]\n}\n\nexport class MeApi extends BaseApi {\n  /**\n   * Returns the currently authenticated user. Without `include`, the user comes without relations (roles,\n   * departments, timetable, account).\n   * @permissions users.view\n   */\n  getMe(headers?: Record<string, string>): Promise<User>\n  getMe(query: MeQuery, headers?: Record<string, string>): Promise<User>\n  getMe(\n    queryOrHeaders?: MeQuery | Record<string, string>,\n    headers?: Record<string, string>,\n  ): Promise<User> {\n    const [query, sent] = splitQueryAndHeaders<MeQuery>(queryOrHeaders, headers)\n    return this.client.get<User>(`/me${this.toQueryString(query)}`, sent)\n  }\n\n  /**\n   * Returns the account of the current user. Send `where.id` with the `accountId` of the user (what the web app\n   * does): without it, the route answers 500.\n   */\n  getAccount(headers?: Record<string, string>): Promise<Account>\n  getAccount(query: MeAccountQuery, headers?: Record<string, string>): Promise<Account>\n  getAccount(\n    queryOrHeaders?: MeAccountQuery | Record<string, string>,\n    headers?: Record<string, string>,\n  ): Promise<Account> {\n    const [query, sent] = splitQueryAndHeaders<MeAccountQuery>(queryOrHeaders, headers)\n    return this.client.get<Account>(`/me/account${this.toQueryString(query)}`, sent)\n  }\n\n  /**\n   * Returns the amounts of the current account named in `filter` (services and/or users). The credit amounts are\n   * never answered here. An account without credits control answers 400.\n   */\n  getAccountAmounts(headers?: Record<string, string>): Promise<AccountAmounts>\n  getAccountAmounts(\n    query: AccountAmountsQuery,\n    headers?: Record<string, string>,\n  ): Promise<AccountAmounts>\n  getAccountAmounts(\n    queryOrHeaders?: AccountAmountsQuery | Record<string, string>,\n    headers?: Record<string, string>,\n  ): Promise<AccountAmounts> {\n    const [query, sent] = splitQueryAndHeaders<AccountAmountsQuery>(queryOrHeaders, headers)\n    const queryString = query ? this.toQueryString({ filter: query.filter.join(',') }) : ''\n    return this.client.get<AccountAmounts>(`/me/get-account-amounts${queryString}`, sent)\n  }\n\n  /**\n   * Returns a URL to the Agnus billing/plan management page for the current account. Calls Agnus (an external\n   * service) and, for accounts without credits control, reports the consumption to it first.\n   * @permissions myAccount.myPlan\n   */\n  getAgnusMyPlanUrl(headers?: Record<string, string>): Promise<{ url: string }> {\n    return this.client.get<{ url: string }>('/me/account/agnus-my-plan-url', headers)\n  }\n\n  /**\n   * Updates the current user's profile fields such as name, language, and preferences (`data` and `preferences`\n   * replace the stored objects). A new `password` needs `currentPassword` and a recent login, is validated against\n   * the last 6 passwords, and revokes the access tokens with an expiration — including the one of this request.\n   */\n  updateMe(body: UpdateMePayload, headers?: Record<string, string>): Promise<User> {\n    return this.client.put<User, UpdateMePayload>('/me', body, headers)\n  }\n\n  /**\n   * Updates account-level settings such as name, settings object, wizard progress, and default department. It\n   * applies to the whole account; the default department is required while the tickets are enabled.\n   */\n  updateAccount(body: UpdateMeAccountPayload, headers?: Record<string, string>): Promise<Account> {\n    return this.client.put<Account, UpdateMeAccountPayload>('/me/account', body, headers)\n  }\n\n  /**\n   * Updates the presence status of the current user (`online`, `offline`, or `away`) for a `client`.\n   * If setting to `online`, validates the user's timetable first — if outside working hours,\n   * the status is set to `offline` instead. Resolves the status fields of the user.\n   */\n  updateStatus(\n    body: UpdateMeStatusPayload,\n    headers?: Record<string, string>,\n  ): Promise<MeStatusResponse> {\n    return this.client.put<MeStatusResponse, UpdateMeStatusPayload>('/me/status', body, headers)\n  }\n\n  /**\n   * Extends the grace period for the current account when it has expired or is about to expire, and notifies the\n   * billing webhook. Returns the updated account; an account not in a grace period answers 400.\n   */\n  extendAccountGracePeriod(headers?: Record<string, string>): Promise<Account> {\n    return this.client.post<Account>('/me/account/extend-grace-period', undefined, headers)\n  }\n\n  /**\n   * Registers the push notification tokens of the current user (`data` replaces the whole `data` of the user).\n   * Resolves with no body.\n   */\n  registerToken(body: RegisterTokenPayload, headers?: Record<string, string>): Promise<void> {\n    return this.client.post<void, RegisterTokenPayload>(\n      '/me/one-signal/register-token',\n      body,\n      headers,\n    )\n  }\n\n  /** Marks the current user's first login as complete by setting `isFirstLogin` to `false`. */\n  reportFirstLogin(headers?: Record<string, string>): Promise<User> {\n    return this.client.post<User>('/me/report-login', undefined, headers)\n  }\n\n  /**\n   * Sets the current user's status to `online` for the given client (`'web'` by default) and emits a takeover\n   * event, which signals other connected sessions to yield control to this one. Resolves with no body.\n   */\n  takeover(body?: TakeoverPayload, headers?: Record<string, string>): Promise<void> {\n    return this.client.post<void, TakeoverPayload>('/me/takeover', body, headers)\n  }\n\n  /**\n   * Stores a 16-character OTP secret key on the current user.\n   * This must be called before activating OTP authentication via `activateOtpAuth`.\n   */\n  setOtpSecretKey(body: SetOtpSecretKeyPayload, headers?: Record<string, string>): Promise<void> {\n    return this.client.patch<void, SetOtpSecretKeyPayload>('/me/set-otp-secret-key', body, headers)\n  }\n\n  /**\n   * Activates OTP (two-factor) authentication for the current user.\n   * Requires the `x-digisac-otp` header with a valid TOTP token generated from the secret key\n   * previously set via `setOtpSecretKey`. Resolves the text `'OK'`.\n   */\n  activateOtpAuth(headers?: Record<string, string>): Promise<'OK'> {\n    return this.client.post<'OK'>('/me/activate-otp-auth', undefined, headers)\n  }\n}\n"],"mappings":";;;;;;;;;AAsBA,SAAS,qBACP,gBACA,SAC0D;AAI1D,QAFE,CAAC,CAAC,kBACF,OAAO,OAAO,eAAe,CAAC,MAAM,UAAU,OAAO,UAAU,YAAY,UAAU,KAAK,GAExF,CAAC,gBAA0B,QAAQ,GACnC,CAAC,QAAW,eAAqD;;AAGvE,IAAa,QAAb,cAA2BA,6BAAQ;CAQjC,MACE,gBACA,SACe;EACf,MAAM,CAAC,OAAO,QAAQ,qBAA8B,gBAAgB,QAAQ;AAC5E,SAAO,KAAK,OAAO,IAAU,MAAM,KAAK,cAAc,MAAM,IAAI,KAAK;;CASvE,WACE,gBACA,SACkB;EAClB,MAAM,CAAC,OAAO,QAAQ,qBAAqC,gBAAgB,QAAQ;AACnF,SAAO,KAAK,OAAO,IAAa,cAAc,KAAK,cAAc,MAAM,IAAI,KAAK;;CAYlF,kBACE,gBACA,SACyB;EACzB,MAAM,CAAC,OAAO,QAAQ,qBAA0C,gBAAgB,QAAQ;EACxF,MAAM,cAAc,QAAQ,KAAK,cAAc,EAAE,QAAQ,MAAM,OAAO,KAAK,IAAI,EAAE,CAAC,GAAG;AACrF,SAAO,KAAK,OAAO,IAAoB,0BAA0B,eAAe,KAAK;;;;;;;CAQvF,kBAAkB,SAA4D;AAC5E,SAAO,KAAK,OAAO,IAAqB,iCAAiC,QAAQ;;;;;;;CAQnF,SAAS,MAAuB,SAAiD;AAC/E,SAAO,KAAK,OAAO,IAA2B,OAAO,MAAM,QAAQ;;;;;;CAOrE,cAAc,MAA8B,SAAoD;AAC9F,SAAO,KAAK,OAAO,IAAqC,eAAe,MAAM,QAAQ;;;;;;;CAQvF,aACE,MACA,SAC2B;AAC3B,SAAO,KAAK,OAAO,IAA6C,cAAc,MAAM,QAAQ;;;;;;CAO9F,yBAAyB,SAAoD;AAC3E,SAAO,KAAK,OAAO,KAAc,mCAAmC,QAAW,QAAQ;;;;;;CAOzF,cAAc,MAA4B,SAAiD;AACzF,SAAO,KAAK,OAAO,KACjB,iCACA,MACA,QACD;;;CAIH,iBAAiB,SAAiD;AAChE,SAAO,KAAK,OAAO,KAAW,oBAAoB,QAAW,QAAQ;;;;;;CAOvE,SAAS,MAAwB,SAAiD;AAChF,SAAO,KAAK,OAAO,KAA4B,gBAAgB,MAAM,QAAQ;;;;;;CAO/E,gBAAgB,MAA8B,SAAiD;AAC7F,SAAO,KAAK,OAAO,MAAoC,0BAA0B,MAAM,QAAQ;;;;;;;CAQjG,gBAAgB,SAAiD;AAC/D,SAAO,KAAK,OAAO,KAAW,yBAAyB,QAAW,QAAQ"}

package/dist/apis/me/MeApi.d.ts

@@ -1,56 +1,67 @@
 import { BaseApi } from '../../core/BaseApi';
 import type { Account } from '../accounts/types';
 import type { User } from '../users/types';
-import type { RegisterTokenPayload, SetOtpSecretKeyPayload, TakeoverPayload, UpdateMeAccountPayload, UpdateMePayload, UpdateMeStatusPayload } from './types';
+import type { AccountAmounts, AccountAmountsQuery, MeAccountQuery, MeQuery, MeStatusResponse, RegisterTokenPayload, SetOtpSecretKeyPayload, TakeoverPayload, UpdateMeAccountPayload, UpdateMePayload, UpdateMeStatusPayload } from './types';
 export declare class MeApi extends BaseApi {
     /**
-     * Returns the currently authenticated user, including their roles, departments, and timetable.
+     * Returns the currently authenticated user. Without `include`, the user comes without relations (roles,
+     * departments, timetable, account).
      * @permissions users.view
      */
     getMe(headers?: Record<string, string>): Promise<User>;
-    /** Returns the account associated with the currently authenticated user. */
+    getMe(query: MeQuery, headers?: Record<string, string>): Promise<User>;
+    /**
+     * Returns the account of the current user. Send `where.id` with the `accountId` of the user (what the web app
+     * does): without it, the route answers 500.
+     */
     getAccount(headers?: Record<string, string>): Promise<Account>;
+    getAccount(query: MeAccountQuery, headers?: Record<string, string>): Promise<Account>;
     /**
-     * Returns credit and usage amounts for the current account.
-     * Excludes Digisac's own internal credit amounts.
+     * Returns the amounts of the current account named in `filter` (services and/or users). The credit amounts are
+     * never answered here. An account without credits control answers 400.
      */
-    getAccountAmounts(headers?: Record<string, string>): Promise<Record<string, unknown>>;
+    getAccountAmounts(headers?: Record<string, string>): Promise<AccountAmounts>;
+    getAccountAmounts(query: AccountAmountsQuery, headers?: Record<string, string>): Promise<AccountAmounts>;
     /**
-     * Returns a URL to the Agnus billing/plan management page for the current account.
+     * Returns a URL to the Agnus billing/plan management page for the current account. Calls Agnus (an external
+     * service) and, for accounts without credits control, reports the consumption to it first.
      * @permissions myAccount.myPlan
      */
     getAgnusMyPlanUrl(headers?: Record<string, string>): Promise<{
         url: string;
     }>;
     /**
-     * Updates the current user's profile fields such as name, language, and preferences.
-     * If a new password is provided, it is validated against the last 6 password history entries
-     * and all existing access tokens for the user are revoked.
+     * Updates the current user's profile fields such as name, language, and preferences (`data` and `preferences`
+     * replace the stored objects). A new `password` needs `currentPassword` and a recent login, is validated against
+     * the last 6 passwords, and revokes the access tokens with an expiration — including the one of this request.
      */
     updateMe(body: UpdateMePayload, headers?: Record<string, string>): Promise<User>;
-    /** Updates account-level settings such as name, settings object, wizard progress, and default department. */
+    /**
+     * Updates account-level settings such as name, settings object, wizard progress, and default department. It
+     * applies to the whole account; the default department is required while the tickets are enabled.
+     */
     updateAccount(body: UpdateMeAccountPayload, headers?: Record<string, string>): Promise<Account>;
     /**
-     * Updates the presence status of the current user (`online`, `offline`, or `away`).
+     * Updates the presence status of the current user (`online`, `offline`, or `away`) for a `client`.
      * If setting to `online`, validates the user's timetable first — if outside working hours,
-     * the status is set to `offline` instead.
+     * the status is set to `offline` instead. Resolves the status fields of the user.
      */
-    updateStatus(body: UpdateMeStatusPayload, headers?: Record<string, string>): Promise<User>;
+    updateStatus(body: UpdateMeStatusPayload, headers?: Record<string, string>): Promise<MeStatusResponse>;
     /**
-     * Extends the grace period for the current account when it has expired or is about to expire.
-     * Returns the updated account.
+     * Extends the grace period for the current account when it has expired or is about to expire, and notifies the
+     * billing webhook. Returns the updated account; an account not in a grace period answers 400.
      */
     extendAccountGracePeriod(headers?: Record<string, string>): Promise<Account>;
     /**
-     * Registers a OneSignal push notification token for the current user.
-     * Used to enable push notifications on mobile/web clients.
+     * Registers the push notification tokens of the current user (`data` replaces the whole `data` of the user).
+     * Resolves with no body.
      */
     registerToken(body: RegisterTokenPayload, headers?: Record<string, string>): Promise<void>;
     /** Marks the current user's first login as complete by setting `isFirstLogin` to `false`. */
     reportFirstLogin(headers?: Record<string, string>): Promise<User>;
     /**
-     * Sets the current user's status to `online` for the given client and emits a takeover event,
-     * which signals other connected sessions to yield control to this one.
+     * Sets the current user's status to `online` for the given client (`'web'` by default) and emits a takeover
+     * event, which signals other connected sessions to yield control to this one. Resolves with no body.
      */
     takeover(body?: TakeoverPayload, headers?: Record<string, string>): Promise<void>;
     /**
@@ -61,8 +72,8 @@ export declare class MeApi extends BaseApi {
     /**
      * Activates OTP (two-factor) authentication for the current user.
      * Requires the `x-digisac-otp` header with a valid TOTP token generated from the secret key
-     * previously set via `setOtpSecretKey`.
+     * previously set via `setOtpSecretKey`. Resolves the text `'OK'`.
      */
-    activateOtpAuth(headers?: Record<string, string>): Promise<boolean>;
+    activateOtpAuth(headers?: Record<string, string>): Promise<'OK'>;
 }
 //# sourceMappingURL=MeApi.d.ts.map

package/dist/apis/me/MeApi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MeApi.d.ts","sourceRoot":"","sources":["../../../src/apis/me/MeApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,KAAK,EACV,oBAAoB,EACpB,sBAAsB,EACtB,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,qBAAqB,EACtB,MAAM,SAAS,CAAA;AAEhB,qBAAa,KAAM,SAAQ,OAAO;IAChC;;;OAGG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAItD,4EAA4E;IAC5E,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9D;;;OAGG;IACH,iBAAiB,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAIrF;;;OAGG;IACH,iBAAiB,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAI7E;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhF,6GAA6G;IAC7G,aAAa,CAAC,IAAI,EAAE,sBAAsB,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAI/F;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,qBAAqB,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1F;;;OAGG;IACH,wBAAwB,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAI5E;;;OAGG;IACH,aAAa,CAAC,IAAI,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ1F,6FAA6F;IAC7F,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjE;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjF;;;OAGG;IACH,eAAe,CAAC,IAAI,EAAE,sBAAsB,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9F;;;;OAIG;IACH,eAAe,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;CAGpE"}
+{"version":3,"file":"MeApi.d.ts","sourceRoot":"","sources":["../../../src/apis/me/MeApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,KAAK,EACV,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,OAAO,EACP,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,EACtB,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,qBAAqB,EACtB,MAAM,SAAS,CAAA;AAmBhB,qBAAa,KAAM,SAAQ,OAAO;IAChC;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IACtD,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAStE;;;OAGG;IACH,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAC9D,UAAU,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IASrF;;;OAGG;IACH,iBAAiB,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC;IAC5E,iBAAiB,CACf,KAAK,EAAE,mBAAmB,EAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,cAAc,CAAC;IAU1B;;;;OAIG;IACH,iBAAiB,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAI7E;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhF;;;OAGG;IACH,aAAa,CAAC,IAAI,EAAE,sBAAsB,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAI/F;;;;OAIG;IACH,YAAY,CACV,IAAI,EAAE,qBAAqB,EAC3B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,gBAAgB,CAAC;IAI5B;;;OAGG;IACH,wBAAwB,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAI5E;;;OAGG;IACH,aAAa,CAAC,IAAI,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ1F,6FAA6F;IAC7F,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjE;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjF;;;OAGG;IACH,eAAe,CAAC,IAAI,EAAE,sBAAsB,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9F;;;;OAIG;IACH,eAAe,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAGjE"}

package/dist/apis/me/MeApi.mjs

@@ -1,62 +1,69 @@
 import { BaseApi } from "../../core/BaseApi.mjs";
 
 //#region src/apis/me/MeApi.ts
+/**
+* A query object always has an array or an object among its values; the headers only have strings (a header that
+* comes as `undefined` at runtime stays a header). That tells the two apart in the methods that took only the
+* headers before and now take a query first.
+*/
+function splitQueryAndHeaders(queryOrHeaders, headers) {
+	return !!queryOrHeaders && Object.values(queryOrHeaders).some((value) => typeof value === "object" && value !== null) ? [queryOrHeaders, headers] : [void 0, queryOrHeaders];
+}
 var MeApi = class extends BaseApi {
-	/**
-	* Returns the currently authenticated user, including their roles, departments, and timetable.
-	* @permissions users.view
-	*/
-	getMe(headers) {
-		return this.client.get("/me", headers);
+	getMe(queryOrHeaders, headers) {
+		const [query, sent] = splitQueryAndHeaders(queryOrHeaders, headers);
+		return this.client.get(`/me${this.toQueryString(query)}`, sent);
 	}
-	/** Returns the account associated with the currently authenticated user. */
-	getAccount(headers) {
-		return this.client.get("/me/account", headers);
+	getAccount(queryOrHeaders, headers) {
+		const [query, sent] = splitQueryAndHeaders(queryOrHeaders, headers);
+		return this.client.get(`/me/account${this.toQueryString(query)}`, sent);
 	}
-	/**
-	* Returns credit and usage amounts for the current account.
-	* Excludes Digisac's own internal credit amounts.
-	*/
-	getAccountAmounts(headers) {
-		return this.client.get("/me/get-account-amounts", headers);
+	getAccountAmounts(queryOrHeaders, headers) {
+		const [query, sent] = splitQueryAndHeaders(queryOrHeaders, headers);
+		const queryString = query ? this.toQueryString({ filter: query.filter.join(",") }) : "";
+		return this.client.get(`/me/get-account-amounts${queryString}`, sent);
 	}
 	/**
-	* Returns a URL to the Agnus billing/plan management page for the current account.
+	* Returns a URL to the Agnus billing/plan management page for the current account. Calls Agnus (an external
+	* service) and, for accounts without credits control, reports the consumption to it first.
 	* @permissions myAccount.myPlan
 	*/
 	getAgnusMyPlanUrl(headers) {
 		return this.client.get("/me/account/agnus-my-plan-url", headers);
 	}
 	/**
-	* Updates the current user's profile fields such as name, language, and preferences.
-	* If a new password is provided, it is validated against the last 6 password history entries
-	* and all existing access tokens for the user are revoked.
+	* Updates the current user's profile fields such as name, language, and preferences (`data` and `preferences`
+	* replace the stored objects). A new `password` needs `currentPassword` and a recent login, is validated against
+	* the last 6 passwords, and revokes the access tokens with an expiration — including the one of this request.
 	*/
 	updateMe(body, headers) {
 		return this.client.put("/me", body, headers);
 	}
-	/** Updates account-level settings such as name, settings object, wizard progress, and default department. */
+	/**
+	* Updates account-level settings such as name, settings object, wizard progress, and default department. It
+	* applies to the whole account; the default department is required while the tickets are enabled.
+	*/
 	updateAccount(body, headers) {
 		return this.client.put("/me/account", body, headers);
 	}
 	/**
-	* Updates the presence status of the current user (`online`, `offline`, or `away`).
+	* Updates the presence status of the current user (`online`, `offline`, or `away`) for a `client`.
 	* If setting to `online`, validates the user's timetable first — if outside working hours,
-	* the status is set to `offline` instead.
+	* the status is set to `offline` instead. Resolves the status fields of the user.
 	*/
 	updateStatus(body, headers) {
 		return this.client.put("/me/status", body, headers);
 	}
 	/**
-	* Extends the grace period for the current account when it has expired or is about to expire.
-	* Returns the updated account.
+	* Extends the grace period for the current account when it has expired or is about to expire, and notifies the
+	* billing webhook. Returns the updated account; an account not in a grace period answers 400.
 	*/
 	extendAccountGracePeriod(headers) {
 		return this.client.post("/me/account/extend-grace-period", void 0, headers);
 	}
 	/**
-	* Registers a OneSignal push notification token for the current user.
-	* Used to enable push notifications on mobile/web clients.
+	* Registers the push notification tokens of the current user (`data` replaces the whole `data` of the user).
+	* Resolves with no body.
 	*/
 	registerToken(body, headers) {
 		return this.client.post("/me/one-signal/register-token", body, headers);
@@ -66,8 +73,8 @@ var MeApi = class extends BaseApi {
 		return this.client.post("/me/report-login", void 0, headers);
 	}
 	/**
-	* Sets the current user's status to `online` for the given client and emits a takeover event,
-	* which signals other connected sessions to yield control to this one.
+	* Sets the current user's status to `online` for the given client (`'web'` by default) and emits a takeover
+	* event, which signals other connected sessions to yield control to this one. Resolves with no body.
 	*/
 	takeover(body, headers) {
 		return this.client.post("/me/takeover", body, headers);
@@ -82,7 +89,7 @@ var MeApi = class extends BaseApi {
 	/**
 	* Activates OTP (two-factor) authentication for the current user.
 	* Requires the `x-digisac-otp` header with a valid TOTP token generated from the secret key
-	* previously set via `setOtpSecretKey`.
+	* previously set via `setOtpSecretKey`. Resolves the text `'OK'`.
 	*/
 	activateOtpAuth(headers) {
 		return this.client.post("/me/activate-otp-auth", void 0, headers);

package/dist/apis/me/MeApi.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"MeApi.mjs","names":[],"sources":["../../../src/apis/me/MeApi.ts"],"sourcesContent":["import { BaseApi } from '../../core/BaseApi'\nimport type { Account } from '../accounts/types'\nimport type { User } from '../users/types'\nimport type {\n  RegisterTokenPayload,\n  SetOtpSecretKeyPayload,\n  TakeoverPayload,\n  UpdateMeAccountPayload,\n  UpdateMePayload,\n  UpdateMeStatusPayload,\n} from './types'\n\nexport class MeApi extends BaseApi {\n  /**\n   * Returns the currently authenticated user, including their roles, departments, and timetable.\n   * @permissions users.view\n   */\n  getMe(headers?: Record<string, string>): Promise<User> {\n    return this.client.get<User>('/me', headers)\n  }\n\n  /** Returns the account associated with the currently authenticated user. */\n  getAccount(headers?: Record<string, string>): Promise<Account> {\n    return this.client.get<Account>('/me/account', headers)\n  }\n\n  /**\n   * Returns credit and usage amounts for the current account.\n   * Excludes Digisac's own internal credit amounts.\n   */\n  getAccountAmounts(headers?: Record<string, string>): Promise<Record<string, unknown>> {\n    return this.client.get<Record<string, unknown>>('/me/get-account-amounts', headers)\n  }\n\n  /**\n   * Returns a URL to the Agnus billing/plan management page for the current account.\n   * @permissions myAccount.myPlan\n   */\n  getAgnusMyPlanUrl(headers?: Record<string, string>): Promise<{ url: string }> {\n    return this.client.get<{ url: string }>('/me/account/agnus-my-plan-url', headers)\n  }\n\n  /**\n   * Updates the current user's profile fields such as name, language, and preferences.\n   * If a new password is provided, it is validated against the last 6 password history entries\n   * and all existing access tokens for the user are revoked.\n   */\n  updateMe(body: UpdateMePayload, headers?: Record<string, string>): Promise<User> {\n    return this.client.put<User, UpdateMePayload>('/me', body, headers)\n  }\n\n  /** Updates account-level settings such as name, settings object, wizard progress, and default department. */\n  updateAccount(body: UpdateMeAccountPayload, headers?: Record<string, string>): Promise<Account> {\n    return this.client.put<Account, UpdateMeAccountPayload>('/me/account', body, headers)\n  }\n\n  /**\n   * Updates the presence status of the current user (`online`, `offline`, or `away`).\n   * If setting to `online`, validates the user's timetable first — if outside working hours,\n   * the status is set to `offline` instead.\n   */\n  updateStatus(body: UpdateMeStatusPayload, headers?: Record<string, string>): Promise<User> {\n    return this.client.put<User, UpdateMeStatusPayload>('/me/status', body, headers)\n  }\n\n  /**\n   * Extends the grace period for the current account when it has expired or is about to expire.\n   * Returns the updated account.\n   */\n  extendAccountGracePeriod(headers?: Record<string, string>): Promise<Account> {\n    return this.client.post<Account>('/me/account/extend-grace-period', undefined, headers)\n  }\n\n  /**\n   * Registers a OneSignal push notification token for the current user.\n   * Used to enable push notifications on mobile/web clients.\n   */\n  registerToken(body: RegisterTokenPayload, headers?: Record<string, string>): Promise<void> {\n    return this.client.post<void, RegisterTokenPayload>(\n      '/me/one-signal/register-token',\n      body,\n      headers,\n    )\n  }\n\n  /** Marks the current user's first login as complete by setting `isFirstLogin` to `false`. */\n  reportFirstLogin(headers?: Record<string, string>): Promise<User> {\n    return this.client.post<User>('/me/report-login', undefined, headers)\n  }\n\n  /**\n   * Sets the current user's status to `online` for the given client and emits a takeover event,\n   * which signals other connected sessions to yield control to this one.\n   */\n  takeover(body?: TakeoverPayload, headers?: Record<string, string>): Promise<void> {\n    return this.client.post<void, TakeoverPayload>('/me/takeover', body, headers)\n  }\n\n  /**\n   * Stores a 16-character OTP secret key on the current user.\n   * This must be called before activating OTP authentication via `activateOtpAuth`.\n   */\n  setOtpSecretKey(body: SetOtpSecretKeyPayload, headers?: Record<string, string>): Promise<void> {\n    return this.client.patch<void, SetOtpSecretKeyPayload>('/me/set-otp-secret-key', body, headers)\n  }\n\n  /**\n   * Activates OTP (two-factor) authentication for the current user.\n   * Requires the `x-digisac-otp` header with a valid TOTP token generated from the secret key\n   * previously set via `setOtpSecretKey`.\n   */\n  activateOtpAuth(headers?: Record<string, string>): Promise<boolean> {\n    return this.client.post<boolean>('/me/activate-otp-auth', undefined, headers)\n  }\n}\n"],"mappings":";;;AAYA,IAAa,QAAb,cAA2B,QAAQ;;;;;CAKjC,MAAM,SAAiD;AACrD,SAAO,KAAK,OAAO,IAAU,OAAO,QAAQ;;;CAI9C,WAAW,SAAoD;AAC7D,SAAO,KAAK,OAAO,IAAa,eAAe,QAAQ;;;;;;CAOzD,kBAAkB,SAAoE;AACpF,SAAO,KAAK,OAAO,IAA6B,2BAA2B,QAAQ;;;;;;CAOrF,kBAAkB,SAA4D;AAC5E,SAAO,KAAK,OAAO,IAAqB,iCAAiC,QAAQ;;;;;;;CAQnF,SAAS,MAAuB,SAAiD;AAC/E,SAAO,KAAK,OAAO,IAA2B,OAAO,MAAM,QAAQ;;;CAIrE,cAAc,MAA8B,SAAoD;AAC9F,SAAO,KAAK,OAAO,IAAqC,eAAe,MAAM,QAAQ;;;;;;;CAQvF,aAAa,MAA6B,SAAiD;AACzF,SAAO,KAAK,OAAO,IAAiC,cAAc,MAAM,QAAQ;;;;;;CAOlF,yBAAyB,SAAoD;AAC3E,SAAO,KAAK,OAAO,KAAc,mCAAmC,QAAW,QAAQ;;;;;;CAOzF,cAAc,MAA4B,SAAiD;AACzF,SAAO,KAAK,OAAO,KACjB,iCACA,MACA,QACD;;;CAIH,iBAAiB,SAAiD;AAChE,SAAO,KAAK,OAAO,KAAW,oBAAoB,QAAW,QAAQ;;;;;;CAOvE,SAAS,MAAwB,SAAiD;AAChF,SAAO,KAAK,OAAO,KAA4B,gBAAgB,MAAM,QAAQ;;;;;;CAO/E,gBAAgB,MAA8B,SAAiD;AAC7F,SAAO,KAAK,OAAO,MAAoC,0BAA0B,MAAM,QAAQ;;;;;;;CAQjG,gBAAgB,SAAoD;AAClE,SAAO,KAAK,OAAO,KAAc,yBAAyB,QAAW,QAAQ"}
+{"version":3,"file":"MeApi.mjs","names":[],"sources":["../../../src/apis/me/MeApi.ts"],"sourcesContent":["import { BaseApi } from '../../core/BaseApi'\nimport type { Account } from '../accounts/types'\nimport type { User } from '../users/types'\nimport type {\n  AccountAmounts,\n  AccountAmountsQuery,\n  MeAccountQuery,\n  MeQuery,\n  MeStatusResponse,\n  RegisterTokenPayload,\n  SetOtpSecretKeyPayload,\n  TakeoverPayload,\n  UpdateMeAccountPayload,\n  UpdateMePayload,\n  UpdateMeStatusPayload,\n} from './types'\n\n/**\n * A query object always has an array or an object among its values; the headers only have strings (a header that\n * comes as `undefined` at runtime stays a header). That tells the two apart in the methods that took only the\n * headers before and now take a query first.\n */\nfunction splitQueryAndHeaders<TQuery extends object>(\n  queryOrHeaders: TQuery | Record<string, string> | undefined,\n  headers: Record<string, string> | undefined,\n): [TQuery | undefined, Record<string, string> | undefined] {\n  const isQuery =\n    !!queryOrHeaders &&\n    Object.values(queryOrHeaders).some((value) => typeof value === 'object' && value !== null)\n  return isQuery\n    ? [queryOrHeaders as TQuery, headers]\n    : [undefined, queryOrHeaders as Record<string, string> | undefined]\n}\n\nexport class MeApi extends BaseApi {\n  /**\n   * Returns the currently authenticated user. Without `include`, the user comes without relations (roles,\n   * departments, timetable, account).\n   * @permissions users.view\n   */\n  getMe(headers?: Record<string, string>): Promise<User>\n  getMe(query: MeQuery, headers?: Record<string, string>): Promise<User>\n  getMe(\n    queryOrHeaders?: MeQuery | Record<string, string>,\n    headers?: Record<string, string>,\n  ): Promise<User> {\n    const [query, sent] = splitQueryAndHeaders<MeQuery>(queryOrHeaders, headers)\n    return this.client.get<User>(`/me${this.toQueryString(query)}`, sent)\n  }\n\n  /**\n   * Returns the account of the current user. Send `where.id` with the `accountId` of the user (what the web app\n   * does): without it, the route answers 500.\n   */\n  getAccount(headers?: Record<string, string>): Promise<Account>\n  getAccount(query: MeAccountQuery, headers?: Record<string, string>): Promise<Account>\n  getAccount(\n    queryOrHeaders?: MeAccountQuery | Record<string, string>,\n    headers?: Record<string, string>,\n  ): Promise<Account> {\n    const [query, sent] = splitQueryAndHeaders<MeAccountQuery>(queryOrHeaders, headers)\n    return this.client.get<Account>(`/me/account${this.toQueryString(query)}`, sent)\n  }\n\n  /**\n   * Returns the amounts of the current account named in `filter` (services and/or users). The credit amounts are\n   * never answered here. An account without credits control answers 400.\n   */\n  getAccountAmounts(headers?: Record<string, string>): Promise<AccountAmounts>\n  getAccountAmounts(\n    query: AccountAmountsQuery,\n    headers?: Record<string, string>,\n  ): Promise<AccountAmounts>\n  getAccountAmounts(\n    queryOrHeaders?: AccountAmountsQuery | Record<string, string>,\n    headers?: Record<string, string>,\n  ): Promise<AccountAmounts> {\n    const [query, sent] = splitQueryAndHeaders<AccountAmountsQuery>(queryOrHeaders, headers)\n    const queryString = query ? this.toQueryString({ filter: query.filter.join(',') }) : ''\n    return this.client.get<AccountAmounts>(`/me/get-account-amounts${queryString}`, sent)\n  }\n\n  /**\n   * Returns a URL to the Agnus billing/plan management page for the current account. Calls Agnus (an external\n   * service) and, for accounts without credits control, reports the consumption to it first.\n   * @permissions myAccount.myPlan\n   */\n  getAgnusMyPlanUrl(headers?: Record<string, string>): Promise<{ url: string }> {\n    return this.client.get<{ url: string }>('/me/account/agnus-my-plan-url', headers)\n  }\n\n  /**\n   * Updates the current user's profile fields such as name, language, and preferences (`data` and `preferences`\n   * replace the stored objects). A new `password` needs `currentPassword` and a recent login, is validated against\n   * the last 6 passwords, and revokes the access tokens with an expiration — including the one of this request.\n   */\n  updateMe(body: UpdateMePayload, headers?: Record<string, string>): Promise<User> {\n    return this.client.put<User, UpdateMePayload>('/me', body, headers)\n  }\n\n  /**\n   * Updates account-level settings such as name, settings object, wizard progress, and default department. It\n   * applies to the whole account; the default department is required while the tickets are enabled.\n   */\n  updateAccount(body: UpdateMeAccountPayload, headers?: Record<string, string>): Promise<Account> {\n    return this.client.put<Account, UpdateMeAccountPayload>('/me/account', body, headers)\n  }\n\n  /**\n   * Updates the presence status of the current user (`online`, `offline`, or `away`) for a `client`.\n   * If setting to `online`, validates the user's timetable first — if outside working hours,\n   * the status is set to `offline` instead. Resolves the status fields of the user.\n   */\n  updateStatus(\n    body: UpdateMeStatusPayload,\n    headers?: Record<string, string>,\n  ): Promise<MeStatusResponse> {\n    return this.client.put<MeStatusResponse, UpdateMeStatusPayload>('/me/status', body, headers)\n  }\n\n  /**\n   * Extends the grace period for the current account when it has expired or is about to expire, and notifies the\n   * billing webhook. Returns the updated account; an account not in a grace period answers 400.\n   */\n  extendAccountGracePeriod(headers?: Record<string, string>): Promise<Account> {\n    return this.client.post<Account>('/me/account/extend-grace-period', undefined, headers)\n  }\n\n  /**\n   * Registers the push notification tokens of the current user (`data` replaces the whole `data` of the user).\n   * Resolves with no body.\n   */\n  registerToken(body: RegisterTokenPayload, headers?: Record<string, string>): Promise<void> {\n    return this.client.post<void, RegisterTokenPayload>(\n      '/me/one-signal/register-token',\n      body,\n      headers,\n    )\n  }\n\n  /** Marks the current user's first login as complete by setting `isFirstLogin` to `false`. */\n  reportFirstLogin(headers?: Record<string, string>): Promise<User> {\n    return this.client.post<User>('/me/report-login', undefined, headers)\n  }\n\n  /**\n   * Sets the current user's status to `online` for the given client (`'web'` by default) and emits a takeover\n   * event, which signals other connected sessions to yield control to this one. Resolves with no body.\n   */\n  takeover(body?: TakeoverPayload, headers?: Record<string, string>): Promise<void> {\n    return this.client.post<void, TakeoverPayload>('/me/takeover', body, headers)\n  }\n\n  /**\n   * Stores a 16-character OTP secret key on the current user.\n   * This must be called before activating OTP authentication via `activateOtpAuth`.\n   */\n  setOtpSecretKey(body: SetOtpSecretKeyPayload, headers?: Record<string, string>): Promise<void> {\n    return this.client.patch<void, SetOtpSecretKeyPayload>('/me/set-otp-secret-key', body, headers)\n  }\n\n  /**\n   * Activates OTP (two-factor) authentication for the current user.\n   * Requires the `x-digisac-otp` header with a valid TOTP token generated from the secret key\n   * previously set via `setOtpSecretKey`. Resolves the text `'OK'`.\n   */\n  activateOtpAuth(headers?: Record<string, string>): Promise<'OK'> {\n    return this.client.post<'OK'>('/me/activate-otp-auth', undefined, headers)\n  }\n}\n"],"mappings":";;;;;;;;AAsBA,SAAS,qBACP,gBACA,SAC0D;AAI1D,QAFE,CAAC,CAAC,kBACF,OAAO,OAAO,eAAe,CAAC,MAAM,UAAU,OAAO,UAAU,YAAY,UAAU,KAAK,GAExF,CAAC,gBAA0B,QAAQ,GACnC,CAAC,QAAW,eAAqD;;AAGvE,IAAa,QAAb,cAA2B,QAAQ;CAQjC,MACE,gBACA,SACe;EACf,MAAM,CAAC,OAAO,QAAQ,qBAA8B,gBAAgB,QAAQ;AAC5E,SAAO,KAAK,OAAO,IAAU,MAAM,KAAK,cAAc,MAAM,IAAI,KAAK;;CASvE,WACE,gBACA,SACkB;EAClB,MAAM,CAAC,OAAO,QAAQ,qBAAqC,gBAAgB,QAAQ;AACnF,SAAO,KAAK,OAAO,IAAa,cAAc,KAAK,cAAc,MAAM,IAAI,KAAK;;CAYlF,kBACE,gBACA,SACyB;EACzB,MAAM,CAAC,OAAO,QAAQ,qBAA0C,gBAAgB,QAAQ;EACxF,MAAM,cAAc,QAAQ,KAAK,cAAc,EAAE,QAAQ,MAAM,OAAO,KAAK,IAAI,EAAE,CAAC,GAAG;AACrF,SAAO,KAAK,OAAO,IAAoB,0BAA0B,eAAe,KAAK;;;;;;;CAQvF,kBAAkB,SAA4D;AAC5E,SAAO,KAAK,OAAO,IAAqB,iCAAiC,QAAQ;;;;;;;CAQnF,SAAS,MAAuB,SAAiD;AAC/E,SAAO,KAAK,OAAO,IAA2B,OAAO,MAAM,QAAQ;;;;;;CAOrE,cAAc,MAA8B,SAAoD;AAC9F,SAAO,KAAK,OAAO,IAAqC,eAAe,MAAM,QAAQ;;;;;;;CAQvF,aACE,MACA,SAC2B;AAC3B,SAAO,KAAK,OAAO,IAA6C,cAAc,MAAM,QAAQ;;;;;;CAO9F,yBAAyB,SAAoD;AAC3E,SAAO,KAAK,OAAO,KAAc,mCAAmC,QAAW,QAAQ;;;;;;CAOzF,cAAc,MAA4B,SAAiD;AACzF,SAAO,KAAK,OAAO,KACjB,iCACA,MACA,QACD;;;CAIH,iBAAiB,SAAiD;AAChE,SAAO,KAAK,OAAO,KAAW,oBAAoB,QAAW,QAAQ;;;;;;CAOvE,SAAS,MAAwB,SAAiD;AAChF,SAAO,KAAK,OAAO,KAA4B,gBAAgB,MAAM,QAAQ;;;;;;CAO/E,gBAAgB,MAA8B,SAAiD;AAC7F,SAAO,KAAK,OAAO,MAAoC,0BAA0B,MAAM,QAAQ;;;;;;;CAQjG,gBAAgB,SAAiD;AAC/D,SAAO,KAAK,OAAO,KAAW,yBAAyB,QAAW,QAAQ"}