@carlonicora/nextjs-jsonapi 1.4.0 → 1.6.0

package/dist/server/index.mjs

@@ -1,12 +1,31 @@
 import {
   serverRequest
-} from "../chunk-HR4H2FP7.mjs";
+} from "../chunk-KJ4ETLJB.mjs";
 import {
-  getServerToken
-} from "../chunk-YF5XQZDR.mjs";
+  AuthService,
+  CompanyService,
+  ContentService,
+  FeatureService,
+  NotificationService,
+  PushService,
+  RoleService,
+  S3Service,
+  UserService
+} from "../chunk-37NJZ2VD.mjs";
+import "../chunk-F4Y3GZG4.mjs";
 import {
   checkPermissionsFromServer
-} from "../chunk-HAG77QBV.mjs";
+} from "../chunk-K4W5QXL5.mjs";
+import "../chunk-KFL5ZFM4.mjs";
+import "../chunk-C7C7VY4F.mjs";
+import {
+  JsonApiDataFactory,
+  translateResponse
+} from "../chunk-RBIVEH2K.mjs";
+import {
+  getServerToken
+} from "../chunk-F5UNXZ3J.mjs";
+import "../chunk-AUXK7QSA.mjs";
 import {
   __name
 } from "../chunk-PAWJFY3S.mjs";
@@ -87,9 +106,200 @@ var ServerSession = class {
     });
   }
 };
