@adminide-stack/core 12.0.4-alpha.95 → 13.0.1-alpha.1

package/lib/core/configurations/utils/configurationExtractor.d.ts

@@ -0,0 +1,224 @@
+import { ConfigurationModel } from '../models/ConfigurationModel';
+/**
+ * Utility to extract overrides and keys from configuration data
+ *
+ * This handles bracket-notation override identifiers like:
+ * - [desktop]
+ * - [/o/:orgName/vault]
+ * - [/o/:orgName/vault][desktop]
+ *
+ * Reuses existing utilities from configuration.ts:
+ * - OVERRIDE_PROPERTY_REGEX: Pattern to match bracket keys
+ * - overrideIdentifiersFromKey: Parse identifiers from bracket notation
+ */
+export interface ConfigurationOverride {
+    identifiers: string[];
+    contents: any;
+    keys: string[];
+}
+export interface ExtractedConfiguration {
+    baseContents: any;
+    baseKeys: string[];
+    overrides: ConfigurationOverride[];
+}
+/**
+ * Check if a key is a bracket-notation override identifier
+ * Uses OVERRIDE_PROPERTY_REGEX from configuration.ts
+ *
+ * @param key - The key to check
+ * @returns True if the key matches the override pattern
+ *
+ * @example
+ * ```typescript
+ * isBracketKey('[desktop]') // true
+ * isBracketKey('[/o/:orgName/vault]') // true
+ * isBracketKey('[/route][desktop]') // true
+ * isBracketKey('headerBgColor') // false
+ * ```
+ */
+export declare function isBracketKey(key: string): boolean;
+/**
+ * Extract individual identifiers from a bracket key
+ * Reuses overrideIdentifiersFromKey from configuration.ts
+ * Handles compound identifiers like [/route][desktop]
+ *
+ * @param key - The bracket key to parse
+ * @returns Array of identifiers without brackets
+ *
+ * @example
+ * ```typescript
+ * extractIdentifiersFromKey('[desktop]')
+ * // Returns: ['desktop']
+ *
+ * extractIdentifiersFromKey('[/o/:orgName/vault]')
+ * // Returns: ['/o/:orgName/vault']
+ *
+ * extractIdentifiersFromKey('[/o/:orgName/vault][desktop]')
+ * // Returns: ['/o/:orgName/vault', 'desktop']
+ * ```
+ */
+export declare function extractIdentifiersFromKey(key: string): string[];
+/**
+ * Extract overrides and base configuration from settings object
+ *
+ * @param settings - Configuration object that may contain bracket-notation overrides
+ * @returns Extracted base contents, keys, and overrides array
+ *
+ * @example
+ * ```typescript
+ * const settings = {
+ *   headerBgColor: "#000000",
+ *   textColor: "#a19c9c",
+ *   "[/o/:orgName/vault]": {
+ *     navTheme: "realDark",
+ *     primaryColor: "#1890ff"
+ *   },
+ *   "[/o/:orgName/pref/settings]": {
+ *     header: { menuHeaderRender: false }
+ *   }
+ * };
+ *
+ * const { baseContents, baseKeys, overrides } = extractConfiguration(settings);
+ * // baseContents: { headerBgColor: "#000000", textColor: "#a19c9c" }
+ * // baseKeys: ["headerBgColor", "textColor"]
+ * // overrides: [
+ * //   { identifiers: ["/o/:orgName/vault"], contents: {...}, keys: [...] },
+ * //   { identifiers: ["/o/:orgName/pref/settings"], contents: {...}, keys: [...] }
+ * // ]
+ * ```
+ */
+export declare function extractConfiguration(settings: any): ExtractedConfiguration;
+/**
+ * Get only the override keys (bracket-notation keys) from settings
+ *
+ * @param settings - Configuration object
+ * @returns Array of bracket keys
+ *
+ * @example
+ * ```typescript
+ * const settings = {
+ *   headerBgColor: "#000000",
+ *   "[/o/:orgName/vault]": {...},
+ *   "[desktop]": {...}
+ * };
+ *
+ * getOverrideKeys(settings)
+ * // Returns: ['[/o/:orgName/vault]', '[desktop]']
+ * ```
+ */
+export declare function getOverrideKeys(settings: any): string[];
+/**
+ * Get only the base keys (non-bracket keys) from settings
+ *
+ * @param settings - Configuration object
+ * @returns Array of base keys
+ *
+ * @example
+ * ```typescript
+ * const settings = {
+ *   headerBgColor: "#000000",
+ *   textColor: "#a19c9c",
+ *   "[/o/:orgName/vault]": {...}
+ * };
+ *
+ * getBaseKeys(settings)
+ * // Returns: ['headerBgColor', 'textColor']
+ * ```
+ */
+export declare function getBaseKeys(settings: any): string[];
+/**
+ * Remove all bracket-notation keys from an object
+ * Returns a new object with only base properties
+ *
+ * @param settings - Configuration object
+ * @returns New object without bracket keys
+ *
+ * @example
+ * ```typescript
+ * const settings = {
+ *   headerBgColor: "#000000",
+ *   "[/o/:orgName/vault]": {...},
+ *   textColor: "#a19c9c"
+ * };
+ *
+ * removeOverrideKeys(settings)
+ * // Returns: { headerBgColor: "#000000", textColor: "#a19c9c" }
+ * ```
+ */
+export declare function removeOverrideKeys(settings: any): any;
+/**
+ * Check if settings object has any override identifiers
+ *
+ * @param settings - Configuration object
+ * @returns True if any bracket keys exist
+ *
+ * @example
+ * ```typescript
+ * hasOverrides({ headerBgColor: "#000" }) // false
+ * hasOverrides({ "[desktop]": {...} }) // true
+ * ```
+ */
+export declare function hasOverrides(settings: any): boolean;
+/**
+ * Get a specific override by identifier
+ *
+ * @param settings - Configuration object
+ * @param identifier - The identifier to search for (without brackets)
+ * @returns The override contents or undefined if not found
+ *
+ * @example
+ * ```typescript
+ * const settings = {
+ *   "[/o/:orgName/vault]": { navTheme: "realDark" },
+ *   "[desktop]": { theme: "dark" }
+ * };
+ *
+ * getOverrideByIdentifier(settings, '/o/:orgName/vault')
+ * // Returns: { navTheme: "realDark" }
+ *
+ * getOverrideByIdentifier(settings, 'desktop')
+ * // Returns: { theme: "dark" }
+ * ```
+ */
+export declare function getOverrideByIdentifier(settings: any, identifier: string): any | undefined;
+/**
+ * Convert extracted configuration directly into a ConfigurationModel
+ *
+ * @param settings - Configuration object with bracket-notation overrides
+ * @returns ConfigurationModel instance ready to use
+ *
+ * @example
+ * ```typescript
+ * const settings = {
+ *   theme: "light",
+ *   "[desktop]": { theme: "dark" },
+ *   "[/o/:orgName/vault]": { navTheme: "realDark" }
+ * };
+ *
+ * const model = createConfigurationModel(settings);
+ * // Now you can use: model.getValue(), model.override('desktop'), etc.
+ * ```
+ */
+export declare function createConfigurationModel(settings: any): ConfigurationModel;
+/**
+ * Extract configuration and return both the extracted data and ConfigurationModel
+ *
+ * @param settings - Configuration object with bracket-notation overrides
+ * @returns Both extracted configuration and ConfigurationModel
+ *
+ * @example
+ * ```typescript
+ * const settings = {
+ *   theme: "light",
+ *   "[desktop]": { theme: "dark" }
+ * };
+ *
+ * const { extracted, model } = extractConfigurationWithModel(settings);
+ * // extracted: { baseContents, baseKeys, overrides }
+ * // model: ConfigurationModel instance
+ * ```
+ */
+export declare function extractConfigurationWithModel(settings: any): {
+    extracted: ExtractedConfiguration;
+    model: ConfigurationModel;
+};

