@en-solutions/tgm-client-sdk 1.8.0 → 1.8.1

package/lib/models/api/cms.models.d.ts

@@ -6,6 +6,10 @@ export interface ContentTypeSchema {
         pluralName: string;
         displayName: string;
         description?: string;
+        /** Target menu section id (e.g., "tgm-om", "administration", "tgm-inventory-management") */
+        menuSection?: string;
+        /** Icon name for sidebar tab (feather/lucide, e.g., "shield", "clipboard") */
+        menuIcon?: string;
     };
     options?: {
         draftAndPublish?: boolean;

package/lib/services/api/cms-menu.helper.d.ts

@@ -1,65 +1,60 @@
 import { Observable } from 'rxjs';
 import * as i0 from "@angular/core";
 /**
- * Menu item structure matching tgm-manager-ui's CoreMenuItem interface.
- * Frontend devs can inject these into the sidebar dynamically.
+ * Transforms CMS content types into sidebar menu items.
  *
- * Usage in tgm-manager-ui:
+ * Each content type can specify where it appears via info.menuSection:
+ * - "tgm-om" → TGM O&M section
+ * - "tgm-economics" → TGM Economics section
+ * - "tgm-inventory-management" → Inventory section
+ * - "administration" (default) → Administration → Custom Objects
+ * - Any other menu section id from menu.ts
  *
- * ```typescript
- * // In AppComponent or a module initializer:
- * cmsMenuHelper.getMenuItems('administration/cms').subscribe(items => {
- *   // items is a CoreMenuItem[] array ready to inject into the sidebar
- *   const adminSection = menu.find(m => m.id === 'administration');
- *   const cmsGroup = {
- *     id: 'custom-objects',
- *     type: 'section' as const,
- *     title: 'Custom Objects',
- *     icon: 'layers',
- *     role: [Role['Administration.Read']],
- *     children: items
- *   };
- *   const moreIdx = adminSection.children.findIndex(c => c.id === 'more');
- *   adminSection.children.splice(moreIdx, 0, cmsGroup);
- * });
- * ```
+ * Usage in AppComponent.initializeMenu():
  *
- * Route setup in administraton.module.ts:
  * ```typescript
- * {
- *   path: 'cms/:collectionName',
- *   loadChildren: () => import('./cms/cms.module').then(m => m.CmsModule),
- *   canActivate: [AuthGuard]
- * }
+ * this.cmsMenuHelper.getMenuItemsBySection('cms').subscribe(grouped => {
+ *   for (const [sectionId, items] of Object.entries(grouped)) {
+ *     const section = menu.find(m => m.id === sectionId);
+ *     if (section?.children) {
+ *       section.children.push(...items);
+ *     }
+ *   }
+ * });
  * ```
  */
 export declare class CmsMenuHelper {
     private contentTypeService;
+    /** Cached content types — shared across subscribers, auto-refreshes on invalidate() */
+    private _cache$;
+    private getContentTypes;
+    /** Invalidate the cache — call after creating/updating/deleting a content type */
+    invalidate(): void;
     /**
-     * Fetch all active content types and transform them into menu items.
+     * Fetch all content types and return menu items grouped by menuSection.
+     * Each key is a menu section id (e.g., "tgm-om", "administration").
+     * Items without menuSection default to "administration".
      *
-     * @param baseUrl - The base route path (e.g., 'administration/cms')
-     * @param defaultIcon - Default icon for items without a specific one (default: 'database')
-     * @returns Observable of menu items array
+     * @param baseUrl - Route base path for CMS pages
+     * @param defaultIcon - Default icon when menuIcon not set
      */
-    getMenuItems(baseUrl?: string, defaultIcon?: string): Observable<CmsMenuItem[]>;
+    getMenuItemsBySection(baseUrl?: string, defaultIcon?: string): Observable<Record<string, CmsMenuItem[]>>;
     /**
-     * Transform a single content type into a menu item.
+     * Fetch all content types as a flat list of menu items.
+     * Use getMenuItemsBySection() instead if you need placement control.
      */
-    private toMenuItem;
+    getMenuItems(baseUrl?: string, defaultIcon?: string): Observable<CmsMenuItem[]>;
     /**
-     * Build a complete "Custom Objects" collapsible menu section.
-     * Ready to inject directly into the sidebar menu array.
-     *
-     * @param baseUrl - Route base path
-     * @param roles - Required roles to see this section
+     * Build a "Custom Objects" section for items that target "administration".
+     * Items targeting other sections are excluded — use getMenuItemsBySection() for those.
      */
     getMenuSection(baseUrl?: string, roles?: string[]): Observable<CmsMenuSection>;
+    private toMenuItem;
     static ɵfac: i0.ɵɵFactoryDeclaration<CmsMenuHelper, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<CmsMenuHelper>;
 }
 /**
- * Menu item structure compatible with tgm-manager-ui's CoreMenuItem.
+ * Menu item compatible with tgm-manager-ui CoreMenuItem.
  */
 export interface CmsMenuItem {
     id: string;
@@ -79,6 +74,8 @@ export interface CmsMenuItem {
         classes?: string;
     };
     children?: CmsMenuItem[];
+    /** Internal: target menu section id */
+    _menuSection?: string;
 }
 /**
  * Complete menu section ready for sidebar injection.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@en-solutions/tgm-client-sdk",
-  "version": "1.8.0",
+  "version": "1.8.1",
   "description": "TGM Manager Client SDK for Angular 18 - Type-safe services for all TGM API endpoints",
   "license": "SEE LICENSE IN LICENSE",
   "repository": {