commandkit 1.2.0-rc.1 → 1.2.0-rc.3

package/dist/commandkit.d.ts

@@ -1,4 +1,4 @@
-import { BootstrapFunction, CommandKit, CommandKitConfiguration, commandkit, onApplicationBootstrap, onBootstrap } from "./analytics-engine-vA4MaJYx.js";
+import { BootstrapFunction, CommandKit, CommandKitConfiguration, commandkit, onApplicationBootstrap, onBootstrap } from "./analytics-engine-nkyqvYAE.js";
 import "./EventInterceptor-x-R2qshQ.js";
 import "./ButtonKit-C7r7RPNf.js";
 import "./ModalKit-Btz58KYn.js";

package/dist/commandkit.js

@@ -1,7 +1,7 @@
 require('./colors-Cd4Oz-r-.js');
 require('./ActionRow-CmTHbo2t.js');
 require('./error-codes-C-ViHyu-.js');
-const require_commandkit = require('./commandkit-DMEW0kJg.js');
+const require_commandkit = require('./commandkit-5VMG2thU.js');
 require('./common-CcfjYnPG.js');
 require('./common-vnMIelAE.js');
 require('./container-z621KfH5.js');
@@ -27,7 +27,7 @@ require('./EventWorkerContext-CSlD9rbx.js');
 require('./signals-DHdYrd-n.js');
 require('./constants-CUND8XkG.js');
 require('./MessageCommandParser-B_BEQ3p8.js');
-require('./CommandsRouter-Ci1Pe8Vd.js');
+require('./CommandsRouter-tMAivEfv.js');
 require('./EventsRouter-C_J0M3uO.js');
 require('./router-DHnFRADH.js');
 require('./common-DNADUU3_.js');

package/dist/components/index.js

@@ -1,7 +1,7 @@
 require('../colors-Cd4Oz-r-.js');
 const require_ActionRow = require('../ActionRow-CmTHbo2t.js');
 require('../error-codes-C-ViHyu-.js');
-const require_commandkit = require('../commandkit-DMEW0kJg.js');
+const require_commandkit = require('../commandkit-5VMG2thU.js');
 require('../common-CcfjYnPG.js');
 require('../common-vnMIelAE.js');
 const require_container = require('../container-z621KfH5.js');
@@ -27,7 +27,7 @@ require('../EventWorkerContext-CSlD9rbx.js');
 require('../signals-DHdYrd-n.js');
 require('../constants-CUND8XkG.js');
 require('../MessageCommandParser-B_BEQ3p8.js');
-require('../CommandsRouter-Ci1Pe8Vd.js');
+require('../CommandsRouter-tMAivEfv.js');
 require('../EventsRouter-C_J0M3uO.js');
 require('../router-DHnFRADH.js');
 require('../common-DNADUU3_.js');

package/dist/components/v1/button/Button.js

@@ -1,7 +1,7 @@
 require('../../../colors-Cd4Oz-r-.js');
 require('../../../ActionRow-CmTHbo2t.js');
 require('../../../error-codes-C-ViHyu-.js');
-const require_commandkit = require('../../../commandkit-DMEW0kJg.js');
+const require_commandkit = require('../../../commandkit-5VMG2thU.js');
 require('../../../common-CcfjYnPG.js');
 require('../../../common-vnMIelAE.js');
 require('../../../container-z621KfH5.js');
@@ -27,7 +27,7 @@ require('../../../EventWorkerContext-CSlD9rbx.js');
 require('../../../signals-DHdYrd-n.js');
 require('../../../constants-CUND8XkG.js');
 require('../../../MessageCommandParser-B_BEQ3p8.js');
-require('../../../CommandsRouter-Ci1Pe8Vd.js');
+require('../../../CommandsRouter-tMAivEfv.js');
 require('../../../EventsRouter-C_J0M3uO.js');
 require('../../../router-DHnFRADH.js');
 require('../../../common-DNADUU3_.js');

