@carlonicora/nextjs-jsonapi 1.4.0 → 1.6.0

package/src/core/abstracts/ClientAbstractService.ts

@@ -0,0 +1,255 @@
+"use client";
+
+import { ApiRequestDataTypeInterface } from "../interfaces/ApiRequestDataTypeInterface";
+import { ApiResponseInterface } from "../interfaces/ApiResponseInterface";
+import {
+  ClientJsonApiGet,
+  ClientJsonApiPost,
+  ClientJsonApiPut,
+  ClientJsonApiPatch,
+  ClientJsonApiDelete,
+} from "../../client/JsonApiClient";
+// Duplicated to avoid importing from AbstractService which pulls in server code
+// These are exported so client services can import them from here instead of core
+export enum ClientHttpMethod {
+  GET = "GET",
+  POST = "POST",
+  PUT = "PUT",
+  PATCH = "PATCH",
+  DELETE = "DELETE",
+}
+
+export interface ClientNextRef {
+  next?: string;
+}
+
+export interface ClientPreviousRef {
+  previous?: string;
+}
+
+export interface ClientSelfRef {
+  self?: string;
+}
+
+let globalErrorHandler: ((status: number, message: string) => void) | null = null;
+
+/**
+ * Set a global error handler for API errors (client-side only).
+ * This handler will be called instead of throwing errors.
+ */
+export function setClientGlobalErrorHandler(handler: (status: number, message: string) => void) {
+  globalErrorHandler = handler;
+}
+
+/**
+ * Get the current global error handler.
+ */
+export function getClientGlobalErrorHandler(): ((status: number, message: string) => void) | null {
+  return globalErrorHandler;
+}
+
+/**
+ * Client-side abstract base class for services that interact with the JSON:API.
+ * Use this for client components.
+ */
+export abstract class ClientAbstractService {
+  /**
+   * Extract locale from client-side URL pathname
+   * URL structure: /{locale}/route-path (e.g., /it/accounts)
+   * Fallback chain: URL locale → navigator.language → "en"
+   */
+  private static getClientLocale(): string {
+    if (typeof window === "undefined") {
+      return "en"; // Should not happen in client service
+    }
+
+    // Extract locale from URL pathname (first segment after leading slash)
+    const pathSegments = window.location.pathname.split("/").filter(Boolean);
+    const urlLocale = pathSegments[0];
+
+    // Validate against supported locales (currently only "en")
+    const supportedLocales = ["en"];
+    if (urlLocale && supportedLocales.includes(urlLocale)) {
+      return urlLocale;
+    }
+
+    // Fallback to navigator language
+    const navigatorLocale = navigator.language.split("-")[0];
+    if (navigatorLocale && supportedLocales.includes(navigatorLocale)) {
+      return navigatorLocale;
+    }
+
+    // Final fallback
+    return "en";
+  }
+
+  /**
+   * Fetch the next page of results.
+   */
+  static async next<T>(params: {
+    type: ApiRequestDataTypeInterface;
+    endpoint: string;
+    next?: ClientNextRef;
+    previous?: ClientPreviousRef;
+    self?: ClientSelfRef;
+  }): Promise<T> {
+    return await this.callApi<T>({
+      method: ClientHttpMethod.GET,
+      type: params.type,
+      endpoint: params.endpoint,
+      next: params.next,
+      previous: params.previous,
+      self: params.self,
+    });
+  }
+
+  /**
+   * Fetch the previous page of results.
+   */
+  static async previous<T>(params: {
+    type: ApiRequestDataTypeInterface;
+    endpoint: string;
+    next?: ClientNextRef;
+    previous?: ClientPreviousRef;
+    self?: ClientSelfRef;
+  }): Promise<T> {
+    return await this.callApi<T>({
+      method: ClientHttpMethod.GET,
+      type: params.type,
+      endpoint: params.endpoint,
+      next: params.next,
+      previous: params.previous,
+      self: params.self,
+    });
+  }
+
+  /**
+   * Make a client-side API call.
+   */
+  protected static async callApi<T>(params: {
+    type: ApiRequestDataTypeInterface;
+    method: ClientHttpMethod;
+    endpoint: string;
+    companyId?: string;
+    input?: any;
+    overridesJsonApiCreation?: boolean;
+    next?: ClientNextRef;
+    previous?: ClientPreviousRef;
+    self?: ClientSelfRef;
+    responseType?: ApiRequestDataTypeInterface;
+    files?: { [key: string]: File | Blob } | File | Blob;
+  }): Promise<T> {
+    let apiResponse: ApiResponseInterface;
+
+    // Client-side: extract locale from URL pathname
+    const language = this.getClientLocale();
+
+    switch (params.method) {
+      case ClientHttpMethod.GET:
+        apiResponse = await ClientJsonApiGet({
+          classKey: params.type,
+          endpoint: params.endpoint,
+          companyId: params.companyId,
+          language: language,
+        });
+        break;
+      case ClientHttpMethod.POST:
+        apiResponse = await ClientJsonApiPost({
+          classKey: params.type,
+          endpoint: params.endpoint,
+          companyId: params.companyId,
+          body: params.input,
+          overridesJsonApiCreation: params.overridesJsonApiCreation,
+          language: language,
+          responseType: params.responseType,
+          files: params.files,
+        });
+        break;
+      case ClientHttpMethod.PUT:
+        apiResponse = await ClientJsonApiPut({
+          classKey: params.type,
+          endpoint: params.endpoint,
+          companyId: params.companyId,
+          body: params.input,
+          language: language,
+          responseType: params.responseType,
+          files: params.files,
+        });
+        break;
+      case ClientHttpMethod.PATCH:
+        apiResponse = await ClientJsonApiPatch({
+          classKey: params.type,
+          endpoint: params.endpoint,
+          companyId: params.companyId,
+          body: params.input,
+          overridesJsonApiCreation: params.overridesJsonApiCreation,
+          language: language,
+          responseType: params.responseType,
+          files: params.files,
+        });
+        break;
+      case ClientHttpMethod.DELETE:
+        apiResponse = await ClientJsonApiDelete({
+          classKey: params.type,
+          endpoint: params.endpoint,
+          companyId: params.companyId,
+          language: language,
+          responseType: params.responseType,
+        });
+        break;
+      default:
+        throw new Error("Method not found");
+    }
+
+    if (!apiResponse.ok) {
+      if (globalErrorHandler) {
+        globalErrorHandler(apiResponse.response, apiResponse.error);
+        return undefined as any;
+      } else {
+        const error = new Error(`${apiResponse.response}:${apiResponse.error}`) as any;
+        error.status = apiResponse.response;
+        error.digest = `HTTP_${apiResponse.response}`;
+        throw error;
+      }
+    }
+
+    if (apiResponse.next && params.next) params.next.next = apiResponse.next;
+    if (apiResponse.prev && params.previous) params.previous.previous = apiResponse.prev;
+    if (apiResponse.self && params.self) params.self.self = apiResponse.self;
+
+    return apiResponse.data as T;
+  }
+
+  /**
+   * Get raw JSON:API response data without deserialization.
+   */
+  protected static async getRawData(params: {
+    type: ApiRequestDataTypeInterface;
+    method: ClientHttpMethod;
+    endpoint: string;
+    companyId?: string;
+  }): Promise<any> {
+    const language = this.getClientLocale();
+
+    const apiResponse: ApiResponseInterface = await ClientJsonApiGet({
+      classKey: params.type,
+      endpoint: params.endpoint,
+      companyId: params.companyId,
+      language: language,
+    });
+
+    if (!apiResponse.ok) {
+      if (globalErrorHandler) {
+        globalErrorHandler(apiResponse.response, apiResponse.error);
+        return undefined as any;
+      } else {
+        const error = new Error(`${apiResponse.response}:${apiResponse.error}`) as any;
+        error.status = apiResponse.response;
+        error.digest = `HTTP_${apiResponse.response}`;
+        throw error;
+      }
+    }
+
+    return apiResponse.raw;
+  }
+}

