@ikatec/digisac-api-sdk 3.1.0 → 4.1.0

package/dist/core/queryString.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryString.d.ts","sourceRoot":"","sources":["../../src/core/queryString.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,IAAI,CAAA;AAEvC,eAAO,MAAM,oBAAoB,EAAE,WAAoB,CAAA;AAEvD,qFAAqF;AACrF,wBAAgB,aAAa,CAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,EACrB,MAAM,GAAE,WAAkC,GACzC,MAAM,CAUR"}

package/dist/core/queryString.mjs

@@ -0,0 +1,18 @@
+import qs from "qs";
+
+//#region src/core/queryString.ts
+const DEFAULT_QUERY_FORMAT = "json";
+/** Serializes a query in `format`, or returns `''` when there is nothing to send. */
+function toQueryString(query, format = DEFAULT_QUERY_FORMAT) {
+	if (!query) return "";
+	if (format === "qs") {
+		const queryString = qs.stringify(query);
+		return queryString ? `?${queryString}` : "";
+	}
+	const json = JSON.stringify(query);
+	return json === "{}" ? "" : `?query=${encodeURIComponent(json)}`;
+}
+
+//#endregion
+export { DEFAULT_QUERY_FORMAT, toQueryString };
+//# sourceMappingURL=queryString.mjs.map

package/dist/core/queryString.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryString.mjs","names":[],"sources":["../../src/core/queryString.ts"],"sourcesContent":["import qs from 'qs'\n\n/**\n * How list/get queries (`where`, `include`, `order`, ...) are put in the URL:\n *\n * - `'json'` — `?query=<JSON>`, merged into `req.query` by the backend `parseQuery` middleware.\n *   Keeps `null`, booleans and numbers typed and has no nesting limit.\n * - `'qs'` — bracket notation (`?where[name]=x&page=2`). Readable, but the backend parses it with\n *   `qs` defaults: `null` arrives as `''`, booleans/numbers as strings, and objects nested deeper\n *   than 5 levels (e.g. an `include` inside an `include` with a `where`) are mangled.\n */\nexport type QueryFormat = 'json' | 'qs'\n\nexport const DEFAULT_QUERY_FORMAT: QueryFormat = 'json'\n\n/** Serializes a query in `format`, or returns `''` when there is nothing to send. */\nexport function toQueryString(\n  query?: object | null,\n  format: QueryFormat = DEFAULT_QUERY_FORMAT,\n): string {\n  if (!query) {\n    return ''\n  }\n  if (format === 'qs') {\n    const queryString = qs.stringify(query)\n    return queryString ? `?${queryString}` : ''\n  }\n  const json = JSON.stringify(query)\n  return json === '{}' ? '' : `?query=${encodeURIComponent(json)}`\n}\n"],"mappings":";;;AAaA,MAAa,uBAAoC;;AAGjD,SAAgB,cACd,OACA,SAAsB,sBACd;AACR,KAAI,CAAC,MACH,QAAO;AAET,KAAI,WAAW,MAAM;EACnB,MAAM,cAAc,GAAG,UAAU,MAAM;AACvC,SAAO,cAAc,IAAI,gBAAgB;;CAE3C,MAAM,OAAO,KAAK,UAAU,MAAM;AAClC,QAAO,SAAS,OAAO,KAAK,UAAU,mBAAmB,KAAK"}

package/dist/core/types.d.ts

@@ -91,6 +91,8 @@ export interface HasGetMany<TResponse, TQuery extends ListQuery<TResponse> = Lis
     getMany(query?: TQuery & {
         paginate?: true;
     }, headers?: Record<string, string>): Promise<Paginated<TResponse>>;
+    /** When `paginate` is only known at runtime (e.g. a `boolean` variable). */
+    getMany(query?: TQuery, headers?: Record<string, string>): Promise<Paginated<TResponse> | TResponse[]>;
 }
 export type GetByIdQuery<T = Record<string, unknown>> = Pick<ListQuery<T>, 'include' | 'attributes'>;
 export interface HasGetById<TResponse> {

package/dist/core/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"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"}

package/dist/core/withQueryFormat.cjs