package/dist/components/v1/button/ButtonKit.js

@@ -1,7 +1,7 @@
 require('../../../colors-Cd4Oz-r-.js');
 require('../../../ActionRow-CmTHbo2t.js');
 require('../../../error-codes-C-ViHyu-.js');
-const require_commandkit = require('../../../commandkit-DMEW0kJg.js');
+const require_commandkit = require('../../../commandkit-5VMG2thU.js');
 require('../../../common-CcfjYnPG.js');
 require('../../../common-vnMIelAE.js');
 require('../../../container-z621KfH5.js');
@@ -27,7 +27,7 @@ require('../../../EventWorkerContext-CSlD9rbx.js');
 require('../../../signals-DHdYrd-n.js');
 require('../../../constants-CUND8XkG.js');
 require('../../../MessageCommandParser-B_BEQ3p8.js');
-require('../../../CommandsRouter-Ci1Pe8Vd.js');
+require('../../../CommandsRouter-tMAivEfv.js');
 require('../../../EventsRouter-C_J0M3uO.js');
 require('../../../router-DHnFRADH.js');
 require('../../../common-DNADUU3_.js');

package/dist/components/v1/modal/Modal.js

@@ -1,7 +1,7 @@
 require('../../../colors-Cd4Oz-r-.js');
 require('../../../ActionRow-CmTHbo2t.js');
 require('../../../error-codes-C-ViHyu-.js');
-const require_commandkit = require('../../../commandkit-DMEW0kJg.js');
+const require_commandkit = require('../../../commandkit-5VMG2thU.js');
 require('../../../common-CcfjYnPG.js');
 require('../../../common-vnMIelAE.js');
 require('../../../container-z621KfH5.js');
@@ -27,7 +27,7 @@ require('../../../EventWorkerContext-CSlD9rbx.js');
 require('../../../signals-DHdYrd-n.js');
 require('../../../constants-CUND8XkG.js');
 require('../../../MessageCommandParser-B_BEQ3p8.js');
-require('../../../CommandsRouter-Ci1Pe8Vd.js');
+require('../../../CommandsRouter-tMAivEfv.js');
 require('../../../EventsRouter-C_J0M3uO.js');
 require('../../../router-DHnFRADH.js');
 require('../../../common-DNADUU3_.js');

package/dist/components/v1/modal/ModalKit.js

@@ -1,7 +1,7 @@
 require('../../../colors-Cd4Oz-r-.js');
 require('../../../ActionRow-CmTHbo2t.js');
 require('../../../error-codes-C-ViHyu-.js');
-const require_commandkit = require('../../../commandkit-DMEW0kJg.js');
+const require_commandkit = require('../../../commandkit-5VMG2thU.js');
 require('../../../common-CcfjYnPG.js');
 require('../../../common-vnMIelAE.js');
 require('../../../container-z621KfH5.js');
@@ -27,7 +27,7 @@ require('../../../EventWorkerContext-CSlD9rbx.js');
 require('../../../signals-DHdYrd-n.js');
 require('../../../constants-CUND8XkG.js');
 require('../../../MessageCommandParser-B_BEQ3p8.js');
-require('../../../CommandsRouter-Ci1Pe8Vd.js');
+require('../../../CommandsRouter-tMAivEfv.js');
 require('../../../EventsRouter-C_J0M3uO.js');
 require('../../../router-DHnFRADH.js');
 require('../../../common-DNADUU3_.js');

package/dist/components/v1/select-menu/ChannelSelectMenuKit.js

@@ -1,7 +1,7 @@
 require('../../../colors-Cd4Oz-r-.js');
 require('../../../ActionRow-CmTHbo2t.js');
 require('../../../error-codes-C-ViHyu-.js');
-const require_commandkit = require('../../../commandkit-DMEW0kJg.js');
+const require_commandkit = require('../../../commandkit-5VMG2thU.js');
 require('../../../common-CcfjYnPG.js');
 require('../../../common-vnMIelAE.js');
 require('../../../container-z621KfH5.js');
