@carlonicora/nextjs-jsonapi 6.20.5 → 6.21.0

package/dist/core/abstracts/AbstractService.d.ts

@@ -0,0 +1,119 @@
+import { ApiRequestDataTypeInterface } from "../interfaces/ApiRequestDataTypeInterface";
+export declare enum HttpMethod {
+    GET = "GET",
+    POST = "POST",
+    PUT = "PUT",
+    PATCH = "PATCH",
+    DELETE = "DELETE"
+}
+export interface NextRef {
+    next?: string;
+}
+export interface PreviousRef {
+    previous?: string;
+}
+export interface SelfRef {
+    self?: string;
+}
+export interface TotalRef {
+    total?: number;
+}
+export { clearLastApiMeta, clearLastApiTotal, getLastApiMeta, getLastApiTotal } from "./lastApiResponse";
+/**
+ * Set a global error handler for API errors (client-side only).
+ * This handler will be called instead of throwing errors.
+ */
+export declare function setGlobalErrorHandler(handler: (status: number, message: string) => void): void;
+/**
+ * Get the current global error handler.
+ */
+export 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.
+ */
+export declare abstract class AbstractService {
+    /**
+     * Extract locale from client-side URL pathname
+     * URL structure: /{locale}/route-path (e.g., /it/accounts)
+     * Fallback chain: URL locale → the app's default locale (first supported locale)
+     */
+    private static getClientLocale;
+    static next<T>(params: {
+        type: ApiRequestDataTypeInterface;
+        endpoint: string;
+        next?: NextRef;
+        previous?: PreviousRef;
+        self?: SelfRef;
+        total?: TotalRef;
+    }): Promise<T>;
+    /**
+     * Fetch the previous page of results.
+     */
+    static previous<T>(params: {
+        type: ApiRequestDataTypeInterface;
+        endpoint: string;
+        next?: NextRef;
+        previous?: PreviousRef;
+        self?: SelfRef;
+        total?: TotalRef;
+    }): 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;
+        total?: TotalRef;
+        responseType?: ApiRequestDataTypeInterface;
+        files?: {
+            [key: string]: File | Blob;
+        } | File | Blob;
+        token?: string;
+        suppressGlobalError?: boolean;
+        /**
+         * Per-call override of the API base URL. When omitted, the existing global
+         * `NEXT_PUBLIC_API_URL` (or `configureJsonApi({ apiUrl })`) resolution is used —
+         * fully backward compatible. Ignored when `endpoint` starts with "http" (passthrough).
+         */
+        baseUrl?: string;
+    }): Promise<T>;
+    /**
+     * Make an API call and return both data and meta from the response.
+     */
+    protected static callApiWithMeta<T>(params: {
+        type: ApiRequestDataTypeInterface;
+        method: HttpMethod;
+        endpoint: string;
+        companyId?: string;
+        input?: any;
+        overridesJsonApiCreation?: boolean;
+        responseType?: ApiRequestDataTypeInterface;
+        files?: {
+            [key: string]: File | Blob;
+        } | File | Blob;
+        suppressGlobalError?: boolean;
+    }): Promise<{
+        data: T;
+        meta?: Record<string, any>;
+    }>;
+    /**
+     * Get raw JSON:API response data without deserialization.
+     */
+    protected static getRawData(params: {
+        type: ApiRequestDataTypeInterface;
+        method: HttpMethod;
+        endpoint: string;
+        companyId?: string;
+        baseUrl?: string;
+        suppressGlobalError?: boolean;
+    }): Promise<any>;
+}
+//# sourceMappingURL=AbstractService.d.ts.map

package/dist/core/abstracts/AbstractService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbstractService.d.ts","sourceRoot":"","sources":["../../../src/core/abstracts/AbstractService.ts"],"names":[],"mappings":"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"}

package/dist/core/abstracts/ClientAbstractService.d.ts