package/src/core/abstracts/ServerAbstractService.ts

@@ -0,0 +1,180 @@
+// Server-only abstract service (NOT a server action - cannot be called from client components)
+
+import { ApiRequestDataTypeInterface } from "../interfaces/ApiRequestDataTypeInterface";
+import { ApiResponseInterface } from "../interfaces/ApiResponseInterface";
+import {
+  ServerJsonApiGet,
+  ServerJsonApiPost,
+  ServerJsonApiPut,
+  ServerJsonApiPatch,
+  ServerJsonApiDelete,
+} from "../../server/JsonApiServer";
+import { HttpMethod, NextRef, PreviousRef, SelfRef } from "./AbstractService";
+
+/**
+ * Server-side abstract base class for services that interact with the JSON:API.
+ * Use this for server components and server actions.
+ */
+export abstract class ServerAbstractService {
+  /**
+   * Fetch the next page of results.
+   */
+  static async next<T>(params: {
+    type: ApiRequestDataTypeInterface;
+    endpoint: string;
+    next?: NextRef;
+    previous?: PreviousRef;
+    self?: SelfRef;
+  }): Promise<T> {
+    return await this.callApi<T>({
+      method: HttpMethod.GET,
+      type: params.type,
+      endpoint: params.endpoint,
+      next: params.next,
+      previous: params.previous,
+      self: params.self,
+    });
+  }
+
+  /**
+   * Fetch the previous page of results.
+   */
+  static async previous<T>(params: {
+    type: ApiRequestDataTypeInterface;
+    endpoint: string;
+    next?: NextRef;
+    previous?: PreviousRef;
+    self?: SelfRef;
+  }): Promise<T> {
+    return await this.callApi<T>({
+      method: HttpMethod.GET,
+      type: params.type,
+      endpoint: params.endpoint,
+      next: params.next,
+      previous: params.previous,
+      self: params.self,
+    });
+  }
+
+  /**
+   * Make a server-side API call.
+   */
+  protected static async callApi<T>(params: {
+    type: ApiRequestDataTypeInterface;
+    method: HttpMethod;
+    endpoint: string;
+    companyId?: string;
+    input?: any;
+    overridesJsonApiCreation?: boolean;
+    next?: NextRef;
+    previous?: PreviousRef;
+    self?: SelfRef;
+    responseType?: ApiRequestDataTypeInterface;
+    files?: { [key: string]: File | Blob } | File | Blob;
+  }): Promise<T> {
+    let apiResponse: ApiResponseInterface;
+
+    // Get language from next-intl server
+    const { getLocale } = await import("next-intl/server");
+    const language = (await getLocale()) ?? "en";
+
+    switch (params.method) {
+      case HttpMethod.GET:
+        apiResponse = await ServerJsonApiGet({
+          classKey: params.type,
+          endpoint: params.endpoint,
+          companyId: params.companyId,
+          language: language,
+        });
+        break;
+      case HttpMethod.POST:
+        apiResponse = await ServerJsonApiPost({
+          classKey: params.type,
+          endpoint: params.endpoint,
+          companyId: params.companyId,
+          body: params.input,
+          overridesJsonApiCreation: params.overridesJsonApiCreation,
+          language: language,
+          responseType: params.responseType,
+          files: params.files,
+        });
+        break;
+      case HttpMethod.PUT:
+        apiResponse = await ServerJsonApiPut({
+          classKey: params.type,
+          endpoint: params.endpoint,
+          companyId: params.companyId,
+          body: params.input,
+          language: language,
+          responseType: params.responseType,
+          files: params.files,
+        });
+        break;
+      case HttpMethod.PATCH:
+        apiResponse = await ServerJsonApiPatch({
+          classKey: params.type,
+          endpoint: params.endpoint,
+          companyId: params.companyId,
+          body: params.input,
+          overridesJsonApiCreation: params.overridesJsonApiCreation,
+          language: language,
+          responseType: params.responseType,
+          files: params.files,
+        });
+        break;
+      case HttpMethod.DELETE:
+        apiResponse = await ServerJsonApiDelete({
+          classKey: params.type,
+          endpoint: params.endpoint,
+          companyId: params.companyId,
+          language: language,
+          responseType: params.responseType,
+        });
+        break;
+      default:
+        throw new Error("Method not found");
+    }
+
+    if (!apiResponse.ok) {
+      const error = new Error(`${apiResponse.response}:${apiResponse.error}`) as any;
+      error.status = apiResponse.response;
+      error.digest = `HTTP_${apiResponse.response}`;
+      throw error;
+    }
+
+    if (apiResponse.next && params.next) params.next.next = apiResponse.next;
+    if (apiResponse.prev && params.previous) params.previous.previous = apiResponse.prev;
+    if (apiResponse.self && params.self) params.self.self = apiResponse.self;
+
+    return apiResponse.data as T;
+  }
+
+  /**
+   * Get raw JSON:API response data without deserialization.
+   */
+  protected static async getRawData(params: {
+    type: ApiRequestDataTypeInterface;
+    method: HttpMethod;
+    endpoint: string;
+    companyId?: string;
+  }): Promise<any> {
+    const { getLocale } = await import("next-intl/server");
+    const language = (await getLocale()) ?? "en";
+
+    const apiResponse: ApiResponseInterface = await ServerJsonApiGet({
+      classKey: params.type,
+      endpoint: params.endpoint,
+      companyId: params.companyId,
+      language: language,
+    });
+
+    if (!apiResponse.ok) {
+      const error = new Error(`${apiResponse.response}:${apiResponse.error}`) as any;
+      error.status = apiResponse.response;
+      error.digest = `HTTP_${apiResponse.response}`;
+      throw error;
+    }
+
+    return apiResponse.raw;
+  }
+}