@@ -27,7 +27,7 @@ require('../../../EventWorkerContext-CSlD9rbx.js');
 require('../../../signals-DHdYrd-n.js');
 require('../../../constants-CUND8XkG.js');
 require('../../../MessageCommandParser-B_BEQ3p8.js');
-require('../../../CommandsRouter-Ci1Pe8Vd.js');
+require('../../../CommandsRouter-tMAivEfv.js');
 require('../../../EventsRouter-C_J0M3uO.js');
 require('../../../router-DHnFRADH.js');
 require('../../../common-DNADUU3_.js');

package/dist/components/v1/select-menu/MentionableSelectMenuKit.js

@@ -1,7 +1,7 @@
 require('../../../colors-Cd4Oz-r-.js');
 require('../../../ActionRow-CmTHbo2t.js');
 require('../../../error-codes-C-ViHyu-.js');
-const require_commandkit = require('../../../commandkit-DMEW0kJg.js');
+const require_commandkit = require('../../../commandkit-5VMG2thU.js');
 require('../../../common-CcfjYnPG.js');
 require('../../../common-vnMIelAE.js');
 require('../../../container-z621KfH5.js');
@@ -27,7 +27,7 @@ require('../../../EventWorkerContext-CSlD9rbx.js');
 require('../../../signals-DHdYrd-n.js');
 require('../../../constants-CUND8XkG.js');
 require('../../../MessageCommandParser-B_BEQ3p8.js');
-require('../../../CommandsRouter-Ci1Pe8Vd.js');
+require('../../../CommandsRouter-tMAivEfv.js');
 require('../../../EventsRouter-C_J0M3uO.js');
 require('../../../router-DHnFRADH.js');
 require('../../../common-DNADUU3_.js');

package/dist/components/v1/select-menu/RoleSelectMenuKit.js

@@ -1,7 +1,7 @@
 require('../../../colors-Cd4Oz-r-.js');
 require('../../../ActionRow-CmTHbo2t.js');
 require('../../../error-codes-C-ViHyu-.js');
-const require_commandkit = require('../../../commandkit-DMEW0kJg.js');
+const require_commandkit = require('../../../commandkit-5VMG2thU.js');
 require('../../../common-CcfjYnPG.js');
 require('../../../common-vnMIelAE.js');
 require('../../../container-z621KfH5.js');
@@ -27,7 +27,7 @@ require('../../../EventWorkerContext-CSlD9rbx.js');
 require('../../../signals-DHdYrd-n.js');
 require('../../../constants-CUND8XkG.js');
 require('../../../MessageCommandParser-B_BEQ3p8.js');
-require('../../../CommandsRouter-Ci1Pe8Vd.js');
+require('../../../CommandsRouter-tMAivEfv.js');
 require('../../../EventsRouter-C_J0M3uO.js');
 require('../../../router-DHnFRADH.js');
 require('../../../common-DNADUU3_.js');

package/dist/components/v1/select-menu/SelectMenu.js

@@ -1,7 +1,7 @@
 require('../../../colors-Cd4Oz-r-.js');
 require('../../../ActionRow-CmTHbo2t.js');
 require('../../../error-codes-C-ViHyu-.js');
-const require_commandkit = require('../../../commandkit-DMEW0kJg.js');
+const require_commandkit = require('../../../commandkit-5VMG2thU.js');
 require('../../../common-CcfjYnPG.js');
 require('../../../common-vnMIelAE.js');
 require('../../../container-z621KfH5.js');
@@ -27,7 +27,7 @@ require('../../../EventWorkerContext-CSlD9rbx.js');
 require('../../../signals-DHdYrd-n.js');
 require('../../../constants-CUND8XkG.js');
 require('../../../MessageCommandParser-B_BEQ3p8.js');
