@carlonicora/nextjs-jsonapi 0.0.1

package/dist/AbstractService-BKlpJA61.d.mts

@@ -0,0 +1,109 @@
+import { A as ApiDataInterface, J as JsonApiHydratedDataInterface } from './ApiDataInterface-DPP8s46n.mjs';
+import { A as ApiRequestDataTypeInterface } from './ApiRequestDataTypeInterface-CUKFDBx2.mjs';
+
+declare abstract class AbstractApiData implements ApiDataInterface {
+    protected _jsonApi?: any;
+    protected _included?: any[];
+    protected _id?: string;
+    protected _type?: string;
+    protected _createdAt?: Date;
+    protected _updatedAt?: Date;
+    protected _self?: string;
+    get type(): string;
+    get id(): string;
+    get self(): string | undefined;
+    get createdAt(): Date;
+    get updatedAt(): Date;
+    get included(): any[];
+    get jsonApi(): any;
+    ingestJsonApi(_data: JsonApiHydratedDataInterface): void;
+    generateApiUrl(_params?: any): string;
+    createJsonApi(_data?: any): any;
+    protected _readIncluded<T extends ApiDataInterface>(data: JsonApiHydratedDataInterface, type: string, dataType: ApiRequestDataTypeInterface): T | T[] | undefined;
+    dehydrate(): JsonApiHydratedDataInterface;
+    rehydrate(data: JsonApiHydratedDataInterface): this;
+}
+
+declare enum HttpMethod {
+    GET = "GET",
+    POST = "POST",
+    PUT = "PUT",
+    PATCH = "PATCH",
+    DELETE = "DELETE"
+}
+interface NextRef {
+    next?: string;
+}
+interface PreviousRef {
+    previous?: string;
+}
+interface SelfRef {
+    self?: string;
+}
+/**
+ * Set a global error handler for API errors (client-side only).
+ * This handler will be called instead of throwing errors.
+ */
+declare function setGlobalErrorHandler(handler: (status: number, message: string) => void): void;
+/**
+ * Get the current global error handler.
+ */
+declare function getGlobalErrorHandler(): ((status: number, message: string) => void) | null;
+/**
+ * Abstract base class for services that interact with the JSON:API.
+ * Extend this class to create feature-specific services.
+ */
+declare abstract class AbstractService {
+    /**
+     * 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;
+    static next<T>(params: {
+        type: ApiRequestDataTypeInterface;
+        endpoint: string;
+        next?: NextRef;
+        previous?: PreviousRef;
+        self?: SelfRef;
+    }): Promise<T>;
+    /**
+     * Fetch the previous page of results.
+     */
+    static previous<T>(params: {
+        type: ApiRequestDataTypeInterface;
+        endpoint: string;
+        next?: NextRef;
+        previous?: PreviousRef;
+        self?: SelfRef;
+    }): Promise<T>;
+    /**
+     * Make an API call with automatic environment detection and error handling.
+     */
+    protected static 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>;
+    /**
+     * Get raw JSON:API response data without deserialization.
+     */
+    protected static getRawData(params: {
+        type: ApiRequestDataTypeInterface;
+        method: HttpMethod;
+        endpoint: string;
+        companyId?: string;
+    }): Promise<any>;
+}
+
+export { AbstractApiData as A, HttpMethod as H, type NextRef as N, type PreviousRef as P, type SelfRef as S, AbstractService as a, getGlobalErrorHandler as g, setGlobalErrorHandler as s };

package/dist/AbstractService-D9eSVKNa.d.ts