package/src/core/abstracts/index.ts

@@ -1,2 +1,4 @@
 export * from "./AbstractApiData";
+// AbstractService is a base class needed by all services
 export * from "./AbstractService";
+export * from "./ClientAbstractService";

package/src/core/index.ts

@@ -1,7 +1,7 @@
-// Interfaces
+// Core interfaces
 export * from "./interfaces";
 
-// Abstracts (will be added)
+// Abstracts
 export * from "./abstracts";
 
 // Factories
@@ -16,5 +16,34 @@ export * from "./endpoint";
 // Field selectors
 export * from "./fields";
 
-// Utilities
+// Core utilities
 export * from "./utils";
+
+// Top-level interfaces (breadcrumb, d3)
+export * from "../interfaces";
+
+// Top-level utilities (cn, date-formatter, schemas, etc.)
+export * from "../utils";
+
+// Feature data classes, interfaces, and modules
+export * from "../features/auth/data";
+export * from "../features/auth/enums";
+export * from "../features/auth/auth.module";
+export * from "../features/company/data";
+export * from "../features/company/company.module";
+export * from "../features/content/data";
+export * from "../features/content/content.module";
+export * from "../features/feature/data";
+export * from "../features/feature/feature.module";
+export * from "../features/module";
+export * from "../features/notification/data";
+export * from "../features/notification/notification.module";
+export * from "../features/push/data";
+export * from "../features/push/push.module";
+export * from "../features/role/data";
+export * from "../features/role/role.module";
+export * from "../features/s3";
+export * from "../features/search";
+export * from "../features/user/data";
+export * from "../features/user/user.module";
+export * from "../features/user/author.module";

