@breadstone/archipel-platform-feature-flags 0.0.32

package/src/azure/AzureFeatureFlagWriter.js

@@ -0,0 +1,231 @@
+"use strict";
+// #region Imports
+var AzureFeatureFlagWriter_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AzureFeatureFlagWriter = void 0;
+const tslib_1 = require("tslib");
+const app_configuration_1 = require("@azure/app-configuration");
+const identity_1 = require("@azure/identity");
+const archipel_platform_configuration_1 = require("@breadstone/archipel-platform-configuration");
+const common_1 = require("@nestjs/common");
+const FeatureFlagWriterPort_1 = require("../contracts/FeatureFlagWriterPort");
+const FeatureFlagError_1 = require("../errors/FeatureFlagError");
+const env_1 = require("./env");
+// #endregion
+/**
+ * Azure App Configuration implementation of the {@link FeatureFlagWriterPort}.
+ * Uses `@azure/app-configuration` (`AppConfigurationClient`) for CRUD operations
+ * on feature flags stored in Azure App Configuration.
+ *
+ * @public
+ */
+let AzureFeatureFlagWriter = AzureFeatureFlagWriter_1 = class AzureFeatureFlagWriter extends FeatureFlagWriterPort_1.FeatureFlagWriterPort {
+    // #endregion
+    // #region Ctor
+    constructor(configService) {
+        super();
+        this._logger = new common_1.Logger(AzureFeatureFlagWriter_1.name);
+        this._configService = configService;
+    }
+    // #endregion
+    // #region Methods
+    /**
+     * Initializes the Azure App Configuration management client.
+     *
+     * @public
+     */
+    async onModuleInit() {
+        try {
+            const endpoint = this._configService.get(env_1.AZURE_APPCONFIG_ENDPOINT.key);
+            const connectionString = this._configService.get(env_1.AZURE_APPCONFIG_CONNECTION_STRING.key);
+            if (!endpoint && !connectionString) {
+                throw new FeatureFlagError_1.FeatureFlagError('azure', 'Either AZURE_APPCONFIG_ENDPOINT or AZURE_APPCONFIG_CONNECTION_STRING must be configured.');
+            }
+            if (endpoint) {
+                this._client = new app_configuration_1.AppConfigurationClient(endpoint, new identity_1.DefaultAzureCredential());
+            }
+            else {
+                this._client = new app_configuration_1.AppConfigurationClient(connectionString);
+            }
+            this._logger.log('[AzureFeatureFlagWriter] Initialized successfully');
+        }
+        catch (error) {
+            if (error instanceof FeatureFlagError_1.FeatureFlagError) {
+                throw error;
+            }
+            throw new FeatureFlagError_1.FeatureFlagError('azure', 'Failed to initialize Azure App Configuration admin client', error);
+        }
+    }
+    /** @inheritdoc */
+    async getFlag(key) {
+        this.ensureInitialized();
+        try {
+            const setting = await this._client.getConfigurationSetting({
+                key: `${app_configuration_1.featureFlagPrefix}${key}`,
+            });
+            if (!(0, app_configuration_1.isFeatureFlag)(setting)) {
+                return undefined;
+            }
+            const parsed = (0, app_configuration_1.parseFeatureFlag)(setting);
+            return {
+                key,
+                enabled: parsed.value.enabled,
+                description: parsed.value.description,
+                label: parsed.label,
+            };
+        }
+        catch (error) {
+            if (this.isNotFoundError(error)) {
+                return undefined;
+            }
+            this._logger.error(`[AzureFeatureFlagWriter] getFlag failed for "${key}"`, {
+                key,
+                error: error.message,
+            });
+            throw new FeatureFlagError_1.FeatureFlagError('azure', `Failed to get feature flag "${key}"`, error);
+        }
+    }
+    /** @inheritdoc */
+    async listFlags() {
+        this.ensureInitialized();
+        try {
+            const flags = [];
+            const settings = this._client.listConfigurationSettings({
+                keyFilter: `${app_configuration_1.featureFlagPrefix}*`,
+            });
+            for await (const setting of settings) {
+                if (!(0, app_configuration_1.isFeatureFlag)(setting)) {
+                    continue;
+                }
+                const parsed = (0, app_configuration_1.parseFeatureFlag)(setting);
+                const key = setting.key.replace(app_configuration_1.featureFlagPrefix, '');
+                flags.push({
+                    key,
+                    enabled: parsed.value.enabled,
+                    description: parsed.value.description,
+                    label: parsed.label,
+                });
+            }
+            return flags;
+        }
+        catch (error) {
+            this._logger.error('[AzureFeatureFlagWriter] listFlags failed', {
+                error: error.message,
+            });
+            throw new FeatureFlagError_1.FeatureFlagError('azure', 'Failed to list feature flags', error);
+        }
+    }
+    /** @inheritdoc */
+    async createFlag(definition) {
+        this.ensureInitialized();
+        try {
+            await this._client.addConfigurationSetting({
+                key: `${app_configuration_1.featureFlagPrefix}${definition.key}`,
+                contentType: app_configuration_1.featureFlagContentType,
+                label: definition.label,
+                value: JSON.stringify({
+                    id: definition.key,
+                    enabled: definition.enabled,
+                    description: definition.description ?? '',
+                    conditions: { client_filters: [] },
+                }),
+            });
+            this._logger.log(`[AzureFeatureFlagWriter] Created flag "${definition.key}"`);
+        }
+        catch (error) {
+            this._logger.error(`[AzureFeatureFlagWriter] createFlag failed for "${definition.key}"`, {
+                key: definition.key,
+                error: error.message,
+            });
+            throw new FeatureFlagError_1.FeatureFlagError('azure', `Failed to create feature flag "${definition.key}"`, error);
+        }
+    }
+    /** @inheritdoc */
+    async updateFlag(key, updates) {
+        this.ensureInitialized();
+        try {
+            const settingKey = `${app_configuration_1.featureFlagPrefix}${key}`;
+            const existing = await this._client.getConfigurationSetting({ key: settingKey });
+            if (!(0, app_configuration_1.isFeatureFlag)(existing)) {
+                throw new FeatureFlagError_1.FeatureFlagError('azure', `Configuration setting "${key}" is not a feature flag.`);
+            }
+            const parsed = (0, app_configuration_1.parseFeatureFlag)(existing);
+            const updatedValue = {
+                id: key,
+                enabled: updates.enabled ?? parsed.value.enabled,
+                description: updates.description ?? parsed.value.description ?? '',
+                conditions: parsed.value.conditions ?? { client_filters: [] },
+            };
+            await this._client.setConfigurationSetting({
+                key: settingKey,
+                contentType: app_configuration_1.featureFlagContentType,
+                label: updates.label ?? existing.label,
+                value: JSON.stringify(updatedValue),
+            });
+            this._logger.log(`[AzureFeatureFlagWriter] Updated flag "${key}"`);
+        }
+        catch (error) {
+            if (error instanceof FeatureFlagError_1.FeatureFlagError) {
+                throw error;
+            }
+            this._logger.error(`[AzureFeatureFlagWriter] updateFlag failed for "${key}"`, {
+                key,
+                error: error.message,
+            });
+            throw new FeatureFlagError_1.FeatureFlagError('azure', `Failed to update feature flag "${key}"`, error);
+        }
+    }
+    /** @inheritdoc */
+    async deleteFlag(key) {
+        this.ensureInitialized();
+        try {
+            await this._client.deleteConfigurationSetting({
+                key: `${app_configuration_1.featureFlagPrefix}${key}`,
+            });
+            this._logger.log(`[AzureFeatureFlagWriter] Deleted flag "${key}"`);
+        }
+        catch (error) {
+            this._logger.error(`[AzureFeatureFlagWriter] deleteFlag failed for "${key}"`, {
+                key,
+                error: error.message,
+            });
+            throw new FeatureFlagError_1.FeatureFlagError('azure', `Failed to delete feature flag "${key}"`, error);
+        }
+    }
+    /** @inheritdoc */
+    async ping() {
+        try {
+            this.ensureInitialized();
+            const iterator = this._client.listConfigurationSettings({ keyFilter: `${app_configuration_1.featureFlagPrefix}*` });
+            // Perform a minimal read to verify connectivity.
+            await iterator.next();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Checks whether the error is a 404 (resource not found).
+     */
+    isNotFoundError(error) {
+        return (typeof error === 'object' &&
+            error !== null &&
+            'statusCode' in error &&
+            error.statusCode === 404);
+    }
+    /**
+     * Ensures the management client has been initialized.
+     */
+    ensureInitialized() {
+        if (!this._client) {
+            throw new FeatureFlagError_1.FeatureFlagError('azure', 'AzureFeatureFlagWriter has not been initialized. Ensure onModuleInit() ran.');
+        }
+    }
+};
+exports.AzureFeatureFlagWriter = AzureFeatureFlagWriter;
+exports.AzureFeatureFlagWriter = AzureFeatureFlagWriter = AzureFeatureFlagWriter_1 = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__metadata("design:paramtypes", [archipel_platform_configuration_1.ConfigService])
+], AzureFeatureFlagWriter);
+//# sourceMappingURL=AzureFeatureFlagWriter.js.map