package/lib/core/configurations/utils/configurationExtractor.js

@@ -0,0 +1,315 @@
+import {OVERRIDE_PROPERTY_REGEX,overrideIdentifiersFromKey}from'../configuration.js';import {ConfigurationModel}from'../models/ConfigurationModel.js';/* eslint-disable @typescript-eslint/no-explicit-any */
+// ============================================================================
+// Core Utility Functions (Reusing existing utilities)
+// ============================================================================
+/**
+ * Check if a key is a bracket-notation override identifier
+ * Uses OVERRIDE_PROPERTY_REGEX from configuration.ts
+ *
+ * @param key - The key to check
+ * @returns True if the key matches the override pattern
+ *
+ * @example
+ * ```typescript
+ * isBracketKey('[desktop]') // true
+ * isBracketKey('[/o/:orgName/vault]') // true
+ * isBracketKey('[/route][desktop]') // true
+ * isBracketKey('headerBgColor') // false
+ * ```
+ */
+function isBracketKey(key) {
+  return OVERRIDE_PROPERTY_REGEX.test(key);
+}
+/**
+ * Extract individual identifiers from a bracket key
+ * Reuses overrideIdentifiersFromKey from configuration.ts
+ * Handles compound identifiers like [/route][desktop]
+ *
+ * @param key - The bracket key to parse
+ * @returns Array of identifiers without brackets
+ *
+ * @example
+ * ```typescript
+ * extractIdentifiersFromKey('[desktop]')
+ * // Returns: ['desktop']
+ *
+ * extractIdentifiersFromKey('[/o/:orgName/vault]')
+ * // Returns: ['/o/:orgName/vault']
+ *
+ * extractIdentifiersFromKey('[/o/:orgName/vault][desktop]')
+ * // Returns: ['/o/:orgName/vault', 'desktop']
+ * ```
+ */
+function extractIdentifiersFromKey(key) {
+  return overrideIdentifiersFromKey(key);
+}
+/**
+ * Extract overrides and base configuration from settings object
+ *
+ * @param settings - Configuration object that may contain bracket-notation overrides
+ * @returns Extracted base contents, keys, and overrides array
+ *
+ * @example
+ * ```typescript
+ * const settings = {
+ *   headerBgColor: "#000000",
+ *   textColor: "#a19c9c",
+ *   "[/o/:orgName/vault]": {
+ *     navTheme: "realDark",
+ *     primaryColor: "#1890ff"
+ *   },
+ *   "[/o/:orgName/pref/settings]": {
+ *     header: { menuHeaderRender: false }
+ *   }
+ * };
+ *
+ * const { baseContents, baseKeys, overrides } = extractConfiguration(settings);
+ * // baseContents: { headerBgColor: "#000000", textColor: "#a19c9c" }
+ * // baseKeys: ["headerBgColor", "textColor"]
+ * // overrides: [
+ * //   { identifiers: ["/o/:orgName/vault"], contents: {...}, keys: [...] },
+ * //   { identifiers: ["/o/:orgName/pref/settings"], contents: {...}, keys: [...] }
+ * // ]
+ * ```
+ */
+function extractConfiguration(settings) {
+  const baseContents = {};
+  const overrides = [];
+  if (!settings || typeof settings !== 'object') {
+    return {
+      baseContents: {},
+      baseKeys: [],
+      overrides: []
+    };
+  }
+  // Iterate through all keys in the settings object
+  Object.keys(settings).forEach(key => {
+    if (isBracketKey(key)) {
+      // This is a bracket override: [device] or [/route][device]
+      const overrideData = settings[key];
+      const identifiers = extractIdentifiersFromKey(key);
+      overrides.push({
+        identifiers,
+        contents: overrideData,
+        keys: Object.keys(overrideData || {})
+      });
+    } else {
+      // Base settings (flat, no wrapper)
+      baseContents[key] = settings[key];
+    }
+  });
+  const baseKeys = Object.keys(baseContents);
+  return {
+    baseContents,
+    baseKeys,
+    overrides
+  };
+}
+// ============================================================================
+// Additional Helper Functions
+// ============================================================================
+/**
+ * Get only the override keys (bracket-notation keys) from settings
+ *
+ * @param settings - Configuration object
+ * @returns Array of bracket keys
+ *
+ * @example
+ * ```typescript
+ * const settings = {
+ *   headerBgColor: "#000000",
+ *   "[/o/:orgName/vault]": {...},
+ *   "[desktop]": {...}
+ * };
+ *
+ * getOverrideKeys(settings)
+ * // Returns: ['[/o/:orgName/vault]', '[desktop]']
+ * ```
+ */
+function getOverrideKeys(settings) {
+  if (!settings || typeof settings !== 'object') {
+    return [];
+  }
+  return Object.keys(settings).filter(isBracketKey);
+}
+/**
+ * Get only the base keys (non-bracket keys) from settings
+ *
+ * @param settings - Configuration object
+ * @returns Array of base keys
+ *
+ * @example
+ * ```typescript
+ * const settings = {
+ *   headerBgColor: "#000000",
+ *   textColor: "#a19c9c",
+ *   "[/o/:orgName/vault]": {...}
+ * };
+ *
+ * getBaseKeys(settings)
+ * // Returns: ['headerBgColor', 'textColor']
+ * ```
+ */
+function getBaseKeys(settings) {
+  if (!settings || typeof settings !== 'object') {
+    return [];
+  }
+  return Object.keys(settings).filter(key => !isBracketKey(key));
+}
+/**
+ * Remove all bracket-notation keys from an object
+ * Returns a new object with only base properties
+ *
+ * @param settings - Configuration object
+ * @returns New object without bracket keys
+ *
+ * @example
+ * ```typescript
+ * const settings = {
+ *   headerBgColor: "#000000",
+ *   "[/o/:orgName/vault]": {...},
+ *   textColor: "#a19c9c"
+ * };
+ *
+ * removeOverrideKeys(settings)
+ * // Returns: { headerBgColor: "#000000", textColor: "#a19c9c" }
+ * ```
+ */
+function removeOverrideKeys(settings) {
+  if (!settings || typeof settings !== 'object') {
+    return {};
+  }
+  const result = {};
+  Object.keys(settings).forEach(key => {
+    if (!isBracketKey(key)) {
+      result[key] = settings[key];
+    }
+  });
+  return result;
+}
+/**
+ * Check if settings object has any override identifiers
+ *
+ * @param settings - Configuration object
+ * @returns True if any bracket keys exist
+ *
+ * @example
+ * ```typescript
+ * hasOverrides({ headerBgColor: "#000" }) // false
+ * hasOverrides({ "[desktop]": {...} }) // true
+ * ```
+ */
+function hasOverrides(settings) {
+  if (!settings || typeof settings !== 'object') {
+    return false;
+  }
+  return Object.keys(settings).some(isBracketKey);
+}
+/**
+ * Get a specific override by identifier
+ *
+ * @param settings - Configuration object
+ * @param identifier - The identifier to search for (without brackets)
+ * @returns The override contents or undefined if not found
+ *
+ * @example
+ * ```typescript
+ * const settings = {
+ *   "[/o/:orgName/vault]": { navTheme: "realDark" },
+ *   "[desktop]": { theme: "dark" }
+ * };
+ *
+ * getOverrideByIdentifier(settings, '/o/:orgName/vault')
+ * // Returns: { navTheme: "realDark" }
+ *
+ * getOverrideByIdentifier(settings, 'desktop')
+ * // Returns: { theme: "dark" }
+ * ```
+ */
+function getOverrideByIdentifier(settings, identifier) {
+  if (!settings || typeof settings !== 'object' || !identifier) {
+    return undefined;
+  }
+  // Try exact match with brackets
+  const exactKey = `[${identifier}]`;
+  if (settings[exactKey]) {
+    return settings[exactKey];
+  }
+  // Try finding in compound keys
+  for (const key of Object.keys(settings)) {
+    if (isBracketKey(key)) {
+      const identifiers = extractIdentifiersFromKey(key);
+      if (identifiers.includes(identifier)) {
+        return settings[key];
+      }
+    }
+  }
+  return undefined;
+}
+// ============================================================================
+// ConfigurationModel Creation
+// ============================================================================
+/**
+ * Convert extracted configuration directly into a ConfigurationModel
+ *
+ * @param settings - Configuration object with bracket-notation overrides
+ * @returns ConfigurationModel instance ready to use
+ *
+ * @example
+ * ```typescript
+ * const settings = {
+ *   theme: "light",
+ *   "[desktop]": { theme: "dark" },
+ *   "[/o/:orgName/vault]": { navTheme: "realDark" }
+ * };
+ *
+ * const model = createConfigurationModel(settings);
+ * // Now you can use: model.getValue(), model.override('desktop'), etc.
+ * ```
+ */
+function createConfigurationModel(settings) {
+  const {
+    baseContents,
+    baseKeys,
+    overrides
+  } = extractConfiguration(settings);
+  // Convert our ConfigurationOverride format to IOverrides format
+  const iOverrides = overrides.map(override => ({
+    identifiers: override.identifiers,
+    keys: override.keys,
+    contents: override.contents
+  }));
+  // Create and return ConfigurationModel
+  return new ConfigurationModel(baseContents, baseKeys, iOverrides);
+}
+/**
+ * Extract configuration and return both the extracted data and ConfigurationModel
+ *
+ * @param settings - Configuration object with bracket-notation overrides
+ * @returns Both extracted configuration and ConfigurationModel
+ *
+ * @example
+ * ```typescript
+ * const settings = {
+ *   theme: "light",
+ *   "[desktop]": { theme: "dark" }
+ * };
+ *
+ * const { extracted, model } = extractConfigurationWithModel(settings);
+ * // extracted: { baseContents, baseKeys, overrides }
+ * // model: ConfigurationModel instance
+ * ```
+ */
+function extractConfigurationWithModel(settings) {
+  const extracted = extractConfiguration(settings);
+  const iOverrides = extracted.overrides.map(override => ({
+    identifiers: override.identifiers,
+    keys: override.keys,
+    contents: override.contents
+  }));
+  const model = new ConfigurationModel(extracted.baseContents, extracted.baseKeys, iOverrides);
+  return {
+    extracted,
+    model
+  };
+}export{createConfigurationModel,extractConfiguration,extractConfigurationWithModel,extractIdentifiersFromKey,getBaseKeys,getOverrideByIdentifier,getOverrideKeys,hasOverrides,isBracketKey,removeOverrideKeys};//# sourceMappingURL=configurationExtractor.js.map

