@econneq/gql-auth 2.0.1 → 2.0.2

package/README.md

@@ -1,304 +1,304 @@
-# @econneq/gql-auth
-
-GraphQL + Auth utilities for **multi-tenant** and **single-tenant** Next.js apps.
-
-Handles:
-- Server-side (internal Docker network) and client-side (browser proxy) GraphQL
-- Multi-tenant header injection (`X-Tenant-ID`, `X-Process-ID`, `X-Widget-ID`)
-- JWT auth on both server and client
-- File uploads (GraphQL multipart spec)
-- Batch mutations with per-item error reporting
-
----
-
-## Installation
-
-```bash
-npm install @econneq/gql-auth
-```
-
-### Peer dependencies
-
-```bash
-npm install @apollo/client graphql next react
-```
-
----
-
-## Environment Variables
-
-| Variable | Side | Description |
-|---|---|---|
-| `DOMAIN_URL` | server | Base domain, e.g. `e-conneq.com` |
-| `PROTOCOL` | server | e.g. `https://` |
-| `BACKEND_URL_INT` | server | Internal Docker URL, e.g. `api:8000` |
-| `BACKEND_URL_EXT` | server | External backend host, e.g. `admin.e-conneq.com` |
-| `NEXT_PUBLIC_DOMAIN_URL` | both | Same as DOMAIN_URL (client-accessible) |
-| `NEXT_PUBLIC_PROTOCOL` | both | Same as PROTOCOL (client-accessible) |
-| `NEXT_PUBLIC_BACKEND_URL_EXT` | both | Same as BACKEND_URL_EXT (client-accessible) |
-| `API_KEY` | server | Optional service-to-service key |
-
-> The internal URL (`BACKEND_URL_INT`) is **never** exposed to the browser.
-> Client-side mutations route through Next.js `/api/graphql` proxy.
-
----
-
-## Config Object
-
-Every function accepts a `config` object describing your tenants.
-
-```ts
-// config.ts  (shared across your project)
-import type { ConfigType } from "@econneq/gql-auth";
-
-export const config: ConfigType = {
-  Subdomains: [
-    { id: 1, subdomain: "acme",  processId: "proc-1", widgetID: "wgt-1" },
-    { id: 2, subdomain: "globex", processId: "proc-2" },
-  ],
-};
-```
-
-**Single-tenant**: put one entry in `Subdomains`. The library will always use it
-without requiring a `domain` parameter.
-
----
-
-## Quick start
-
-### 1. Register the cookie helper (Next.js app)
-
-In your root layout (`app/layout.tsx`) or instrumentation file:
-
-```ts
-import { cookies } from "next/headers";
-import { registerCookiesFn } from "@econneq/gql-auth";
-
-registerCookiesFn(cookies);
-```
-
-This lets the Apollo client forward cookies server-side without a hard
-`next/headers` import inside the package.
-
----
-
-### 2. Server-side query (Server Component / Route Handler)
-
-```ts
-import { queryServerGraphQL } from "@econneq/gql-auth";
-import { config } from "@/config";
-import { GET_USERS } from "@/graphql/queries";
-
-// Multi-tenant
-const data = await queryServerGraphQL({
-  query: GET_USERS,
-  variables: { active: true },
-  domain: "acme",      // ← matches Subdomains[].subdomain
-  config,
-});
-
-// Single-tenant (omit domain)
-const data = await queryServerGraphQL({
-  query: GET_USERS,
-  config,
-});
-```
-
-### 3. Server-side mutation (Server Action)
-
-```ts
-"use server";
-import { mutateServerGraphQL } from "@econneq/gql-auth";
-
-const result = await mutateServerGraphQL({
-  query: CREATE_USER_MUTATION,
-  variables: { input: formData },
-  domain: params.domain,
-  config,
-});
-```
-
----
-
-### 4. Client-side mutation with ApiFactory
-
-```tsx
-"use client";
-import { ApiFactory, getToken } from "@econneq/gql-auth";
-import { useRouter } from "next/navigation";
-import { config } from "@/config";
-
-export function MyForm({ params }: { params: { domain: string } }) {
-  const router = useRouter();
-
-  const handleSubmit = async (formData: any) => {
-    await ApiFactory({
-      newData: formData,
-      mutationName: "createUser",
-      modelName: "user",
-      successField: "username",
-      query: CREATE_USER_MUTATION,
-      params: { domain: params.domain },  // omit for single-tenant
-      config,
-      router,
-      token: getToken() ?? undefined,
-      onAlert: ({ title, status }) => {
-        // Connect to your toast/alert system
-        console.log(title, status);
-      },
-      redirect: true,
-      redirectPath: "/dashboard",
-    });
-  };
-
-  return <form onSubmit={...}>...</form>;
-}
-```
-
-#### Batch mutations
-
-Pass an array to `newData`:
-
-```ts
-await ApiFactory({
-  newData: [item1, item2, item3],
-  mutationName: "createProduct",
-  modelName: "product",
-  // ...
-});
-```
-
-#### File uploads
-
-```ts
-await ApiFactory({
-  newData: formData,
-  getFileMap: (item) => ({ avatar: item.avatarFile }),
-  // ...
-});
-```
-
-#### Return data instead of alert
-
-```ts
-const user = await ApiFactory<{ id: string; username: string }>({
-  returnResponseObject: true,
-  // ...
-});
-```
-
----
-
-### 5. Direct upload mutation
-
-For full control over multipart uploads:
-
-```ts
-import { uploadGraphQLMutation } from "@econneq/gql-auth";
-
-const response = await uploadGraphQLMutation({
-  query: UPLOAD_DOCUMENT_MUTATION.loc!.source.body,
-  variables: { title: "Report", file: null },
-  fileMap: { file: selectedFile },
-  params: { domain: "acme" },
-  config,
-  token: userToken,
-});
-```
-
----
-
-### 6. Auth utilities
-
-#### Client-side
-
-```ts
-import { getToken, getUser, logout } from "@econneq/gql-auth";
-
-const token = getToken();          // cookie → localStorage
-const user  = getUser();           // decoded JwtPayload
-logout();                          // clears cookies + localStorage
-```
-
-#### Server-side
-
-```ts
-import {
-  getServerToken,
-  getServerUser,
-  getPermissions,
-} from "@econneq/gql-auth";
-
-const token = await getServerToken();
-const user  = await getServerUser();
-
-// Does the user have any access to module 42?
-const canRead = getPermissions(user?.permissions ?? [], 42);
-
-// Does the user have CREATE access to module 42?
-const canCreate = getPermissions(user?.permissions ?? [], 42, "C");
-```
-
----
-
-### 7. Apollo client (advanced)
-
-Direct access when you need a custom query/mutation outside ApiFactory:
-
-```ts
-import { getApolloClient } from "@econneq/gql-auth";
-
-const client = await getApolloClient({
-  domain: "acme",   // omit for single-tenant
-  config,
-});
-
-const { data } = await client.query({ query: MY_QUERY });
-```
-
----
-
-## Architecture
-
-```
-Browser                     Next.js Server              Backend (Docker)
-─────────                   ──────────────              ────────────────
-uploadGraphQLMutation  ──►  /api/graphql  (proxy) ──►  api:8000/graphql/
-ApiFactory             ──►  /api/graphql  (proxy) ──►  api:8000/graphql/
-
-queryServerGraphQL     ────────────────────────────►  http://api:8000/graphql/
-mutateServerGraphQL    ────────────────────────────►  http://api:8000/graphql/
-getApolloClient        ────────────────────────────►  http://api:8000/graphql/
-```
-
-Server-side calls skip the proxy entirely and hit the backend directly
-through Docker's internal network — faster and no public exposure.
-
----
-
-## Permissions format
-
-Permission strings encode resource + action:
-
-```
-"42"   → access resource 42 (any action)
-"42C"  → create on resource 42
-"42R"  → read on resource 42
-"42U"  → update on resource 42
-"42D"  → delete on resource 42
-```
-
----
-
-## Changelog
-
-### 2.0.0
-- Centralised env resolution (`env.ts`)
-- Tenant resolution separated into `tenant.ts` — single-tenant fallback
-- `mutateServerGraphQL` added (server-side mutations)
-- `ApiFactory` typed generics, batch partial-error reporting
-- `registerCookiesFn` removes hard `next/headers` dependency
-- `getServerCookieString` helper exported
-- `parseGraphQLErrors` exported for custom use
-- Subdomains[0] fallback for single-tenant setups
-- `uploadGraphQLMutation` no longer throws on missing tenant in single-tenant mode
+# @econneq/gql-auth
+
+GraphQL + Auth utilities for **multi-tenant** and **single-tenant** Next.js apps.
+
+Handles:
+- Server-side (internal Docker network) and client-side (browser proxy) GraphQL
+- Multi-tenant header injection (`X-Tenant-ID`, `X-Process-ID`, `X-Widget-ID`)
+- JWT auth on both server and client
+- File uploads (GraphQL multipart spec)
+- Batch mutations with per-item error reporting
+
+---
+
+## Installation
+
+```bash
+npm install @econneq/gql-auth
+```
+
+### Peer dependencies
+
+```bash
+npm install @apollo/client graphql next react
+```
+
+---
+
+## Environment Variables
+
+| Variable | Side | Description |
+|---|---|---|
+| `DOMAIN_URL` | server | Base domain, e.g. `e-conneq.com` |
+| `PROTOCOL` | server | e.g. `https://` |
+| `BACKEND_URL_INT` | server | Internal Docker URL, e.g. `api:8000` |
+| `BACKEND_URL_EXT` | server | External backend host, e.g. `admin.e-conneq.com` |
+| `NEXT_PUBLIC_DOMAIN_URL` | both | Same as DOMAIN_URL (client-accessible) |
+| `NEXT_PUBLIC_PROTOCOL` | both | Same as PROTOCOL (client-accessible) |
+| `NEXT_PUBLIC_BACKEND_URL_EXT` | both | Same as BACKEND_URL_EXT (client-accessible) |
+| `API_KEY` | server | Optional service-to-service key |
+
+> The internal URL (`BACKEND_URL_INT`) is **never** exposed to the browser.
+> Client-side mutations route through Next.js `/api/graphql` proxy.
+
+---
+
+## Config Object
+
+Every function accepts a `config` object describing your tenants.
+
+```ts
+// config.ts  (shared across your project)
+import type { ConfigType } from "@econneq/gql-auth";
+
+export const config: ConfigType = {
+  Subdomains: [
+    { id: 1, subdomain: "acme",  processId: "proc-1", widgetID: "wgt-1" },
+    { id: 2, subdomain: "globex", processId: "proc-2" },
+  ],
+};
+```
+
+**Single-tenant**: put one entry in `Subdomains`. The library will always use it
+without requiring a `domain` parameter.
+
+---
+
+## Quick start
+
+### 1. Register the cookie helper (Next.js app)
+
+In your root layout (`app/layout.tsx`) or instrumentation file:
+
+```ts
+import { cookies } from "next/headers";
+import { registerCookiesFn } from "@econneq/gql-auth";
+
+registerCookiesFn(cookies);
+```
+
+This lets the Apollo client forward cookies server-side without a hard
+`next/headers` import inside the package.
+
+---
+
+### 2. Server-side query (Server Component / Route Handler)
+
+```ts
+import { queryServerGraphQL } from "@econneq/gql-auth";
+import { config } from "@/config";
+import { GET_USERS } from "@/graphql/queries";
+
+// Multi-tenant
+const data = await queryServerGraphQL({
+  query: GET_USERS,
+  variables: { active: true },
+  domain: "acme",      // ← matches Subdomains[].subdomain
+  config,
+});
+
+// Single-tenant (omit domain)
+const data = await queryServerGraphQL({
+  query: GET_USERS,
+  config,
+});
+```
+
+### 3. Server-side mutation (Server Action)
+
+```ts
+"use server";
+import { mutateServerGraphQL } from "@econneq/gql-auth";
+
+const result = await mutateServerGraphQL({
+  query: CREATE_USER_MUTATION,
+  variables: { input: formData },
+  domain: params.domain,
+  config,
+});
+```
+
+---
+
+### 4. Client-side mutation with ApiFactory
+
+```tsx
+"use client";
+import { ApiFactory, getToken } from "@econneq/gql-auth";
+import { useRouter } from "next/navigation";
+import { config } from "@/config";
+
+export function MyForm({ params }: { params: { domain: string } }) {
+  const router = useRouter();
+
+  const handleSubmit = async (formData: any) => {
+    await ApiFactory({
+      newData: formData,
+      mutationName: "createUser",
+      modelName: "user",
+      successField: "username",
+      query: CREATE_USER_MUTATION,
+      params: { domain: params.domain },  // omit for single-tenant
+      config,
+      router,
+      token: getToken() ?? undefined,
+      onAlert: ({ title, status }) => {
+        // Connect to your toast/alert system
+        console.log(title, status);
+      },
+      redirect: true,
+      redirectPath: "/dashboard",
+    });
+  };
+
+  return <form onSubmit={...}>...</form>;
+}
+```
+
+#### Batch mutations
+
+Pass an array to `newData`:
+
+```ts
+await ApiFactory({
+  newData: [item1, item2, item3],
+  mutationName: "createProduct",
+  modelName: "product",
+  // ...
+});
+```
+
+#### File uploads
+
+```ts
+await ApiFactory({
+  newData: formData,
+  getFileMap: (item) => ({ avatar: item.avatarFile }),
+  // ...
+});
+```
+
+#### Return data instead of alert
+
+```ts
+const user = await ApiFactory<{ id: string; username: string }>({
+  returnResponseObject: true,
+  // ...
+});
+```
+
+---
+
+### 5. Direct upload mutation
+
+For full control over multipart uploads:
+
+```ts
+import { uploadGraphQLMutation } from "@econneq/gql-auth";
+
+const response = await uploadGraphQLMutation({
+  query: UPLOAD_DOCUMENT_MUTATION.loc!.source.body,
+  variables: { title: "Report", file: null },
+  fileMap: { file: selectedFile },
+  params: { domain: "acme" },
+  config,
+  token: userToken,
+});
+```
+
+---
+
+### 6. Auth utilities
+
+#### Client-side
+
+```ts
+import { getToken, getUser, logout } from "@econneq/gql-auth";
+
+const token = getToken();          // cookie → localStorage
+const user  = getUser();           // decoded JwtPayload
+logout();                          // clears cookies + localStorage
+```
+
+#### Server-side
+
+```ts
+import {
+  getServerToken,
+  getServerUser,
+  getPermissions,
+} from "@econneq/gql-auth";
+
+const token = await getServerToken();
+const user  = await getServerUser();
+
+// Does the user have any access to module 42?
+const canRead = getPermissions(user?.permissions ?? [], 42);
+
+// Does the user have CREATE access to module 42?
+const canCreate = getPermissions(user?.permissions ?? [], 42, "C");
+```
+
+---
+
+### 7. Apollo client (advanced)
+
+Direct access when you need a custom query/mutation outside ApiFactory:
+
+```ts
+import { getApolloClient } from "@econneq/gql-auth";
+
+const client = await getApolloClient({
+  domain: "acme",   // omit for single-tenant
+  config,
+});
+
+const { data } = await client.query({ query: MY_QUERY });
+```
+
+---
+
+## Architecture
+
+```
+Browser                     Next.js Server              Backend (Docker)
+─────────                   ──────────────              ────────────────
+uploadGraphQLMutation  ──►  /api/graphql  (proxy) ──►  api:8000/graphql/
+ApiFactory             ──►  /api/graphql  (proxy) ──►  api:8000/graphql/
+
+queryServerGraphQL     ────────────────────────────►  http://api:8000/graphql/
+mutateServerGraphQL    ────────────────────────────►  http://api:8000/graphql/
+getApolloClient        ────────────────────────────►  http://api:8000/graphql/
+```
+
+Server-side calls skip the proxy entirely and hit the backend directly
+through Docker's internal network — faster and no public exposure.
+
+---
+
+## Permissions format
+
+Permission strings encode resource + action:
+
+```
+"42"   → access resource 42 (any action)
+"42C"  → create on resource 42
+"42R"  → read on resource 42
+"42U"  → update on resource 42
+"42D"  → delete on resource 42
+```
+
+---
+
+## Changelog
+
+### 2.0.0
+- Centralised env resolution (`env.ts`)
+- Tenant resolution separated into `tenant.ts` — single-tenant fallback
+- `mutateServerGraphQL` added (server-side mutations)
+- `ApiFactory` typed generics, batch partial-error reporting
+- `registerCookiesFn` removes hard `next/headers` dependency
+- `getServerCookieString` helper exported
+- `parseGraphQLErrors` exported for custom use
+- Subdomains[0] fallback for single-tenant setups
+- `uploadGraphQLMutation` no longer throws on missing tenant in single-tenant mode

