@econneq/utility-functions 1.0.0

package/README.md

@@ -0,0 +1,22 @@
+# @econneq/gql-auth
+![NPM Version](https://img.shields.io/npm/v/@econneq/utilility-functions)
+
+A high-performance, multi-tenant GraphQL abstraction layer designed for **Next.js (App Router)** and **Apollo Client**. 
+
+This package standardizes how frontend projects interact with a Django GraphQL backend, handling tenant detection, SSR cookie forwarding, and multipart file uploads.
+
+---
+
+## ✨ Features
+
+* 🌍 **Automatic Tenant Injection**: Detects subdomains and injects `X-Tenant-ID`, `X-Process-ID`, and `X-Widget-ID` headers.
+* 🔐 **SSR Ready**: Built-in support for `next/headers` to forward authentication cookies during Server-Side Rendering.
+* 📁 **Smart File Uploads**: Simplifies `multipart/form-data` logic for GraphQL mutations.
+* 🚀 **Lightweight**: Optimized to use peer dependencies, keeping your bundle size minimal.
+
+---
+
+## 📦 Installation
+
+```bash
+npm install @econneq/gql-auth

package/dist/api-factory.d.ts

@@ -0,0 +1,30 @@
+type SubmitOptions = {
+    newData: any;
+    editData?: any;
+    mutationName: string;
+    modelName: string;
+    successField?: string;
+    query: any;
+    params: any;
+    router: any;
+    token?: string;
+    config: {
+        protocol: string;
+        RootApi: string;
+        Subdomains: any[];
+    };
+    onAlert: (options: {
+        title: string;
+        status: boolean;
+        duration: number;
+    }) => void;
+    redirect?: boolean;
+    redirectPath?: string;
+    returnResponseField?: boolean;
+    returnResponseObject?: boolean;
+    reload?: boolean;
+    getFileMap?: (item: any) => Record<string, File>;
+};
+export declare const ApiFactory: (options: SubmitOptions) => Promise<any>;
+export {};
+//# sourceMappingURL=api-factory.d.ts.map

package/dist/api-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-factory.d.ts","sourceRoot":"","sources":["../src/api-factory.ts"],"names":[],"mappings":"AAIA,KAAK,aAAa,GAAG;IACnB,OAAO,EAAE,GAAG,CAAC;IACb,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,GAAG,CAAC;IACX,MAAM,EAAE,GAAG,CAAC;IACZ,MAAM,EAAE,GAAG,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE;QACN,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,GAAG,EAAE,CAAC;KACnB,CAAC;IACF,OAAO,EAAE,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACjF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;CAClD,CAAC;AAEF,eAAO,MAAM,UAAU,GAAU,SAAS,aAAa,iBA0DtD,CAAC"}

package/dist/api-factory.js

@@ -0,0 +1,68 @@
+import { uploadGraphQLMutation } from "./upload-gql";
+import { removeEmptyFields } from "./utilsGeneral";
+export const ApiFactory = async (options) => {
+    const { newData, editData, mutationName, modelName, successField = "title", query, router, params, reload = true, redirect, redirectPath, returnResponseField = false, returnResponseObject = false, getFileMap, token, config, onAlert } = options;
+    const items = Array.isArray(newData || editData) ? (newData || editData) : [(newData || editData)];
+    const successMessages = [];
+    const errorMessages = [];
+    let responseFieldData = null;
+    for (const res of items) {
+        try {
+            console.log("launching e-conneq/auth-gql ......");
+            const response = await uploadGraphQLMutation({
+                query: query.loc?.source.body || "",
+                variables: removeEmptyFields(res),
+                fileMap: getFileMap ? getFileMap(res) : {},
+                params, // Pass domain params for multi-tenancy
+                token,
+                config, // Pass global URLs and Subdomain list
+            });
+            console.log("response e-conneq/auth-gql ......");
+            const result = response?.data?.[mutationName]?.[modelName];
+            if (response?.data?.[mutationName]) {
+                successMessages.push(result?.[successField] || "operation successful ✅");
+                if (returnResponseObject)
+                    responseFieldData = response.data[mutationName];
+                if (result?.id && returnResponseField)
+                    responseFieldData = result[successField];
+                if (result?.id || result?.token || result === null) {
+                }
+            }
+            // Error Handling
+            if (response?.errors) {
+                handleGraphQLErrors(response.errors, errorMessages);
+            }
+        }
+        catch (err) {
+            errorMessages.push(`Error: ${err.message}`);
+        }
+    }
+    // Handle Response/UI Logic
+    if (successMessages.length > 0 && errorMessages.length === 0) {
+        if (returnResponseObject || returnResponseField)
+            return responseFieldData;
+        onAlert({ title: "successfully submitted ✅", status: true, duration: 3000 });
+        if (redirect && redirectPath)
+            router.push(redirectPath);
+        else if (reload)
+            window.location.reload();
+    }
+    else if (errorMessages.length > 0) {
+        onAlert({
+            title: `❌ Errors:\n${errorMessages.join("\n")}`,
+            status: false,
+            duration: 5000
+        });
+    }
+};
+// Internal Helper for Error Parsing
+const handleGraphQLErrors = (errors, errorList) => {
+    errors.forEach(error => {
+        if (error.message.includes("duplicate"))
+            errorList.push("Record Already Exists ❌");
+        else if (error.message.includes("Authentication"))
+            errorList.push("Login Required ❌");
+        else
+            errorList.push(error.message);
+    });
+};

package/dist/client.d.ts

@@ -0,0 +1,15 @@
+import { ApolloClient } from '@apollo/client';
+export default function getApolloClient(options?: {
+    csrfToken?: string;
+    cookie?: string;
+}, domain?: string | null, config?: {
+    protocol: string;
+    RootApi: string;
+    Subdomains: {
+        subdomain: string;
+        processId?: string;
+        widgetID?: string;
+    }[];
+    apiKey: string;
+}): Promise<ApolloClient | null>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAA2B,MAAM,gBAAgB,CAAC;AAGvE,wBAA8B,eAAe,CAC3C,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EACjD,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,EACtB,MAAM,CAAC,EAAE;IACP,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC3E,MAAM,EAAE,MAAM,CAAC;CAChB,GACA,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAgD9B"}

package/dist/client.js

@@ -0,0 +1,44 @@
+// src/client.ts
+import { ApolloClient, InMemoryCache, HttpLink } from '@apollo/client';
+import Cookies from "js-cookie";
+export default async function getApolloClient(options, domain, config) {
+    if (!config)
+        throw new Error("Configuration is required for getApolloClient");
+    const isServer = typeof window === "undefined";
+    const { protocol, RootApi, Subdomains, apiKey } = config;
+    // 1. Find Tenant Data
+    const tenant = domain
+        ? Subdomains.find((s) => s.subdomain.toLowerCase() === domain.toLowerCase())
+        : null;
+    const baseUrl = `${protocol + RootApi}`;
+    const uri = `${baseUrl}/graphql/`;
+    const csrfToken = options?.csrfToken || (!isServer ? Cookies.get("csrftoken") : "");
+    const dynamicHost = domain
+        ? `${domain}.${RootApi}`
+        : RootApi;
+    const headers = {
+        'Content-Type': 'application/json',
+        'X-API-KEY': apiKey,
+        ...(options?.cookie && { 'Cookie': options.cookie }),
+        ...(csrfToken && { 'X-CSRFToken': csrfToken }),
+        ...(tenant && {
+            'X-Tenant-ID': tenant.subdomain,
+            'X-Process-ID': tenant?.processId || "",
+            'X-Widget-ID': tenant?.widgetID || "",
+        }),
+        'Referer': baseUrl,
+        'Host': isServer ? dynamicHost : window.location.host,
+    };
+    return new ApolloClient({
+        link: new HttpLink({
+            uri,
+            fetch, // Next.js polyfills fetch on server automatically
+            headers,
+        }),
+        cache: new InMemoryCache(),
+        defaultOptions: {
+            mutate: { fetchPolicy: 'no-cache' },
+            query: { fetchPolicy: 'no-cache' },
+        },
+    });
+}

package/dist/index.d.ts

@@ -0,0 +1,67 @@
+import { ReactNode } from "react";
+export type ApolloOptions = {
+    csrfToken?: string;
+    cookie?: string;
+};
+export type SelectOptions = string | {
+    label: string;
+    value: string | number;
+};
+export interface InterLoginData {
+    username: string;
+    password: string;
+    parent?: boolean;
+}
+export interface JwtPayload {
+    iss?: string;
+    sub?: string;
+    aud?: string[] | string;
+    exp: number;
+    nbf?: number;
+    iat?: number;
+    jti?: string;
+    user_id?: number;
+    username?: string;
+    matricle?: string;
+    photo?: string;
+    is_superuser?: boolean;
+    is_staff?: boolean;
+    is_active?: boolean;
+    is_hod?: boolean;
+    role?: string;
+    dept?: string[] | any;
+    page?: string[] | any;
+    school?: number[] | any;
+    domain?: number[] | any;
+    language?: string[];
+    last_login?: any;
+}
+export interface InterField {
+    name: string;
+    label: string;
+    inputType: 'text' | "textarea" | 'number' | 'float' | 'search-select' | 'select' | 'file' | 'date' | 'password';
+    type: 'text' | 'textarea' | 'number' | 'float' | 'email' | 'date' | 'file' | 'password';
+    required?: boolean;
+    min?: number;
+    max?: number;
+    message?: string;
+    options?: {
+        value: string | number;
+        label: string;
+    }[];
+    show?: boolean;
+    sort?: boolean;
+    placeholder?: string;
+    acceptedFileType?: string;
+    icon?: ReactNode;
+    labelIcon?: ReactNode;
+}
+export interface InterFieldList {
+    rowId: number | string;
+    desktopCols: 1 | 2 | 3 | 4;
+    mobileCols: 1 | 2;
+    fields: InterField[];
+}
+export { capitalizeEachWord, errorLog, getToken, getUser, logout, getStoredFont, getTimeAgo, getLanguage, getTemplate, decodeUrlID, removeEmptyFields, Alert, validateFormFields, lastYears, formatText, } from './utilsGeneral.js';
+export { getProfile, getClass, getClassName, getLevel, getAcademicYear, getAcademicYearStudent } from './utilsSchool.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,2 @@
+export { capitalizeEachWord, errorLog, getToken, getUser, logout, getStoredFont, getTimeAgo, getLanguage, getTemplate, decodeUrlID, removeEmptyFields, Alert, validateFormFields, lastYears, formatText, } from './utilsGeneral.js';
+export { getProfile, getClass, getClassName, getLevel, getAcademicYear, getAcademicYearStudent } from './utilsSchool.js';

package/dist/query-server.d.ts

@@ -0,0 +1,14 @@
+type ServerQueryArgs = {
+    query: any;
+    variables?: Record<string, any>;
+    domain?: string | null;
+    config: {
+        protocol: string;
+        RootApi: string;
+        Subdomains: any[];
+        apiKey: string;
+    };
+};
+export declare function queryServerGraphQL<T = any>({ query, variables, domain, config, }: ServerQueryArgs): Promise<T | null>;
+export {};
+//# sourceMappingURL=query-server.d.ts.map

package/dist/query-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-server.d.ts","sourceRoot":"","sources":["../src/query-server.ts"],"names":[],"mappings":"AAKA,KAAK,eAAe,GAAG;IACrB,KAAK,EAAE,GAAG,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE;QACN,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,GAAG,EAAE,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH,CAAC;AAEF,wBAAsB,kBAAkB,CAAC,CAAC,GAAG,GAAG,EAAE,EAChD,KAAK,EACL,SAAc,EACd,MAAM,EACN,MAAM,GACP,EAAE,eAAe,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CA8BrC"}

package/dist/query-server.js

@@ -0,0 +1,30 @@
+// src/server-query.ts
+'use server';
+import { cookies } from 'next/headers';
+import getApolloClient from './client';
+export async function queryServerGraphQL({ query, variables = {}, domain, config, }) {
+    try {
+        // 1. Get server-side cookies
+        const cookieStore = await cookies();
+        const cookieString = cookieStore.toString();
+        // 2. Call getApolloClient with the correct 3 arguments:
+        // Arg 1: options (cookies)
+        // Arg 2: domain (subdomain string)
+        // Arg 3: config (URLs and Subdomain array)
+        const client = await getApolloClient({ cookie: cookieString }, domain, config);
+        if (!client)
+            return null;
+        const result = await client.query({
+            query,
+            variables,
+            fetchPolicy: 'no-cache',
+        });
+        console.log("getting @e-conneq/gql-auth ........");
+        return result?.data;
+    }
+    catch (err) {
+        // On the server, we console.error instead of using Swal
+        console.error("GraphQL Server Error:", err);
+        return null;
+    }
+}

package/dist/upload-gql.d.ts

@@ -0,0 +1,21 @@
+type UploadGraphQLArgs = {
+    query: string;
+    variables: Record<string, any>;
+    fileMap: Record<string, File>;
+    token?: string;
+    params: any;
+    config: {
+        protocol: string;
+        RootApi: string;
+        Subdomains: {
+            subdomain: string;
+            id: string | number;
+            processId: string;
+            widgetID: string;
+        }[];
+        apiKey?: string;
+    };
+};
+export declare function uploadGraphQLMutation({ query, variables, fileMap, token, params, config }: UploadGraphQLArgs): Promise<any>;
+export {};
+//# sourceMappingURL=upload-gql.d.ts.map

package/dist/upload-gql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-gql.d.ts","sourceRoot":"","sources":["../src/upload-gql.ts"],"names":[],"mappings":"AAAA,KAAK,iBAAiB,GAAG;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,GAAG,CAAC;IACZ,MAAM,EAAE;QACN,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAC9F,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH,CAAC;AAEF,wBAAsB,qBAAqB,CAAC,EAC1C,KAAK,EACL,SAAS,EACT,OAAO,EACP,KAAK,EACL,MAAM,EACN,MAAM,EACP,EAAE,iBAAiB,gBA0DnB"}

package/dist/upload-gql.js

@@ -0,0 +1,45 @@
+export async function uploadGraphQLMutation({ query, variables, fileMap, token, params, config }) {
+    const { protocol, RootApi, Subdomains, apiKey } = config;
+    const formData = new FormData();
+    const updatedVariables = { ...variables };
+    // 1. Prepare GraphQL Multipart Request (Spec compliant)
+    Object.keys(fileMap).forEach((key) => {
+        updatedVariables[key] = null;
+    });
+    const operations = { query, variables: updatedVariables };
+    const map = {};
+    const fileKeys = Object.keys(fileMap);
+    fileKeys.forEach((key, index) => {
+        map[`${index}`] = [`variables.${key}`];
+    });
+    formData.append("operations", JSON.stringify(operations));
+    formData.append("map", JSON.stringify(map));
+    fileKeys.forEach((key, index) => {
+        formData.append(`${index}`, fileMap[key]);
+    });
+    // 2. Multi-tenant URL and Data Logic
+    const requestedDomain = params?.domain || "";
+    const tenantData = Subdomains.find((d) => d.subdomain.toLowerCase() === requestedDomain.toLowerCase());
+    // Determine URL: Use subdomain api if tenant exists, otherwise use root API
+    const API_LINK = `${protocol + RootApi}/graphql/`;
+    // 3. Construct Headers
+    const headers = {
+        ...(token ? { "Authorization": `Bearer ${token}` } : {}),
+        ...(apiKey ? { "X-API-KEY": apiKey } : {}),
+    };
+    // Inject specific tenant metadata into headers for Django to read
+    if (tenantData) {
+        headers["X-Tenant-ID"] = String(tenantData.subdomain);
+        headers["X-Process-ID"] = tenantData.processId || "";
+        headers["X-Widget-ID"] = tenantData.widgetID || "";
+    }
+    // 4. Execute Fetch
+    const res = await fetch(API_LINK, {
+        method: "POST",
+        headers,
+        body: formData,
+        // credentials: "include" is important if you use cookies alongside headers
+        credentials: "include",
+    });
+    return await res.json();
+}

package/dist/utils.d.ts

@@ -0,0 +1,24 @@
+import { InterFieldList, JwtPayload } from ".";
+export declare const capitalizeEachWord: (str: string) => string;
+export declare const errorLog: (err: any, show?: boolean) => string;
+export declare const getToken: () => string | null;
+export declare const getUser: () => JwtPayload | null;
+export declare const getStoredFont: (FONTS: string[]) => string;
+export declare const getTimeAgo: (dateStr: string, type: "past" | "future") => string;
+export declare const getLanguage: () => "en" | "fr";
+export declare const getTemplate: () => number;
+export declare const decodeUrlID: (urlID: string) => string;
+export declare function getAcademicYear(): string;
+export declare const removeEmptyFields: (obj: any) => any;
+export declare const Alert: ({ title, duration, status }: {
+    title: string;
+    duration: 1000 | 1500 | 2000 | 3000 | 4000 | 5000;
+    status?: boolean;
+}) => void;
+export declare const validateFormFields: (formData: any, currentStepFields: InterFieldList[]) => Record<string, string>;
+export declare const lastYears: (number: number) => {
+    value: string;
+    label: string;
+}[];
+export declare const formatText: (text: string) => string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,GAAG,CAAC;AAI/C,eAAO,MAAM,kBAAkB,GAAI,KAAK,MAAM,WAM7C,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,KAAK,GAAG,EAAE,OAAO,OAAO,WAyBhD,CAAC;AAKF,eAAO,MAAM,QAAQ,qBAKpB,CAAC;AAEF,eAAO,MAAM,OAAO,yBAKnB,CAAA;AAED,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,EAAE,WAO5C,CAAC;AAEF,eAAO,MAAM,UAAU,GACnB,SAAS,MAAM,EACf,MAAM,MAAM,GAAG,QAAQ,KACxB,MA0CF,CAAC;AAGF,eAAO,MAAM,WAAW,mBAOvB,CAAC;AAEF,eAAO,MAAM,WAAW,cAMvB,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,WAIxC,CAAA;AAED,wBAAgB,eAAe,IAAI,MAAM,CAUxC;AAED,eAAO,MAAM,iBAAiB,GAAI,KAAK,GAAG,QAUzC,CAAC;AAGF,eAAO,MAAM,KAAK,GACd,6BACI;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,SAU7F,CAAC;AAIF,eAAO,MAAM,kBAAkB,GAAI,UAAU,GAAG,EAAE,mBAAmB,cAAc,EAAE,2BAkDpF,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,QAAQ,MAAM;;;GAKvC,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,WAiDtC,CAAC"}

package/dist/utils.js

@@ -0,0 +1,257 @@
+import Swal from "sweetalert2";
+import Cookies from "js-cookie";
+import { jwtDecode } from "jwt-decode";
+export const capitalizeEachWord = (str) => {
+    if (!str)
+        return ''; // Handle empty or null strings
+    return str
+        .split(' ')
+        .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+        .join(' ');
+};
+export const errorLog = (err, show) => {
+    let mes = "An unknown error occurred";
+    if (typeof err === "string")
+        mes = err;
+    else if (err?.graphQLErrors?.length > 0)
+        mes = err.graphQLErrors.map((e) => e.message).join('\n');
+    else if (err?.networkError) {
+        const netErr = err.networkError;
+        if ("result" in netErr && netErr.result?.errors?.length > 0)
+            mes = netErr.result.errors.map((e) => e.message).join('\n');
+        else if (netErr.message)
+            mes = netErr.message;
+    }
+    else if (err?.extraInfo)
+        mes = String(err.extraInfo);
+    else if (err?.message)
+        mes = err.message;
+    if (show) {
+        Swal.fire({
+            title: mes,
+            icon: 'error',
+            timer: 3000,
+            timerProgressBar: true,
+            showConfirmButton: false,
+        });
+    }
+    return mes;
+};
+const currentYear = new Date().getFullYear();
+export const getToken = () => {
+    if (typeof window === "undefined") {
+        return null;
+    }
+    return Cookies.get("token") || localStorage.getItem("token");
+};
+export const getUser = () => {
+    // const token = typeof window !== 'undefined' ? localStorage.getItem("token") : null;
+    const token = getToken();
+    const user = token ? jwtDecode(token) : null;
+    return user;
+};
+export const getStoredFont = (FONTS) => {
+    if (typeof window === "undefined")
+        return FONTS[0]; // Default for SSR
+    const up = localStorage.getItem("user-pref");
+    if (!up)
+        return FONTS[5]; // Default to Ubuntu (6th index)
+    const fontIndex = parseInt(up[1]) - 1;
+    return FONTS[fontIndex] || FONTS[5];
+};
+export const getTimeAgo = (dateStr, type) => {
+    if (!dateStr)
+        return "";
+    const now = new Date();
+    const item = new Date(dateStr);
+    let diffMs = 0;
+    if (type === "past")
+        diffMs = now.getTime() - item.getTime();
+    if (type === "future")
+        diffMs = item.getTime() - now.getTime();
+    // Handle invalid date ranges
+    if (diffMs < 0) {
+        return type === "past" ? "just now" : "Closed";
+    }
+    const seconds = Math.floor(diffMs / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    const days = Math.floor(hours / 24);
+    const weeks = Math.floor(days / 7);
+    const months = Math.floor(days / 30.44); // Use average month length
+    const years = Math.floor(days / 365.25); // Account for leap years
+    const suffix = type === "past" ? "ago" : "left";
+    // 1. Logic for Past Dates (e.g., Posted 2 days ago)
+    if (type === "past") {
+        if (days === 0)
+            return "Today";
+        if (days === 1)
+            return "Yesterday";
+        if (days < 7)
+            return `${days} days ago`;
+        if (weeks < 5)
+            return `${weeks} week${weeks > 1 ? "s" : ""} ago`;
+        if (months < 12)
+            return `${months} month${months > 1 ? "s" : ""} ago`;
+        return `${years} year${years > 1 ? "s" : ""} ago`;
+    }
+    // 2. Logic for Future Dates (e.g., 5 days left)
+    if (days === 0)
+        return "Ends today";
+    if (days === 1)
+        return "1 day left";
+    if (days < 7)
+        return `${days} days left`;
+    if (weeks < 5)
+        return `${weeks} week${weeks > 1 ? "s" : ""} left`;
+    if (months < 12)
+        return `${months} month${months > 1 ? "s" : ""} left`;
+    return `${years} year${years > 1 ? "s" : ""} left`;
+};
+export const getLanguage = () => {
+    if (typeof window === "undefined")
+        return "en";
+    const up = localStorage.getItem("user-pref");
+    if (!up)
+        return "en";
+    const langNumber = parseInt(up[0]);
+    return langNumber === 1 ? "en" : "fr";
+};
+export const getTemplate = () => {
+    if (typeof window === "undefined")
+        return 1;
+    const up = localStorage.getItem("user-pref");
+    if (!up)
+        return 1;
+    return parseInt(up[2]);
+};
+export const decodeUrlID = (urlID) => {
+    const base64DecodedString = decodeURIComponent(urlID); // Decodes %3D%3D to ==
+    const id = Buffer.from(base64DecodedString, 'base64').toString('utf-8'); // Decoding from base64
+    return id.split(":")[1];
+};
+export function getAcademicYear() {
+    const today = new Date();
+    const year = today.getFullYear();
+    const month = today.getMonth(); // 0 = January, 7 = August
+    if (month < 7) {
+        return `${year - 1}/${year}`;
+    }
+    else {
+        return `${year}/${year + 1}`;
+    }
+}
+export const removeEmptyFields = (obj) => {
+    const newObj = {};
+    for (const key in obj) {
+        // Keep File objects and non-empty values
+        if (obj[key] instanceof File ||
+            (obj[key] !== null && obj[key] !== undefined && obj[key] !== '')) {
+            newObj[key] = obj[key];
+        }
+    }
+    return newObj;
+};
+export const Alert = ({ title, duration, status = true }) => {
+    Swal.fire({
+        title: capitalizeEachWord(title),
+        timer: duration,
+        timerProgressBar: true,
+        showConfirmButton: false,
+        icon: status ? 'success' : 'error',
+    });
+};
+export const validateFormFields = (formData, currentStepFields) => {
+    const newErrors = {};
+    // 1. Flatten the fields from all rows in the step
+    const fieldsToValidate = currentStepFields.flatMap(row => row.fields);
+    fieldsToValidate.forEach((field) => {
+        // Skip validation if the field is hidden
+        if (field.show === false)
+            return;
+        // 2. Get the value from formData
+        const value = formData[field.name];
+        // 3. Check Required
+        if (field.required && (!value || value.toString().trim() === "")) {
+            newErrors[field.name] = `${capitalizeEachWord(field.label)} is required`;
+            // return;
+        }
+        // 4. Check Type (Email)
+        if (field.type === 'email' && value) {
+            const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+            if (!emailRegex.test(value)) {
+                newErrors[field.name] = "Invalid email format";
+            }
+        }
+        // 5. Check Numbers (Min/Max)
+        if (field.type === 'number' && value) {
+            const numValue = Number(value);
+            if (field.min !== undefined && numValue < field.min) {
+                newErrors[field.name] = `Minimum value is ${field.min}`;
+            }
+            if (field.max !== undefined && numValue > field.max) {
+                newErrors[field.name] = `Maximum value is ${field.max}`;
+            }
+        }
+        // 6. Check Length (Strings)
+        if (field.type === 'text' && value) {
+            if (field.min !== undefined && value.length < field.min) {
+                newErrors[field.name] = `Too short (min ${field.min} chars)`;
+            }
+            if (field.max !== undefined && value.length > field.max) {
+                newErrors[field.name] = `Too long (min ${field.max} chars)`;
+            }
+        }
+    });
+    return newErrors;
+};
+export const lastYears = (number) => {
+    return Array.from({ length: number }, (_, i) => ({
+        value: (currentYear - i).toString(),
+        label: (currentYear - i).toString()
+    })).sort((a, b) => Number(b.value) - Number(a.value));
+};
+export const formatText = (text) => {
+    return text;
+    if (!text || typeof text !== "string")
+        return "";
+    return text
+        // Ensure space after "." if it's not part of abbreviation/number
+        .replace(/\.(?!\s|$|[a-zA-Z0-9])/g, ". ")
+        // Split sentences by ". " but preserve delimiter
+        .split(/(\. )/g)
+        .map((segment) => {
+        if (segment === ". ")
+            return segment; // keep delimiter
+        return segment
+            .split(" ")
+            .map((word, i) => {
+            if (word === "")
+                return word;
+            // Preserve existing ALL CAPS words
+            if (word.length > 1 && /^[A-Z]+$/.test(word)) {
+                return word;
+            }
+            // Abbreviations like g.a, n.l.n
+            if (/^([a-zA-Z]\.)+[a-zA-Z]?$/.test(word)) {
+                return word.toUpperCase(); // → G.A, N.L.N
+            }
+            // Version numbers like 3.0.1
+            if (/^\d+(\.\d+)+$/.test(word)) {
+                return word;
+            }
+            // Mixed abbrev/numbers (like p.m2.5 or covid-19 v2.0)
+            if (/[a-zA-Z]\.\d/.test(word) || /\d+\.\d+[a-zA-Z]?/.test(word)) {
+                return word; // leave as-is
+            }
+            // First word of sentence → capitalize first letter
+            if (i === 0) {
+                return word.charAt(0).toUpperCase() + word.slice(1).toLowerCase();
+            }
+            // Other words → lowercase
+            return word.toLowerCase();
+        })
+            .join(" ");
+    })
+        .join("");
+};

package/dist/utilsGeneral.d.ts

@@ -0,0 +1,24 @@
+import { InterFieldList, JwtPayload } from ".";
+export declare const capitalizeEachWord: (str: string) => string;
+export declare const errorLog: (err: any, show?: boolean) => string;
+export declare const logout: () => void;
+export declare const getToken: () => string | null;
+export declare const getUser: () => JwtPayload | null;
+export declare const getStoredFont: (FONTS: string[]) => string;
+export declare const getTimeAgo: (dateStr: string, type: "past" | "future") => string;
+export declare const getLanguage: () => "en" | "fr";
+export declare const getTemplate: () => number;
+export declare const decodeUrlID: (urlID: string) => string;
+export declare const removeEmptyFields: (obj: any) => any;
+export declare const Alert: ({ title, duration, status }: {
+    title: string;
+    duration: 1000 | 1500 | 2000 | 3000 | 4000 | 5000;
+    status?: boolean;
+}) => void;
+export declare const validateFormFields: (formData: any, currentStepFields: InterFieldList[]) => Record<string, string>;
+export declare const lastYears: (number: number) => {
+    value: string;
+    label: string;
+}[];
+export declare const formatText: (text: string) => string;
+//# sourceMappingURL=utilsGeneral.d.ts.map

package/dist/utilsGeneral.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilsGeneral.d.ts","sourceRoot":"","sources":["../src/utilsGeneral.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,GAAG,CAAC;AAM/C,eAAO,MAAM,kBAAkB,GAAI,KAAK,MAAM,WAM7C,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,KAAK,GAAG,EAAE,OAAO,OAAO,WAyBhD,CAAC;AAEF,eAAO,MAAM,MAAM,YAclB,CAAC;AAEF,eAAO,MAAM,QAAQ,qBAKpB,CAAC;AAEF,eAAO,MAAM,OAAO,yBAKnB,CAAA;AAED,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,EAAE,WAO5C,CAAC;AAEF,eAAO,MAAM,UAAU,GACnB,SAAS,MAAM,EACf,MAAM,MAAM,GAAG,QAAQ,KACxB,MA0CF,CAAC;AAEF,eAAO,MAAM,WAAW,mBAOvB,CAAC;AAEF,eAAO,MAAM,WAAW,cAMvB,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,WAIxC,CAAA;AAED,eAAO,MAAM,iBAAiB,GAAI,KAAK,GAAG,QAUzC,CAAC;AAEF,eAAO,MAAM,KAAK,GACd,6BACI;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,SAU7F,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,UAAU,GAAG,EAAE,mBAAmB,cAAc,EAAE,2BAkDpF,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,QAAQ,MAAM;;;GAKvC,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,WAiDtC,CAAC"}

package/dist/utilsGeneral.js

@@ -0,0 +1,260 @@
+import Swal from "sweetalert2";
+import Cookies from "js-cookie";
+import { jwtDecode } from "jwt-decode";
+const currentYear = new Date().getFullYear();
+export const capitalizeEachWord = (str) => {
+    if (!str)
+        return ''; // Handle empty or null strings
+    return str
+        .split(' ')
+        .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+        .join(' ');
+};
+export const errorLog = (err, show) => {
+    let mes = "An unknown error occurred";
+    if (typeof err === "string")
+        mes = err;
+    else if (err?.graphQLErrors?.length > 0)
+        mes = err.graphQLErrors.map((e) => e.message).join('\n');
+    else if (err?.networkError) {
+        const netErr = err.networkError;
+        if ("result" in netErr && netErr.result?.errors?.length > 0)
+            mes = netErr.result.errors.map((e) => e.message).join('\n');
+        else if (netErr.message)
+            mes = netErr.message;
+    }
+    else if (err?.extraInfo)
+        mes = String(err.extraInfo);
+    else if (err?.message)
+        mes = err.message;
+    if (show) {
+        Swal.fire({
+            title: mes,
+            icon: 'error',
+            timer: 3000,
+            timerProgressBar: true,
+            showConfirmButton: false,
+        });
+    }
+    return mes;
+};
+export const logout = () => {
+    // 1. Clear Local Storage
+    localStorage.removeItem("token");
+    const tokenDeleteString = "token=; expires=Thu, 01 Jan 1970 00:00:00 GMT; path=/;";
+    document.cookie = tokenDeleteString;
+    // 3. Fallback: Clear ALL cookies (your original loop)
+    const cookies = document.cookie.split(";");
+    for (let i = 0; i < cookies.length; i++) {
+        const cookie = cookies[i];
+        const eqPos = cookie.indexOf("=");
+        const name = eqPos > -1 ? cookie.substr(0, eqPos).trim() : cookie.trim();
+        document.cookie = `${name}=; expires=Thu, 01 Jan 1970 00:00:00 GMT; path=/;`;
+    }
+};
+export const getToken = () => {
+    if (typeof window === "undefined") {
+        return null;
+    }
+    return Cookies.get("token") || localStorage.getItem("token");
+};
+export const getUser = () => {
+    // const token = typeof window !== 'undefined' ? localStorage.getItem("token") : null;
+    const token = getToken();
+    const user = token ? jwtDecode(token) : null;
+    return user;
+};
+export const getStoredFont = (FONTS) => {
+    if (typeof window === "undefined")
+        return FONTS[0]; // Default for SSR
+    const up = localStorage.getItem("user-pref");
+    if (!up)
+        return FONTS[5]; // Default to Ubuntu (6th index)
+    const fontIndex = parseInt(up[1]) - 1;
+    return FONTS[fontIndex] || FONTS[5];
+};
+export const getTimeAgo = (dateStr, type) => {
+    if (!dateStr)
+        return "";
+    const now = new Date();
+    const item = new Date(dateStr);
+    let diffMs = 0;
+    if (type === "past")
+        diffMs = now.getTime() - item.getTime();
+    if (type === "future")
+        diffMs = item.getTime() - now.getTime();
+    // Handle invalid date ranges
+    if (diffMs < 0) {
+        return type === "past" ? "just now" : "Closed";
+    }
+    const seconds = Math.floor(diffMs / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    const days = Math.floor(hours / 24);
+    const weeks = Math.floor(days / 7);
+    const months = Math.floor(days / 30.44); // Use average month length
+    const years = Math.floor(days / 365.25); // Account for leap years
+    const suffix = type === "past" ? "ago" : "left";
+    // 1. Logic for Past Dates (e.g., Posted 2 days ago)
+    if (type === "past") {
+        if (days === 0)
+            return "Today";
+        if (days === 1)
+            return "Yesterday";
+        if (days < 7)
+            return `${days} days ago`;
+        if (weeks < 5)
+            return `${weeks} week${weeks > 1 ? "s" : ""} ago`;
+        if (months < 12)
+            return `${months} month${months > 1 ? "s" : ""} ago`;
+        return `${years} year${years > 1 ? "s" : ""} ago`;
+    }
+    // 2. Logic for Future Dates (e.g., 5 days left)
+    if (days === 0)
+        return "Ends today";
+    if (days === 1)
+        return "1 day left";
+    if (days < 7)
+        return `${days} days left`;
+    if (weeks < 5)
+        return `${weeks} week${weeks > 1 ? "s" : ""} left`;
+    if (months < 12)
+        return `${months} month${months > 1 ? "s" : ""} left`;
+    return `${years} year${years > 1 ? "s" : ""} left`;
+};
+export const getLanguage = () => {
+    if (typeof window === "undefined")
+        return "en";
+    const up = localStorage.getItem("user-pref");
+    if (!up)
+        return "en";
+    const langNumber = parseInt(up[0]);
+    return langNumber === 1 ? "en" : "fr";
+};
+export const getTemplate = () => {
+    if (typeof window === "undefined")
+        return 1;
+    const up = localStorage.getItem("user-pref");
+    if (!up)
+        return 1;
+    return parseInt(up[2]);
+};
+export const decodeUrlID = (urlID) => {
+    const base64DecodedString = decodeURIComponent(urlID); // Decodes %3D%3D to ==
+    const id = Buffer.from(base64DecodedString, 'base64').toString('utf-8'); // Decoding from base64
+    return id.split(":")[1];
+};
+export const removeEmptyFields = (obj) => {
+    const newObj = {};
+    for (const key in obj) {
+        // Keep File objects and non-empty values
+        if (obj[key] instanceof File ||
+            (obj[key] !== null && obj[key] !== undefined && obj[key] !== '')) {
+            newObj[key] = obj[key];
+        }
+    }
+    return newObj;
+};
+export const Alert = ({ title, duration, status = true }) => {
+    Swal.fire({
+        title: capitalizeEachWord(title),
+        timer: duration,
+        timerProgressBar: true,
+        showConfirmButton: false,
+        icon: status ? 'success' : 'error',
+    });
+};
+export const validateFormFields = (formData, currentStepFields) => {
+    const newErrors = {};
+    // 1. Flatten the fields from all rows in the step
+    const fieldsToValidate = currentStepFields.flatMap(row => row.fields);
+    fieldsToValidate.forEach((field) => {
+        // Skip validation if the field is hidden
+        if (field.show === false)
+            return;
+        // 2. Get the value from formData
+        const value = formData[field.name];
+        // 3. Check Required
+        if (field.required && (!value || value.toString().trim() === "")) {
+            newErrors[field.name] = `${capitalizeEachWord(field.label)} is required`;
+            // return;
+        }
+        // 4. Check Type (Email)
+        if (field.type === 'email' && value) {
+            const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+            if (!emailRegex.test(value)) {
+                newErrors[field.name] = "Invalid email format";
+            }
+        }
+        // 5. Check Numbers (Min/Max)
+        if (field.type === 'number' && value) {
+            const numValue = Number(value);
+            if (field.min !== undefined && numValue < field.min) {
+                newErrors[field.name] = `Minimum value is ${field.min}`;
+            }
+            if (field.max !== undefined && numValue > field.max) {
+                newErrors[field.name] = `Maximum value is ${field.max}`;
+            }
+        }
+        // 6. Check Length (Strings)
+        if (field.type === 'text' && value) {
+            if (field.min !== undefined && value.length < field.min) {
+                newErrors[field.name] = `Too short (min ${field.min} chars)`;
+            }
+            if (field.max !== undefined && value.length > field.max) {
+                newErrors[field.name] = `Too long (min ${field.max} chars)`;
+            }
+        }
+    });
+    return newErrors;
+};
+export const lastYears = (number) => {
+    return Array.from({ length: number }, (_, i) => ({
+        value: (currentYear - i).toString(),
+        label: (currentYear - i).toString()
+    })).sort((a, b) => Number(b.value) - Number(a.value));
+};
+export const formatText = (text) => {
+    return text;
+    if (!text || typeof text !== "string")
+        return "";
+    return text
+        // Ensure space after "." if it's not part of abbreviation/number
+        .replace(/\.(?!\s|$|[a-zA-Z0-9])/g, ". ")
+        // Split sentences by ". " but preserve delimiter
+        .split(/(\. )/g)
+        .map((segment) => {
+        if (segment === ". ")
+            return segment; // keep delimiter
+        return segment
+            .split(" ")
+            .map((word, i) => {
+            if (word === "")
+                return word;
+            // Preserve existing ALL CAPS words
+            if (word.length > 1 && /^[A-Z]+$/.test(word)) {
+                return word;
+            }
+            // Abbreviations like g.a, n.l.n
+            if (/^([a-zA-Z]\.)+[a-zA-Z]?$/.test(word)) {
+                return word.toUpperCase(); // → G.A, N.L.N
+            }
+            // Version numbers like 3.0.1
+            if (/^\d+(\.\d+)+$/.test(word)) {
+                return word;
+            }
+            // Mixed abbrev/numbers (like p.m2.5 or covid-19 v2.0)
+            if (/[a-zA-Z]\.\d/.test(word) || /\d+\.\d+[a-zA-Z]?/.test(word)) {
+                return word; // leave as-is
+            }
+            // First word of sentence → capitalize first letter
+            if (i === 0) {
+                return word.charAt(0).toUpperCase() + word.slice(1).toLowerCase();
+            }
+            // Other words → lowercase
+            return word.toLowerCase();
+        })
+            .join(" ");
+    })
+        .join("");
+};

package/dist/utilsSchool.d.ts

@@ -0,0 +1,7 @@
+export declare const getProfile: (item: any) => any;
+export declare const getClass: (item: any) => any;
+export declare const getClassName: (item: any) => any;
+export declare const getLevel: (item: any) => any;
+export declare const getAcademicYearStudent: (item: any) => any;
+export declare function getAcademicYear(): string;
+//# sourceMappingURL=utilsSchool.d.ts.map

package/dist/utilsSchool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilsSchool.d.ts","sourceRoot":"","sources":["../src/utilsSchool.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,UAAU,GAAI,MAAM,GAAG,QAAuE,CAAC;AAC5G,eAAO,MAAM,QAAQ,GAAI,MAAM,GAAG,QAA+G,CAAC;AAClJ,eAAO,MAAM,YAAY,GAAI,MAAM,GAAG,QAA2J,CAAC;AAClM,eAAO,MAAM,QAAQ,GAAI,MAAM,GAAG,QAA6M,CAAC;AAChP,eAAO,MAAM,sBAAsB,GAAI,MAAM,GAAG,QAAyJ,CAAC;AAC1M,wBAAgB,eAAe,IAAI,MAAM,CAUxC"}

package/dist/utilsSchool.js

@@ -0,0 +1,16 @@
+export const getProfile = (item) => item?.userprofile || item?.userprofilesec || item?.userprofileprim;
+export const getClass = (item) => item?.userprofile?.specialty || item?.userprofilesec?.classroomsec || item?.userprofileprim?.classroomprim;
+export const getClassName = (item) => item?.userprofile?.specialty?.mainSpecialty?.specialtyName || item?.userprofilesec?.classroomsec?.level || item?.userprofileprim?.classroomprim?.level;
+export const getLevel = (item) => item?.userprofile?.specialty?.level?.level || (item?.userprofilesec?.classroomsec?.series?.name || item?.userprofilesec?.classroomsec?.series?.classType) || item?.userprofileprim?.classroomprim?.level;
+export const getAcademicYearStudent = (item) => item?.userprofile?.specialty?.academicYear || item?.userprofilesec?.classroomsec?.academicYear || item?.userprofileprim?.classroomprim?.academicYear;
+export function getAcademicYear() {
+    const today = new Date();
+    const year = today.getFullYear();
+    const month = today.getMonth(); // 0 = January, 7 = August
+    if (month < 7) {
+        return `${year - 1}/${year}`;
+    }
+    else {
+        return `${year}/${year + 1}`;
+    }
+}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@econneq/utility-functions",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    },
+    "./query-server": {
+      "types": "./dist/query-server.d.ts",
+      "import": "./dist/query-server.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "@apollo/client": "^4.0.0",
+    "graphql": "^16.0.0",
+    "next": "^16.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0",
+    "sweetalert2": "^11.0.0"
+  },
+  "dependencies": {
+    "js-cookie": "^3.0.0",
+    "jwt-decode": "^4.0.0"
+  }
+}