package/lib/core/configurations/utils/configurationExtractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configurationExtractor.js","sources":["../../../../src/core/configurations/utils/configurationExtractor.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/lib/core/configurations/utils/configurationExtractor.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/core/configurations/utils/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Configuration utilities index
+ * Exports all utility functions for working with configuration data
+ */
+export { ConfigurationOverride, ExtractedConfiguration, extractConfiguration, isBracketKey, extractIdentifiersFromKey, getOverrideKeys, getBaseKeys, removeOverrideKeys, hasOverrides, getOverrideByIdentifier, createConfigurationModel, extractConfigurationWithModel, } from './configurationExtractor';

package/lib/core/configurations/utils/model-creation-examples.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Usage Examples: ConfigurationModel Creation Functions
+ *
+ * Demonstrates how to use createConfigurationModel() and extractConfigurationWithModel()
+ * to work with ConfigurationModel from raw settings data.
+ */
+/**
+ * The simplest way to create a ConfigurationModel from settings.
+ * Use this when you just need a model and don't care about raw extraction data.
+ */
+declare function example1_quickModelCreation(): void;
+/**
+ * Convert server configuration response to ConfigurationModel
+ * for client-side configuration management.
+ */
+declare function example2_serverResponseProcessing(): Promise<void>;
+/**
+ * Use extractConfigurationWithModel when you need both:
+ * - Raw extraction data (for inspection, logging, debugging)
+ * - ConfigurationModel (for application logic)
+ */
+declare function example3_dualPurpose(): void;
+/**
+ * Validate configuration structure and apply business logic.
+ */
+declare function example4_configurationValidation(): void;
+/**
+ * Merge multiple configuration sources using ConfigurationModel.
+ */
+declare function example5_configurationMerging(): void;
+/**
+ * Handle dynamic route-based configuration in a web application.
+ */
+declare function example6_dynamicRouteConfiguration(): void;
+declare function example7_typeSafeConfiguration(): void;
+export { example1_quickModelCreation, example2_serverResponseProcessing, example3_dualPurpose, example4_configurationValidation, example5_configurationMerging, example6_dynamicRouteConfiguration, example7_typeSafeConfiguration, };

