@carlonicora/nextjs-jsonapi 1.0.3 → 1.0.5

package/dist/server/index.mjs

@@ -4,6 +4,9 @@ import {
 import {
   getServerToken
 } from "../chunk-YF5XQZDR.mjs";
+import {
+  checkPermissionsFromServer
+} from "../chunk-DD3KISNB.mjs";
 import {
   __name
 } from "../chunk-PAWJFY3S.mjs";
@@ -20,7 +23,72 @@ async function invalidateCacheTags(tags, profile = "max") {
   }
 }
 __name(invalidateCacheTags, "invalidateCacheTags");
+
+// src/server/ServerSession.ts
+import { cookies } from "next/headers";
+import { redirect } from "next/navigation";
+import zlib from "zlib";
+var ServerSession = class {
+  static {
+    __name(this, "ServerSession");
+  }
+  static async isLogged() {
+    const cookieStore = await cookies();
+    const token = cookieStore.get("token");
+    if (!token || !token.value) return false;
+    return true;
+  }
+  static async isLicenseActive() {
+    const cookieStore = await cookies();
+    const licenseExpirationDate = cookieStore.get("licenseExpirationDate")?.value;
+    if (!licenseExpirationDate) return false;
+    const now = /* @__PURE__ */ new Date();
+    return new Date(licenseExpirationDate) > now;
+  }
+  static async companyId() {
+    const cookieStore = await cookies();
+    return cookieStore.get("companyId")?.value ?? "";
+  }
+  static async userId() {
+    const cookieStore = await cookies();
+    return cookieStore.get("userId")?.value ?? "";
+  }
+  static async checkPermission(params) {
+    if (!await this.hasPermissionToModule(params)) redirect(`/401`);
+  }
+  static async hasRole(roleId) {
+    const cookieStore = await cookies();
+    const roles = cookieStore.get("roles")?.value;
+    if (!roles || !roles.includes(roleId)) return false;
+    return true;
+  }
+  static async hasFeature(featureId) {
+    const cookieStore = await cookies();
+    const features = cookieStore.get("features")?.value;
+    if (!features || !features.includes(featureId)) return false;
+    return true;
+  }
+  static async hasPermissionToModule(params) {
+    const cookieStore = await cookies();
+    if (params.module.feature) {
+      const features = cookieStore.get("features")?.value;
+      if (features && !features.includes(params.module.feature)) return false;
+    }
+    const rawModules = cookieStore.get("modules")?.value;
+    if (!rawModules) return false;
+    const modules = JSON.parse(zlib.gunzipSync(Buffer.from(rawModules, "base64")).toString());
+    const selectedModule = modules.find((module) => module.id === params.module.moduleId);
+    return checkPermissionsFromServer({
+      module: params.module,
+      action: params.action,
+      data: params.data,
+      userId: await this.userId(),
+      selectedModule
+    });
+  }
+};
 export {
+  ServerSession,
   getServerToken,
   invalidateCacheTag,
   invalidateCacheTags,

package/dist/server/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/server/cache.ts"],"sourcesContent":["\"use server\";\n\nimport { revalidateTag } from \"next/cache\";\n\nexport type CacheProfile = \"seconds\" | \"minutes\" | \"hours\" | \"days\" | \"weeks\" | \"max\" | \"default\";\n\n/**\n * Revalidate a cache tag to invalidate cached data.\n * Next.js 16+ requires a profile parameter.\n *\n * @param tag - The cache tag to invalidate\n * @param profile - The cache profile (defaults to \"max\" for immediate invalidation)\n */\nexport async function invalidateCacheTag(tag: string, profile: CacheProfile = \"max\"): Promise<void> {\n  revalidateTag(tag, profile);\n}\n\n/**\n * Revalidate multiple cache tags.\n *\n * @param tags - Array of cache tags to invalidate\n * @param profile - The cache profile (defaults to \"max\" for immediate invalidation)\n */\nexport async function invalidateCacheTags(tags: string[], profile: CacheProfile = \"max\"): Promise<void> {\n  for (const tag of tags) {\n    revalidateTag(tag, profile);\n  }\n}\n"],"mappings":";;;;;;;;;;;AAEA,SAAS,qBAAqB;AAW9B,eAAsB,mBAAmB,KAAa,UAAwB,OAAsB;AAClG,gBAAc,KAAK,OAAO;AAC5B;AAFsB;AAUtB,eAAsB,oBAAoB,MAAgB,UAAwB,OAAsB;AACtG,aAAW,OAAO,MAAM;AACtB,kBAAc,KAAK,OAAO;AAAA,EAC5B;AACF;AAJsB;","names":[]}
+{"version":3,"sources":["../../src/server/cache.ts","../../src/server/ServerSession.ts"],"sourcesContent":["\"use server\";\n\nimport { revalidateTag } from \"next/cache\";\n\nexport type CacheProfile = \"seconds\" | \"minutes\" | \"hours\" | \"days\" | \"weeks\" | \"max\" | \"default\";\n\n/**\n * Revalidate a cache tag to invalidate cached data.\n * Next.js 16+ requires a profile parameter.\n *\n * @param tag - The cache tag to invalidate\n * @param profile - The cache profile (defaults to \"max\" for immediate invalidation)\n */\nexport async function invalidateCacheTag(tag: string, profile: CacheProfile = \"max\"): Promise<void> {\n  revalidateTag(tag, profile);\n}\n\n/**\n * Revalidate multiple cache tags.\n *\n * @param tags - Array of cache tags to invalidate\n * @param profile - The cache profile (defaults to \"max\" for immediate invalidation)\n */\nexport async function invalidateCacheTags(tags: string[], profile: CacheProfile = \"max\"): Promise<void> {\n  for (const tag of tags) {\n    revalidateTag(tag, profile);\n  }\n}\n","import { cookies } from \"next/headers\";\nimport { redirect } from \"next/navigation\";\nimport zlib from \"zlib\";\nimport { Action, checkPermissionsFromServer, ModuleWithPermissions } from \"../permissions\";\n\nexport class ServerSession {\n  static async isLogged() {\n    const cookieStore = await cookies();\n    const token = cookieStore.get(\"token\");\n\n    if (!token || !token.value) return false;\n    return true;\n  }\n\n  static async isLicenseActive(): Promise<boolean> {\n    const cookieStore = await cookies();\n    const licenseExpirationDate = cookieStore.get(\"licenseExpirationDate\")?.value;\n\n    if (!licenseExpirationDate) return false;\n\n    const now = new Date();\n    return new Date(licenseExpirationDate) > now;\n  }\n\n  static async companyId() {\n    const cookieStore = await cookies();\n    return cookieStore.get(\"companyId\")?.value ?? \"\";\n  }\n\n  static async userId() {\n    const cookieStore = await cookies();\n    return cookieStore.get(\"userId\")?.value ?? \"\";\n  }\n\n  static async checkPermission<M extends ModuleWithPermissions>(params: { module: M; action: Action; data?: any }) {\n    if (!(await this.hasPermissionToModule(params))) redirect(`/401`);\n  }\n\n  static async hasRole(roleId: string): Promise<boolean> {\n    const cookieStore = await cookies();\n    const roles = cookieStore.get(\"roles\")?.value;\n\n    if (!roles || !roles.includes(roleId)) return false;\n\n    return true;\n  }\n\n  static async hasFeature(featureId: string): Promise<boolean> {\n    const cookieStore = await cookies();\n    const features = cookieStore.get(\"features\")?.value;\n\n    if (!features || !features.includes(featureId)) return false;\n\n    return true;\n  }\n\n  static async hasPermissionToModule<M extends ModuleWithPermissions>(params: {\n    module: M;\n    action: Action;\n    data?: any;\n  }): Promise<boolean> {\n    const cookieStore = await cookies();\n\n    if (params.module.feature) {\n      const features = cookieStore.get(\"features\")?.value;\n\n      if (features && !features.includes(params.module.feature)) return false;\n    }\n\n    const rawModules = cookieStore.get(\"modules\")?.value;\n    if (!rawModules) return false;\n\n    const modules: {\n      id: string;\n      permissions: {\n        create: boolean | string;\n        read: boolean | string;\n        update: boolean | string;\n        delete: boolean | string;\n      };\n    }[] = JSON.parse(zlib.gunzipSync(Buffer.from(rawModules, \"base64\")).toString());\n\n    const selectedModule = modules.find((module) => module.id === params.module.moduleId);\n\n    return checkPermissionsFromServer({\n      module: params.module,\n      action: params.action,\n      data: params.data,\n      userId: await this.userId(),\n      selectedModule: selectedModule,\n    });\n\n    // if (!selectedModule) return false;\n\n    // if (!selectedModule.permissions[params.action]) return false;\n    // if (typeof selectedModule.permissions[params.action] === \"boolean\")\n    //   return selectedModule.permissions[params.action] as boolean;\n\n    // if (!params.data) return false;\n\n    // return params.data[selectedModule.permissions[params.action] as string] === this.userId;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;AAEA,SAAS,qBAAqB;AAW9B,eAAsB,mBAAmB,KAAa,UAAwB,OAAsB;AAClG,gBAAc,KAAK,OAAO;AAC5B;AAFsB;AAUtB,eAAsB,oBAAoB,MAAgB,UAAwB,OAAsB;AACtG,aAAW,OAAO,MAAM;AACtB,kBAAc,KAAK,OAAO;AAAA,EAC5B;AACF;AAJsB;;;ACvBtB,SAAS,eAAe;AACxB,SAAS,gBAAgB;AACzB,OAAO,UAAU;AAGV,IAAM,gBAAN,MAAoB;AAAA,EAL3B,OAK2B;AAAA;AAAA;AAAA,EACzB,aAAa,WAAW;AACtB,UAAM,cAAc,MAAM,QAAQ;AAClC,UAAM,QAAQ,YAAY,IAAI,OAAO;AAErC,QAAI,CAAC,SAAS,CAAC,MAAM,MAAO,QAAO;AACnC,WAAO;AAAA,EACT;AAAA,EAEA,aAAa,kBAAoC;AAC/C,UAAM,cAAc,MAAM,QAAQ;AAClC,UAAM,wBAAwB,YAAY,IAAI,uBAAuB,GAAG;AAExE,QAAI,CAAC,sBAAuB,QAAO;AAEnC,UAAM,MAAM,oBAAI,KAAK;AACrB,WAAO,IAAI,KAAK,qBAAqB,IAAI;AAAA,EAC3C;AAAA,EAEA,aAAa,YAAY;AACvB,UAAM,cAAc,MAAM,QAAQ;AAClC,WAAO,YAAY,IAAI,WAAW,GAAG,SAAS;AAAA,EAChD;AAAA,EAEA,aAAa,SAAS;AACpB,UAAM,cAAc,MAAM,QAAQ;AAClC,WAAO,YAAY,IAAI,QAAQ,GAAG,SAAS;AAAA,EAC7C;AAAA,EAEA,aAAa,gBAAiD,QAAmD;AAC/G,QAAI,CAAE,MAAM,KAAK,sBAAsB,MAAM,EAAI,UAAS,MAAM;AAAA,EAClE;AAAA,EAEA,aAAa,QAAQ,QAAkC;AACrD,UAAM,cAAc,MAAM,QAAQ;AAClC,UAAM,QAAQ,YAAY,IAAI,OAAO,GAAG;AAExC,QAAI,CAAC,SAAS,CAAC,MAAM,SAAS,MAAM,EAAG,QAAO;AAE9C,WAAO;AAAA,EACT;AAAA,EAEA,aAAa,WAAW,WAAqC;AAC3D,UAAM,cAAc,MAAM,QAAQ;AAClC,UAAM,WAAW,YAAY,IAAI,UAAU,GAAG;AAE9C,QAAI,CAAC,YAAY,CAAC,SAAS,SAAS,SAAS,EAAG,QAAO;AAEvD,WAAO;AAAA,EACT;AAAA,EAEA,aAAa,sBAAuD,QAI/C;AACnB,UAAM,cAAc,MAAM,QAAQ;AAElC,QAAI,OAAO,OAAO,SAAS;AACzB,YAAM,WAAW,YAAY,IAAI,UAAU,GAAG;AAE9C,UAAI,YAAY,CAAC,SAAS,SAAS,OAAO,OAAO,OAAO,EAAG,QAAO;AAAA,IACpE;AAEA,UAAM,aAAa,YAAY,IAAI,SAAS,GAAG;AAC/C,QAAI,CAAC,WAAY,QAAO;AAExB,UAAM,UAQA,KAAK,MAAM,KAAK,WAAW,OAAO,KAAK,YAAY,QAAQ,CAAC,EAAE,SAAS,CAAC;AAE9E,UAAM,iBAAiB,QAAQ,KAAK,CAAC,WAAW,OAAO,OAAO,OAAO,OAAO,QAAQ;AAEpF,WAAO,2BAA2B;AAAA,MAChC,QAAQ,OAAO;AAAA,MACf,QAAQ,OAAO;AAAA,MACf,MAAM,OAAO;AAAA,MACb,QAAQ,MAAM,KAAK,OAAO;AAAA,MAC1B;AAAA,IACF,CAAC;AAAA,EAWH;AACF;","names":[]}

package/dist/types-BUAlgqqh.d.ts

@@ -0,0 +1,39 @@
+import { ColumnDef } from '@tanstack/react-table';
+import { b as PageUrl } from './types-Bl61ob-7.js';
+import { D as DataListRetriever } from './useDataListRetriever-futhx3OP.js';
+
+type TableContent<T> = {
+    jsonApiData: T;
+    [key: string]: any;
+};
+interface TableStructureGeneratorInterface<T, U> {
+    generateTableStructure: (params: {
+        t: (key: string) => string;
+        generateUrl: (params: {
+            page: string | PageUrl | string;
+            id?: string;
+        }) => string;
+        data: T[];
+        fields: Array<U>;
+        checkedIds?: string[];
+        toggleId?: (id: string) => void;
+    }) => {
+        data: TableContent<T>[];
+        columns: ColumnDef<TableContent<T>>[];
+    };
+}
+type UseTableStructureHookParams<T, U> = {
+    data: T[];
+    fields: Array<U>;
+    checkedIds?: string[];
+    toggleId?: (id: string) => void;
+    dataRetriever?: DataListRetriever<T>;
+    context?: Record<string, any>;
+};
+type UseTableStructureHookReturn<T> = {
+    data: TableContent<T>[];
+    columns: ColumnDef<TableContent<T>>[];
+};
+type UseTableStructureHook<T, U> = (params: UseTableStructureHookParams<T, U>) => UseTableStructureHookReturn<T>;
+
+export type { TableContent as T, UseTableStructureHook as U, UseTableStructureHookParams as a, UseTableStructureHookReturn as b, TableStructureGeneratorInterface as c };

package/dist/{types-DluCaP1I.d.ts → types-Bl61ob-7.d.mts}

@@ -1,4 +1,21 @@
-import { A as ApiRequestDataTypeInterface, F as FieldSelector } from './ApiRequestDataTypeInterface-CUKFDBx2.js';
+type GetterKeys<T> = {
+    [K in keyof T]: T[K] extends () => any ? never : K;
+}[keyof T];
+type FieldSelector<T> = {
+    type: string;
+    fields: ReadonlyArray<GetterKeys<T>>;
+};
+declare function createJsonApiInclusion<T>(dataType: string, fields: ReadonlyArray<GetterKeys<T>>): FieldSelector<T>;
+
+type ApiRequestDataTypeInterface = {
+    name: string;
+    cache?: string;
+    inclusions?: Record<string, {
+        types?: string[];
+        fields?: FieldSelector<any>[];
+    }>;
+    model: new () => any;
+};
 
 /**
  * Permission actions
@@ -92,4 +109,4 @@ type ModuleFactory = (params: {
     }>;
 }) => ModuleWithPermissions;
 
-export { Action as A, type ModulePermissionDefinition as M, type PermissionCheck as P, type PageUrl as a, type ModuleDefinition as b, type PermissionConfig as c, type PermissionModule as d, type PermissionUser as e, type ModuleWithPermissions as f, type ModuleFactory as g };
+export { type ApiRequestDataTypeInterface as A, type FieldSelector as F, type GetterKeys as G, type ModuleWithPermissions as M, type PermissionCheck as P, Action as a, type PageUrl as b, createJsonApiInclusion as c, type ModulePermissionDefinition as d, type ModuleDefinition as e, type PermissionConfig as f, type PermissionModule as g, type PermissionUser as h, type ModuleFactory as i };

package/dist/{types-lQVA8d_P.d.mts → types-Bl61ob-7.d.ts}

@@ -1,4 +1,21 @@
-import { A as ApiRequestDataTypeInterface, F as FieldSelector } from './ApiRequestDataTypeInterface-CUKFDBx2.mjs';
+type GetterKeys<T> = {
+    [K in keyof T]: T[K] extends () => any ? never : K;
+}[keyof T];
+type FieldSelector<T> = {
+    type: string;
+    fields: ReadonlyArray<GetterKeys<T>>;
+};
+declare function createJsonApiInclusion<T>(dataType: string, fields: ReadonlyArray<GetterKeys<T>>): FieldSelector<T>;
+
+type ApiRequestDataTypeInterface = {
+    name: string;
+    cache?: string;
+    inclusions?: Record<string, {
+        types?: string[];
+        fields?: FieldSelector<any>[];
+    }>;
+    model: new () => any;
+};
 
 /**
  * Permission actions
@@ -92,4 +109,4 @@ type ModuleFactory = (params: {
     }>;
 }) => ModuleWithPermissions;
 
-export { Action as A, type ModulePermissionDefinition as M, type PermissionCheck as P, type PageUrl as a, type ModuleDefinition as b, type PermissionConfig as c, type PermissionModule as d, type PermissionUser as e, type ModuleWithPermissions as f, type ModuleFactory as g };
+export { type ApiRequestDataTypeInterface as A, type FieldSelector as F, type GetterKeys as G, type ModuleWithPermissions as M, type PermissionCheck as P, Action as a, type PageUrl as b, createJsonApiInclusion as c, type ModulePermissionDefinition as d, type ModuleDefinition as e, type PermissionConfig as f, type PermissionModule as g, type PermissionUser as h, type ModuleFactory as i };

package/dist/types-iVdVY7ba.d.mts

@@ -0,0 +1,39 @@
+import { ColumnDef } from '@tanstack/react-table';
+import { b as PageUrl } from './types-Bl61ob-7.mjs';
+import { D as DataListRetriever } from './useDataListRetriever-futhx3OP.mjs';
+
+type TableContent<T> = {
+    jsonApiData: T;
+    [key: string]: any;
+};
+interface TableStructureGeneratorInterface<T, U> {
+    generateTableStructure: (params: {
+        t: (key: string) => string;
+        generateUrl: (params: {
+            page: string | PageUrl | string;
+            id?: string;
+        }) => string;
+        data: T[];
+        fields: Array<U>;
+        checkedIds?: string[];
+        toggleId?: (id: string) => void;
+    }) => {
+        data: TableContent<T>[];
+        columns: ColumnDef<TableContent<T>>[];
+    };
+}
+type UseTableStructureHookParams<T, U> = {
+    data: T[];
+    fields: Array<U>;
+    checkedIds?: string[];
+    toggleId?: (id: string) => void;
+    dataRetriever?: DataListRetriever<T>;
+    context?: Record<string, any>;
+};
+type UseTableStructureHookReturn<T> = {
+    data: TableContent<T>[];
+    columns: ColumnDef<TableContent<T>>[];
+};
+type UseTableStructureHook<T, U> = (params: UseTableStructureHookParams<T, U>) => UseTableStructureHookReturn<T>;
+
+export type { TableContent as T, UseTableStructureHook as U, UseTableStructureHookParams as a, UseTableStructureHookReturn as b, TableStructureGeneratorInterface as c };

package/dist/useSocket-Cn7fB_B1.d.mts

@@ -0,0 +1,25 @@
+import { N as NotificationInterface } from './notification.interface-BBgMUdLR.mjs';
+
+interface UseSocketOptions {
+    token: string;
+}
+interface SocketLike {
+    emit: (event: string, ...args: any[]) => void;
+    on: (event: string, callback: (...args: any[]) => void) => void;
+    off: (event: string, callback?: (...args: any[]) => void) => void;
+    connected: boolean;
+}
+interface UseSocketReturn {
+    socket: SocketLike | null;
+    isConnected: boolean;
+    messages: any[];
+    socketNotifications: NotificationInterface[];
+    sendMessage: (event: string, data: any) => void;
+    removeMessage: (index: number) => void;
+    removeSocketNotification: (index: number) => void;
+    clearMessages: () => void;
+    clearSocketNotifications: () => void;
+}
+declare function useSocket({ token }: UseSocketOptions): UseSocketReturn;
+
+export { useSocket as u };

package/dist/useSocket-DzMKRKCA.d.ts

@@ -0,0 +1,25 @@
+import { N as NotificationInterface } from './notification.interface-gyvT-Z2F.js';
+
+interface UseSocketOptions {
+    token: string;
+}
+interface SocketLike {
+    emit: (event: string, ...args: any[]) => void;
+    on: (event: string, callback: (...args: any[]) => void) => void;
+    off: (event: string, callback?: (...args: any[]) => void) => void;
+    connected: boolean;
+}
+interface UseSocketReturn {
+    socket: SocketLike | null;
+    isConnected: boolean;
+    messages: any[];
+    socketNotifications: NotificationInterface[];
+    sendMessage: (event: string, data: any) => void;
+    removeMessage: (index: number) => void;
+    removeSocketNotification: (index: number) => void;
+    clearMessages: () => void;
+    clearSocketNotifications: () => void;
+}
+declare function useSocket({ token }: UseSocketOptions): UseSocketReturn;
+
+export { useSocket as u };

package/dist/user.fields-CbdObSmS.d.mts

@@ -0,0 +1,18 @@
+declare enum RoleFields {
+    roleId = "roleId",
+    name = "name",
+    description = "description",
+    createdAt = "createdAt",
+    updatedAt = "updatedAt"
+}
+
+declare enum UserFields {
+    userId = "userId",
+    name = "name",
+    email = "email",
+    relevance = "relevance",
+    createdAt = "createdAt",
+    updatedAt = "updatedAt"
+}
+
+export { RoleFields as R, UserFields as U };

package/dist/user.fields-CbdObSmS.d.ts

@@ -0,0 +1,18 @@
+declare enum RoleFields {
+    roleId = "roleId",
+    name = "name",
+    description = "description",
+    createdAt = "createdAt",
+    updatedAt = "updatedAt"
+}
+
+declare enum UserFields {
+    userId = "userId",
+    name = "name",
+    email = "email",
+    relevance = "relevance",
+    createdAt = "createdAt",
+    updatedAt = "updatedAt"
+}
+
+export { RoleFields as R, UserFields as U };

package/dist/utils/index.d.mts

@@ -2,10 +2,9 @@ import { ClassValue } from 'clsx';
 export { ClassValue } from 'clsx';
 import * as React from 'react';
 import { ReactElement } from 'react';
-import { f as ModuleWithPermissions, A as Action } from '../types-lQVA8d_P.mjs';
+import { M as ModuleWithPermissions, a as Action } from '../types-Bl61ob-7.mjs';
 import { z } from 'zod';
 import { PartialBlock } from '@blocknote/core';
-import '../ApiRequestDataTypeInterface-CUKFDBx2.mjs';
 
 declare function cn(...inputs: ClassValue[]): string;
 

package/dist/utils/index.d.ts

@@ -2,10 +2,9 @@ import { ClassValue } from 'clsx';
 export { ClassValue } from 'clsx';
 import * as React from 'react';
 import { ReactElement } from 'react';
-import { f as ModuleWithPermissions, A as Action } from '../types-DluCaP1I.js';
+import { M as ModuleWithPermissions, a as Action } from '../types-Bl61ob-7.js';
 import { z } from 'zod';
 import { PartialBlock } from '@blocknote/core';
-import '../ApiRequestDataTypeInterface-CUKFDBx2.js';
 
 declare function cn(...inputs: ClassValue[]): string;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carlonicora/nextjs-jsonapi",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Next.js JSON:API client with server/client support and caching",
   "author": "Carlo Nicora",
   "license": "GPL-3.0-or-later",
@@ -8,7 +8,6 @@
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
-  "sideEffects": false,
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -91,6 +90,7 @@
   },
   "files": [
     "dist",
+    "src",
     "README.md"
   ],
   "peerDependencies": {
@@ -119,6 +119,7 @@
     "@dnd-kit/core": "^6.3.1",
     "@dnd-kit/sortable": "^10.0.0",
     "@dnd-kit/utilities": "^3.2.2",
+    "@hookform/resolvers": "^5.2.2",
     "@radix-ui/react-accordion": "^1.2.12",
     "@radix-ui/react-alert-dialog": "^1.1.15",
     "@radix-ui/react-avatar": "^1.1.11",
@@ -146,7 +147,7 @@
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "cmdk": "^1.1.1",
-    "cookies-next": "^6.0.0",
+    "cookies-next": "^6.1.1",
     "d3": "^7.9.0",
     "date-fns": "^4.1.0",
     "embla-carousel-react": "^8.6.0",
@@ -155,10 +156,12 @@
     "next-themes": "^0.4.6",
     "react-day-picker": "^9.11.3",
     "react-dropzone": "^14.3.8",
+    "react-hook-form": "^7.68.0",
     "react-markdown": "^10.1.0",
     "react-resizable-panels": "^3.0.6",
     "recharts": "^3.5.1",
     "remark-gfm": "^4.0.1",
+    "socket.io-client": "^4.8.1",
     "sonner": "^2.0.7",
     "tailwind-merge": "^3.4.0",
     "uuid": "^13.0.0",

package/src/atoms/index.ts

@@ -0,0 +1 @@
+export * from "./recentPagesAtom";

package/src/atoms/recentPagesAtom.ts

@@ -0,0 +1,10 @@
+import { atomWithStorage } from "jotai/utils";
+
+export interface RecentPage {
+  url: string;
+  title: string;
+  moduleType: string;
+  timestamp: number;
+}
+
+export const recentPagesAtom = atomWithStorage<RecentPage[]>("recentPages", []);

package/src/client/context/JsonApiContext.ts

@@ -0,0 +1,61 @@
+"use client";
+
+import { createContext, useContext } from "react";
+
+export type CacheProfile = "seconds" | "minutes" | "hours" | "days" | "weeks" | "max" | "default";
+
+export interface JsonApiConfig {
+  /**
+   * The base URL for API requests (e.g., https://api.example.com)
+   */
+  apiUrl: string;
+
+  /**
+   * Custom token getter function. If not provided, will use default cookie-based token retrieval.
+   */
+  tokenGetter?: () => Promise<string | undefined>;
+
+  /**
+   * Custom language getter function. If not provided, will use browser locale or next-intl.
+   */
+  languageGetter?: () => Promise<string>;
+
+  /**
+   * Default headers to include in all requests
+   */
+  defaultHeaders?: Record<string, string>;
+
+  /**
+   * Global error handler for failed requests (client-side only)
+   */
+  onError?: (status: number, message: string) => void;
+
+  /**
+   * Cache configuration
+   */
+  cacheConfig?: {
+    defaultProfile: CacheProfile;
+  };
+
+  /**
+   * Function to bootstrap the data class registry.
+   * Will be called automatically when needed.
+   */
+  bootstrapper?: () => void;
+}
+
+const JsonApiContext = createContext<JsonApiConfig | null>(null);
+
+export function useJsonApiConfig(): JsonApiConfig {
+  const config = useContext(JsonApiContext);
+  if (!config) {
+    throw new Error("useJsonApiConfig must be used within a JsonApiProvider");
+  }
+  return config;
+}
+
+export function useJsonApiConfigOptional(): JsonApiConfig | null {
+  return useContext(JsonApiContext);
+}
+
+export { JsonApiContext };

package/src/client/context/JsonApiProvider.tsx

@@ -0,0 +1,27 @@
+"use client";
+
+import React, { useEffect, useMemo } from "react";
+import { JsonApiConfig, JsonApiContext } from "./JsonApiContext";
+
+export interface JsonApiProviderProps {
+  config: JsonApiConfig;
+  children: React.ReactNode;
+}
+
+export function JsonApiProvider({ config, children }: JsonApiProviderProps) {
+  // Run bootstrapper on mount if provided
+  useEffect(() => {
+    if (config.bootstrapper) {
+      config.bootstrapper();
+    }
+  }, [config.bootstrapper]);
+
+  // Memoize config to prevent unnecessary re-renders
+  const memoizedConfig = useMemo(() => config, [config]);
+
+  return (
+    <JsonApiContext.Provider value={memoizedConfig}>
+      {children}
+    </JsonApiContext.Provider>
+  );
+}

package/src/client/context/index.ts

@@ -0,0 +1,2 @@
+export * from "./JsonApiContext";
+export * from "./JsonApiProvider";

package/src/client/hooks/index.ts

@@ -0,0 +1,3 @@
+export * from "./useJsonApiGet";
+export * from "./useJsonApiMutation";
+export * from "./useRehydration";