@@ -0,0 +1,109 @@
+import { A as ApiDataInterface, J as JsonApiHydratedDataInterface } from './ApiDataInterface-DPP8s46n.js';
+import { A as ApiRequestDataTypeInterface } from './ApiRequestDataTypeInterface-CUKFDBx2.js';
+
+declare abstract class AbstractApiData implements ApiDataInterface {
+    protected _jsonApi?: any;
+    protected _included?: any[];
+    protected _id?: string;
+    protected _type?: string;
+    protected _createdAt?: Date;
+    protected _updatedAt?: Date;
+    protected _self?: string;
+    get type(): string;
+    get id(): string;
+    get self(): string | undefined;
+    get createdAt(): Date;
+    get updatedAt(): Date;
+    get included(): any[];
+    get jsonApi(): any;
+    ingestJsonApi(_data: JsonApiHydratedDataInterface): void;
+    generateApiUrl(_params?: any): string;
+    createJsonApi(_data?: any): any;
+    protected _readIncluded<T extends ApiDataInterface>(data: JsonApiHydratedDataInterface, type: string, dataType: ApiRequestDataTypeInterface): T | T[] | undefined;
+    dehydrate(): JsonApiHydratedDataInterface;
+    rehydrate(data: JsonApiHydratedDataInterface): this;
+}
+
+declare enum HttpMethod {
+    GET = "GET",
+    POST = "POST",
+    PUT = "PUT",
+    PATCH = "PATCH",
+    DELETE = "DELETE"
+}
+interface NextRef {
+    next?: string;
+}
+interface PreviousRef {
+    previous?: string;
+}
+interface SelfRef {
+    self?: string;
+}
+/**
+ * Set a global error handler for API errors (client-side only).
+ * This handler will be called instead of throwing errors.
+ */
+declare function setGlobalErrorHandler(handler: (status: number, message: string) => void): void;
+/**
+ * Get the current global error handler.
+ */
+declare function getGlobalErrorHandler(): ((status: number, message: string) => void) | null;
+/**
+ * Abstract base class for services that interact with the JSON:API.
+ * Extend this class to create feature-specific services.
+ */
+declare abstract class AbstractService {
+    /**
+     * 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;
+    static next<T>(params: {
+        type: ApiRequestDataTypeInterface;
+        endpoint: string;
+        next?: NextRef;
+        previous?: PreviousRef;
+        self?: SelfRef;
+    }): Promise<T>;
+    /**
+     * Fetch the previous page of results.
+     */
+    static previous<T>(params: {
+        type: ApiRequestDataTypeInterface;
+        endpoint: string;
+        next?: NextRef;
+        previous?: PreviousRef;
+        self?: SelfRef;
+    }): Promise<T>;
+    /**
+     * Make an API call with automatic environment detection and error handling.
+     */
+    protected static 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>;
+    /**
+     * Get raw JSON:API response data without deserialization.
+     */
+    protected static getRawData(params: {
+        type: ApiRequestDataTypeInterface;
+        method: HttpMethod;
+        endpoint: string;
+        companyId?: string;
+    }): Promise<any>;
+}
+
+export { AbstractApiData as A, HttpMethod as H, type NextRef as N, type PreviousRef as P, type SelfRef as S, AbstractService as a, getGlobalErrorHandler as g, setGlobalErrorHandler as s };

package/dist/ApiData-DPKNfY-9.d.mts

@@ -0,0 +1,10 @@
+type ApiData = {
+    data: any;
+    ok: boolean;
+    status: number;
+    statusText: string;
+    token?: string;
+    refreshToken?: string;
+};
+
+export type { ApiData as A };

package/dist/ApiData-DPKNfY-9.d.ts

@@ -0,0 +1,10 @@
+type ApiData = {
+    data: any;
+    ok: boolean;
+    status: number;
+    statusText: string;
+    token?: string;
+    refreshToken?: string;
+};
+
+export type { ApiData as A };

package/dist/ApiDataInterface-DPP8s46n.d.mts

@@ -0,0 +1,21 @@
+interface JsonApiHydratedDataInterface {
+    jsonApi: any;
+    included: any[];
+    allData?: any[];
+}
+
+interface ApiDataInterface {
+    get included(): any[];
+    get type(): string;
+    get id(): string;
+    get createdAt(): Date;
+    get updatedAt(): Date;
+    get self(): string | undefined;
+    get jsonApi(): any;
+    generateApiUrl(params?: any): string;
+    dehydrate(): JsonApiHydratedDataInterface;
+    rehydrate(data: JsonApiHydratedDataInterface): this;
+    createJsonApi(data: any): any;
+}
+
+export type { ApiDataInterface as A, JsonApiHydratedDataInterface as J };

