ConfigurationProperty class abstract

A base class for defining structured and strongly typed configuration classes in the JetLeaf framework.

This replaces the need for @ConfigurationProperties annotations by requiring subclasses to override the properties method. This method returns a ConfigurationProperties instance, which contains metadata like the profile (e.g. "dev", "prod") and source file name.

The JetLeaf framework uses this base class to automatically discover, validate, and inject environment-specific configurations at runtime.

🛠️ How to Use

1. Create a class that extends ConfigurationProperty
2. Implement the properties method, returning the profile and metadata

class DevConfig extends ConfigurationProperty {
  final int port = 3000;
  final bool debug = true;

  @override
  ConfigurationProperties properties() => ConfigurationProperties({
    JetProperty.SERVER_PORT.copyWith(value: port),
    JetProperty.DEBUG.copyWith(value: debug),
  });
}

📦 Default Profile Example

If your configuration is from application.dart, use the default profile:

class AppConfig extends ConfigurationProperty {
  final int port = 8080;
  final bool secure = false;

  @override
  ConfigurationProperties properties() => ConfigurationProperties.empty(); // default
}

🔍 What This Enables

• 🧭 Automatic profile resolution (e.g., application_dev.dart → dev)
• 🧪 Type-safe property validation via JetProperty
• 🧰 Code generation or runtime scanning for all configuration providers
• ✅ No need for custom annotations or reflection

🧱 Why You Must Extend ConfigurationProperty

• Allows Jet to discover configuration classes at runtime
• Enables profile-specific overrides and conditional loading
• Encourages typed, expressive configuration definitions

🔁 Switching Configurations by Profile

Jet uses the profile field from ConfigurationProperties to decide which config to apply. For example:

ConfigurationProperties({JetProperty.PROFILE.copyWith(value: 'dev')})

will be used when application_dev.dart is the active environment.

✅ Summary

See also: ConfigurationProperties