+
+// src/server/JsonApiServer.ts
+var _serverConfig = null;
+function configureServerJsonApi(config) {
+  _serverConfig = config;
+  if (config.bootstrapper) {
+    config.bootstrapper();
+  }
+}
+__name(configureServerJsonApi, "configureServerJsonApi");
+function getServerApiUrl() {
+  if (_serverConfig?.apiUrl) {
+    return _serverConfig.apiUrl;
+  }
+  const envUrl = process.env.NEXT_PUBLIC_API_URL;
+  if (!envUrl) {
+    throw new Error("API URL not configured. Use configureServerJsonApi() or set NEXT_PUBLIC_API_URL environment variable.");
+  }
+  return envUrl;
+}
+__name(getServerApiUrl, "getServerApiUrl");
+function getServerAppUrl() {
+  if (_serverConfig?.appUrl) {
+    return _serverConfig.appUrl;
+  }
+  const envUrl = process.env.NEXT_PUBLIC_ADDRESS;
+  if (!envUrl) {
+    throw new Error("App URL not configured. Use configureServerJsonApi({ appUrl }) or set NEXT_PUBLIC_ADDRESS environment variable.");
+  }
+  return envUrl.trim().replace(/\/+$/, "");
+}
+__name(getServerAppUrl, "getServerAppUrl");
+function getServerTrackablePages() {
+  return _serverConfig?.trackablePages ?? [];
+}
+__name(getServerTrackablePages, "getServerTrackablePages");
+function runServerBootstrapper() {
+  if (_serverConfig?.bootstrapper) {
+    _serverConfig.bootstrapper();
+  }
+}
+__name(runServerBootstrapper, "runServerBootstrapper");
+function buildServerUrl(endpoint) {
+  const apiUrl = getServerApiUrl();
+  return endpoint.startsWith("http") ? endpoint : `${apiUrl}${endpoint}`;
+}
+__name(buildServerUrl, "buildServerUrl");
+async function ServerJsonApiGet(params) {
+  runServerBootstrapper();
+  const token = await getServerToken();
+  const apiResponse = await serverRequest({
+    method: "GET",
+    url: buildServerUrl(params.endpoint),
+    token,
+    cache: params.classKey.cache,
+    companyId: params.companyId,
+    language: params.language,
+    additionalHeaders: _serverConfig?.additionalHeaders
+  });
+  return translateResponse({
+    classKey: params.classKey,
+    apiResponse,
+    companyId: params.companyId,
+    language: params.language,
+    paginationHandler: /* @__PURE__ */ __name(async (endpoint) => ServerJsonApiGet({
+      classKey: params.classKey,
+      endpoint,
+      companyId: params.companyId,
+      language: params.language
+    }), "paginationHandler")
+  });
+}
+__name(ServerJsonApiGet, "ServerJsonApiGet");
+async function ServerJsonApiPost(params) {
+  runServerBootstrapper();
+  const token = await getServerToken();
+  let body = params.body;
+  if (!body) {
+    body = {};
+  } else if (params.overridesJsonApiCreation !== true) {
+    body = JsonApiDataFactory.create(params.classKey, body);
+  }
+  const apiResponse = await serverRequest({
+    method: "POST",
+    url: buildServerUrl(params.endpoint),
+    token,
+    body,
+    files: params.files,
+    companyId: params.companyId,
+    language: params.language,
+    additionalHeaders: _serverConfig?.additionalHeaders
+  });
+  return translateResponse({
+    classKey: params.responseType ?? params.classKey,
+    apiResponse,
+    companyId: params.companyId,
+    language: params.language
+  });
+}
+__name(ServerJsonApiPost, "ServerJsonApiPost");
+async function ServerJsonApiPut(params) {
+  runServerBootstrapper();
+  const token = await getServerToken();
+  let body = params.body;
+  if (!body) {
+    body = {};
+  } else {
+    body = JsonApiDataFactory.create(params.classKey, body);
+  }
+  const apiResponse = await serverRequest({
+    method: "PUT",
+    url: buildServerUrl(params.endpoint),
+    token,
+    body,
+    files: params.files,
+    companyId: params.companyId,
+    language: params.language,
+    additionalHeaders: _serverConfig?.additionalHeaders
+  });
+  return translateResponse({
+    classKey: params.responseType ?? params.classKey,
+    apiResponse,
+    companyId: params.companyId,
+    language: params.language
+  });
+}
+__name(ServerJsonApiPut, "ServerJsonApiPut");
+async function ServerJsonApiPatch(params) {
+  runServerBootstrapper();
+  const token = await getServerToken();
+  let body = params.body;
+  if (!body) {
+    body = {};
+  } else if (params.overridesJsonApiCreation !== true) {
+    body = JsonApiDataFactory.create(params.classKey, body);
+  }
+  const apiResponse = await serverRequest({
+    method: "PATCH",
+    url: buildServerUrl(params.endpoint),
+    token,
+    body,
+    files: params.files,
+    companyId: params.companyId,
+    language: params.language,
+    additionalHeaders: _serverConfig?.additionalHeaders
+  });
+  return translateResponse({
+    classKey: params.responseType ?? params.classKey,
+    apiResponse,
+    companyId: params.companyId,
+    language: params.language
+  });
+}
+__name(ServerJsonApiPatch, "ServerJsonApiPatch");
+async function ServerJsonApiDelete(params) {
+  runServerBootstrapper();
+  const token = await getServerToken();
+  const apiResponse = await serverRequest({
+    method: "DELETE",
+    url: buildServerUrl(params.endpoint),
+    token,
+    companyId: params.companyId,
+    language: params.language,
+    additionalHeaders: _serverConfig?.additionalHeaders
+  });
+  return translateResponse({
+    classKey: params.responseType ?? params.classKey,
+    apiResponse,
+    companyId: params.companyId,
+    language: params.language
+  });
+}
+__name(ServerJsonApiDelete, "ServerJsonApiDelete");
 export {
+  AuthService as ServerAuthService,
+  CompanyService as ServerCompanyService,
+  ContentService as ServerContentService,
+  FeatureService as ServerFeatureService,
+  ServerJsonApiDelete,
+  ServerJsonApiGet,
+  ServerJsonApiPatch,
+  ServerJsonApiPost,
+  ServerJsonApiPut,
+  NotificationService as ServerNotificationService,
+  PushService as ServerPushService,
+  RoleService as ServerRoleService,
+  S3Service as ServerS3Service,
   ServerSession,
+  UserService as ServerUserService,
+  configureServerJsonApi,
+  getServerApiUrl,
+  getServerAppUrl,
   getServerToken,
+  getServerTrackablePages,
   invalidateCacheTag,
   invalidateCacheTags,
   serverRequest

package/dist/server/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/server/cache.ts","../../src/server/ServerSession.ts"],"sourcesContent":["\"use server\";\n\nimport { revalidateTag } from \"next/cache\";\n\nexport type CacheProfile = \"seconds\" | \"minutes\" | \"hours\" | \"days\" | \"weeks\" | \"max\" | \"default\";\n\n/**\n * Revalidate a cache tag to invalidate cached data.\n * Next.js 16+ requires a profile parameter.\n *\n * @param tag - The cache tag to invalidate\n * @param profile - The cache profile (defaults to \"max\" for immediate invalidation)\n */\nexport async function invalidateCacheTag(tag: string, profile: CacheProfile = \"max\"): Promise<void> {\n  revalidateTag(tag, profile);\n}\n\n/**\n * Revalidate multiple cache tags.\n *\n * @param tags - Array of cache tags to invalidate\n * @param profile - The cache profile (defaults to \"max\" for immediate invalidation)\n */\nexport async function invalidateCacheTags(tags: string[], profile: CacheProfile = \"max\"): Promise<void> {\n  for (const tag of tags) {\n    revalidateTag(tag, profile);\n  }\n}\n","import { cookies } from \"next/headers\";\nimport { redirect } from \"next/navigation\";\nimport zlib from \"zlib\";\nimport { Action, checkPermissionsFromServer, ModuleWithPermissions } from \"../permissions\";\n\nexport class ServerSession {\n  static async isLogged() {\n    const cookieStore = await cookies();\n    const token = cookieStore.get(\"token\");\n\n    if (!token || !token.value) return false;\n    return true;\n  }\n\n  static async isLicenseActive(): Promise<boolean> {\n    const cookieStore = await cookies();\n    const licenseExpirationDate = cookieStore.get(\"licenseExpirationDate\")?.value;\n\n    if (!licenseExpirationDate) return false;\n\n    const now = new Date();\n    return new Date(licenseExpirationDate) > now;\n  }\n\n  static async companyId() {\n    const cookieStore = await cookies();\n    return cookieStore.get(\"companyId\")?.value ?? \"\";\n  }\n\n  static async userId() {\n    const cookieStore = await cookies();\n    return cookieStore.get(\"userId\")?.value ?? \"\";\n  }\n\n  static async checkPermission<M extends ModuleWithPermissions>(params: { module: M; action: Action; data?: any }) {\n    if (!(await this.hasPermissionToModule(params))) redirect(`/401`);\n  }\n\n  static async hasRole(roleId: string): Promise<boolean> {\n    const cookieStore = await cookies();\n    const roles = cookieStore.get(\"roles\")?.value;\n\n    if (!roles || !roles.includes(roleId)) return false;\n\n    return true;\n  }\n\n  static async hasFeature(featureId: string): Promise<boolean> {\n    const cookieStore = await cookies();\n    const features = cookieStore.get(\"features\")?.value;\n\n    if (!features || !features.includes(featureId)) return false;\n\n    return true;\n  }\n\n  static async hasPermissionToModule<M extends ModuleWithPermissions>(params: {\n    module: M;\n    action: Action;\n    data?: any;\n  }): Promise<boolean> {\n    const cookieStore = await cookies();\n\n    if (params.module.feature) {\n      const features = cookieStore.get(\"features\")?.value;\n\n      if (features && !features.includes(params.module.feature)) return false;\n    }\n\n    const rawModules = cookieStore.get(\"modules\")?.value;\n    if (!rawModules) return false;\n\n    const modules: {\n      id: string;\n      permissions: {\n        create: boolean | string;\n        read: boolean | string;\n        update: boolean | string;\n        delete: boolean | string;\n      };\n    }[] = JSON.parse(zlib.gunzipSync(Buffer.from(rawModules, \"base64\")).toString());\n\n    const selectedModule = modules.find((module) => module.id === params.module.moduleId);\n\n    return checkPermissionsFromServer({\n      module: params.module,\n      action: params.action,\n      data: params.data,\n      userId: await this.userId(),\n      selectedModule: selectedModule,\n    });\n\n    // if (!selectedModule) return false;\n\n    // if (!selectedModule.permissions[params.action]) return false;\n    // if (typeof selectedModule.permissions[params.action] === \"boolean\")\n    //   return selectedModule.permissions[params.action] as boolean;\n\n    // if (!params.data) return false;\n\n    // return params.data[selectedModule.permissions[params.action] as string] === this.userId;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;AAEA,SAAS,qBAAqB;AAW9B,eAAsB,mBAAmB,KAAa,UAAwB,OAAsB;AAClG,gBAAc,KAAK,OAAO;AAC5B;AAFsB;AAUtB,eAAsB,oBAAoB,MAAgB,UAAwB,OAAsB;AACtG,aAAW,OAAO,MAAM;AACtB,kBAAc,KAAK,OAAO;AAAA,EAC5B;AACF;AAJsB;;;ACvBtB,SAAS,eAAe;AACxB,SAAS,gBAAgB;AACzB,OAAO,UAAU;AAGV,IAAM,gBAAN,MAAoB;AAAA,EAL3B,OAK2B;AAAA;AAAA;AAAA,EACzB,aAAa,WAAW;AACtB,UAAM,cAAc,MAAM,QAAQ;AAClC,UAAM,QAAQ,YAAY,IAAI,OAAO;AAErC,QAAI,CAAC,SAAS,CAAC,MAAM,MAAO,QAAO;AACnC,WAAO;AAAA,EACT;AAAA,EAEA,aAAa,kBAAoC;AAC/C,UAAM,cAAc,MAAM,QAAQ;AAClC,UAAM,wBAAwB,YAAY,IAAI,uBAAuB,GAAG;AAExE,QAAI,CAAC,sBAAuB,QAAO;AAEnC,UAAM,MAAM,oBAAI,KAAK;AACrB,WAAO,IAAI,KAAK,qBAAqB,IAAI;AAAA,EAC3C;AAAA,EAEA,aAAa,YAAY;AACvB,UAAM,cAAc,MAAM,QAAQ;AAClC,WAAO,YAAY,IAAI,WAAW,GAAG,SAAS;AAAA,EAChD;AAAA,EAEA,aAAa,SAAS;AACpB,UAAM,cAAc,MAAM,QAAQ;AAClC,WAAO,YAAY,IAAI,QAAQ,GAAG,SAAS;AAAA,EAC7C;AAAA,EAEA,aAAa,gBAAiD,QAAmD;AAC/G,QAAI,CAAE,MAAM,KAAK,sBAAsB,MAAM,EAAI,UAAS,MAAM;AAAA,EAClE;AAAA,EAEA,aAAa,QAAQ,QAAkC;AACrD,UAAM,cAAc,MAAM,QAAQ;AAClC,UAAM,QAAQ,YAAY,IAAI,OAAO,GAAG;AAExC,QAAI,CAAC,SAAS,CAAC,MAAM,SAAS,MAAM,EAAG,QAAO;AAE9C,WAAO;AAAA,EACT;AAAA,EAEA,aAAa,WAAW,WAAqC;AAC3D,UAAM,cAAc,MAAM,QAAQ;AAClC,UAAM,WAAW,YAAY,IAAI,UAAU,GAAG;AAE9C,QAAI,CAAC,YAAY,CAAC,SAAS,SAAS,SAAS,EAAG,QAAO;AAEvD,WAAO;AAAA,EACT;AAAA,EAEA,aAAa,sBAAuD,QAI/C;AACnB,UAAM,cAAc,MAAM,QAAQ;AAElC,QAAI,OAAO,OAAO,SAAS;AACzB,YAAM,WAAW,YAAY,IAAI,UAAU,GAAG;AAE9C,UAAI,YAAY,CAAC,SAAS,SAAS,OAAO,OAAO,OAAO,EAAG,QAAO;AAAA,IACpE;AAEA,UAAM,aAAa,YAAY,IAAI,SAAS,GAAG;AAC/C,QAAI,CAAC,WAAY,QAAO;AAExB,UAAM,UAQA,KAAK,MAAM,KAAK,WAAW,OAAO,KAAK,YAAY,QAAQ,CAAC,EAAE,SAAS,CAAC;AAE9E,UAAM,iBAAiB,QAAQ,KAAK,CAAC,WAAW,OAAO,OAAO,OAAO,OAAO,QAAQ;AAEpF,WAAO,2BAA2B;AAAA,MAChC,QAAQ,OAAO;AAAA,MACf,QAAQ,OAAO;AAAA,MACf,MAAM,OAAO;AAAA,MACb,QAAQ,MAAM,KAAK,OAAO;AAAA,MAC1B;AAAA,IACF,CAAC;AAAA,EAWH;AACF;","names":[]}
+{"version":3,"sources":["../../src/server/cache.ts","../../src/server/ServerSession.ts","../../src/server/JsonApiServer.ts"],"sourcesContent":["// Server-only utilities (NOT server actions - these cannot be called from client components)\n\nimport { revalidateTag } from \"next/cache\";\n\nexport type CacheProfile = \"seconds\" | \"minutes\" | \"hours\" | \"days\" | \"weeks\" | \"max\" | \"default\";\n\n/**\n * Revalidate a cache tag to invalidate cached data.\n * Next.js 16+ requires a profile parameter.\n *\n * @param tag - The cache tag to invalidate\n * @param profile - The cache profile (defaults to \"max\" for immediate invalidation)\n */\nexport async function invalidateCacheTag(tag: string, profile: CacheProfile = \"max\"): Promise<void> {\n  revalidateTag(tag, profile);\n}\n\n/**\n * Revalidate multiple cache tags.\n *\n * @param tags - Array of cache tags to invalidate\n * @param profile - The cache profile (defaults to \"max\" for immediate invalidation)\n */\nexport async function invalidateCacheTags(tags: string[], profile: CacheProfile = \"max\"): Promise<void> {\n  for (const tag of tags) {\n    revalidateTag(tag, profile);\n  }\n}\n","import { cookies } from \"next/headers\";\nimport { redirect } from \"next/navigation\";\nimport zlib from \"zlib\";\nimport { Action, checkPermissionsFromServer, ModuleWithPermissions } from \"../permissions\";\n\nexport class ServerSession {\n  static async isLogged() {\n    const cookieStore = await cookies();\n    const token = cookieStore.get(\"token\");\n\n    if (!token || !token.value) return false;\n    return true;\n  }\n\n  static async isLicenseActive(): Promise<boolean> {\n    const cookieStore = await cookies();\n    const licenseExpirationDate = cookieStore.get(\"licenseExpirationDate\")?.value;\n\n    if (!licenseExpirationDate) return false;\n\n    const now = new Date();\n    return new Date(licenseExpirationDate) > now;\n  }\n\n  static async companyId() {\n    const cookieStore = await cookies();\n    return cookieStore.get(\"companyId\")?.value ?? \"\";\n  }\n\n  static async userId() {\n    const cookieStore = await cookies();\n    return cookieStore.get(\"userId\")?.value ?? \"\";\n  }\n\n  static async checkPermission<M extends ModuleWithPermissions>(params: { module: M; action: Action; data?: any }) {\n    if (!(await this.hasPermissionToModule(params))) redirect(`/401`);\n  }\n\n  static async hasRole(roleId: string): Promise<boolean> {\n    const cookieStore = await cookies();\n    const roles = cookieStore.get(\"roles\")?.value;\n\n    if (!roles || !roles.includes(roleId)) return false;\n\n    return true;\n  }\n\n  static async hasFeature(featureId: string): Promise<boolean> {\n    const cookieStore = await cookies();\n    const features = cookieStore.get(\"features\")?.value;\n\n    if (!features || !features.includes(featureId)) return false;\n\n    return true;\n  }\n\n  static async hasPermissionToModule<M extends ModuleWithPermissions>(params: {\n    module: M;\n    action: Action;\n    data?: any;\n  }): Promise<boolean> {\n    const cookieStore = await cookies();\n\n    if (params.module.feature) {\n      const features = cookieStore.get(\"features\")?.value;\n\n      if (features && !features.includes(params.module.feature)) return false;\n    }\n\n    const rawModules = cookieStore.get(\"modules\")?.value;\n    if (!rawModules) return false;\n\n    const modules: {\n      id: string;\n      permissions: {\n        create: boolean | string;\n        read: boolean | string;\n        update: boolean | string;\n        delete: boolean | string;\n      };\n    }[] = JSON.parse(zlib.gunzipSync(Buffer.from(rawModules, \"base64\")).toString());\n\n    const selectedModule = modules.find((module) => module.id === params.module.moduleId);\n\n    return checkPermissionsFromServer({\n      module: params.module,\n      action: params.action,\n      data: params.data,\n      userId: await this.userId(),\n      selectedModule: selectedModule,\n    });\n\n    // if (!selectedModule) return false;\n\n    // if (!selectedModule.permissions[params.action]) return false;\n    // if (typeof selectedModule.permissions[params.action] === \"boolean\")\n    //   return selectedModule.permissions[params.action] as boolean;\n\n    // if (!params.data) return false;\n\n    // return params.data[selectedModule.permissions[params.action] as string] === this.userId;\n  }\n}\n","// Server-only utilities (NOT server actions - these cannot be called from client components)\n\nimport { JsonApiDataFactory } from \"../core/factories/JsonApiDataFactory\";\nimport { ApiRequestDataTypeInterface } from \"../core/interfaces/ApiRequestDataTypeInterface\";\nimport { ApiResponseInterface } from \"../core/interfaces/ApiResponseInterface\";\nimport { translateResponse } from \"../core/utils/translateResponse\";\nimport { ModuleWithPermissions } from \"../permissions/types\";\nimport { serverRequest } from \"./request\";\nimport { getServerToken } from \"./token\";\n\n// Config storage for server contexts\nlet _serverConfig: {\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 server client.\n * Call this in your Bootstrapper or server initialization.\n */\nexport function configureServerJsonApi(config: {\n  apiUrl: string;\n  appUrl?: string;\n  trackablePages?: ModuleWithPermissions[];\n  bootstrapper?: () => void;\n  additionalHeaders?: Record<string, string>;\n}): void {\n  _serverConfig = config;\n  if (config.bootstrapper) {\n    config.bootstrapper();\n  }\n}\n\nexport function getServerApiUrl(): string {\n  if (_serverConfig?.apiUrl) {\n    return _serverConfig.apiUrl;\n  }\n  const envUrl = process.env.NEXT_PUBLIC_API_URL;\n  if (!envUrl) {\n    throw new Error(\"API URL not configured. Use configureServerJsonApi() or set NEXT_PUBLIC_API_URL environment variable.\");\n  }\n  return envUrl;\n}\n\nexport function getServerAppUrl(): string {\n  if (_serverConfig?.appUrl) {\n    return _serverConfig.appUrl;\n  }\n  const envUrl = process.env.NEXT_PUBLIC_ADDRESS;\n  if (!envUrl) {\n    throw new Error(\"App URL not configured. Use configureServerJsonApi({ appUrl }) or set NEXT_PUBLIC_ADDRESS environment variable.\");\n  }\n  return envUrl.trim().replace(/\\/+$/, \"\");\n}\n\nexport function getServerTrackablePages(): ModuleWithPermissions[] {\n  return _serverConfig?.trackablePages ?? [];\n}\n\nfunction runServerBootstrapper(): void {\n  if (_serverConfig?.bootstrapper) {\n    _serverConfig.bootstrapper();\n  }\n}\n\nfunction buildServerUrl(endpoint: string): string {\n  const apiUrl = getServerApiUrl();\n  return endpoint.startsWith(\"http\") ? endpoint : `${apiUrl}${endpoint}`;\n}\n\nexport async function ServerJsonApiGet(params: {\n  classKey: ApiRequestDataTypeInterface;\n  endpoint: string;\n  companyId?: string;\n  language: string;\n}): Promise<ApiResponseInterface> {\n  runServerBootstrapper();\n  const token = await getServerToken();\n\n  const apiResponse = await serverRequest({\n    method: \"GET\",\n    url: buildServerUrl(params.endpoint),\n    token,\n    cache: params.classKey.cache,\n    companyId: params.companyId,\n    language: params.language,\n    additionalHeaders: _serverConfig?.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      ServerJsonApiGet({\n        classKey: params.classKey,\n        endpoint,\n        companyId: params.companyId,\n        language: params.language,\n      }),\n  });\n}\n\nexport async function ServerJsonApiPost(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}): Promise<ApiResponseInterface> {\n  runServerBootstrapper();\n  const token = await getServerToken();\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 serverRequest({\n    method: \"POST\",\n    url: buildServerUrl(params.endpoint),\n    token,\n    body,\n    files: params.files,\n    companyId: params.companyId,\n    language: params.language,\n    additionalHeaders: _serverConfig?.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 ServerJsonApiPut(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  runServerBootstrapper();\n  const token = await getServerToken();\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 serverRequest({\n    method: \"PUT\",\n    url: buildServerUrl(params.endpoint),\n    token,\n    body,\n    files: params.files,\n    companyId: params.companyId,\n    language: params.language,\n    additionalHeaders: _serverConfig?.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 ServerJsonApiPatch(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  runServerBootstrapper();\n  const token = await getServerToken();\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 serverRequest({\n    method: \"PATCH\",\n    url: buildServerUrl(params.endpoint),\n    token,\n    body,\n    files: params.files,\n    companyId: params.companyId,\n    language: params.language,\n    additionalHeaders: _serverConfig?.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 ServerJsonApiDelete(params: {\n  classKey: ApiRequestDataTypeInterface;\n  endpoint: string;\n  companyId?: string;\n  language: string;\n  responseType?: ApiRequestDataTypeInterface;\n}): Promise<ApiResponseInterface> {\n  runServerBootstrapper();\n  const token = await getServerToken();\n\n  const apiResponse = await serverRequest({\n    method: \"DELETE\",\n    url: buildServerUrl(params.endpoint),\n    token,\n    companyId: params.companyId,\n    language: params.language,\n    additionalHeaders: _serverConfig?.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"],"mappings":"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","names":[]}