-require('../../../CommandsRouter-Ci1Pe8Vd.js');
+require('../../../CommandsRouter-tMAivEfv.js');
 require('../../../EventsRouter-C_J0M3uO.js');
 require('../../../router-DHnFRADH.js');
 require('../../../common-DNADUU3_.js');

package/dist/components/v1/select-menu/StringSelectMenuKit.js

@@ -1,7 +1,7 @@
 require('../../../colors-Cd4Oz-r-.js');
 require('../../../ActionRow-CmTHbo2t.js');
 require('../../../error-codes-C-ViHyu-.js');
-const require_commandkit = require('../../../commandkit-DMEW0kJg.js');
+const require_commandkit = require('../../../commandkit-5VMG2thU.js');
 require('../../../common-CcfjYnPG.js');
 require('../../../common-vnMIelAE.js');
 require('../../../container-z621KfH5.js');
@@ -27,7 +27,7 @@ require('../../../EventWorkerContext-CSlD9rbx.js');
 require('../../../signals-DHdYrd-n.js');
 require('../../../constants-CUND8XkG.js');
 require('../../../MessageCommandParser-B_BEQ3p8.js');
-require('../../../CommandsRouter-Ci1Pe8Vd.js');
+require('../../../CommandsRouter-tMAivEfv.js');
 require('../../../EventsRouter-C_J0M3uO.js');
 require('../../../router-DHnFRADH.js');
 require('../../../common-DNADUU3_.js');

package/dist/components/v1/select-menu/UserSelectMenuKit.js

@@ -1,7 +1,7 @@
 require('../../../colors-Cd4Oz-r-.js');
 require('../../../ActionRow-CmTHbo2t.js');
 require('../../../error-codes-C-ViHyu-.js');
-const require_commandkit = require('../../../commandkit-DMEW0kJg.js');
+const require_commandkit = require('../../../commandkit-5VMG2thU.js');
 require('../../../common-CcfjYnPG.js');
 require('../../../common-vnMIelAE.js');
 require('../../../container-z621KfH5.js');
@@ -27,7 +27,7 @@ require('../../../EventWorkerContext-CSlD9rbx.js');
 require('../../../signals-DHdYrd-n.js');
 require('../../../constants-CUND8XkG.js');
 require('../../../MessageCommandParser-B_BEQ3p8.js');
-require('../../../CommandsRouter-Ci1Pe8Vd.js');
+require('../../../CommandsRouter-tMAivEfv.js');
 require('../../../EventsRouter-C_J0M3uO.js');
 require('../../../router-DHnFRADH.js');
 require('../../../common-DNADUU3_.js');

package/dist/config/config.d.ts

@@ -1,4 +1,4 @@
-import "../analytics-engine-vA4MaJYx.js";
+import "../analytics-engine-nkyqvYAE.js";
 import "../EventInterceptor-x-R2qshQ.js";
 import "../ButtonKit-C7r7RPNf.js";
 import "../ModalKit-Btz58KYn.js";
@@ -29,5 +29,5 @@ import "../CommandsRouter-CoOA7hkf.js";
 import "../EventsRouter-BacqK6z3.js";
 import "../index-DKcmsWXw.js";
 import "../constants-MKu-Q1jh.js";
-import { defineConfig, getConfig } from "../config-CcWJ-vz5.js";
+import { defineConfig, getConfig } from "../config-C1msSu1G.js";
 export { defineConfig, getConfig };

package/dist/config/config.js

@@ -1,7 +1,7 @@
 require('../colors-Cd4Oz-r-.js');
 require('../ActionRow-CmTHbo2t.js');
 require('../error-codes-C-ViHyu-.js');
-const require_commandkit = require('../commandkit-DMEW0kJg.js');
+const require_commandkit = require('../commandkit-5VMG2thU.js');
 require('../common-CcfjYnPG.js');
 require('../common-vnMIelAE.js');
 require('../container-z621KfH5.js');