package/src/azure/env.d.ts

@@ -0,0 +1,11 @@
+import { type IConfigRegistryEntry } from '@breadstone/archipel-platform-configuration';
+/** Azure App Configuration endpoint URL. Required when using Entra ID authentication. */
+export declare const AZURE_APPCONFIG_ENDPOINT: import("@breadstone/archipel-platform-configuration").IConfigKey<string>;
+/** Azure App Configuration connection string. Alternative to endpoint + Entra ID. */
+export declare const AZURE_APPCONFIG_CONNECTION_STRING: import("@breadstone/archipel-platform-configuration").IConfigKey<string>;
+/** Refresh interval in milliseconds for feature flag state. Defaults to 30000. */
+export declare const AZURE_FEATURE_FLAG_REFRESH_INTERVAL: import("@breadstone/archipel-platform-configuration").IConfigKey<number>;
+/** Key filter for selecting feature flags. Defaults to `*` (all). */
+export declare const AZURE_FEATURE_FLAG_KEY_FILTER: import("@breadstone/archipel-platform-configuration").IConfigKey<string>;
+/** Configuration entries required by the Azure feature flag provider. */
+export declare const AZURE_FEATURE_FLAG_CONFIG_ENTRIES: ReadonlyArray<Omit<IConfigRegistryEntry, 'module'>>;

