commandkit 1.0.0-dev.20250608124717 → 1.0.0-dev.20250609020912

package/dist/{CommandKit-CEFWQpDo.d.ts → CommandKit-VTym8VA2.d.ts}

@@ -761,58 +761,291 @@ declare class CommandKitPluginRuntime {
   execute<R = any>(f: AsyncFunction<[CommandKitPluginRuntime, RuntimePlugin], R | undefined>): Promise<true | R | undefined>;
 }
 //#endregion
+//#region src/flags/FlagProvider.d.ts
+/**
+ * Interface for external feature flag providers.
+ * Implement this interface to integrate with external flag management systems
+ * like LaunchDarkly, Split, Unleash, etc.
+ */
+interface FlagProvider {
+  /**
+   * Initialize the provider (e.g., establish connections, load initial config)
+   */
+  initialize?(): MaybePromise<void>;
+  /**
+   * Get the current value/configuration for a feature flag
+   * @param key - The feature flag key
+   * @param context - Optional context for flag evaluation
+   * @returns The flag configuration or null if not found
+   */
+  getFlag(key: string, context?: any): MaybePromise<FlagConfiguration | null>;
+  /**
+   * Check if a flag exists in the external system
+   * @param key - The feature flag key
+   */
+  hasFlag(key: string): MaybePromise<boolean>;
+  /**
+   * Cleanup resources when the provider is no longer needed
+   */
+  destroy?(): MaybePromise<void>;
+}
+/**
+ * Configuration returned by external flag providers
+ */
+interface FlagConfiguration {
+  /**
+   * Whether the flag is enabled/disabled at the provider level
+   */
+  enabled: boolean;
+  /**
+   * Optional configuration data that can be used in the decide function
+   */
+  config?: Record<string, any>;
+  /**
+   * Optional percentage for gradual rollouts (0-100)
+   */
+  percentage?: number;
+  /**
+   * Optional targeting rules or segments
+   */
+  targeting?: {
+    segments?: string[];
+    rules?: Array<{
+      condition: string;
+      value: any;
+    }>;
+  };
+}
+/**
+ * Example implementation for a simple JSON-based flag provider
+ */
+declare class JsonFlagProvider implements FlagProvider {
+  private config;
+  private flags;
+  constructor(config: Record<string, FlagConfiguration>);
+  getFlag(key: string): Promise<FlagConfiguration | null>;
+  hasFlag(key: string): Promise<boolean>;
+  destroy(): Promise<void>;
+}
+//#endregion
 //#region src/flags/feature-flags.d.ts
+/**
+ * Set the global flag provider for all feature flags
+ */
+declare function setFlagProvider(provider: FlagProvider): void;
 type MaybePromise<T> = T | Promise<T>;
+/**
+ * Function type for identifying entities in the context of feature flags.
+ * This function should return an object representing the entity that will be used
+ * to evaluate the feature flag.
+ * It can be synchronous or asynchronous.
+ */
 type IdentifyFunction<R> = (context: EvaluationContext) => MaybePromise<R>;
+/**
+ * Function type for deciding the outcome of a feature flag based on the provided entities.
+ * This function receives an object containing the entities and optionally the provider configuration,
+ * and should return the result of the decision.
+ * It can be synchronous or asynchronous.
+ */
 type DecideFunction<E, R> = (data: {
   entities: E;
+  provider?: FlagConfiguration | null;
 }) => MaybePromise<R>;
+/**
+ * Definition for a feature flag, including its key, description, identify function,
+ * and decide function.
+ * The identify function is used to determine the entities that will be evaluated
+ * against the feature flag, while the decide function contains the logic for
+ * determining the outcome of the flag based on those entities.
+ */
 interface FeatureFlagDefinition<R, Entity> {
+  /**
+   * Unique key for the feature flag.
+   * Should be a string that identifies the flag.
+   */
   key: string;
+  /**
+   * Optional description of the feature flag.
+   * This can be used for documentation or debugging purposes.
+   */
   description?: string;
+  /**
+   * Optional flag to enable integration with an external flag provider.
+   * If true, the flag will use the global flag provider to determine its state.
+   * Default: false
+   */
   identify?: IdentifyFunction<Entity>;
+  /**
+   * Function to decide the outcome of the feature flag.
+   * This function receives the identified entities and should return the result of the decision.
+   */
   decide: DecideFunction<Entity, R>;
+  /**
+   * Whether to disable analytics tracking for this flag.
+   * Default: false
+   */
+  disableAnalytics?: boolean;
 }
 interface CommandFlagContext {
+  /**
+   * The Discord client instance.
+   * This is the main entry point for interacting with the Discord API.
+   */
   client: Client<true>;
+  /**
+   * The CommandKit instance, which provides access to the command framework.
+   * This includes commands, events, and other features of CommandKit.
+   */
   commandkit: CommandKit;
+  /**
+   * The command context, which includes information about the command being executed.
+   * This can include the interaction, message, guild, channel, and the loaded command.
+   */
   command: {
+    /**
+     * The interaction object if the command was invoked via an interaction.
+     * This can be a ChatInputCommandInteraction, AutocompleteInteraction, or ContextMenuCommandInteraction.
+     */
     interaction?: ChatInputCommandInteraction | AutocompleteInteraction | ContextMenuCommandInteraction;
+    /**
+     * The message object if the command was invoked via a message.
+     */
     message?: Message;
+    /**
+     * The guild where the command was invoked, if applicable.
+     * This will be null for commands invoked in DMs.
+     */
     guild: Guild | null;
+    /**
+     * The channel where the command was invoked.
+     * This can be a text channel, DM channel, or any other type of text-based channel.
+     */
     channel: TextBasedChannel | null;
+    /**
+     * The loaded command instance that is being executed.
+     * This contains the command's metadata and logic.
+     */
     command: LoadedCommand;
   };
+  /**
+   * The event context is null for command flags, as they are not tied to a specific event.
+   * This is used to differentiate between command and event flags.
+   */
   event: null;
 }
 interface EventFlagContext {
+  /**
+   * The Discord client instance.
+   * This is the main entry point for interacting with the Discord API.
+   */
   client: Client<true>;
+  /**
+   * The CommandKit instance, which provides access to the command framework.
+   * This includes commands, events, and other features of CommandKit.
+   */
   commandkit: CommandKit;
+  /**
+   * The event context, which includes information about the event being processed.
+   * This can include the parsed event data, the event name, and the namespace if applicable.
+   */
   event: {
+    /**
+     * The parsed event data, which contains the raw data from the event.
+     * This can include information like user IDs, channel IDs, and other relevant data.
+     */
     data: ParsedEvent;
+    /**
+     * The name of the event being processed.
+     * This is the string identifier for the event, such as 'messageCreate' or 'guildMemberAdd'.
+     */
     event: string;
+    /**
+     * The namespace of the event, if applicable.
+     * This can be used to group related events or commands together.
+     * It is null if the event does not belong to a specific namespace.
+     */
     namespace: string | null;
+    /**
+     * The arguments passed to the event handler.
+     * This is an array of arguments that were passed when the event was triggered.
+     * It can be used to access specific data related to the event.
+     */
     arguments: any[];
+    /**
+     * A function to retrieve the arguments for a specific event type.
+     * This allows for type-safe access to the arguments based on the event name.
+     * @param event - The name of the event to retrieve arguments for.
+     */
     argumentsAs<E extends keyof ClientEvents>(event: E): ClientEvents[E];
   };
+  /**
+   * The command context is null for event flags, as they are not tied to a specific command.
+   * This is used to differentiate between command and event flags.
+   */
   command: null;
 }
+/**
+ * Combined context type for feature flag evaluation.
+ */
 type EvaluationContext = CommandFlagContext | EventFlagContext;
+/**
+ * Function type for custom evaluation of feature flags.
+ * This function can be used to provide a custom evaluation context for the flag.
+ * It should return an object representing the entities to be evaluated.
+ */
 type CustomEvaluationFunction<E> = () => MaybePromise<E>;
+/**
+ * Context for custom evaluation of feature flags.
+ * This allows for more flexible evaluation based on custom logic or external data.
+ * The identify function can be a direct object or a function that returns the entities.
+ */
 type CustomEvaluationContext<E> = {
+  /**
+   * Optional function to identify the entities for evaluation.
+   * This can be a function that returns the entities based on the current context.
+   */
   identify: E | CustomEvaluationFunction<E>;
 };
 interface FlagRunner<E, R> {
+  /**
+   * Execute the feature flag evaluation with the provided entities.
+   * This method will run the identify and decide functions to determine the flag's outcome.
+   * @param res - Optional entities to use for evaluation. If not provided, it will call the identify function.
+   * @returns A promise that resolves to the result of the feature flag evaluation.
+   */
   (): Promise<R>;
+  /**
+   * Run the feature flag evaluation with a custom context.
+   * This allows for more flexible evaluation based on custom logic or external data.
+   * @param context - The custom evaluation context containing the identify function or object.
+   * @returns A promise that resolves to the result of the feature flag evaluation.
+   */
   run(context: CustomEvaluationContext<E>): Promise<R>;
 }
+/**
+ * Class representing a feature flag in CommandKit.
+ */
 declare class FeatureFlag<R, T> {
   readonly options: FeatureFlagDefinition<R, T>;
   private commandkit;
+  /**
+   * Create a new feature flag.
+   * @param options - The options for the feature flag.
+   */
   constructor(options: FeatureFlagDefinition<R, T>);
   private getContext;
+  /**
+   * Execute the feature flag evaluation.
+   * @param res - Optional entities to use for evaluation. If not provided, it will call the identify function.
+   * @returns A promise that resolves to the result of the feature flag evaluation.
+   */
   execute(res?: T): Promise<R>;
 }
+/**
+ * Create a new feature flag.
+ * @param options - The options for the feature flag.
+ * @returns A new instance of the FeatureFlag class.
+ */
 declare function flag<Returns = boolean, Entity = Record<any, any>>(options: FeatureFlagDefinition<Returns, Entity>): FlagRunner<Entity, Returns>;
 //#endregion
 //#region src/flags/store.d.ts
@@ -961,5 +1194,5 @@ declare class CommandKit extends EventEmitter {
 }
 declare const commandkit: CommandKit;
 //#endregion
-export { AnalyticsEngine, AnalyticsEvent, AnalyticsProvider, AnyCommandExecute, AppCommandHandler, AppCommandRunner, AppEventsHandler, AppEventsHandlerLoadedData, AsyncFunction, AutocompleteCommand, AutocompleteCommandContext, AutocompleteCommandMiddlewareContext, BootstrapFunction, ChatInputCommand, ChatInputCommandContext, CommandBuilderLike, CommandContext, CommandContextOptions, CommandData, CommandExecutionMode, CommandFlagContext, CommandKit, CommandKitConfiguration, CommandKitEnvironment, CommandKitEnvironmentInternalData, CommandKitEnvironmentType, CommandKitEventDispatch, CommandKitEventsChannel, CommandKitHMREvent, CommandKitOptions, CommandKitPlugin, CommandKitPluginRuntime, CommandRegistrar, CommandTypeData, CommonDirectiveTransformer, CommonDirectiveTransformerOptions, CommonPluginRuntime, CompilerPlugin, CompilerPluginRuntime, Context, ContextParameters, CustomEvaluationContext, CustomEvaluationFunction, DecideFunction, EvaluationContext, EventFlagContext, EventListener, FeatureFlag, FeatureFlagDefinition, FilterFunction, FlagRunner, FlagStore, GenericFunction, IdentifyEvent, IdentifyFunction, InteractionCommandContext, InteractionCommandMiddlewareContext, ListenerFunction, LoadedCommand, LoadedEvent, MaybeFalsey, MaybePromise, MessageCommand, MessageCommandContext, MessageCommandMiddlewareContext, MessageContextMenuCommand, MessageContextMenuCommandContext, MessageContextMenuCommandMiddlewareContext, MiddlewareContext, MiddlewareContextArgs, PluginCommon, PluginOptions, PluginTransformParameters, PluginType, PreRegisterCommandsEvent, PreparedAppCommandExecution, ResolvableCommand, RunCommand, RuntimePlugin, SlashCommandMiddlewareContext, TemplateHandler, TransformedResult, UserContextMenuCommand, UserContextMenuCommandContext, UserContextMenuCommandMiddlewareContext, after, cancelAfter, commandkit, exitContext, flag, getCommandKit, getContext, isCommandWorkerContext, isCompilerPlugin, isPlugin, isRuntimePlugin, makeContextAwareFunction, onApplicationBootstrap, onBootstrap, provideContext, registerDevHooks, useEnvironment };
-//# sourceMappingURL=CommandKit-CEFWQpDo.d.ts.map
+export { AnalyticsEngine, AnalyticsEvent, AnalyticsProvider, AnyCommandExecute, AppCommandHandler, AppCommandRunner, AppEventsHandler, AppEventsHandlerLoadedData, AsyncFunction, AutocompleteCommand, AutocompleteCommandContext, AutocompleteCommandMiddlewareContext, BootstrapFunction, ChatInputCommand, ChatInputCommandContext, CommandBuilderLike, CommandContext, CommandContextOptions, CommandData, CommandExecutionMode, CommandFlagContext, CommandKit, CommandKitConfiguration, CommandKitEnvironment, CommandKitEnvironmentInternalData, CommandKitEnvironmentType, CommandKitEventDispatch, CommandKitEventsChannel, CommandKitHMREvent, CommandKitOptions, CommandKitPlugin, CommandKitPluginRuntime, CommandRegistrar, CommandTypeData, CommonDirectiveTransformer, CommonDirectiveTransformerOptions, CommonPluginRuntime, CompilerPlugin, CompilerPluginRuntime, Context, ContextParameters, CustomEvaluationContext, CustomEvaluationFunction, DecideFunction, EvaluationContext, EventFlagContext, EventListener, FeatureFlag, FeatureFlagDefinition, FilterFunction, FlagConfiguration, FlagProvider, FlagRunner, FlagStore, GenericFunction, IdentifyEvent, IdentifyFunction, InteractionCommandContext, InteractionCommandMiddlewareContext, JsonFlagProvider, ListenerFunction, LoadedCommand, LoadedEvent, MaybeFalsey, MaybePromise, MessageCommand, MessageCommandContext, MessageCommandMiddlewareContext, MessageContextMenuCommand, MessageContextMenuCommandContext, MessageContextMenuCommandMiddlewareContext, MiddlewareContext, MiddlewareContextArgs, PluginCommon, PluginOptions, PluginTransformParameters, PluginType, PreRegisterCommandsEvent, PreparedAppCommandExecution, ResolvableCommand, RunCommand, RuntimePlugin, SlashCommandMiddlewareContext, TemplateHandler, TransformedResult, UserContextMenuCommand, UserContextMenuCommandContext, UserContextMenuCommandMiddlewareContext, after, cancelAfter, commandkit, exitContext, flag, getCommandKit, getContext, isCommandWorkerContext, isCompilerPlugin, isPlugin, isRuntimePlugin, makeContextAwareFunction, onApplicationBootstrap, onBootstrap, provideContext, registerDevHooks, setFlagProvider, useEnvironment };
+//# sourceMappingURL=CommandKit-VTym8VA2.d.ts.map