@@ -27,7 +27,7 @@ require('../EventWorkerContext-CSlD9rbx.js');
 require('../signals-DHdYrd-n.js');
 require('../constants-CUND8XkG.js');
 require('../MessageCommandParser-B_BEQ3p8.js');
-require('../CommandsRouter-Ci1Pe8Vd.js');
+require('../CommandsRouter-tMAivEfv.js');
 require('../EventsRouter-C_J0M3uO.js');
 require('../router-DHnFRADH.js');
 require('../common-DNADUU3_.js');

package/dist/config/default.d.ts

@@ -1,4 +1,4 @@
-import { ResolvedCommandKitConfig } from "../analytics-engine-vA4MaJYx.js";
+import { ResolvedCommandKitConfig } from "../analytics-engine-nkyqvYAE.js";
 import "../EventInterceptor-x-R2qshQ.js";
 import "../ButtonKit-C7r7RPNf.js";
 import "../ModalKit-Btz58KYn.js";

package/dist/config/default.js

@@ -1,7 +1,7 @@
 require('../colors-Cd4Oz-r-.js');
 require('../ActionRow-CmTHbo2t.js');
 require('../error-codes-C-ViHyu-.js');
-const require_commandkit = require('../commandkit-DMEW0kJg.js');
+const require_commandkit = require('../commandkit-5VMG2thU.js');
 require('../common-CcfjYnPG.js');
 require('../common-vnMIelAE.js');
 require('../container-z621KfH5.js');
@@ -27,7 +27,7 @@ require('../EventWorkerContext-CSlD9rbx.js');
 require('../signals-DHdYrd-n.js');
 require('../constants-CUND8XkG.js');
 require('../MessageCommandParser-B_BEQ3p8.js');
-require('../CommandsRouter-Ci1Pe8Vd.js');
+require('../CommandsRouter-tMAivEfv.js');
 require('../EventsRouter-C_J0M3uO.js');
 require('../router-DHnFRADH.js');
 require('../common-DNADUU3_.js');

package/dist/config/loader.d.ts

@@ -1,4 +1,4 @@
-import { CommandKitConfig, DeepRequired } from "../analytics-engine-vA4MaJYx.js";
+import { CommandKitConfig, DeepRequired } from "../analytics-engine-nkyqvYAE.js";
 import "../EventInterceptor-x-R2qshQ.js";
 import "../ButtonKit-C7r7RPNf.js";
 import "../ModalKit-Btz58KYn.js";

package/dist/config/loader.js

@@ -1,7 +1,7 @@
 require('../colors-Cd4Oz-r-.js');
 require('../ActionRow-CmTHbo2t.js');
 require('../error-codes-C-ViHyu-.js');
-const require_commandkit = require('../commandkit-DMEW0kJg.js');
+const require_commandkit = require('../commandkit-5VMG2thU.js');
 require('../common-CcfjYnPG.js');
 require('../common-vnMIelAE.js');
 require('../container-z621KfH5.js');
@@ -27,7 +27,7 @@ require('../EventWorkerContext-CSlD9rbx.js');
 require('../signals-DHdYrd-n.js');
 require('../constants-CUND8XkG.js');
 require('../MessageCommandParser-B_BEQ3p8.js');
-require('../CommandsRouter-Ci1Pe8Vd.js');
+require('../CommandsRouter-tMAivEfv.js');
 require('../EventsRouter-C_J0M3uO.js');
 require('../router-DHnFRADH.js');
 require('../common-DNADUU3_.js');

package/dist/config/types.d.ts

@@ -1,4 +1,4 @@
-import { CommandKitCompilerOptions, CommandKitConfig } from "../analytics-engine-vA4MaJYx.js";
+import { CommandKitCompilerOptions, CommandKitConfig } from "../analytics-engine-nkyqvYAE.js";
 import "../EventInterceptor-x-R2qshQ.js";
 import "../ButtonKit-C7r7RPNf.js";
 import "../ModalKit-Btz58KYn.js";

package/dist/config/utils.d.ts

