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

package/lib/core/configurations/models/ConfigurationModelWrapper.d.ts

@@ -0,0 +1,47 @@
+import { ConfigurationModel } from './ConfigurationModel';
+/**
+ * Enhanced configuration model that includes compound override information
+ */
+export declare class EnhancedConfigurationModel {
+    private baseModel;
+    private identifier;
+    private options?;
+    private overrideModel;
+    private compoundOverrides;
+    constructor(baseModel: ConfigurationModel, identifier: string, options?: {
+        strict?: boolean;
+    });
+    /**
+     * Extract compound overrides that include the current identifier
+     * Returns them without the current identifier in the key
+     */
+    private extractCompoundOverrides;
+    /**
+     * Get value with compound overrides included in the result
+     * @param section Configuration section to retrieve
+     * @returns Value merged with base + identifier, and compound overrides as additional keys
+     */
+    getValue<T>(section?: string): T;
+    /**
+     * Filter out bracket-notation keys from an object
+     */
+    private filterBracketKeys;
+    /**
+     * Get all available compound override keys (without the current identifier)
+     */
+    getCompoundOverrideKeys(): string[];
+    /**
+     * Get a specific compound override value
+     * @param compoundKey The compound key (e.g., '[/o/:orgName/vault]')
+     * @param section Optional section to retrieve
+     */
+    getCompoundOverride<T>(compoundKey: string, section?: string): T | undefined;
+    /**
+     * Helper to extract value from contents by section path
+     */
+    private getValueFromContents;
+    /**
+     * Get the underlying override model
+     */
+    getOverrideModel(): ConfigurationModel;
+}

package/lib/core/configurations/models/ConfigurationModelWrapper.js

@@ -0,0 +1,130 @@
+/**
+ * Enhanced configuration model that includes compound override information
+ */
+class EnhancedConfigurationModel {
+  baseModel;
+  identifier;
+  options;
+  overrideModel;
+  compoundOverrides;
+  constructor(baseModel, identifier, options) {
+    this.baseModel = baseModel;
+    this.identifier = identifier;
+    this.options = options;
+    // Get the override model (base + identifier override)
+    this.overrideModel = baseModel.override(identifier, options);
+    // Find all compound overrides containing this identifier
+    this.compoundOverrides = this.extractCompoundOverrides();
+  }
+  /**
+   * Extract compound overrides that include the current identifier
+   * Returns them without the current identifier in the key
+   */
+  extractCompoundOverrides() {
+    const compounds = new Map();
+    for (const override of this.baseModel.overrides) {
+      // Skip if no identifiers or not a compound override
+      if (!override.identifiers || override.identifiers.length <= 1) {
+        // eslint-disable-next-line no-continue
+        continue;
+      }
+      // Check if this compound override includes our identifier
+      if (override.identifiers.includes(this.identifier)) {
+        // Extract the other identifiers (not the current one)
+        const otherIdentifiers = override.identifiers.filter(id => id !== this.identifier);
+        // Create a key without the current identifier
+        const key = otherIdentifiers.map(id => `[${id}]`).join('');
+        compounds.set(key, override.contents);
+      }
+    }
+    return compounds;
+  }
+  /**
+   * Get value with compound overrides included in the result
+   * @param section Configuration section to retrieve
+   * @returns Value merged with base + identifier, and compound overrides as additional keys
+   */
+  getValue(section) {
+    // Get the merged value (base + identifier override)
+    const mergedValue = section ? this.overrideModel.getValue(section) : this.overrideModel.contents;
+    // If no compound overrides, return as-is (but filter out bracket keys if no section)
+    if (this.compoundOverrides.size === 0) {
+      if (!section) {
+        // Filter out any bracket-notation keys from the result
+        return this.filterBracketKeys(mergedValue);
+      }
+      return mergedValue;
+    }
+    // Create result object with merged value and compound overrides
+    // When no section is specified, filter out bracket keys from base contents
+    const baseResult = section ? mergedValue : this.filterBracketKeys(mergedValue);
+    const result = {
+      ...(baseResult || {})
+    };
+    // Add compound overrides as separate keys
+    for (const [key, contents] of this.compoundOverrides.entries()) {
+      // Extract the value for the specific section if provided
+      // Note: contents already has the section wrapped, so we need to unwrap it
+      const compoundValue = section ? this.getValueFromContents(contents, section) : contents;
+      if (compoundValue !== undefined) {
+        result[key] = compoundValue;
+      }
+    }
+    return result;
+  }
+  /**
+   * Filter out bracket-notation keys from an object
+   */
+  filterBracketKeys(obj) {
+    if (!obj || typeof obj !== 'object') {
+      return obj;
+    }
+    const filtered = {};
+    for (const key of Object.keys(obj)) {
+      // Skip keys that start with '[' (bracket notation)
+      if (!key.startsWith('[')) {
+        filtered[key] = obj[key];
+      }
+    }
+    return filtered;
+  }
+  /**
+   * Get all available compound override keys (without the current identifier)
+   */
+  getCompoundOverrideKeys() {
+    return Array.from(this.compoundOverrides.keys());
+  }
+  /**
+   * Get a specific compound override value
+   * @param compoundKey The compound key (e.g., '[/o/:orgName/vault]')
+   * @param section Optional section to retrieve
+   */
+  getCompoundOverride(compoundKey, section) {
+    const contents = this.compoundOverrides.get(compoundKey);
+    if (!contents) {
+      return undefined;
+    }
+    return section ? this.getValueFromContents(contents, section) : contents;
+  }
+  /**
+   * Helper to extract value from contents by section path
+   */
+  getValueFromContents(contents, section) {
+    const parts = section.split('.');
+    let value = contents;
+    for (const part of parts) {
+      if (value && typeof value === 'object' && part in value) {
+        value = value[part];
+      } else {
+        return undefined;
+      }
+    }
+    return value;
+  }
+  /**
+   * Get the underlying override model
+   */
+  getOverrideModel() {
+    return this.overrideModel;
+  }
+}export{EnhancedConfigurationModel};//# sourceMappingURL=ConfigurationModelWrapper.js.map

