@carlonicora/nextjs-jsonapi 1.118.0 → 1.119.0

package/src/unified/JsonApiRequest.ts

@@ -167,9 +167,17 @@ function runBootstrapper(): void {
   }
 }
 
-function buildUrl(endpoint: string): string {
-  const apiUrl = getApiUrl();
-  return endpoint.startsWith("http") ? endpoint : `${apiUrl}${endpoint}`;
+/**
+ * Resolve the final request URL for an endpoint.
+ *
+ * - `endpoint` starting with "http" is always passed through unchanged (existing behaviour).
+ * - Otherwise, an explicit `baseUrl` (per-call override) takes precedence over the global
+ *   `getApiUrl()` resolution. Omitting `baseUrl` preserves today's behaviour exactly.
+ */
+export function buildUrl(endpoint: string, baseUrl?: string): string {
+  if (endpoint.startsWith("http")) return endpoint;
+  const apiUrl = baseUrl ?? getApiUrl();
+  return `${apiUrl}${endpoint}`;
 }
 
 export async function JsonApiGet(params: {
@@ -177,13 +185,14 @@ export async function JsonApiGet(params: {
   endpoint: string;
   companyId?: string;
   language: string;
+  baseUrl?: string;
 }): Promise<ApiResponseInterface> {
   runBootstrapper();
   const token = await getToken();
 
   const apiResponse = await makeRequest({
     method: "GET",
-    url: buildUrl(params.endpoint),
+    url: buildUrl(params.endpoint, params.baseUrl),
     token,
     cache: params.classKey.cache,
     companyId: params.companyId,
@@ -202,6 +211,7 @@ export async function JsonApiGet(params: {
         endpoint,
         companyId: params.companyId,
         language: params.language,
+        baseUrl: params.baseUrl,
       }),
   });
 }
@@ -216,6 +226,7 @@ export async function JsonApiPost(params: {
   language: string;
   responseType?: ApiRequestDataTypeInterface;
   token?: string;
+  baseUrl?: string;
 }): Promise<ApiResponseInterface> {
   runBootstrapper();
   const token = params.token ?? (await getToken());
@@ -229,7 +240,7 @@ export async function JsonApiPost(params: {
 
   const apiResponse = await makeRequest({
     method: "POST",
-    url: buildUrl(params.endpoint),
+    url: buildUrl(params.endpoint, params.baseUrl),
     token,
     body,
     files: params.files,
@@ -254,6 +265,7 @@ export async function JsonApiPut(params: {
   files?: { [key: string]: File | Blob } | File | Blob;
   language: string;
   responseType?: ApiRequestDataTypeInterface;
+  baseUrl?: string;
 }): Promise<ApiResponseInterface> {
   runBootstrapper();
   const token = await getToken();
@@ -267,7 +279,7 @@ export async function JsonApiPut(params: {
 
   const apiResponse = await makeRequest({
     method: "PUT",
-    url: buildUrl(params.endpoint),
+    url: buildUrl(params.endpoint, params.baseUrl),
     token,
     body,
     files: params.files,
@@ -293,6 +305,7 @@ export async function JsonApiPatch(params: {
   overridesJsonApiCreation?: boolean;
   responseType?: ApiRequestDataTypeInterface;
   language: string;
+  baseUrl?: string;
 }): Promise<ApiResponseInterface> {
   runBootstrapper();
   const token = await getToken();
@@ -306,7 +319,7 @@ export async function JsonApiPatch(params: {
 
   const apiResponse = await makeRequest({
     method: "PATCH",
-    url: buildUrl(params.endpoint),
+    url: buildUrl(params.endpoint, params.baseUrl),
     token,
     body,
     files: params.files,
@@ -329,13 +342,14 @@ export async function JsonApiDelete(params: {
   companyId?: string;
   language: string;
   responseType?: ApiRequestDataTypeInterface;
+  baseUrl?: string;
 }): Promise<ApiResponseInterface> {
   runBootstrapper();
   const token = await getToken();
 
   const apiResponse = await makeRequest({
     method: "DELETE",
-    url: buildUrl(params.endpoint),
+    url: buildUrl(params.endpoint, params.baseUrl),
     token,
     companyId: params.companyId,
     language: params.language,

package/src/unified/__tests__/JsonApiRequest.test.ts

@@ -0,0 +1,29 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { buildUrl } from "../JsonApiRequest";
+
+describe("buildUrl", () => {
+  afterEach(() => {
+    vi.unstubAllEnvs();
+  });
+
+  it("uses NEXT_PUBLIC_API_URL when baseUrl is omitted", () => {
+    vi.stubEnv("NEXT_PUBLIC_API_URL", "https://api.example.com");
+
+    expect(buildUrl("/sncass/sync")).toBe("https://api.example.com/sncass/sync");
+  });
+
+  it("uses the per-call baseUrl override when provided", () => {
+    vi.stubEnv("NEXT_PUBLIC_API_URL", "https://api.example.com");
+
+    expect(buildUrl("/sncass/sync", "https://corpus.example.com")).toBe("https://corpus.example.com/sncass/sync");
+  });
+
+  it("passes through an http-prefixed endpoint regardless of baseUrl", () => {
+    vi.stubEnv("NEXT_PUBLIC_API_URL", "https://api.example.com");
+
+    expect(buildUrl("https://elsewhere.example.com/sncass/sync", "https://corpus.example.com")).toBe(
+      "https://elsewhere.example.com/sncass/sync",
+    );
+    expect(buildUrl("https://elsewhere.example.com/sncass/sync")).toBe("https://elsewhere.example.com/sncass/sync");
+  });
+});

package/dist/JsonApiRequest-OSGJ63XR.js

@@ -1,24 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
-
-
-
-
-
-
-
-
-
-var _chunkJ5LROFGLjs = require('./chunk-J5LROFGL.js');
-require('./chunk-7QVYU63E.js');
-
-
-
-
-
-
-
-
-
-
-exports.JsonApiDelete = _chunkJ5LROFGLjs.JsonApiDelete; exports.JsonApiGet = _chunkJ5LROFGLjs.JsonApiGet; exports.JsonApiPatch = _chunkJ5LROFGLjs.JsonApiPatch; exports.JsonApiPost = _chunkJ5LROFGLjs.JsonApiPost; exports.JsonApiPut = _chunkJ5LROFGLjs.JsonApiPut; exports.configureJsonApi = _chunkJ5LROFGLjs.configureJsonApi; exports.getApiUrl = _chunkJ5LROFGLjs.getApiUrl; exports.getAppUrl = _chunkJ5LROFGLjs.getAppUrl; exports.getTrackablePages = _chunkJ5LROFGLjs.getTrackablePages;
-//# sourceMappingURL=JsonApiRequest-OSGJ63XR.js.map

package/dist/JsonApiRequest-OSGJ63XR.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["/home/runner/work/nextjs-jsonapi/nextjs-jsonapi/dist/JsonApiRequest-OSGJ63XR.js"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,sDAA4B;AAC5B,+BAA4B;AAC5B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,meAAC","file":"/home/runner/work/nextjs-jsonapi/nextjs-jsonapi/dist/JsonApiRequest-OSGJ63XR.js"}

package/dist/chunk-J5LROFGL.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["/home/runner/work/nextjs-jsonapi/nextjs-jsonapi/dist/chunk-J5LROFGL.js","../src/core/registry/DataClassRegistry.ts","../src/core/factories/JsonApiDataFactory.ts","../src/core/registry/bootstrapStore.ts","../src/core/utils/translateResponse.ts","../src/unified/JsonApiRequest.ts"],"names":[],"mappings":"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","file":"/home/runner/work/nextjs-jsonapi/nextjs-jsonapi/dist/chunk-J5LROFGL.js","sourcesContent":[null,"import { ApiDataInterface } from \"../interfaces/ApiDataInterface\";\nimport { ApiRequestDataTypeInterface } from \"../interfaces/ApiRequestDataTypeInterface\";\n\nexport class DataClassRegistry {\n  // Use Map with string key (module.name) for reliable lookup\n  // String keys are stable across HMR and module re-evaluations\n  // Note: WeakMap with object identity was tried but fails during Next.js navigation\n  // because module re-evaluation creates new object instances with different identity\n  private static _map = new Map<string, { new (): ApiDataInterface }>();\n\n  public static registerObjectClass(\n    key: ApiRequestDataTypeInterface,\n    classConstructor: { new (): ApiDataInterface },\n  ): void {\n    const classKey = key.name;\n    if (!this._map.has(classKey)) {\n      this._map.set(classKey, classConstructor);\n    }\n  }\n\n  public static get(classKey: ApiRequestDataTypeInterface): {\n    new (): ApiDataInterface;\n  } {\n    const response = this._map.get(classKey.name);\n    if (!response) {\n      throw new Error(\n        `Class not registered for key: ${typeof classKey === \"string\" ? classKey : classKey.name}. Ensure bootstrap() was called.`,\n      );\n    }\n\n    return response;\n  }\n\n  /**\n   * Get class constructor by JSON:API type name.\n   * Used for polymorphic rehydration where the type is determined at runtime.\n   */\n  public static getByJsonApiType(typeName: string): { new (): ApiDataInterface } | undefined {\n    return this._map.get(typeName);\n  }\n\n  /**\n   * Bootstrap the registry with all modules.\n   * This is a convenience method for apps to register all their modules at once.\n   *\n   * @param modules - An object with module definitions (like the app's Modules class)\n   */\n  public static bootstrap(modules: Record<string, ApiRequestDataTypeInterface>): void {\n    Object.values(modules).forEach((module) => {\n      if (module && module.model) {\n        this.registerObjectClass(module, module.model);\n      }\n    });\n  }\n\n  /**\n   * Clear all registered classes. Useful for testing.\n   */\n  public static clear(): void {\n    this._map.clear();\n  }\n}\n\n// Export alias for backward compatibility\nexport { DataClassRegistry as DataClass };\n","import { ApiDataInterface } from \"../interfaces/ApiDataInterface\";\nimport { ApiRequestDataTypeInterface } from \"../interfaces/ApiRequestDataTypeInterface\";\nimport { DataClassRegistry } from \"../registry/DataClassRegistry\";\n\nexport class JsonApiDataFactory {\n  public static create(classKey: ApiRequestDataTypeInterface, data: any): any {\n    const factoryClass = DataClassRegistry.get(classKey);\n\n    const instance = new factoryClass() as ApiDataInterface;\n    const result = instance.createJsonApi(data);\n    return result;\n  }\n}\n","/**\n * Centralized bootstrap store accessible from ModuleRegistry.\n * This file has NO external dependencies to avoid circular imports.\n *\n * The bootstrap store allows ModuleRegistry to call the app's bootstrapper\n * when modules are accessed before bootstrap() was called, providing\n * self-healing behavior for module evaluation order issues.\n *\n * IMPORTANT: We use globalThis to persist state across HMR/Turbopack\n * module re-evaluations in development mode. Without this, the bootstrapper\n * reference would be lost when modules are hot-reloaded, causing\n * \"Module not registered\" errors during navigation.\n */\n\ntype BootstrapperFn = () => void;\n\n// Symbol key to avoid conflicts with other globals\nconst BOOTSTRAP_KEY = Symbol.for(\"nextjs-jsonapi:bootstrapper\");\nconst BOOTSTRAP_ATTEMPTED_KEY = Symbol.for(\"nextjs-jsonapi:bootstrapAttempted\");\n\n// Use globalThis to persist across HMR reloads\nconst globalStore = globalThis as unknown as {\n  [BOOTSTRAP_KEY]?: BootstrapperFn | null;\n  [BOOTSTRAP_ATTEMPTED_KEY]?: boolean;\n};\n\n// Initialize from global if not set\nif (globalStore[BOOTSTRAP_KEY] === undefined) {\n  globalStore[BOOTSTRAP_KEY] = null;\n}\nif (globalStore[BOOTSTRAP_ATTEMPTED_KEY] === undefined) {\n  globalStore[BOOTSTRAP_ATTEMPTED_KEY] = false;\n}\n\n// Getters/setters that use the global store\nfunction getBootstrapperInternal(): BootstrapperFn | null {\n  return globalStore[BOOTSTRAP_KEY] ?? null;\n}\n\nfunction setBootstrapperInternal(fn: BootstrapperFn | null): void {\n  globalStore[BOOTSTRAP_KEY] = fn;\n}\n\nfunction getBootstrapAttempted(): boolean {\n  return globalStore[BOOTSTRAP_ATTEMPTED_KEY] ?? false;\n}\n\nfunction setBootstrapAttempted(value: boolean): void {\n  globalStore[BOOTSTRAP_ATTEMPTED_KEY] = value;\n}\n\n/**\n * Register the bootstrapper function.\n * Called by configureJsonApi() from client/config, client/JsonApiClient, or unified/JsonApiRequest.\n */\nexport function setBootstrapper(fn: BootstrapperFn): void {\n  setBootstrapperInternal(fn);\n}\n\n/**\n * Get the registered bootstrapper function.\n * Returns null if no bootstrapper has been registered.\n */\nexport function getBootstrapper(): BootstrapperFn | null {\n  return getBootstrapperInternal();\n}\n\n/**\n * Attempt to run the bootstrapper if one is registered.\n * Returns true if bootstrapper was executed, false if not available.\n * Safe to call multiple times - bootstrapper is expected to be idempotent.\n */\nexport function tryBootstrap(): boolean {\n  const bootstrapper = getBootstrapperInternal();\n  const attempted = getBootstrapAttempted();\n\n  if (attempted && !bootstrapper) {\n    // Already tried and no bootstrapper available\n    return false;\n  }\n  setBootstrapAttempted(true);\n\n  if (bootstrapper) {\n    bootstrapper();\n    return true;\n  }\n  return false;\n}\n\n/**\n * Check if a bootstrapper has been registered.\n */\nexport function hasBootstrapper(): boolean {\n  return getBootstrapperInternal() !== null;\n}\n\n/**\n * Reset the bootstrap store. Useful for testing.\n */\nexport function resetBootstrapStore(): void {\n  setBootstrapperInternal(null);\n  setBootstrapAttempted(false);\n}\n","import { ApiData } from \"../interfaces/ApiData\";\nimport { ApiDataInterface } from \"../interfaces/ApiDataInterface\";\nimport { ApiRequestDataTypeInterface } from \"../interfaces/ApiRequestDataTypeInterface\";\nimport { ApiResponseInterface } from \"../interfaces/ApiResponseInterface\";\nimport { DataClassRegistry } from \"../registry/DataClassRegistry\";\n\n/**\n * Translates raw JSON:API data into typed objects.\n * Does not require API response metadata.\n */\nexport function translateData<T extends ApiDataInterface>(params: {\n  classKey: ApiRequestDataTypeInterface;\n  data: any;\n}): T | T[] {\n  const factoryClass = DataClassRegistry.get(params.classKey);\n\n  if (!factoryClass) {\n    throw new Error(\n      `Class not registered for key: ${typeof params.classKey === \"string\" ? params.classKey : params.classKey.name}`,\n    );\n  }\n\n  const included: any = params.data.included ?? [];\n\n  if (Array.isArray(params.data.data)) {\n    const responseData: T[] = [];\n\n    for (const data of params.data.data) {\n      const object = new factoryClass();\n      object.rehydrate({ jsonApi: data, included: included, allData: params.data.data });\n      responseData.push(object as T);\n    }\n\n    return responseData as T[];\n  } else {\n    const responseData = new factoryClass();\n    responseData.rehydrate({\n      jsonApi: params.data.data,\n      included: included,\n    });\n\n    return responseData as T;\n  }\n}\n\n/**\n * Translates a full API response into a typed ApiResponseInterface.\n * Includes pagination support.\n */\nexport async function translateResponse<T extends ApiDataInterface>(params: {\n  classKey: ApiRequestDataTypeInterface;\n  apiResponse: ApiData;\n  companyId?: string;\n  language: string;\n  paginationHandler?: (endpoint: string) => Promise<ApiResponseInterface>;\n}): Promise<ApiResponseInterface> {\n  const response: ApiResponseInterface = {\n    ok: true,\n    response: 0,\n    data: [],\n    error: \"\",\n  };\n\n  const factoryClass = DataClassRegistry.get(params.classKey);\n\n  if (!factoryClass) {\n    throw new Error(\n      `Class not registered for key: ${typeof params.classKey === \"string\" ? params.classKey : params.classKey.name}`,\n    );\n  }\n\n  response.ok = params.apiResponse.ok;\n  response.response = params.apiResponse.status;\n\n  if (!params.apiResponse.ok) {\n    response.error = params.apiResponse?.data?.message ?? params.apiResponse.statusText;\n    return response;\n  }\n\n  if (params.apiResponse.status === 204) return response;\n\n  response.raw = params.apiResponse.data;\n\n  // Extract meta from JSON:API response\n  if (params.apiResponse.data?.meta) {\n    response.meta = params.apiResponse.data.meta;\n  }\n\n  try {\n    // Check if response is JSON:API formatted (has a 'data' property)\n    // If not, return the raw response data directly (e.g., { url: \"...\" } or { clientSecret: \"...\" })\n    if (\n      params.apiResponse.data &&\n      typeof params.apiResponse.data === \"object\" &&\n      !Array.isArray(params.apiResponse.data) &&\n      params.apiResponse.data.data === undefined\n    ) {\n      response.data = params.apiResponse.data;\n      return response;\n    }\n\n    const included: any = params.apiResponse.data.included ?? [];\n\n    if (params.apiResponse.data.links) {\n      response.self = params.apiResponse.data.links.self;\n\n      if (params.apiResponse.data.links.next && params.paginationHandler) {\n        response.next = params.apiResponse.data.links.next;\n        response.nextPage = async () => params.paginationHandler!(params.apiResponse.data.links.next);\n      }\n\n      if (params.apiResponse.data.links.prev && params.paginationHandler) {\n        response.prev = params.apiResponse.data.links.prev;\n        response.prevPage = async () => params.paginationHandler!(params.apiResponse.data.links.prev);\n      }\n    }\n\n    if (Array.isArray(params.apiResponse.data.data)) {\n      const responseData: T[] = [];\n\n      for (const data of params.apiResponse.data.data) {\n        const object = new factoryClass();\n        object.rehydrate({ jsonApi: data, included: included, allData: params.apiResponse.data.data });\n        responseData.push(object as T);\n      }\n\n      response.data = responseData;\n    } else {\n      const responseData = new factoryClass();\n      responseData.rehydrate({\n        jsonApi: params.apiResponse.data.data,\n        included: included,\n      });\n\n      response.data = responseData;\n    }\n  } catch (e) {\n    console.error(e);\n  }\n\n  return response;\n}\n","import { JsonApiDataFactory } from \"../core/factories/JsonApiDataFactory\";\nimport { ApiData } from \"../core/interfaces/ApiData\";\nimport { ApiRequestDataTypeInterface } from \"../core/interfaces/ApiRequestDataTypeInterface\";\nimport { ApiResponseInterface } from \"../core/interfaces/ApiResponseInterface\";\nimport { setBootstrapper } from \"../core/registry/bootstrapStore\";\nimport { translateResponse } from \"../core/utils/translateResponse\";\nimport { ModuleWithPermissions } from \"../permissions/types\";\n\n// Type definitions for dynamically imported functions (avoiding typeof import to prevent bundling)\ntype DirectFetchFn = (params: {\n  method: string;\n  url: string;\n  token?: string;\n  body?: any;\n  files?: { [key: string]: File | Blob } | File | Blob;\n  companyId?: string;\n  language: string;\n  additionalHeaders?: Record<string, string>;\n}) => Promise<ApiData>;\n\ntype ServerRequestFn = (params: {\n  method: string;\n  url: string;\n  token?: string;\n  cache?: string;\n  body?: any;\n  files?: { [key: string]: File | Blob } | File | Blob;\n  companyId?: string;\n  language: string;\n  additionalHeaders?: Record<string, string>;\n}) => Promise<ApiData>;\n\ntype GetTokenFn = () => Promise<string | undefined>;\n\n// These will be dynamically imported based on environment\nlet _directFetch: DirectFetchFn;\nlet _serverRequest: ServerRequestFn;\nlet _getClientToken: GetTokenFn;\nlet _getServerToken: GetTokenFn;\n\n// Config storage for non-React contexts\nlet _staticConfig: {\n  apiUrl: string;\n  appUrl?: string;\n  trackablePages?: ModuleWithPermissions[];\n  bootstrapper?: () => void;\n  additionalHeaders?: Record<string, string>;\n} | null = null;\n\n/**\n * Configure the JSON:API client for non-React contexts (e.g., server components).\n * For React contexts, use JsonApiProvider instead.\n */\nexport function configureJsonApi(config: {\n  apiUrl: string;\n  appUrl?: string;\n  trackablePages?: ModuleWithPermissions[];\n  bootstrapper?: () => void;\n  additionalHeaders?: Record<string, string>;\n}): void {\n  _staticConfig = config;\n  // Register and call bootstrapper to register all modules\n  if (config.bootstrapper) {\n    setBootstrapper(config.bootstrapper);\n    config.bootstrapper();\n  }\n}\n\nasync function getToken(): Promise<string | undefined> {\n  if (typeof window === \"undefined\") {\n    // Server-side\n    if (!_getServerToken) {\n      const serverModule = await import(\"../server/token\");\n      _getServerToken = serverModule.getServerToken;\n    }\n    return _getServerToken();\n  } else {\n    // Client-side\n    if (!_getClientToken) {\n      const clientModule = await import(\"../client/token\");\n      _getClientToken = clientModule.getClientToken;\n    }\n    return _getClientToken();\n  }\n}\n\nasync function makeRequest(params: {\n  method: string;\n  url: string;\n  token?: string;\n  cache?: string;\n  body?: any;\n  files?: { [key: string]: File | Blob } | File | Blob;\n  companyId?: string;\n  language: string;\n  additionalHeaders?: Record<string, string>;\n}): Promise<ApiData> {\n  if (typeof window !== \"undefined\") {\n    // Client-side: use direct fetch\n    if (!_directFetch) {\n      const clientModule = await import(\"../client/request\");\n      _directFetch = clientModule.directFetch;\n    }\n    return _directFetch({\n      method: params.method,\n      url: params.url,\n      token: params.token,\n      body: params.body,\n      files: params.files,\n      companyId: params.companyId,\n      language: params.language,\n      additionalHeaders: params.additionalHeaders,\n    });\n  } else {\n    // Server-side: use server request with caching\n    if (!_serverRequest) {\n      const serverModule = await import(\"../server/request\");\n      _serverRequest = serverModule.serverRequest;\n    }\n    return _serverRequest({\n      method: params.method,\n      url: params.url,\n      token: params.token,\n      cache: params.cache,\n      body: params.body,\n      files: params.files,\n      companyId: params.companyId,\n      language: params.language,\n      additionalHeaders: params.additionalHeaders,\n    });\n  }\n}\n\nexport function getApiUrl(): string {\n  if (_staticConfig?.apiUrl) {\n    return _staticConfig.apiUrl;\n  }\n  // Fallback to environment variable\n  const envUrl = process.env.NEXT_PUBLIC_API_URL;\n  if (!envUrl) {\n    throw new Error(\"API URL not configured. Use configureJsonApi() or set NEXT_PUBLIC_API_URL environment variable.\");\n  }\n  return envUrl;\n}\n\nexport function getAppUrl(): string {\n  if (_staticConfig?.appUrl) {\n    return _staticConfig.appUrl;\n  }\n  // Fallback to environment variable\n  const envUrl = process.env.NEXT_PUBLIC_ADDRESS;\n  if (!envUrl) {\n    throw new Error(\n      \"App URL not configured. Use configureJsonApi({ appUrl }) or set NEXT_PUBLIC_ADDRESS environment variable.\",\n    );\n  }\n  return envUrl.trim().replace(/\\/+$/, \"\");\n}\n\nexport function getTrackablePages(): ModuleWithPermissions[] {\n  return _staticConfig?.trackablePages ?? [];\n}\n\nfunction runBootstrapper(): void {\n  if (_staticConfig?.bootstrapper) {\n    _staticConfig.bootstrapper();\n  }\n}\n\nfunction buildUrl(endpoint: string): string {\n  const apiUrl = getApiUrl();\n  return endpoint.startsWith(\"http\") ? endpoint : `${apiUrl}${endpoint}`;\n}\n\nexport async function JsonApiGet(params: {\n  classKey: ApiRequestDataTypeInterface;\n  endpoint: string;\n  companyId?: string;\n  language: string;\n}): Promise<ApiResponseInterface> {\n  runBootstrapper();\n  const token = await getToken();\n\n  const apiResponse = await makeRequest({\n    method: \"GET\",\n    url: buildUrl(params.endpoint),\n    token,\n    cache: params.classKey.cache,\n    companyId: params.companyId,\n    language: params.language,\n    additionalHeaders: _staticConfig?.additionalHeaders,\n  });\n\n  return translateResponse({\n    classKey: params.classKey,\n    apiResponse,\n    companyId: params.companyId,\n    language: params.language,\n    paginationHandler: async (endpoint: string) =>\n      JsonApiGet({\n        classKey: params.classKey,\n        endpoint,\n        companyId: params.companyId,\n        language: params.language,\n      }),\n  });\n}\n\nexport async function JsonApiPost(params: {\n  classKey: ApiRequestDataTypeInterface;\n  endpoint: string;\n  companyId?: string;\n  body?: any;\n  overridesJsonApiCreation?: boolean;\n  files?: { [key: string]: File | Blob } | File | Blob;\n  language: string;\n  responseType?: ApiRequestDataTypeInterface;\n  token?: string;\n}): Promise<ApiResponseInterface> {\n  runBootstrapper();\n  const token = params.token ?? (await getToken());\n\n  let body = params.body;\n  if (!body) {\n    body = {};\n  } else if (params.overridesJsonApiCreation !== true) {\n    body = JsonApiDataFactory.create(params.classKey, body);\n  }\n\n  const apiResponse = await makeRequest({\n    method: \"POST\",\n    url: buildUrl(params.endpoint),\n    token,\n    body,\n    files: params.files,\n    companyId: params.companyId,\n    language: params.language,\n    additionalHeaders: _staticConfig?.additionalHeaders,\n  });\n\n  return translateResponse({\n    classKey: params.responseType ?? params.classKey,\n    apiResponse,\n    companyId: params.companyId,\n    language: params.language,\n  });\n}\n\nexport async function JsonApiPut(params: {\n  classKey: ApiRequestDataTypeInterface;\n  endpoint: string;\n  companyId?: string;\n  body?: any;\n  files?: { [key: string]: File | Blob } | File | Blob;\n  language: string;\n  responseType?: ApiRequestDataTypeInterface;\n}): Promise<ApiResponseInterface> {\n  runBootstrapper();\n  const token = await getToken();\n\n  let body = params.body;\n  if (!body) {\n    body = {};\n  } else {\n    body = JsonApiDataFactory.create(params.classKey, body);\n  }\n\n  const apiResponse = await makeRequest({\n    method: \"PUT\",\n    url: buildUrl(params.endpoint),\n    token,\n    body,\n    files: params.files,\n    companyId: params.companyId,\n    language: params.language,\n    additionalHeaders: _staticConfig?.additionalHeaders,\n  });\n\n  return translateResponse({\n    classKey: params.responseType ?? params.classKey,\n    apiResponse,\n    companyId: params.companyId,\n    language: params.language,\n  });\n}\n\nexport async function JsonApiPatch(params: {\n  classKey: ApiRequestDataTypeInterface;\n  endpoint: string;\n  companyId?: string;\n  body?: any;\n  files?: { [key: string]: File | Blob } | File | Blob;\n  overridesJsonApiCreation?: boolean;\n  responseType?: ApiRequestDataTypeInterface;\n  language: string;\n}): Promise<ApiResponseInterface> {\n  runBootstrapper();\n  const token = await getToken();\n\n  let body = params.body;\n  if (!body) {\n    body = {};\n  } else if (params.overridesJsonApiCreation !== true) {\n    body = JsonApiDataFactory.create(params.classKey, body);\n  }\n\n  const apiResponse = await makeRequest({\n    method: \"PATCH\",\n    url: buildUrl(params.endpoint),\n    token,\n    body,\n    files: params.files,\n    companyId: params.companyId,\n    language: params.language,\n    additionalHeaders: _staticConfig?.additionalHeaders,\n  });\n\n  return translateResponse({\n    classKey: params.responseType ?? params.classKey,\n    apiResponse,\n    companyId: params.companyId,\n    language: params.language,\n  });\n}\n\nexport async function JsonApiDelete(params: {\n  classKey: ApiRequestDataTypeInterface;\n  endpoint: string;\n  companyId?: string;\n  language: string;\n  responseType?: ApiRequestDataTypeInterface;\n}): Promise<ApiResponseInterface> {\n  runBootstrapper();\n  const token = await getToken();\n\n  const apiResponse = await makeRequest({\n    method: \"DELETE\",\n    url: buildUrl(params.endpoint),\n    token,\n    companyId: params.companyId,\n    language: params.language,\n    additionalHeaders: _staticConfig?.additionalHeaders,\n  });\n\n  return translateResponse({\n    classKey: params.responseType ?? params.classKey,\n    apiResponse,\n    companyId: params.companyId,\n    language: params.language,\n  });\n}\n"]}