package/src/discord/config.ts

@@ -0,0 +1,15 @@
+let _useDiscord: boolean = false;
+let _useInternalAuth: boolean = true;
+
+export function configureDiscord(params: { useDiscord: boolean; useInternalAuth: boolean }): void {
+  _useDiscord = params.useDiscord;
+  _useInternalAuth = params.useInternalAuth;
+}
+
+export function isDiscordConfigured(): boolean {
+  return _useDiscord;
+}
+
+export function isInternalAuthConfigured(): boolean {
+  return _useInternalAuth;
+}

package/src/discord/index.ts

@@ -0,0 +1 @@
+export { configureDiscord, isDiscordConfigured, isInternalAuthConfigured } from "./config";

package/src/features/auth/components/details/LandingComponent.tsx

@@ -2,9 +2,9 @@
 
 import { useTranslations } from "next-intl";
 import Image from "next/image";
-import { isDiscordConfigured, isInternalAuthConfigured } from "../../../../roles";
+import { isDiscordConfigured, isInternalAuthConfigured } from "../../../../discord";
 import { Button, CardDescription, CardFooter, CardHeader, CardTitle, Link } from "../../../../shadcnui";
-import { getApiUrl } from "../../../../unified";
+import { getApiUrl } from "../../../../client/config";
 import { useAuthContext } from "../../contexts";
 import { AuthComponent } from "../../enums";
 

