@apptimate/core-lib 1.0.0 → 1.2.0

package/src/constants/menus.ts

@@ -0,0 +1,576 @@
+export interface SubMenuItem {
+  id: string;
+  label: string;
+  path: string;
+}
+
+export interface SubMenuGroup {
+  id: string;
+  label: string;
+  items: SubMenuItem[];
+}
+
+export interface MainMenuItem {
+  id: string;
+  label: string;
+  iconName: string;
+  groups: SubMenuGroup[];
+}
+
+/**
+ * A secondary item in a saved menu config.
+ * Can be a plain registry key (backward compat) or an enriched object
+ * with optional label/group overrides.
+ */
+export type SecondaryItemConfig = string | {
+  key: string;
+  /** Override the default label from the registry */
+  label?: string;
+  /** Override the default group from the registry */
+  group?: string;
+};
+
+/** Normalize a SecondaryItemConfig to its key string. */
+export function secondaryItemKey(item: SecondaryItemConfig): string {
+  return typeof item === 'string' ? item : item.key;
+}
+
+/** Normalize a SecondaryItemConfig to the enriched shape. */
+export function normalizeSecondaryItem(item: SecondaryItemConfig): { key: string; label?: string; group?: string } {
+  return typeof item === 'string' ? { key: item } : item;
+}
+
+// ─── MASTER REGISTRY ─────────────────────────────────────────────
+// Every possible secondary menu item across all modules.
+// These are the building blocks that can be assembled into custom menus.
+
+export interface RegistryItem {
+  /** Unique key used for selection, e.g. "core__users" */
+  key: string;
+  /** Human-readable label */
+  label: string;
+  /** URL path */
+  path: string;
+  /** Which module this belongs to */
+  module: string;
+  /** Default group label when added to a menu */
+  defaultGroup: string;
+}
+
+export const MENU_ITEM_REGISTRY: RegistryItem[] = [
+  // ── Core Module ──
+  { key: 'core__users', label: 'Users', path: '/users', module: 'Core', defaultGroup: 'User Management' },
+  { key: 'core__roles', label: 'Roles', path: '/roles', module: 'Core', defaultGroup: 'User Management' },
+  { key: 'core__organizations', label: 'Organizations', path: '/organizations', module: 'Core', defaultGroup: 'User Management' },
+  { key: 'core__parties', label: 'Parties', path: '/parties', module: 'Core', defaultGroup: 'User Management' },
+  { key: 'core__activity_logs', label: 'Activity Logs', path: '/activity-logs', module: 'Core', defaultGroup: 'System Auditing' },
+  { key: 'core__api_requests', label: 'API Requests', path: '/system/api-requests', module: 'Core', defaultGroup: 'System Auditing' },
+  { key: 'core__feature_access_logs', label: 'Feature Access Logs', path: '/system/feature-access-logs', module: 'Core', defaultGroup: 'System Auditing' },
+  { key: 'core__issue_logs', label: 'Issue Logs', path: '/system/issue-logs', module: 'Core', defaultGroup: 'System Auditing' },
+  { key: 'core__feature_registry', label: 'Feature Registry', path: '/system/features', module: 'Core', defaultGroup: 'System Auditing' },
+  { key: 'core__menu_config', label: 'Menu Configuration', path: '/menu-config', module: 'Core', defaultGroup: 'System' },
+  { key: 'core__printables', label: 'Printable Templates', path: '/system/printables', module: 'Core', defaultGroup: 'System' },
+  { key: 'core__warehouses', label: 'Warehouses', path: '/warehouses', module: 'Core', defaultGroup: 'Resources' },
+  { key: 'core__terminals', label: 'Terminals', path: '/terminals', module: 'Core', defaultGroup: 'Resources' },
+
+  // ── Inventory Module ──
+  { key: 'inventory__items', label: 'Items', path: '/inventory/items', module: 'Inventory', defaultGroup: 'Catalog' },
+  { key: 'inventory__categories', label: 'Categories', path: '/inventory/categories', module: 'Inventory', defaultGroup: 'Catalog' },
+  { key: 'inventory__brands', label: 'Brands', path: '/inventory/brands', module: 'Inventory', defaultGroup: 'Catalog' },
+  { key: 'inventory__uom', label: 'Units of Measure', path: '/inventory/uom', module: 'Inventory', defaultGroup: 'Catalog' },
+
+  { key: 'inventory__stock', label: 'Stock Overview', path: '/inventory/stock', module: 'Inventory', defaultGroup: 'Stock' },
+  { key: 'inventory__ledger', label: 'Stock Movements', path: '/inventory/ledger', module: 'Inventory', defaultGroup: 'Stock' },
+  { key: 'inventory__adjustments', label: 'Adjustments', path: '/inventory/adjustments', module: 'Inventory', defaultGroup: 'Operations' },
+  { key: 'inventory__transfers', label: 'Transfers', path: '/inventory/transfers', module: 'Inventory', defaultGroup: 'Operations' },
+  { key: 'inventory__serials', label: 'Serial Numbers', path: '/inventory/serials', module: 'Inventory', defaultGroup: 'Operations' },
+
+  // ── Sales Module ──
+  { key: 'sales__price_lists', label: 'Price Lists', path: '/sales/price-lists', module: 'Sales', defaultGroup: 'Master Data' },
+  { key: 'sales__quotations', label: 'Quotations', path: '/sales/quotations', module: 'Sales', defaultGroup: 'Orders' },
+  { key: 'sales__orders', label: 'Sales Orders', path: '/sales/orders', module: 'Sales', defaultGroup: 'Orders' },
+  { key: 'sales__goods_issue_notes', label: 'Goods Issue Notes', path: '/sales/delivery-notes', module: 'Sales', defaultGroup: 'Fulfillment' },
+  { key: 'sales__returns', label: 'Sales Returns', path: '/sales/returns', module: 'Sales', defaultGroup: 'Post-Sales' },
+  { key: 'sales__credit_notes', label: 'Credit Notes', path: '/sales/credit-notes', module: 'Sales', defaultGroup: 'Post-Sales' },
+  { key: 'sales__pos', label: 'POS Terminal', path: '/sales/pos', module: 'Sales', defaultGroup: 'POS' },
+
+  { key: 'sales__pos_sessions', label: 'Terminal Sessions', path: '/sales/pos/sessions', module: 'Sales', defaultGroup: 'POS' },
+  { key: 'sales__reports', label: 'Sales Reports', path: '/sales/reports', module: 'Sales', defaultGroup: 'Analytics' },
+
+  // ── Procurement Module ──
+  { key: 'procurement__orders', label: 'Purchase Orders', path: '/procurement/orders', module: 'Procurement', defaultGroup: 'Orders' },
+  { key: 'procurement__grn', label: 'Goods Receipt', path: '/procurement/grns', module: 'Procurement', defaultGroup: 'Receiving' },
+  { key: 'procurement__invoices', label: 'Invoices', path: '/finance/invoices', module: 'Procurement', defaultGroup: 'Finance' },
+  { key: 'procurement__payments', label: 'Payments', path: '/finance/payments', module: 'Procurement', defaultGroup: 'Finance' },
+
+  // ── Finance Module ──
+  { key: 'finance__invoices', label: 'Invoices', path: '/finance/invoices', module: 'Finance', defaultGroup: 'Transactions' },
+  { key: 'finance__payments', label: 'Payments', path: '/finance/payments', module: 'Finance', defaultGroup: 'Transactions' },
+  { key: 'finance__chart_of_accounts', label: 'Chart of Accounts', path: '/finance/chart-of-accounts', module: 'Finance', defaultGroup: 'Accounting' },
+  { key: 'finance__journal_entries', label: 'Journal Entries', path: '/finance/journal-entries', module: 'Finance', defaultGroup: 'Accounting' },
+  { key: 'finance__fiscal_years', label: 'Fiscal Years', path: '/finance/fiscal-years', module: 'Finance', defaultGroup: 'Accounting' },
+  { key: 'finance__trial_balance', label: 'Trial Balance', path: '/finance/reports/trial-balance', module: 'Finance', defaultGroup: 'Reports' },
+  { key: 'finance__profit_loss', label: 'Profit & Loss', path: '/finance/reports/profit-loss', module: 'Finance', defaultGroup: 'Reports' },
+  { key: 'finance__balance_sheet', label: 'Balance Sheet', path: '/finance/reports/balance-sheet', module: 'Finance', defaultGroup: 'Reports' },
+  { key: 'finance__account_ledger', label: 'Account Ledger', path: '/finance/reports/account-ledger', module: 'Finance', defaultGroup: 'Reports' },
+  { key: 'finance__payment_modes', label: 'Payment Modes', path: '/finance/payment-modes', module: 'Finance', defaultGroup: 'Settings' },
+  { key: 'finance__bank_accounts', label: 'Bank Accounts', path: '/finance/bank-accounts', module: 'Finance', defaultGroup: 'Settings' },
+  { key: 'finance__account_mappings', label: 'Account Mappings', path: '/finance/account-mappings', module: 'Finance', defaultGroup: 'Settings' },
+
+  // ── Jewelry Module ──
+  { key: 'jewelry__items', label: 'Jewelry Items', path: '/jewelry/items', module: 'Jewelry', defaultGroup: 'Catalog' },
+  { key: 'jewelry__categories', label: 'Categories', path: '/jewelry/categories', module: 'Jewelry', defaultGroup: 'Catalog' },
+  { key: 'jewelry__material_types', label: 'Material Types', path: '/jewelry/material-types', module: 'Jewelry', defaultGroup: 'Master Data' },
+  { key: 'jewelry__purities', label: 'Purities', path: '/jewelry/purities', module: 'Jewelry', defaultGroup: 'Master Data' },
+  { key: 'jewelry__metal_rates', label: 'Metal Rates', path: '/jewelry/metal-rates', module: 'Jewelry', defaultGroup: 'Master Data' },
+  { key: 'jewelry__purchase_orders', label: 'Purchase Orders', path: '/jewelry/procurement/orders', module: 'Jewelry', defaultGroup: 'Procurement' },
+  { key: 'jewelry__grn', label: 'Goods Receipt', path: '/jewelry/procurement/grn', module: 'Jewelry', defaultGroup: 'Procurement' },
+  { key: 'jewelry__custom_orders', label: 'Custom Orders', path: '/jewelry/custom-orders', module: 'Jewelry', defaultGroup: 'Procurement' },
+  { key: 'jewelry__transformations', label: 'Transformations', path: '/jewelry/procurement/transformations', module: 'Jewelry', defaultGroup: 'Procurement' },
+  { key: 'jewelry__old_gold_purchases', label: 'Old Material Purchases', path: '/jewelry/old-gold-purchases', module: 'Jewelry', defaultGroup: 'Buying' },
+  { key: 'jewelry__sales', label: 'Sales', path: '/jewelry/sales', module: 'Jewelry', defaultGroup: 'Sales' },
+  { key: 'jewelry__sales_orders', label: 'Sales Orders', path: '/jewelry/sales/orders', module: 'Jewelry', defaultGroup: 'Sales' },
+  { key: 'jewelry__stock_balances', label: 'Stock Balances', path: '/jewelry/stock/balances', module: 'Jewelry', defaultGroup: 'Stock' },
+  { key: 'jewelry__stock_movements', label: 'Stock Movements', path: '/jewelry/stock/movements', module: 'Jewelry', defaultGroup: 'Stock' },
+  { key: 'jewelry__party_transactions', label: 'Party Transactions', path: '/jewelry/party-transactions', module: 'Jewelry', defaultGroup: 'Karigar' },
+  { key: 'jewelry__settings', label: 'Settings', path: '/jewelry/settings', module: 'Jewelry', defaultGroup: 'Configuration' },
+];
+
+/**
+ * Get all unique module names from the registry.
+ */
+export function getRegistryModules(): string[] {
+  const modules = new Set(MENU_ITEM_REGISTRY.map(item => item.module));
+  return Array.from(modules);
+}
+
+/**
+ * Get registry items filtered by module.
+ */
+export function getRegistryItemsByModule(module: string): RegistryItem[] {
+  return MENU_ITEM_REGISTRY.filter(item => item.module === module);
+}
+
+/**
+ * Resolve secondary item configs into MainMenuItem groups.
+ * Accepts both plain string keys (legacy) and enriched objects with
+ * optional label / group overrides.
+ */
+export function resolveRegistryKeys(items: SecondaryItemConfig[]): SubMenuGroup[] {
+  const groupMap = new Map<string, SubMenuItem[]>();
+  // Track insertion order of groups
+  const groupOrder: string[] = [];
+
+  for (const raw of items) {
+    const cfg = normalizeSecondaryItem(raw);
+    const reg = MENU_ITEM_REGISTRY.find(r => r.key === cfg.key);
+    if (!reg) continue;
+
+    const groupLabel = cfg.group || reg.defaultGroup;
+
+    if (!groupMap.has(groupLabel)) {
+      groupMap.set(groupLabel, []);
+      groupOrder.push(groupLabel);
+    }
+    groupMap.get(groupLabel)!.push({
+      id: cfg.key,
+      label: cfg.label || reg.label,
+      path: reg.path,
+    });
+  }
+
+  return groupOrder.map(label => ({
+    id: label.toLowerCase().replace(/[^a-z0-9]+/g, '_'),
+    label,
+    items: groupMap.get(label)!,
+  }));
+}
+
+
+// ─── PRESET MENU CONFIGURATIONS ──────────────────────────────────
+// These are the default/example configs for different business types.
+
+export interface MenuPreset {
+  id: string;
+  label: string;
+  description: string;
+  primaryMenus: {
+    id: string;
+    label: string;
+    iconName: string;
+    secondaryItems: string[];   // registry keys
+  }[];
+}
+
+export const MENU_PRESETS: MenuPreset[] = [
+  {
+    id: 'default_full',
+    label: 'Core Only',
+    description: 'System modules only',
+    primaryMenus: [
+      {
+        id: 'core',
+        label: 'Core',
+        iconName: 'Settings',
+        secondaryItems: [
+          'core__users', 'core__roles', 'core__organizations', 'core__parties',
+          'core__warehouses', 'core__terminals',
+          'core__activity_logs', 'core__api_requests', 'core__feature_access_logs',
+          'core__issue_logs', 'core__feature_registry', 'core__menu_config',
+          'core__printables',
+        ],
+      },
+      {
+        id: 'inventory',
+        label: 'Inventory',
+        iconName: 'Package',
+        secondaryItems: [
+          'inventory__items', 'inventory__categories', 'inventory__brands', 'inventory__uom',
+          'inventory__stock', 'inventory__ledger',
+          'inventory__adjustments', 'inventory__transfers', 'inventory__serials',
+        ],
+      },
+      {
+        id: 'sales',
+        label: 'Sales',
+        iconName: 'ShoppingCart',
+        secondaryItems: [
+          'sales__price_lists',
+          'sales__quotations', 'sales__orders', 'sales__goods_issue_notes',
+          'sales__returns', 'sales__credit_notes',
+          'sales__pos', 'sales__pos_sessions', 'sales__reports',
+        ],
+      },
+      {
+        id: 'procurement',
+        label: 'Procurement',
+        iconName: 'Truck',
+        secondaryItems: [
+          'procurement__orders', 'procurement__grn',
+          'procurement__invoices', 'procurement__payments',
+        ],
+      },
+      {
+        id: 'finance',
+        label: 'Finance',
+        iconName: 'Wallet',
+        secondaryItems: [
+          'finance__invoices', 'finance__payments',
+          'finance__chart_of_accounts', 'finance__journal_entries', 'finance__fiscal_years',
+          'finance__trial_balance', 'finance__profit_loss', 'finance__balance_sheet', 'finance__account_ledger',
+          'finance__payment_modes', 'finance__bank_accounts', 'finance__account_mappings',
+        ],
+      },
+      {
+        id: 'jewelry',
+        label: 'Jewelry',
+        iconName: 'Gem',
+        secondaryItems: [
+          'jewelry__items', 'jewelry__categories',
+          'jewelry__material_types', 'jewelry__purities', 'jewelry__metal_rates',
+          'jewelry__purchase_orders', 'jewelry__grn', 'jewelry__custom_orders', 'jewelry__transformations',
+          'jewelry__old_gold_purchases',
+          'jewelry__sales', 'jewelry__sales_orders',
+          'jewelry__stock_balances', 'jewelry__stock_movements',
+          'jewelry__party_transactions',
+          'jewelry__settings',
+        ],
+      },
+    ],
+  },
+];
+
+
+// ─── DEFAULT APP MENUS (legacy / fallback) ───────────────────────
+// This is the current static config, used when no custom config exists.
+
+export const APP_MENUS: MainMenuItem[] = [
+  {
+    id: "core",
+    label: "Core",
+    iconName: "Settings",
+    groups: [
+      {
+        id: "core_users",
+        label: "User Management",
+        items: [
+          { id: "users", label: "Users", path: "/users" },
+          { id: "roles", label: "Roles", path: "/roles" },
+          { id: "organizations", label: "Organizations", path: "/organizations" },
+          { id: "parties", label: "Parties", path: "/parties" },
+        ],
+      },
+      {
+        id: "core_system",
+        label: "System",
+        items: [
+          { id: "menu_config", label: "Menu Configuration", path: "/menu-config" },
+          { id: "printables", label: "Printable Templates", path: "/system/printables" },
+        ],
+      },
+      {
+        id: "core_resources",
+        label: "Resources",
+        items: [
+          { id: "warehouses", label: "Warehouses", path: "/warehouses" },
+          { id: "terminals", label: "Terminals", path: "/terminals" },
+        ],
+      },
+      {
+        id: "core_audit",
+        label: "System Auditing",
+        items: [
+          { id: "activity_logs", label: "Activity Logs", path: "/activity-logs" },
+          { id: "api_requests", label: "API Requests", path: "/system/api-requests" },
+          { id: "feature_access_logs", label: "Feature Access Logs", path: "/system/feature-access-logs" },
+          { id: "issue_logs", label: "Issue Logs", path: "/system/issue-logs" },
+          { id: "feature_registry", label: "Feature Registry", path: "/system/features" },
+        ],
+      },
+    ],
+  },
+  {
+    id: "inventory",
+    label: "Inventory",
+    iconName: "Package",
+    groups: [
+      {
+        id: "inventory_catalog",
+        label: "Catalog",
+        items: [
+          { id: "items", label: "Items", path: "/inventory/items" },
+          { id: "categories", label: "Categories", path: "/inventory/categories" },
+          { id: "brands", label: "Brands", path: "/inventory/brands" },
+          { id: "uom", label: "Units of Measure", path: "/inventory/uom" },
+        ],
+      },
+      {
+        id: "inventory_stock",
+        label: "Stock",
+        items: [
+          { id: "stock", label: "Stock Overview", path: "/inventory/stock" },
+          { id: "ledger", label: "Stock Movements", path: "/inventory/ledger" },
+        ],
+      },
+      {
+        id: "inventory_operations",
+        label: "Operations",
+        items: [
+          { id: "adjustments", label: "Adjustments", path: "/inventory/adjustments" },
+          { id: "transfers", label: "Transfers", path: "/inventory/transfers" },
+          { id: "serials", label: "Serial Numbers", path: "/inventory/serials" },
+        ],
+      },
+    ],
+  },
+  {
+    id: "sales",
+    label: "Sales",
+    iconName: "ShoppingCart",
+    groups: [
+      {
+        id: "sales_master_data",
+        label: "Master Data",
+        items: [
+          { id: "price_lists", label: "Price Lists", path: "/sales/price-lists" },
+        ],
+      },
+      {
+        id: "sales_orders",
+        label: "Orders",
+        items: [
+          { id: "quotations", label: "Quotations", path: "/sales/quotations" },
+          { id: "sales_orders", label: "Sales Orders", path: "/sales/orders" },
+        ],
+      },
+      {
+        id: "sales_fulfillment",
+        label: "Fulfillment",
+        items: [
+          { id: "goods_issue_notes", label: "Goods Issue Notes", path: "/sales/delivery-notes" },
+        ],
+      },
+      {
+        id: "sales_post_sales",
+        label: "Post-Sales",
+        items: [
+          { id: "returns", label: "Sales Returns", path: "/sales/returns" },
+          { id: "credit_notes", label: "Credit Notes", path: "/sales/credit-notes" },
+        ],
+      },
+      {
+        id: "sales_pos",
+        label: "POS",
+        items: [
+          { id: "pos_terminal", label: "POS Terminal", path: "/sales/pos" },
+          { id: "pos_sessions", label: "Terminal Sessions", path: "/sales/pos/sessions" },
+        ],
+      },
+      {
+        id: "sales_analytics",
+        label: "Analytics",
+        items: [
+          { id: "sales_reports", label: "Sales Reports", path: "/sales/reports" },
+        ],
+      },
+    ],
+  },
+  {
+    id: "procurement",
+    label: "Procurement",
+    iconName: "Truck",
+    groups: [
+      {
+        id: "procurement_orders",
+        label: "Orders",
+        items: [
+          { id: "purchase_orders", label: "Purchase Orders", path: "/procurement/orders" },
+        ],
+      },
+      {
+        id: "procurement_receiving",
+        label: "Receiving",
+        items: [
+          { id: "goods_receipt", label: "Goods Receipt", path: "/procurement/grns" },
+        ],
+      },
+      {
+        id: "procurement_finance",
+        label: "Finance",
+        items: [
+          { id: "ap_invoices", label: "Invoices", path: "/finance/invoices" },
+          { id: "outgoing_payments", label: "Payments", path: "/finance/payments" },
+        ],
+      },
+    ],
+  },
+  {
+    id: "finance",
+    label: "Finance",
+    iconName: "Wallet",
+    groups: [
+      {
+        id: "finance_transactions",
+        label: "Transactions",
+        items: [
+          { id: "invoices", label: "Invoices", path: "/finance/invoices" },
+          { id: "payments", label: "Payments", path: "/finance/payments" },
+        ],
+      },
+      {
+        id: "finance_accounting",
+        label: "Accounting",
+        items: [
+          { id: "chart_of_accounts", label: "Chart of Accounts", path: "/finance/chart-of-accounts" },
+          { id: "journal_entries", label: "Journal Entries", path: "/finance/journal-entries" },
+          { id: "fiscal_years", label: "Fiscal Years", path: "/finance/fiscal-years" },
+        ],
+      },
+      {
+        id: "finance_reports",
+        label: "Reports",
+        items: [
+          { id: "trial_balance", label: "Trial Balance", path: "/finance/reports/trial-balance" },
+          { id: "profit_loss", label: "Profit & Loss", path: "/finance/reports/profit-loss" },
+          { id: "balance_sheet", label: "Balance Sheet", path: "/finance/reports/balance-sheet" },
+          { id: "account_ledger", label: "Account Ledger", path: "/finance/reports/account-ledger" },
+        ],
+      },
+      {
+        id: "finance_settings",
+        label: "Settings",
+        items: [
+          { id: "payment_modes", label: "Payment Modes", path: "/finance/payment-modes" },
+          { id: "bank_accounts", label: "Bank Accounts", path: "/finance/bank-accounts" },
+          { id: "account_mappings", label: "Account Mappings", path: "/finance/account-mappings" },
+        ],
+      },
+    ],
+  },
+  {
+    id: "jewelry",
+    label: "Jewelry",
+    iconName: "Gem",
+    groups: [
+      {
+        id: "jewelry_catalog",
+        label: "Catalog",
+        items: [
+          { id: "jewelry_items", label: "Jewelry Items", path: "/jewelry/items" },
+          { id: "jewelry_categories", label: "Categories", path: "/jewelry/categories" },
+        ],
+      },
+      {
+        id: "jewelry_master_data",
+        label: "Master Data",
+        items: [
+          { id: "material_types", label: "Material Types", path: "/jewelry/material-types" },
+          { id: "purities", label: "Purities", path: "/jewelry/purities" },
+          { id: "metal_rates", label: "Metal Rates", path: "/jewelry/metal-rates" },
+        ],
+      },
+      {
+        id: "jewelry_procurement",
+        label: "Procurement",
+        items: [
+          { id: "purchase_orders", label: "Purchase Orders", path: "/jewelry/procurement/orders" },
+          { id: "goods_receipt", label: "Goods Receipt", path: "/jewelry/procurement/grn" },
+          { id: "custom_orders", label: "Custom Orders", path: "/jewelry/custom-orders" },
+          { id: "transformations", label: "Transformations", path: "/jewelry/procurement/transformations" },
+        ],
+      },
+      {
+        id: "jewelry_buying",
+        label: "Buying",
+        items: [
+          { id: "old_gold_purchases", label: "Old Material Purchases", path: "/jewelry/old-gold-purchases" },
+        ],
+      },
+      {
+        id: "jewelry_sales",
+        label: "Sales",
+        items: [
+          { id: "jewelry_sales_main", label: "Sales", path: "/jewelry/sales" },
+          { id: "sales_orders", label: "Sales Orders", path: "/jewelry/sales/orders" },
+        ],
+      },
+      {
+        id: "jewelry_stock",
+        label: "Stock",
+        items: [
+          { id: "stock_balances", label: "Stock Balances", path: "/jewelry/stock/balances" },
+          { id: "stock_movements", label: "Stock Movements", path: "/jewelry/stock/movements" },
+        ],
+      },
+      {
+        id: "jewelry_karigar",
+        label: "Karigar",
+        items: [
+          { id: "party_transactions", label: "Party Transactions", path: "/jewelry/party-transactions" },
+        ],
+      },
+      {
+        id: "jewelry_configuration",
+        label: "Configuration",
+        items: [
+          { id: "jewelry_settings", label: "Settings", path: "/jewelry/settings" },
+        ],
+      },
+    ],
+  },
+];
+
+/**
+ * Builds MainMenuItem[] from a saved menu config (from the API).
+ * Supports both legacy string[] and enriched SecondaryItemConfig[] formats.
+ */
+export function buildMenusFromConfig(config: {
+  primaryMenus: { id: string; label: string; iconName: string; secondaryItems: SecondaryItemConfig[] }[];
+}): MainMenuItem[] {
+  return config.primaryMenus.map(pm => ({
+    id: pm.id,
+    label: pm.label,
+    iconName: pm.iconName,
+    groups: resolveRegistryKeys(pm.secondaryItems),
+  }));
+}