@@ -1,4 +1,4 @@
-import { DeepPartial, DeepRequired, ResolvedCommandKitConfig, mergeDeep } from "../analytics-engine-vA4MaJYx.js";
+import { DeepPartial, DeepRequired, ResolvedCommandKitConfig, mergeDeep } from "../analytics-engine-nkyqvYAE.js";
 import "../EventInterceptor-x-R2qshQ.js";
 import "../ButtonKit-C7r7RPNf.js";
 import "../ModalKit-Btz58KYn.js";

package/dist/{config-CcWJ-vz5.d.ts → config-C1msSu1G.d.ts}

@@ -1,4 +1,4 @@
-import { CommandKitConfig, ResolvedCommandKitConfig } from "./analytics-engine-vA4MaJYx.js";
+import { CommandKitConfig, ResolvedCommandKitConfig } from "./analytics-engine-nkyqvYAE.js";
 
 //#region src/config/config.d.ts
 
@@ -13,4 +13,4 @@ declare function getConfig(): ResolvedCommandKitConfig;
 declare function defineConfig(config?: Partial<CommandKitConfig>): ResolvedCommandKitConfig;
 //#endregion
 export { defineConfig, getConfig };
-//# sourceMappingURL=config-CcWJ-vz5.d.ts.map
+//# sourceMappingURL=config-C1msSu1G.d.ts.map

package/dist/{constants-DrjIvQd6.d.ts → constants-D8PMA9on.d.ts}

@@ -16,4 +16,4 @@ declare enum SerializerType {
 }
 //#endregion
 export { SerializerType };
-//# sourceMappingURL=constants-DrjIvQd6.d.ts.map
+//# sourceMappingURL=constants-D8PMA9on.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 "../analytics-engine-vA4MaJYx.js";
+import { AsyncFunction, GenericFunction, exitContext, getCommandKit, getContext, isCommandWorkerContext, makeContextAwareFunction, provideContext, useEnvironment } from "../analytics-engine-nkyqvYAE.js";
 import "../EventInterceptor-x-R2qshQ.js";
 import "../ButtonKit-C7r7RPNf.js";
 import "../ModalKit-Btz58KYn.js";

package/dist/context/async-context.js

@@ -1,7 +1,7 @@
 require('../colors-Cd4Oz-r-.js');
 require('../ActionRow-CmTHbo2t.js');
 require('../error-codes-C-ViHyu-.js');
-const require_commandkit = require('../commandkit-DMEW0kJg.js');
+const require_commandkit = require('../commandkit-5VMG2thU.js');
 require('../common-CcfjYnPG.js');
 require('../common-vnMIelAE.js');
 require('../container-z621KfH5.js');
@@ -27,7 +27,7 @@ require('../EventWorkerContext-CSlD9rbx.js');
 require('../signals-DHdYrd-n.js');
 require('../constants-CUND8XkG.js');
 require('../MessageCommandParser-B_BEQ3p8.js');
-require('../CommandsRouter-Ci1Pe8Vd.js');
+require('../CommandsRouter-tMAivEfv.js');
 require('../EventsRouter-C_J0M3uO.js');
 require('../router-DHnFRADH.js');
 require('../common-DNADUU3_.js');

package/dist/context/environment.d.ts

@@ -1,4 +1,4 @@
-import { CommandKitEnvironment, CommandKitEnvironmentInternalData, CommandKitEnvironmentType, after, cancelAfter } from "../analytics-engine-vA4MaJYx.js";
+import { CommandKitEnvironment, CommandKitEnvironmentInternalData, CommandKitEnvironmentType, after, cancelAfter } from "../analytics-engine-nkyqvYAE.js";
 import "../EventInterceptor-x-R2qshQ.js";
 import "../ButtonKit-C7r7RPNf.js";
 import "../ModalKit-Btz58KYn.js";

package/dist/context/environment.js

@@ -1,7 +1,7 @@
 require('../colors-Cd4Oz-r-.js');
 require('../ActionRow-CmTHbo2t.js');
 require('../error-codes-C-ViHyu-.js');
