@arch-cadre/modules 0.0.49 → 0.0.50

package/dist/server/ui.mjs

@@ -1,169 +1,218 @@
 "use server";
-
-import { getModuleConfig, getModuleInstance, getModules } from "./manage.mjs";
 import { getCurrentSession } from "@arch-cadre/core/server";
-
-//#region src/server/ui.ts
-/**
-* Helper to check and filter a navigation item based on roles and permissions.
-* Returns the item (potentially with filtered sub-items) or null if access is denied.
-*/
+import { getModuleConfig, getModuleInstance, getModules } from "./manage.js";
 function filterNavItem(item, userRoles, userPermissions) {
-	if (item.roles && item.roles.length > 0) {
-		if (!item.roles.some((role) => userRoles.includes(role))) return null;
-	}
-	if (item.permissions && item.permissions.length > 0) {
-		if (!item.permissions.every((perm) => userPermissions.includes(perm))) return null;
-	}
-	if (item.items && item.items.length > 0) {
-		const filteredSubItems = item.items.map((subItem) => filterNavItem(subItem, userRoles, userPermissions)).filter((subItem) => subItem !== null);
-		return {
-			...item,
-			items: filteredSubItems
-		};
-	}
-	return item;
+  if (item.roles && item.roles.length > 0) {
+    if (!item.roles.some((role) => userRoles.includes(role))) {
+      return null;
+    }
+  }
+  if (item.permissions && item.permissions.length > 0) {
+    if (!item.permissions.every((perm) => userPermissions.includes(perm))) {
+      return null;
+    }
+  }
+  if (item.items && item.items.length > 0) {
+    const filteredSubItems = item.items.map(
+      (subItem) => filterNavItem(subItem, userRoles, userPermissions)
+    ).filter((subItem) => subItem !== null);
+    return {
+      ...item,
+      items: filteredSubItems
+    };
+  }
+  return item;
 }