package/dist/authServer.d.ts

@@ -23,7 +23,7 @@ export declare const getServerUser: () => Promise<JwtPayload | null>;
  * // Does the user have CREATE access to module 42?
  * getPermissions(user.permissions, 42, "C");
  */
-export declare const getPermissions: (list: string[], access: number, action?: string) => boolean;
+export declare const getPermissions: (list: string[], access: number, action?: string) => Promise<boolean>;
 /**
  * Return the full cookie header string for forwarding to the
  * backend (Django session / CSRF pass-through).

package/dist/authServer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"authServer.d.ts","sourceRoot":"","sources":["../src/authServer.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAI1C;;;GAGG;AACH,eAAO,MAAM,cAAc,QAAa,OAAO,CAAC,MAAM,GAAG,IAAI,CAS5D,CAAC;AAIF;;;GAGG;AACH,eAAO,MAAM,aAAa,QAAa,OAAO,CAAC,UAAU,GAAG,IAAI,CAU/D,CAAC;AAIF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,cAAc,GACzB,MAAM,MAAM,EAAE,EACd,QAAQ,MAAM,EACd,SAAS,MAAM,KACd,OAoBF,CAAC;AAIF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,QAAa,OAAO,CAAC,MAAM,CAQ5D,CAAC"}
+{"version":3,"file":"authServer.d.ts","sourceRoot":"","sources":["../src/authServer.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAI1C;;;GAGG;AACH,eAAO,MAAM,cAAc,QAAa,OAAO,CAAC,MAAM,GAAG,IAAI,CAS5D,CAAC;AAIF;;;GAGG;AACH,eAAO,MAAM,aAAa,QAAa,OAAO,CAAC,UAAU,GAAG,IAAI,CAU/D,CAAC;AAIF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,cAAc,GACzB,MAAM,MAAM,EAAE,EACd,QAAQ,MAAM,EACd,SAAS,MAAM,KACd,OAAO,CAAC,OAAO,CAoBjB,CAAC;AAIF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,QAAa,OAAO,CAAC,MAAM,CAQ5D,CAAC"}

package/dist/authServer.js

@@ -55,7 +55,7 @@ export const getServerUser = async () => {
  * // Does the user have CREATE access to module 42?
  * getPermissions(user.permissions, 42, "C");
  */