package/src/constants/storageKeys.ts

@@ -1,9 +1,14 @@
-export interface IStorageOptions {
-    name: string;
-    secretName: string;
-    encrypted: boolean;
-}
-
-export const cookie = {
-    access_token: { name: 'access_token', secretName: 'PATKXFGLSIZXZBXEEFK', encrypted: true } as IStorageOptions
-};
+export interface IStorageOptions {
+    name: string;
+    secretName: string;
+    encrypted: boolean;
+}
+
+export const cookie = {
+    access_token: { name: 'access_token', secretName: 'PATKXFGLSIZXZBXEEFK', encrypted: false } as IStorageOptions
+};
+
+export const local_storage = {
+    user_info: { name: 'user_info', secretName: 'USER_INFO_SECRET', encrypted: false } as IStorageOptions,
+    selected_organization: { name: 'selected_organization', secretName: 'SELECTED_ORG', encrypted: false } as IStorageOptions
+};

package/src/index.ts

@@ -1,8 +1,3 @@
-export * from './utils/commonService';
-export * from './utils/cookiesHandler';
-export * from './utils/httpClient';
-export * from './utils/localStorageHandler';
-export * from './utils/bem';
-export * from './utils/cn';
-export * from './common/interfaces/ICommon';
-export * from './constants/storageKeys';
+// Default entry point — client-safe (no 'use server' modules)
+// For server components/actions, import from '@apptimate/core-lib/src/server'
+export * from './client';

package/src/server.ts

@@ -0,0 +1,12 @@
+// Server-safe exports — includes everything including 'use server' modules
+export * from './utils/commonService';
+export * from './utils/cookiesHandler';
+export * from './utils/httpClient';
+export * from './utils/localStorageHandler';
+export * from './utils/bem';
+export * from './utils/cn';
+export * from './common/interfaces/ICommon';
+export * from './constants/storageKeys';
+export * from './constants/menus';
+export * from './constants/iconRegistry';
+export * from './utils/bootstrapConfig';