-async function getModuleNavigationGrouped(type) {
-	const { user } = await getCurrentSession();
-	const userRoles = user?.roles || [];
-	const userPermissions = user?.permissions || [];
-	const active = (await getModules()).filter((m) => m.enabled);
-	const groups = {};
-	for (const mod of active) try {
-		const instanceNav = (await getModuleInstance(mod.id))?.navigation?.[type];
-		if (instanceNav) for (const [groupName, items] of Object.entries(instanceNav)) {
-			if (!groups[groupName]) groups[groupName] = [];
-			for (const rawItem of items) {
-				const item = filterNavItem(rawItem, userRoles, userPermissions);
-				if (item && !groups[groupName].some((existing) => existing.url === item.url)) groups[groupName].push(item);
-			}
-		}
-	} catch (_e) {
-		console.warn(`[Kernel:UI] Failed to load navigation for module ${mod.id}:`, _e);
-	}
-	return groups;
+export async function getModuleNavigationGrouped(type) {
+  const { user } = await getCurrentSession();
+  const userRoles = user?.roles || [];
+  const userPermissions = user?.permissions || [];
+  const modules = await getModules();
+  const active = modules.filter((m) => m.enabled);
+  const groups = {};
+  for (const mod of active) {
+    try {
+      const instance = await getModuleInstance(mod.id);
+      const instanceNav = instance?.navigation?.[type];
+      if (instanceNav) {
+        for (const [groupName, items] of Object.entries(
+          instanceNav
+        )) {
+          if (!groups[groupName]) groups[groupName] = [];
+          for (const rawItem of items) {
+            const item = filterNavItem(rawItem, userRoles, userPermissions);
+            if (item && !groups[groupName].some((existing) => existing.url === item.url)) {
+              groups[groupName].push(item);
+            }
+          }
+        }
+      }
+    } catch (_e) {
+      console.warn(
+        `[Kernel:UI] Failed to load navigation for module ${mod.id}:`,
+        _e
+      );
+    }
+  }
+  return groups;
 }
-async function getKryoPathPrefix() {
-	try {
-		return (await getModuleConfig("kryo-panel"))?.pathPrefix ?? "/kryo";
-	} catch (_e) {
-		return "/kryo";
-	}
+export async function getKryoPathPrefix() {
+  try {
+    const config = await getModuleConfig("kryo-panel");
+    return config?.pathPrefix ?? "/kryo";
+  } catch (_e) {
+    return "/kryo";
+  }
 }
-async function getKryoModuleNavigationGrouped(type) {
-	const groups = await getModuleNavigationGrouped(type);
-	const prefix = await getKryoPathPrefix();
-	const prefixUrl = (url) => {
-		if (url.startsWith(prefix)) return url;
-		return url === "/" ? prefix : `${prefix}${url}`;
-	};
-	const processItems = (items) => {
-		return items.map((item) => ({
-			...item,
-			url: prefixUrl(item.url),
-			items: item.items ? processItems(item.items) : void 0
-		}));
-	};
-	const transformedGroups = {};
-	for (const [group, items] of Object.entries(groups)) transformedGroups[group] = processItems(items);
-	return transformedGroups;
+export async function getKryoModuleNavigationGrouped(type) {
+  const groups = await getModuleNavigationGrouped(type);
+  const prefix = await getKryoPathPrefix();
+  const prefixUrl = (url) => {
+    if (url.startsWith(prefix)) return url;
+    return url === "/" ? prefix : `${prefix}${url}`;
+  };
+  const processItems = (items) => {
+    return items.map((item) => ({
+      ...item,
+      url: prefixUrl(item.url),
+      items: item.items ? processItems(item.items) : void 0
+    }));
+  };
+  const transformedGroups = {};
+  for (const [group, items] of Object.entries(groups)) {
+    transformedGroups[group] = processItems(items);
+  }
+  return transformedGroups;
 }
-async function getModuleNavigation(type) {
-	const { user } = await getCurrentSession();
-	const userRoles = user?.roles || [];
-	const userPermissions = user?.permissions || [];
-	const active = (await getModules()).filter((m) => m.enabled);
-	const all = [];
-	for (const mod of active) try {
-		const instance = await getModuleInstance(mod.id);
-		if (instance?.navigation?.[type]) {
-			const items = instance.navigation[type];
-			for (const rawItem of items) {
-				const item = filterNavItem(rawItem, userRoles, userPermissions);
-				if (item) all.push(item);
-			}
-		}
-	} catch {}
-	return all;
+export async function getModuleNavigation(type) {
+  const { user } = await getCurrentSession();
+  const userRoles = user?.roles || [];
+  const userPermissions = user?.permissions || [];
+  const modules = await getModules();
+  const active = modules.filter((m) => m.enabled);
+  const all = [];
+  for (const mod of active) {
+    try {
+      const instance = await getModuleInstance(mod.id);
+      if (instance?.navigation?.[type]) {
+        const items = instance.navigation[type];
+        for (const rawItem of items) {
+          const item = filterNavItem(rawItem, userRoles, userPermissions);
+          if (item) all.push(item);
+        }
+      }
+    } catch {
+    }
+  }
+  return all;
 }
-async function getPublicModuleRoutes() {
-	const active = (await getModules()).filter((m) => m.enabled);
-	const allRoutes = [];
-	for (const mod of active) try {
-		const instance = await getModuleInstance(mod.id);
-		if (instance?.routes?.public) allRoutes.push(...instance.routes.public);
-	} catch {}
-	return allRoutes;
+export async function getPublicModuleRoutes() {
+  const modules = await getModules();
+  const active = modules.filter((m) => m.enabled);
+  const allRoutes = [];
+  for (const mod of active) {
+    try {
+      const instance = await getModuleInstance(mod.id);
+      if (instance?.routes?.public) {
+        allRoutes.push(...instance.routes.public);
+      }
+    } catch {
+    }
+  }
+  return allRoutes;
 }
-async function getPrivateModuleRoutes() {
-	const active = (await getModules()).filter((m) => m.enabled);
-	const allRoutes = [];
-	for (const mod of active) try {
-		const instance = await getModuleInstance(mod.id);
-		if (instance?.routes?.private) allRoutes.push(...instance.routes.private);
-	} catch {}
-	return allRoutes;
+export async function getPrivateModuleRoutes() {
+  const modules = await getModules();
+  const active = modules.filter((m) => m.enabled);
+  const allRoutes = [];
+  for (const mod of active) {
+    try {
+      const instance = await getModuleInstance(mod.id);
+      if (instance?.routes?.private) {
+        allRoutes.push(...instance.routes.private);
+      }
+    } catch {
+    }
+  }
+  return allRoutes;
 }
-async function getKryoModuleRoutes() {
-	const routes = await getPrivateModuleRoutes();
-	const prefix = await getKryoPathPrefix();
-	return routes.map((route) => ({
-		...route,
-		path: route.path === "/" ? prefix : `${prefix}${route.path}`
-	}));
+export async function getKryoModuleRoutes() {
+  const routes = await getPrivateModuleRoutes();
+  const prefix = await getKryoPathPrefix();
+  return routes.map((route) => ({
+    ...route,
+    path: route.path === "/" ? prefix : `${prefix}${route.path}`
+  }));
 }
-async function getApiModuleRoutes() {
-	const active = (await getModules()).filter((m) => m.enabled);
-	const allRoutes = [];
-	for (const mod of active) try {
-		const instance = await getModuleInstance(mod.id);
-		if (instance?.routes?.api) allRoutes.push(...instance.routes.api);
-	} catch {}
-	return allRoutes;
+export async function getApiModuleRoutes() {
+  const modules = await getModules();
+  const active = modules.filter((m) => m.enabled);
+  const allRoutes = [];
+  for (const mod of active) {
+    try {
+      const instance = await getModuleInstance(mod.id);
+      if (instance?.routes?.api) {
+        allRoutes.push(...instance.routes.api);
+      }
+    } catch {
+    }
+  }
+  return allRoutes;
 }
-async function getModuleWidgets(area) {
-	const active = (await getModules()).filter((m) => m.enabled);
-	const widgets = [];
-	for (const mod of active) try {
-		const instance = await getModuleInstance(mod.id);
-		if (instance?.widgets) {
-			const matching = instance.widgets.filter((w) => w.area === area);
-			widgets.push(...matching);
-		}
-	} catch (_e) {}
-	return widgets.sort((a, b) => (a.priority || 0) - (b.priority || 0));
+export async function getModuleWidgets(area) {
+  const modules = await getModules();
+  const active = modules.filter((m) => m.enabled);
+  const widgets = [];
+  for (const mod of active) {
+    try {
+      const instance = await getModuleInstance(mod.id);
+      if (instance?.widgets) {
+        const matching = instance.widgets.filter(
+          (w) => w.area === area
+        );
+        widgets.push(...matching);
+      }
+    } catch (_e) {
+    }
+  }
+  return widgets.sort((a, b) => (a.priority || 0) - (b.priority || 0));
 }
-async function getExtensions(targetModule, point) {
-	const active = (await getModules()).filter((m) => m.enabled);
-	const extensions = [];
-	for (const mod of active) try {
-		const instance = await getModuleInstance(mod.id);
-		if (instance?.extensions) {
-			const matching = instance.extensions.filter((ext) => {
-				const isTarget = ext.targetModule === targetModule;
-				const isPoint = point ? ext.point === point : true;
-				return isTarget && isPoint;
-			});
-			extensions.push(...matching);
-		}
-	} catch (_e) {}
-	return extensions.sort((a, b) => (a.priority || 0) - (b.priority || 0));
+export async function getExtensions(targetModule, point) {
+  const modules = await getModules();
+  const active = modules.filter((m) => m.enabled);
+  const extensions = [];
+  for (const mod of active) {
+    try {
+      const instance = await getModuleInstance(mod.id);
+      if (instance?.extensions) {
+        const matching = instance.extensions.filter((ext) => {
+          const isTarget = ext.targetModule === targetModule;
+          const isPoint = point ? ext.point === point : true;
+          return isTarget && isPoint;
+        });
+        extensions.push(...matching);
+      }
+    } catch (_e) {
+    }
+  }
+  return extensions.sort((a, b) => (a.priority || 0) - (b.priority || 0));
 }
-async function hasExtension(targetModule, point) {
-	const active = (await getModules()).filter((m) => m.enabled);
-	for (const mod of active) try {
-		const instance = await getModuleInstance(mod.id);
-		if (instance?.extensions) {
-			if (instance.extensions.filter((ext) => {
-				const isTarget = ext.targetModule === targetModule;
-				const isPoint = point ? ext.point === point : true;
-				return isTarget && isPoint;
-			}).length > 0) return true;
-		}
-	} catch (_e) {}
-	return false;
+export async function hasExtension(targetModule, point) {
+  const modules = await getModules();
+  const active = modules.filter((m) => m.enabled);
+  for (const mod of active) {
+    try {
+      const instance = await getModuleInstance(mod.id);
+      if (instance?.extensions) {
+        const matching = instance.extensions.filter((ext) => {
+          const isTarget = ext.targetModule === targetModule;
+          const isPoint = point ? ext.point === point : true;
+          return isTarget && isPoint;
+        });
+        if (matching.length > 0) return true;
+      }
+    } catch (_e) {
+    }
+  }
+  return false;
 }
-
-//#endregion
-export { getApiModuleRoutes, getExtensions, getKryoModuleNavigationGrouped, getKryoModuleRoutes, getKryoPathPrefix, getModuleNavigation, getModuleNavigationGrouped, getModuleWidgets, getPrivateModuleRoutes, getPublicModuleRoutes, hasExtension };

package/dist/server.cjs

@@ -1,30 +1,60 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_types = require('./types.cjs');
-const require_manage = require('./server/manage.cjs');
-const require_ui = require('./server/ui.cjs');
-const require_lifecycle = require('./server/lifecycle.cjs');
-const require_registry = require('./server/registry.cjs');
+"use strict";
 
-exports.ModuleManifestSchema = require_types.ModuleManifestSchema;
-exports.getApiModuleRoutes = require_ui.getApiModuleRoutes;
-exports.getExtensions = require_ui.getExtensions;
-exports.getKryoModuleNavigationGrouped = require_ui.getKryoModuleNavigationGrouped;
-exports.getKryoModuleRoutes = require_ui.getKryoModuleRoutes;
-exports.getKryoPathPrefix = require_ui.getKryoPathPrefix;
-exports.getModuleConfig = require_manage.getModuleConfig;
-exports.getModuleInstance = require_manage.getModuleInstance;
-exports.getModuleNavigation = require_ui.getModuleNavigation;
-exports.getModuleNavigationGrouped = require_ui.getModuleNavigationGrouped;
-exports.getModuleStatus = require_manage.getModuleStatus;
-exports.getModuleWidgets = require_ui.getModuleWidgets;
-exports.getModules = require_manage.getModules;
-exports.getPrivateModuleRoutes = require_ui.getPrivateModuleRoutes;
-exports.getPublicModuleRoutes = require_ui.getPublicModuleRoutes;
-exports.hasExtension = require_ui.hasExtension;
-exports.initModules = require_registry.initModules;
-exports.initOperationalModules = require_lifecycle.initOperationalModules;
-exports.isModuleEnabled = require_manage.isModuleEnabled;
-exports.pushModuleSchema = require_lifecycle.pushModuleSchema;
-exports.registerModules = require_manage.registerModules;
-exports.toggleModuleState = require_lifecycle.toggleModuleState;
-exports.updateModuleConfig = require_manage.updateModuleConfig;
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _lifecycle = require("./server/lifecycle.js");
+Object.keys(_lifecycle).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _lifecycle[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _lifecycle[key];
+    }
+  });
+});
+var _manage = require("./server/manage.js");
+Object.keys(_manage).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _manage[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _manage[key];
+    }
+  });
+});
+var _registry = require("./server/registry.js");
+Object.keys(_registry).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _registry[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _registry[key];
+    }
+  });
+});
+var _ui = require("./server/ui.js");
+Object.keys(_ui).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _ui[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _ui[key];
+    }
+  });
+});
+var _types = require("./types.js");
+Object.keys(_types).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _types[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _types[key];
+    }
+  });
+});