@@ -0,0 +1,42 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+//#region src/core/withQueryFormat.ts
+/**
+* A view of `client` that serializes queries in `format`. Everything else — methods, base URL and
+* the access token — is read from `client`, so `client.setAccessToken()` still applies to it.
+*/
+function overrideQueryFormat(client, format) {
+	return Object.create(client, { queryFormat: {
+		value: format,
+		enumerable: true,
+		configurable: true
+	} });
+}
+/**
+* Copy of `api` whose client serializes queries in `format`; `api` itself is untouched.
+*
+* The copy has the same prototype and fields as `api`, with `client` replaced. Methods the
+* constructor bound to `api` (`this.getMany = this.getMany.bind(this)`) are bound again to the
+* copy, so they use its client.
+*/
+function cloneWithQueryFormat(api, format) {
+	const source = api;
+	const prototype = Object.getPrototypeOf(api);
+	const copy = Object.create(prototype);
+	for (const key of Reflect.ownKeys(api)) Object.defineProperty(copy, key, Object.getOwnPropertyDescriptor(api, key));
+	Object.defineProperty(copy, "client", {
+		value: overrideQueryFormat(source.client, format),
+		enumerable: true,
+		configurable: true,
+		writable: false
+	});
+	for (const key of Reflect.ownKeys(api)) {
+		const method = prototype[key];
+		if (typeof copy[key] === "function" && typeof method === "function") copy[key] = method.bind(copy);
+	}
+	return copy;
+}
+
+//#endregion
+exports.cloneWithQueryFormat = cloneWithQueryFormat;
+//# sourceMappingURL=withQueryFormat.cjs.map

package/dist/core/withQueryFormat.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"withQueryFormat.cjs","names":[],"sources":["../../src/core/withQueryFormat.ts"],"sourcesContent":["import type { ApiClient } from './ApiClient'\nimport type { QueryFormat } from './queryString'\n\n/**\n * A view of `client` that serializes queries in `format`. Everything else — methods, base URL and\n * the access token — is read from `client`, so `client.setAccessToken()` still applies to it.\n */\nfunction overrideQueryFormat<T extends ApiClient>(client: T, format: QueryFormat): T {\n  return Object.create(client, {\n    queryFormat: { value: format, enumerable: true, configurable: true },\n  })\n}\n\n/**\n * Copy of `api` whose client serializes queries in `format`; `api` itself is untouched.\n *\n * The copy has the same prototype and fields as `api`, with `client` replaced. Methods the\n * constructor bound to `api` (`this.getMany = this.getMany.bind(this)`) are bound again to the\n * copy, so they use its client.\n */\nexport function cloneWithQueryFormat<T extends object>(api: T, format: QueryFormat): T {\n  const source = api as T & { client: ApiClient }\n  const prototype = Object.getPrototypeOf(api) as Record<PropertyKey, unknown>\n  const copy = Object.create(prototype) as Record<PropertyKey, unknown>\n\n  for (const key of Reflect.ownKeys(api)) {\n    Object.defineProperty(\n      copy,\n      key,\n      Object.getOwnPropertyDescriptor(api, key) as PropertyDescriptor,\n    )\n  }\n  Object.defineProperty(copy, 'client', {\n    value: overrideQueryFormat(source.client, format),\n    enumerable: true,\n    configurable: true,\n    writable: false,\n  })\n  for (const key of Reflect.ownKeys(api)) {\n    const method = prototype[key]\n    if (typeof copy[key] === 'function' && typeof method === 'function') {\n      copy[key] = method.bind(copy)\n    }\n  }\n\n  return copy as T\n}\n"],"mappings":";;;;;;;AAOA,SAAS,oBAAyC,QAAW,QAAwB;AACnF,QAAO,OAAO,OAAO,QAAQ,EAC3B,aAAa;EAAE,OAAO;EAAQ,YAAY;EAAM,cAAc;EAAM,EACrE,CAAC;;;;;;;;;AAUJ,SAAgB,qBAAuC,KAAQ,QAAwB;CACrF,MAAM,SAAS;CACf,MAAM,YAAY,OAAO,eAAe,IAAI;CAC5C,MAAM,OAAO,OAAO,OAAO,UAAU;AAErC,MAAK,MAAM,OAAO,QAAQ,QAAQ,IAAI,CACpC,QAAO,eACL,MACA,KACA,OAAO,yBAAyB,KAAK,IAAI,CAC1C;AAEH,QAAO,eAAe,MAAM,UAAU;EACpC,OAAO,oBAAoB,OAAO,QAAQ,OAAO;EACjD,YAAY;EACZ,cAAc;EACd,UAAU;EACX,CAAC;AACF,MAAK,MAAM,OAAO,QAAQ,QAAQ,IAAI,EAAE;EACtC,MAAM,SAAS,UAAU;AACzB,MAAI,OAAO,KAAK,SAAS,cAAc,OAAO,WAAW,WACvD,MAAK,OAAO,OAAO,KAAK,KAAK;;AAIjC,QAAO"}