package/dist/CommandKit.d.ts

@@ -1,4 +1,4 @@
-import { BootstrapFunction, CommandKit, CommandKitConfiguration, commandkit, onApplicationBootstrap, onBootstrap } from "./CommandKit-CEFWQpDo.js";
+import { BootstrapFunction, CommandKit, CommandKitConfiguration, commandkit, onApplicationBootstrap, onBootstrap } from "./CommandKit-VTym8VA2.js";
 import "./EventInterceptor-D_oEWSnF.js";
 import "./ButtonKit-BSI7lCI0.js";
 import "./ModalKit-CKtQ8eXW.js";

package/dist/{EventWorkerContext-Dk7c6sRe.d.ts → EventWorkerContext-BXKO7FMY.d.ts}

@@ -1,4 +1,4 @@
-import { CommandKit } from "./CommandKit-CEFWQpDo.js";
+import { CommandKit } from "./CommandKit-VTym8VA2.js";
 import { ParsedEvent } from "./EventsRouter-BacqK6z3.js";
 import { AsyncLocalStorage } from "node:async_hooks";
 
@@ -17,4 +17,4 @@ declare function getEventWorkerContext(): EventWorkerContext;
 declare function isEventWorkerContext(worker: any): worker is EventWorkerContext;
 //#endregion
 export { EventWorkerContext, eventWorkerContext, getEventWorkerContext, isEventWorkerContext, runInEventWorkerContext };
-//# sourceMappingURL=EventWorkerContext-Dk7c6sRe.d.ts.map
+//# sourceMappingURL=EventWorkerContext-BXKO7FMY.d.ts.map

package/dist/analytics/analytics-engine.d.ts

@@ -1,4 +1,4 @@
-import { AnalyticsEngine, FilterFunction } from "../CommandKit-CEFWQpDo.js";
+import { AnalyticsEngine, FilterFunction } from "../CommandKit-VTym8VA2.js";
 import "../EventInterceptor-D_oEWSnF.js";
 import "../ButtonKit-BSI7lCI0.js";
 import "../ModalKit-CKtQ8eXW.js";

package/dist/analytics/analytics-provider.d.ts

@@ -1,4 +1,4 @@
-import { AnalyticsEvent, AnalyticsProvider, IdentifyEvent } from "../CommandKit-CEFWQpDo.js";
+import { AnalyticsEvent, AnalyticsProvider, IdentifyEvent } from "../CommandKit-VTym8VA2.js";
 import "../EventInterceptor-D_oEWSnF.js";
 import "../ButtonKit-BSI7lCI0.js";
 import "../ModalKit-CKtQ8eXW.js";

package/dist/app/commands/AppCommandRunner.d.ts

@@ -1,4 +1,4 @@
-import { AppCommandRunner } from "../../CommandKit-CEFWQpDo.js";
+import { AppCommandRunner } from "../../CommandKit-VTym8VA2.js";
 import "../../EventInterceptor-D_oEWSnF.js";
 import "../../ButtonKit-BSI7lCI0.js";
 import "../../ModalKit-CKtQ8eXW.js";

package/dist/app/commands/Context.d.ts

@@ -1,4 +1,4 @@
-import { AnyCommandExecute, AutocompleteCommand, AutocompleteCommandContext, AutocompleteCommandMiddlewareContext, ChatInputCommand, ChatInputCommandContext, CommandContextOptions, CommandExecutionMode, Context, ContextParameters, InteractionCommandContext, InteractionCommandMiddlewareContext, MessageCommand, MessageCommandContext, MessageCommandMiddlewareContext, MessageContextMenuCommand, MessageContextMenuCommandContext, MessageContextMenuCommandMiddlewareContext, MiddlewareContext, MiddlewareContextArgs, SlashCommandMiddlewareContext, UserContextMenuCommand, UserContextMenuCommandContext, UserContextMenuCommandMiddlewareContext } from "../../CommandKit-CEFWQpDo.js";
+import { AnyCommandExecute, AutocompleteCommand, AutocompleteCommandContext, AutocompleteCommandMiddlewareContext, ChatInputCommand, ChatInputCommandContext, CommandContextOptions, CommandExecutionMode, Context, ContextParameters, InteractionCommandContext, InteractionCommandMiddlewareContext, MessageCommand, MessageCommandContext, MessageCommandMiddlewareContext, MessageContextMenuCommand, MessageContextMenuCommandContext, MessageContextMenuCommandMiddlewareContext, MiddlewareContext, MiddlewareContextArgs, SlashCommandMiddlewareContext, UserContextMenuCommand, UserContextMenuCommandContext, UserContextMenuCommandMiddlewareContext } from "../../CommandKit-VTym8VA2.js";
 import "../../EventInterceptor-D_oEWSnF.js";
 import "../../ButtonKit-BSI7lCI0.js";
 import "../../ModalKit-CKtQ8eXW.js";

package/dist/app/events/EventWorkerContext.d.ts

@@ -1,4 +1,4 @@
-import "../../CommandKit-CEFWQpDo.js";
+import "../../CommandKit-VTym8VA2.js";
 import "../../EventInterceptor-D_oEWSnF.js";
 import "../../ButtonKit-BSI7lCI0.js";
 import "../../ModalKit-CKtQ8eXW.js";
@@ -29,5 +29,5 @@ import "../../CommandsRouter-C7X-eXE2.js";
 import "../../EventsRouter-BacqK6z3.js";
 import "../../index-CUPkUUOR.js";
 import "../../constants-BPWSrMkn.js";
-import { EventWorkerContext, eventWorkerContext, getEventWorkerContext, isEventWorkerContext, runInEventWorkerContext } from "../../EventWorkerContext-Dk7c6sRe.js";
+import { EventWorkerContext, eventWorkerContext, getEventWorkerContext, isEventWorkerContext, runInEventWorkerContext } from "../../EventWorkerContext-BXKO7FMY.js";
 export { EventWorkerContext, eventWorkerContext, getEventWorkerContext, isEventWorkerContext, runInEventWorkerContext };

package/dist/app/handlers/AppCommandHandler.d.ts

@@ -1,4 +1,4 @@
-import { AppCommandHandler, CommandBuilderLike, CommandTypeData, LoadedCommand, PreparedAppCommandExecution, ResolvableCommand, RunCommand } from "../../CommandKit-CEFWQpDo.js";
+import { AppCommandHandler, CommandBuilderLike, CommandTypeData, LoadedCommand, PreparedAppCommandExecution, ResolvableCommand, RunCommand } from "../../CommandKit-VTym8VA2.js";
 import "../../EventInterceptor-D_oEWSnF.js";
 import "../../ButtonKit-BSI7lCI0.js";
 import "../../ModalKit-CKtQ8eXW.js";

package/dist/app/handlers/AppEventsHandler.d.ts

@@ -1,4 +1,4 @@
-import { AppEventsHandler, AppEventsHandlerLoadedData, EventListener, LoadedEvent } from "../../CommandKit-CEFWQpDo.js";
+import { AppEventsHandler, AppEventsHandlerLoadedData, EventListener, LoadedEvent } from "../../CommandKit-VTym8VA2.js";
 import "../../EventInterceptor-D_oEWSnF.js";
 import "../../ButtonKit-BSI7lCI0.js";
 import "../../ModalKit-CKtQ8eXW.js";

package/dist/app/index.d.ts

@@ -1,4 +1,4 @@
-import { AnyCommandExecute, AppCommandHandler, AutocompleteCommand, AutocompleteCommandContext, AutocompleteCommandMiddlewareContext, ChatInputCommand, ChatInputCommandContext, CommandBuilderLike, CommandContextOptions, CommandExecutionMode, CommandRegistrar, CommandTypeData, Context, ContextParameters, InteractionCommandContext, InteractionCommandMiddlewareContext, LoadedCommand, MessageCommand, MessageCommandContext, MessageCommandMiddlewareContext, MessageContextMenuCommand, MessageContextMenuCommandContext, MessageContextMenuCommandMiddlewareContext, MiddlewareContext, MiddlewareContextArgs, PreRegisterCommandsEvent, PreparedAppCommandExecution, ResolvableCommand, RunCommand, SlashCommandMiddlewareContext, UserContextMenuCommand, UserContextMenuCommandContext, UserContextMenuCommandMiddlewareContext } from "../CommandKit-CEFWQpDo.js";
+import { AnyCommandExecute, AppCommandHandler, AutocompleteCommand, AutocompleteCommandContext, AutocompleteCommandMiddlewareContext, ChatInputCommand, ChatInputCommandContext, CommandBuilderLike, CommandContextOptions, CommandExecutionMode, CommandRegistrar, CommandTypeData, Context, ContextParameters, InteractionCommandContext, InteractionCommandMiddlewareContext, LoadedCommand, MessageCommand, MessageCommandContext, MessageCommandMiddlewareContext, MessageContextMenuCommand, MessageContextMenuCommandContext, MessageContextMenuCommandMiddlewareContext, MiddlewareContext, MiddlewareContextArgs, PreRegisterCommandsEvent, PreparedAppCommandExecution, ResolvableCommand, RunCommand, SlashCommandMiddlewareContext, UserContextMenuCommand, UserContextMenuCommandContext, UserContextMenuCommandMiddlewareContext } from "../CommandKit-VTym8VA2.js";
 import "../EventInterceptor-D_oEWSnF.js";
 import "../ButtonKit-BSI7lCI0.js";
 import "../ModalKit-CKtQ8eXW.js";

package/dist/app/register/CommandRegistrar.d.ts

@@ -1,4 +1,4 @@
-import { CommandRegistrar, PreRegisterCommandsEvent } from "../../CommandKit-CEFWQpDo.js";
+import { CommandRegistrar, PreRegisterCommandsEvent } from "../../CommandKit-VTym8VA2.js";
 import "../../EventInterceptor-D_oEWSnF.js";
 import "../../ButtonKit-BSI7lCI0.js";
 import "../../ModalKit-CKtQ8eXW.js";

package/dist/cli/app-process.d.ts

@@ -1,7 +1,7 @@
-import * as child_process0 from "child_process";
+import * as child_process4 from "child_process";
 
 //#region src/cli/app-process.d.ts
-declare function createAppProcess(fileName: string, cwd: string, isDev: boolean): child_process0.ChildProcess;
+declare function createAppProcess(fileName: string, cwd: string, isDev: boolean): child_process4.ChildProcess;
 //#endregion
 export { createAppProcess };
 //# sourceMappingURL=app-process.d.ts.map

package/dist/cli/build.d.ts

@@ -1,4 +1,4 @@
-import { CompilerPlugin } from "../CommandKit-CEFWQpDo.js";
+import { CompilerPlugin } from "../CommandKit-VTym8VA2.js";
 import "../EventInterceptor-D_oEWSnF.js";
 import "../ButtonKit-BSI7lCI0.js";
 import "../ModalKit-CKtQ8eXW.js";

package/dist/cli/common.d.ts

@@ -1,4 +1,4 @@
-import "../CommandKit-CEFWQpDo.js";
+import "../CommandKit-VTym8VA2.js";
 import "../EventInterceptor-D_oEWSnF.js";
 import "../ButtonKit-BSI7lCI0.js";
 import "../ModalKit-CKtQ8eXW.js";
@@ -29,9 +29,9 @@ import "../CommandsRouter-C7X-eXE2.js";
 import "../EventsRouter-BacqK6z3.js";
 import "../index-CUPkUUOR.js";
 import "../constants-BPWSrMkn.js";