package/src/azure/env.js

@@ -0,0 +1,44 @@
+"use strict";
+// #region Imports
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AZURE_FEATURE_FLAG_CONFIG_ENTRIES = exports.AZURE_FEATURE_FLAG_KEY_FILTER = exports.AZURE_FEATURE_FLAG_REFRESH_INTERVAL = exports.AZURE_APPCONFIG_CONNECTION_STRING = exports.AZURE_APPCONFIG_ENDPOINT = void 0;
+const archipel_platform_configuration_1 = require("@breadstone/archipel-platform-configuration");
+// #endregion
+// ──────────────────────────────────────────────────────────────
+// Azure App Configuration
+// ──────────────────────────────────────────────────────────────
+/** Azure App Configuration endpoint URL. Required when using Entra ID authentication. */
+exports.AZURE_APPCONFIG_ENDPOINT = (0, archipel_platform_configuration_1.createConfigKey)('AZURE_APPCONFIG_ENDPOINT');
+/** Azure App Configuration connection string. Alternative to endpoint + Entra ID. */
+exports.AZURE_APPCONFIG_CONNECTION_STRING = (0, archipel_platform_configuration_1.createConfigKey)('AZURE_APPCONFIG_CONNECTION_STRING');
+/** Refresh interval in milliseconds for feature flag state. Defaults to 30000. */
+exports.AZURE_FEATURE_FLAG_REFRESH_INTERVAL = (0, archipel_platform_configuration_1.createConfigKey)('AZURE_FEATURE_FLAG_REFRESH_INTERVAL');
+/** Key filter for selecting feature flags. Defaults to `*` (all). */
+exports.AZURE_FEATURE_FLAG_KEY_FILTER = (0, archipel_platform_configuration_1.createConfigKey)('AZURE_FEATURE_FLAG_KEY_FILTER');
+// ──────────────────────────────────────────────────────────────
+// Registry entries
+// ──────────────────────────────────────────────────────────────
+/** Configuration entries required by the Azure feature flag provider. */
+exports.AZURE_FEATURE_FLAG_CONFIG_ENTRIES = [
+    {
+        key: exports.AZURE_APPCONFIG_ENDPOINT,
+        required: false,
+        description: 'Azure App Configuration endpoint URL. Required when using Entra ID authentication.',
+    },
+    {
+        key: exports.AZURE_APPCONFIG_CONNECTION_STRING,
+        required: false,
+        description: 'Azure App Configuration connection string. Alternative to endpoint + Entra ID.',
+    },
+    {
+        key: exports.AZURE_FEATURE_FLAG_REFRESH_INTERVAL,
+        required: false,
+        description: 'Refresh interval in milliseconds for feature flag state. Defaults to 30000.',
+    },
+    {
+        key: exports.AZURE_FEATURE_FLAG_KEY_FILTER,
+        required: false,
+        description: 'Key filter for selecting feature flags. Defaults to * (all).',
+    },
+];
+//# sourceMappingURL=env.js.map