package/lib/core/configurations/models/ConfigurationModelWrapper.js.map

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

package/lib/core/configurations/models/ConfigurationModelWrapper.spec.d.ts

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

package/lib/core/configurations/models/ConfigurationModelWrapper.test.d.ts

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

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

@@ -1 +1,2 @@
 export * from './ConfigurationModel';
+export * from './ConfigurationModelWrapper';

package/lib/core/configurations/models/override.compound.test.d.ts

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

package/lib/core/configurations/models/override.edgecase.test.d.ts

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

package/lib/core/configurations/models/override.keys.test.d.ts

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

package/lib/core/configurations/models/override.strict.test.d.ts

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

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

@@ -0,0 +1,23 @@
+import { ConfigurationScope } from 'common/server';
+import { IConfigurationPropertySchema } from '../../../interfaces/configuration';
+import { ConfigurationModel } from '../models';
+export interface ConfigurationParseOptions {
+    scopes?: ConfigurationScope[];
+    skipRestricted?: boolean;
+}
+/**
+ * Parses the given JSON content into a ConfigurationModel, fetching property schemas
+ * from the provided registry based on "options.context" for multi-tenant use.
+ *
+ * 1. Converts JSON -> raw object (with error tracking).
+ * 2. Fetches tenant-specific configuration properties from the registry.
+ * 3. Filters raw object by scopes, restricted properties, or override sections.
+ * 4. Returns a { model, restricted, errors } object in a stateless manner.
+ */
+export declare function parseConfiguration(content: string | undefined | null, configurationProperties: {
+    [qualifiedKey: string]: IConfigurationPropertySchema | undefined;
+}, name: string, options: ConfigurationParseOptions): Promise<{
+    model: ConfigurationModel;
+    restricted: string[];
+    errors: any[];
+}>;

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