package/dist/core/withQueryFormat.d.ts

@@ -0,0 +1,10 @@
+import type { QueryFormat } from './queryString';
+/**
+ * Copy of `api` whose client serializes queries in `format`; `api` itself is untouched.
+ *
+ * The copy has the same prototype and fields as `api`, with `client` replaced. Methods the
+ * constructor bound to `api` (`this.getMany = this.getMany.bind(this)`) are bound again to the
+ * copy, so they use its client.
+ */
+export declare function cloneWithQueryFormat<T extends object>(api: T, format: QueryFormat): T;
+//# sourceMappingURL=withQueryFormat.d.ts.map

package/dist/core/withQueryFormat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withQueryFormat.d.ts","sourceRoot":"","sources":["../../src/core/withQueryFormat.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAYhD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,GAAG,CAAC,CA0BrF"}

package/dist/core/withQueryFormat.mjs

@@ -0,0 +1,40 @@
+//#region src/core/withQueryFormat.ts
+/**
+* A view of `client` that serializes queries in `format`. Everything else — methods, base URL and
+* the access token — is read from `client`, so `client.setAccessToken()` still applies to it.
+*/
+function overrideQueryFormat(client, format) {
+	return Object.create(client, { queryFormat: {
+		value: format,
+		enumerable: true,
+		configurable: true
+	} });
+}
+/**
+* Copy of `api` whose client serializes queries in `format`; `api` itself is untouched.
+*
+* The copy has the same prototype and fields as `api`, with `client` replaced. Methods the
+* constructor bound to `api` (`this.getMany = this.getMany.bind(this)`) are bound again to the
+* copy, so they use its client.
+*/
+function cloneWithQueryFormat(api, format) {
+	const source = api;
+	const prototype = Object.getPrototypeOf(api);
+	const copy = Object.create(prototype);
+	for (const key of Reflect.ownKeys(api)) Object.defineProperty(copy, key, Object.getOwnPropertyDescriptor(api, key));
+	Object.defineProperty(copy, "client", {
+		value: overrideQueryFormat(source.client, format),
+		enumerable: true,
+		configurable: true,
+		writable: false
+	});
+	for (const key of Reflect.ownKeys(api)) {
+		const method = prototype[key];
+		if (typeof copy[key] === "function" && typeof method === "function") copy[key] = method.bind(copy);
+	}
+	return copy;
+}
+
+//#endregion
+export { cloneWithQueryFormat };
+//# sourceMappingURL=withQueryFormat.mjs.map