package/dist/server.d.ts

@@ -0,0 +1,5 @@
+export * from "./server/lifecycle.js";
+export * from "./server/manage.js";
+export * from "./server/registry.js";
+export * from "./server/ui.js";
+export * from "./types.js";

package/dist/server.mjs

@@ -1,7 +1,5 @@
-import { ModuleManifestSchema } from "./types.mjs";
-import { getModuleConfig, getModuleInstance, getModuleStatus, getModules, isModuleEnabled, registerModules, updateModuleConfig } from "./server/manage.mjs";
-import { getApiModuleRoutes, getExtensions, getKryoModuleNavigationGrouped, getKryoModuleRoutes, getKryoPathPrefix, getModuleNavigation, getModuleNavigationGrouped, getModuleWidgets, getPrivateModuleRoutes, getPublicModuleRoutes, hasExtension } from "./server/ui.mjs";
-import { initOperationalModules, pushModuleSchema, toggleModuleState } from "./server/lifecycle.mjs";
-import { initModules } from "./server/registry.mjs";
-
-export { ModuleManifestSchema, getApiModuleRoutes, getExtensions, getKryoModuleNavigationGrouped, getKryoModuleRoutes, getKryoPathPrefix, getModuleConfig, getModuleInstance, getModuleNavigation, getModuleNavigationGrouped, getModuleStatus, getModuleWidgets, getModules, getPrivateModuleRoutes, getPublicModuleRoutes, hasExtension, initModules, initOperationalModules, isModuleEnabled, pushModuleSchema, registerModules, toggleModuleState, updateModuleConfig };
+export * from "./server/lifecycle.js";
+export * from "./server/manage.js";
+export * from "./server/registry.js";
+export * from "./server/ui.js";
+export * from "./types.js";