-import "../types-DFaFI0H7.js";
-import { ResolvedCommandKitConfig } from "../utils-DOSJ2rn3.js";
-import * as typescript1 from "typescript";
+import "../types-CICvhb0c.js";
+import { ResolvedCommandKitConfig } from "../utils-B1KWblpG.js";
+import * as typescript5 from "typescript";
 
 //#region src/cli/common.d.ts
 declare function write(message: any): void;
@@ -41,7 +41,7 @@ declare function findEntrypoint(dir: string): string;
  */
 declare function panic(message: any): never;
 declare function findPackageJSON(): any;
-declare function loadTypeScript(e?: string): Promise<typeof typescript1>;
+declare function loadTypeScript(e?: string): Promise<typeof typescript5>;
 declare function loadConfigFileFromPath(target: string): Promise<ResolvedCommandKitConfig>;
 declare function erase(dir: string): void;
 declare function copyLocaleFiles(_from: string, _to: string): Promise<void>;

package/dist/cli/information.js

@@ -1,5 +1,5 @@
 const require_chunk = require('../chunk-nOFOJqeH.js');
-const require_version = require('../version-DR9rRG__.js');
+const require_version = require('../version-CObFfDEn.js');
 const node_fs = require_chunk.__toESM(require("node:fs"));
 const node_path = require_chunk.__toESM(require("node:path"));
 const node_child_process = require_chunk.__toESM(require("node:child_process"));

package/dist/config/config.d.ts

@@ -1,4 +1,4 @@
-import "../CommandKit-CEFWQpDo.js";
+import "../CommandKit-VTym8VA2.js";
 import "../EventInterceptor-D_oEWSnF.js";
 import "../ButtonKit-BSI7lCI0.js";
 import "../ModalKit-CKtQ8eXW.js";
@@ -29,7 +29,7 @@ import "../CommandsRouter-C7X-eXE2.js";
 import "../EventsRouter-BacqK6z3.js";
 import "../index-CUPkUUOR.js";
 import "../constants-BPWSrMkn.js";
-import "../types-DFaFI0H7.js";
-import "../utils-DOSJ2rn3.js";
-import { defineConfig, getConfig } from "../config-BX3KH7XB.js";
+import "../types-CICvhb0c.js";
+import "../utils-B1KWblpG.js";
+import { defineConfig, getConfig } from "../config-aIOTA81x.js";
 export { defineConfig, getConfig };

package/dist/config/default.d.ts

@@ -1,4 +1,4 @@
-import "../CommandKit-CEFWQpDo.js";
+import "../CommandKit-VTym8VA2.js";
 import "../EventInterceptor-D_oEWSnF.js";
 import "../ButtonKit-BSI7lCI0.js";
 import "../ModalKit-CKtQ8eXW.js";
@@ -29,8 +29,8 @@ import "../CommandsRouter-C7X-eXE2.js";
 import "../EventsRouter-BacqK6z3.js";
 import "../index-CUPkUUOR.js";
 import "../constants-BPWSrMkn.js";
-import "../types-DFaFI0H7.js";
-import { ResolvedCommandKitConfig } from "../utils-DOSJ2rn3.js";
+import "../types-CICvhb0c.js";
+import { ResolvedCommandKitConfig } from "../utils-B1KWblpG.js";
 
 //#region src/config/default.d.ts
 declare const defaultConfig: ResolvedCommandKitConfig;

package/dist/config/loader.d.ts

@@ -1,4 +1,4 @@
-import "../CommandKit-CEFWQpDo.js";
+import "../CommandKit-VTym8VA2.js";
 import "../EventInterceptor-D_oEWSnF.js";
 import "../ButtonKit-BSI7lCI0.js";
 import "../ModalKit-CKtQ8eXW.js";
@@ -29,8 +29,8 @@ import "../CommandsRouter-C7X-eXE2.js";
 import "../EventsRouter-BacqK6z3.js";
 import "../index-CUPkUUOR.js";
 import "../constants-BPWSrMkn.js";
-import { CommandKitConfig } from "../types-DFaFI0H7.js";
-import { DeepRequired } from "../utils-DOSJ2rn3.js";
+import { CommandKitConfig } from "../types-CICvhb0c.js";
+import { DeepRequired } from "../utils-B1KWblpG.js";
 
 //#region src/config/loader.d.ts
 declare function getPossibleConfigPaths(root: string): string[];

package/dist/config/types.d.ts

@@ -1,4 +1,4 @@
-import "../CommandKit-CEFWQpDo.js";
+import "../CommandKit-VTym8VA2.js";
 import "../EventInterceptor-D_oEWSnF.js";
 import "../ButtonKit-BSI7lCI0.js";
 import "../ModalKit-CKtQ8eXW.js";
@@ -29,5 +29,5 @@ import "../CommandsRouter-C7X-eXE2.js";
 import "../EventsRouter-BacqK6z3.js";
 import "../index-CUPkUUOR.js";
 import "../constants-BPWSrMkn.js";
-import { CommandKitConfig } from "../types-DFaFI0H7.js";
+import { CommandKitConfig } from "../types-CICvhb0c.js";
 export { CommandKitConfig };

package/dist/config/utils.d.ts

@@ -1,4 +1,4 @@
-import "../CommandKit-CEFWQpDo.js";
+import "../CommandKit-VTym8VA2.js";
 import "../EventInterceptor-D_oEWSnF.js";
 import "../ButtonKit-BSI7lCI0.js";
 import "../ModalKit-CKtQ8eXW.js";
@@ -29,6 +29,6 @@ import "../CommandsRouter-C7X-eXE2.js";
 import "../EventsRouter-BacqK6z3.js";
 import "../index-CUPkUUOR.js";
 import "../constants-BPWSrMkn.js";
-import "../types-DFaFI0H7.js";
-import { DeepPartial, DeepRequired, ResolvedCommandKitConfig, mergeDeep } from "../utils-DOSJ2rn3.js";
+import "../types-CICvhb0c.js";
+import { DeepPartial, DeepRequired, ResolvedCommandKitConfig, mergeDeep } from "../utils-B1KWblpG.js";
 export { DeepPartial, DeepRequired, ResolvedCommandKitConfig, mergeDeep };

package/dist/{config-BX3KH7XB.d.ts → config-aIOTA81x.d.ts}

@@ -1,5 +1,5 @@
-import { CommandKitConfig } from "./types-DFaFI0H7.js";
-import { ResolvedCommandKitConfig } from "./utils-DOSJ2rn3.js";
+import { CommandKitConfig } from "./types-CICvhb0c.js";
+import { ResolvedCommandKitConfig } from "./utils-B1KWblpG.js";
 
 //#region src/config/config.d.ts
 
@@ -14,4 +14,4 @@ declare function getConfig(): ResolvedCommandKitConfig;
 declare function defineConfig(config?: Partial<CommandKitConfig>): ResolvedCommandKitConfig;
 //#endregion
 export { defineConfig, getConfig };
-//# sourceMappingURL=config-BX3KH7XB.d.ts.map
+//# sourceMappingURL=config-aIOTA81x.d.ts.map

package/dist/context/async-context.d.ts

@@ -1,4 +1,4 @@
-import { AsyncFunction, GenericFunction, exitContext, getCommandKit, getContext, isCommandWorkerContext, makeContextAwareFunction, provideContext, useEnvironment } from "../CommandKit-CEFWQpDo.js";
+import { AsyncFunction, GenericFunction, exitContext, getCommandKit, getContext, isCommandWorkerContext, makeContextAwareFunction, provideContext, useEnvironment } from "../CommandKit-VTym8VA2.js";
 import "../EventInterceptor-D_oEWSnF.js";
 import "../ButtonKit-BSI7lCI0.js";
 import "../ModalKit-CKtQ8eXW.js";

package/dist/context/environment.d.ts

@@ -1,4 +1,4 @@
-import { CommandKitEnvironment, CommandKitEnvironmentInternalData, CommandKitEnvironmentType, after, cancelAfter } from "../CommandKit-CEFWQpDo.js";
+import { CommandKitEnvironment, CommandKitEnvironmentInternalData, CommandKitEnvironmentType, after, cancelAfter } from "../CommandKit-VTym8VA2.js";
 import "../EventInterceptor-D_oEWSnF.js";
 import "../ButtonKit-BSI7lCI0.js";
 import "../ModalKit-CKtQ8eXW.js";

package/dist/events/CommandKitEventsChannel.d.ts

@@ -1,4 +1,4 @@
-import { CommandKitEventsChannel, ListenerFunction } from "../CommandKit-CEFWQpDo.js";
+import { CommandKitEventsChannel, ListenerFunction } from "../CommandKit-VTym8VA2.js";
 import "../EventInterceptor-D_oEWSnF.js";
 import "../ButtonKit-BSI7lCI0.js";
 import "../ModalKit-CKtQ8eXW.js";

package/dist/{feature-flags-DJi3gEFN.js → feature-flags-BFiGn38a.js}

@@ -3,8 +3,22 @@ const require_EventWorkerContext = require('./EventWorkerContext-BAKiTqJz.js');
 const require_constants = require('./constants-DWe181uQ.js');
 
 //#region src/flags/feature-flags.ts