package/src/azure/index.d.ts

@@ -0,0 +1,3 @@
+export { AzureFeatureFlagReader } from './AzureFeatureFlagReader';
+export { AzureFeatureFlagWriter } from './AzureFeatureFlagWriter';
+export { AZURE_APPCONFIG_CONNECTION_STRING, AZURE_APPCONFIG_ENDPOINT, AZURE_FEATURE_FLAG_CONFIG_ENTRIES, AZURE_FEATURE_FLAG_KEY_FILTER, AZURE_FEATURE_FLAG_REFRESH_INTERVAL, } from './env';

package/src/azure/index.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AZURE_FEATURE_FLAG_REFRESH_INTERVAL = exports.AZURE_FEATURE_FLAG_KEY_FILTER = exports.AZURE_FEATURE_FLAG_CONFIG_ENTRIES = exports.AZURE_APPCONFIG_ENDPOINT = exports.AZURE_APPCONFIG_CONNECTION_STRING = exports.AzureFeatureFlagWriter = exports.AzureFeatureFlagReader = void 0;
+var AzureFeatureFlagReader_1 = require("./AzureFeatureFlagReader");
+Object.defineProperty(exports, "AzureFeatureFlagReader", { enumerable: true, get: function () { return AzureFeatureFlagReader_1.AzureFeatureFlagReader; } });
+var AzureFeatureFlagWriter_1 = require("./AzureFeatureFlagWriter");
+Object.defineProperty(exports, "AzureFeatureFlagWriter", { enumerable: true, get: function () { return AzureFeatureFlagWriter_1.AzureFeatureFlagWriter; } });
+var env_1 = require("./env");
+Object.defineProperty(exports, "AZURE_APPCONFIG_CONNECTION_STRING", { enumerable: true, get: function () { return env_1.AZURE_APPCONFIG_CONNECTION_STRING; } });
+Object.defineProperty(exports, "AZURE_APPCONFIG_ENDPOINT", { enumerable: true, get: function () { return env_1.AZURE_APPCONFIG_ENDPOINT; } });
+Object.defineProperty(exports, "AZURE_FEATURE_FLAG_CONFIG_ENTRIES", { enumerable: true, get: function () { return env_1.AZURE_FEATURE_FLAG_CONFIG_ENTRIES; } });
+Object.defineProperty(exports, "AZURE_FEATURE_FLAG_KEY_FILTER", { enumerable: true, get: function () { return env_1.AZURE_FEATURE_FLAG_KEY_FILTER; } });
+Object.defineProperty(exports, "AZURE_FEATURE_FLAG_REFRESH_INTERVAL", { enumerable: true, get: function () { return env_1.AZURE_FEATURE_FLAG_REFRESH_INTERVAL; } });
+//# sourceMappingURL=index.js.map

package/src/contracts/FeatureFlagReaderPort.d.ts