@@ -0,0 +1,97 @@
+import { ApiRequestDataTypeInterface } from "../interfaces/ApiRequestDataTypeInterface";
+export declare 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;
+}
+export interface ClientTotalRef {
+    total?: number;
+}
+/**
+ * Set a global error handler for API errors (client-side only).
+ * This handler will be called instead of throwing errors.
+ */
+export declare function setClientGlobalErrorHandler(handler: (status: number, message: string) => void): void;
+/**
+ * Get the current global error handler.
+ */
+export declare function getClientGlobalErrorHandler(): ((status: number, message: string) => void) | null;
+/**
+ * Client-side abstract base class for services that interact with the JSON:API.
+ * Use this for client components.
+ */
+export declare abstract class ClientAbstractService {
+    /**
+     * Extract locale from client-side URL pathname
+     * URL structure: /{locale}/route-path (e.g., /it/accounts)
+     * Fallback chain: URL locale → the app's default locale (first supported locale)
+     */
+    private static getClientLocale;
+    /**
+     * Fetch the next page of results.
+     */
+    static next<T>(params: {
+        type: ApiRequestDataTypeInterface;
+        endpoint: string;
+        next?: ClientNextRef;
+        previous?: ClientPreviousRef;
+        self?: ClientSelfRef;
+        total?: ClientTotalRef;
+    }): Promise<T>;
+    /**
+     * Fetch the previous page of results.
+     */
+    static previous<T>(params: {
+        type: ApiRequestDataTypeInterface;
+        endpoint: string;
+        next?: ClientNextRef;
+        previous?: ClientPreviousRef;
+        self?: ClientSelfRef;
+        total?: ClientTotalRef;
+    }): Promise<T>;
+    /**
+     * Make a client-side API call.
+     */
+    protected static callApi<T>(params: {
+        type: ApiRequestDataTypeInterface;
+        method: ClientHttpMethod;
+        endpoint: string;
+        companyId?: string;
+        input?: any;
+        overridesJsonApiCreation?: boolean;
+        next?: ClientNextRef;
+        previous?: ClientPreviousRef;
+        self?: ClientSelfRef;
+        total?: ClientTotalRef;
+        responseType?: ApiRequestDataTypeInterface;
+        files?: {
+            [key: string]: File | Blob;
+        } | File | Blob;
+        /**
+         * Per-call override of the API base URL (mirrors `AbstractService.callApi`'s `baseUrl`).
+         * Omitted => existing global `NEXT_PUBLIC_API_URL` resolution, unchanged.
+         */
+        baseUrl?: string;
+    }): Promise<T>;
+    /**
+     * Get raw JSON:API response data without deserialization.
+     */
+    protected static getRawData(params: {
+        type: ApiRequestDataTypeInterface;
+        method: ClientHttpMethod;
+        endpoint: string;
+        companyId?: string;
+    }): Promise<any>;
+}
+//# sourceMappingURL=ClientAbstractService.d.ts.map

package/dist/core/abstracts/ClientAbstractService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClientAbstractService.d.ts","sourceRoot":"","sources":["../../../src/core/abstracts/ClientAbstractService.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AAaxF,oBAAY,gBAAgB;IAC1B,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,KAAK,UAAU;IACf,MAAM,WAAW;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,QAE7F;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,IAAI,CAEhG;AAED;;;GAGG;AACH,8BAAsB,qBAAqB;IACzC;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAmB9B;;OAEG;WACU,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE;QAC3B,IAAI,EAAE,2BAA2B,CAAC;QAClC,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,aAAa,CAAC;QACrB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;QAC7B,IAAI,CAAC,EAAE,aAAa,CAAC;QACrB,KAAK,CAAC,EAAE,cAAc,CAAC;KACxB,GAAG,OAAO,CAAC,CAAC,CAAC;IAYd;;OAEG;WACU,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE;QAC/B,IAAI,EAAE,2BAA2B,CAAC;QAClC,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,aAAa,CAAC;QACrB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;QAC7B,IAAI,CAAC,EAAE,aAAa,CAAC;QACrB,KAAK,CAAC,EAAE,cAAc,CAAC;KACxB,GAAG,OAAO,CAAC,CAAC,CAAC;IAYd;;OAEG;qBACoB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE;QACxC,IAAI,EAAE,2BAA2B,CAAC;QAClC,MAAM,EAAE,gBAAgB,CAAC;QACzB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,GAAG,CAAC;QACZ,wBAAwB,CAAC,EAAE,OAAO,CAAC;QACnC,IAAI,CAAC,EAAE,aAAa,CAAC;QACrB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;QAC7B,IAAI,CAAC,EAAE,aAAa,CAAC;QACrB,KAAK,CAAC,EAAE,cAAc,CAAC;QACvB,YAAY,CAAC,EAAE,2BAA2B,CAAC;QAC3C,KAAK,CAAC,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAA;SAAE,GAAG,IAAI,GAAG,IAAI,CAAC;QACrD;;;WAGG;QACH,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,CAAC,CAAC;IA6Fd;;OAEG;qBACoB,UAAU,CAAC,MAAM,EAAE;QACxC,IAAI,EAAE,2BAA2B,CAAC;QAClC,MAAM,EAAE,gBAAgB,CAAC;QACzB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,GAAG,CAAC;CAyBjB"}