package/dist/ApiDataInterface-DPP8s46n.d.ts

@@ -0,0 +1,21 @@
+interface JsonApiHydratedDataInterface {
+    jsonApi: any;
+    included: any[];
+    allData?: any[];
+}
+
+interface ApiDataInterface {
+    get included(): any[];
+    get type(): string;
+    get id(): string;
+    get createdAt(): Date;
+    get updatedAt(): Date;
+    get self(): string | undefined;
+    get jsonApi(): any;
+    generateApiUrl(params?: any): string;
+    dehydrate(): JsonApiHydratedDataInterface;
+    rehydrate(data: JsonApiHydratedDataInterface): this;
+    createJsonApi(data: any): any;
+}
+
+export type { ApiDataInterface as A, JsonApiHydratedDataInterface as J };

package/dist/ApiRequestDataTypeInterface-CUKFDBx2.d.mts

@@ -0,0 +1,20 @@
+type GetterKeys<T> = {
+    [K in keyof T]: T[K] extends () => any ? never : K;
+}[keyof T];
+type FieldSelector<T> = {
+    type: string;
+    fields: ReadonlyArray<GetterKeys<T>>;
+};
+declare function createJsonApiInclusion<T>(dataType: string, fields: ReadonlyArray<GetterKeys<T>>): FieldSelector<T>;
+
+type ApiRequestDataTypeInterface = {
+    name: string;
+    cache?: string;
+    inclusions?: Record<string, {
+        types?: string[];
+        fields?: FieldSelector<any>[];
+    }>;
+    model: new () => any;
+};
+
+export { type ApiRequestDataTypeInterface as A, type FieldSelector as F, type GetterKeys as G, createJsonApiInclusion as c };

package/dist/ApiRequestDataTypeInterface-CUKFDBx2.d.ts

@@ -0,0 +1,20 @@
+type GetterKeys<T> = {
+    [K in keyof T]: T[K] extends () => any ? never : K;
+}[keyof T];
+type FieldSelector<T> = {
+    type: string;
+    fields: ReadonlyArray<GetterKeys<T>>;
+};
+declare function createJsonApiInclusion<T>(dataType: string, fields: ReadonlyArray<GetterKeys<T>>): FieldSelector<T>;
+
+type ApiRequestDataTypeInterface = {
+    name: string;
+    cache?: string;
+    inclusions?: Record<string, {
+        types?: string[];
+        fields?: FieldSelector<any>[];
+    }>;
+    model: new () => any;
+};
+
+export { type ApiRequestDataTypeInterface as A, type FieldSelector as F, type GetterKeys as G, createJsonApiInclusion as c };

package/dist/ApiResponseInterface-BHN5D9r5.d.mts

@@ -0,0 +1,16 @@
+import { A as ApiDataInterface } from './ApiDataInterface-DPP8s46n.mjs';
+
+interface ApiResponseInterface {
+    ok: boolean;
+    response: number;
+    raw?: any;
+    self?: string;
+    next?: string;
+    prev?: string;
+    nextPage?: () => Promise<ApiResponseInterface>;
+    prevPage?: () => Promise<ApiResponseInterface>;
+    data: ApiDataInterface | ApiDataInterface[];
+    error: string;
+}
+
+export type { ApiResponseInterface as A };

package/dist/ApiResponseInterface-DDI7QQPR.d.ts

@@ -0,0 +1,16 @@
+import { A as ApiDataInterface } from './ApiDataInterface-DPP8s46n.js';
+
+interface ApiResponseInterface {
+    ok: boolean;
+    response: number;
+    raw?: any;
+    self?: string;
+    next?: string;
+    prev?: string;
+    nextPage?: () => Promise<ApiResponseInterface>;
+    prevPage?: () => Promise<ApiResponseInterface>;
+    data: ApiDataInterface | ApiDataInterface[];
+    error: string;
+}
+
+export type { ApiResponseInterface as A };