@@ -0,0 +1,54 @@
+import type { IFeatureFlagContext } from '../models/IFeatureFlagContext';
+import type { IFeatureFlagEvaluation } from '../models/IFeatureFlagEvaluation';
+/**
+ * Abstract port for feature flag reader operations.
+ * Each provider (Azure App Configuration, Vercel Edge Config) must implement this contract
+ * so that the consuming application can switch providers without changing business logic.
+ *
+ * @public
+ */
+export declare abstract class FeatureFlagReaderPort {
+    /**
+     * Evaluates whether a feature flag is enabled.
+     *
+     * @public
+     * @param key - The unique key identifying the feature flag.
+     * @param context - Optional evaluation context for targeting and segmentation.
+     * @returns `true` if the feature flag is enabled.
+     */
+    abstract isEnabled(key: string, context?: IFeatureFlagContext): Promise<boolean>;
+    /**
+     * Returns the variant value of a feature flag for multivariate flags and A/B testing.
+     *
+     * @public
+     * @param key - The unique key identifying the feature flag.
+     * @param defaultValue - The default value to return if the flag is not found.
+     * @param context - Optional evaluation context for targeting and segmentation.
+     * @returns The variant value of the feature flag.
+     */
+    abstract getVariant<T = unknown>(key: string, defaultValue: T, context?: IFeatureFlagContext): Promise<T>;
+    /**
+     * Returns all known feature flags with their current evaluation.
+     *
+     * @public
+     * @param context - Optional evaluation context for targeting and segmentation.
+     * @returns Array of evaluated feature flags.
+     */
+    abstract getAllFlags(context?: IFeatureFlagContext): Promise<ReadonlyArray<IFeatureFlagEvaluation>>;
+    /**
+     * Refreshes the flag state from the remote provider.
+     * Implementations should reload configuration from the upstream source.
+     *
+     * @public
+     */
+    abstract refresh(): Promise<void>;
+    /**
+     * Lightweight connectivity check for the feature flag provider.
+     * Override in adapters to perform a real API call.
+     * Defaults to `true` if not overridden.
+     *
+     * @public
+     * @returns `true` if the provider is reachable.
+     */
+    ping(): Promise<boolean>;
+}

package/src/contracts/FeatureFlagReaderPort.js

@@ -0,0 +1,27 @@
+"use strict";
+// #region Imports
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FeatureFlagReaderPort = void 0;
+// #endregion
+/**
+ * Abstract port for feature flag reader operations.
+ * Each provider (Azure App Configuration, Vercel Edge Config) must implement this contract
+ * so that the consuming application can switch providers without changing business logic.
+ *
+ * @public
+ */
+class FeatureFlagReaderPort {
+    /**
+     * Lightweight connectivity check for the feature flag provider.
+     * Override in adapters to perform a real API call.
+     * Defaults to `true` if not overridden.
+     *
+     * @public
+     * @returns `true` if the provider is reachable.
+     */
+    async ping() {
+        return true;
+    }
+}
+exports.FeatureFlagReaderPort = FeatureFlagReaderPort;
+//# sourceMappingURL=FeatureFlagReaderPort.js.map

package/src/contracts/FeatureFlagWriterPort.d.ts

@@ -0,0 +1,64 @@
+import type { IFeatureFlagDefinition } from '../models/IFeatureFlagDefinition';
+/**
+ * Abstract port for feature flag writer operations (CRUD).
+ * Each provider (Azure App Configuration, Vercel Edge Config) must implement this contract
+ * so that the admin UI backend can manage flags without being coupled to a specific provider.
+ *
+ * @remarks
+ * This port is intentionally separated from {@link FeatureFlagReaderPort} because
+ * the read path (consumed by application code) and the write path (consumed by admin tooling)
+ * have different deployment contexts, security requirements, and SDK dependencies.
+ *
+ * @public
+ */
+export declare abstract class FeatureFlagWriterPort {
+    /**
+     * Returns a single feature flag definition by key.
+     *
+     * @public
+     * @param key - The unique key identifying the feature flag.
+     * @returns The flag definition, or `undefined` if not found.
+     */
+    abstract getFlag(key: string): Promise<IFeatureFlagDefinition | undefined>;
+    /**
+     * Returns all feature flag definitions managed by the provider.
+     *
+     * @public
+     * @returns Array of flag definitions.
+     */
+    abstract listFlags(): Promise<ReadonlyArray<IFeatureFlagDefinition>>;
+    /**
+     * Creates a new feature flag.
+     *
+     * @public
+     * @param definition - The flag definition to create.
+     * @throws {FeatureFlagError} If the flag already exists or creation fails.
+     */
+    abstract createFlag(definition: IFeatureFlagDefinition): Promise<void>;
+    /**
+     * Updates an existing feature flag.
+     * Only the fields present in the partial definition are updated.
+     *
+     * @public
+     * @param key - The unique key of the flag to update.
+     * @param updates - Partial definition with the fields to update.
+     * @throws {FeatureFlagError} If the flag does not exist or the update fails.
+     */
+    abstract updateFlag(key: string, updates: Partial<Omit<IFeatureFlagDefinition, 'key'>>): Promise<void>;
+    /**
+     * Deletes a feature flag.
+     *
+     * @public
+     * @param key - The unique key of the flag to delete.
+     * @throws {FeatureFlagError} If the deletion fails.
+     */
+    abstract deleteFlag(key: string): Promise<void>;
+    /**
+     * Lightweight connectivity check for the writer provider.
+     * Defaults to `true` if not overridden.
+     *
+     * @public
+     * @returns `true` if the provider is reachable.
+     */
+    ping(): Promise<boolean>;
+}