package/dist/token-2UWQJY5T.js

@@ -0,0 +1,8 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkYUO55Q5Ajs = require('./chunk-YUO55Q5A.js');
+require('./chunk-7QVYU63E.js');
+
+
+exports.getServerToken = _chunkYUO55Q5Ajs.getServerToken;
+//# sourceMappingURL=token-2UWQJY5T.js.map

package/dist/token-2UWQJY5T.js.map

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

package/dist/token-EOK3N45S.mjs

@@ -0,0 +1,8 @@
+import {
+  getServerToken
+} from "./chunk-F5UNXZ3J.mjs";
+import "./chunk-PAWJFY3S.mjs";
+export {
+  getServerToken
+};
+//# sourceMappingURL=token-EOK3N45S.mjs.map

package/dist/{useSocket-DzMKRKCA.d.ts → useSocket-8vwK_R_c.d.ts}

@@ -1,4 +1,4 @@
-import { N as NotificationInterface } from './notification.interface-gyvT-Z2F.js';
+import { N as NotificationInterface } from './notification.interface-BdcwkuQE.js';
 
 interface UseSocketOptions {
     token: string;

package/dist/{useSocket-Cn7fB_B1.d.mts → useSocket-BWJUXuOl.d.mts}

@@ -1,4 +1,4 @@
-import { N as NotificationInterface } from './notification.interface-BBgMUdLR.mjs';
+import { N as NotificationInterface } from './notification.interface-BdcwkuQE.mjs';
 
 interface UseSocketOptions {
     token: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carlonicora/nextjs-jsonapi",
-  "version": "1.4.0",
+  "version": "1.6.0",
   "description": "Next.js JSON:API client with server/client support and caching",
   "author": "Carlo Nicora",
   "license": "GPL-3.0-or-later",
@@ -17,16 +17,21 @@
       "import": "./dist/index.mjs",
       "require": "./dist/index.js"
     },
-    "./atoms": {
-      "types": "./dist/atoms/index.d.ts",
-      "import": "./dist/atoms/index.mjs",
-      "require": "./dist/atoms/index.js"
-    },
     "./core": {
       "types": "./dist/core/index.d.ts",
       "import": "./dist/core/index.mjs",
       "require": "./dist/core/index.js"
     },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.mjs",
+      "require": "./dist/server/index.js"
+    },
+    "./client": {
+      "types": "./dist/client/index.d.ts",
+      "import": "./dist/client/index.mjs",
+      "require": "./dist/client/index.js"
+    },
     "./components": {
       "types": "./dist/components/index.d.ts",
       "import": "./dist/components/index.mjs",
@@ -36,55 +41,10 @@
       "types": "./dist/contexts/index.d.ts",
       "import": "./dist/contexts/index.mjs",
       "require": "./dist/contexts/index.js"
-    },
-    "./client": {
-      "types": "./dist/client/index.d.ts",
-      "import": "./dist/client/index.mjs",
-      "require": "./dist/client/index.js"
-    },
-    "./server": {
-      "types": "./dist/server/index.d.ts",
-      "import": "./dist/server/index.mjs",
-      "require": "./dist/server/index.js"
-    },
-    "./permissions": {
-      "types": "./dist/permissions/index.d.ts",
-      "import": "./dist/permissions/index.mjs",
-      "require": "./dist/permissions/index.js"
-    },
-    "./utils": {
-      "types": "./dist/utils/index.d.ts",
-      "import": "./dist/utils/index.mjs",
-      "require": "./dist/utils/index.js"
-    },
-    "./interfaces": {
-      "types": "./dist/interfaces/index.d.ts",
-      "import": "./dist/interfaces/index.mjs",
-      "require": "./dist/interfaces/index.js"
-    },
-    "./shadcnui": {
-      "types": "./dist/shadcnui/index.d.ts",
-      "import": "./dist/shadcnui/index.mjs",
-      "require": "./dist/shadcnui/index.js"
-    },
-    "./hooks": {
-      "types": "./dist/hooks/index.d.ts",
-      "import": "./dist/hooks/index.mjs",
-      "require": "./dist/hooks/index.js"
-    },
-    "./features": {
-      "types": "./dist/features/index.d.ts",
-      "import": "./dist/features/index.mjs",
-      "require": "./dist/features/index.js"
-    },
-    "./roles": {
-      "types": "./dist/roles/index.d.ts",
-      "import": "./dist/roles/index.mjs",
-      "require": "./dist/roles/index.js"
     }
   },
   "scripts": {
-    "build": "tsup && tsc -p scripts/generate-web-module/tsconfig.json",
+    "build": "NODE_OPTIONS='--max-old-space-size=8192' tsup && tsc -p scripts/generate-web-module/tsconfig.json",
     "dev": "tsup --watch",
     "clean": "rm -rf dist",
     "lint": "eslint \"src/**/*.ts\" --fix",

package/scripts/generate-web-module/generator.ts

@@ -108,11 +108,14 @@ export async function generateWebModule(options: GenerateWebModuleOptions): Prom
     console.log(`   ${bootstrapResult.success ? "✅" : "❌"} ${bootstrapResult.message}`);
   }
 