+let flagProvider = null;
+/**
+* Set the global flag provider for all feature flags
+*/
+function setFlagProvider(provider) {
+	flagProvider = provider;
+}
+/**
+* Class representing a feature flag in CommandKit.
+*/
 var FeatureFlag = class {
 	commandkit;
+	/**
+	* Create a new feature flag.
+	* @param options - The options for the feature flag.
+	*/
 	constructor(options) {
 		this.options = options;
 		this.commandkit = require_CommandKit.getCommandKit(true);
@@ -50,40 +64,73 @@ var FeatureFlag = class {
 		}
 		throw new Error("Could not determine the execution context. Feature flags may only be used inside a command or event.");
 	}
+	/**
+	* Execute the feature flag evaluation.
+	* @param res - Optional entities to use for evaluation. If not provided, it will call the identify function.
+	* @returns A promise that resolves to the result of the feature flag evaluation.
+	*/
 	async execute(res) {
-		const { decide, identify } = this.options;
+		const { decide, identify, disableAnalytics } = this.options;
 		const identificationStart = performance.now();
 		const entities = res ?? await (async () => {
 			const ctx = this.getContext();
 			return await (identify === null || identify === void 0 ? void 0 : identify(ctx)) ?? {};
 		})();
 		const identificationTime = performance.now() - identificationStart;
+		let providerConfig = null;
+		if (flagProvider) try {
+			providerConfig = await flagProvider.getFlag(this.options.key, entities);
+			if (providerConfig && !providerConfig.enabled) {
+				if (typeof decide === "function") {
+					const decisionResult$1 = await decide({
+						entities,
+						provider: providerConfig
+					});
+					return decisionResult$1;
+				}
+			}
+		} catch (error) {
+			require_CommandKit.Logger.error(`Error fetching flag provider configuration for "${this.options.key}": ${error}`);
+		}
 		const decisionStart = performance.now();
-		const decisionResult = await decide({ entities });
+		const decisionResult = await decide({
+			entities,
+			provider: providerConfig
+		});
 		const decisionTime = performance.now() - decisionStart;
-		require_CommandKit.defer(async () => {
-			await this.commandkit.analytics.track({
-				name: require_constants.AnalyticsEvents.FEATURE_FLAG_METRICS,
-				data: {
-					flag: this.options.key,
-					identificationTime: identificationTime.toFixed(2),
-					decisionTime: decisionTime.toFixed(2)
-				}
+		if (!disableAnalytics) {
+			require_CommandKit.defer(async () => {
+				await this.commandkit.analytics.track({
+					name: require_constants.AnalyticsEvents.FEATURE_FLAG_METRICS,
+					data: {
+						flag: this.options.key,
+						identificationTime: identificationTime.toFixed(2),
+						decisionTime: decisionTime.toFixed(2),
+						usedProvider: flagProvider !== null,
+						providerEnabled: (providerConfig === null || providerConfig === void 0 ? void 0 : providerConfig.enabled) ?? null
+					}
+				});
 			});
-		});
-		require_CommandKit.defer(async () => {
-			await this.commandkit.analytics.track({
-				name: require_constants.AnalyticsEvents.FEATURE_FLAG_DECISION,
-				id: entities && typeof entities === "object" && "id" in entities && typeof entities.id === "string" ? entities.id : void 0,
-				data: {
-					flag: this.options.key,
-					decision: require_CommandKit.JsonSerialize(decisionResult, "unknown")
-				}
+			require_CommandKit.defer(async () => {
+				await this.commandkit.analytics.track({
+					name: require_constants.AnalyticsEvents.FEATURE_FLAG_DECISION,
+					id: entities && typeof entities === "object" && "id" in entities && typeof entities.id === "string" ? entities.id : void 0,
+					data: {
+						flag: this.options.key,
+						decision: require_CommandKit.JsonSerialize(decisionResult, "unknown"),
+						providerUsed: flagProvider !== null
+					}
+				});
 			});
-		});
+		}
 		return decisionResult;
 	}
 };
+/**
+* Create a new feature flag.
+* @param options - The options for the feature flag.
+* @returns A new instance of the FeatureFlag class.
+*/
 function flag(options) {
 	const flag$1 = new FeatureFlag(options);
 	const runner = flag$1.execute.bind(flag$1, void 0);
@@ -109,4 +156,10 @@ Object.defineProperty(exports, 'flag', {
     return flag;
   }
 });
-//# sourceMappingURL=feature-flags-DJi3gEFN.js.map
+Object.defineProperty(exports, 'setFlagProvider', {
+  enumerable: true,
+  get: function () {
+    return setFlagProvider;
+  }
+});
+//# sourceMappingURL=feature-flags-BFiGn38a.js.map

package/dist/feature-flags-BFiGn38a.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flags-BFiGn38a.js","names":[],"sources":["../src/flags/feature-flags.ts"],"sourcesContent":["import { getCommandKit, getContext } from '../context/async-context';\nimport { eventWorkerContext } from '../app/events/EventWorkerContext';\nimport { ParsedEvent } from '../app/router';\nimport { CommandKit } from '../CommandKit';\nimport {\n  AutocompleteInteraction,\n  ChatInputCommandInteraction,\n  Client,\n  ClientEvents,\n  ContextMenuCommandInteraction,\n  Guild,\n  Message,\n  TextBasedChannel,\n} from 'discord.js';\nimport { LoadedCommand } from '../app';\nimport { defer, JsonSerialize } from '../utils/utilities';\nimport { AnalyticsEvents } from '../analytics/constants';\nimport { FlagProvider, FlagConfiguration } from './FlagProvider';\nimport { Logger } from '../logger/Logger';\n\n// Global flag provider\nlet flagProvider: FlagProvider | null = null;\n\n/**\n * Set the global flag provider for all feature flags\n */\nexport function setFlagProvider(provider: FlagProvider): void {\n  flagProvider = provider;\n}\n\nexport type MaybePromise<T> = T | Promise<T>;\n\n/**\n * Function type for identifying entities in the context of feature flags.\n * This function should return an object representing the entity that will be used\n * to evaluate the feature flag.\n * It can be synchronous or asynchronous.\n */\nexport type IdentifyFunction<R> = (\n  context: EvaluationContext,\n) => MaybePromise<R>;\n\n/**\n * Function type for deciding the outcome of a feature flag based on the provided entities.\n * This function receives an object containing the entities and optionally the provider configuration,\n * and should return the result of the decision.\n * It can be synchronous or asynchronous.\n */\nexport type DecideFunction<E, R> = (data: {\n  entities: E;\n  provider?: FlagConfiguration | null;\n}) => MaybePromise<R>;\n\n/**\n * Definition for a feature flag, including its key, description, identify function,\n * and decide function.\n * The identify function is used to determine the entities that will be evaluated\n * against the feature flag, while the decide function contains the logic for\n * determining the outcome of the flag based on those entities.\n */\nexport interface FeatureFlagDefinition<R, Entity> {\n  /**\n   * Unique key for the feature flag.\n   * Should be a string that identifies the flag.\n   */\n  key: string;\n  /**\n   * Optional description of the feature flag.\n   * This can be used for documentation or debugging purposes.\n   */\n  description?: string;\n  /**\n   * Optional flag to enable integration with an external flag provider.\n   * If true, the flag will use the global flag provider to determine its state.\n   * Default: false\n   */\n  identify?: IdentifyFunction<Entity>;\n  /**\n   * Function to decide the outcome of the feature flag.\n   * This function receives the identified entities and should return the result of the decision.\n   */\n  decide: DecideFunction<Entity, R>;\n  /**\n   * Whether to disable analytics tracking for this flag.\n   * Default: false\n   */\n  disableAnalytics?: boolean;\n}\n\nexport interface CommandFlagContext {\n  /**\n   * The Discord client instance.\n   * This is the main entry point for interacting with the Discord API.\n   */\n  client: Client<true>;\n  /**\n   * The CommandKit instance, which provides access to the command framework.\n   * This includes commands, events, and other features of CommandKit.\n   */\n  commandkit: CommandKit;\n  /**\n   * The command context, which includes information about the command being executed.\n   * This can include the interaction, message, guild, channel, and the loaded command.\n   */\n  command: {\n    /**\n     * The interaction object if the command was invoked via an interaction.\n     * This can be a ChatInputCommandInteraction, AutocompleteInteraction, or ContextMenuCommandInteraction.\n     */\n    interaction?:\n      | ChatInputCommandInteraction\n      | AutocompleteInteraction\n      | ContextMenuCommandInteraction;\n    /**\n     * The message object if the command was invoked via a message.\n     */\n    message?: Message;\n    /**\n     * The guild where the command was invoked, if applicable.\n     * This will be null for commands invoked in DMs.\n     */\n    guild: Guild | null;\n    /**\n     * The channel where the command was invoked.\n     * This can be a text channel, DM channel, or any other type of text-based channel.\n     */\n    channel: TextBasedChannel | null;\n    /**\n     * The loaded command instance that is being executed.\n     * This contains the command's metadata and logic.\n     */\n    command: LoadedCommand;\n  };\n  /**\n   * The event context is null for command flags, as they are not tied to a specific event.\n   * This is used to differentiate between command and event flags.\n   */\n  event: null;\n}\n\nexport interface EventFlagContext {\n  /**\n   * The Discord client instance.\n   * This is the main entry point for interacting with the Discord API.\n   */\n  client: Client<true>;\n  /**\n   * The CommandKit instance, which provides access to the command framework.\n   * This includes commands, events, and other features of CommandKit.\n   */\n  commandkit: CommandKit;\n  /**\n   * The event context, which includes information about the event being processed.\n   * This can include the parsed event data, the event name, and the namespace if applicable.\n   */\n  event: {\n    /**\n     * The parsed event data, which contains the raw data from the event.\n     * This can include information like user IDs, channel IDs, and other relevant data.\n     */\n    data: ParsedEvent;\n    /**\n     * The name of the event being processed.\n     * This is the string identifier for the event, such as 'messageCreate' or 'guildMemberAdd'.\n     */\n    event: string;\n    /**\n     * The namespace of the event, if applicable.\n     * This can be used to group related events or commands together.\n     * It is null if the event does not belong to a specific namespace.\n     */\n    namespace: string | null;\n    /**\n     * The arguments passed to the event handler.\n     * This is an array of arguments that were passed when the event was triggered.\n     * It can be used to access specific data related to the event.\n     */\n    arguments: any[];\n    /**\n     * A function to retrieve the arguments for a specific event type.\n     * This allows for type-safe access to the arguments based on the event name.\n     * @param event - The name of the event to retrieve arguments for.\n     */\n    argumentsAs<E extends keyof ClientEvents>(event: E): ClientEvents[E];\n  };\n  /**\n   * The command context is null for event flags, as they are not tied to a specific command.\n   * This is used to differentiate between command and event flags.\n   */\n  command: null;\n}\n\n/**\n * Combined context type for feature flag evaluation.\n */\nexport type EvaluationContext = CommandFlagContext | EventFlagContext;\n\n/**\n * Function type for custom evaluation of feature flags.\n * This function can be used to provide a custom evaluation context for the flag.\n * It should return an object representing the entities to be evaluated.\n */\nexport type CustomEvaluationFunction<E> = () => MaybePromise<E>;\n\n/**\n * Context for custom evaluation of feature flags.\n * This allows for more flexible evaluation based on custom logic or external data.\n * The identify function can be a direct object or a function that returns the entities.\n */\nexport type CustomEvaluationContext<E> = {\n  /**\n   * Optional function to identify the entities for evaluation.\n   * This can be a function that returns the entities based on the current context.\n   */\n  identify: E | CustomEvaluationFunction<E>;\n};\n\nexport interface FlagRunner<E, R> {\n  /**\n   * Execute the feature flag evaluation with the provided entities.\n   * This method will run the identify and decide functions to determine the flag's outcome.\n   * @param res - Optional entities to use for evaluation. If not provided, it will call the identify function.\n   * @returns A promise that resolves to the result of the feature flag evaluation.\n   */\n  (): Promise<R>;\n  /**\n   * Run the feature flag evaluation with a custom context.\n   * This allows for more flexible evaluation based on custom logic or external data.\n   * @param context - The custom evaluation context containing the identify function or object.\n   * @returns A promise that resolves to the result of the feature flag evaluation.\n   */\n  run(context: CustomEvaluationContext<E>): Promise<R>;\n}\n\n/**\n * Class representing a feature flag in CommandKit.\n */\nexport class FeatureFlag<R, T> {\n  private commandkit: CommandKit;\n\n  /**\n   * Create a new feature flag.\n   * @param options - The options for the feature flag.\n   */\n  public constructor(public readonly options: FeatureFlagDefinition<R, T>) {\n    this.commandkit = getCommandKit(true);\n    const FlagStore = this.commandkit.flags;\n\n    if (FlagStore.has(options.key)) {\n      throw new Error(`Feature flag with key \"${options.key}\" already exists.`);\n    }\n\n    FlagStore.set(options.key, this);\n  }\n\n  private getContext(): EvaluationContext {\n    const env = getContext();\n\n    if (env?.context) {\n      const {\n        client,\n        commandkit,\n        interaction,\n        message,\n        guild,\n        channel,\n        command,\n      } = env.context;\n\n      return {\n        client: client as Client<true>,\n        commandkit,\n        command: {\n          interaction,\n          message,\n          guild,\n          channel,\n          command,\n        },\n        event: null,\n      };\n    }\n\n    const eventCtx = eventWorkerContext.getStore();\n\n    if (eventCtx) {\n      const { commandkit, data, event, namespace } = eventCtx;\n\n      return {\n        client: commandkit.client as Client<true>,\n        commandkit,\n        event: {\n          data,\n          event,\n          namespace,\n          arguments: eventCtx.arguments,\n          argumentsAs: (eventName) => {\n            const args = eventCtx.arguments as ClientEvents[typeof eventName];\n            return args;\n          },\n        },\n        command: null,\n      };\n    }\n\n    throw new Error(\n      'Could not determine the execution context. Feature flags may only be used inside a command or event.',\n    );\n  }\n\n  /**\n   * Execute the feature flag evaluation.\n   * @param res - Optional entities to use for evaluation. If not provided, it will call the identify function.\n   * @returns A promise that resolves to the result of the feature flag evaluation.\n   */\n  public async execute(res?: T): Promise<R> {\n    const { decide, identify, disableAnalytics } = this.options;\n\n    const identificationStart = performance.now();\n    const entities =\n      res ??\n      (await (async () => {\n        const ctx = this.getContext();\n        return (await identify?.(ctx)) ?? ({} as T);\n      })());\n    const identificationTime = performance.now() - identificationStart;\n\n    // Get provider configuration if global provider is available\n    let providerConfig: FlagConfiguration | null = null;\n    if (flagProvider) {\n      try {\n        providerConfig = await flagProvider.getFlag(this.options.key, entities);\n\n        // If provider says flag is disabled, return early with default behavior\n        if (providerConfig && !providerConfig.enabled) {\n          // For boolean flags, return false; for others, let decide function handle it\n          if (typeof decide === 'function') {\n            const decisionResult = await decide({\n              entities,\n              provider: providerConfig,\n            });\n            return decisionResult as R;\n          }\n        }\n      } catch (error) {\n        Logger.error(\n          `Error fetching flag provider configuration for \"${this.options.key}\": ${error}`,\n        );\n        // continue with local decision if provider fails\n      }\n    }\n\n    const decisionStart = performance.now();\n    const decisionResult = await decide({\n      entities,\n      provider: providerConfig,\n    });\n    const decisionTime = performance.now() - decisionStart;\n\n    // Skip analytics if disabled\n    if (!disableAnalytics) {\n      defer(async () => {\n        await this.commandkit.analytics.track({\n          name: AnalyticsEvents.FEATURE_FLAG_METRICS,\n          data: {\n            flag: this.options.key,\n            identificationTime: identificationTime.toFixed(2),\n            decisionTime: decisionTime.toFixed(2),\n            usedProvider: flagProvider !== null,\n            providerEnabled: providerConfig?.enabled ?? null,\n          },\n        });\n      });\n\n      defer(async () => {\n        await this.commandkit.analytics.track({\n          name: AnalyticsEvents.FEATURE_FLAG_DECISION,\n          id:\n            entities &&\n            typeof entities === 'object' &&\n            'id' in entities &&\n            typeof entities.id === 'string'\n              ? entities.id\n              : undefined,\n          data: {\n            flag: this.options.key,\n            decision: JsonSerialize(decisionResult, 'unknown'),\n            providerUsed: flagProvider !== null,\n          },\n        });\n      });\n    }\n\n    return decisionResult as R;\n  }\n}\n\n/**\n * Create a new feature flag.\n * @param options - The options for the feature flag.\n * @returns A new instance of the FeatureFlag class.\n */\nexport function flag<Returns = boolean, Entity = Record<any, any>>(\n  options: FeatureFlagDefinition<Returns, Entity>,\n): FlagRunner<Entity, Returns> {\n  const flag = new FeatureFlag<Returns, Entity>(options);\n  const runner = flag.execute.bind(flag, undefined) as FlagRunner<\n    Entity,\n    Returns\n  >;\n\n  runner.run = async function (ctx) {\n    if (!ctx?.identify) {\n      throw new Error(\n        'Custom evaluation context must have an identify function or object.',\n      );\n    }\n\n    const context = (\n      typeof ctx === 'function'\n        ? await (ctx as CustomEvaluationFunction<Entity>)()\n        : ctx\n    ) as Entity;\n\n    const decisionResult = await flag.execute(context);\n\n    return decisionResult;\n  };\n\n  return runner;\n}\n"],"mappings":";;;;;AAqBA,IAAI,eAAoC;;;;AAKxC,SAAgB,gBAAgB,UAA8B;AAC5D,gBAAe;AACjB;;;;AAiNA,IAAa,cAAb,MAA+B;CAC7B,AAAQ;;;;;CAMR,AAAO,YAA4B,SAAsC;EAAtC;AACjC,OAAK,aAAa,iCAAc,KAAK;EACrC,MAAM,YAAY,KAAK,WAAW;AAElC,MAAI,UAAU,IAAI,QAAQ,IAAI,CAC5B,OAAM,IAAI,OAAO,yBAAyB,QAAQ,IAAI;AAGxD,YAAU,IAAI,QAAQ,KAAK,KAAK;CAClC;CAEA,AAAQ,aAAgC;EACtC,MAAM,MAAM,+BAAY;AAExB,gDAAI,IAAK,SAAS;GAChB,MAAM,EACJ,QACA,YACA,aACA,SACA,OACA,SACA,SACD,GAAG,IAAI;AAER,UAAO;IACG;IACR;IACA,SAAS;KACP;KACA;KACA;KACA;KACA;IACD;IACD,OAAO;GACR;EACH;EAEA,MAAM,WAAW,8CAAmB,UAAU;AAE9C,MAAI,UAAU;GACZ,MAAM,EAAE,YAAY,MAAM,OAAO,WAAW,GAAG;AAE/C,UAAO;IACL,QAAQ,WAAW;IACnB;IACA,OAAO;KACL;KACA;KACA;KACA,WAAW,SAAS;KACpB,aAAa,CAAC,cAAc;MAC1B,MAAM,OAAO,SAAS;AACtB,aAAO;KACR;IACF;IACD,SAAS;GACV;EACH;AAEA,QAAM,IAAI,MACR;CAEJ;;;;;;CAOA,MAAa,QAAQ,KAAqB;EACxC,MAAM,EAAE,QAAQ,UAAU,kBAAkB,GAAG,KAAK;EAEpD,MAAM,sBAAsB,YAAY,KAAK;EAC7C,MAAM,WACN,OACA,MAAM,CAAC,YAAY;GACjB,MAAM,MAAM,KAAK,YAAY;AAC7B,UAAQ,2DAAM,SAAW,IAAI,KAAK,CAAE;EACrC,IAAG;EACJ,MAAM,qBAAqB,YAAY,KAAK,GAAG;EAG/C,IAAI,iBAA2C;AAC/C,MAAI,aACF,KAAI;AACF,oBAAiB,MAAM,aAAa,QAAQ,KAAK,QAAQ,KAAK,SAAS;AAGvE,OAAI,mBAAmB,eAAe,SAEpC;eAAW,WAAW,YAAY;KAChC,MAAM,mBAAiB,MAAM,OAAO;MAClC;MACA,UAAU;KACX,EAAC;AACF,YAAO;IACT;;EAEH,SAAQ,OAAO;AACd,6BAAO,OACJ,kDAAkD,KAAK,QAAQ,IAAI,KAAK,MAAM,EAChF;EAEH;EAGF,MAAM,gBAAgB,YAAY,KAAK;EACvC,MAAM,iBAAiB,MAAM,OAAO;GAClC;GACA,UAAU;EACX,EAAC;EACF,MAAM,eAAe,YAAY,KAAK,GAAG;AAGzC,OAAK,kBAAkB;AACrB,4BAAM,YAAY;AAChB,UAAM,KAAK,WAAW,UAAU,MAAM;KACpC,MAAM,kCAAgB;KACtB,MAAM;MACJ,MAAM,KAAK,QAAQ;MACnB,oBAAoB,mBAAmB,QAAQ,EAAE;MACjD,cAAc,aAAa,QAAQ,EAAE;MACrC,cAAc,iBAAiB;MAC/B,kFAAiB,eAAgB,YAAW;KAC7C;IACF,EAAC;GACH,EAAC;AAEF,4BAAM,YAAY;AAChB,UAAM,KAAK,WAAW,UAAU,MAAM;KACpC,MAAM,kCAAgB;KACtB,IACA,mBACO,aAAa,YACpB,QAAQ,mBACD,SAAS,OAAO,WACvB,SAAS;KAET,MAAM;MACJ,MAAM,KAAK,QAAQ;MACnB,UAAU,iCAAc,gBAAgB,UAAU;MAClD,cAAc,iBAAiB;KAChC;IACF,EAAC;GACH,EAAC;EACJ;AAEA,SAAO;CACT;AACF;;;;;;AAOA,SAAgB,KAChB,SAC8B;CAC5B,MAAM,SAAO,IAAI,YAA6B;CAC9C,MAAM,SAAS,OAAK,QAAQ,KAAK,eAAgB;AAKjD,QAAO,MAAM,eAAgB,KAAK;AAChC,kDAAK,IAAK,UACR,OAAM,IAAI,MACR;EAIJ,MAAM,iBACC,QAAQ,aACf,MAAM,AAAC,KAA0C,GACjD;EAGA,MAAM,iBAAiB,MAAM,OAAK,QAAQ,QAAQ;AAElD,SAAO;CACR;AAED,QAAO;AACT"}

package/dist/flags/FlagProvider.d.ts

@@ -0,0 +1,32 @@
+import { FlagConfiguration, FlagProvider, JsonFlagProvider } from "../CommandKit-VTym8VA2.js";
+import "../EventInterceptor-D_oEWSnF.js";
+import "../ButtonKit-BSI7lCI0.js";
+import "../ModalKit-CKtQ8eXW.js";
+import "../element-D_nyVwgB.js";
+import "../ActionRow-D0wafJhZ.js";
+import "../types-CJ-XvOFN.js";
+import "../Button-Bl5nbwTS.js";
+import "../Modal-Cxm6cs5c.js";
+import "../common-pvPJVTfe.js";
+import "../StringSelectMenuKit-B9FHTe48.js";
+import "../ChannelSelectMenuKit-L15A2jpT.js";
+import "../MentionableSelectMenuKit-BiUSKUtZ.js";
+import "../UserSelectMenuKit-DiP0imyo.js";
+import "../RoleSelectMenuKit-BSMKkru2.js";
+import "../SelectMenu-b7jgrkjO.js";
+import "../container-CwEATQy2.js";
+import "../file-BdyYwkaI.js";
+import "../media-gallery-DCu02VXc.js";
+import "../section-fktaECHL.js";
+import "../separator-CuesaLrC.js";
+import "../text-display-DNMwmGHJ.js";
+import "../index-Dw5cCt-A.js";
+import "../index-E7Wvm5uX.js";
+import "../MessageCommandParser-tzroBwij.js";
+import "../signals-DUoWkeZ7.js";
+import "../helpers-DAmE106r.js";
+import "../CommandsRouter-C7X-eXE2.js";
+import "../EventsRouter-BacqK6z3.js";
+import "../index-CUPkUUOR.js";
+import "../constants-BPWSrMkn.js";
+export { FlagConfiguration, FlagProvider, JsonFlagProvider };

package/dist/flags/FlagProvider.js

@@ -0,0 +1,27 @@
+
+//#region src/flags/FlagProvider.ts
+/**
+* Example implementation for a simple JSON-based flag provider
+*/
+var JsonFlagProvider = class {
+	flags = /* @__PURE__ */ new Map();
+	constructor(config) {
+		this.config = config;
+		Object.entries(config).forEach(([key, value]) => {
+			this.flags.set(key, value);
+		});
+	}
+	async getFlag(key) {
+		return this.flags.get(key) || null;
+	}
+	async hasFlag(key) {
+		return this.flags.has(key);
+	}
+	async destroy() {
+		this.flags.clear();
+	}
+};
+
+//#endregion
+exports.JsonFlagProvider = JsonFlagProvider;
+//# sourceMappingURL=FlagProvider.js.map

package/dist/flags/FlagProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlagProvider.js","names":[],"sources":["../../src/flags/FlagProvider.ts"],"sourcesContent":["import type { MaybePromise } from './feature-flags';\n\n/**\n * Interface for external feature flag providers.\n * Implement this interface to integrate with external flag management systems\n * like LaunchDarkly, Split, Unleash, etc.\n */\nexport interface FlagProvider {\n  /**\n   * Initialize the provider (e.g., establish connections, load initial config)\n   */\n  initialize?(): MaybePromise<void>;\n\n  /**\n   * Get the current value/configuration for a feature flag\n   * @param key - The feature flag key\n   * @param context - Optional context for flag evaluation\n   * @returns The flag configuration or null if not found\n   */\n  getFlag(key: string, context?: any): MaybePromise<FlagConfiguration | null>;\n\n  /**\n   * Check if a flag exists in the external system\n   * @param key - The feature flag key\n   */\n  hasFlag(key: string): MaybePromise<boolean>;\n\n  /**\n   * Cleanup resources when the provider is no longer needed\n   */\n  destroy?(): MaybePromise<void>;\n}\n\n/**\n * Configuration returned by external flag providers\n */\nexport interface FlagConfiguration {\n  /**\n   * Whether the flag is enabled/disabled at the provider level\n   */\n  enabled: boolean;\n\n  /**\n   * Optional configuration data that can be used in the decide function\n   */\n  config?: Record<string, any>;\n\n  /**\n   * Optional percentage for gradual rollouts (0-100)\n   */\n  percentage?: number;\n\n  /**\n   * Optional targeting rules or segments\n   */\n  targeting?: {\n    segments?: string[];\n    rules?: Array<{\n      condition: string;\n      value: any;\n    }>;\n  };\n}\n\n/**\n * Example implementation for a simple JSON-based flag provider\n */\nexport class JsonFlagProvider implements FlagProvider {\n  private flags: Map<string, FlagConfiguration> = new Map();\n\n  public constructor(private config: Record<string, FlagConfiguration>) {\n    Object.entries(config).forEach(([key, value]) => {\n      this.flags.set(key, value);\n    });\n  }\n\n  public async getFlag(key: string): Promise<FlagConfiguration | null> {\n    return this.flags.get(key) || null;\n  }\n\n  public async hasFlag(key: string): Promise<boolean> {\n    return this.flags.has(key);\n  }\n\n  public async destroy(): Promise<void> {\n    this.flags.clear();\n  }\n}\n"],"mappings":";;;;;AAmEA,IAAa,mBAAb,MAAsD;CACpD,AAAQ,wBAAwC,IAAI;CAEpD,AAAO,YAAoB,QAA2C;EAA3C;AACzB,SAAO,QAAQ,OAAO,CAAC,QAAQ,CAAC,CAAC,KAAK,MAAM,KAAK;AAC/C,QAAK,MAAM,IAAI,KAAK,MAAM;EAC3B,EAAC;CACJ;CAEA,MAAa,QAAQ,KAAgD;AACnE,SAAO,KAAK,MAAM,IAAI,IAAI,IAAI;CAChC;CAEA,MAAa,QAAQ,KAA+B;AAClD,SAAO,KAAK,MAAM,IAAI,IAAI;CAC5B;CAEA,MAAa,UAAyB;AACpC,OAAK,MAAM,OAAO;CACpB;AACF"}

package/dist/flags/feature-flags.d.ts

@@ -1,4 +1,4 @@
-import { CommandFlagContext, CustomEvaluationContext, CustomEvaluationFunction, DecideFunction, EvaluationContext, EventFlagContext, FeatureFlag, FeatureFlagDefinition, FlagRunner, IdentifyFunction, MaybePromise, flag } from "../CommandKit-CEFWQpDo.js";
+import { CommandFlagContext, CustomEvaluationContext, CustomEvaluationFunction, DecideFunction, EvaluationContext, EventFlagContext, FeatureFlag, FeatureFlagDefinition, FlagRunner, IdentifyFunction, MaybePromise, flag, setFlagProvider } from "../CommandKit-VTym8VA2.js";
 import "../EventInterceptor-D_oEWSnF.js";
 import "../ButtonKit-BSI7lCI0.js";
 import "../ModalKit-CKtQ8eXW.js";
@@ -29,4 +29,4 @@ import "../CommandsRouter-C7X-eXE2.js";
 import "../EventsRouter-BacqK6z3.js";
 import "../index-CUPkUUOR.js";
 import "../constants-BPWSrMkn.js";
-export { CommandFlagContext, CustomEvaluationContext, CustomEvaluationFunction, DecideFunction, EvaluationContext, EventFlagContext, FeatureFlag, FeatureFlagDefinition, FlagRunner, IdentifyFunction, MaybePromise, flag };
+export { CommandFlagContext, CustomEvaluationContext, CustomEvaluationFunction, DecideFunction, EvaluationContext, EventFlagContext, FeatureFlag, FeatureFlagDefinition, FlagRunner, IdentifyFunction, MaybePromise, flag, setFlagProvider };

package/dist/flags/feature-flags.js

@@ -34,7 +34,8 @@ require('../router-Dn35v30f.js');
 require('../common-CW8v7gAn.js');
 require('../CommandKitEventsChannel-B6LKgxmv.js');
 require('../store-Ci6ib2C9.js');
-const require_feature_flags = require('../feature-flags-DJi3gEFN.js');
+const require_feature_flags = require('../feature-flags-BFiGn38a.js');
 
 exports.FeatureFlag = require_feature_flags.FeatureFlag;
-exports.flag = require_feature_flags.flag;
+exports.flag = require_feature_flags.flag;
+exports.setFlagProvider = require_feature_flags.setFlagProvider;

package/dist/flags/store.d.ts

@@ -1,4 +1,4 @@
-import { FlagStore } from "../CommandKit-CEFWQpDo.js";
+import { FlagStore } from "../CommandKit-VTym8VA2.js";
 import "../EventInterceptor-D_oEWSnF.js";
 import "../ButtonKit-BSI7lCI0.js";
 import "../ModalKit-CKtQ8eXW.js";

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { AnyCommandExecute, AppCommandHandler, AsyncFunction, AutocompleteCommand, AutocompleteCommandContext, AutocompleteCommandMiddlewareContext, BootstrapFunction, ChatInputCommand, ChatInputCommandContext, CommandBuilderLike, CommandContext, CommandContextOptions, CommandData, CommandExecutionMode, CommandFlagContext, CommandKit, CommandKitConfiguration, CommandKitEnvironment, CommandKitEnvironmentInternalData, CommandKitEnvironmentType, CommandKitEventDispatch, CommandKitHMREvent, CommandKitOptions, CommandKitPlugin, CommandKitPluginRuntime, CommandRegistrar, CommandTypeData, CommonDirectiveTransformer, CommonDirectiveTransformerOptions, CommonPluginRuntime, CompilerPlugin, CompilerPluginRuntime, Context, ContextParameters, CustomEvaluationContext, CustomEvaluationFunction, DecideFunction, EvaluationContext, EventFlagContext, FeatureFlag, FeatureFlagDefinition, FlagRunner, GenericFunction, IdentifyFunction, InteractionCommandContext, InteractionCommandMiddlewareContext, LoadedCommand, MaybeFalsey, MaybePromise, MessageCommand, MessageCommandContext, MessageCommandMiddlewareContext, MessageContextMenuCommand, MessageContextMenuCommandContext, MessageContextMenuCommandMiddlewareContext, MiddlewareContext, MiddlewareContextArgs, PluginTransformParameters, PreRegisterCommandsEvent, PreparedAppCommandExecution, ResolvableCommand, RunCommand, RuntimePlugin, SlashCommandMiddlewareContext, TemplateHandler, TransformedResult, UserContextMenuCommand, UserContextMenuCommandContext, UserContextMenuCommandMiddlewareContext, after, cancelAfter, commandkit, exitContext, flag, getCommandKit, getContext, isCommandWorkerContext, isCompilerPlugin, isRuntimePlugin, makeContextAwareFunction, onApplicationBootstrap, onBootstrap, provideContext, useEnvironment } from "./CommandKit-CEFWQpDo.js";
+import { AnyCommandExecute, AppCommandHandler, AsyncFunction, AutocompleteCommand, AutocompleteCommandContext, AutocompleteCommandMiddlewareContext, BootstrapFunction, ChatInputCommand, ChatInputCommandContext, CommandBuilderLike, CommandContext, CommandContextOptions, CommandData, CommandExecutionMode, CommandFlagContext, CommandKit, CommandKitConfiguration, CommandKitEnvironment, CommandKitEnvironmentInternalData, CommandKitEnvironmentType, CommandKitEventDispatch, CommandKitHMREvent, CommandKitOptions, CommandKitPlugin, CommandKitPluginRuntime, CommandRegistrar, CommandTypeData, CommonDirectiveTransformer, CommonDirectiveTransformerOptions, CommonPluginRuntime, CompilerPlugin, CompilerPluginRuntime, Context, ContextParameters, CustomEvaluationContext, CustomEvaluationFunction, DecideFunction, EvaluationContext, EventFlagContext, FeatureFlag, FeatureFlagDefinition, FlagRunner, GenericFunction, IdentifyFunction, InteractionCommandContext, InteractionCommandMiddlewareContext, LoadedCommand, MaybeFalsey, MaybePromise, MessageCommand, MessageCommandContext, MessageCommandMiddlewareContext, MessageContextMenuCommand, MessageContextMenuCommandContext, MessageContextMenuCommandMiddlewareContext, MiddlewareContext, MiddlewareContextArgs, PluginTransformParameters, PreRegisterCommandsEvent, PreparedAppCommandExecution, ResolvableCommand, RunCommand, RuntimePlugin, SlashCommandMiddlewareContext, TemplateHandler, TransformedResult, UserContextMenuCommand, UserContextMenuCommandContext, UserContextMenuCommandMiddlewareContext, after, cancelAfter, commandkit, exitContext, flag, getCommandKit, getContext, isCommandWorkerContext, isCompilerPlugin, isRuntimePlugin, makeContextAwareFunction, onApplicationBootstrap, onBootstrap, provideContext, setFlagProvider, useEnvironment } from "./CommandKit-VTym8VA2.js";
 import { EventInterceptor, EventInterceptorContextData, EventInterceptorErrorHandler } from "./EventInterceptor-D_oEWSnF.js";
 import { ButtonKit, ButtonKitPredicate, CommandKitButtonBuilderInteractionCollectorDispatch, CommandKitButtonBuilderInteractionCollectorDispatchContextData, CommandKitButtonBuilderOnEnd, OnButtonKitClick, OnButtonKitEnd } from "./ButtonKit-BSI7lCI0.js";
 import { CommandKitModalBuilderInteractionCollectorDispatch, CommandKitModalBuilderInteractionCollectorDispatchContextData, CommandKitModalBuilderOnEnd, ModalKit, ModalKitPredicate, OnModalKitEnd, OnModalKitSubmit } from "./ModalKit-CKtQ8eXW.js";
@@ -29,14 +29,14 @@ import { Command, CommandsRouter, CommandsRouterOptions, Middleware, ParsedComma
 import { EventsRouter, EventsRouterOptions, EventsTree, ParsedEvent } from "./EventsRouter-BacqK6z3.js";
 import "./index-CUPkUUOR.js";
 import { COMMANDKIT_BOOTSTRAP_MODE, COMMANDKIT_CACHE_TAG, COMMANDKIT_IS_CLI, COMMANDKIT_IS_DEV, COMMANDKIT_IS_TEST, HMREventType } from "./constants-BPWSrMkn.js";
-import { EventWorkerContext, eventWorkerContext, getEventWorkerContext, isEventWorkerContext, runInEventWorkerContext } from "./EventWorkerContext-Dk7c6sRe.js";
-import "./types-DFaFI0H7.js";
-import "./utils-DOSJ2rn3.js";
+import { EventWorkerContext, eventWorkerContext, getEventWorkerContext, isEventWorkerContext, runInEventWorkerContext } from "./EventWorkerContext-BXKO7FMY.js";
+import "./types-CICvhb0c.js";
+import "./utils-B1KWblpG.js";
 import { bootstrapCommandkitCLI } from "./init-CT348Okf.js";
-import { defineConfig, getConfig } from "./config-BX3KH7XB.js";
+import { defineConfig, getConfig } from "./config-aIOTA81x.js";
 import { ILogger } from "./ILogger-kqwb2kUu.js";
 import { DefaultLogger } from "./DefaultLogger-CcW-Fuq5.js";
 import { CommandKitLoggerOptions, Logger, LoggerImpl, createLogger } from "./Logger-B4B_URL-.js";
 import { version } from "./version-DggMfP_1.js";
 import { StopEventPropagationError, debounce, defer, devOnly, getCurrentDirectory, getSourceDirectories, stopEvents } from "./utilities-DQT4lzAB.js";
-export { ActionRow, ActionRowProps, AnyCommandExecute, AnyCommandKitElement, AppCommandHandler, AsyncFunction, AutocompleteCommand, AutocompleteCommandContext, AutocompleteCommandMiddlewareContext, BootstrapFunction, Button, ButtonChildrenLike, ButtonKit, ButtonKitPredicate, ButtonProps, COMMANDKIT_BOOTSTRAP_MODE, COMMANDKIT_CACHE_TAG, COMMANDKIT_IS_CLI, COMMANDKIT_IS_DEV, COMMANDKIT_IS_TEST, ChannelSelectMenu, ChannelSelectMenuKit, ChannelSelectMenuKitPredicate, ChannelSelectMenuProps, ChatInputCommand, ChatInputCommandContext, Command, CommandBuilderLike, CommandContext, CommandContextOptions, CommandData, CommandExecutionMode, CommandFlagContext, CommandKit, CommandKitButtonBuilderInteractionCollectorDispatch, CommandKitButtonBuilderInteractionCollectorDispatchContextData, CommandKitButtonBuilderOnEnd, CommandKitConfiguration, CommandKitElement, CommandKitElementData, CommandKitEnvironment, CommandKitEnvironmentInternalData, CommandKitEnvironmentType, CommandKitEventDispatch, CommandKitHMREvent, CommandKitLoggerOptions, CommandKitModalBuilderInteractionCollectorDispatch, CommandKitModalBuilderInteractionCollectorDispatchContextData, CommandKitModalBuilderOnEnd, CommandKitOptions, CommandKitPlugin, CommandKitPluginRuntime, CommandKitSelectMenuBuilderInteractionCollectorDispatch, CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData, CommandKitSelectMenuBuilderOnEnd, CommandRegistrar, CommandSource, CommandTypeData, CommandsRouter, CommandsRouterOptions, CommonBuilderKit, CommonDirectiveTransformer, CommonDirectiveTransformerOptions, CommonPluginRuntime, CommonSelectMenuProps, CompilerPlugin, CompilerPluginRuntime, Container, ContainerProps, Context, ContextParameters, CustomEvaluationContext, CustomEvaluationFunction, DecideFunction, DefaultLogger, ElementType, EvaluationContext, EventFlagContext, EventInterceptor, EventInterceptorContextData, EventInterceptorErrorHandler, EventWorkerContext, EventsRouter, EventsRouterOptions, EventsTree, FeatureFlag, FeatureFlagDefinition, File, FileProps, FlagRunner, Fragment, FragmentElementProps, GenericFunction, HMREventType, ILogger, IdentifyFunction, InteractionCommandContext, InteractionCommandMiddlewareContext, LoadedCommand, Logger, LoggerImpl, MaybeArray, MaybeFalsey, MaybePromise, MediaGallery, MediaGalleryItem, MediaGalleryItemProps, MediaGalleryProps, MentionableSelectMenu, MentionableSelectMenuKit, MentionableSelectMenuKitPredicate, MentionableSelectMenuProps, MessageCommand, MessageCommandContext, MessageCommandMiddlewareContext, MessageCommandOptions, MessageCommandOptionsSchema, MessageCommandParser, MessageContextMenuCommand, MessageContextMenuCommandContext, MessageContextMenuCommandMiddlewareContext, Middleware, MiddlewareContext, MiddlewareContextArgs, Modal, ModalKit, ModalKitPredicate, ModalProps, OnButtonKitClick, OnButtonKitEnd, OnChannelSelectMenuKitSubmit, OnMentionableSelectMenuKitSubmit, OnModalKitEnd, OnModalKitSubmit, OnRoleSelectMenuKitSubmit, OnSelectMenuKitEnd, OnSelectMenuKitSubmit, OnStringSelectMenuKitSubmit, OnUserSelectMenuKitSubmit, ParagraphInput, ParsedCommandData, ParsedEvent, ParsedMessageCommand, PluginTransformParameters, PreRegisterCommandsEvent, PreparedAppCommandExecution, ResolvableCommand, ResolveBuilderInteraction, RoleSelectMenu, RoleSelectMenuKit, RoleSelectMenuKitPredicate, RoleSelectMenuProps, RunCommand, RuntimePlugin, Section, SectionProps, SelectMenuKitPredicate, SelectMenuProps, Separator, SeparatorProps, ShortInput, SlashCommandMiddlewareContext, StopEventPropagationError, StringEncodable, StringSelectMenu, StringSelectMenuKit, StringSelectMenuKitPredicate, StringSelectMenuOption, StringSelectMenuOptionProps, StringSelectMenuProps, TemplateHandler, TextDisplay, TextDisplayProps, TextInput, TextInputProps, Thumbnail, ThumbnailProps, TransformedResult, UserContextMenuCommand, UserContextMenuCommandContext, UserContextMenuCommandMiddlewareContext, UserSelectMenu, UserSelectMenuKit, UserSelectMenuKitPredicate, UserSelectMenuProps, after, bootstrapCommandkitCLI, cancelAfter, commandkit, createElement, createElement as jsx, createElement as jsxs, createLogger, debounce, CommandKit as default, defer, defineConfig, devOnly, eventWorkerContext, exitContext, exitMiddleware, flag, getCommandKit, getConfig, getContext, getCurrentDirectory, getElement, getEventWorkerContext, getSourceDirectories, isCommandKitElement, isCommandWorkerContext, isCompilerPlugin, isEventWorkerContext, isInteractionSource, isMessageSource, isRuntimePlugin, makeContextAwareFunction, onApplicationBootstrap, onBootstrap, provideContext, redirect, rethrow, runInEventWorkerContext, stopEvents, useEnvironment, version };
+export { ActionRow, ActionRowProps, AnyCommandExecute, AnyCommandKitElement, AppCommandHandler, AsyncFunction, AutocompleteCommand, AutocompleteCommandContext, AutocompleteCommandMiddlewareContext, BootstrapFunction, Button, ButtonChildrenLike, ButtonKit, ButtonKitPredicate, ButtonProps, COMMANDKIT_BOOTSTRAP_MODE, COMMANDKIT_CACHE_TAG, COMMANDKIT_IS_CLI, COMMANDKIT_IS_DEV, COMMANDKIT_IS_TEST, ChannelSelectMenu, ChannelSelectMenuKit, ChannelSelectMenuKitPredicate, ChannelSelectMenuProps, ChatInputCommand, ChatInputCommandContext, Command, CommandBuilderLike, CommandContext, CommandContextOptions, CommandData, CommandExecutionMode, CommandFlagContext, CommandKit, CommandKitButtonBuilderInteractionCollectorDispatch, CommandKitButtonBuilderInteractionCollectorDispatchContextData, CommandKitButtonBuilderOnEnd, CommandKitConfiguration, CommandKitElement, CommandKitElementData, CommandKitEnvironment, CommandKitEnvironmentInternalData, CommandKitEnvironmentType, CommandKitEventDispatch, CommandKitHMREvent, CommandKitLoggerOptions, CommandKitModalBuilderInteractionCollectorDispatch, CommandKitModalBuilderInteractionCollectorDispatchContextData, CommandKitModalBuilderOnEnd, CommandKitOptions, CommandKitPlugin, CommandKitPluginRuntime, CommandKitSelectMenuBuilderInteractionCollectorDispatch, CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData, CommandKitSelectMenuBuilderOnEnd, CommandRegistrar, CommandSource, CommandTypeData, CommandsRouter, CommandsRouterOptions, CommonBuilderKit, CommonDirectiveTransformer, CommonDirectiveTransformerOptions, CommonPluginRuntime, CommonSelectMenuProps, CompilerPlugin, CompilerPluginRuntime, Container, ContainerProps, Context, ContextParameters, CustomEvaluationContext, CustomEvaluationFunction, DecideFunction, DefaultLogger, ElementType, EvaluationContext, EventFlagContext, EventInterceptor, EventInterceptorContextData, EventInterceptorErrorHandler, EventWorkerContext, EventsRouter, EventsRouterOptions, EventsTree, FeatureFlag, FeatureFlagDefinition, File, FileProps, FlagRunner, Fragment, FragmentElementProps, GenericFunction, HMREventType, ILogger, IdentifyFunction, InteractionCommandContext, InteractionCommandMiddlewareContext, LoadedCommand, Logger, LoggerImpl, MaybeArray, MaybeFalsey, MaybePromise, MediaGallery, MediaGalleryItem, MediaGalleryItemProps, MediaGalleryProps, MentionableSelectMenu, MentionableSelectMenuKit, MentionableSelectMenuKitPredicate, MentionableSelectMenuProps, MessageCommand, MessageCommandContext, MessageCommandMiddlewareContext, MessageCommandOptions, MessageCommandOptionsSchema, MessageCommandParser, MessageContextMenuCommand, MessageContextMenuCommandContext, MessageContextMenuCommandMiddlewareContext, Middleware, MiddlewareContext, MiddlewareContextArgs, Modal, ModalKit, ModalKitPredicate, ModalProps, OnButtonKitClick, OnButtonKitEnd, OnChannelSelectMenuKitSubmit, OnMentionableSelectMenuKitSubmit, OnModalKitEnd, OnModalKitSubmit, OnRoleSelectMenuKitSubmit, OnSelectMenuKitEnd, OnSelectMenuKitSubmit, OnStringSelectMenuKitSubmit, OnUserSelectMenuKitSubmit, ParagraphInput, ParsedCommandData, ParsedEvent, ParsedMessageCommand, PluginTransformParameters, PreRegisterCommandsEvent, PreparedAppCommandExecution, ResolvableCommand, ResolveBuilderInteraction, RoleSelectMenu, RoleSelectMenuKit, RoleSelectMenuKitPredicate, RoleSelectMenuProps, RunCommand, RuntimePlugin, Section, SectionProps, SelectMenuKitPredicate, SelectMenuProps, Separator, SeparatorProps, ShortInput, SlashCommandMiddlewareContext, StopEventPropagationError, StringEncodable, StringSelectMenu, StringSelectMenuKit, StringSelectMenuKitPredicate, StringSelectMenuOption, StringSelectMenuOptionProps, StringSelectMenuProps, TemplateHandler, TextDisplay, TextDisplayProps, TextInput, TextInputProps, Thumbnail, ThumbnailProps, TransformedResult, UserContextMenuCommand, UserContextMenuCommandContext, UserContextMenuCommandMiddlewareContext, UserSelectMenu, UserSelectMenuKit, UserSelectMenuKitPredicate, UserSelectMenuProps, after, bootstrapCommandkitCLI, cancelAfter, commandkit, createElement, createElement as jsx, createElement as jsxs, createLogger, debounce, CommandKit as default, defer, defineConfig, devOnly, eventWorkerContext, exitContext, exitMiddleware, flag, getCommandKit, getConfig, getContext, getCurrentDirectory, getElement, getEventWorkerContext, getSourceDirectories, isCommandKitElement, isCommandWorkerContext, isCompilerPlugin, isEventWorkerContext, isInteractionSource, isMessageSource, isRuntimePlugin, makeContextAwareFunction, onApplicationBootstrap, onBootstrap, provideContext, redirect, rethrow, runInEventWorkerContext, setFlagProvider, stopEvents, useEnvironment, version };

package/dist/index.js

@@ -38,8 +38,8 @@ require('./store-Ci6ib2C9.js');
 const require_helpers = require('./helpers-CswC9gKF.js');
 require('./app-CXCbKsPz.js');
 require('./ILogger-DucYb0bG.js');
-const require_version = require('./version-DR9rRG__.js');
-const require_feature_flags = require('./feature-flags-DJi3gEFN.js');
+const require_version = require('./version-CObFfDEn.js');
+const require_feature_flags = require('./feature-flags-BFiGn38a.js');
 const require_init = require('./init-BDgyvx9E.js');
 
 //#region src/index.ts
@@ -141,6 +141,7 @@ exports.provideContext = require_CommandKit.provideContext;
 exports.redirect = require_signals.redirect;
 exports.rethrow = require_signals.rethrow;
 exports.runInEventWorkerContext = require_EventWorkerContext.runInEventWorkerContext;
+exports.setFlagProvider = require_feature_flags.setFlagProvider;
 exports.stopEvents = require_CommandKit.stopEvents;
 exports.useEnvironment = require_CommandKit.useEnvironment;
 exports.version = require_version.version;

package/dist/plugins/CompilerPlugin.d.ts

@@ -1,4 +1,4 @@
-import { CompilerPlugin, PluginTransformParameters, TransformedResult, isCompilerPlugin } from "../CommandKit-CEFWQpDo.js";
+import { CompilerPlugin, PluginTransformParameters, TransformedResult, isCompilerPlugin } from "../CommandKit-VTym8VA2.js";
 import "../EventInterceptor-D_oEWSnF.js";
 import "../ButtonKit-BSI7lCI0.js";
 import "../ModalKit-CKtQ8eXW.js";

package/dist/plugins/PluginCommon.d.ts

@@ -1,4 +1,4 @@
-import { PluginCommon, PluginOptions, PluginType, isPlugin } from "../CommandKit-CEFWQpDo.js";
+import { PluginCommon, PluginOptions, PluginType, isPlugin } from "../CommandKit-VTym8VA2.js";
 import "../EventInterceptor-D_oEWSnF.js";
 import "../ButtonKit-BSI7lCI0.js";
 import "../ModalKit-CKtQ8eXW.js";

package/dist/plugins/RuntimePlugin.d.ts

@@ -1,4 +1,4 @@
-import { RuntimePlugin, isRuntimePlugin } from "../CommandKit-CEFWQpDo.js";
+import { RuntimePlugin, isRuntimePlugin } from "../CommandKit-VTym8VA2.js";
 import "../EventInterceptor-D_oEWSnF.js";
 import "../ButtonKit-BSI7lCI0.js";
 import "../ModalKit-CKtQ8eXW.js";

package/dist/plugins/index.d.ts

@@ -1,4 +1,4 @@
-import { CommandKitEventDispatch, CommandKitPlugin, CommandKitPluginRuntime, CommonDirectiveTransformer, CommonDirectiveTransformerOptions, CommonPluginRuntime, CompilerPlugin, CompilerPluginRuntime, MaybeFalsey, PluginTransformParameters, RuntimePlugin, TemplateHandler, TransformedResult, isCompilerPlugin, isRuntimePlugin } from "../CommandKit-CEFWQpDo.js";
+import { CommandKitEventDispatch, CommandKitPlugin, CommandKitPluginRuntime, CommonDirectiveTransformer, CommonDirectiveTransformerOptions, CommonPluginRuntime, CompilerPlugin, CompilerPluginRuntime, MaybeFalsey, PluginTransformParameters, RuntimePlugin, TemplateHandler, TransformedResult, isCompilerPlugin, isRuntimePlugin } from "../CommandKit-VTym8VA2.js";
 import "../EventInterceptor-D_oEWSnF.js";
 import "../ButtonKit-BSI7lCI0.js";
 import "../ModalKit-CKtQ8eXW.js";

package/dist/plugins/plugin-runtime/CommandKitPluginRuntime.d.ts

@@ -1,4 +1,4 @@
-import { CommandKitPluginRuntime } from "../../CommandKit-CEFWQpDo.js";
+import { CommandKitPluginRuntime } from "../../CommandKit-VTym8VA2.js";
 import "../../EventInterceptor-D_oEWSnF.js";
 import "../../ButtonKit-BSI7lCI0.js";
 import "../../ModalKit-CKtQ8eXW.js";

package/dist/plugins/plugin-runtime/CompilerPluginRuntime.d.ts

@@ -1,4 +1,4 @@
-import { CompilerPluginRuntime } from "../../CommandKit-CEFWQpDo.js";
+import { CompilerPluginRuntime } from "../../CommandKit-VTym8VA2.js";
 import "../../EventInterceptor-D_oEWSnF.js";
 import "../../ButtonKit-BSI7lCI0.js";
 import "../../ModalKit-CKtQ8eXW.js";

package/dist/plugins/plugin-runtime/builtin/CommonDirectiveTransformer.d.ts

@@ -1,4 +1,4 @@
-import { CommonDirectiveTransformer, CommonDirectiveTransformerOptions } from "../../../CommandKit-CEFWQpDo.js";
+import { CommonDirectiveTransformer, CommonDirectiveTransformerOptions } from "../../../CommandKit-VTym8VA2.js";
 import "../../../EventInterceptor-D_oEWSnF.js";
 import "../../../ButtonKit-BSI7lCI0.js";
 import "../../../ModalKit-CKtQ8eXW.js";

package/dist/plugins/plugin-runtime/builtin/MacroPlugin.d.ts

@@ -1,4 +1,4 @@
-import { CompilerPlugin, MaybeFalsey, PluginTransformParameters, TransformedResult } from "../../../CommandKit-CEFWQpDo.js";
+import { CompilerPlugin, MaybeFalsey, PluginTransformParameters, TransformedResult } from "../../../CommandKit-VTym8VA2.js";
 import "../../../EventInterceptor-D_oEWSnF.js";
 import "../../../ButtonKit-BSI7lCI0.js";
 import "../../../ModalKit-CKtQ8eXW.js";

package/dist/plugins/plugin-runtime/runtime.d.ts

@@ -1,4 +1,4 @@
-import { CommonPluginRuntime } from "../../CommandKit-CEFWQpDo.js";
+import { CommonPluginRuntime } from "../../CommandKit-VTym8VA2.js";
 import "../../EventInterceptor-D_oEWSnF.js";
 import "../../ButtonKit-BSI7lCI0.js";
 import "../../ModalKit-CKtQ8eXW.js";

package/dist/plugins/types.d.ts

@@ -1,4 +1,4 @@
-import { CommandKitEventDispatch, CommandKitPlugin, MaybeFalsey, TemplateHandler } from "../CommandKit-CEFWQpDo.js";
+import { CommandKitEventDispatch, CommandKitPlugin, MaybeFalsey, TemplateHandler } from "../CommandKit-VTym8VA2.js";
 import "../EventInterceptor-D_oEWSnF.js";
 import "../ButtonKit-BSI7lCI0.js";
 import "../ModalKit-CKtQ8eXW.js";

package/dist/{types-DFaFI0H7.d.ts → types-CICvhb0c.d.ts}

@@ -1,4 +1,4 @@
-import { CommandKitPlugin } from "./CommandKit-CEFWQpDo.js";
+import { CommandKitPlugin } from "./CommandKit-VTym8VA2.js";
 import { MaybeArray } from "./types-CJ-XvOFN.js";
 
 //#region src/config/types.d.ts
@@ -70,4 +70,4 @@ interface CommandKitConfig {
 }
 //#endregion
 export { CommandKitConfig };
-//# sourceMappingURL=types-DFaFI0H7.d.ts.map
+//# sourceMappingURL=types-CICvhb0c.d.ts.map

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-import { CommandContext, CommandData, CommandKitOptions } from "./CommandKit-CEFWQpDo.js";
+import { CommandContext, CommandData, CommandKitOptions } from "./CommandKit-VTym8VA2.js";
 import "./EventInterceptor-D_oEWSnF.js";
 import "./ButtonKit-BSI7lCI0.js";
 import "./ModalKit-CKtQ8eXW.js";

package/dist/utils/dev-hooks.d.ts

@@ -1,4 +1,4 @@
-import { CommandKitHMREvent, registerDevHooks } from "../CommandKit-CEFWQpDo.js";
+import { CommandKitHMREvent, registerDevHooks } from "../CommandKit-VTym8VA2.js";
 import "../EventInterceptor-D_oEWSnF.js";
 import "../ButtonKit-BSI7lCI0.js";
 import "../ModalKit-CKtQ8eXW.js";

package/dist/{utils-DOSJ2rn3.d.ts → utils-B1KWblpG.d.ts}

@@ -1,4 +1,4 @@
-import { CommandKitConfig } from "./types-DFaFI0H7.js";
+import { CommandKitConfig } from "./types-CICvhb0c.js";
 
 //#region src/config/utils.d.ts
 type DeepRequired<T> = { [P in keyof T]-?: DeepRequired<T[P]> };
@@ -7,4 +7,4 @@ declare const mergeDeep: <T extends Record<string, any>>(target: T, source: T) =
 type ResolvedCommandKitConfig = DeepRequired<CommandKitConfig>;
 //#endregion
 export { DeepPartial, DeepRequired, ResolvedCommandKitConfig, mergeDeep };
-//# sourceMappingURL=utils-DOSJ2rn3.d.ts.map
+//# sourceMappingURL=utils-B1KWblpG.d.ts.map

package/dist/{version-DR9rRG__.js → version-CObFfDEn.js}

@@ -3,7 +3,7 @@
 /**
 * The current version of CommandKit.
 */
-const version = "1.0.0-dev.20250608124717";
+const version = "1.0.0-dev.20250609020912";
 
 //#endregion
 Object.defineProperty(exports, 'version', {
@@ -12,4 +12,4 @@ Object.defineProperty(exports, 'version', {
     return version;
   }
 });
-//# sourceMappingURL=version-DR9rRG__.js.map
+//# sourceMappingURL=version-CObFfDEn.js.map

package/dist/{version-DR9rRG__.js.map → version-CObFfDEn.js.map}

@@ -1 +1 @@
-{"version":3,"file":"version-DR9rRG__.js","names":[],"sources":["../src/version.ts"],"sourcesContent":["function $version(): string {\n  'use macro';\n  return require('../package.json').version;\n}\n\n/**\n * The current version of CommandKit.\n */\nexport const version: string = $version();\n"],"mappings":";;;;;AAQA,MAAa,UAA4B"}
+{"version":3,"file":"version-CObFfDEn.js","names":[],"sources":["../src/version.ts"],"sourcesContent":["function $version(): string {\n  'use macro';\n  return require('../package.json').version;\n}\n\n/**\n * The current version of CommandKit.\n */\nexport const version: string = $version();\n"],"mappings":";;;;;AAQA,MAAa,UAA4B"}

package/dist/version.js

@@ -1,3 +1,3 @@
-const require_version = require('./version-DR9rRG__.js');
+const require_version = require('./version-CObFfDEn.js');
 
 exports.version = require_version.version;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "commandkit",
   "description": "Beginner friendly command & event handler for Discord.js",
-  "version": "1.0.0-dev.20250608124717",
+  "version": "1.0.0-dev.20250609020912",
   "license": "MIT",
   "type": "commonjs",
   "main": "./dist/index.js",
@@ -129,7 +129,7 @@
     "tsx": "^4.19.2",
     "typescript": "^5.7.3",
     "vitest": "^3.0.5",
-    "tsconfig": "0.0.0-dev.20250608124717"
+    "tsconfig": "0.0.0-dev.20250609020912"
   },
   "peerDependencies": {
     "discord.js": "^14"

package/dist/feature-flags-DJi3gEFN.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"feature-flags-DJi3gEFN.js","names":[],"sources":["../src/flags/feature-flags.ts"],"sourcesContent":["import { getCommandKit, getContext } from '../context/async-context';\nimport { eventWorkerContext } from '../app/events/EventWorkerContext';\nimport { ParsedEvent } from '../app/router';\nimport { CommandKit } from '../CommandKit';\nimport {\n  AutocompleteInteraction,\n  ChatInputCommandInteraction,\n  Client,\n  ClientEvents,\n  ContextMenuCommandInteraction,\n  Guild,\n  Message,\n  TextBasedChannel,\n} from 'discord.js';\nimport { LoadedCommand } from '../app';\nimport { defer, JsonSerialize } from '../utils/utilities';\nimport { AnalyticsEvents } from '../analytics/constants';\n\nexport type MaybePromise<T> = T | Promise<T>;\n\nexport type IdentifyFunction<R> = (\n  context: EvaluationContext,\n) => MaybePromise<R>;\n\nexport type DecideFunction<E, R> = (data: { entities: E }) => MaybePromise<R>;\n\nexport interface FeatureFlagDefinition<R, Entity> {\n  key: string;\n  description?: string;\n  identify?: IdentifyFunction<Entity>;\n  decide: DecideFunction<Entity, R>;\n}\n\nexport interface CommandFlagContext {\n  client: Client<true>;\n  commandkit: CommandKit;\n  command: {\n    interaction?:\n      | ChatInputCommandInteraction\n      | AutocompleteInteraction\n      | ContextMenuCommandInteraction;\n    message?: Message;\n    guild: Guild | null;\n    channel: TextBasedChannel | null;\n    command: LoadedCommand;\n  };\n  event: null;\n}\n\nexport interface EventFlagContext {\n  client: Client<true>;\n  commandkit: CommandKit;\n  event: {\n    data: ParsedEvent;\n    event: string;\n    namespace: string | null;\n    arguments: any[];\n    argumentsAs<E extends keyof ClientEvents>(event: E): ClientEvents[E];\n  };\n  command: null;\n}\n\nexport type EvaluationContext = CommandFlagContext | EventFlagContext;\n\nexport type CustomEvaluationFunction<E> = () => MaybePromise<E>;\n\nexport type CustomEvaluationContext<E> = {\n  identify: E | CustomEvaluationFunction<E>;\n};\n\nexport interface FlagRunner<E, R> {\n  (): Promise<R>;\n  run(context: CustomEvaluationContext<E>): Promise<R>;\n}\n\nexport class FeatureFlag<R, T> {\n  private commandkit: CommandKit;\n  public constructor(public readonly options: FeatureFlagDefinition<R, T>) {\n    this.commandkit = getCommandKit(true);\n    const FlagStore = this.commandkit.flags;\n\n    if (FlagStore.has(options.key)) {\n      throw new Error(`Feature flag with key \"${options.key}\" already exists.`);\n    }\n\n    FlagStore.set(options.key, this);\n  }\n\n  private getContext(): EvaluationContext {\n    const env = getContext();\n\n    if (env?.context) {\n      const {\n        client,\n        commandkit,\n        interaction,\n        message,\n        guild,\n        channel,\n        command,\n      } = env.context;\n\n      return {\n        client: client as Client<true>,\n        commandkit,\n        command: {\n          interaction,\n          message,\n          guild,\n          channel,\n          command,\n        },\n        event: null,\n      };\n    }\n\n    const eventCtx = eventWorkerContext.getStore();\n\n    if (eventCtx) {\n      const { commandkit, data, event, namespace } = eventCtx;\n\n      return {\n        client: commandkit.client as Client<true>,\n        commandkit,\n        event: {\n          data,\n          event,\n          namespace,\n          arguments: eventCtx.arguments,\n          argumentsAs: (eventName) => {\n            const args = eventCtx.arguments as ClientEvents[typeof eventName];\n            return args;\n          },\n        },\n        command: null,\n      };\n    }\n\n    throw new Error(\n      'Could not determine the execution context. Feature flags may only be used inside a command or event.',\n    );\n  }\n\n  public async execute(res?: T): Promise<R> {\n    const { decide, identify } = this.options;\n\n    const identificationStart = performance.now();\n    const entities =\n      res ??\n      (await (async () => {\n        const ctx = this.getContext();\n        return (await identify?.(ctx)) ?? ({} as T);\n      })());\n    const identificationTime = performance.now() - identificationStart;\n\n    const decisionStart = performance.now();\n    const decisionResult = await decide({\n      entities,\n    });\n    const decisionTime = performance.now() - decisionStart;\n\n    defer(async () => {\n      await this.commandkit.analytics.track({\n        name: AnalyticsEvents.FEATURE_FLAG_METRICS,\n        data: {\n          flag: this.options.key,\n          identificationTime: identificationTime.toFixed(2),\n          decisionTime: decisionTime.toFixed(2),\n        },\n      });\n    });\n\n    defer(async () => {\n      await this.commandkit.analytics.track({\n        name: AnalyticsEvents.FEATURE_FLAG_DECISION,\n        id:\n          entities &&\n          typeof entities === 'object' &&\n          'id' in entities &&\n          typeof entities.id === 'string'\n            ? entities.id\n            : undefined,\n        data: {\n          flag: this.options.key,\n          decision: JsonSerialize(decisionResult, 'unknown'),\n        },\n      });\n    });\n\n    return decisionResult as R;\n  }\n}\n\nexport function flag<Returns = boolean, Entity = Record<any, any>>(\n  options: FeatureFlagDefinition<Returns, Entity>,\n): FlagRunner<Entity, Returns> {\n  const flag = new FeatureFlag<Returns, Entity>(options);\n  const runner = flag.execute.bind(flag, undefined) as FlagRunner<\n    Entity,\n    Returns\n  >;\n\n  runner.run = async function (ctx) {\n    if (!ctx?.identify) {\n      throw new Error(\n        'Custom evaluation context must have an identify function or object.',\n      );\n    }\n\n    const context = (\n      typeof ctx === 'function'\n        ? await (ctx as CustomEvaluationFunction<Entity>)()\n        : ctx\n    ) as Entity;\n\n    const decisionResult = await flag.execute(context);\n\n    return decisionResult;\n  };\n\n  return runner;\n}\n"],"mappings":";;;;;AA2EA,IAAa,cAAb,MAA+B;CAC7B,AAAQ;CACR,AAAO,YAA4B,SAAsC;EAAtC;AACjC,OAAK,aAAa,iCAAc,KAAK;EACrC,MAAM,YAAY,KAAK,WAAW;AAElC,MAAI,UAAU,IAAI,QAAQ,IAAI,CAC5B,OAAM,IAAI,OAAO,yBAAyB,QAAQ,IAAI;AAGxD,YAAU,IAAI,QAAQ,KAAK,KAAK;CAClC;CAEA,AAAQ,aAAgC;EACtC,MAAM,MAAM,+BAAY;AAExB,gDAAI,IAAK,SAAS;GAChB,MAAM,EACJ,QACA,YACA,aACA,SACA,OACA,SACA,SACD,GAAG,IAAI;AAER,UAAO;IACG;IACR;IACA,SAAS;KACP;KACA;KACA;KACA;KACA;IACD;IACD,OAAO;GACR;EACH;EAEA,MAAM,WAAW,8CAAmB,UAAU;AAE9C,MAAI,UAAU;GACZ,MAAM,EAAE,YAAY,MAAM,OAAO,WAAW,GAAG;AAE/C,UAAO;IACL,QAAQ,WAAW;IACnB;IACA,OAAO;KACL;KACA;KACA;KACA,WAAW,SAAS;KACpB,aAAa,CAAC,cAAc;MAC1B,MAAM,OAAO,SAAS;AACtB,aAAO;KACR;IACF;IACD,SAAS;GACV;EACH;AAEA,QAAM,IAAI,MACR;CAEJ;CAEA,MAAa,QAAQ,KAAqB;EACxC,MAAM,EAAE,QAAQ,UAAU,GAAG,KAAK;EAElC,MAAM,sBAAsB,YAAY,KAAK;EAC7C,MAAM,WACN,OACA,MAAM,CAAC,YAAY;GACjB,MAAM,MAAM,KAAK,YAAY;AAC7B,UAAQ,2DAAM,SAAW,IAAI,KAAK,CAAE;EACrC,IAAG;EACJ,MAAM,qBAAqB,YAAY,KAAK,GAAG;EAE/C,MAAM,gBAAgB,YAAY,KAAK;EACvC,MAAM,iBAAiB,MAAM,OAAO,EAClC,SACD,EAAC;EACF,MAAM,eAAe,YAAY,KAAK,GAAG;AAEzC,2BAAM,YAAY;AAChB,SAAM,KAAK,WAAW,UAAU,MAAM;IACpC,MAAM,kCAAgB;IACtB,MAAM;KACJ,MAAM,KAAK,QAAQ;KACnB,oBAAoB,mBAAmB,QAAQ,EAAE;KACjD,cAAc,aAAa,QAAQ,EAAE;IACtC;GACF,EAAC;EACH,EAAC;AAEF,2BAAM,YAAY;AAChB,SAAM,KAAK,WAAW,UAAU,MAAM;IACpC,MAAM,kCAAgB;IACtB,IACA,mBACO,aAAa,YACpB,QAAQ,mBACD,SAAS,OAAO,WACvB,SAAS;IAET,MAAM;KACJ,MAAM,KAAK,QAAQ;KACnB,UAAU,iCAAc,gBAAgB,UAAU;IACnD;GACF,EAAC;EACH,EAAC;AAEF,SAAO;CACT;AACF;AAEA,SAAgB,KAChB,SAC8B;CAC5B,MAAM,SAAO,IAAI,YAA6B;CAC9C,MAAM,SAAS,OAAK,QAAQ,KAAK,eAAgB;AAKjD,QAAO,MAAM,eAAgB,KAAK;AAChC,kDAAK,IAAK,UACR,OAAM,IAAI,MACR;EAIJ,MAAM,iBACC,QAAQ,aACf,MAAM,AAAC,KAA0C,GACjD;EAGA,MAAM,iBAAiB,MAAM,OAAK,QAAQ,QAAQ;AAElD,SAAO;CACR;AAED,QAAO;AACT"}