package/src/contracts/FeatureFlagWriterPort.js

@@ -0,0 +1,31 @@
+"use strict";
+// #region Imports
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FeatureFlagWriterPort = void 0;
+// #endregion
+/**
+ * Abstract port for feature flag writer operations (CRUD).
+ * Each provider (Azure App Configuration, Vercel Edge Config) must implement this contract
+ * so that the admin UI backend can manage flags without being coupled to a specific provider.
+ *
+ * @remarks
+ * This port is intentionally separated from {@link FeatureFlagReaderPort} because
+ * the read path (consumed by application code) and the write path (consumed by admin tooling)
+ * have different deployment contexts, security requirements, and SDK dependencies.
+ *
+ * @public
+ */
+class FeatureFlagWriterPort {
+    /**
+     * Lightweight connectivity check for the writer provider.
+     * Defaults to `true` if not overridden.
+     *
+     * @public
+     * @returns `true` if the provider is reachable.
+     */
+    async ping() {
+        return true;
+    }
+}
+exports.FeatureFlagWriterPort = FeatureFlagWriterPort;
+//# sourceMappingURL=FeatureFlagWriterPort.js.map

package/src/contracts/index.d.ts

@@ -0,0 +1,2 @@
+export { FeatureFlagReaderPort } from './FeatureFlagReaderPort';
+export { FeatureFlagWriterPort } from './FeatureFlagWriterPort';

package/src/contracts/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FeatureFlagWriterPort = exports.FeatureFlagReaderPort = void 0;
+var FeatureFlagReaderPort_1 = require("./FeatureFlagReaderPort");
+Object.defineProperty(exports, "FeatureFlagReaderPort", { enumerable: true, get: function () { return FeatureFlagReaderPort_1.FeatureFlagReaderPort; } });
+var FeatureFlagWriterPort_1 = require("./FeatureFlagWriterPort");
+Object.defineProperty(exports, "FeatureFlagWriterPort", { enumerable: true, get: function () { return FeatureFlagWriterPort_1.FeatureFlagWriterPort; } });
+//# sourceMappingURL=index.js.map

package/src/decorators/FeatureFlag.d.ts

@@ -0,0 +1,11 @@
+import { SetMetadata } from '@nestjs/common';
+/** Metadata key used to store the feature flag key on route handlers. */
+export declare const FEATURE_FLAG_KEY_METADATA = "feature_flag_key";
+/**
+ * Decorator to mark endpoints that require a specific feature flag to be enabled.
+ * The guard reads this metadata to evaluate the flag before allowing access.
+ *
+ * @public
+ * @param flagKey - The unique key of the feature flag to check.
+ */
+export declare const FeatureFlag: (flagKey: string) => ReturnType<typeof SetMetadata>;

package/src/decorators/FeatureFlag.js

@@ -0,0 +1,18 @@
+"use strict";
+// #region Imports
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FeatureFlag = exports.FEATURE_FLAG_KEY_METADATA = void 0;
+const common_1 = require("@nestjs/common");
+// #endregion
+/** Metadata key used to store the feature flag key on route handlers. */
+exports.FEATURE_FLAG_KEY_METADATA = 'feature_flag_key';
+/**
+ * Decorator to mark endpoints that require a specific feature flag to be enabled.
+ * The guard reads this metadata to evaluate the flag before allowing access.
+ *
+ * @public
+ * @param flagKey - The unique key of the feature flag to check.
+ */
+const FeatureFlag = (flagKey) => (0, common_1.SetMetadata)(exports.FEATURE_FLAG_KEY_METADATA, flagKey);
+exports.FeatureFlag = FeatureFlag;
+//# sourceMappingURL=FeatureFlag.js.map

