weseek__growi/packages/core/src/interfaces/config-manager.ts

/**
 * Available configuration sources
 */
export const ConfigSource = {
  env: 'env',
  db: 'db',
} as const;
export type ConfigSource = (typeof ConfigSource)[keyof typeof ConfigSource];

/**
 * Metadata for a configuration value
 */
export interface ConfigDefinition<T> {
  defaultValue: T;
  envVarName?: string;
  isSecret?: boolean;
}

/**
 * Helper function for defining configurations with type safety
 */
export const defineConfig = <T>(
  config: ConfigDefinition<T>,
): ConfigDefinition<T> => config;

/**
 * Interface for loading configuration values
 */
// biome-ignore lint/suspicious/noExplicitAny: ignore
export interface IConfigLoader<K extends string, V extends Record<K, any>> {
  /**
   * Load configurations from environment variables
   */
  loadFromEnv(): Promise<RawConfigData<K, V>>;

  /**
   * Load configurations from database
   */
  loadFromDB(): Promise<RawConfigData<K, V>>;
}

// biome-ignore lint/suspicious/noExplicitAny: ignore
export type RawConfigData<K extends string, V extends Record<K, any>> = Record<
  K,
  {
    value: V[K];
    definition?: ConfigDefinition<V[K]>;
  }
>;

export type UpdateConfigOptions = {
  skipPubsub?: boolean;
  removeIfUndefined?: boolean;
};

/**
 * Interface for managing configuration values
 */
// biome-ignore lint/suspicious/noExplicitAny: ignore
export interface IConfigManager<K extends string, V extends Record<K, any>> {
  /**
   * Load configurations
   * @param options.source - Specify which source to load from
   */
  loadConfigs(options?: { source?: ConfigSource }): Promise<void>;

  /**
   * Get a configuration value
   */
  getConfig<T extends K>(key: T, source?: ConfigSource): V[T];

  /**
   * Update a configuration value
   */
  updateConfig<T extends K>(
    key: T,
    value: V[T],
    options?: UpdateConfigOptions,
  ): Promise<void>;

  /**
   * Update multiple configuration values
   */
  updateConfigs(
    updates: Partial<{ [T in K]: V[T] }>,
    options?: UpdateConfigOptions,
  ): Promise<void>;

  /**
   * Remove multiple configuration values
   */
  removeConfigs(keys: K[], options?: UpdateConfigOptions): Promise<void>;

  /**
   * Get environment variables managed with ConfigDefinitions
   */
  getManagedEnvVars(showSecretValues: boolean): Record<string, string>;
}