package/src/features/auth/components/forms/AcceptInvitation.tsx

@@ -10,7 +10,7 @@ import { z } from "zod";
 import { errorToast, FormPassword } from "../../../../components";
 import { Button, CardContent, CardDescription, CardHeader, CardTitle, Form } from "../../../../shadcnui";
 import { useAuthContext } from "../../contexts";
-import { AuthService } from "../../data";
+import { AuthService } from "../../data/auth.service";
 import { AuthComponent } from "../../enums";
 
 export function AcceptInvitation() {

package/src/features/auth/components/forms/ActivateAccount.tsx

@@ -7,7 +7,7 @@ import { toast } from "sonner";
 import { errorToast } from "../../../../components";
 import { CardContent, CardDescription, CardHeader, CardTitle } from "../../../../shadcnui";
 import { useAuthContext } from "../../contexts";
-import { AuthService } from "../../data";
+import { AuthService } from "../../data/auth.service";
 import { AuthComponent } from "../../enums";
 
 export function ActivateAccount() {

package/src/features/auth/components/forms/Cookies.tsx

@@ -5,7 +5,8 @@ import { JsonApiHydratedDataInterface, Modules, rehydrate } from "../../../../co
 import { useI18nRouter } from "../../../../i18n";
 import { UserInterface } from "../../../user";
 import { useCurrentUserContext } from "../../../user/contexts";
-import { AuthInterface, AuthService } from "../../data";
+import { AuthInterface } from "../../data";
+import { AuthService } from "../../data/auth.service";
 
 export function Cookies({ dehydratedAuth, page }: { dehydratedAuth: JsonApiHydratedDataInterface; page?: string }) {
   const { setUser } = useCurrentUserContext<UserInterface>();

package/src/features/auth/components/forms/ForgotPassword.tsx

@@ -18,7 +18,7 @@ import {
   Link,
 } from "../../../../shadcnui";
 import { useAuthContext } from "../../contexts";
-import { AuthService } from "../../data";
+import { AuthService } from "../../data/auth.service";
 import { AuthComponent } from "../../enums";
 
 export function ForgotPassword() {

package/src/features/auth/components/forms/Login.tsx

@@ -20,7 +20,7 @@ import {
 import { UserInterface } from "../../../user";
 import { useCurrentUserContext } from "../../../user/contexts";
 import { useAuthContext } from "../../contexts";
-import { AuthService } from "../../data";
+import { AuthService } from "../../data/auth.service";
 import { AuthComponent } from "../../enums";
 
 export function Login() {

package/src/features/auth/components/forms/Logout.tsx

@@ -2,7 +2,7 @@
 
 import { useEffect } from "react";
 import { usePageUrlGenerator } from "../../../../hooks";
-import { AuthService } from "../../data";
+import { AuthService } from "../../data/auth.service";
 
 export function Logout() {
   const generateUrl = usePageUrlGenerator();

package/src/features/auth/components/forms/RefreshUser.tsx

@@ -2,7 +2,8 @@
 
 import { deleteCookie, getCookie } from "cookies-next";
 import { useEffect } from "react";
-import { UserInterface, UserService } from "../../../user";
+import { UserInterface } from "../../../user";
+import { UserService } from "../../../user/data/user.service";
 import { useCurrentUserContext } from "../../../user/contexts";
 import { getTokenHandler } from "../../config";
 

package/src/features/auth/components/forms/Register.tsx

@@ -19,7 +19,7 @@ import {
   Link,
 } from "../../../../shadcnui";
 import { useAuthContext } from "../../contexts";
-import { AuthService } from "../../data";
+import { AuthService } from "../../data/auth.service";
 import { AuthComponent } from "../../enums";
 
 export default function Register() {

package/src/features/auth/components/forms/ResetPassword.tsx

@@ -10,7 +10,7 @@ import { z } from "zod";
 import { errorToast, FormPassword } from "../../../../components";
 import { Button, CardContent, CardDescription, CardHeader, CardTitle, Form } from "../../../../shadcnui";
 import { useAuthContext } from "../../contexts";
-import { AuthService } from "../../data";
+import { AuthService } from "../../data/auth.service";
 import { AuthComponent } from "../../enums";
 
 export function ResetPassword() {

package/src/features/auth/data/auth.service.ts

@@ -1,5 +1,5 @@
 import { AuthInput, AuthInterface } from ".";
-import { JsonApiDelete, JsonApiGet, JsonApiPost } from "../../../";
+import { JsonApiDelete, JsonApiGet, JsonApiPost } from "../../../unified";
 import {
   AbstractService,
   ApiResponseInterface,

package/src/features/auth/data/index.ts

@@ -1,3 +1,2 @@
 export * from "./auth";
 export * from "./auth.interface";
-export * from "./auth.service";

package/src/features/auth/utils/AuthCookies.ts

@@ -1,4 +1,4 @@
-"use server";
+// Server-only cookie utilities (consumers should provide their own server actions via configureAuth)
 
 import { cookies } from "next/headers";
 import zlib from "zlib";

package/src/features/company/components/forms/CompanyConfigurationEditor.tsx

@@ -23,9 +23,11 @@ import {
   TabsList,
   TabsTrigger,
 } from "../../../../shadcnui";
-import { UserInterface, UserService } from "../../../user";
+import { UserInterface } from "../../../user";
+import { UserService } from "../../../user/data/user.service";
 import { useCurrentUserContext } from "../../../user/contexts";
-import { CompanyInput, CompanyInterface, CompanyService } from "../../data";
+import { CompanyInput, CompanyInterface } from "../../data";
+import { CompanyService } from "../../data/company.service";
 import { CompanyConfigurationSecurityForm } from "./CompanyConfigurationSecurityForm";
 
 type CompanyConfigurationEditorProps = {

package/src/features/company/components/forms/CompanyDeleter.tsx

@@ -21,7 +21,8 @@ import {
 } from "../../../../shadcnui";
 import { UserInterface } from "../../../user";
 import { useCurrentUserContext } from "../../../user/contexts";
-import { CompanyInterface, CompanyService } from "../../data";
+import { CompanyInterface } from "../../data";
+import { CompanyService } from "../../data/company.service";
 
 type CompanyDeleterProps = {
   company: CompanyInterface;

package/src/features/company/components/forms/CompanyEditor.tsx

@@ -25,11 +25,14 @@ import { usePageUrlGenerator } from "../../../../hooks";
 import { useI18nRouter } from "../../../../i18n";
 import { getRoleId } from "../../../../roles";
 import { Dialog, DialogContent, Form, ScrollArea } from "../../../../shadcnui";
-import { FeatureInterface, FeatureService } from "../../../feature";
-import { S3Interface, S3Service } from "../../../s3";
+import { FeatureInterface } from "../../../feature";
+import { S3Interface } from "../../../s3";
+import { FeatureService } from "../../../feature/data/feature.service";
+import { S3Service } from "../../../s3/data/s3.service";
 import { UserInterface } from "../../../user";
 import { useCurrentUserContext } from "../../../user/contexts";
-import { CompanyInput, CompanyInterface, CompanyService } from "../../data";
+import { CompanyInput, CompanyInterface } from "../../data";
+import { CompanyService } from "../../data/company.service";
 
 type CompanyEditorProps = {
   company?: CompanyInterface;