@griddo/ax 11.10.23 → 11.10.24

package/src/services/SchemasService.ts

@@ -0,0 +1,240 @@
+import type { IRichTextConfig } from "@ax/components/Fields/Wysiwyg/helpers";
+import type { IGriddoTheme, ISchema, ModuleCategoryInfo } from "@ax/types";
+
+/**
+ * Error thrown when schemas are accessed before being loaded
+ */
+class SchemasNotLoadedError extends Error {
+	constructor() {
+		super("Schemas have not been loaded yet. Call loadSchemas() first.");
+		this.name = "SchemasNotLoadedError";
+	}
+}
+
+/**
+ * Singleton service for managing schemas loaded from API.
+ *
+ * This service acts as a central store for schemas that can be accessed
+ * from both React components (via hooks) and non-React code (thunks, helpers).
+ *
+ * @example
+ * // In a thunk or helper
+ * import { schemasService } from "@ax/services";
+ * const schemas = schemasService.getSchemas();
+ * const module = schemas.ui.modules["ModuleName"];
+ *
+ * @example
+ * // In a React component via a hook
+ * import { useMemo } from "react";
+ * import { schemasService } from "@ax/services";
+ *
+ * const MyComponent = () => {
+ *   // Optionally, wrap access in useMemo to avoid unnecessary re-renders
+ *   const schemas = useMemo(() => {
+ *     if (schemasService.isLoaded()) {
+ *       return schemasService.getSchemas();
+ *     }
+ *     return null;
+ *   }, []);
+ *
+ *   if (!schemas) {
+ *     return <div>Loading...</div>;
+ *   }
+ *   const module = schemas.ui.modules["ModuleName"];
+ *   return <div>{module.label}</div>;
+ * };
+ *
+ * @example
+ * // Check if loaded before accessing
+ * if (schemasService.isLoaded()) {
+ *   const schemas = schemasService.getSchemas();
+ * }
+ */
+class SchemasService {
+	private schemas: ISchemas | null = null;
+	private instanceId: string;
+
+	constructor(instanceId?: string) {
+		this.instanceId = instanceId || `instance-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+	}
+
+	/**
+	 * Store schemas data in the service.
+	 * Should be called after successfully fetching schemas from the API.
+	 */
+	setSchemas(schemas: ISchemas): void {
+		this.schemas = schemas;
+	}
+
+	/**
+	 * Get the stored schemas.
+	 * @throws {SchemasNotLoadedError} if schemas have not been loaded yet
+	 */
+	getSchemas(): ISchemas {
+		if (this.schemas === null) {
+			throw new SchemasNotLoadedError();
+		}
+		return this.schemas;
+	}
+
+	/**
+	 * Check if schemas have been loaded.
+	 */
+	isLoaded(): boolean {
+		return this.schemas !== null;
+	}
+
+	/**
+	 * Clear the stored schemas.
+	 * Useful when changing sites or logging out.
+	 */
+	clear(): void {
+		this.schemas = null;
+	}
+
+	getInstanceId(): string {
+		return this.instanceId;
+	}
+}
+
+/**
+ * Singleton pattern that survives module re-evaluation.
+ *
+ * This ensures that even if the module is re-evaluated (e.g., during HMR),
+ * we reuse the same instance stored in the global object.
+ */
+const getSchemasService = (): SchemasService => {
+	const globalKey = "__GRIDDO_SCHEMAS_SERVICE__";
+	const debugKey = "__GRIDDO_SCHEMAS_SERVICE_DEBUG__";
+
+	// In browser environment, use window
+	if (typeof window !== "undefined") {
+		const existingInstance = (window as any)[globalKey];
+
+		if (existingInstance) {
+			// Track access for debugging
+			if (!(window as any)[debugKey]) {
+				(window as any)[debugKey] = {
+					createdAt: new Date().toISOString(),
+					accessCount: 0,
+					lastAccess: null,
+				};
+			}
+			const debug = (window as any)[debugKey];
+			debug.accessCount = (debug.accessCount || 0) + 1;
+			debug.lastAccess = new Date().toISOString();
+
+			return existingInstance;
+		}
+
+		const newInstance = new SchemasService();
+		(window as any)[globalKey] = newInstance;
+
+		// Initialize debug info
+		(window as any)[debugKey] = {
+			createdAt: new Date().toISOString(),
+			accessCount: 1,
+			lastAccess: new Date().toISOString(),
+		};
+
+		return newInstance;
+	}
+
+	// Fallback for non-browser environments (SSR, tests)
+	if (typeof global !== "undefined") {
+		const existingInstance = (global as any)[globalKey];
+
+		if (existingInstance) {
+			return existingInstance;
+		}
+
+		const newInstance = new SchemasService();
+		(global as any)[globalKey] = newInstance;
+		return newInstance;
+	}
+
+	// Last resort: module-level instance (will be lost on re-evaluation)
+	console.warn(
+		`[SchemasService Factory] [${new Date().toISOString()}] ` +
+			`WARNING: No global object available, creating module-level instance. ` +
+			`This instance will be lost if the module is re-evaluated.`,
+	);
+
+	return new SchemasService();
+};
+
+const schemasService = getSchemasService();
+
+// Expose debug info helper for console inspection
+// if (typeof window !== "undefined") {
+// 	(window as any).__getSchemasServiceDebugInfo = () => {
+// 		const debugKey = "__GRIDDO_SCHEMAS_SERVICE_DEBUG__";
+// 		const debug = (window as any)[debugKey];
+// 		const instance = (window as any).__GRIDDO_SCHEMAS_SERVICE__;
+
+// 		return {
+// 			debugInfo: debug || null,
+// 			instanceId: instance?.getInstanceId?.() || "not found",
+// 			isLoaded: instance?.isLoaded?.() || false,
+// 			hasSchemas: instance?.isLoaded?.() || false,
+// 		};
+// 	};
+// }
+
+interface IUISchemas {
+	modules: Record<string, ISchema>;
+	components: Record<string, ISchema>;
+	templates: Record<string, ISchema>;
+}
+
+interface IFormSchemas {
+	fields?: Record<string, ISchema>;
+	templates?: Record<string, ISchema>;
+	categories?: { label: string; value: string; featured?: boolean }[];
+	templateCategories?: { label: string; value: string }[];
+}
+
+interface IContentTypesSchemas {
+	dataPacks: Record<string, ISchema>;
+}
+
+/**
+ * Configuration schemas structure
+ */
+interface ISchemasConfig {
+	themes: IGriddoTheme[];
+	moduleCategories: ModuleCategoryInfo[];
+	menuItems: Record<string, { fields: unknown[] }>;
+	richTextConfig?: IRichTextConfig;
+	[key: string]: unknown;
+}
+
+interface ILanguage {
+	id: number;
+	locale: string;
+	language: string;
+	label: string;
+	isDefault: boolean;
+}
+
+interface ISchemas {
+	ui: IUISchemas;
+	config: ISchemasConfig;
+	forms?: IFormSchemas;
+	contentTypes: IContentTypesSchemas;
+	languagesDefinition: Record<string, { name: string; label: string }>;
+	version: string;
+	languages: ILanguage[];
+	defaultLanguage: ILanguage;
+}
+
+export {
+	type ISchemas,
+	type ISchemasConfig,
+	type IUISchemas,
+	type IFormSchemas,
+	type IContentTypesSchemas,
+	type ILanguage,
+	SchemasNotLoadedError,
+	schemasService,
+};

package/src/services/index.ts

@@ -0,0 +1,9 @@
+export {
+	type IContentTypesSchemas,
+	type IFormSchemas,
+	type ISchemas,
+	type ISchemasConfig,
+	type IUISchemas,
+	SchemasNotLoadedError,
+	schemasService,
+} from "./SchemasService";

package/src/types/index.tsx

@@ -1,47 +1,45 @@
-import { IAppState } from "@ax/containers/App/reducer";
-import { ISitesState } from "@ax/containers/Sites/reducer";
-import { IPageEditorState } from "@ax/containers/PageEditor/reducer";
-import { IMenuState } from "@ax/containers/Navigation/Menu/reducer";
-import { INavigationState } from "@ax/containers/Navigation/Defaults/reducer";
-import { IStructuredDataState } from "@ax/containers/StructuredData/reducer";
-import { ILanguageState } from "@ax/containers/Settings/Languages/reducer";
-import { IDataPacksState } from "@ax/containers/Settings/DataPacks/reducer";
-import { IUsersState } from "@ax/containers/Users/reducer";
-import { IGalleryState } from "@ax/containers/Gallery/reducer";
-import { IDomainsState } from "@ax/containers/Domains/reducer";
-import { IRedirectsState } from "@ax/containers/Redirects/reducer";
-import { IAnalyticsState } from "@ax/containers/Analytics/reducer";
-import { IIntegrationsState } from "@ax/containers/Integrations/reducer";
-import { IFileDriveState } from "@ax/containers/FileDrive/reducer";
-import { IFormsState } from "@ax/containers/Forms/reducer";
-import { IActivityLogState } from "@ax/containers/ActivityLog/reducer";
-
-import {
-	GetFormsParams,
-	FormContent,
-	ListForm,
-	FormCategory,
-	FormCategoriesList,
-	PostFormCategoryParams,
-	PutFormCategoryParams,
-	FormCategoriesOrderParams,
-	FormState,
-	FormLanguage,
-} from "./forms";
-
-import {
-	IFilesFolder,
+import type { IActivityLogState } from "@ax/containers/ActivityLog/reducer";
+import type { IAnalyticsState } from "@ax/containers/Analytics/reducer";
+import type { IAppState } from "@ax/containers/App/reducer";
+import type { IDomainsState } from "@ax/containers/Domains/reducer";
+import type { IFileDriveState } from "@ax/containers/FileDrive/reducer";
+import type { IFormsState } from "@ax/containers/Forms/reducer";
+import type { IGalleryState } from "@ax/containers/Gallery/reducer";
+import type { IIntegrationsState } from "@ax/containers/Integrations/reducer";
+import type { INavigationState } from "@ax/containers/Navigation/Defaults/reducer";
+import type { IMenuState } from "@ax/containers/Navigation/Menu/reducer";
+import type { IPageEditorState } from "@ax/containers/PageEditor/reducer";
+import type { IRedirectsState } from "@ax/containers/Redirects/reducer";
+import type { IDataPacksState } from "@ax/containers/Settings/DataPacks/reducer";
+import type { ILanguageState } from "@ax/containers/Settings/Languages/reducer";
+import type { ISitesState } from "@ax/containers/Sites/reducer";
+import type { IStructuredDataState } from "@ax/containers/StructuredData/reducer";
+import type { IUsersState } from "@ax/containers/Users/reducer";
+
+import type {
 	IFile,
-	IFileUsePages,
+	IFilesFolder,
 	IFileUseItem,
+	IFileUsePages,
 	IFolder,
 	IFolderTree,
 	IGetFolderParams,
 	IImage,
 	IImageFolder,
 } from "./files";
-
-import { ILogItemsByDay, ILogItemsByUser, ILogContent } from "./logs";
+import type {
+	FormCategoriesList,
+	FormCategoriesOrderParams,
+	FormCategory,
+	FormContent,
+	FormLanguage,
+	FormState,
+	GetFormsParams,
+	ListForm,
+	PostFormCategoryParams,
+	PutFormCategoryParams,
+} from "./forms";
+import type { ILogContent, ILogItemsByDay, ILogItemsByUser } from "./logs";
 
 export interface IBreadcrumbItem {
 	editorID: number;
@@ -184,10 +182,22 @@ export interface ISiteListConfig {
 		sortedByTitle: boolean;
 	};
 }
+
 export interface ISchema {
 	title: string;
 	component: string;
-	type?: string;
+	type: any;
+	// Este type está en any porque puede ser string | object
+	// Si ponemos el type de abajo da errores de tipado y hay que refactorizar.
+	// Esto pasa porque en los templates type es un objeto y en los modulos un string.
+	// type:
+	// 	| string
+	// 	| {
+	// 			label: string;
+	// 			value: string;
+	// 			mode?: "list" | "detail" | "paginated-data" | "virtual-list";
+	// 			special?: "404" | "sitemap";
+	// 	  };
 	configTabs: ISchemaTab[];
 	schemaType: string;
 	displayName?: string;
@@ -196,6 +206,7 @@ export interface ISchema {
 	styles?: Record<string, string>;
 	maxModulesPerPage?: number;
 	content?: ISchemaField[];
+	singleInstance?: boolean;
 	[key: string]: any;
 	default?: {
 		title?: string | { content: string };
@@ -1132,7 +1143,6 @@ export type {
 	FormState,
 	FormLanguage,
 };
-
 export type {
 	IFilesFolder,
 	IFile,
@@ -1144,5 +1154,4 @@ export type {
 	IImage,
 	IImageFolder,
 };
-
 export type { ILogItemsByDay, ILogItemsByUser, ILogContent };

package/tsconfig.paths.json

@@ -17,6 +17,7 @@
 			"@ax/routes/*": ["src/routes/*"],
 			"@ax/types": ["src/types"],
 			"@ax/schemas": ["src/schemas"],
+			"@ax/services": ["src/services"],
 			"@ax/themes/*": ["src/themes/*"]
 		}
 	}

package/src/schemas/pages/Page.tsx

@@ -1,301 +0,0 @@
-import { config } from "components";
-
-const themes = config.schemas.config.themes;
-
-export default {
-	schemaType: "page",
-	displayName: "Page",
-	component: "Page",
-	dataPacks: null,
-	configTabs: [
-		{
-			title: "content",
-			fields: [
-				{
-					title: "",
-					type: "TranslateButton",
-					key: "translate",
-					contentType: "page",
-				},
-				{
-					title: "Title",
-					type: "TextField",
-					key: "title",
-					autoComplete: "false",
-				},
-				{
-					title: "Template",
-					key: "template",
-					type: "template",
-				},
-			],
-		},
-		{
-			title: "config",
-			fields: [
-				{
-					type: "UniqueCheck",
-					key: "isHome",
-					options: [
-						{
-							title: "Set as home",
-						},
-					],
-				},
-				{
-					title: "Parent",
-					type: "AsyncSelect",
-					entity: "pages",
-					key: "parent",
-					options: { excludeDetailPages: true },
-				},
-				{
-					title: "Slug",
-					type: "TextField",
-					key: "slug",
-				},
-				{
-					title: "Template",
-					key: "template",
-					type: "template",
-				},
-				{
-					title: "Page Options",
-					type: "FieldGroup",
-					key: "pageOptions",
-					collapsed: false,
-					fields: [
-						{
-							title: "Theme",
-							type: "Select",
-							key: "theme",
-							options: themes,
-							helptext: "It affects the whole page: Header, Content, and footer.",
-						},
-						{
-							title: "Customize header and footer themes",
-							type: "ConditionalField",
-							key: "customizeThemes",
-							mandatory: true,
-							defaultValue: false,
-							options: [
-								{
-									value: true,
-									title: "Yes",
-									name: "Yes",
-								},
-								{
-									value: false,
-									title: "No",
-									name: "No",
-								},
-							],
-							fields: [
-								{
-									title: "Header Theme",
-									type: "Select",
-									key: "headerTheme",
-									options: themes,
-									condition: true,
-								},
-								{
-									title: "Footer Theme",
-									type: "Select",
-									key: "footerTheme",
-									options: themes,
-									condition: true,
-								},
-							],
-						},
-					],
-				},
-				{
-					type: "IntegrationsField",
-					key: "integrations",
-				},
-			],
-		},
-		{
-			title: "SEO & Analytics",
-			fields: [
-				{
-					title: "SEO Data",
-					type: "FieldGroup",
-					key: "seoData",
-					collapsed: true,
-					fields: [
-						{
-							title: "",
-							type: "SummaryButton",
-							key: "summary",
-						},
-						{
-							title: "Meta title",
-							type: "TextField",
-							key: "metaTitle",
-						},
-						{
-							title: "Meta description",
-							type: "TextArea",
-							key: "metaDescription",
-						},
-						{
-							title: "Keywords",
-							type: "TagsField",
-							key: "metaKeywords",
-						},
-						{
-							title: "Canonical URL",
-							type: "TextField",
-							key: "canonicalURL",
-						},
-						{
-							title: "Meta robots index",
-							type: "RadioGroup",
-							key: "isIndexed",
-							options: [
-								{
-									value: true,
-									title: "Index",
-									name: "index",
-								},
-								{
-									value: false,
-									title: "No index",
-									name: "noindex",
-								},
-							],
-						},
-						{
-							title: "Meta robots follow",
-							type: "RadioGroup",
-							key: "follow",
-							options: [
-								{
-									value: true,
-									title: "Follow",
-									name: "follow",
-								},
-								{
-									value: false,
-									title: "No follow",
-									name: "nofollow",
-								},
-							],
-						},
-						{
-							title: "Meta robots advanced",
-							type: "CheckGroup",
-							key: "metasAdvanced",
-							options: [
-								{
-									value: "noimageindex",
-									title: "No image index",
-									name: "noimage",
-								},
-								{
-									value: "nosnippet",
-									title: "No snippet",
-									name: "nosnippet",
-								},
-								{
-									value: "noodp",
-									title: "No ODP",
-									name: "noodp",
-								},
-								{
-									value: "noarchive",
-									title: "No archive",
-									name: "noarchive",
-								},
-								{
-									value: "noTranslate",
-									title: "No translate",
-									name: "noTranslate",
-								},
-							],
-						},
-					],
-				},
-				{
-					title: "GEO (LLMS)",
-					type: "FieldGroup",
-					key: "geo",
-					collapsed: true,
-					fields: [
-						{
-							type: "UniqueCheck",
-							key: "isLlmsEnabled",
-							options: [
-								{ "title": "Include this page in LLMs.txt" }
-							],
-							description: "If enabled, this page will be listed in LLMs.txt for language models."
-						},
-					],
-				},
-				{
-					title: "Analytics Data Layer",
-					type: "FieldGroup",
-					key: "analytics",
-					collapsed: true,
-					fields: [
-						{
-							type: "AnalyticsField",
-							key: "dimensions",
-							collapsed: true,
-						},
-					],
-				},
-				{
-					title: "Social Media",
-					type: "FieldGroup",
-					key: "socialShare",
-					collapsed: true,
-					fields: [
-						{
-							title: "Title",
-							type: "TextField",
-							key: "socialTitle",
-						},
-						{
-							title: "Description",
-							type: "TextField",
-							key: "socialDescription",
-						},
-						{
-							title: "Image",
-							type: "ImageField",
-							key: "socialImage",
-						},
-					],
-				},
-			],
-		},
-	],
-	default: {
-		component: "Page",
-		isHome: false,
-		slug: "new-page",
-		title: "New Page",
-		headerConfig: "{}",
-		footerConfig: "{}",
-		liveStatus: { id: 1 },
-		template: {},
-		metaTitle: "",
-		metaDescription: "",
-		canonicalURL: "",
-		isIndexed: true,
-		follow: true,
-		metasAdvanced: "",
-		socialTitle: "",
-		socialDescription: "",
-		socialImage: {},
-		dimensions: {},
-		integrations: null,
-		theme: null,
-		customizeThemes: false,
-		headerTheme: null,
-		footerTheme: null,
-		isLlmsEnabled: true,
-	},
-};

package/src/schemas/pages/index.tsx

@@ -1,5 +0,0 @@
-import Page from "./Page";
-import GlobalPage from "./GlobalPage";
-import FormPage from "./FormPage";
-
-export default { Page, GlobalPage, FormPage };