package/src/decorators/index.d.ts

@@ -0,0 +1 @@
+export { FEATURE_FLAG_KEY_METADATA, FeatureFlag } from './FeatureFlag';

package/src/decorators/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FeatureFlag = exports.FEATURE_FLAG_KEY_METADATA = void 0;
+var FeatureFlag_1 = require("./FeatureFlag");
+Object.defineProperty(exports, "FEATURE_FLAG_KEY_METADATA", { enumerable: true, get: function () { return FeatureFlag_1.FEATURE_FLAG_KEY_METADATA; } });
+Object.defineProperty(exports, "FeatureFlag", { enumerable: true, get: function () { return FeatureFlag_1.FeatureFlag; } });
+//# sourceMappingURL=index.js.map

package/src/env.d.ts

@@ -0,0 +1,5 @@
+import type { IConfigRegistryEntry } from '@breadstone/archipel-platform-configuration';
+export { AZURE_APPCONFIG_CONNECTION_STRING, AZURE_APPCONFIG_ENDPOINT, AZURE_FEATURE_FLAG_CONFIG_ENTRIES, AZURE_FEATURE_FLAG_KEY_FILTER, AZURE_FEATURE_FLAG_REFRESH_INTERVAL, } from './azure/env';
+export { VERCEL_API_TOKEN, VERCEL_EDGE_CONFIG, VERCEL_EDGE_CONFIG_ID, VERCEL_EDGE_CONFIG_TOKEN, VERCEL_FEATURE_FLAG_CONFIG_ENTRIES, VERCEL_FEATURE_FLAG_PREFIX, VERCEL_FEATURE_FLAG_WRITER_CONFIG_ENTRIES, VERCEL_TEAM_ID, } from './vercel/env';
+/** All configuration entries required by the platform-feature-flags library across all providers. */
+export declare const PLATFORM_FEATURE_FLAGS_CONFIG_ENTRIES: ReadonlyArray<Omit<IConfigRegistryEntry, 'module'>>;

package/src/env.js