-const require_commandkit = require('../commandkit-DMEW0kJg.js');
+const require_commandkit = require('../commandkit-5VMG2thU.js');
 require('../common-CcfjYnPG.js');
 require('../common-vnMIelAE.js');
 require('../container-z621KfH5.js');
@@ -27,7 +27,7 @@ require('../EventWorkerContext-CSlD9rbx.js');
 require('../signals-DHdYrd-n.js');
 require('../constants-CUND8XkG.js');
 require('../MessageCommandParser-B_BEQ3p8.js');
-require('../CommandsRouter-Ci1Pe8Vd.js');
+require('../CommandsRouter-tMAivEfv.js');
 require('../EventsRouter-C_J0M3uO.js');
 require('../router-DHnFRADH.js');
 require('../common-DNADUU3_.js');

package/dist/error-codes-BzoEctmD.d.ts

@@ -0,0 +1,54 @@
+//#region src/utils/error-codes.d.ts
+/**
+ * The error codes used by CommandKit.
+ */
+declare const CommandKitErrorCodes: {
+  /**
+   * Error code for exiting middleware.
+   */
+  readonly ExitMiddleware: symbol;
+  /**
+   * Error code for forwarded commands.
+   */
+  readonly ForwardedCommand: symbol;
+  /**
+   * Error code for invalid command prefix.
+   */
+  readonly InvalidCommandPrefix: symbol;
+  /**
+   * Error code for plugin capture handle.
+   */
+  readonly PluginCaptureHandle: symbol;
+  /**
+   * Error code for event interruption signal
+   */
+  readonly StopEvents: symbol;
+};
+/**
+ * The type for CommandKit errors.
+ */
+type CommandKitError = Error & {
+  code: symbol;
+};
+/**
+ * Creates a new CommandKit error with the specified code.
+ * @param code The error code to assign to the error.
+ * @returns A new CommandKit error instance.
+ */
+declare function createCommandKitError(code: symbol): CommandKitError;
+/**
+ * Checks if the given error is a CommandKit error.
+ * @param error The error to check.
+ * @returns True if the error is a CommandKit error, false otherwise.
+ */
+declare function isCommandKitError(error: unknown): error is CommandKitError;
+/**
+ * Checks if the given error is of a specific CommandKit error type.
+ * @param error The error to check.
+ * @param code The error code or an array of error codes to check against.
+ * @returns True if the error matches the specified code(s), false otherwise.
+ */
+declare function isErrorType(error: unknown, code: symbol | symbol[]): boolean;
+//#endregion
+export { CommandKitError, CommandKitErrorCodes, createCommandKitError, isCommandKitError, isErrorType };
+//# sourceMappingURL=error-codes-BzoEctmD.d.ts.map

package/dist/events/CommandKitEventsChannel.d.ts

@@ -1,4 +1,4 @@
-import { CommandKitEventsChannel, ListenerFunction } from "../analytics-engine-vA4MaJYx.js";
+import { CommandKitEventsChannel, ListenerFunction } from "../analytics-engine-nkyqvYAE.js";
 import "../EventInterceptor-x-R2qshQ.js";
 import "../ButtonKit-C7r7RPNf.js";
 import "../ModalKit-Btz58KYn.js";

package/dist/{feature-flags-Cxl9JtVG.js → feature-flags-C44dggkN.js}

@@ -1,4 +1,4 @@
-const require_commandkit = require('./commandkit-DMEW0kJg.js');
+const require_commandkit = require('./commandkit-5VMG2thU.js');
 const require_EventWorkerContext = require('./EventWorkerContext-CSlD9rbx.js');
 const require_constants = require('./constants-CUND8XkG.js');
 
@@ -162,4 +162,4 @@ Object.defineProperty(exports, 'setFlagProvider', {
     return setFlagProvider;
   }
 });