package/dist/types.cjs

@@ -1,19 +1,20 @@
-const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
-let zod = require("zod");
+"use strict";
 
-//#region src/types.ts
-const ModuleManifestSchema = zod.z.object({
-	id: zod.z.string(),
-	name: zod.z.string(),
-	version: zod.z.string(),
-	description: zod.z.string().optional(),
-	dependencies: zod.z.array(zod.z.string()).default([]),
-	extends: zod.z.array(zod.z.string()).default([]),
-	enabled: zod.z.boolean().default(true),
-	system: zod.z.boolean().default(false),
-	npmDependencies: zod.z.array(zod.z.string()).optional(),
-	npmDevDependencies: zod.z.array(zod.z.string()).optional()
+Object.defineProperty(exports, "__esModule", {
+  value: true
 });
-
-//#endregion
-exports.ModuleManifestSchema = ModuleManifestSchema;
+exports.ModuleManifestSchema = void 0;
+var _zod = require("zod");
+const ModuleManifestSchema = exports.ModuleManifestSchema = _zod.z.object({
+  id: _zod.z.string(),
+  name: _zod.z.string(),
+  version: _zod.z.string(),
+  description: _zod.z.string().optional(),
+  dependencies: _zod.z.array(_zod.z.string()).default([]),
+  extends: _zod.z.array(_zod.z.string()).default([]),
+  // NOWE: Lista modułów, które ten moduł rozszerza
+  enabled: _zod.z.boolean().default(true),
+  system: _zod.z.boolean().default(false),
+  npmDependencies: _zod.z.array(_zod.z.string()).optional(),
+  npmDevDependencies: _zod.z.array(_zod.z.string()).optional()
+});

package/dist/types.d.ts

@@ -0,0 +1,113 @@
+import type { SystemEvent, UserPermission, UserRole } from "@arch-cadre/core";
+export type { SystemEvent };
+import type { Metadata } from "next";
+import { z } from "zod";
+export type SidebarGroupType = {
+    title: string;
+    items: SidebarMenuType;
+};
+export type SidebarMenuItemType<T = Record<string, string>> = {
+    id?: string;
+    title: string;
+    icon?: string;
+    url: string;
+    roles?: string[];
+    permissions?: string[];
+    badge?: string | number | null | undefined;
+    badgeVariant?: "default" | "secondary" | "destructive" | "outline" | null | undefined;
+} & T;
+export type SidebarMenuType = SidebarMenuItemType<{
+    items?: SidebarMenuItemType[];
+}>[];
+export declare const ModuleManifestSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    version: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    dependencies: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    extends: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    system: z.ZodDefault<z.ZodBoolean>;
+    npmDependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    npmDevDependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type ModuleManifest = z.infer<typeof ModuleManifestSchema>;
+export interface ModuleExtension {
+    id: string;
+    targetModule: string;
+    point: string;
+    component: React.ComponentType<any>;
+    priority?: number;
+    metadata?: any;
+}
+export interface ModulePageProps {
+    params: any;
+    searchParams: any;
+}
+export interface ModuleRouteDefinition {
+    id?: string;
+    roles?: UserRole[];
+    permissions?: UserPermission[];
+    component: React.ComponentType<any>;
+    layout?: React.ComponentType<{
+        children: React.ReactNode;
+    }>;
+    generateMetadata?: (props: ModulePageProps) => Promise<Metadata> | Metadata;
+}
+export interface ModuleWidget {
+    id: string;
+    name: string;
+    area: "dashboard-stats" | "dashboard-main" | "sidebar-bottom" | string;
+    component: React.ComponentType<any>;
+    priority?: number;
+}
+export interface IModule {
+    manifest: ModuleManifest;
+    schema?: any;
+    onMigrate?: () => Promise<void>;
+    onEnable?: () => Promise<void>;
+    onDisable?: () => Promise<void>;
+    init?: () => Promise<void>;
+    widgets?: ModuleWidget[];
+    extensions?: ModuleExtension[];
+    navigation?: ModuleNavigation;
+    routes?: {
+        public?: PublicRouteDefinition[];
+        private?: PrivateRouteDefinition[];
+        api?: ApiRouteDefinition[];
+    };
+}
+/**
+ * Element menu zarejestrowany przez moduł.
+ */
+export type ModuleNavElement = SidebarMenuItemType<{
+    items?: SidebarMenuItemType[];
+}>;
+/**
+ * Mapa nawigacji modułu.
+ * Klucz: Nazwa grupy (np. "CMS", "Platform", "Journal")
+ * Vartość: Tablica elementów menu trafiających do tej grupy.
+ */
+export type ModuleNavigationGroupMap = Record<string, ModuleNavElement[]>;
+export interface PublicRouteDefinition extends ModuleRouteDefinition {
+    path: string;
+    auth?: boolean;
+}
+export interface PrivateRouteDefinition extends ModuleRouteDefinition {
+    path: string;
+    auth?: boolean;
+}
+export interface ApiRouteDefinition {
+    id?: string;
+    path: string;
+    handler: (request: Request, context: any) => Promise<Response> | Response;
+    auth?: boolean;
+    roles?: UserRole[];
+    permissions?: UserPermission[];
+}
+export interface ModuleNavigation {
+    public?: ModuleNavElement[];
+    admin?: ModuleNavigationGroupMap;
+    settings?: ModuleNavigationGroupMap;
+    globalRoutes?: (PublicRouteDefinition | PrivateRouteDefinition | ApiRouteDefinition)[];
+}