package/lib/core/configurations/utils/preferences-service-integration.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Integration Example: In your preferences-service.ts
+ */
+export declare function getPageSettings(_configKey: string, _overrideIdentifier: string, _strict: boolean): Promise<any>;
+/**
+ * Benefits of using the utility:
+ *
+ * 1. ✅ Reuses existing OVERRIDE_PROPERTY_REGEX (consistent with parser)
+ * 2. ✅ Reuses existing overrideIdentifiersFromKey (handles compound keys properly)
+ * 3. ✅ One line instead of ~20 lines of inline logic
+ * 4. ✅ Tested and documented
+ * 5. ✅ Can be reused across your codebase
+ * 6. ✅ Properly handles edge cases (null, empty, compound identifiers)
+ * 7. ✅ TypeScript typed
+ * 8. ✅ Maintains same output structure
+ */
+/**
+ * Your original commented code vs utility:
+ */
+export declare function comparison(): void;
+/**
+ * Complete integration example for preferences-service.ts
+ */
+export declare class PreferencesServiceExample {
+    getPageSettings(targets: string[], configKey?: string, overrideIdentifier?: string, strict?: boolean): Promise<{
+        contents: any;
+        keys: string[];
+        overrides: {
+            identifiers: string[];
+            contents: any;
+        }[];
+    }>;
+}
+/**
+ * Quick reference for your use case:
+ *
+ * REPLACE THIS:
+ * -------------
+ * const baseContents: any = {};
+ * const overrides: any[] = [];
+ * Object.keys(cleanedSettings).forEach((key) => {
+ *   if (key.startsWith('[') && key.endsWith(']')) {
+ *     const overrideData = cleanedSettings[key];
+ *     overrides.push({ identifiers: [key], contents: overrideData, keys: Object.keys(overrideData) });
+ *   } else {
+ *     baseContents[key] = cleanedSettings[key];
+ *   }
+ * });
+ *
+ * WITH THIS:
+ * ----------
+ * import { extractConfiguration } from '@adminide/core/configurations/utils';
+ * const { baseContents, overrides } = extractConfiguration(cleanedSettings);
+ */

package/lib/core/configurations/utils/usage-examples.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Example 1: Basic Extraction
+ * Extract base configuration and overrides
+ */
+export declare function example1_BasicExtraction(): void;
+/**
+ * Example 2: Working with Base Configuration
+ * Get and manipulate base configuration
+ */
+export declare function example2_BaseConfiguration(): void;
+/**
+ * Example 3: Route-Specific Configuration
+ * Get configuration for a specific route
+ */
+export declare function example3_RouteConfiguration(): void;
+/**
+ * Example 4: Checking and Filtering
+ * Various utility functions
+ */
+export declare function example4_CheckingFiltering(): void;
+/**
+ * Example 5: Parsing Identifiers
+ * Extract identifiers from bracket keys
+ */
+export declare function example5_ParsingIdentifiers(): void;
+/**
+ * Example 6: Lazy Loading Pattern
+ * Load configuration once, apply overrides as needed
+ */
+export declare function example6_LazyLoadingPattern(): void;
+/**
+ * Example 7: Configuration Merging
+ * Merge multiple configuration sources
+ */
+export declare function example7_ConfigurationMerging(): void;
+/**
+ * Run all examples
+ */
+export declare function runAllExamples(): void;