@@ -0,0 +1,209 @@
+import*as json from'@vscode-alt/monaco-editor/esm/vs/base/common/json.js';import {ConfigurationModel}from'../models/ConfigurationModel.js';import {toValuesTree}from'../helpers/configuration.js';import {OVERRIDE_PROPERTY_REGEX,overrideIdentifiersFromKey}from'../configuration.js';/* eslint-disable @typescript-eslint/no-explicit-any */
+/**
+ * Parses the given JSON content into a ConfigurationModel, fetching property schemas
+ * from the provided registry based on "options.context" for multi-tenant use.
+ *
+ * 1. Converts JSON -> raw object (with error tracking).
+ * 2. Fetches tenant-specific configuration properties from the registry.
+ * 3. Filters raw object by scopes, restricted properties, or override sections.
+ * 4. Returns a { model, restricted, errors } object in a stateless manner.
+ */
+async function parseConfiguration(content, configurationProperties, name, options) {
+  if (!content) {
+    // No content to parse -> return empty model
+    return {
+      model: new ConfigurationModel(),
+      restricted: [],
+      errors: []
+    };
+  }
+  // 1) Convert JSON -> raw object
+  const {
+    raw,
+    parseErrors
+  } = doParseContent(content, name);
+  // 2) Build full model from raw
+  const {
+    model,
+    restricted
+  } = await doParseRaw(raw, configurationProperties, name, options);
+  return {
+    model,
+    restricted: restricted || [],
+    errors: parseErrors
+  };
+}
+/**
+ * JSON -> Raw object, tracking parse errors. No class-level storage.
+ */
+function doParseContent(content, name) {
+  let raw = {};
+  const parseErrors = [];
+  let currentProperty = null;
+  let currentParent = [];
+  const previousParents = [];
+  function onValue(value) {
+    if (Array.isArray(currentParent)) {
+      currentParent.push(value);
+    } else if (currentProperty !== null) {
+      currentParent[currentProperty] = value;
+    }
+  }
+  const visitor = {
+    onObjectBegin: () => {
+      const object = {};
+      onValue(object);
+      previousParents.push(currentParent);
+      currentParent = object;
+      currentProperty = null;
+    },
+    onObjectProperty: name => {
+      currentProperty = name;
+    },
+    onObjectEnd: () => {
+      currentParent = previousParents.pop();
+    },
+    onArrayBegin: () => {
+      const array = [];
+      onValue(array);
+      previousParents.push(currentParent);
+      currentParent = array;
+      currentProperty = null;
+    },
+    onArrayEnd: () => {
+      currentParent = previousParents.pop();
+    },
+    onLiteralValue: onValue,
+    onError: (error, offset, length) => {
+      parseErrors.push({
+        error,
+        offset,
+        length
+      });
+    }
+  };
+  if (content) {
+    try {
+      json.visit(content, visitor);
+      // If valid array in top-level JSON, it might end up as currentParent[0],
+      // else we interpret root as an object.
+      raw = currentParent[0] || {};
+    } catch (e) {
+      console.error(`Error while parsing file ${name}: ${e}`);
+      parseErrors.push(e);
+    }
+  }
+  return {
+    raw,
+    parseErrors
+  };
+}
+/**
+ * Given the raw JSON object and registry, filter and convert into a ConfigurationModel.
+ */
+async function doParseRaw(raw, configurationProperties, name, options) {
+  // 1) Fetch tenant-specific properties from registry
+  // 2) Filter raw object
+  const filtered = filterRaw(raw, configurationProperties, true, options);
+  const finalRaw = filtered.raw;
+  // 3) Build the final model
+  // Check if any keys are override identifiers - if so, handle them specially
+  const hasOverrideIdentifiers = Object.keys(finalRaw).some(key => OVERRIDE_PROPERTY_REGEX.test(key));
+  let contents;
+  if (hasOverrideIdentifiers) {
+    // For override identifiers, we need to convert the override sections to nested objects
+    // but keep the override identifier keys as-is (not dot-split)
+    contents = {};
+    for (const key of Object.keys(finalRaw)) {
+      if (OVERRIDE_PROPERTY_REGEX.test(key)) {
+        // This is an override identifier - convert its contents to nested object
+        contents[key] = toValuesTree(finalRaw[key], message => console.error(`Conflict in settings file ${name}: ${message}`));
+      } else {
+        // Regular key - add directly (will be converted by toValuesTree at the end)
+        contents[key] = finalRaw[key];
+      }
+    }
+    // Now convert the non-override keys
+    const nonOverrideContents = {};
+    for (const key of Object.keys(contents)) {
+      if (!OVERRIDE_PROPERTY_REGEX.test(key)) {
+        nonOverrideContents[key] = contents[key];
+        delete contents[key];
+      }
+    }
+    const convertedNonOverride = toValuesTree(nonOverrideContents, message => console.error(`Conflict in settings file ${name}: ${message}`));
+    // Merge back
+    contents = {
+      ...convertedNonOverride,
+      ...contents
+    };
+  } else {
+    contents = toValuesTree(finalRaw, message => console.error(`Conflict in settings file ${name}: ${message}`));
+  }
+  const keys = Object.keys(finalRaw);
+  const overrides = toOverrides(finalRaw, message => console.error(`Conflict in settings file ${name}: ${message}`));
+  return {
+    model: new ConfigurationModel(contents, keys, overrides),
+    restricted: filtered.restricted
+  };
+}
+/**
+ * Synchronously filters out properties not matching scopes,
+ * or restricted properties (if skipRestricted is set).
+ */
+function filterRaw(properties, configurationProperties, filterOverriddenProperties, options) {
+  let hasExcludedProperties = false;
+  const raw = {};
+  const restricted = [];
+  // if (!options.scopes && !options.skipRestricted) {
+  //     // No filtering needed
+  //     return { raw: properties, restricted, hasExcludedProperties };
+  // }
+  for (const key in properties) {
+    if (OVERRIDE_PROPERTY_REGEX.test(key) && filterOverriddenProperties) {
+      const overrideResult = filterRaw(properties[key], configurationProperties, false, options);
+      raw[key] = overrideResult.raw;
+      hasExcludedProperties = hasExcludedProperties || overrideResult.hasExcludedProperties;
+      restricted.push(...overrideResult.restricted);
+    } else {
+      const propertySchema = configurationProperties[key];
+      const scope = propertySchema?.scope ?? 3 /* ConfigurationScope.WINDOW */;
+      if (propertySchema?.restricted) {
+        restricted.push(key);
+      }
+      // Debug scope filtering logic
+      const scopeIncluded = !options.scopes || Array.isArray(options.scopes) && (Array.isArray(scope) ? scope.some(s => options.scopes.includes(s)) : options.scopes.includes(scope));
+      // Check scope and skipRestricted
+      if (scopeIncluded && !(options.skipRestricted && propertySchema?.restricted)) {
+        raw[key] = properties[key];
+      } else {
+        hasExcludedProperties = true;
+      }
+    }
+  }
+  return {
+    raw,
+    restricted,
+    hasExcludedProperties
+  };
+}
+/**
+ * Builds override sections (e.g. "[mySetting]": { ... }) into IOverrides[].
+ */
+function toOverrides(raw, conflictReporter) {
+  const overrides = [];
+  for (const key of Object.keys(raw)) {
+    if (OVERRIDE_PROPERTY_REGEX.test(key)) {
+      const overrideRaw = {};
+      for (const keyInOverrideRaw in raw[key]) {
+        overrideRaw[keyInOverrideRaw] = raw[key][keyInOverrideRaw];
+      }
+      overrides.push({
+        identifiers: overrideIdentifiersFromKey(key),
+        keys: Object.keys(overrideRaw),
+        contents: toValuesTree(overrideRaw, conflictReporter)
+      });
+    }
+  }
+  return overrides;
+}export{parseConfiguration};//# sourceMappingURL=configurationParser.js.map

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 {};