package/dist/core/abstracts/ServerAbstractService.d.ts

@@ -0,0 +1,56 @@
+import { ApiRequestDataTypeInterface } from "../interfaces/ApiRequestDataTypeInterface";
+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 declare abstract class ServerAbstractService {
+    /**
+     * Fetch the next page of results.
+     */
+    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 a server-side API call.
+     */
+    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>;
+}
+//# sourceMappingURL=ServerAbstractService.d.ts.map

package/dist/core/abstracts/ServerAbstractService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServerAbstractService.d.ts","sourceRoot":"","sources":["../../../src/core/abstracts/ServerAbstractService.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AASxF,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE9E;;;GAGG;AACH,8BAAsB,qBAAqB;IACzC;;OAEG;WACU,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE;QAC3B,IAAI,EAAE,2BAA2B,CAAC;QAClC,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,QAAQ,CAAC,EAAE,WAAW,CAAC;QACvB,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB,GAAG,OAAO,CAAC,CAAC,CAAC;IAWd;;OAEG;WACU,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE;QAC/B,IAAI,EAAE,2BAA2B,CAAC;QAClC,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,QAAQ,CAAC,EAAE,WAAW,CAAC;QACvB,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB,GAAG,OAAO,CAAC,CAAC,CAAC;IAWd;;OAEG;qBACoB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE;QACxC,IAAI,EAAE,2BAA2B,CAAC;QAClC,MAAM,EAAE,UAAU,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,GAAG,CAAC;QACZ,wBAAwB,CAAC,EAAE,OAAO,CAAC;QACnC,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,QAAQ,CAAC,EAAE,WAAW,CAAC;QACvB,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,YAAY,CAAC,EAAE,2BAA2B,CAAC;QAC3C,KAAK,CAAC,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAA;SAAE,GAAG,IAAI,GAAG,IAAI,CAAC;KACtD,GAAG,OAAO,CAAC,CAAC,CAAC;IA8Ed;;OAEG;qBACoB,UAAU,CAAC,MAAM,EAAE;QACxC,IAAI,EAAE,2BAA2B,CAAC;QAClC,MAAM,EAAE,UAAU,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,GAAG,CAAC;CAoBjB"}

package/dist/core/abstracts/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./AbstractApiData";
+export * from "./AbstractService";
+export * from "./ClientAbstractService";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/abstracts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/abstracts/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAElC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC"}

package/dist/core/abstracts/lastApiResponse.d.ts

@@ -0,0 +1,7 @@
+/** Record the top-level `meta` of the response that just completed. */
+export declare function setLastApiResponse(meta: Record<string, any> | undefined): void;
+export declare function getLastApiTotal(): number | undefined;
+export declare function clearLastApiTotal(): void;
+export declare function getLastApiMeta(): Record<string, any> | undefined;
+export declare function clearLastApiMeta(): void;
+//# sourceMappingURL=lastApiResponse.d.ts.map

package/dist/core/abstracts/lastApiResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lastApiResponse.d.ts","sourceRoot":"","sources":["../../../src/core/abstracts/lastApiResponse.ts"],"names":[],"mappings":"AAgBA,uEAAuE;AACvE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GAAG,IAAI,CAG9E;AAED,wBAAgB,eAAe,IAAI,MAAM,GAAG,SAAS,CAEpD;AAED,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED,wBAAgB,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,CAEhE;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}

package/dist/core/endpoint/EndpointCreator.d.ts

@@ -0,0 +1,38 @@
+import { FieldSelector } from "../fields/FieldSelector";
+import { ApiRequestDataTypeInterface } from "../interfaces/ApiRequestDataTypeInterface";
+export type EndpointQuery = {
+    endpoint: ApiRequestDataTypeInterface | string;
+    id?: string;
+    childEndpoint?: ApiRequestDataTypeInterface | string;
+    childId?: string;
+    additionalParams?: {
+        key: string;
+        value: string | string[];
+    }[];
+};
+export declare class EndpointCreator {
+    private _endpoint;
+    constructor(params: {
+        endpoint: ApiRequestDataTypeInterface | string;
+        id?: string;
+        childEndpoint?: ApiRequestDataTypeInterface | string;
+        childId?: string;
+        additionalParams?: {
+            key: string;
+            value: string;
+        }[];
+    });
+    endpoint(value: ApiRequestDataTypeInterface | string): EndpointCreator;
+    id(value: string): EndpointCreator;
+    childEndpoint(value: ApiRequestDataTypeInterface | string): EndpointCreator;
+    childId(value: string): EndpointCreator;
+    set additionalParams(value: {
+        key: string;
+        value: string;
+    }[]);
+    addAdditionalParam(key: string, value: string | string[]): EndpointCreator;
+    limitToType(selectors: string[]): this;
+    limitToFields(selectors: FieldSelector<any>[]): this;
+    generate(): string;
+}
+//# sourceMappingURL=EndpointCreator.d.ts.map

