@ikatec/digisac-api-sdk 3.1.0 → 4.1.0

package/dist/core/BaseApiClient.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"BaseApiClient.cjs","names":[],"sources":["../../src/core/BaseApiClient.ts"],"sourcesContent":["import type { ApiClient, HttpMethod } from './ApiClient'\n\nexport interface ValidationError {\n  path: string\n  message: string\n  code: string\n}\n\n/**\n * Digisac field errors: `{ errors: { <location>: { <field>: { messages: string[], types: string[] } } } }`,\n * where location is `body`, `params`, `query`, `headers` or `cookies` (backend `validate` middleware).\n */\ntype DigisacFieldErrors = Record<string, Record<string, { messages?: unknown; types?: unknown }>>\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value)\n\n/**\n * Flattens the Digisac `errors` object into `ValidationError[]` — one entry per message, with\n * `path` = `<location>.<field>` (e.g. `body.name`) and `code` = the rule type (e.g. `required`).\n * Returns `null` when the body carries no field errors.\n */\nfunction parseValidationErrors(errors: unknown): ValidationError[] | null {\n  if (!isRecord(errors)) {\n    return null\n  }\n\n  const parsed: ValidationError[] = []\n  for (const [location, fields] of Object.entries(errors as DigisacFieldErrors)) {\n    if (!isRecord(fields)) {\n      continue\n    }\n    for (const [field, detail] of Object.entries(fields)) {\n      const messages = Array.isArray(detail?.messages) ? detail.messages.map(String) : []\n      const types = Array.isArray(detail?.types) ? detail.types.map(String) : []\n      messages.forEach((message, index) => {\n        parsed.push({ path: `${location}.${field}`, message, code: types[index] ?? types[0] ?? '' })\n      })\n    }\n  }\n\n  return parsed.length ? parsed : null\n}\n\nexport class ApiError extends Error {\n  public readonly errorClass?: string | undefined\n  public readonly status?: number | undefined\n  public readonly validationErrors: ValidationError[] | null\n\n  constructor(\n    message: string,\n    errorClass?: string,\n    status?: number,\n    validationErrors: ValidationError[] | null = null,\n  ) {\n    super(message)\n    this.name = 'ApiError'\n    this.errorClass = errorClass\n    this.status = status\n    this.validationErrors = validationErrors\n  }\n}\n\nexport class BaseApiClient implements ApiClient {\n  protected readonly baseUrl: string\n  protected accessToken: string | null = null\n\n  constructor(baseUrl: string, accessToken?: string) {\n    this.baseUrl = baseUrl.replace(/\\/$/, '')\n    this.accessToken = accessToken || null\n  }\n\n  setAccessToken(accessToken: string): this {\n    this.accessToken = accessToken\n    return this\n  }\n\n  async request<TResponse = unknown, TBody = unknown>(\n    method: HttpMethod,\n    endpoint: string,\n    body?: TBody,\n    headers?: Record<string, string>,\n  ): Promise<TResponse> {\n    const url = `${this.baseUrl}/${endpoint.replace(/^\\//, '')}`\n\n    const response = await fetch(url, {\n      method,\n      headers: {\n        'Content-Type': 'application/json',\n        ...(this.accessToken && { Authorization: `Bearer ${this.accessToken}` }),\n        ...headers,\n      },\n      ...(body !== undefined && { body: JSON.stringify(body) }),\n    })\n\n    return this.handleResponse<TResponse>(response)\n  }\n\n  protected async handleResponse<TResponse>(response: Response): Promise<TResponse> {\n    if (!response.ok) {\n      const contentType = response.headers.get('Content-Type')\n      const isJson = contentType?.includes('application/json') ?? false\n\n      let errorMessage = `HTTP Error ${response.status}: ${response.statusText}`\n      let errorClass: string | undefined\n      let validationErrors: ValidationError[] | null = null\n\n      if (isJson) {\n        try {\n          const errorText = await response.text()\n          if (errorText) {\n            const errorData = JSON.parse(errorText)\n            errorMessage = errorData.message || errorData.error || errorMessage\n            errorClass = errorData.error\n            validationErrors = errorData.validationErrors ?? parseValidationErrors(errorData.errors)\n          }\n        } catch {\n          // If JSON parsing fails, use the default error message\n        }\n      }\n\n      throw new ApiError(errorMessage, errorClass, response.status, validationErrors)\n    }\n\n    // 204 No Content never has a body; short-circuit before reading the stream.\n    if (response.status === 204) {\n      return undefined as unknown as TResponse\n    }\n\n    // Read body as text once and treat an empty body as \"no content\" regardless of\n    // Content-Type. Servers sometimes return 200 with Content-Type: application/json\n    // and an empty body (e.g. POST endpoints whose framework keeps the default JSON\n    // content-type even when nothing is written). `response.json()` would throw\n    // \"Unexpected end of input\" in that case.\n    const text = await response.text()\n    if (!text) {\n      return undefined as unknown as TResponse\n    }\n\n    const contentType = response.headers.get('Content-Type')\n    const isJson = contentType?.includes('application/json') ?? false\n\n    if (isJson) {\n      return JSON.parse(text) as TResponse\n    }\n\n    try {\n      return JSON.parse(text) as TResponse\n    } catch {\n      return text as unknown as TResponse\n    }\n  }\n\n  get<TResponse = unknown>(endpoint: string, headers?: Record<string, string>): Promise<TResponse> {\n    return this.request<TResponse>('GET', endpoint, undefined, headers)\n  }\n\n  post<TResponse = unknown, TBody = unknown>(\n    endpoint: string,\n    body?: TBody,\n    headers?: Record<string, string>,\n  ): Promise<TResponse> {\n    return this.request<TResponse, TBody>('POST', endpoint, body, headers)\n  }\n\n  put<TResponse = unknown, TBody = unknown>(\n    endpoint: string,\n    body?: TBody,\n    headers?: Record<string, string>,\n  ): Promise<TResponse> {\n    return this.request<TResponse, TBody>('PUT', endpoint, body, headers)\n  }\n\n  patch<TResponse = unknown, TBody = unknown>(\n    endpoint: string,\n    body?: TBody,\n    headers?: Record<string, string>,\n  ): Promise<TResponse> {\n    return this.request<TResponse, TBody>('PATCH', endpoint, body, headers)\n  }\n\n  delete<TResponse = unknown>(\n    endpoint: string,\n    headers?: Record<string, string>,\n  ): Promise<TResponse> {\n    return this.request<TResponse>('DELETE', endpoint, undefined, headers)\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"BaseApiClient.cjs","names":["DEFAULT_QUERY_FORMAT","ApiConnectionError","ApiError"],"sources":["../../src/core/BaseApiClient.ts"],"sourcesContent":["import type { ApiClient, HttpMethod } from './ApiClient'\nimport { ApiConnectionError, ApiError } from './errors'\nimport { DEFAULT_QUERY_FORMAT, type QueryFormat } from './queryString'\n\nexport interface BaseApiClientOptions {\n  /** How list/get queries are serialized in the URL. Defaults to `'json'`. */\n  queryFormat?: QueryFormat\n}\n\nexport class BaseApiClient implements ApiClient {\n  protected readonly baseUrl: string\n  protected accessToken: string | null = null\n  public readonly queryFormat: QueryFormat\n\n  constructor(baseUrl: string, accessToken?: string, options: BaseApiClientOptions = {}) {\n    this.baseUrl = baseUrl.replace(/\\/$/, '')\n    this.accessToken = accessToken || null\n    this.queryFormat = options.queryFormat ?? DEFAULT_QUERY_FORMAT\n  }\n\n  setAccessToken(accessToken: string): this {\n    this.accessToken = accessToken\n    return this\n  }\n\n  async request<TResponse = unknown, TBody = unknown>(\n    method: HttpMethod,\n    endpoint: string,\n    body?: TBody,\n    headers?: Record<string, string>,\n  ): Promise<TResponse> {\n    const url = `${this.baseUrl}/${endpoint.replace(/^\\//, '')}`\n    const init: RequestInit = {\n      method,\n      headers: {\n        'Content-Type': 'application/json',\n        ...(this.accessToken && { Authorization: `Bearer ${this.accessToken}` }),\n        ...headers,\n      },\n      ...(body !== undefined && { body: JSON.stringify(body) }),\n    }\n\n    let response: Response\n    try {\n      response = await fetch(url, init)\n    } catch (error) {\n      const reason = error instanceof Error ? error.message : String(error)\n      throw new ApiConnectionError(`Request to ${method} ${url} failed: ${reason}`, {\n        cause: error,\n      })\n    }\n\n    return this.handleResponse<TResponse>(response)\n  }\n\n  protected async handleResponse<TResponse>(response: Response): Promise<TResponse> {\n    if (!response.ok) {\n      throw ApiError.fromResponse(\n        response.status,\n        response.statusText,\n        response.headers,\n        await this.readErrorBody(response),\n      )\n    }\n\n    // 204 No Content never has a body; short-circuit before reading the stream.\n    if (response.status === 204) {\n      return undefined as unknown as TResponse\n    }\n\n    // Read body as text once and treat an empty body as \"no content\" regardless of\n    // Content-Type. Servers sometimes return 200 with Content-Type: application/json\n    // and an empty body (e.g. POST endpoints whose framework keeps the default JSON\n    // content-type even when nothing is written). `response.json()` would throw\n    // \"Unexpected end of input\" in that case.\n    const text = await response.text()\n    if (!text) {\n      return undefined as unknown as TResponse\n    }\n\n    const contentType = response.headers.get('Content-Type')\n    const isJson = contentType?.includes('application/json') ?? false\n\n    if (isJson) {\n      return JSON.parse(text) as TResponse\n    }\n\n    try {\n      return JSON.parse(text) as TResponse\n    } catch {\n      return text as unknown as TResponse\n    }\n  }\n\n  /** Reads an error body: parsed JSON when possible, the raw text otherwise, `undefined` when empty. */\n  protected async readErrorBody(response: Response): Promise<unknown> {\n    let text: string\n    try {\n      text = await response.text()\n    } catch {\n      return undefined\n    }\n    if (!text) {\n      return undefined\n    }\n    try {\n      return JSON.parse(text)\n    } catch {\n      return text\n    }\n  }\n\n  get<TResponse = unknown>(endpoint: string, headers?: Record<string, string>): Promise<TResponse> {\n    return this.request<TResponse>('GET', endpoint, undefined, headers)\n  }\n\n  post<TResponse = unknown, TBody = unknown>(\n    endpoint: string,\n    body?: TBody,\n    headers?: Record<string, string>,\n  ): Promise<TResponse> {\n    return this.request<TResponse, TBody>('POST', endpoint, body, headers)\n  }\n\n  put<TResponse = unknown, TBody = unknown>(\n    endpoint: string,\n    body?: TBody,\n    headers?: Record<string, string>,\n  ): Promise<TResponse> {\n    return this.request<TResponse, TBody>('PUT', endpoint, body, headers)\n  }\n\n  patch<TResponse = unknown, TBody = unknown>(\n    endpoint: string,\n    body?: TBody,\n    headers?: Record<string, string>,\n  ): Promise<TResponse> {\n    return this.request<TResponse, TBody>('PATCH', endpoint, body, headers)\n  }\n\n  delete<TResponse = unknown>(\n    endpoint: string,\n    headers?: Record<string, string>,\n  ): Promise<TResponse> {\n    return this.request<TResponse>('DELETE', endpoint, undefined, headers)\n  }\n}\n"],"mappings":";;;;;AASA,IAAa,gBAAb,MAAgD;CAC9C,AAAmB;CACnB,AAAU,cAA6B;CACvC,AAAgB;CAEhB,YAAY,SAAiB,aAAsB,UAAgC,EAAE,EAAE;AACrF,OAAK,UAAU,QAAQ,QAAQ,OAAO,GAAG;AACzC,OAAK,cAAc,eAAe;AAClC,OAAK,cAAc,QAAQ,eAAeA;;CAG5C,eAAe,aAA2B;AACxC,OAAK,cAAc;AACnB,SAAO;;CAGT,MAAM,QACJ,QACA,UACA,MACA,SACoB;EACpB,MAAM,MAAM,GAAG,KAAK,QAAQ,GAAG,SAAS,QAAQ,OAAO,GAAG;EAC1D,MAAM,OAAoB;GACxB;GACA,SAAS;IACP,gBAAgB;IAChB,GAAI,KAAK,eAAe,EAAE,eAAe,UAAU,KAAK,eAAe;IACvE,GAAG;IACJ;GACD,GAAI,SAAS,UAAa,EAAE,MAAM,KAAK,UAAU,KAAK,EAAE;GACzD;EAED,IAAI;AACJ,MAAI;AACF,cAAW,MAAM,MAAM,KAAK,KAAK;WAC1B,OAAO;AAEd,SAAM,IAAIC,uCAAmB,cAAc,OAAO,GAAG,IAAI,WAD1C,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,IACS,EAC5E,OAAO,OACR,CAAC;;AAGJ,SAAO,KAAK,eAA0B,SAAS;;CAGjD,MAAgB,eAA0B,UAAwC;AAChF,MAAI,CAAC,SAAS,GACZ,OAAMC,6BAAS,aACb,SAAS,QACT,SAAS,YACT,SAAS,SACT,MAAM,KAAK,cAAc,SAAS,CACnC;AAIH,MAAI,SAAS,WAAW,IACtB;EAQF,MAAM,OAAO,MAAM,SAAS,MAAM;AAClC,MAAI,CAAC,KACH;AAMF,MAHoB,SAAS,QAAQ,IAAI,eAAe,EAC5B,SAAS,mBAAmB,IAAI,MAG1D,QAAO,KAAK,MAAM,KAAK;AAGzB,MAAI;AACF,UAAO,KAAK,MAAM,KAAK;UACjB;AACN,UAAO;;;;CAKX,MAAgB,cAAc,UAAsC;EAClE,IAAI;AACJ,MAAI;AACF,UAAO,MAAM,SAAS,MAAM;UACtB;AACN;;AAEF,MAAI,CAAC,KACH;AAEF,MAAI;AACF,UAAO,KAAK,MAAM,KAAK;UACjB;AACN,UAAO;;;CAIX,IAAyB,UAAkB,SAAsD;AAC/F,SAAO,KAAK,QAAmB,OAAO,UAAU,QAAW,QAAQ;;CAGrE,KACE,UACA,MACA,SACoB;AACpB,SAAO,KAAK,QAA0B,QAAQ,UAAU,MAAM,QAAQ;;CAGxE,IACE,UACA,MACA,SACoB;AACpB,SAAO,KAAK,QAA0B,OAAO,UAAU,MAAM,QAAQ;;CAGvE,MACE,UACA,MACA,SACoB;AACpB,SAAO,KAAK,QAA0B,SAAS,UAAU,MAAM,QAAQ;;CAGzE,OACE,UACA,SACoB;AACpB,SAAO,KAAK,QAAmB,UAAU,UAAU,QAAW,QAAQ"}

package/dist/core/BaseApiClient.d.ts

@@ -1,22 +1,19 @@
 import type { ApiClient, HttpMethod } from './ApiClient';
-export interface ValidationError {
-    path: string;
-    message: string;
-    code: string;
-}
-export declare class ApiError extends Error {
-    readonly errorClass?: string | undefined;
-    readonly status?: number | undefined;
-    readonly validationErrors: ValidationError[] | null;
-    constructor(message: string, errorClass?: string, status?: number, validationErrors?: ValidationError[] | null);
+import { type QueryFormat } from './queryString';
+export interface BaseApiClientOptions {
+    /** How list/get queries are serialized in the URL. Defaults to `'json'`. */
+    queryFormat?: QueryFormat;
 }
 export declare class BaseApiClient implements ApiClient {
     protected readonly baseUrl: string;
     protected accessToken: string | null;
-    constructor(baseUrl: string, accessToken?: string);
+    readonly queryFormat: QueryFormat;
+    constructor(baseUrl: string, accessToken?: string, options?: BaseApiClientOptions);
     setAccessToken(accessToken: string): this;
     request<TResponse = unknown, TBody = unknown>(method: HttpMethod, endpoint: string, body?: TBody, headers?: Record<string, string>): Promise<TResponse>;
     protected handleResponse<TResponse>(response: Response): Promise<TResponse>;
+    /** Reads an error body: parsed JSON when possible, the raw text otherwise, `undefined` when empty. */
+    protected readErrorBody(response: Response): Promise<unknown>;
     get<TResponse = unknown>(endpoint: string, headers?: Record<string, string>): Promise<TResponse>;
     post<TResponse = unknown, TBody = unknown>(endpoint: string, body?: TBody, headers?: Record<string, string>): Promise<TResponse>;
     put<TResponse = unknown, TBody = unknown>(endpoint: string, body?: TBody, headers?: Record<string, string>): Promise<TResponse>;

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

@@ -1 +1 @@
-{"version":3,"file":"BaseApiClient.d.ts","sourceRoot":"","sources":["../../src/core/BaseApiClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAExD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;CACb;AAsCD,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAgB,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/C,SAAgB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3C,SAAgB,gBAAgB,EAAE,eAAe,EAAE,GAAG,IAAI,CAAA;gBAGxD,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,MAAM,EACf,gBAAgB,GAAE,eAAe,EAAE,GAAG,IAAW;CAQpD;AAED,qBAAa,aAAc,YAAW,SAAS;IAC7C,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IAClC,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAO;gBAE/B,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;IAKjD,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAKnC,OAAO,CAAC,SAAS,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,EAChD,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,SAAS,CAAC;cAgBL,cAAc,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC;IAuDjF,GAAG,CAAC,SAAS,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;IAIhG,IAAI,CAAC,SAAS,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,EACvC,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,SAAS,CAAC;IAIrB,GAAG,CAAC,SAAS,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,EACtC,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,SAAS,CAAC;IAIrB,KAAK,CAAC,SAAS,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,EACxC,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,SAAS,CAAC;IAIrB,MAAM,CAAC,SAAS,GAAG,OAAO,EACxB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,SAAS,CAAC;CAGtB"}
+{"version":3,"file":"BaseApiClient.d.ts","sourceRoot":"","sources":["../../src/core/BaseApiClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAExD,OAAO,EAAwB,KAAK,WAAW,EAAE,MAAM,eAAe,CAAA;AAEtE,MAAM,WAAW,oBAAoB;IACnC,4EAA4E;IAC5E,WAAW,CAAC,EAAE,WAAW,CAAA;CAC1B;AAED,qBAAa,aAAc,YAAW,SAAS;IAC7C,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IAClC,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAO;IAC3C,SAAgB,WAAW,EAAE,WAAW,CAAA;gBAE5B,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB;IAMrF,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAKnC,OAAO,CAAC,SAAS,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,EAChD,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,SAAS,CAAC;cAyBL,cAAc,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC;IAuCjF,sGAAsG;cACtF,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAiBnE,GAAG,CAAC,SAAS,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;IAIhG,IAAI,CAAC,SAAS,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,EACvC,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,SAAS,CAAC;IAIrB,GAAG,CAAC,SAAS,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,EACtC,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,SAAS,CAAC;IAIrB,KAAK,CAAC,SAAS,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,EACxC,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,SAAS,CAAC;IAIrB,MAAM,CAAC,SAAS,GAAG,OAAO,EACxB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,SAAS,CAAC;CAGtB"}

package/dist/core/BaseApiClient.mjs

@@ -1,47 +1,15 @@
+import { ApiConnectionError, ApiError } from "./errors.mjs";
+import { DEFAULT_QUERY_FORMAT } from "./queryString.mjs";
+
 //#region src/core/BaseApiClient.ts
-const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-/**
-* Flattens the Digisac `errors` object into `ValidationError[]` — one entry per message, with
-* `path` = `<location>.<field>` (e.g. `body.name`) and `code` = the rule type (e.g. `required`).
-* Returns `null` when the body carries no field errors.
-*/
-function parseValidationErrors(errors) {
-	if (!isRecord(errors)) return null;
-	const parsed = [];
-	for (const [location, fields] of Object.entries(errors)) {
-		if (!isRecord(fields)) continue;
-		for (const [field, detail] of Object.entries(fields)) {
-			const messages = Array.isArray(detail?.messages) ? detail.messages.map(String) : [];
-			const types = Array.isArray(detail?.types) ? detail.types.map(String) : [];
-			messages.forEach((message, index) => {
-				parsed.push({
-					path: `${location}.${field}`,
-					message,
-					code: types[index] ?? types[0] ?? ""
-				});
-			});
-		}
-	}
-	return parsed.length ? parsed : null;
-}
-var ApiError = class extends Error {
-	errorClass;
-	status;
-	validationErrors;
-	constructor(message, errorClass, status, validationErrors = null) {
-		super(message);
-		this.name = "ApiError";
-		this.errorClass = errorClass;
-		this.status = status;
-		this.validationErrors = validationErrors;
-	}
-};
 var BaseApiClient = class {
 	baseUrl;
 	accessToken = null;
-	constructor(baseUrl, accessToken) {
+	queryFormat;
+	constructor(baseUrl, accessToken, options = {}) {
 		this.baseUrl = baseUrl.replace(/\/$/, "");
 		this.accessToken = accessToken || null;
+		this.queryFormat = options.queryFormat ?? DEFAULT_QUERY_FORMAT;
 	}
 	setAccessToken(accessToken) {
 		this.accessToken = accessToken;
@@ -49,7 +17,7 @@ var BaseApiClient = class {
 	}
 	async request(method, endpoint, body, headers) {
 		const url = `${this.baseUrl}/${endpoint.replace(/^\//, "")}`;
-		const response = await fetch(url, {
+		const init = {
 			method,
 			headers: {
 				"Content-Type": "application/json",
@@ -57,26 +25,17 @@ var BaseApiClient = class {
 				...headers
 			},
 			...body !== void 0 && { body: JSON.stringify(body) }
-		});
+		};
+		let response;
+		try {
+			response = await fetch(url, init);
+		} catch (error) {
+			throw new ApiConnectionError(`Request to ${method} ${url} failed: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+		}
 		return this.handleResponse(response);
 	}
 	async handleResponse(response) {
-		if (!response.ok) {
-			const isJson = response.headers.get("Content-Type")?.includes("application/json") ?? false;
-			let errorMessage = `HTTP Error ${response.status}: ${response.statusText}`;
-			let errorClass;
-			let validationErrors = null;
-			if (isJson) try {
-				const errorText = await response.text();
-				if (errorText) {
-					const errorData = JSON.parse(errorText);
-					errorMessage = errorData.message || errorData.error || errorMessage;
-					errorClass = errorData.error;
-					validationErrors = errorData.validationErrors ?? parseValidationErrors(errorData.errors);
-				}
-			} catch {}
-			throw new ApiError(errorMessage, errorClass, response.status, validationErrors);
-		}
+		if (!response.ok) throw ApiError.fromResponse(response.status, response.statusText, response.headers, await this.readErrorBody(response));
 		if (response.status === 204) return;
 		const text = await response.text();
 		if (!text) return;
@@ -87,6 +46,21 @@ var BaseApiClient = class {
 			return text;
 		}
 	}
+	/** Reads an error body: parsed JSON when possible, the raw text otherwise, `undefined` when empty. */
+	async readErrorBody(response) {
+		let text;
+		try {
+			text = await response.text();
+		} catch {
+			return;
+		}
+		if (!text) return;
+		try {
+			return JSON.parse(text);
+		} catch {
+			return text;
+		}
+	}
 	get(endpoint, headers) {
 		return this.request("GET", endpoint, void 0, headers);
 	}
@@ -105,5 +79,5 @@ var BaseApiClient = class {
 };
 
 //#endregion
-export { ApiError, BaseApiClient };
+export { BaseApiClient };
 //# sourceMappingURL=BaseApiClient.mjs.map

package/dist/core/BaseApiClient.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"BaseApiClient.mjs","names":[],"sources":["../../src/core/BaseApiClient.ts"],"sourcesContent":["import type { ApiClient, HttpMethod } from './ApiClient'\n\nexport interface ValidationError {\n  path: string\n  message: string\n  code: string\n}\n\n/**\n * Digisac field errors: `{ errors: { <location>: { <field>: { messages: string[], types: string[] } } } }`,\n * where location is `body`, `params`, `query`, `headers` or `cookies` (backend `validate` middleware).\n */\ntype DigisacFieldErrors = Record<string, Record<string, { messages?: unknown; types?: unknown }>>\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value)\n\n/**\n * Flattens the Digisac `errors` object into `ValidationError[]` — one entry per message, with\n * `path` = `<location>.<field>` (e.g. `body.name`) and `code` = the rule type (e.g. `required`).\n * Returns `null` when the body carries no field errors.\n */\nfunction parseValidationErrors(errors: unknown): ValidationError[] | null {\n  if (!isRecord(errors)) {\n    return null\n  }\n\n  const parsed: ValidationError[] = []\n  for (const [location, fields] of Object.entries(errors as DigisacFieldErrors)) {\n    if (!isRecord(fields)) {\n      continue\n    }\n    for (const [field, detail] of Object.entries(fields)) {\n      const messages = Array.isArray(detail?.messages) ? detail.messages.map(String) : []\n      const types = Array.isArray(detail?.types) ? detail.types.map(String) : []\n      messages.forEach((message, index) => {\n        parsed.push({ path: `${location}.${field}`, message, code: types[index] ?? types[0] ?? '' })\n      })\n    }\n  }\n\n  return parsed.length ? parsed : null\n}\n\nexport class ApiError extends Error {\n  public readonly errorClass?: string | undefined\n  public readonly status?: number | undefined\n  public readonly validationErrors: ValidationError[] | null\n\n  constructor(\n    message: string,\n    errorClass?: string,\n    status?: number,\n    validationErrors: ValidationError[] | null = null,\n  ) {\n    super(message)\n    this.name = 'ApiError'\n    this.errorClass = errorClass\n    this.status = status\n    this.validationErrors = validationErrors\n  }\n}\n\nexport class BaseApiClient implements ApiClient {\n  protected readonly baseUrl: string\n  protected accessToken: string | null = null\n\n  constructor(baseUrl: string, accessToken?: string) {\n    this.baseUrl = baseUrl.replace(/\\/$/, '')\n    this.accessToken = accessToken || null\n  }\n\n  setAccessToken(accessToken: string): this {\n    this.accessToken = accessToken\n    return this\n  }\n\n  async request<TResponse = unknown, TBody = unknown>(\n    method: HttpMethod,\n    endpoint: string,\n    body?: TBody,\n    headers?: Record<string, string>,\n  ): Promise<TResponse> {\n    const url = `${this.baseUrl}/${endpoint.replace(/^\\//, '')}`\n\n    const response = await fetch(url, {\n      method,\n      headers: {\n        'Content-Type': 'application/json',\n        ...(this.accessToken && { Authorization: `Bearer ${this.accessToken}` }),\n        ...headers,\n      },\n      ...(body !== undefined && { body: JSON.stringify(body) }),\n    })\n\n    return this.handleResponse<TResponse>(response)\n  }\n\n  protected async handleResponse<TResponse>(response: Response): Promise<TResponse> {\n    if (!response.ok) {\n      const contentType = response.headers.get('Content-Type')\n      const isJson = contentType?.includes('application/json') ?? false\n\n      let errorMessage = `HTTP Error ${response.status}: ${response.statusText}`\n      let errorClass: string | undefined\n      let validationErrors: ValidationError[] | null = null\n\n      if (isJson) {\n        try {\n          const errorText = await response.text()\n          if (errorText) {\n            const errorData = JSON.parse(errorText)\n            errorMessage = errorData.message || errorData.error || errorMessage\n            errorClass = errorData.error\n            validationErrors = errorData.validationErrors ?? parseValidationErrors(errorData.errors)\n          }\n        } catch {\n          // If JSON parsing fails, use the default error message\n        }\n      }\n\n      throw new ApiError(errorMessage, errorClass, response.status, validationErrors)\n    }\n\n    // 204 No Content never has a body; short-circuit before reading the stream.\n    if (response.status === 204) {\n      return undefined as unknown as TResponse\n    }\n\n    // Read body as text once and treat an empty body as \"no content\" regardless of\n    // Content-Type. Servers sometimes return 200 with Content-Type: application/json\n    // and an empty body (e.g. POST endpoints whose framework keeps the default JSON\n    // content-type even when nothing is written). `response.json()` would throw\n    // \"Unexpected end of input\" in that case.\n    const text = await response.text()\n    if (!text) {\n      return undefined as unknown as TResponse\n    }\n\n    const contentType = response.headers.get('Content-Type')\n    const isJson = contentType?.includes('application/json') ?? false\n\n    if (isJson) {\n      return JSON.parse(text) as TResponse\n    }\n\n    try {\n      return JSON.parse(text) as TResponse\n    } catch {\n      return text as unknown as TResponse\n    }\n  }\n\n  get<TResponse = unknown>(endpoint: string, headers?: Record<string, string>): Promise<TResponse> {\n    return this.request<TResponse>('GET', endpoint, undefined, headers)\n  }\n\n  post<TResponse = unknown, TBody = unknown>(\n    endpoint: string,\n    body?: TBody,\n    headers?: Record<string, string>,\n  ): Promise<TResponse> {\n    return this.request<TResponse, TBody>('POST', endpoint, body, headers)\n  }\n\n  put<TResponse = unknown, TBody = unknown>(\n    endpoint: string,\n    body?: TBody,\n    headers?: Record<string, string>,\n  ): Promise<TResponse> {\n    return this.request<TResponse, TBody>('PUT', endpoint, body, headers)\n  }\n\n  patch<TResponse = unknown, TBody = unknown>(\n    endpoint: string,\n    body?: TBody,\n    headers?: Record<string, string>,\n  ): Promise<TResponse> {\n    return this.request<TResponse, TBody>('PATCH', endpoint, body, headers)\n  }\n\n  delete<TResponse = unknown>(\n    endpoint: string,\n    headers?: Record<string, string>,\n  ): Promise<TResponse> {\n    return this.request<TResponse>('DELETE', endpoint, undefined, headers)\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"BaseApiClient.mjs","names":[],"sources":["../../src/core/BaseApiClient.ts"],"sourcesContent":["import type { ApiClient, HttpMethod } from './ApiClient'\nimport { ApiConnectionError, ApiError } from './errors'\nimport { DEFAULT_QUERY_FORMAT, type QueryFormat } from './queryString'\n\nexport interface BaseApiClientOptions {\n  /** How list/get queries are serialized in the URL. Defaults to `'json'`. */\n  queryFormat?: QueryFormat\n}\n\nexport class BaseApiClient implements ApiClient {\n  protected readonly baseUrl: string\n  protected accessToken: string | null = null\n  public readonly queryFormat: QueryFormat\n\n  constructor(baseUrl: string, accessToken?: string, options: BaseApiClientOptions = {}) {\n    this.baseUrl = baseUrl.replace(/\\/$/, '')\n    this.accessToken = accessToken || null\n    this.queryFormat = options.queryFormat ?? DEFAULT_QUERY_FORMAT\n  }\n\n  setAccessToken(accessToken: string): this {\n    this.accessToken = accessToken\n    return this\n  }\n\n  async request<TResponse = unknown, TBody = unknown>(\n    method: HttpMethod,\n    endpoint: string,\n    body?: TBody,\n    headers?: Record<string, string>,\n  ): Promise<TResponse> {\n    const url = `${this.baseUrl}/${endpoint.replace(/^\\//, '')}`\n    const init: RequestInit = {\n      method,\n      headers: {\n        'Content-Type': 'application/json',\n        ...(this.accessToken && { Authorization: `Bearer ${this.accessToken}` }),\n        ...headers,\n      },\n      ...(body !== undefined && { body: JSON.stringify(body) }),\n    }\n\n    let response: Response\n    try {\n      response = await fetch(url, init)\n    } catch (error) {\n      const reason = error instanceof Error ? error.message : String(error)\n      throw new ApiConnectionError(`Request to ${method} ${url} failed: ${reason}`, {\n        cause: error,\n      })\n    }\n\n    return this.handleResponse<TResponse>(response)\n  }\n\n  protected async handleResponse<TResponse>(response: Response): Promise<TResponse> {\n    if (!response.ok) {\n      throw ApiError.fromResponse(\n        response.status,\n        response.statusText,\n        response.headers,\n        await this.readErrorBody(response),\n      )\n    }\n\n    // 204 No Content never has a body; short-circuit before reading the stream.\n    if (response.status === 204) {\n      return undefined as unknown as TResponse\n    }\n\n    // Read body as text once and treat an empty body as \"no content\" regardless of\n    // Content-Type. Servers sometimes return 200 with Content-Type: application/json\n    // and an empty body (e.g. POST endpoints whose framework keeps the default JSON\n    // content-type even when nothing is written). `response.json()` would throw\n    // \"Unexpected end of input\" in that case.\n    const text = await response.text()\n    if (!text) {\n      return undefined as unknown as TResponse\n    }\n\n    const contentType = response.headers.get('Content-Type')\n    const isJson = contentType?.includes('application/json') ?? false\n\n    if (isJson) {\n      return JSON.parse(text) as TResponse\n    }\n\n    try {\n      return JSON.parse(text) as TResponse\n    } catch {\n      return text as unknown as TResponse\n    }\n  }\n\n  /** Reads an error body: parsed JSON when possible, the raw text otherwise, `undefined` when empty. */\n  protected async readErrorBody(response: Response): Promise<unknown> {\n    let text: string\n    try {\n      text = await response.text()\n    } catch {\n      return undefined\n    }\n    if (!text) {\n      return undefined\n    }\n    try {\n      return JSON.parse(text)\n    } catch {\n      return text\n    }\n  }\n\n  get<TResponse = unknown>(endpoint: string, headers?: Record<string, string>): Promise<TResponse> {\n    return this.request<TResponse>('GET', endpoint, undefined, headers)\n  }\n\n  post<TResponse = unknown, TBody = unknown>(\n    endpoint: string,\n    body?: TBody,\n    headers?: Record<string, string>,\n  ): Promise<TResponse> {\n    return this.request<TResponse, TBody>('POST', endpoint, body, headers)\n  }\n\n  put<TResponse = unknown, TBody = unknown>(\n    endpoint: string,\n    body?: TBody,\n    headers?: Record<string, string>,\n  ): Promise<TResponse> {\n    return this.request<TResponse, TBody>('PUT', endpoint, body, headers)\n  }\n\n  patch<TResponse = unknown, TBody = unknown>(\n    endpoint: string,\n    body?: TBody,\n    headers?: Record<string, string>,\n  ): Promise<TResponse> {\n    return this.request<TResponse, TBody>('PATCH', endpoint, body, headers)\n  }\n\n  delete<TResponse = unknown>(\n    endpoint: string,\n    headers?: Record<string, string>,\n  ): Promise<TResponse> {\n    return this.request<TResponse>('DELETE', endpoint, undefined, headers)\n  }\n}\n"],"mappings":";;;;AASA,IAAa,gBAAb,MAAgD;CAC9C,AAAmB;CACnB,AAAU,cAA6B;CACvC,AAAgB;CAEhB,YAAY,SAAiB,aAAsB,UAAgC,EAAE,EAAE;AACrF,OAAK,UAAU,QAAQ,QAAQ,OAAO,GAAG;AACzC,OAAK,cAAc,eAAe;AAClC,OAAK,cAAc,QAAQ,eAAe;;CAG5C,eAAe,aAA2B;AACxC,OAAK,cAAc;AACnB,SAAO;;CAGT,MAAM,QACJ,QACA,UACA,MACA,SACoB;EACpB,MAAM,MAAM,GAAG,KAAK,QAAQ,GAAG,SAAS,QAAQ,OAAO,GAAG;EAC1D,MAAM,OAAoB;GACxB;GACA,SAAS;IACP,gBAAgB;IAChB,GAAI,KAAK,eAAe,EAAE,eAAe,UAAU,KAAK,eAAe;IACvE,GAAG;IACJ;GACD,GAAI,SAAS,UAAa,EAAE,MAAM,KAAK,UAAU,KAAK,EAAE;GACzD;EAED,IAAI;AACJ,MAAI;AACF,cAAW,MAAM,MAAM,KAAK,KAAK;WAC1B,OAAO;AAEd,SAAM,IAAI,mBAAmB,cAAc,OAAO,GAAG,IAAI,WAD1C,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,IACS,EAC5E,OAAO,OACR,CAAC;;AAGJ,SAAO,KAAK,eAA0B,SAAS;;CAGjD,MAAgB,eAA0B,UAAwC;AAChF,MAAI,CAAC,SAAS,GACZ,OAAM,SAAS,aACb,SAAS,QACT,SAAS,YACT,SAAS,SACT,MAAM,KAAK,cAAc,SAAS,CACnC;AAIH,MAAI,SAAS,WAAW,IACtB;EAQF,MAAM,OAAO,MAAM,SAAS,MAAM;AAClC,MAAI,CAAC,KACH;AAMF,MAHoB,SAAS,QAAQ,IAAI,eAAe,EAC5B,SAAS,mBAAmB,IAAI,MAG1D,QAAO,KAAK,MAAM,KAAK;AAGzB,MAAI;AACF,UAAO,KAAK,MAAM,KAAK;UACjB;AACN,UAAO;;;;CAKX,MAAgB,cAAc,UAAsC;EAClE,IAAI;AACJ,MAAI;AACF,UAAO,MAAM,SAAS,MAAM;UACtB;AACN;;AAEF,MAAI,CAAC,KACH;AAEF,MAAI;AACF,UAAO,KAAK,MAAM,KAAK;UACjB;AACN,UAAO;;;CAIX,IAAyB,UAAkB,SAAsD;AAC/F,SAAO,KAAK,QAAmB,OAAO,UAAU,QAAW,QAAQ;;CAGrE,KACE,UACA,MACA,SACoB;AACpB,SAAO,KAAK,QAA0B,QAAQ,UAAU,MAAM,QAAQ;;CAGxE,IACE,UACA,MACA,SACoB;AACpB,SAAO,KAAK,QAA0B,OAAO,UAAU,MAAM,QAAQ;;CAGvE,MACE,UACA,MACA,SACoB;AACpB,SAAO,KAAK,QAA0B,SAAS,UAAU,MAAM,QAAQ;;CAGzE,OACE,UACA,SACoB;AACpB,SAAO,KAAK,QAAmB,UAAU,UAAU,QAAW,QAAQ"}

package/dist/core/BaseCrudApi.cjs

@@ -1,24 +1,15 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_chunk = require('../_chunks/chunk-Dk0Otj32.cjs');
-let qs = require("qs");
-qs = require_chunk.__toESM(qs);
+const require_core_BaseApi = require('./BaseApi.cjs');
 
 //#region src/core/BaseCrudApi.ts
-var BaseCrudApi = class {
-	client;
+var BaseCrudApi = class extends require_core_BaseApi.BaseApi {
 	basePath;
 	constructor(client, basePath) {
-		this.client = client;
+		super(client);
 		this.basePath = basePath.replace(/\/$/, "");
-		this.getMany = this.getMany.bind(this);
-		this.getOne = this.getOne.bind(this);
-		this.getById = this.getById.bind(this);
-		this.create = this.create.bind(this);
-		this.updateById = this.updateById.bind(this);
-		this.deleteById = this.deleteById.bind(this);
 	}
 	getMany(query, headers) {
-		const queryString = query ? `?${qs.default.stringify(query)}` : "";
+		const queryString = this.toQueryString(query);
 		return this.client.get(`${this.basePath}${queryString}`, headers);
 	}
 	/**
@@ -31,15 +22,14 @@ var BaseCrudApi = class {
 			...query,
 			limit: 1,
 			paginate: false
-		}, headers))[0] ?? null;
+		}, headers))?.[0] ?? null;
 	}
 	/**
 	* Returns a single resource by ID.
 	* @permissions $resourceName.view
 	*/
 	getById(id, query, headers) {
-		const queryString = query ? `?${qs.default.stringify(query)}` : "";
-		return this.client.get(`${this.basePath}/${id}${queryString}`, headers);
+		return this.client.get(`${this.basePath}/${id}${this.toQueryString(query)}`, headers);
 	}
 	/**
 	* Creates a new resource.

package/dist/core/BaseCrudApi.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"BaseCrudApi.cjs","names":[],"sources":["../../src/core/BaseCrudApi.ts"],"sourcesContent":["import qs from 'qs'\nimport type { ApiClient } from './ApiClient'\nimport type { CrudApi, GetByIdQuery, ListQuery, Paginated } from './types'\nexport type {\n  WhereClause,\n  IncludeItem,\n  ListQuery,\n  GetByIdQuery,\n  Paginated,\n  HasGetMany,\n  HasGetById,\n  HasCreate,\n  HasUpdateById,\n  HasDeleteById,\n  CrudApi,\n} from './types'\n\nexport class BaseCrudApi<\n  TResponse,\n  TCreate,\n  TUpdate = TCreate,\n  TQuery extends ListQuery<TResponse> = ListQuery<TResponse>,\n> implements CrudApi<TResponse, TCreate, TUpdate, TQuery> {\n  public readonly client: ApiClient\n  public readonly basePath: string\n\n  constructor(client: ApiClient, basePath: string) {\n    this.client = client\n    this.basePath = basePath.replace(/\\/$/, '')\n    this.getMany = this.getMany.bind(this)\n    this.getOne = this.getOne.bind(this)\n    this.getById = this.getById.bind(this)\n    this.create = this.create.bind(this)\n    this.updateById = this.updateById.bind(this)\n    this.deleteById = this.deleteById.bind(this)\n  }\n\n  getMany(\n    query: TQuery & { paginate: false },\n    headers?: Record<string, string>,\n  ): Promise<TResponse[]>\n  getMany(\n    query?: TQuery & { paginate?: true },\n    headers?: Record<string, string>,\n  ): Promise<Paginated<TResponse>>\n  getMany(\n    query?: TQuery,\n    headers?: Record<string, string>,\n  ): Promise<Paginated<TResponse> | TResponse[]> {\n    const queryString = query ? `?${qs.stringify(query)}` : ''\n    return this.client.get<Paginated<TResponse> | TResponse[]>(\n      `${this.basePath}${queryString}`,\n      headers,\n    )\n  }\n\n  /**\n   * Returns the first resource matching the query, or `null` when none match.\n   * Convenience over `getMany` with `limit: 1`.\n   * @permissions $resourceName.view\n   */\n  async getOne(query?: TQuery, headers?: Record<string, string>): Promise<TResponse | null> {\n    const results = await this.getMany(\n      { ...query, limit: 1, paginate: false } as TQuery & { paginate: false },\n      headers,\n    )\n    return results[0] ?? null\n  }\n\n  /**\n   * Returns a single resource by ID.\n   * @permissions $resourceName.view\n   */\n  getById(\n    id: string,\n    query?: GetByIdQuery<TResponse>,\n    headers?: Record<string, string>,\n  ): Promise<TResponse> {\n    const queryString = query ? `?${qs.stringify(query)}` : ''\n    return this.client.get<TResponse>(`${this.basePath}/${id}${queryString}`, headers)\n  }\n\n  /**\n   * Creates a new resource.\n   * @permissions $resourceName.create\n   */\n  create(body: TCreate, headers?: Record<string, string>): Promise<TResponse> {\n    return this.client.post<TResponse, TCreate>(this.basePath, body, headers)\n  }\n\n  /**\n   * Updates an existing resource by ID.\n   * @permissions $resourceName.update\n   */\n  updateById(id: string, body: TUpdate, headers?: Record<string, string>): Promise<TResponse> {\n    return this.client.put<TResponse, TUpdate>(`${this.basePath}/${id}`, body, headers)\n  }\n\n  /**\n   * Deletes a resource by ID.\n   * @permissions $resourceName.delete\n   */\n  deleteById(id: string, headers?: Record<string, string>): Promise<TResponse> {\n    return this.client.delete<TResponse>(`${this.basePath}/${id}`, headers)\n  }\n}\n"],"mappings":";;;;;;AAiBA,IAAa,cAAb,MAK0D;CACxD,AAAgB;CAChB,AAAgB;CAEhB,YAAY,QAAmB,UAAkB;AAC/C,OAAK,SAAS;AACd,OAAK,WAAW,SAAS,QAAQ,OAAO,GAAG;AAC3C,OAAK,UAAU,KAAK,QAAQ,KAAK,KAAK;AACtC,OAAK,SAAS,KAAK,OAAO,KAAK,KAAK;AACpC,OAAK,UAAU,KAAK,QAAQ,KAAK,KAAK;AACtC,OAAK,SAAS,KAAK,OAAO,KAAK,KAAK;AACpC,OAAK,aAAa,KAAK,WAAW,KAAK,KAAK;AAC5C,OAAK,aAAa,KAAK,WAAW,KAAK,KAAK;;CAW9C,QACE,OACA,SAC6C;EAC7C,MAAM,cAAc,QAAQ,IAAI,WAAG,UAAU,MAAM,KAAK;AACxD,SAAO,KAAK,OAAO,IACjB,GAAG,KAAK,WAAW,eACnB,QACD;;;;;;;CAQH,MAAM,OAAO,OAAgB,SAA6D;AAKxF,UAJgB,MAAM,KAAK,QACzB;GAAE,GAAG;GAAO,OAAO;GAAG,UAAU;GAAO,EACvC,QACD,EACc,MAAM;;;;;;CAOvB,QACE,IACA,OACA,SACoB;EACpB,MAAM,cAAc,QAAQ,IAAI,WAAG,UAAU,MAAM,KAAK;AACxD,SAAO,KAAK,OAAO,IAAe,GAAG,KAAK,SAAS,GAAG,KAAK,eAAe,QAAQ;;;;;;CAOpF,OAAO,MAAe,SAAsD;AAC1E,SAAO,KAAK,OAAO,KAAyB,KAAK,UAAU,MAAM,QAAQ;;;;;;CAO3E,WAAW,IAAY,MAAe,SAAsD;AAC1F,SAAO,KAAK,OAAO,IAAwB,GAAG,KAAK,SAAS,GAAG,MAAM,MAAM,QAAQ;;;;;;CAOrF,WAAW,IAAY,SAAsD;AAC3E,SAAO,KAAK,OAAO,OAAkB,GAAG,KAAK,SAAS,GAAG,MAAM,QAAQ"}
+{"version":3,"file":"BaseCrudApi.cjs","names":["BaseApi"],"sources":["../../src/core/BaseCrudApi.ts"],"sourcesContent":["import type { ApiClient } from './ApiClient'\nimport { BaseApi } from './BaseApi'\nimport type { CrudApi, GetByIdQuery, ListQuery, Paginated } from './types'\nexport type {\n  WhereClause,\n  IncludeItem,\n  ListQuery,\n  GetByIdQuery,\n  Paginated,\n  HasGetMany,\n  HasGetById,\n  HasCreate,\n  HasUpdateById,\n  HasDeleteById,\n  CrudApi,\n} from './types'\n\nexport class BaseCrudApi<\n  TResponse,\n  TCreate,\n  TUpdate = TCreate,\n  TQuery extends ListQuery<TResponse> = ListQuery<TResponse>,\n>\n  extends BaseApi\n  implements CrudApi<TResponse, TCreate, TUpdate, TQuery>\n{\n  public readonly basePath: string\n\n  constructor(client: ApiClient, basePath: string) {\n    super(client)\n    this.basePath = basePath.replace(/\\/$/, '')\n  }\n\n  getMany(\n    query: TQuery & { paginate: false },\n    headers?: Record<string, string>,\n  ): Promise<TResponse[]>\n  getMany(\n    query?: TQuery & { paginate?: true },\n    headers?: Record<string, string>,\n  ): Promise<Paginated<TResponse>>\n  getMany(\n    query?: TQuery,\n    headers?: Record<string, string>,\n  ): Promise<Paginated<TResponse> | TResponse[]>\n  getMany(\n    query?: TQuery,\n    headers?: Record<string, string>,\n  ): Promise<Paginated<TResponse> | TResponse[]> {\n    const queryString = this.toQueryString(query)\n    return this.client.get<Paginated<TResponse> | TResponse[]>(\n      `${this.basePath}${queryString}`,\n      headers,\n    )\n  }\n\n  /**\n   * Returns the first resource matching the query, or `null` when none match.\n   * Convenience over `getMany` with `limit: 1`.\n   * @permissions $resourceName.view\n   */\n  async getOne(query?: TQuery, headers?: Record<string, string>): Promise<TResponse | null> {\n    const results = await this.getMany(\n      { ...query, limit: 1, paginate: false } as TQuery & { paginate: false },\n      headers,\n    )\n    // An empty response body resolves to `undefined`.\n    return results?.[0] ?? null\n  }\n\n  /**\n   * Returns a single resource by ID.\n   * @permissions $resourceName.view\n   */\n  getById(\n    id: string,\n    query?: GetByIdQuery<TResponse>,\n    headers?: Record<string, string>,\n  ): Promise<TResponse> {\n    return this.client.get<TResponse>(`${this.basePath}/${id}${this.toQueryString(query)}`, headers)\n  }\n\n  /**\n   * Creates a new resource.\n   * @permissions $resourceName.create\n   */\n  create(body: TCreate, headers?: Record<string, string>): Promise<TResponse> {\n    return this.client.post<TResponse, TCreate>(this.basePath, body, headers)\n  }\n\n  /**\n   * Updates an existing resource by ID.\n   * @permissions $resourceName.update\n   */\n  updateById(id: string, body: TUpdate, headers?: Record<string, string>): Promise<TResponse> {\n    return this.client.put<TResponse, TUpdate>(`${this.basePath}/${id}`, body, headers)\n  }\n\n  /**\n   * Deletes a resource by ID.\n   * @permissions $resourceName.delete\n   */\n  deleteById(id: string, headers?: Record<string, string>): Promise<TResponse> {\n    return this.client.delete<TResponse>(`${this.basePath}/${id}`, headers)\n  }\n}\n"],"mappings":";;;;AAiBA,IAAa,cAAb,cAMUA,6BAEV;CACE,AAAgB;CAEhB,YAAY,QAAmB,UAAkB;AAC/C,QAAM,OAAO;AACb,OAAK,WAAW,SAAS,QAAQ,OAAO,GAAG;;CAe7C,QACE,OACA,SAC6C;EAC7C,MAAM,cAAc,KAAK,cAAc,MAAM;AAC7C,SAAO,KAAK,OAAO,IACjB,GAAG,KAAK,WAAW,eACnB,QACD;;;;;;;CAQH,MAAM,OAAO,OAAgB,SAA6D;AAMxF,UALgB,MAAM,KAAK,QACzB;GAAE,GAAG;GAAO,OAAO;GAAG,UAAU;GAAO,EACvC,QACD,IAEgB,MAAM;;;;;;CAOzB,QACE,IACA,OACA,SACoB;AACpB,SAAO,KAAK,OAAO,IAAe,GAAG,KAAK,SAAS,GAAG,KAAK,KAAK,cAAc,MAAM,IAAI,QAAQ;;;;;;CAOlG,OAAO,MAAe,SAAsD;AAC1E,SAAO,KAAK,OAAO,KAAyB,KAAK,UAAU,MAAM,QAAQ;;;;;;CAO3E,WAAW,IAAY,MAAe,SAAsD;AAC1F,SAAO,KAAK,OAAO,IAAwB,GAAG,KAAK,SAAS,GAAG,MAAM,MAAM,QAAQ;;;;;;CAOrF,WAAW,IAAY,SAAsD;AAC3E,SAAO,KAAK,OAAO,OAAkB,GAAG,KAAK,SAAS,GAAG,MAAM,QAAQ"}

package/dist/core/BaseCrudApi.d.ts

@@ -1,8 +1,8 @@
 import type { ApiClient } from './ApiClient';
+import { BaseApi } from './BaseApi';
 import type { CrudApi, GetByIdQuery, ListQuery, Paginated } from './types';
 export type { WhereClause, IncludeItem, ListQuery, GetByIdQuery, Paginated, HasGetMany, HasGetById, HasCreate, HasUpdateById, HasDeleteById, CrudApi, } from './types';
-export declare class BaseCrudApi<TResponse, TCreate, TUpdate = TCreate, TQuery extends ListQuery<TResponse> = ListQuery<TResponse>> implements CrudApi<TResponse, TCreate, TUpdate, TQuery> {
-    readonly client: ApiClient;
+export declare class BaseCrudApi<TResponse, TCreate, TUpdate = TCreate, TQuery extends ListQuery<TResponse> = ListQuery<TResponse>> extends BaseApi implements CrudApi<TResponse, TCreate, TUpdate, TQuery> {
     readonly basePath: string;
     constructor(client: ApiClient, basePath: string);
     getMany(query: TQuery & {
@@ -11,6 +11,7 @@ export declare class BaseCrudApi<TResponse, TCreate, TUpdate = TCreate, TQuery e
     getMany(query?: TQuery & {
         paginate?: true;
     }, headers?: Record<string, string>): Promise<Paginated<TResponse>>;
+    getMany(query?: TQuery, headers?: Record<string, string>): Promise<Paginated<TResponse> | TResponse[]>;
     /**
      * Returns the first resource matching the query, or `null` when none match.
      * Convenience over `getMany` with `limit: 1`.

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

@@ -1 +1 @@
-{"version":3,"file":"BaseCrudApi.d.ts","sourceRoot":"","sources":["../../src/core/BaseCrudApi.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAC1E,YAAY,EACV,WAAW,EACX,WAAW,EACX,SAAS,EACT,YAAY,EACZ,SAAS,EACT,UAAU,EACV,UAAU,EACV,SAAS,EACT,aAAa,EACb,aAAa,EACb,OAAO,GACR,MAAM,SAAS,CAAA;AAEhB,qBAAa,WAAW,CACtB,SAAS,EACT,OAAO,EACP,OAAO,GAAG,OAAO,EACjB,MAAM,SAAS,SAAS,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC,SAAS,CAAC,CAC1D,YAAW,OAAO,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC;IACvD,SAAgB,MAAM,EAAE,SAAS,CAAA;IACjC,SAAgB,QAAQ,EAAE,MAAM,CAAA;gBAEpB,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM;IAW/C,OAAO,CACL,KAAK,EAAE,MAAM,GAAG;QAAE,QAAQ,EAAE,KAAK,CAAA;KAAE,EACnC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,SAAS,EAAE,CAAC;IACvB,OAAO,CACL,KAAK,CAAC,EAAE,MAAM,GAAG;QAAE,QAAQ,CAAC,EAAE,IAAI,CAAA;KAAE,EACpC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IAYhC;;;;OAIG;IACG,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAQzF;;;OAGG;IACH,OAAO,CACL,EAAE,EAAE,MAAM,EACV,KAAK,CAAC,EAAE,YAAY,CAAC,SAAS,CAAC,EAC/B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,SAAS,CAAC;IAKrB;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;IAI3E;;;OAGG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;IAI3F;;;OAGG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;CAG7E"}
+{"version":3,"file":"BaseCrudApi.d.ts","sourceRoot":"","sources":["../../src/core/BaseCrudApi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAC1E,YAAY,EACV,WAAW,EACX,WAAW,EACX,SAAS,EACT,YAAY,EACZ,SAAS,EACT,UAAU,EACV,UAAU,EACV,SAAS,EACT,aAAa,EACb,aAAa,EACb,OAAO,GACR,MAAM,SAAS,CAAA;AAEhB,qBAAa,WAAW,CACtB,SAAS,EACT,OAAO,EACP,OAAO,GAAG,OAAO,EACjB,MAAM,SAAS,SAAS,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC,SAAS,CAAC,CAE1D,SAAQ,OACR,YAAW,OAAO,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC;IAEvD,SAAgB,QAAQ,EAAE,MAAM,CAAA;gBAEpB,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM;IAK/C,OAAO,CACL,KAAK,EAAE,MAAM,GAAG;QAAE,QAAQ,EAAE,KAAK,CAAA;KAAE,EACnC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,SAAS,EAAE,CAAC;IACvB,OAAO,CACL,KAAK,CAAC,EAAE,MAAM,GAAG;QAAE,QAAQ,CAAC,EAAE,IAAI,CAAA;KAAE,EACpC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CACL,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,SAAS,EAAE,CAAC;IAY9C;;;;OAIG;IACG,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IASzF;;;OAGG;IACH,OAAO,CACL,EAAE,EAAE,MAAM,EACV,KAAK,CAAC,EAAE,YAAY,CAAC,SAAS,CAAC,EAC/B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,SAAS,CAAC;IAIrB;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;IAI3E;;;OAGG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;IAI3F;;;OAGG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;CAG7E"}

package/dist/core/BaseCrudApi.mjs

@@ -1,21 +1,14 @@
-import qs from "qs";
+import { BaseApi } from "./BaseApi.mjs";
 
 //#region src/core/BaseCrudApi.ts
-var BaseCrudApi = class {
-	client;
+var BaseCrudApi = class extends BaseApi {
 	basePath;
 	constructor(client, basePath) {
-		this.client = client;
+		super(client);
 		this.basePath = basePath.replace(/\/$/, "");
-		this.getMany = this.getMany.bind(this);
-		this.getOne = this.getOne.bind(this);
-		this.getById = this.getById.bind(this);
-		this.create = this.create.bind(this);
-		this.updateById = this.updateById.bind(this);
-		this.deleteById = this.deleteById.bind(this);
 	}
 	getMany(query, headers) {
-		const queryString = query ? `?${qs.stringify(query)}` : "";
+		const queryString = this.toQueryString(query);
 		return this.client.get(`${this.basePath}${queryString}`, headers);
 	}
 	/**
@@ -28,15 +21,14 @@ var BaseCrudApi = class {
 			...query,
 			limit: 1,
 			paginate: false
-		}, headers))[0] ?? null;
+		}, headers))?.[0] ?? null;
 	}
 	/**
 	* Returns a single resource by ID.
 	* @permissions $resourceName.view
 	*/
 	getById(id, query, headers) {
-		const queryString = query ? `?${qs.stringify(query)}` : "";
-		return this.client.get(`${this.basePath}/${id}${queryString}`, headers);
+		return this.client.get(`${this.basePath}/${id}${this.toQueryString(query)}`, headers);
 	}
 	/**
 	* Creates a new resource.

package/dist/core/BaseCrudApi.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"BaseCrudApi.mjs","names":[],"sources":["../../src/core/BaseCrudApi.ts"],"sourcesContent":["import qs from 'qs'\nimport type { ApiClient } from './ApiClient'\nimport type { CrudApi, GetByIdQuery, ListQuery, Paginated } from './types'\nexport type {\n  WhereClause,\n  IncludeItem,\n  ListQuery,\n  GetByIdQuery,\n  Paginated,\n  HasGetMany,\n  HasGetById,\n  HasCreate,\n  HasUpdateById,\n  HasDeleteById,\n  CrudApi,\n} from './types'\n\nexport class BaseCrudApi<\n  TResponse,\n  TCreate,\n  TUpdate = TCreate,\n  TQuery extends ListQuery<TResponse> = ListQuery<TResponse>,\n> implements CrudApi<TResponse, TCreate, TUpdate, TQuery> {\n  public readonly client: ApiClient\n  public readonly basePath: string\n\n  constructor(client: ApiClient, basePath: string) {\n    this.client = client\n    this.basePath = basePath.replace(/\\/$/, '')\n    this.getMany = this.getMany.bind(this)\n    this.getOne = this.getOne.bind(this)\n    this.getById = this.getById.bind(this)\n    this.create = this.create.bind(this)\n    this.updateById = this.updateById.bind(this)\n    this.deleteById = this.deleteById.bind(this)\n  }\n\n  getMany(\n    query: TQuery & { paginate: false },\n    headers?: Record<string, string>,\n  ): Promise<TResponse[]>\n  getMany(\n    query?: TQuery & { paginate?: true },\n    headers?: Record<string, string>,\n  ): Promise<Paginated<TResponse>>\n  getMany(\n    query?: TQuery,\n    headers?: Record<string, string>,\n  ): Promise<Paginated<TResponse> | TResponse[]> {\n    const queryString = query ? `?${qs.stringify(query)}` : ''\n    return this.client.get<Paginated<TResponse> | TResponse[]>(\n      `${this.basePath}${queryString}`,\n      headers,\n    )\n  }\n\n  /**\n   * Returns the first resource matching the query, or `null` when none match.\n   * Convenience over `getMany` with `limit: 1`.\n   * @permissions $resourceName.view\n   */\n  async getOne(query?: TQuery, headers?: Record<string, string>): Promise<TResponse | null> {\n    const results = await this.getMany(\n      { ...query, limit: 1, paginate: false } as TQuery & { paginate: false },\n      headers,\n    )\n    return results[0] ?? null\n  }\n\n  /**\n   * Returns a single resource by ID.\n   * @permissions $resourceName.view\n   */\n  getById(\n    id: string,\n    query?: GetByIdQuery<TResponse>,\n    headers?: Record<string, string>,\n  ): Promise<TResponse> {\n    const queryString = query ? `?${qs.stringify(query)}` : ''\n    return this.client.get<TResponse>(`${this.basePath}/${id}${queryString}`, headers)\n  }\n\n  /**\n   * Creates a new resource.\n   * @permissions $resourceName.create\n   */\n  create(body: TCreate, headers?: Record<string, string>): Promise<TResponse> {\n    return this.client.post<TResponse, TCreate>(this.basePath, body, headers)\n  }\n\n  /**\n   * Updates an existing resource by ID.\n   * @permissions $resourceName.update\n   */\n  updateById(id: string, body: TUpdate, headers?: Record<string, string>): Promise<TResponse> {\n    return this.client.put<TResponse, TUpdate>(`${this.basePath}/${id}`, body, headers)\n  }\n\n  /**\n   * Deletes a resource by ID.\n   * @permissions $resourceName.delete\n   */\n  deleteById(id: string, headers?: Record<string, string>): Promise<TResponse> {\n    return this.client.delete<TResponse>(`${this.basePath}/${id}`, headers)\n  }\n}\n"],"mappings":";;;AAiBA,IAAa,cAAb,MAK0D;CACxD,AAAgB;CAChB,AAAgB;CAEhB,YAAY,QAAmB,UAAkB;AAC/C,OAAK,SAAS;AACd,OAAK,WAAW,SAAS,QAAQ,OAAO,GAAG;AAC3C,OAAK,UAAU,KAAK,QAAQ,KAAK,KAAK;AACtC,OAAK,SAAS,KAAK,OAAO,KAAK,KAAK;AACpC,OAAK,UAAU,KAAK,QAAQ,KAAK,KAAK;AACtC,OAAK,SAAS,KAAK,OAAO,KAAK,KAAK;AACpC,OAAK,aAAa,KAAK,WAAW,KAAK,KAAK;AAC5C,OAAK,aAAa,KAAK,WAAW,KAAK,KAAK;;CAW9C,QACE,OACA,SAC6C;EAC7C,MAAM,cAAc,QAAQ,IAAI,GAAG,UAAU,MAAM,KAAK;AACxD,SAAO,KAAK,OAAO,IACjB,GAAG,KAAK,WAAW,eACnB,QACD;;;;;;;CAQH,MAAM,OAAO,OAAgB,SAA6D;AAKxF,UAJgB,MAAM,KAAK,QACzB;GAAE,GAAG;GAAO,OAAO;GAAG,UAAU;GAAO,EACvC,QACD,EACc,MAAM;;;;;;CAOvB,QACE,IACA,OACA,SACoB;EACpB,MAAM,cAAc,QAAQ,IAAI,GAAG,UAAU,MAAM,KAAK;AACxD,SAAO,KAAK,OAAO,IAAe,GAAG,KAAK,SAAS,GAAG,KAAK,eAAe,QAAQ;;;;;;CAOpF,OAAO,MAAe,SAAsD;AAC1E,SAAO,KAAK,OAAO,KAAyB,KAAK,UAAU,MAAM,QAAQ;;;;;;CAO3E,WAAW,IAAY,MAAe,SAAsD;AAC1F,SAAO,KAAK,OAAO,IAAwB,GAAG,KAAK,SAAS,GAAG,MAAM,MAAM,QAAQ;;;;;;CAOrF,WAAW,IAAY,SAAsD;AAC3E,SAAO,KAAK,OAAO,OAAkB,GAAG,KAAK,SAAS,GAAG,MAAM,QAAQ"}
+{"version":3,"file":"BaseCrudApi.mjs","names":[],"sources":["../../src/core/BaseCrudApi.ts"],"sourcesContent":["import type { ApiClient } from './ApiClient'\nimport { BaseApi } from './BaseApi'\nimport type { CrudApi, GetByIdQuery, ListQuery, Paginated } from './types'\nexport type {\n  WhereClause,\n  IncludeItem,\n  ListQuery,\n  GetByIdQuery,\n  Paginated,\n  HasGetMany,\n  HasGetById,\n  HasCreate,\n  HasUpdateById,\n  HasDeleteById,\n  CrudApi,\n} from './types'\n\nexport class BaseCrudApi<\n  TResponse,\n  TCreate,\n  TUpdate = TCreate,\n  TQuery extends ListQuery<TResponse> = ListQuery<TResponse>,\n>\n  extends BaseApi\n  implements CrudApi<TResponse, TCreate, TUpdate, TQuery>\n{\n  public readonly basePath: string\n\n  constructor(client: ApiClient, basePath: string) {\n    super(client)\n    this.basePath = basePath.replace(/\\/$/, '')\n  }\n\n  getMany(\n    query: TQuery & { paginate: false },\n    headers?: Record<string, string>,\n  ): Promise<TResponse[]>\n  getMany(\n    query?: TQuery & { paginate?: true },\n    headers?: Record<string, string>,\n  ): Promise<Paginated<TResponse>>\n  getMany(\n    query?: TQuery,\n    headers?: Record<string, string>,\n  ): Promise<Paginated<TResponse> | TResponse[]>\n  getMany(\n    query?: TQuery,\n    headers?: Record<string, string>,\n  ): Promise<Paginated<TResponse> | TResponse[]> {\n    const queryString = this.toQueryString(query)\n    return this.client.get<Paginated<TResponse> | TResponse[]>(\n      `${this.basePath}${queryString}`,\n      headers,\n    )\n  }\n\n  /**\n   * Returns the first resource matching the query, or `null` when none match.\n   * Convenience over `getMany` with `limit: 1`.\n   * @permissions $resourceName.view\n   */\n  async getOne(query?: TQuery, headers?: Record<string, string>): Promise<TResponse | null> {\n    const results = await this.getMany(\n      { ...query, limit: 1, paginate: false } as TQuery & { paginate: false },\n      headers,\n    )\n    // An empty response body resolves to `undefined`.\n    return results?.[0] ?? null\n  }\n\n  /**\n   * Returns a single resource by ID.\n   * @permissions $resourceName.view\n   */\n  getById(\n    id: string,\n    query?: GetByIdQuery<TResponse>,\n    headers?: Record<string, string>,\n  ): Promise<TResponse> {\n    return this.client.get<TResponse>(`${this.basePath}/${id}${this.toQueryString(query)}`, headers)\n  }\n\n  /**\n   * Creates a new resource.\n   * @permissions $resourceName.create\n   */\n  create(body: TCreate, headers?: Record<string, string>): Promise<TResponse> {\n    return this.client.post<TResponse, TCreate>(this.basePath, body, headers)\n  }\n\n  /**\n   * Updates an existing resource by ID.\n   * @permissions $resourceName.update\n   */\n  updateById(id: string, body: TUpdate, headers?: Record<string, string>): Promise<TResponse> {\n    return this.client.put<TResponse, TUpdate>(`${this.basePath}/${id}`, body, headers)\n  }\n\n  /**\n   * Deletes a resource by ID.\n   * @permissions $resourceName.delete\n   */\n  deleteById(id: string, headers?: Record<string, string>): Promise<TResponse> {\n    return this.client.delete<TResponse>(`${this.basePath}/${id}`, headers)\n  }\n}\n"],"mappings":";;;AAiBA,IAAa,cAAb,cAMU,QAEV;CACE,AAAgB;CAEhB,YAAY,QAAmB,UAAkB;AAC/C,QAAM,OAAO;AACb,OAAK,WAAW,SAAS,QAAQ,OAAO,GAAG;;CAe7C,QACE,OACA,SAC6C;EAC7C,MAAM,cAAc,KAAK,cAAc,MAAM;AAC7C,SAAO,KAAK,OAAO,IACjB,GAAG,KAAK,WAAW,eACnB,QACD;;;;;;;CAQH,MAAM,OAAO,OAAgB,SAA6D;AAMxF,UALgB,MAAM,KAAK,QACzB;GAAE,GAAG;GAAO,OAAO;GAAG,UAAU;GAAO,EACvC,QACD,IAEgB,MAAM;;;;;;CAOzB,QACE,IACA,OACA,SACoB;AACpB,SAAO,KAAK,OAAO,IAAe,GAAG,KAAK,SAAS,GAAG,KAAK,KAAK,cAAc,MAAM,IAAI,QAAQ;;;;;;CAOlG,OAAO,MAAe,SAAsD;AAC1E,SAAO,KAAK,OAAO,KAAyB,KAAK,UAAU,MAAM,QAAQ;;;;;;CAO3E,WAAW,IAAY,MAAe,SAAsD;AAC1F,SAAO,KAAK,OAAO,IAAwB,GAAG,KAAK,SAAS,GAAG,MAAM,MAAM,QAAQ;;;;;;CAOrF,WAAW,IAAY,SAAsD;AAC3E,SAAO,KAAK,OAAO,OAAkB,GAAG,KAAK,SAAS,GAAG,MAAM,QAAQ"}

package/dist/core/bindMethods.cjs

@@ -0,0 +1,24 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+//#region src/core/bindMethods.ts
+/**
+* Binds every method of `instance`'s class chain (up to `Object.prototype`) to `instance`, as own
+* properties, so methods keep working when destructured (`const { getMany } = api`). The most
+* derived implementation wins; getters, setters and `constructor` are skipped.
+*/
+function bindMethods(instance) {
+	const target = instance;
+	const bound = /* @__PURE__ */ new Set();
+	for (let prototype = Object.getPrototypeOf(instance); prototype && prototype !== Object.prototype; prototype = Object.getPrototypeOf(prototype)) for (const key of Reflect.ownKeys(prototype)) {
+		if (key === "constructor" || bound.has(key)) continue;
+		const { value } = Object.getOwnPropertyDescriptor(prototype, key);
+		if (typeof value === "function") {
+			target[key] = value.bind(instance);
+			bound.add(key);
+		}
+	}
+}
+
+//#endregion
+exports.bindMethods = bindMethods;
+//# sourceMappingURL=bindMethods.cjs.map

package/dist/core/bindMethods.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bindMethods.cjs","names":[],"sources":["../../src/core/bindMethods.ts"],"sourcesContent":["/**\n * Binds every method of `instance`'s class chain (up to `Object.prototype`) to `instance`, as own\n * properties, so methods keep working when destructured (`const { getMany } = api`). The most\n * derived implementation wins; getters, setters and `constructor` are skipped.\n */\nexport function bindMethods(instance: object): void {\n  const target = instance as Record<PropertyKey, unknown>\n  const bound = new Set<PropertyKey>()\n\n  for (\n    let prototype: object | null = Object.getPrototypeOf(instance);\n    prototype && prototype !== Object.prototype;\n    prototype = Object.getPrototypeOf(prototype)\n  ) {\n    for (const key of Reflect.ownKeys(prototype)) {\n      if (key === 'constructor' || bound.has(key)) {\n        continue\n      }\n      const { value } = Object.getOwnPropertyDescriptor(prototype, key) as PropertyDescriptor\n      if (typeof value === 'function') {\n        target[key] = value.bind(instance)\n        bound.add(key)\n      }\n    }\n  }\n}\n"],"mappings":";;;;;;;;AAKA,SAAgB,YAAY,UAAwB;CAClD,MAAM,SAAS;CACf,MAAM,wBAAQ,IAAI,KAAkB;AAEpC,MACE,IAAI,YAA2B,OAAO,eAAe,SAAS,EAC9D,aAAa,cAAc,OAAO,WAClC,YAAY,OAAO,eAAe,UAAU,CAE5C,MAAK,MAAM,OAAO,QAAQ,QAAQ,UAAU,EAAE;AAC5C,MAAI,QAAQ,iBAAiB,MAAM,IAAI,IAAI,CACzC;EAEF,MAAM,EAAE,UAAU,OAAO,yBAAyB,WAAW,IAAI;AACjE,MAAI,OAAO,UAAU,YAAY;AAC/B,UAAO,OAAO,MAAM,KAAK,SAAS;AAClC,SAAM,IAAI,IAAI"}

package/dist/core/bindMethods.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Binds every method of `instance`'s class chain (up to `Object.prototype`) to `instance`, as own
+ * properties, so methods keep working when destructured (`const { getMany } = api`). The most
+ * derived implementation wins; getters, setters and `constructor` are skipped.
+ */
+export declare function bindMethods(instance: object): void;
+//# sourceMappingURL=bindMethods.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bindMethods.d.ts","sourceRoot":"","sources":["../../src/core/bindMethods.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAoBlD"}

package/dist/core/bindMethods.mjs

@@ -0,0 +1,22 @@
+//#region src/core/bindMethods.ts
+/**
+* Binds every method of `instance`'s class chain (up to `Object.prototype`) to `instance`, as own
+* properties, so methods keep working when destructured (`const { getMany } = api`). The most
+* derived implementation wins; getters, setters and `constructor` are skipped.
+*/
+function bindMethods(instance) {
+	const target = instance;
+	const bound = /* @__PURE__ */ new Set();
+	for (let prototype = Object.getPrototypeOf(instance); prototype && prototype !== Object.prototype; prototype = Object.getPrototypeOf(prototype)) for (const key of Reflect.ownKeys(prototype)) {
+		if (key === "constructor" || bound.has(key)) continue;
+		const { value } = Object.getOwnPropertyDescriptor(prototype, key);
+		if (typeof value === "function") {
+			target[key] = value.bind(instance);
+			bound.add(key);
+		}
+	}
+}
+
+//#endregion
+export { bindMethods };
+//# sourceMappingURL=bindMethods.mjs.map

package/dist/core/bindMethods.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bindMethods.mjs","names":[],"sources":["../../src/core/bindMethods.ts"],"sourcesContent":["/**\n * Binds every method of `instance`'s class chain (up to `Object.prototype`) to `instance`, as own\n * properties, so methods keep working when destructured (`const { getMany } = api`). The most\n * derived implementation wins; getters, setters and `constructor` are skipped.\n */\nexport function bindMethods(instance: object): void {\n  const target = instance as Record<PropertyKey, unknown>\n  const bound = new Set<PropertyKey>()\n\n  for (\n    let prototype: object | null = Object.getPrototypeOf(instance);\n    prototype && prototype !== Object.prototype;\n    prototype = Object.getPrototypeOf(prototype)\n  ) {\n    for (const key of Reflect.ownKeys(prototype)) {\n      if (key === 'constructor' || bound.has(key)) {\n        continue\n      }\n      const { value } = Object.getOwnPropertyDescriptor(prototype, key) as PropertyDescriptor\n      if (typeof value === 'function') {\n        target[key] = value.bind(instance)\n        bound.add(key)\n      }\n    }\n  }\n}\n"],"mappings":";;;;;;AAKA,SAAgB,YAAY,UAAwB;CAClD,MAAM,SAAS;CACf,MAAM,wBAAQ,IAAI,KAAkB;AAEpC,MACE,IAAI,YAA2B,OAAO,eAAe,SAAS,EAC9D,aAAa,cAAc,OAAO,WAClC,YAAY,OAAO,eAAe,UAAU,CAE5C,MAAK,MAAM,OAAO,QAAQ,QAAQ,UAAU,EAAE;AAC5C,MAAI,QAAQ,iBAAiB,MAAM,IAAI,IAAI,CACzC;EAEF,MAAM,EAAE,UAAU,OAAO,yBAAyB,WAAW,IAAI;AACjE,MAAI,OAAO,UAAU,YAAY;AAC/B,UAAO,OAAO,MAAM,KAAK,SAAS;AAClC,SAAM,IAAI,IAAI"}