-  // Step 7: Update i18n (unless --no-register)
+  // Step 7: Update i18n for all languages (unless --no-register)
   if (!noRegister) {
-    console.log("\n🌐 Updating messages/en.json...");
-    const i18nResult = updateI18n(templateData, webBasePath, dryRun);
-    console.log(`   ${i18nResult.success ? "✅" : "❌"} ${i18nResult.message}`);
+    const languages = schema.languages || ["en"];
+    console.log(`\n🌐 Updating i18n for ${languages.length} language(s)...`);
+    for (const language of languages) {
+      const i18nResult = updateI18n(templateData, webBasePath, language, dryRun);
+      console.log(`   ${i18nResult.success ? "✅" : "❌"} ${i18nResult.message}`);
+    }
   }
 
   console.log("\n✅ Generation complete!");
@@ -131,7 +134,7 @@ export async function generateWebModule(options: GenerateWebModuleOptions): Prom
 function buildTemplateData(schema: JsonModuleDefinition): FrontendTemplateData {
   const names = transformNames(schema.moduleName, schema.endpointName);
   const targetDir = schema.targetDir as "features" | "foundations";
-  const extendsContent = detectExtendsContent(schema.fields);
+  const extendsContent = detectExtendsContent(schema.fields, schema.extendsContent);
 
   // Map fields
   const allFields = mapFields(schema.fields, names.camelCase);

package/scripts/generate-web-module/index.ts

@@ -26,7 +26,7 @@ program
   .argument("<json-path>", "Path to JSON schema file (relative or absolute)")
   .option("-d, --dry-run", "Preview files without writing them", false)
   .option("-f, --force", "Overwrite existing files", false)
-  .option("-n, --no-register", "Skip Bootstrapper.ts and i18n updates", false)
+  .option("-n, --no-register", "Skip Bootstrapper.ts and i18n updates")
   .action(async (jsonPath: string, options: { dryRun: boolean; force: boolean; register: boolean }) => {
     // Resolve path
     const resolvedPath = path.isAbsolute(jsonPath) ? jsonPath : path.resolve(process.cwd(), jsonPath);

package/scripts/generate-web-module/templates/components/editor.template.ts

@@ -8,7 +8,7 @@ import { FrontendTemplateData, FrontendField, FrontendRelationship } from "../..
 import { toCamelCase, pluralize, toPascalCase } from "../../transformers/name-transformer";
 import { AUTHOR_VARIANT } from "../../types/field-mapping.types";
 import { getFormFieldJsx } from "../../transformers/field-mapper";
-import { getRelationshipFormJsx, getDefaultValueExpression, getPayloadMapping } from "../../transformers/relationship-resolver";
+import { getRelationshipFormJsx, getDefaultValueExpression, getPayloadMapping, isFoundationImport, FOUNDATION_PACKAGE } from "../../transformers/relationship-resolver";
 
 /**
  * Generate the editor component file content
@@ -154,7 +154,12 @@ function generateImports(data: FrontendTemplateData): string {
       imports.push(`import { UserInterface } from "@/features/foundations/user/data/UserInterface";`);
     } else {
       const componentName = rel.single ? `${rel.name}Selector` : `${rel.name}MultiSelector`;
-      imports.push(`import ${componentName} from "${rel.importPath}";`);
+      if (rel.isFoundation) {
+        // Foundation entities use named imports from the package
+        imports.push(`import { ${componentName} } from "${FOUNDATION_PACKAGE}";`);
+      } else {
+        imports.push(`import ${componentName} from "${rel.importPath}";`);
+      }
     }
   });
 

package/scripts/generate-web-module/transformers/parent-detector.ts

@@ -2,19 +2,26 @@
  * Parent Class Detector
  *
  * Determines whether a module should extend Content or AbstractApiData
- * based on the presence of Content-specific fields.
+ * based on the presence of Content-specific fields or explicit configuration.
  */
 
 import { JsonFieldDefinition } from "../types/json-schema.interface";
 import { CONTENT_INDICATOR_FIELDS } from "../types/field-mapping.types";
 
 /**
- * Check if a module should extend Content based on its fields
+ * Check if a module should extend Content
  *
  * @param fields - Array of field definitions from JSON schema
+ * @param explicitValue - Optional explicit value from JSON schema
  * @returns true if the module should extend Content
  */
-export function detectExtendsContent(fields: JsonFieldDefinition[]): boolean {
+export function detectExtendsContent(fields: JsonFieldDefinition[], explicitValue?: boolean): boolean {
+  // If explicitly set in JSON schema, use that value
+  if (explicitValue !== undefined) {
+    return explicitValue;
+  }
+
+  // Otherwise, auto-detect based on fields
   const fieldNames = fields.map((f) => f.name);
   return CONTENT_INDICATOR_FIELDS.some((indicator) => fieldNames.includes(indicator));
 }

package/scripts/generate-web-module/transformers/relationship-resolver.ts

@@ -10,6 +10,21 @@ import { FrontendRelationship, RelationshipServiceMethod } from "../types/templa
 import { AUTHOR_VARIANT, AUTHOR_ZOD_SCHEMA, ENTITY_ZOD_SCHEMA } from "../types/field-mapping.types";
 import { toCamelCase, toKebabCase, pluralize, toPascalCase } from "./name-transformer";
 
+/**
+ * Foundation package name constant for web imports
+ */
+export const FOUNDATION_PACKAGE = "@carlonicora/nextjs-jsonapi/features";
+
+/**
+ * Check if a directory represents a foundation import (from the package)
+ *
+ * @param directory - The directory string from relationship definition
+ * @returns True if this should import from the foundation package
+ */
+export function isFoundationImport(directory: string): boolean {
+  return directory === "@foundation" || directory.startsWith("@foundation/");
+}
+
 /**
  * Resolve a JSON relationship to frontend representation
  *
@@ -56,11 +71,23 @@ export function resolveRelationship(rel: JsonRelationshipDefinition): FrontendRe
     zodSchema = rel.nullable ? `z.array(${ENTITY_ZOD_SCHEMA}).optional()` : `z.array(${ENTITY_ZOD_SCHEMA})`;
   }
 
-  // Import paths - map directory to web path
-  const webDirectory = mapDirectoryToWebPath(rel.directory);
-  const importPath = `@/features/${webDirectory}/${modelKebab}/components/forms/${selectorComponent}`;
-  const interfaceImportPath = `@/features/${webDirectory}/${modelKebab}/data/${rel.name}Interface`;
-  const serviceImportPath = `@/features/${webDirectory}/${modelKebab}/data/${rel.name}Service`;
+  // Import paths - check for foundation imports
+  let importPath: string;
+  let interfaceImportPath: string;
+  let serviceImportPath: string;
+
+  if (isFoundationImport(rel.directory)) {
+    // Foundation entities import from the package
+    importPath = FOUNDATION_PACKAGE;
+    interfaceImportPath = FOUNDATION_PACKAGE;
+    serviceImportPath = FOUNDATION_PACKAGE;
+  } else {
+    // Feature entities use local paths
+    const webDirectory = mapDirectoryToWebPath(rel.directory);
+    importPath = `@/features/${webDirectory}/${modelKebab}/components/forms/${selectorComponent}`;
+    interfaceImportPath = `@/features/${webDirectory}/${modelKebab}/data/${rel.name}Interface`;
+    serviceImportPath = `@/features/${webDirectory}/${modelKebab}/data/${rel.name}Service`;
+  }
 
   return {
     name: rel.name,
@@ -68,6 +95,7 @@ export function resolveRelationship(rel: JsonRelationshipDefinition): FrontendRe
     directory: rel.directory,
     single: rel.single,
     nullable: rel.nullable,
+    isFoundation: isFoundationImport(rel.directory),
     formFieldId,
     formFieldIdPlural,
     payloadFieldId,
@@ -131,10 +159,9 @@ export function getSelectorImports(relationships: FrontendRelationship[]): strin
   const imports = new Set<string>();
 
   relationships.forEach((rel) => {
-    // Don't import User selector from same module - it's typically a library import
-    if (rel.name === "User" && rel.variant === AUTHOR_VARIANT) {
-      // User selector is imported from library or user feature
-      imports.add(`import { UserSelector } from "@/features/foundations/user/components/forms/UserSelector";`);
+    if (isFoundationImport(rel.directory)) {
+      // Foundation entities use named imports from the package
+      imports.add(`import { ${rel.selectorComponent} } from "${FOUNDATION_PACKAGE}";`);
     } else {
       imports.add(`import ${rel.selectorComponent} from "${rel.importPath}";`);
     }

package/scripts/generate-web-module/types/json-schema.interface.ts

@@ -39,4 +39,6 @@ export interface JsonModuleDefinition {
   languages: string[];
   fields: JsonFieldDefinition[];
   relationships: JsonRelationshipDefinition[];
+  /** Explicitly set whether this module extends Content. If not set, auto-detects based on fields. */
+  extendsContent?: boolean;
 }

package/scripts/generate-web-module/types/template-data.interface.ts

@@ -46,6 +46,7 @@ export interface FrontendRelationship {
   directory: string; // e.g., "foundations"
   single: boolean;
   nullable: boolean;
+  isFoundation: boolean; // true if importing from @carlonicora/nextjs-jsonapi/features
   // Derived properties
   formFieldId: string; // e.g., "author" (lowercase variant) or "user"
   formFieldIdPlural: string; // e.g., "topics" for multi-select