package/dist/core/endpoint/EndpointCreator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EndpointCreator.d.ts","sourceRoot":"","sources":["../../../src/core/endpoint/EndpointCreator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AAExF,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,2BAA2B,GAAG,MAAM,CAAC;IAC/C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,aAAa,CAAC,EAAE,2BAA2B,GAAG,MAAM,CAAC;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;CAChE,CAAC;AAEF,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAAgB;gBAErB,MAAM,EAAE;QAClB,QAAQ,EAAE,2BAA2B,GAAG,MAAM,CAAC;QAC/C,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,aAAa,CAAC,EAAE,2BAA2B,GAAG,MAAM,CAAC;QACrD,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,gBAAgB,CAAC,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;KACrD;IAUD,QAAQ,CAAC,KAAK,EAAE,2BAA2B,GAAG,MAAM,GAAG,eAAe;IAKtE,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe;IAKlC,aAAa,CAAC,KAAK,EAAE,2BAA2B,GAAG,MAAM,GAAG,eAAe;IAK3E,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe;IAKvC,IAAI,gBAAgB,CAAC,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,EAE3D;IAED,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,eAAe;IAM1E,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAKtC,aAAa,CAAC,SAAS,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI;IAWpD,QAAQ,IAAI,MAAM;CAuBnB"}

package/dist/core/endpoint/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./EndpointCreator";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/endpoint/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/endpoint/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/dist/core/env.d.ts

@@ -0,0 +1,58 @@
+/**
+ * The single place in this package that reads `process.env`.
+ *
+ * Everything else imports {@link ENV}. Centralising the reads keeps every
+ * default in one place — the same contract `base.config.ts` provides on the
+ * NestJS side — instead of scattering `process.env.X || "…"` across hooks,
+ * clients and components where the fallbacks silently drift apart.
+ *
+ * WHY THE READS MUST STAY LITERAL: Next.js inlines `NEXT_PUBLIC_*` by textual
+ * substitution at build time, replacing the exact expression
+ * `process.env.NEXT_PUBLIC_FOO` with a string literal. A computed lookup
+ * (`process.env[key]`) is NOT substituted and reads as `undefined` in the
+ * browser bundle. Every entry below therefore spells its variable out in full,
+ * and new entries must do the same.
+ *
+ * WHY GETTERS AND NOT PLAIN PROPERTIES: every call site this replaced read
+ * `process.env` at CALL time, not at import time. A plain property would freeze
+ * the value when the module is first imported, which breaks any consumer that
+ * assigns the variable after boot — the package's own tests do exactly that.
+ * Getters keep the read lazy while leaving the expression literal, so the build
+ * time substitution still applies.
+ *
+ * Because that substitution happens before the code runs, no reference to
+ * `process` survives into the client bundle — so this module is safe to import
+ * from client components, server components, route handlers and middleware
+ * alike. It deliberately carries no `"use client"` directive for that reason.
+ *
+ * Values are normalised (empty string rather than `undefined`, booleans rather
+ * than string comparisons) so callers never repeat the parsing. Callers that
+ * must distinguish "unset" from "set to empty" — the URL getters, which throw a
+ * configuration error — check for an empty string.
+ */
+export declare const ENV: {
+    /** Public API base URL (NEXT_PUBLIC_API_URL). Empty when unset. */
+    readonly API_URL: string;
+    /** Public app base URL (NEXT_PUBLIC_ADDRESS). Empty when unset. */
+    readonly APP_URL: string;
+    /**
+     * Alternative app base URL (NEXT_PUBLIC_APP_URL), used only by
+     * `client/config.ts`'s `getAppUrl()` before it falls back to
+     * `window.location.origin`. Empty when unset.
+     */
+    readonly APP_URL_ALTERNATE: string;
+    /** Web-push VAPID public key (NEXT_PUBLIC_VAPID_PUBLIC_KEY). Empty when unset. */
+    readonly VAPID_PUBLIC_KEY: string;
+    /** Google Maps JS key (NEXT_PUBLIC_GOOGLE_MAPS_API_KEY). Empty disables autocomplete. */
+    readonly GOOGLE_MAPS_API_KEY: string;
+    /**
+     * NEXT_PUBLIC_PRIVATE_INSTALLATION === "true", case-insensitively
+     * (default false). A private installation is a single-tenant deployment.
+     */
+    readonly PRIVATE_INSTALLATION: boolean;
+    /** NODE_ENV === "production" — set by the Next build, not by `.env`. */
+    readonly IS_PRODUCTION: boolean;
+    /** NODE_ENV === "development" — gates verbose client-side diagnostics. */
+    readonly IS_DEVELOPMENT: boolean;
+};
+//# sourceMappingURL=env.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/core/env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,GAAG;IACd,mEAAmE;sBACpD,MAAM;IAGrB,mEAAmE;sBACpD,MAAM;IAGrB;;;;OAIG;gCACsB,MAAM;IAG/B,kFAAkF;+BAC1D,MAAM;IAG9B,yFAAyF;kCAC9D,MAAM;IAGjC;;;OAGG;mCACyB,OAAO;IAGnC,wEAAwE;4BACnD,OAAO;IAG5B,0EAA0E;6BACpD,OAAO;CAG9B,CAAC"}

