@adminide-stack/core 12.0.4-alpha.92 → 13.0.1-alpha.0

package/lib/core/configurations/parser/configurationParser.js.map

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

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

@@ -0,0 +1 @@
+export * from './configurationParser';

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

@@ -0,0 +1,103 @@
+/**
+ * QUICK REFERENCE: Configuration Extractor Utilities
+ * ==================================================
+ *
+ * Import:
+ * import { extractConfiguration, ... } from '@adminide/core/configurations/utils';
+ *
+ * REUSES EXISTING CODE:
+ * - OVERRIDE_PROPERTY_REGEX from configuration.ts
+ * - overrideIdentifiersFromKey from configuration.ts
+ *
+ * ==================================================
+ * MAIN FUNCTION
+ * ==================================================
+ *
+ * extractConfiguration(settings)
+ * Returns: { baseContents, baseKeys, overrides }
+ *
+ * Example:
+ * const { baseContents, baseKeys, overrides } = extractConfiguration({
+ *   theme: "light",
+ *   "[desktop]": { theme: "dark" }
+ * });
+ *
+ * ==================================================
+ * HELPER FUNCTIONS
+ * ==================================================
+ *
+ * isBracketKey(key: string): boolean
+ *   Check if key is bracket notation: [desktop], [/route]
+ *
+ * extractIdentifiersFromKey(key: string): string[]
+ *   Parse identifiers from key: "[/route][desktop]" => ["/route", "desktop"]
+ *
+ * getOverrideKeys(settings): string[]
+ *   Get all bracket keys: ["[desktop]", "[mobile]"]
+ *
+ * getBaseKeys(settings): string[]
+ *   Get all non-bracket keys: ["theme", "color"]
+ *
+ * removeOverrideKeys(settings): object
+ *   Return new object without bracket keys
+ *
+ * hasOverrides(settings): boolean
+ *   Check if settings has any overrides
+ *
+ * getOverrideByIdentifier(settings, identifier): contents | undefined
+ *   Get specific override: getOverrideByIdentifier(settings, "desktop")
+ *
+ * ==================================================
+ * COMMON PATTERNS
+ * ==================================================
+ *
+ * 1. EXTRACT AND SEPARATE
+ * ------------------------
+ * const { baseContents, overrides } = extractConfiguration(settings);
+ *
+ * 2. GET ROUTE CONFIG
+ * -------------------
+ * const override = overrides.find(o => o.identifiers.includes(route));
+ * const config = override ? { ...baseContents, ...override.contents } : baseContents;
+ *
+ * 3. CLEAN CONFIG
+ * ---------------
+ * const cleanConfig = removeOverrideKeys(settings);
+ *
+ * 4. CHECK FOR OVERRIDES
+ * ----------------------
+ * if (hasOverrides(settings)) { ... }
+ *
+ * 5. GET SPECIFIC OVERRIDE
+ * ------------------------
+ * const desktopConfig = getOverrideByIdentifier(settings, "desktop");
+ *
+ * ==================================================
+ * TYPES
+ * ==================================================
+ *
+ * interface ExtractedConfiguration {
+ *   baseContents: any;
+ *   baseKeys: string[];
+ *   overrides: ConfigurationOverride[];
+ * }
+ *
+ * interface ConfigurationOverride {
+ *   identifiers: string[];  // e.g., ["/o/:orgName/vault"]
+ *   contents: any;          // Override data
+ *   keys: string[];         // Keys in override
+ * }
+ *
+ * ==================================================
+ * WHEN TO USE
+ * ==================================================
+ *
+ * ✅ Parsing server responses
+ * ✅ Client-side route handling
+ * ✅ Data transformation
+ * ✅ Testing configuration structure
+ * ✅ API response formatting
+ *
+ * ==================================================
+ */
+export {};

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';