package/dist/core/withQueryFormat.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"withQueryFormat.mjs","names":[],"sources":["../../src/core/withQueryFormat.ts"],"sourcesContent":["import type { ApiClient } from './ApiClient'\nimport type { QueryFormat } from './queryString'\n\n/**\n * A view of `client` that serializes queries in `format`. Everything else — methods, base URL and\n * the access token — is read from `client`, so `client.setAccessToken()` still applies to it.\n */\nfunction overrideQueryFormat<T extends ApiClient>(client: T, format: QueryFormat): T {\n  return Object.create(client, {\n    queryFormat: { value: format, enumerable: true, configurable: true },\n  })\n}\n\n/**\n * Copy of `api` whose client serializes queries in `format`; `api` itself is untouched.\n *\n * The copy has the same prototype and fields as `api`, with `client` replaced. Methods the\n * constructor bound to `api` (`this.getMany = this.getMany.bind(this)`) are bound again to the\n * copy, so they use its client.\n */\nexport function cloneWithQueryFormat<T extends object>(api: T, format: QueryFormat): T {\n  const source = api as T & { client: ApiClient }\n  const prototype = Object.getPrototypeOf(api) as Record<PropertyKey, unknown>\n  const copy = Object.create(prototype) as Record<PropertyKey, unknown>\n\n  for (const key of Reflect.ownKeys(api)) {\n    Object.defineProperty(\n      copy,\n      key,\n      Object.getOwnPropertyDescriptor(api, key) as PropertyDescriptor,\n    )\n  }\n  Object.defineProperty(copy, 'client', {\n    value: overrideQueryFormat(source.client, format),\n    enumerable: true,\n    configurable: true,\n    writable: false,\n  })\n  for (const key of Reflect.ownKeys(api)) {\n    const method = prototype[key]\n    if (typeof copy[key] === 'function' && typeof method === 'function') {\n      copy[key] = method.bind(copy)\n    }\n  }\n\n  return copy as T\n}\n"],"mappings":";;;;;AAOA,SAAS,oBAAyC,QAAW,QAAwB;AACnF,QAAO,OAAO,OAAO,QAAQ,EAC3B,aAAa;EAAE,OAAO;EAAQ,YAAY;EAAM,cAAc;EAAM,EACrE,CAAC;;;;;;;;;AAUJ,SAAgB,qBAAuC,KAAQ,QAAwB;CACrF,MAAM,SAAS;CACf,MAAM,YAAY,OAAO,eAAe,IAAI;CAC5C,MAAM,OAAO,OAAO,OAAO,UAAU;AAErC,MAAK,MAAM,OAAO,QAAQ,QAAQ,IAAI,CACpC,QAAO,eACL,MACA,KACA,OAAO,yBAAyB,KAAK,IAAI,CAC1C;AAEH,QAAO,eAAe,MAAM,UAAU;EACpC,OAAO,oBAAoB,OAAO,QAAQ,OAAO;EACjD,YAAY;EACZ,cAAc;EACd,UAAU;EACX,CAAC;AACF,MAAK,MAAM,OAAO,QAAQ,QAAQ,IAAI,EAAE;EACtC,MAAM,SAAS,UAAU;AACzB,MAAI,OAAO,KAAK,SAAS,cAAc,OAAO,WAAW,WACvD,MAAK,OAAO,OAAO,KAAK,KAAK;;AAIjC,QAAO"}

package/dist/index.cjs

@@ -1,10 +1,26 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_core_errors = require('./core/errors.cjs');
 const require_core_BaseApiClient = require('./core/BaseApiClient.cjs');
+const require_core_BaseApi = require('./core/BaseApi.cjs');
 const require_core_BaseCrudApi = require('./core/BaseCrudApi.cjs');
 const require_core_ArchivableCrudApi = require('./core/ArchivableCrudApi.cjs');
 require('./core/index.cjs');
 
-exports.ApiError = require_core_BaseApiClient.ApiError;
+exports.ApiConnectionError = require_core_errors.ApiConnectionError;
+exports.ApiError = require_core_errors.ApiError;
 exports.ArchivableCrudApi = require_core_ArchivableCrudApi.ArchivableCrudApi;
+exports.AuthenticationError = require_core_errors.AuthenticationError;
+exports.BadRequestError = require_core_errors.BadRequestError;
+exports.BaseApi = require_core_BaseApi.BaseApi;
 exports.BaseApiClient = require_core_BaseApiClient.BaseApiClient;
-exports.BaseCrudApi = require_core_BaseCrudApi.BaseCrudApi;
+exports.BaseCrudApi = require_core_BaseCrudApi.BaseCrudApi;
+exports.ConflictError = require_core_errors.ConflictError;
+exports.DigisacError = require_core_errors.DigisacError;
+exports.InternalServerError = require_core_errors.InternalServerError;
+exports.NotFoundError = require_core_errors.NotFoundError;
+exports.PaymentRequiredError = require_core_errors.PaymentRequiredError;
+exports.PermissionDeniedError = require_core_errors.PermissionDeniedError;
+exports.RateLimitError = require_core_errors.RateLimitError;
+exports.UnprocessableEntityError = require_core_errors.UnprocessableEntityError;
+exports.ValidationError = require_core_errors.ValidationError;
+exports.parseFieldErrors = require_core_errors.parseFieldErrors;

package/dist/index.mjs

@@ -1,6 +1,8 @@
-import { ApiError, BaseApiClient } from "./core/BaseApiClient.mjs";
+import { ApiConnectionError, ApiError, AuthenticationError, BadRequestError, ConflictError, DigisacError, InternalServerError, NotFoundError, PaymentRequiredError, PermissionDeniedError, RateLimitError, UnprocessableEntityError, ValidationError, parseFieldErrors } from "./core/errors.mjs";
+import { BaseApiClient } from "./core/BaseApiClient.mjs";
+import { BaseApi } from "./core/BaseApi.mjs";
 import { BaseCrudApi } from "./core/BaseCrudApi.mjs";
 import { ArchivableCrudApi } from "./core/ArchivableCrudApi.mjs";
 import "./core/index.mjs";
 
