@carlonicora/nextjs-jsonapi 1.8.1 → 1.9.0

package/dist/index.mjs

@@ -8,7 +8,7 @@ import {
   getRoleId,
   getTrackablePages,
   isRolesConfigured
-} from "./chunk-IGOWVLJH.mjs";
+} from "./chunk-33UYFFIK.mjs";
 import {
   AbstractApiData,
   AbstractService,
@@ -88,14 +88,19 @@ import {
   useComposedRefs,
   useIsMobile,
   userObjectSchema
-} from "./chunk-CK5KLBZV.mjs";
+} from "./chunk-MOVONDSX.mjs";
 import "./chunk-C7C7VY4F.mjs";
 import {
   DataClassRegistry,
   JsonApiDataFactory,
+  getBootstrapper,
+  hasBootstrapper,
+  resetBootstrapStore,
+  setBootstrapper,
   translateData,
-  translateResponse
-} from "./chunk-SAL7XW2G.mjs";
+  translateResponse,
+  tryBootstrap
+} from "./chunk-CHNXYTKO.mjs";
 import "./chunk-AUXK7QSA.mjs";
 import "./chunk-PAWJFY3S.mjs";
 export {
@@ -167,6 +172,7 @@ export {
   formatDate,
   getApiUrl,
   getAppUrl,
+  getBootstrapper,
   getClientGlobalErrorHandler,
   getGlobalErrorHandler,
   getIcon,
@@ -181,13 +187,17 @@ export {
   getTokenHandler,
   getTrackablePages,
   getValueFromPath,
+  hasBootstrapper,
   isRolesConfigured,
   rehydrate,
   rehydrateList,
+  resetBootstrapStore,
+  setBootstrapper,
   setClientGlobalErrorHandler,
   setGlobalErrorHandler,
   translateData,
   translateResponse,
+  tryBootstrap,
   useComposedRefs,
   useIsMobile,
   userObjectSchema

package/dist/server/index.js

@@ -12,12 +12,12 @@ var _chunk3ZPK4QOBjs = require('../chunk-3ZPK4QOB.js');
 
 
 
-var _chunk7Z7FEMEBjs = require('../chunk-7Z7FEMEB.js');
+var _chunkLPBABDEPjs = require('../chunk-LPBABDEP.js');
 require('../chunk-IBS6NI7D.js');
 
 
 
-var _chunkCKS6SVUKjs = require('../chunk-CKS6SVUK.js');
+var _chunkUVXEP2EDjs = require('../chunk-UVXEP2ED.js');
 
 
 var _chunkYUO55Q5Ajs = require('../chunk-YUO55Q5A.js');
@@ -93,7 +93,7 @@ var ServerSession = class {
     if (!rawModules) return false;
     const modules = JSON.parse(_zlib2.default.gunzipSync(Buffer.from(rawModules, "base64")).toString());
     const selectedModule = modules.find((module) => module.id === params.module.moduleId);
-    return _chunk7Z7FEMEBjs.checkPermissionsFromServer.call(void 0, {
+    return _chunkLPBABDEPjs.checkPermissionsFromServer.call(void 0, {
       module: params.module,
       action: params.action,
       data: params.data,
@@ -165,7 +165,7 @@ async function ServerJsonApiGet(params) {
     language: params.language,
     additionalHeaders: _optionalChain([_serverConfig, 'optionalAccess', _26 => _26.additionalHeaders])
   });
-  return _chunkCKS6SVUKjs.translateResponse.call(void 0, {
+  return _chunkUVXEP2EDjs.translateResponse.call(void 0, {
     classKey: params.classKey,
     apiResponse,
     companyId: params.companyId,
@@ -186,7 +186,7 @@ async function ServerJsonApiPost(params) {
   if (!body) {
     body = {};
   } else if (params.overridesJsonApiCreation !== true) {
-    body = _chunkCKS6SVUKjs.JsonApiDataFactory.create(params.classKey, body);
+    body = _chunkUVXEP2EDjs.JsonApiDataFactory.create(params.classKey, body);
   }
   const apiResponse = await _chunk3ZPK4QOBjs.serverRequest.call(void 0, {
     method: "POST",
@@ -198,7 +198,7 @@ async function ServerJsonApiPost(params) {
     language: params.language,
     additionalHeaders: _optionalChain([_serverConfig, 'optionalAccess', _27 => _27.additionalHeaders])
   });
-  return _chunkCKS6SVUKjs.translateResponse.call(void 0, {
+  return _chunkUVXEP2EDjs.translateResponse.call(void 0, {
     classKey: _nullishCoalesce(params.responseType, () => ( params.classKey)),
     apiResponse,
     companyId: params.companyId,
@@ -213,7 +213,7 @@ async function ServerJsonApiPut(params) {
   if (!body) {
     body = {};
   } else {
-    body = _chunkCKS6SVUKjs.JsonApiDataFactory.create(params.classKey, body);
+    body = _chunkUVXEP2EDjs.JsonApiDataFactory.create(params.classKey, body);
   }
   const apiResponse = await _chunk3ZPK4QOBjs.serverRequest.call(void 0, {
     method: "PUT",
@@ -225,7 +225,7 @@ async function ServerJsonApiPut(params) {
     language: params.language,
     additionalHeaders: _optionalChain([_serverConfig, 'optionalAccess', _28 => _28.additionalHeaders])
   });
-  return _chunkCKS6SVUKjs.translateResponse.call(void 0, {
+  return _chunkUVXEP2EDjs.translateResponse.call(void 0, {
     classKey: _nullishCoalesce(params.responseType, () => ( params.classKey)),
     apiResponse,
     companyId: params.companyId,
@@ -240,7 +240,7 @@ async function ServerJsonApiPatch(params) {
   if (!body) {
     body = {};
   } else if (params.overridesJsonApiCreation !== true) {
-    body = _chunkCKS6SVUKjs.JsonApiDataFactory.create(params.classKey, body);
+    body = _chunkUVXEP2EDjs.JsonApiDataFactory.create(params.classKey, body);
   }
   const apiResponse = await _chunk3ZPK4QOBjs.serverRequest.call(void 0, {
     method: "PATCH",
@@ -252,7 +252,7 @@ async function ServerJsonApiPatch(params) {
     language: params.language,
     additionalHeaders: _optionalChain([_serverConfig, 'optionalAccess', _29 => _29.additionalHeaders])
   });
-  return _chunkCKS6SVUKjs.translateResponse.call(void 0, {
+  return _chunkUVXEP2EDjs.translateResponse.call(void 0, {
     classKey: _nullishCoalesce(params.responseType, () => ( params.classKey)),
     apiResponse,
     companyId: params.companyId,
@@ -271,7 +271,7 @@ async function ServerJsonApiDelete(params) {
     language: params.language,
     additionalHeaders: _optionalChain([_serverConfig, 'optionalAccess', _30 => _30.additionalHeaders])
   });
-  return _chunkCKS6SVUKjs.translateResponse.call(void 0, {
+  return _chunkUVXEP2EDjs.translateResponse.call(void 0, {
     classKey: _nullishCoalesce(params.responseType, () => ( params.classKey)),
     apiResponse,
     companyId: params.companyId,
@@ -303,5 +303,5 @@ _chunk7QVYU63Ejs.__name.call(void 0, ServerJsonApiDelete, "ServerJsonApiDelete")
 
 
 
-exports.ServerAuthService = _chunk7Z7FEMEBjs.AuthService; exports.ServerCompanyService = _chunk7Z7FEMEBjs.CompanyService; exports.ServerContentService = _chunk7Z7FEMEBjs.ContentService; exports.ServerFeatureService = _chunk7Z7FEMEBjs.FeatureService; exports.ServerJsonApiDelete = ServerJsonApiDelete; exports.ServerJsonApiGet = ServerJsonApiGet; exports.ServerJsonApiPatch = ServerJsonApiPatch; exports.ServerJsonApiPost = ServerJsonApiPost; exports.ServerJsonApiPut = ServerJsonApiPut; exports.ServerNotificationService = _chunk7Z7FEMEBjs.NotificationService; exports.ServerPushService = _chunk7Z7FEMEBjs.PushService; exports.ServerRoleService = _chunk7Z7FEMEBjs.RoleService; exports.ServerS3Service = _chunk7Z7FEMEBjs.S3Service; exports.ServerSession = ServerSession; exports.ServerUserService = _chunk7Z7FEMEBjs.UserService; exports.configureServerJsonApi = configureServerJsonApi; exports.getServerApiUrl = getServerApiUrl; exports.getServerAppUrl = getServerAppUrl; exports.getServerToken = _chunkYUO55Q5Ajs.getServerToken; exports.getServerTrackablePages = getServerTrackablePages; exports.invalidateCacheTag = invalidateCacheTag; exports.invalidateCacheTags = invalidateCacheTags; exports.serverRequest = _chunk3ZPK4QOBjs.serverRequest;
+exports.ServerAuthService = _chunkLPBABDEPjs.AuthService; exports.ServerCompanyService = _chunkLPBABDEPjs.CompanyService; exports.ServerContentService = _chunkLPBABDEPjs.ContentService; exports.ServerFeatureService = _chunkLPBABDEPjs.FeatureService; exports.ServerJsonApiDelete = ServerJsonApiDelete; exports.ServerJsonApiGet = ServerJsonApiGet; exports.ServerJsonApiPatch = ServerJsonApiPatch; exports.ServerJsonApiPost = ServerJsonApiPost; exports.ServerJsonApiPut = ServerJsonApiPut; exports.ServerNotificationService = _chunkLPBABDEPjs.NotificationService; exports.ServerPushService = _chunkLPBABDEPjs.PushService; exports.ServerRoleService = _chunkLPBABDEPjs.RoleService; exports.ServerS3Service = _chunkLPBABDEPjs.S3Service; exports.ServerSession = ServerSession; exports.ServerUserService = _chunkLPBABDEPjs.UserService; exports.configureServerJsonApi = configureServerJsonApi; exports.getServerApiUrl = getServerApiUrl; exports.getServerAppUrl = getServerAppUrl; exports.getServerToken = _chunkYUO55Q5Ajs.getServerToken; exports.getServerTrackablePages = getServerTrackablePages; exports.invalidateCacheTag = invalidateCacheTag; exports.invalidateCacheTags = invalidateCacheTags; exports.serverRequest = _chunk3ZPK4QOBjs.serverRequest;
 //# sourceMappingURL=index.js.map

package/dist/server/index.mjs

@@ -12,12 +12,12 @@ import {
   S3Service,
   UserService,
   checkPermissionsFromServer
-} from "../chunk-CK5KLBZV.mjs";
+} from "../chunk-MOVONDSX.mjs";
 import "../chunk-C7C7VY4F.mjs";
 import {
   JsonApiDataFactory,
   translateResponse
-} from "../chunk-SAL7XW2G.mjs";
+} from "../chunk-CHNXYTKO.mjs";
 import {
   getServerToken
 } from "../chunk-F5UNXZ3J.mjs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carlonicora/nextjs-jsonapi",
-  "version": "1.8.1",
+  "version": "1.9.0",
   "description": "Next.js JSON:API client with server/client support and caching",
   "author": "Carlo Nicora",
   "license": "GPL-3.0-or-later",

package/src/client/JsonApiClient.ts

@@ -3,6 +3,7 @@
 import { JsonApiDataFactory } from "../core/factories/JsonApiDataFactory";
 import { ApiRequestDataTypeInterface } from "../core/interfaces/ApiRequestDataTypeInterface";
 import { ApiResponseInterface } from "../core/interfaces/ApiResponseInterface";
+import { setBootstrapper } from "../core/registry/bootstrapStore";
 import { translateResponse } from "../core/utils/translateResponse";
 import { ModuleWithPermissions } from "../permissions/types";
 import { directFetch } from "./request";
@@ -30,6 +31,7 @@ export function configureClientJsonApi(config: {
 }): void {
   _clientConfig = config;
   if (config.bootstrapper) {
+    setBootstrapper(config.bootstrapper);
     config.bootstrapper();
   }
 }

package/src/client/config.ts

@@ -1,6 +1,7 @@
 "use client";
 
 import { ModuleWithPermissions } from "../permissions/types";
+import { setBootstrapper } from "../core/registry/bootstrapStore";
 
 // Config storage for client-side contexts
 let _clientConfig: {
@@ -23,8 +24,9 @@ export function configureJsonApi(config: {
   additionalHeaders?: Record<string, string>;
 }): void {
   _clientConfig = config;
-  // Call bootstrapper immediately to register all modules
+  // Register and call bootstrapper to register all modules
   if (config.bootstrapper) {
+    setBootstrapper(config.bootstrapper);
     config.bootstrapper();
   }
 }

package/src/components/containers/PageContainer.tsx

@@ -9,7 +9,7 @@ export function PageContainer({ children, testId, className }: PageContainerProp
   return (
     <div className={`flex h-full w-full flex-col`} data-testid={testId}>
       <Header />
-      <main className={cn(`flex w-full flex-1 flex-col gap-y-4 pt-4 pl-4 pr-4`, className)}>{children}</main>
+      <main className={cn(`flex w-full flex-1 flex-col gap-y-4 pt-4 pl-4 pr-4 pb-20`, className)}>{children}</main>
     </div>
   );
 }

package/src/core/registry/ModuleRegistry.ts

@@ -1,5 +1,6 @@
 import { ApiRequestDataTypeInterface } from "../interfaces/ApiRequestDataTypeInterface";
 import { ModuleWithPermissions } from "../../permissions/types";
+import { tryBootstrap, hasBootstrapper } from "./bootstrapStore";
 
 // Foundation module types - defined by LIBRARY
 export interface FoundationModuleDefinitions {
@@ -33,14 +34,34 @@ class ModuleRegistryClass {
   }
 
   get<K extends keyof ModuleDefinitions>(name: K): ModuleDefinitions[K] {
-    const module = this._modules.get(name as string);
+    let module = this._modules.get(name as string);
+
+    // Self-healing: if module not found, try bootstrapping first
     if (!module) {
-      throw new Error(`Module "${String(name)}" not registered. Call bootstrap() first.`);
+      const didBootstrap = tryBootstrap();
+      if (didBootstrap) {
+        // Retry after bootstrap
+        module = this._modules.get(name as string);
+      }
     }
+
+    if (!module) {
+      // Provide helpful error message based on state
+      const hint = hasBootstrapper()
+        ? "Bootstrap was called but module still not found. Check module registration."
+        : "No bootstrapper registered. Ensure configureJsonApi({ bootstrapper }) is called before accessing modules.";
+      throw new Error(`Module "${String(name)}" not registered. ${hint}`);
+    }
+
     return module as ModuleDefinitions[K];
   }
 
   findByName(moduleName: string): ModuleWithPermissions {
+    // Self-healing: try bootstrap if registry is empty
+    if (this._modules.size === 0) {
+      tryBootstrap();
+    }
+
     // Search by module's name property (e.g., "topics", "articles")
     for (const module of this._modules.values()) {
       if ((module as ModuleWithPermissions).name === moduleName) {
@@ -52,7 +73,16 @@ class ModuleRegistryClass {
 
   findByModelName(modelName: string): ModuleWithPermissions {
     // Direct lookup by registry key (e.g., "Article", "Document")
-    const module = this._modules.get(modelName);
+    let module = this._modules.get(modelName);
+
+    // Self-healing: if not found, try bootstrapping
+    if (!module) {
+      const didBootstrap = tryBootstrap();
+      if (didBootstrap) {
+        module = this._modules.get(modelName);
+      }
+    }
+
     if (!module) {
       throw new Error(`Module not found for model: ${modelName}`);
     }

package/src/core/registry/bootstrapStore.ts

@@ -0,0 +1,63 @@
+/**
+ * Centralized bootstrap store accessible from ModuleRegistry.
+ * This file has NO external dependencies to avoid circular imports.
+ *
+ * The bootstrap store allows ModuleRegistry to call the app's bootstrapper
+ * when modules are accessed before bootstrap() was called, providing
+ * self-healing behavior for module evaluation order issues.
+ */
+
+type BootstrapperFn = () => void;
+
+let _bootstrapper: BootstrapperFn | null = null;
+let _bootstrapAttempted = false;
+
+/**
+ * Register the bootstrapper function.
+ * Called by configureJsonApi() from client/config, client/JsonApiClient, or unified/JsonApiRequest.
+ */
+export function setBootstrapper(fn: BootstrapperFn): void {
+  _bootstrapper = fn;
+}
+
+/**
+ * Get the registered bootstrapper function.
+ * Returns null if no bootstrapper has been registered.
+ */
+export function getBootstrapper(): BootstrapperFn | null {
+  return _bootstrapper;
+}
+
+/**
+ * Attempt to run the bootstrapper if one is registered.
+ * Returns true if bootstrapper was executed, false if not available.
+ * Safe to call multiple times - bootstrapper is expected to be idempotent.
+ */
+export function tryBootstrap(): boolean {
+  if (_bootstrapAttempted && !_bootstrapper) {
+    // Already tried and no bootstrapper available
+    return false;
+  }
+  _bootstrapAttempted = true;
+
+  if (_bootstrapper) {
+    _bootstrapper();
+    return true;
+  }
+  return false;
+}
+
+/**
+ * Check if a bootstrapper has been registered.
+ */
+export function hasBootstrapper(): boolean {
+  return _bootstrapper !== null;
+}
+
+/**
+ * Reset the bootstrap store. Useful for testing.
+ */
+export function resetBootstrapStore(): void {
+  _bootstrapper = null;
+  _bootstrapAttempted = false;
+}

package/src/core/registry/index.ts

@@ -1,3 +1,4 @@
 export * from "./DataClassRegistry";
 export * from "./ModuleRegistrar";
 export * from "./ModuleRegistry";
+export * from "./bootstrapStore";

package/src/unified/JsonApiRequest.ts

@@ -2,6 +2,7 @@ import { JsonApiDataFactory } from "../core/factories/JsonApiDataFactory";
 import { ApiData } from "../core/interfaces/ApiData";
 import { ApiRequestDataTypeInterface } from "../core/interfaces/ApiRequestDataTypeInterface";
 import { ApiResponseInterface } from "../core/interfaces/ApiResponseInterface";
+import { setBootstrapper } from "../core/registry/bootstrapStore";
 import { translateResponse } from "../core/utils/translateResponse";
 import { ModuleWithPermissions } from "../permissions/types";
 
@@ -58,8 +59,9 @@ export function configureJsonApi(config: {
   additionalHeaders?: Record<string, string>;
 }): void {
   _staticConfig = config;
-  // Call bootstrapper immediately to register all modules
+  // Register and call bootstrapper to register all modules
   if (config.bootstrapper) {
+    setBootstrapper(config.bootstrapper);
     config.bootstrapper();
   }
 }

package/dist/JsonApiRequest-2OM5NDAW.js

@@ -1,24 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
-
-
-
-
-
-
-
-
-
-var _chunkCKS6SVUKjs = require('./chunk-CKS6SVUK.js');
-require('./chunk-7QVYU63E.js');
-
-
-
-
-
-
-
-
-
-
-exports.JsonApiDelete = _chunkCKS6SVUKjs.JsonApiDelete; exports.JsonApiGet = _chunkCKS6SVUKjs.JsonApiGet; exports.JsonApiPatch = _chunkCKS6SVUKjs.JsonApiPatch; exports.JsonApiPost = _chunkCKS6SVUKjs.JsonApiPost; exports.JsonApiPut = _chunkCKS6SVUKjs.JsonApiPut; exports.configureJsonApi = _chunkCKS6SVUKjs.configureJsonApi; exports.getApiUrl = _chunkCKS6SVUKjs.getApiUrl; exports.getAppUrl = _chunkCKS6SVUKjs.getAppUrl; exports.getTrackablePages = _chunkCKS6SVUKjs.getTrackablePages;
-//# sourceMappingURL=JsonApiRequest-2OM5NDAW.js.map