-//# sourceMappingURL=feature-flags-Cxl9JtVG.js.map
+//# sourceMappingURL=feature-flags-C44dggkN.js.map

package/dist/{feature-flags-Cxl9JtVG.js.map → feature-flags-C44dggkN.js.map}

@@ -1 +1 @@
-{"version":3,"file":"feature-flags-Cxl9JtVG.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\n/**\n * @private\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\n/**\n * Context for evaluating command flags in CommandKit.\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\n/**\n * Context for evaluating event flags in CommandKit.\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":"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"}
+{"version":3,"file":"feature-flags-C44dggkN.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\n/**\n * @private\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\n/**\n * Context for evaluating command flags in CommandKit.\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\n/**\n * Context for evaluating event flags in CommandKit.\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":"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"}

package/dist/flags/FlagProvider.d.ts

@@ -1,4 +1,4 @@
-import { FlagConfiguration, FlagProvider, JsonFlagProvider } from "../analytics-engine-vA4MaJYx.js";
+import { FlagConfiguration, FlagProvider, JsonFlagProvider } from "../analytics-engine-nkyqvYAE.js";
 import "../EventInterceptor-x-R2qshQ.js";
 import "../ButtonKit-C7r7RPNf.js";
 import "../ModalKit-Btz58KYn.js";

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

@@ -1,4 +1,4 @@
-import { CommandFlagContext, CustomEvaluationContext, CustomEvaluationFunction, DecideFunction, EvaluationContext, EventFlagContext, FeatureFlag, FeatureFlagDefinition, FlagRunner, IdentifyFunction, MaybePromise, flag, setFlagProvider } from "../analytics-engine-vA4MaJYx.js";
+import { CommandFlagContext, CustomEvaluationContext, CustomEvaluationFunction, DecideFunction, EvaluationContext, EventFlagContext, FeatureFlag, FeatureFlagDefinition, FlagRunner, IdentifyFunction, MaybePromise, flag, setFlagProvider } from "../analytics-engine-nkyqvYAE.js";
 import "../EventInterceptor-x-R2qshQ.js";
 import "../ButtonKit-C7r7RPNf.js";
 import "../ModalKit-Btz58KYn.js";

package/dist/flags/feature-flags.js

@@ -1,7 +1,7 @@
 require('../colors-Cd4Oz-r-.js');
 require('../ActionRow-CmTHbo2t.js');
 require('../error-codes-C-ViHyu-.js');
-require('../commandkit-DMEW0kJg.js');
+require('../commandkit-5VMG2thU.js');
 require('../common-CcfjYnPG.js');
 require('../common-vnMIelAE.js');
 require('../container-z621KfH5.js');
@@ -27,13 +27,13 @@ require('../EventWorkerContext-CSlD9rbx.js');
 require('../signals-DHdYrd-n.js');
 require('../constants-CUND8XkG.js');
 require('../MessageCommandParser-B_BEQ3p8.js');
-require('../CommandsRouter-Ci1Pe8Vd.js');
+require('../CommandsRouter-tMAivEfv.js');
 require('../EventsRouter-C_J0M3uO.js');
 require('../router-DHnFRADH.js');
 require('../common-DNADUU3_.js');
 require('../CommandKitEventsChannel-Bgw0XCOl.js');
 require('../store-CiqLHedg.js');
-const require_feature_flags = require('../feature-flags-Cxl9JtVG.js');
+const require_feature_flags = require('../feature-flags-C44dggkN.js');
 
 exports.FeatureFlag = require_feature_flags.FeatureFlag;
 exports.flag = require_feature_flags.flag;

package/dist/flags/store.d.ts

@@ -1,4 +1,4 @@
-import { FlagStore } from "../analytics-engine-vA4MaJYx.js";
+import { FlagStore } from "../analytics-engine-nkyqvYAE.js";
 import "../EventInterceptor-x-R2qshQ.js";
 import "../ButtonKit-C7r7RPNf.js";
 import "../ModalKit-Btz58KYn.js";