-export { ApiError, ArchivableCrudApi, BaseApiClient, BaseCrudApi };
+export { ApiConnectionError, ApiError, ArchivableCrudApi, AuthenticationError, BadRequestError, BaseApi, BaseApiClient, BaseCrudApi, ConflictError, DigisacError, InternalServerError, NotFoundError, PaymentRequiredError, PermissionDeniedError, RateLimitError, UnprocessableEntityError, ValidationError, parseFieldErrors };

package/package.json

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

package/src/apis/authHistory/AuthHistoryApi.test.ts

@@ -69,7 +69,7 @@ describe('AuthHistoryApi', () => {
       await api.getMany({ page: 2, perPage: 5 })
       const url = vi.mocked(client.get).mock.calls[0][0] as string
       expect(url).toContain('/auth-history?')
-      expect(url).toContain('page=2')
+      expect(decodeURIComponent(url)).toContain('"page":2')
     })
 
     it('forwards custom headers', async () => {

package/src/apis/authHistory/AuthHistoryApi.ts

@@ -1,15 +1,11 @@
-import qs from 'qs'
-import type { ApiClient } from '../../core/ApiClient'
+import { BaseApi } from '../../core/BaseApi'
 import type { ListQuery, Paginated, HasGetMany, HasGetById } from '../../core/types'
 import type { AuthHistory } from './types'
 
-export class AuthHistoryApi implements HasGetMany<AuthHistory>, HasGetById<AuthHistory> {
-  private readonly client: ApiClient
-
-  constructor(client: ApiClient) {
-    this.client = client
-  }
-
+export class AuthHistoryApi
+  extends BaseApi
+  implements HasGetMany<AuthHistory>, HasGetById<AuthHistory>
+{
   /**
    * Returns a paginated list of authentication events (auth, password_change, logout). Non-admin users can only see their own records.
    * @permissions authHistory.view
@@ -22,11 +18,15 @@ export class AuthHistoryApi implements HasGetMany<AuthHistory>, HasGetById<AuthH
     query?: ListQuery<AuthHistory> & { paginate?: true },
     headers?: Record<string, string>,
   ): Promise<Paginated<AuthHistory>>
+  getMany(
+    query?: ListQuery<AuthHistory>,
+    headers?: Record<string, string>,
+  ): Promise<Paginated<AuthHistory> | AuthHistory[]>
   getMany(
     query?: ListQuery<AuthHistory>,
     headers?: Record<string, string>,
   ): Promise<Paginated<AuthHistory> | AuthHistory[]> {
-    const queryString = query ? `?${qs.stringify(query)}` : ''
+    const queryString = this.toQueryString(query)
     return this.client.get<Paginated<AuthHistory> | AuthHistory[]>(
       `/auth-history${queryString}`,
       headers,

package/src/apis/campaigns/CampaignsApi.test.ts

@@ -96,7 +96,7 @@ describe('CampaignsApi', () => {
       await api.getMany({ page: 2, perPage: 5 })
       const url = vi.mocked(client.get).mock.calls[0][0] as string
       expect(url).toContain('/campaigns?')
-      expect(url).toContain('page=2')
+      expect(decodeURIComponent(url)).toContain('"page":2')
     })
 
     it('forwards custom headers', async () => {

package/src/apis/clientFeedback/ClientFeedbackApi.ts

@@ -1,15 +1,13 @@
-import type { ApiClient } from '../../core/ApiClient'
+import { BaseApi } from '../../core/BaseApi'
 import type { HasCreate } from '../../core/types'
 import type { ClientFeedback, CreateClientFeedbackPayload } from './types'
 
-export class ClientFeedbackApi implements HasCreate<ClientFeedback, CreateClientFeedbackPayload> {
-  private readonly client: ApiClient
+export class ClientFeedbackApi
+  extends BaseApi
+  implements HasCreate<ClientFeedback, CreateClientFeedbackPayload>
+{
   private readonly basePath = '/client-feedback'
 
-  constructor(client: ApiClient) {
-    this.client = client
-  }
-
   /** Creates a client feedback record for a ticket (accountId, ticketId, and feedback text are required). */
   create(
     body: CreateClientFeedbackPayload,

package/src/apis/contacts/ContactsApi.test.ts

@@ -103,7 +103,7 @@ describe('ContactsApi', () => {
       await api.getMany({ page: 2, perPage: 5 })
       const url = vi.mocked(client.get).mock.calls[0][0] as string
       expect(url).toContain('/contacts?')
-      expect(url).toContain('page=2')
+      expect(decodeURIComponent(url)).toContain('"page":2')
     })
 
     it('forwards custom headers', async () => {

package/src/apis/contacts/ContactsApi.ts

@@ -35,7 +35,7 @@ export class ContactsApi extends BaseCrudApi<Contact, CreateContactPayload, Upda
    * @permissions contacts.view
    */
   count(query?: CountContactsQuery, headers?: Record<string, string>): Promise<{ count: number }> {
-    const queryString = query ? `?${qs.stringify(query)}` : ''
+    const queryString = this.toQueryString(query)
     return this.client.get<{ count: number }>(`${this.basePath}/count${queryString}`, headers)
   }
 
@@ -62,7 +62,7 @@ export class ContactsApi extends BaseCrudApi<Contact, CreateContactPayload, Upda
     query?: ListQuery<Contact>,
     headers?: Record<string, string>,
   ): Promise<Paginated<Contact>> {
-    const queryString = query ? `?${qs.stringify(query)}` : ''
+    const queryString = this.toQueryString(query)
     return this.client.get<Paginated<Contact>>(`${this.basePath}/forward${queryString}`, headers)
   }
 

package/src/apis/me/MeApi.ts

@@ -1,4 +1,4 @@
-import type { ApiClient } from '../../core/ApiClient'
+import { BaseApi } from '../../core/BaseApi'
 import type { Account } from '../accounts/types'
 import type { User } from '../users/types'
 import type {
@@ -10,13 +10,7 @@ import type {
   UpdateMeStatusPayload,
 } from './types'
 
-export class MeApi {
-  protected readonly client: ApiClient
-
-  constructor(client: ApiClient) {
-    this.client = client
-  }
-
+export class MeApi extends BaseApi {
   /**
    * Returns the currently authenticated user, including their roles, departments, and timetable.
    * @permissions users.view

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

@@ -87,8 +87,8 @@ describe('MessagesApi', () => {
       await api.getMany({ page: 2, perPage: 5 })
       const url = vi.mocked(client.get).mock.calls[0][0] as string
       expect(url).toContain('/messages?')
-      expect(url).toContain('page=2')
-      expect(url).toContain('perPage=5')
+      expect(decodeURIComponent(url)).toContain('"page":2')
+      expect(decodeURIComponent(url)).toContain('"perPage":5')
     })
 
     it('forwards custom headers', async () => {

package/src/apis/queryFormat.test.ts

@@ -0,0 +1,198 @@
+import { afterEach, describe, expect, it, vi } from 'vitest'
+import qs from 'qs'
+import type { ApiClient } from '../core/ApiClient'
+import { BaseApiClient } from '../core/BaseApiClient'
+import type { QueryFormat } from '../core/queryString'
+import { AuthHistoryApi } from './authHistory/AuthHistoryApi'
+import { ContactsApi } from './contacts/ContactsApi'
+import { ServiceAccessManagementApi } from './serviceAccessManagement/ServiceAccessManagementApi'
+import { StickerUsersApi } from './stickerUsers/StickerUsersApi'
+import { TermsApi } from './terms/TermsApi'
+
+/**
+ * Every method that sends a list/get query must serialize it in the client's `queryFormat` and
+ * honor `withQueryFormat`. A method listed here that ignored the format would fail below.
+ */
+
+function createMockClient(queryFormat?: QueryFormat): ApiClient {
+  return {
+    ...(queryFormat && { queryFormat }),
+    setAccessToken: vi.fn().mockReturnThis(),
+    request: vi.fn(),
+    get: vi.fn().mockResolvedValue([]),
+    post: vi.fn(),
+    put: vi.fn(),
+    patch: vi.fn(),
+    delete: vi.fn(),
+  }
+}
+
+const listQuery = { where: { name: 'x' }, page: 2, perPage: 5 }
+const getQuery = { attributes: ['id'] }
+
+type Case = {
+  name: string
+  path: string
+  query: object
+  /** Calls the method on the API built from `client`, optionally through `withQueryFormat`. */
+  call: (client: ApiClient, override?: QueryFormat) => Promise<unknown>
+}
+
+const cases: Case[] = [
+  {
+    name: 'ContactsApi.getMany (BaseCrudApi)',
+    path: '/contacts',
+    query: listQuery,
+    call: (client, f) => {
+      const api = new ContactsApi(client)
+      return (f ? api.withQueryFormat(f) : api).getMany(listQuery)
+    },
+  },
+  {
+    name: 'ContactsApi.getById (BaseCrudApi)',
+    path: '/contacts/c1',
+    query: getQuery,
+    call: (client, f) => {
+      const api = new ContactsApi(client)
+      return (f ? api.withQueryFormat(f) : api).getById('c1', { attributes: ['id'] })
+    },
+  },
+  {
+    name: 'ContactsApi.count',
+    path: '/contacts/count',
+    query: listQuery,
+    call: (client, f) => {
+      const api = new ContactsApi(client)
+      return (f ? api.withQueryFormat(f) : api).count(listQuery)
+    },
+  },
+  {
+    name: 'ContactsApi.forward',
+    path: '/contacts/forward',
+    query: listQuery,
+    call: (client, f) => {
+      const api = new ContactsApi(client)
+      return (f ? api.withQueryFormat(f) : api).forward(listQuery)
+    },
+  },
+  {
+    name: 'AuthHistoryApi.getMany',
+    path: '/auth-history',
+    query: { page: 2, perPage: 5 },
+    call: (client, f) => {
+      const api = new AuthHistoryApi(client)
+      return (f ? api.withQueryFormat(f) : api).getMany({ page: 2, perPage: 5 })
+    },
+  },
+  {
+    name: 'ServiceAccessManagementApi.getMany',
+    path: '/service-access-management',
+    query: { page: 2, perPage: 5 },
+    call: (client, f) => {
+      const api = new ServiceAccessManagementApi(client)
+      return (f ? api.withQueryFormat(f) : api).getMany({ page: 2, perPage: 5 })
+    },
+  },
+  {
+    name: 'StickerUsersApi.getMany',
+    path: '/sticker-users',
+    query: { page: 2, perPage: 5 },
+    call: (client, f) => {
+      const api = new StickerUsersApi(client)
+      return (f ? api.withQueryFormat(f) : api).getMany({ page: 2, perPage: 5 })
+    },
+  },
+  {
+    name: 'TermsApi.getById',
+    path: '/terms/t1',
+    query: getQuery,
+    call: (client, f) => {
+      const api = new TermsApi(client)
+      return (f ? api.withQueryFormat(f) : api).getById('t1', { attributes: ['id'] })
+    },
+  },
+]
+
+const jsonUrl = (path: string, query: object) =>
+  `${path}?query=${encodeURIComponent(JSON.stringify(query))}`
+const qsUrl = (path: string, query: object) => `${path}?${qs.stringify(query)}`
+const calledUrl = (client: ApiClient) => vi.mocked(client.get).mock.calls.at(0)?.at(0)
+
+describe.each(cases)('$name', ({ path, query, call }) => {
+  it("sends JSON with the default client format ('json')", async () => {
+    const client = createMockClient()
+    await call(client)
+    expect(calledUrl(client)).toBe(jsonUrl(path, query))
+  })
+
+  it("sends bracket notation with a 'qs' client", async () => {
+    const client = createMockClient('qs')
+    await call(client)
+    expect(calledUrl(client)).toBe(qsUrl(path, query))
+  })
+
+  it("withQueryFormat('qs') overrides a 'json' client", async () => {
+    const client = createMockClient()
+    await call(client, 'qs')
+    expect(calledUrl(client)).toBe(qsUrl(path, query))
+  })
+
+  it("withQueryFormat('json') overrides a 'qs' client", async () => {
+    const client = createMockClient('qs')
+    await call(client, 'json')
+    expect(calledUrl(client)).toBe(jsonUrl(path, query))
+  })
+})
+
+describe('query format through BaseApiClient', () => {
+  afterEach(() => {
+    vi.restoreAllMocks()
+  })
+
+  const mockFetch = () =>
+    vi
+      .spyOn(globalThis, 'fetch')
+      .mockImplementation(
+        async () =>
+          new Response('[]', { status: 200, headers: { 'Content-Type': 'application/json' } }),
+      )
+
+  it('builds the full ?query=<JSON> URL by default, keeping null typed', async () => {
+    const fetchSpy = mockFetch()
+    const contacts = new ContactsApi(new BaseApiClient('https://api.example.com/'))
+
+    await contacts.getMany({ where: { name: null }, paginate: false })
+
+    const query = '{"where":{"name":null},"paginate":false}'
+    expect(fetchSpy.mock.calls[0]?.[0]).toBe(
+      `https://api.example.com/contacts?query=${encodeURIComponent(query)}`,
+    )
+  })
+
+  it("builds the bracket URL with queryFormat 'qs'", async () => {
+    const fetchSpy = mockFetch()
+    const client = new BaseApiClient('https://api.example.com', undefined, { queryFormat: 'qs' })
+
+    await new ContactsApi(client).getMany({ where: { name: 'x' }, paginate: false })
+
+    expect(decodeURIComponent(fetchSpy.mock.calls[0]?.[0] as string)).toBe(
+      'https://api.example.com/contacts?where[name]=x&paginate=false',
+    )
+  })
+
+  it("setAccessToken on a copy's client only affects the copy", async () => {
+    const fetchSpy = mockFetch()
+    const client = new BaseApiClient('https://api.example.com', 'original')
+    const contacts = new ContactsApi(client)
+    const copy = contacts.withQueryFormat('qs')
+
+    copy.client.setAccessToken('copy-only')
+    await contacts.getMany({ paginate: false })
+    await copy.getMany({ paginate: false })
+
+    const authorization = (call: number) =>
+      (fetchSpy.mock.calls[call]?.[1]?.headers as Record<string, string>).Authorization
+    expect(authorization(0)).toBe('Bearer original')
+    expect(authorization(1)).toBe('Bearer copy-only')
+  })
+})

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

@@ -63,7 +63,7 @@ describe('ServiceAccessManagementApi', () => {
       await api.getMany({ page: 2, perPage: 5 })
       const url = vi.mocked(client.get).mock.calls[0][0] as string
       expect(url).toContain('/service-access-management?')
-      expect(url).toContain('page=2')
+      expect(decodeURIComponent(url)).toContain('"page":2')
     })
 
     it('forwards custom headers', async () => {
@@ -77,7 +77,7 @@ describe('ServiceAccessManagementApi', () => {
       vi.mocked(client.get).mockResolvedValue([record])
       const result = await api.getMany({ paginate: false })
       const url = vi.mocked(client.get).mock.calls[0][0] as string
-      expect(url).toContain('paginate=false')
+      expect(decodeURIComponent(url)).toContain('"paginate":false')
       expect(result).toEqual([record])
     })
 

package/src/apis/serviceAccessManagement/ServiceAccessManagementApi.ts

@@ -1,15 +1,11 @@
-import qs from 'qs'
-import type { ApiClient } from '../../core/ApiClient'
+import { BaseApi } from '../../core/BaseApi'
 import type { ListQuery, Paginated, HasGetMany } from '../../core/types'
 import type { ServiceAccessManagement } from './types'
 
-export class ServiceAccessManagementApi implements HasGetMany<ServiceAccessManagement> {
-  private readonly client: ApiClient
-
-  constructor(client: ApiClient) {
-    this.client = client
-  }
-
+export class ServiceAccessManagementApi
+  extends BaseApi
+  implements HasGetMany<ServiceAccessManagement>
+{
   /** Returns a paginated list of which users have access to which services. */
   getMany(
     query: ListQuery<ServiceAccessManagement> & { paginate: false },
@@ -19,11 +15,15 @@ export class ServiceAccessManagementApi implements HasGetMany<ServiceAccessManag
     query?: ListQuery<ServiceAccessManagement> & { paginate?: true },
     headers?: Record<string, string>,
   ): Promise<Paginated<ServiceAccessManagement>>
+  getMany(
+    query?: ListQuery<ServiceAccessManagement>,
+    headers?: Record<string, string>,
+  ): Promise<Paginated<ServiceAccessManagement> | ServiceAccessManagement[]>
   getMany(
     query?: ListQuery<ServiceAccessManagement>,
     headers?: Record<string, string>,
   ): Promise<Paginated<ServiceAccessManagement> | ServiceAccessManagement[]> {
-    const queryString = query ? `?${qs.stringify(query)}` : ''
+    const queryString = this.toQueryString(query)
     return this.client.get<Paginated<ServiceAccessManagement> | ServiceAccessManagement[]>(
       `/service-access-management${queryString}`,
       headers,

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

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