@@ -0,0 +1,35 @@
+"use strict";
+// #region Imports
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PLATFORM_FEATURE_FLAGS_CONFIG_ENTRIES = exports.VERCEL_TEAM_ID = exports.VERCEL_FEATURE_FLAG_WRITER_CONFIG_ENTRIES = exports.VERCEL_FEATURE_FLAG_PREFIX = exports.VERCEL_FEATURE_FLAG_CONFIG_ENTRIES = exports.VERCEL_EDGE_CONFIG_TOKEN = exports.VERCEL_EDGE_CONFIG_ID = exports.VERCEL_EDGE_CONFIG = exports.VERCEL_API_TOKEN = exports.AZURE_FEATURE_FLAG_REFRESH_INTERVAL = exports.AZURE_FEATURE_FLAG_KEY_FILTER = exports.AZURE_FEATURE_FLAG_CONFIG_ENTRIES = exports.AZURE_APPCONFIG_ENDPOINT = exports.AZURE_APPCONFIG_CONNECTION_STRING = void 0;
+const env_1 = require("./azure/env");
+const env_2 = require("./vercel/env");
+// #endregion
+// ──────────────────────────────────────────────────────────────
+// Re-exports
+// ──────────────────────────────────────────────────────────────
+var env_3 = require("./azure/env");
+Object.defineProperty(exports, "AZURE_APPCONFIG_CONNECTION_STRING", { enumerable: true, get: function () { return env_3.AZURE_APPCONFIG_CONNECTION_STRING; } });
+Object.defineProperty(exports, "AZURE_APPCONFIG_ENDPOINT", { enumerable: true, get: function () { return env_3.AZURE_APPCONFIG_ENDPOINT; } });
+Object.defineProperty(exports, "AZURE_FEATURE_FLAG_CONFIG_ENTRIES", { enumerable: true, get: function () { return env_3.AZURE_FEATURE_FLAG_CONFIG_ENTRIES; } });
+Object.defineProperty(exports, "AZURE_FEATURE_FLAG_KEY_FILTER", { enumerable: true, get: function () { return env_3.AZURE_FEATURE_FLAG_KEY_FILTER; } });
+Object.defineProperty(exports, "AZURE_FEATURE_FLAG_REFRESH_INTERVAL", { enumerable: true, get: function () { return env_3.AZURE_FEATURE_FLAG_REFRESH_INTERVAL; } });
+var env_4 = require("./vercel/env");
+Object.defineProperty(exports, "VERCEL_API_TOKEN", { enumerable: true, get: function () { return env_4.VERCEL_API_TOKEN; } });
+Object.defineProperty(exports, "VERCEL_EDGE_CONFIG", { enumerable: true, get: function () { return env_4.VERCEL_EDGE_CONFIG; } });
+Object.defineProperty(exports, "VERCEL_EDGE_CONFIG_ID", { enumerable: true, get: function () { return env_4.VERCEL_EDGE_CONFIG_ID; } });
+Object.defineProperty(exports, "VERCEL_EDGE_CONFIG_TOKEN", { enumerable: true, get: function () { return env_4.VERCEL_EDGE_CONFIG_TOKEN; } });
+Object.defineProperty(exports, "VERCEL_FEATURE_FLAG_CONFIG_ENTRIES", { enumerable: true, get: function () { return env_4.VERCEL_FEATURE_FLAG_CONFIG_ENTRIES; } });
+Object.defineProperty(exports, "VERCEL_FEATURE_FLAG_PREFIX", { enumerable: true, get: function () { return env_4.VERCEL_FEATURE_FLAG_PREFIX; } });
+Object.defineProperty(exports, "VERCEL_FEATURE_FLAG_WRITER_CONFIG_ENTRIES", { enumerable: true, get: function () { return env_4.VERCEL_FEATURE_FLAG_WRITER_CONFIG_ENTRIES; } });
+Object.defineProperty(exports, "VERCEL_TEAM_ID", { enumerable: true, get: function () { return env_4.VERCEL_TEAM_ID; } });
+// ──────────────────────────────────────────────────────────────
+// Aggregated registry entries
+// ──────────────────────────────────────────────────────────────
+/** All configuration entries required by the platform-feature-flags library across all providers. */
+exports.PLATFORM_FEATURE_FLAGS_CONFIG_ENTRIES = [
+    ...env_1.AZURE_FEATURE_FLAG_CONFIG_ENTRIES,
+    ...env_2.VERCEL_FEATURE_FLAG_CONFIG_ENTRIES,
+    ...env_2.VERCEL_FEATURE_FLAG_WRITER_CONFIG_ENTRIES,
+];
+//# sourceMappingURL=env.js.map

package/src/errors/FeatureFlagError.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Domain error thrown when a feature flag operation fails.
+ *
+ * @public
+ */
+export declare class FeatureFlagError extends Error {
+    readonly code = "FEATURE_FLAG";
+    readonly provider: string;
+    constructor(provider: string, message: string, cause?: unknown);
+}

package/src/errors/FeatureFlagError.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FeatureFlagError = void 0;
+/**
+ * Domain error thrown when a feature flag operation fails.
+ *
+ * @public
+ */
+class FeatureFlagError extends Error {
+    // #endregion
+    // #region Ctor
+    constructor(provider, message, cause) {
+        super(message, { cause });
+        // #region Fields
+        this.code = 'FEATURE_FLAG';
+        this.name = 'FeatureFlagError';
+        this.provider = provider;
+    }
+}
+exports.FeatureFlagError = FeatureFlagError;
+//# sourceMappingURL=FeatureFlagError.js.map

package/src/errors/index.d.ts

@@ -0,0 +1 @@
+export { FeatureFlagError } from './FeatureFlagError';

package/src/errors/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FeatureFlagError = void 0;
+var FeatureFlagError_1 = require("./FeatureFlagError");
+Object.defineProperty(exports, "FeatureFlagError", { enumerable: true, get: function () { return FeatureFlagError_1.FeatureFlagError; } });
+//# sourceMappingURL=index.js.map