-export const getPermissions = (list, access, action) => {
+export const getPermissions = async (list, access, action) => {
     if (!list?.length)
         return false;
     try {

package/dist/authServer.js.map

@@ -1 +1 @@
-{"version":3,"file":"authServer.js","sourceRoot":"","sources":["../src/authServer.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+CAA+C;AAC/C,+DAA+D;AAC/D,EAAE;AACF,8DAA8D;AAC9D,4DAA4D;AAC5D,kBAAkB;AAClB,gEAAgE;AAEhE,YAAY,CAAC;AAIb,gEAAgE;AAEhE;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,IAA4B,EAAE;IAC/D,IAAI,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;QACjD,MAAM,WAAW,GAAG,MAAM,OAAO,EAAE,CAAC;QACpC,OAAO,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,KAAK,IAAI,IAAI,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,0DAA0D;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEF,iEAAiE;AAEjE;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,IAAgC,EAAE;IAClE,MAAM,KAAK,GAAG,MAAM,cAAc,EAAE,CAAC;IACrC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,IAAI,CAAC;QACH,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;QACjD,OAAO,SAAS,CAAa,KAAK,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEF,gEAAgE;AAEhE;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,IAAc,EACd,MAAc,EACd,MAAe,EACN,EAAE;IACX,IAAI,CAAC,IAAI,EAAE,MAAM;QAAE,OAAO,KAAK,CAAC;IAEhC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;YACzB,IAAI,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;gBACtB,iDAAiD;gBACjD,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,MAAM,SAAS,CAAC,CAAC;gBAC9C,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC3B,CAAC;YAED,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;gBACrB,OAAO,KAAK,KAAK,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC;YACxC,CAAC;YAED,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC;AAEF,iEAAiE;AAEjE;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,IAAqB,EAAE;IAC/D,IAAI,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;QACjD,MAAM,WAAW,GAAG,MAAM,OAAO,EAAE,CAAC;QACpC,OAAO,WAAW,CAAC,QAAQ,EAAE,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC,CAAC"}
+{"version":3,"file":"authServer.js","sourceRoot":"","sources":["../src/authServer.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+CAA+C;AAC/C,+DAA+D;AAC/D,EAAE;AACF,8DAA8D;AAC9D,4DAA4D;AAC5D,kBAAkB;AAClB,gEAAgE;AAEhE,YAAY,CAAC;AAIb,gEAAgE;AAEhE;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,IAA4B,EAAE;IAC/D,IAAI,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;QACjD,MAAM,WAAW,GAAG,MAAM,OAAO,EAAE,CAAC;QACpC,OAAO,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,KAAK,IAAI,IAAI,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,0DAA0D;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEF,iEAAiE;AAEjE;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,IAAgC,EAAE;IAClE,MAAM,KAAK,GAAG,MAAM,cAAc,EAAE,CAAC;IACrC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,IAAI,CAAC;QACH,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;QACjD,OAAO,SAAS,CAAa,KAAK,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEF,gEAAgE;AAEhE;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EACjC,IAAc,EACd,MAAc,EACd,MAAe,EACG,EAAE;IACpB,IAAI,CAAC,IAAI,EAAE,MAAM;QAAE,OAAO,KAAK,CAAC;IAEhC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;YACzB,IAAI,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;gBACtB,iDAAiD;gBACjD,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,MAAM,SAAS,CAAC,CAAC;gBAC9C,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC3B,CAAC;YAED,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;gBACrB,OAAO,KAAK,KAAK,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC;YACxC,CAAC;YAED,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC;AAEF,iEAAiE;AAEjE;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,IAAqB,EAAE;IAC/D,IAAI,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;QACjD,MAAM,WAAW,GAAG,MAAM,OAAO,EAAE,CAAC;QACpC,OAAO,WAAW,CAAC,QAAQ,EAAE,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC,CAAC"}

package/dist/utilsGeneral.d.ts

@@ -1,4 +1,4 @@
-import { InterFieldList, JwtPayload } from ".";
+import { InterFieldList, JwtPayload } from "./index.js";
 export declare const capitalizeEachWord: (str: string) => string;
 export declare const errorLog: (err: any, show?: boolean) => string;
 export declare const logout: () => void;

package/dist/utilsGeneral.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"utilsGeneral.d.ts","sourceRoot":"","sources":["../src/utilsGeneral.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAMxD,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/package.json

@@ -1,17 +1,11 @@
 {
   "name": "@econneq/gql-auth",
-  "version": "2.0.1",
+  "version": "2.0.2",
   "description": "GraphQL auth utilities for multi-tenant and single-tenant Next.js projects.",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
-  "scripts": {
-    "build": "tsc",
-    "build:watch": "tsc --watch",
-    "prepublishOnly": "npm run build",
-    "typecheck": "tsc --noEmit"
-  },
   "publishConfig": {
     "access": "public"
   },
@@ -72,5 +66,10 @@
     "@types/node": "^20.0.0",
     "@types/react": "^19.0.0",
     "typescript": "^5.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "typecheck": "tsc --noEmit"
   }
-}
+}

package/dist/utils.d.ts

@@ -1,24 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,257 +0,0 @@
-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("");
-};