package/dist/core/factories/JsonApiDataFactory.d.ts

@@ -0,0 +1,5 @@
+import { ApiRequestDataTypeInterface } from "../interfaces/ApiRequestDataTypeInterface";
+export declare class JsonApiDataFactory {
+    static create(classKey: ApiRequestDataTypeInterface, data: any): any;
+}
+//# sourceMappingURL=JsonApiDataFactory.d.ts.map

package/dist/core/factories/JsonApiDataFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonApiDataFactory.d.ts","sourceRoot":"","sources":["../../../src/core/factories/JsonApiDataFactory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AAGxF,qBAAa,kBAAkB;WACf,MAAM,CAAC,QAAQ,EAAE,2BAA2B,EAAE,IAAI,EAAE,GAAG,GAAG,GAAG;CAO5E"}

package/dist/core/factories/RehydrationFactory.d.ts

@@ -0,0 +1,8 @@
+import { ApiDataInterface } from "../interfaces/ApiDataInterface";
+import { ApiRequestDataTypeInterface } from "../interfaces/ApiRequestDataTypeInterface";
+import { JsonApiHydratedDataInterface } from "../interfaces/JsonApiHydratedDataInterface";
+export declare class RehydrationFactory {
+    static rehydrate<T extends ApiDataInterface>(classKey: ApiRequestDataTypeInterface, data: JsonApiHydratedDataInterface): T;
+    static rehydrateList<T extends ApiDataInterface>(classKey: ApiRequestDataTypeInterface, data: JsonApiHydratedDataInterface[]): T[];
+}
+//# sourceMappingURL=RehydrationFactory.d.ts.map

package/dist/core/factories/RehydrationFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RehydrationFactory.d.ts","sourceRoot":"","sources":["../../../src/core/factories/RehydrationFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AACxF,OAAO,EAAE,4BAA4B,EAAE,MAAM,4CAA4C,CAAC;AAmE1F,qBAAa,kBAAkB;WACf,SAAS,CAAC,CAAC,SAAS,gBAAgB,EAChD,QAAQ,EAAE,2BAA2B,EACrC,IAAI,EAAE,4BAA4B,GACjC,CAAC;WAMU,aAAa,CAAC,CAAC,SAAS,gBAAgB,EACpD,QAAQ,EAAE,2BAA2B,EACrC,IAAI,EAAE,4BAA4B,EAAE,GACnC,CAAC,EAAE;CASP"}

package/dist/core/factories/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./JsonApiDataFactory";
+export * from "./RehydrationFactory";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/factories/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/factories/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC"}

package/dist/core/fields/FieldSelector.d.ts

@@ -0,0 +1,9 @@
+export type GetterKeys<T> = {
+    [K in keyof T]: T[K] extends () => any ? never : K;
+}[keyof T];
+export type FieldSelector<T> = {
+    type: string;
+    fields: ReadonlyArray<GetterKeys<T>>;
+};
+export declare function createJsonApiInclusion<T>(dataType: string, fields: ReadonlyArray<GetterKeys<T>>): FieldSelector<T>;
+//# sourceMappingURL=FieldSelector.d.ts.map

package/dist/core/fields/FieldSelector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldSelector.d.ts","sourceRoot":"","sources":["../../../src/core/fields/FieldSelector.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI;KACzB,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,GAAG,KAAK,GAAG,CAAC;CACnD,CAAC,MAAM,CAAC,CAAC,CAAC;AAEX,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;CACtC,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAKlH"}

package/dist/core/fields/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./FieldSelector";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/fields/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/fields/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}