commandkit 1.0.0-dev.20250605143740 → 1.0.0-dev.20250606020134

package/dist/{constants-Do7znYzW.js → constants-DWe181uQ.js}

@@ -5,6 +5,8 @@ const node_crypto = require_chunk.__toESM(require("node:crypto"));
 const DO_NOT_TRACK_KEY = `COMMANDKIT_ANALYTICS__DO_NOT_TRACK::${(0, node_crypto.randomUUID)()}`;
 const AnalyticsEvents = {
 	COMMAND_EXECUTION: "command_execution",
+	FEATURE_FLAG_METRICS: "feature_flag_metrics",
+	FEATURE_FLAG_DECISION: "feature_flag_decision",
 	CACHE_HIT: "cache_hit",
 	CACHE_MISS: "cache_miss",
 	CACHE_REVALIDATED: "cache_revalidated"
@@ -23,4 +25,4 @@ Object.defineProperty(exports, 'DO_NOT_TRACK_KEY', {
     return DO_NOT_TRACK_KEY;
   }
 });
-//# sourceMappingURL=constants-Do7znYzW.js.map
+//# sourceMappingURL=constants-DWe181uQ.js.map

package/dist/constants-DWe181uQ.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants-DWe181uQ.js","names":[],"sources":["../src/analytics/constants.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nexport const DO_NOT_TRACK_KEY = `COMMANDKIT_ANALYTICS__DO_NOT_TRACK::${randomUUID()}`;\n\nexport const AnalyticsEvents = {\n  // commands\n  COMMAND_EXECUTION: 'command_execution',\n  // feature flags\n  FEATURE_FLAG_METRICS: 'feature_flag_metrics',\n  FEATURE_FLAG_DECISION: 'feature_flag_decision',\n  // @commandkit/cache\n  CACHE_HIT: 'cache_hit',\n  CACHE_MISS: 'cache_miss',\n  CACHE_REVALIDATED: 'cache_revalidated',\n} as const;\n\nexport type AnalyticsEvent =\n  (typeof AnalyticsEvents)[keyof typeof AnalyticsEvents];\n"],"mappings":";;;;AAEA,MAAa,oBAAoB,sCAAsC,6BAAY,CAAC;AAEpF,MAAa,kBAAkB;CAE7B,mBAAmB;CAEnB,sBAAsB;CACtB,uBAAuB;CAEvB,WAAW;CACX,YAAY;CACZ,mBAAmB;AACpB"}

package/dist/context/async-context.js

@@ -1,7 +1,7 @@
 require('../colors-Cd4Oz-r-.js');
 require('../ActionRow-CmTHbo2t.js');
 require('../error-codes-C_UO39jz.js');
-const require_CommandKit = require('../CommandKit-czUX38Mz.js');
+const require_CommandKit = require('../CommandKit-D8HJegdh.js');
 require('../common-CcfjYnPG.js');
 require('../common-CeO-vn8Y.js');
 require('../container-CpuiLsZM.js');
@@ -26,7 +26,7 @@ require('../EventWorkerContext-BAKiTqJz.js');
 require('../resolve-file-url-ifwdwqmq.js');
 require('../MessageCommandParser-D02-wpZN.js');
 require('../signals-scJdEbly.js');
-require('../constants-Do7znYzW.js');
+require('../constants-DWe181uQ.js');
 require('../types-package-CTSNSM93.js');
 require('../CommandsRouter-BHaPno8o.js');
 require('../EventsRouter-CqnrlbjN.js');

package/dist/context/environment.js

@@ -1,7 +1,7 @@
 require('../colors-Cd4Oz-r-.js');
 require('../ActionRow-CmTHbo2t.js');
 require('../error-codes-C_UO39jz.js');
-const require_CommandKit = require('../CommandKit-czUX38Mz.js');
+const require_CommandKit = require('../CommandKit-D8HJegdh.js');
 require('../common-CcfjYnPG.js');
 require('../common-CeO-vn8Y.js');
 require('../container-CpuiLsZM.js');
@@ -26,7 +26,7 @@ require('../EventWorkerContext-BAKiTqJz.js');
 require('../resolve-file-url-ifwdwqmq.js');
 require('../MessageCommandParser-D02-wpZN.js');
 require('../signals-scJdEbly.js');
-require('../constants-Do7znYzW.js');
+require('../constants-DWe181uQ.js');
 require('../types-package-CTSNSM93.js');
 require('../CommandsRouter-BHaPno8o.js');
 require('../EventsRouter-CqnrlbjN.js');

package/dist/{feature-flags-2jhIRnS6.js → feature-flags-DBD8a_eD.js}

@@ -1,5 +1,6 @@
-const require_CommandKit = require('./CommandKit-czUX38Mz.js');
+const require_CommandKit = require('./CommandKit-D8HJegdh.js');
 const require_EventWorkerContext = require('./EventWorkerContext-BAKiTqJz.js');
+const require_constants = require('./constants-DWe181uQ.js');
 
 //#region src/flags/feature-flags.ts
 var FeatureFlag = class {
@@ -62,7 +63,7 @@ var FeatureFlag = class {
 		const decisionTime = performance.now() - decisionStart;
 		require_CommandKit.defer(async () => {
 			await this.commandkit.analytics.track({
-				name: "feature_flag_metrics",
+				name: require_constants.AnalyticsEvents.FEATURE_FLAG_METRICS,
 				data: {
 					flag: this.options.key,
 					identificationTime: identificationTime.toFixed(2),
@@ -72,7 +73,7 @@ var FeatureFlag = class {
 		});
 		require_CommandKit.defer(async () => {
 			await this.commandkit.analytics.track({
-				name: "feature_flag_decision",
+				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,
@@ -108,4 +109,4 @@ Object.defineProperty(exports, 'flag', {
     return flag;
   }
 });
-//# sourceMappingURL=feature-flags-2jhIRnS6.js.map
+//# sourceMappingURL=feature-flags-DBD8a_eD.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flags-DBD8a_eD.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"}

package/dist/flags/feature-flags.js

@@ -1,7 +1,7 @@
 require('../colors-Cd4Oz-r-.js');
 require('../ActionRow-CmTHbo2t.js');
 require('../error-codes-C_UO39jz.js');
-require('../CommandKit-czUX38Mz.js');
+require('../CommandKit-D8HJegdh.js');
 require('../common-CcfjYnPG.js');
 require('../common-CeO-vn8Y.js');
 require('../container-CpuiLsZM.js');
@@ -26,7 +26,7 @@ require('../EventWorkerContext-BAKiTqJz.js');
 require('../resolve-file-url-ifwdwqmq.js');
 require('../MessageCommandParser-D02-wpZN.js');
 require('../signals-scJdEbly.js');
-require('../constants-Do7znYzW.js');
+require('../constants-DWe181uQ.js');
 require('../types-package-CTSNSM93.js');
 require('../CommandsRouter-BHaPno8o.js');
 require('../EventsRouter-CqnrlbjN.js');
@@ -34,7 +34,7 @@ require('../router-Dn35v30f.js');
 require('../common-CW8v7gAn.js');
 require('../CommandKitEventsChannel-B6LKgxmv.js');
 require('../store-Ci6ib2C9.js');
-const require_feature_flags = require('../feature-flags-2jhIRnS6.js');
+const require_feature_flags = require('../feature-flags-DBD8a_eD.js');
 
 exports.FeatureFlag = require_feature_flags.FeatureFlag;
 exports.flag = require_feature_flags.flag;

package/dist/index.js

@@ -2,7 +2,7 @@ Object.defineProperty(exports, '__esModule', { value: true });
 require('./colors-Cd4Oz-r-.js');
 const require_ActionRow = require('./ActionRow-CmTHbo2t.js');
 require('./error-codes-C_UO39jz.js');
-const require_CommandKit = require('./CommandKit-czUX38Mz.js');
+const require_CommandKit = require('./CommandKit-D8HJegdh.js');
 require('./common-CcfjYnPG.js');
 require('./common-CeO-vn8Y.js');
 const require_container = require('./container-CpuiLsZM.js');
@@ -27,7 +27,7 @@ const require_EventWorkerContext = require('./EventWorkerContext-BAKiTqJz.js');
 require('./resolve-file-url-ifwdwqmq.js');
 const require_MessageCommandParser = require('./MessageCommandParser-D02-wpZN.js');
 const require_signals = require('./signals-scJdEbly.js');
-require('./constants-Do7znYzW.js');
+require('./constants-DWe181uQ.js');
 require('./types-package-CTSNSM93.js');
 const require_CommandsRouter = require('./CommandsRouter-BHaPno8o.js');
 const require_EventsRouter = require('./EventsRouter-CqnrlbjN.js');
@@ -38,9 +38,9 @@ require('./store-Ci6ib2C9.js');
 const require_helpers = require('./helpers-CswC9gKF.js');
 require('./app-CXCbKsPz.js');
 require('./ILogger-DucYb0bG.js');
-const require_version = require('./version-Cxwx9WK4.js');
-const require_feature_flags = require('./feature-flags-2jhIRnS6.js');
-const require_init = require('./init-D5lt58YO.js');
+const require_version = require('./version-C9ijCrHf.js');
+const require_feature_flags = require('./feature-flags-DBD8a_eD.js');
+const require_init = require('./init-B2LsvQoh.js');
 
 //#region src/index.ts
 var src_default = require_CommandKit.CommandKit;

package/dist/{init-D5lt58YO.js → init-B2LsvQoh.js}

@@ -1,5 +1,5 @@
 const require_chunk = require('./chunk-nOFOJqeH.js');
-const require_CommandKit = require('./CommandKit-czUX38Mz.js');
+const require_CommandKit = require('./CommandKit-D8HJegdh.js');
 const require_CompilerPlugin = require('./CompilerPlugin-DrnhOC1c.js');
 const require_CompilerPluginRuntime = require('./CompilerPluginRuntime-C9wmPMQf.js');
 const require_types_package = require('./types-package-CTSNSM93.js');
@@ -89,4 +89,4 @@ Object.defineProperty(exports, 'bootstrapCommandkitCLI', {
     return bootstrapCommandkitCLI;
   }
 });
-//# sourceMappingURL=init-D5lt58YO.js.map
+//# sourceMappingURL=init-B2LsvQoh.js.map

package/dist/{init-D5lt58YO.js.map → init-B2LsvQoh.js.map}

@@ -1 +1 @@
-{"version":3,"file":"init-D5lt58YO.js","names":[],"sources":["../src/cli/init.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { mkdir } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { generateTypesPackage } from '../utils/types-package';\nimport { loadConfigFile } from '../config/loader';\nimport {\n  CompilerPlugin,\n  CompilerPluginRuntime,\n  isCompilerPlugin,\n} from '../plugins';\nimport { panic } from './common';\n\n/**\n * Creates a command line interface for CommandKit.\n * @param argv The arguments passed to the CLI.\n * @param options The options passed to the CLI.\n */\nexport async function bootstrapCommandkitCLI(\n  argv: string[],\n  options?: import('commander').ParseOptions | undefined,\n) {\n  process.title = 'CommandKit CLI';\n\n  // imports are lazily loaded when the cli is used, instead of loading it with the lib itself\n  const { Command } = await import('commander');\n  const { bootstrapDevelopmentServer } = await import('./development');\n  const { bootstrapProductionServer, createProductionBuild } = await import(\n    './production'\n  );\n  const { generateCommand, generateEvent } = await import('./generators');\n  const { version } = await import('../version');\n  const { showInformation } = await import('./information');\n  const { setCLIEnv } = await import('./env');\n\n  const program = new Command('commandkit');\n\n  program\n    .command('dev')\n    .version(version)\n    .description('Start your bot in development mode.')\n    .option(\n      '-c, --config [path]',\n      'Path to your commandkit config file.',\n      './commandkit.js',\n    )\n    .action(() => {\n      const options = program.opts();\n      bootstrapDevelopmentServer(options.config);\n    });\n\n  program\n    .command('info')\n    .description(\n      'Show information about the system which can be used to report bugs.',\n    )\n    .action(async () => {\n      await showInformation();\n    });\n\n  program\n    .command('start')\n    .description(\n      'Start your bot in production mode after running the build command.',\n    )\n    .option('-c, --config [path]', 'Path to your commandkit config file.')\n    .action(() => {\n      const options = program.opts();\n      bootstrapProductionServer(options.config);\n    });\n\n  program\n    .command('build')\n    .description('Build your project for production usage.')\n    .option('-c, --config [path]', 'Path to your commandkit config file.')\n    .action(() => {\n      setCLIEnv();\n      const options = program.opts();\n      return createProductionBuild(options.config);\n    });\n\n  program\n    .command('create')\n    .description(\n      'Create new files using built-in templates or custom plugin templates',\n    )\n    .argument(\n      '<template>',\n      'The template to use (e.g. command, event, or custom plugin template)',\n    )\n    .argument('[args...]', 'Additional arguments for the template')\n    .action(async (template, args) => {\n      setCLIEnv();\n\n      // Handle custom plugin templates\n      const { plugins } = await loadConfigFile();\n      const runtime = new CompilerPluginRuntime(\n        plugins.filter((p) => isCompilerPlugin(p)) as CompilerPlugin[],\n      );\n\n      try {\n        await runtime.init();\n        const templateHandler = runtime.getTemplate(template);\n\n        if (!templateHandler) {\n          // Handle built-in templates\n          if (template === 'command') {\n            const [name] = args;\n            if (!name) {\n              panic('Command name is required');\n            }\n            await generateCommand(name);\n            return;\n          }\n\n          if (template === 'event') {\n            const [name] = args;\n            if (!name) {\n              panic('Event name is required');\n            }\n            await generateEvent(name);\n            return;\n          }\n\n          const valid = Array.from(\n            new Set([\n              'command',\n              'event',\n              ...Array.from(runtime.getTemplates().keys()),\n            ]),\n          ).map((t) => `\"${t}\"`);\n\n          panic(\n            `Template \"${template}\" not found. Available templates: ${valid.join(', ')}`,\n          );\n        }\n\n        await templateHandler(args);\n      } catch (e: any) {\n        panic(`Failed to execute template \"${template}\": ${e?.message || e}`);\n      } finally {\n        await runtime.destroy();\n      }\n    });\n\n  const types = join(process.cwd(), 'node_modules', 'commandkit-types');\n\n  if (!existsSync(types)) {\n    await mkdir(types, { recursive: true }).catch(() => {});\n    await generateTypesPackage(true).catch(() => {});\n  }\n\n  await program.parseAsync(argv, options);\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAiBA,eAAsB,uBACtB,MACA,SACA;AACE,SAAQ,QAAQ;CAGhB,MAAM,EAAE,SAAS,GAAG,MAAM,OAAO;CACjC,MAAM,EAAE,4BAA4B,GAAG,2CAAM;CAC7C,MAAM,EAAE,2BAA2B,uBAAuB,GAAG,2CAAM;CAGnE,MAAM,EAAE,iBAAiB,eAAe,GAAG,2CAAM;CACjD,MAAM,EAAE,SAAS,GAAG,2CAAM;CAC1B,MAAM,EAAE,iBAAiB,GAAG,2CAAM;CAClC,MAAM,EAAE,WAAW,GAAG,2CAAM;CAE5B,MAAM,UAAU,IAAI,QAAQ;AAE5B,SACA,QAAQ,MAAM,CACd,QAAQ,QAAQ,CAChB,YAAY,sCAAsC,CAClD,OACE,uBACA,wCACA,kBACD,CACD,OAAO,MAAM;EACX,MAAM,YAAU,QAAQ,MAAM;AAC9B,6BAA2B,UAAQ,OAAO;CAC3C,EAAC;AAEF,SACA,QAAQ,OAAO,CACf,YACE,sEACD,CACD,OAAO,YAAY;AACjB,QAAM,iBAAiB;CACxB,EAAC;AAEF,SACA,QAAQ,QAAQ,CAChB,YACE,qEACD,CACD,OAAO,uBAAuB,uCAAuC,CACrE,OAAO,MAAM;EACX,MAAM,YAAU,QAAQ,MAAM;AAC9B,4BAA0B,UAAQ,OAAO;CAC1C,EAAC;AAEF,SACA,QAAQ,QAAQ,CAChB,YAAY,2CAA2C,CACvD,OAAO,uBAAuB,uCAAuC,CACrE,OAAO,MAAM;AACX,aAAW;EACX,MAAM,YAAU,QAAQ,MAAM;AAC9B,SAAO,sBAAsB,UAAQ,OAAO;CAC7C,EAAC;AAEF,SACA,QAAQ,SAAS,CACjB,YACE,uEACD,CACD,SACE,cACA,uEACD,CACD,SAAS,aAAa,wCAAwC,CAC9D,OAAO,OAAO,UAAU,SAAS;AAC/B,aAAW;EAGX,MAAM,EAAE,SAAS,GAAG,MAAM,mCAAgB;EAC1C,MAAM,UAAU,IAAI,oDAClB,QAAQ,OAAO,CAAC,MAAM,wCAAiB,EAAE,CAAC;AAG5C,MAAI;AACF,SAAM,QAAQ,MAAM;GACpB,MAAM,kBAAkB,QAAQ,YAAY,SAAS;AAErD,QAAK,iBAAiB;AAEpB,QAAI,aAAa,WAAW;KAC1B,MAAM,CAAC,KAAK,GAAG;AACf,UAAK,KACH,sBAAM,2BAA2B;AAEnC,WAAM,gBAAgB,KAAK;AAC3B;IACD;AAED,QAAI,aAAa,SAAS;KACxB,MAAM,CAAC,KAAK,GAAG;AACf,UAAK,KACH,sBAAM,yBAAyB;AAEjC,WAAM,cAAc,KAAK;AACzB;IACD;IAED,MAAM,QAAQ,MAAM,KAClB,IAAI,IAAI;KACR;KACA;KACA,GAAG,MAAM,KAAK,QAAQ,cAAc,CAAC,MAAM,CAAC;IAAC,GAE9C,CAAC,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG;AAEtB,0BACG,YAAY,SAAS,oCAAoC,MAAM,KAAK,KAAK,CAAC,EAC5E;GACF;AAED,SAAM,gBAAgB,KAAK;EAC5B,SAAQ,GAAQ;AACf,yBAAO,8BAA8B,SAAS,4CAAK,EAAG,YAAW,EAAE,EAAE;EACtE,UAAS;AACR,SAAM,QAAQ,SAAS;EACxB;CACF,EAAC;CAEF,MAAM,QAAQ,oBAAK,QAAQ,KAAK,EAAE,gBAAgB,mBAAmB;AAErE,MAAK,wBAAW,MAAM,EAAE;AACtB,QAAM,4BAAM,OAAO,EAAE,WAAW,KAAM,EAAC,CAAC,MAAM,MAAM,CAAE,EAAC;AACvD,QAAM,2CAAqB,KAAK,CAAC,MAAM,MAAM,CAAE,EAAC;CAClD;AAEA,OAAM,QAAQ,WAAW,MAAM,QAAQ;AACzC"}
+{"version":3,"file":"init-B2LsvQoh.js","names":[],"sources":["../src/cli/init.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { mkdir } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { generateTypesPackage } from '../utils/types-package';\nimport { loadConfigFile } from '../config/loader';\nimport {\n  CompilerPlugin,\n  CompilerPluginRuntime,\n  isCompilerPlugin,\n} from '../plugins';\nimport { panic } from './common';\n\n/**\n * Creates a command line interface for CommandKit.\n * @param argv The arguments passed to the CLI.\n * @param options The options passed to the CLI.\n */\nexport async function bootstrapCommandkitCLI(\n  argv: string[],\n  options?: import('commander').ParseOptions | undefined,\n) {\n  process.title = 'CommandKit CLI';\n\n  // imports are lazily loaded when the cli is used, instead of loading it with the lib itself\n  const { Command } = await import('commander');\n  const { bootstrapDevelopmentServer } = await import('./development');\n  const { bootstrapProductionServer, createProductionBuild } = await import(\n    './production'\n  );\n  const { generateCommand, generateEvent } = await import('./generators');\n  const { version } = await import('../version');\n  const { showInformation } = await import('./information');\n  const { setCLIEnv } = await import('./env');\n\n  const program = new Command('commandkit');\n\n  program\n    .command('dev')\n    .version(version)\n    .description('Start your bot in development mode.')\n    .option(\n      '-c, --config [path]',\n      'Path to your commandkit config file.',\n      './commandkit.js',\n    )\n    .action(() => {\n      const options = program.opts();\n      bootstrapDevelopmentServer(options.config);\n    });\n\n  program\n    .command('info')\n    .description(\n      'Show information about the system which can be used to report bugs.',\n    )\n    .action(async () => {\n      await showInformation();\n    });\n\n  program\n    .command('start')\n    .description(\n      'Start your bot in production mode after running the build command.',\n    )\n    .option('-c, --config [path]', 'Path to your commandkit config file.')\n    .action(() => {\n      const options = program.opts();\n      bootstrapProductionServer(options.config);\n    });\n\n  program\n    .command('build')\n    .description('Build your project for production usage.')\n    .option('-c, --config [path]', 'Path to your commandkit config file.')\n    .action(() => {\n      setCLIEnv();\n      const options = program.opts();\n      return createProductionBuild(options.config);\n    });\n\n  program\n    .command('create')\n    .description(\n      'Create new files using built-in templates or custom plugin templates',\n    )\n    .argument(\n      '<template>',\n      'The template to use (e.g. command, event, or custom plugin template)',\n    )\n    .argument('[args...]', 'Additional arguments for the template')\n    .action(async (template, args) => {\n      setCLIEnv();\n\n      // Handle custom plugin templates\n      const { plugins } = await loadConfigFile();\n      const runtime = new CompilerPluginRuntime(\n        plugins.filter((p) => isCompilerPlugin(p)) as CompilerPlugin[],\n      );\n\n      try {\n        await runtime.init();\n        const templateHandler = runtime.getTemplate(template);\n\n        if (!templateHandler) {\n          // Handle built-in templates\n          if (template === 'command') {\n            const [name] = args;\n            if (!name) {\n              panic('Command name is required');\n            }\n            await generateCommand(name);\n            return;\n          }\n\n          if (template === 'event') {\n            const [name] = args;\n            if (!name) {\n              panic('Event name is required');\n            }\n            await generateEvent(name);\n            return;\n          }\n\n          const valid = Array.from(\n            new Set([\n              'command',\n              'event',\n              ...Array.from(runtime.getTemplates().keys()),\n            ]),\n          ).map((t) => `\"${t}\"`);\n\n          panic(\n            `Template \"${template}\" not found. Available templates: ${valid.join(', ')}`,\n          );\n        }\n\n        await templateHandler(args);\n      } catch (e: any) {\n        panic(`Failed to execute template \"${template}\": ${e?.message || e}`);\n      } finally {\n        await runtime.destroy();\n      }\n    });\n\n  const types = join(process.cwd(), 'node_modules', 'commandkit-types');\n\n  if (!existsSync(types)) {\n    await mkdir(types, { recursive: true }).catch(() => {});\n    await generateTypesPackage(true).catch(() => {});\n  }\n\n  await program.parseAsync(argv, options);\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAiBA,eAAsB,uBACtB,MACA,SACA;AACE,SAAQ,QAAQ;CAGhB,MAAM,EAAE,SAAS,GAAG,MAAM,OAAO;CACjC,MAAM,EAAE,4BAA4B,GAAG,2CAAM;CAC7C,MAAM,EAAE,2BAA2B,uBAAuB,GAAG,2CAAM;CAGnE,MAAM,EAAE,iBAAiB,eAAe,GAAG,2CAAM;CACjD,MAAM,EAAE,SAAS,GAAG,2CAAM;CAC1B,MAAM,EAAE,iBAAiB,GAAG,2CAAM;CAClC,MAAM,EAAE,WAAW,GAAG,2CAAM;CAE5B,MAAM,UAAU,IAAI,QAAQ;AAE5B,SACA,QAAQ,MAAM,CACd,QAAQ,QAAQ,CAChB,YAAY,sCAAsC,CAClD,OACE,uBACA,wCACA,kBACD,CACD,OAAO,MAAM;EACX,MAAM,YAAU,QAAQ,MAAM;AAC9B,6BAA2B,UAAQ,OAAO;CAC3C,EAAC;AAEF,SACA,QAAQ,OAAO,CACf,YACE,sEACD,CACD,OAAO,YAAY;AACjB,QAAM,iBAAiB;CACxB,EAAC;AAEF,SACA,QAAQ,QAAQ,CAChB,YACE,qEACD,CACD,OAAO,uBAAuB,uCAAuC,CACrE,OAAO,MAAM;EACX,MAAM,YAAU,QAAQ,MAAM;AAC9B,4BAA0B,UAAQ,OAAO;CAC1C,EAAC;AAEF,SACA,QAAQ,QAAQ,CAChB,YAAY,2CAA2C,CACvD,OAAO,uBAAuB,uCAAuC,CACrE,OAAO,MAAM;AACX,aAAW;EACX,MAAM,YAAU,QAAQ,MAAM;AAC9B,SAAO,sBAAsB,UAAQ,OAAO;CAC7C,EAAC;AAEF,SACA,QAAQ,SAAS,CACjB,YACE,uEACD,CACD,SACE,cACA,uEACD,CACD,SAAS,aAAa,wCAAwC,CAC9D,OAAO,OAAO,UAAU,SAAS;AAC/B,aAAW;EAGX,MAAM,EAAE,SAAS,GAAG,MAAM,mCAAgB;EAC1C,MAAM,UAAU,IAAI,oDAClB,QAAQ,OAAO,CAAC,MAAM,wCAAiB,EAAE,CAAC;AAG5C,MAAI;AACF,SAAM,QAAQ,MAAM;GACpB,MAAM,kBAAkB,QAAQ,YAAY,SAAS;AAErD,QAAK,iBAAiB;AAEpB,QAAI,aAAa,WAAW;KAC1B,MAAM,CAAC,KAAK,GAAG;AACf,UAAK,KACH,sBAAM,2BAA2B;AAEnC,WAAM,gBAAgB,KAAK;AAC3B;IACD;AAED,QAAI,aAAa,SAAS;KACxB,MAAM,CAAC,KAAK,GAAG;AACf,UAAK,KACH,sBAAM,yBAAyB;AAEjC,WAAM,cAAc,KAAK;AACzB;IACD;IAED,MAAM,QAAQ,MAAM,KAClB,IAAI,IAAI;KACR;KACA;KACA,GAAG,MAAM,KAAK,QAAQ,cAAc,CAAC,MAAM,CAAC;IAAC,GAE9C,CAAC,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG;AAEtB,0BACG,YAAY,SAAS,oCAAoC,MAAM,KAAK,KAAK,CAAC,EAC5E;GACF;AAED,SAAM,gBAAgB,KAAK;EAC5B,SAAQ,GAAQ;AACf,yBAAO,8BAA8B,SAAS,4CAAK,EAAG,YAAW,EAAE,EAAE;EACtE,UAAS;AACR,SAAM,QAAQ,SAAS;EACxB;CACF,EAAC;CAEF,MAAM,QAAQ,oBAAK,QAAQ,KAAK,EAAE,gBAAgB,mBAAmB;AAErE,MAAK,wBAAW,MAAM,EAAE;AACtB,QAAM,4BAAM,OAAO,EAAE,WAAW,KAAM,EAAC,CAAC,MAAM,MAAM,CAAE,EAAC;AACvD,QAAM,2CAAqB,KAAK,CAAC,MAAM,MAAM,CAAE,EAAC;CAClD;AAEA,OAAM,QAAQ,WAAW,MAAM,QAAQ;AACzC"}

package/dist/logger/DefaultLogger.js

@@ -1,7 +1,7 @@
 require('../colors-Cd4Oz-r-.js');
 require('../ActionRow-CmTHbo2t.js');
 require('../error-codes-C_UO39jz.js');
-const require_CommandKit = require('../CommandKit-czUX38Mz.js');
+const require_CommandKit = require('../CommandKit-D8HJegdh.js');
 require('../common-CcfjYnPG.js');
 require('../common-CeO-vn8Y.js');
 require('../container-CpuiLsZM.js');
@@ -26,7 +26,7 @@ require('../EventWorkerContext-BAKiTqJz.js');
 require('../resolve-file-url-ifwdwqmq.js');
 require('../MessageCommandParser-D02-wpZN.js');
 require('../signals-scJdEbly.js');
-require('../constants-Do7znYzW.js');
+require('../constants-DWe181uQ.js');
 require('../types-package-CTSNSM93.js');
 require('../CommandsRouter-BHaPno8o.js');
 require('../EventsRouter-CqnrlbjN.js');

package/dist/logger/Logger.js

@@ -1,7 +1,7 @@
 require('../colors-Cd4Oz-r-.js');
 require('../ActionRow-CmTHbo2t.js');
 require('../error-codes-C_UO39jz.js');
-const require_CommandKit = require('../CommandKit-czUX38Mz.js');
+const require_CommandKit = require('../CommandKit-D8HJegdh.js');
 require('../common-CcfjYnPG.js');
 require('../common-CeO-vn8Y.js');
 require('../container-CpuiLsZM.js');
@@ -26,7 +26,7 @@ require('../EventWorkerContext-BAKiTqJz.js');
 require('../resolve-file-url-ifwdwqmq.js');
 require('../MessageCommandParser-D02-wpZN.js');
 require('../signals-scJdEbly.js');
-require('../constants-Do7znYzW.js');
+require('../constants-DWe181uQ.js');
 require('../types-package-CTSNSM93.js');
 require('../CommandsRouter-BHaPno8o.js');
 require('../EventsRouter-CqnrlbjN.js');

package/dist/plugins/index.js

@@ -1,7 +1,7 @@
 require('../colors-Cd4Oz-r-.js');
 require('../ActionRow-CmTHbo2t.js');
 require('../error-codes-C_UO39jz.js');
-const require_CommandKit = require('../CommandKit-czUX38Mz.js');
+const require_CommandKit = require('../CommandKit-D8HJegdh.js');
 require('../common-CcfjYnPG.js');
 require('../common-CeO-vn8Y.js');
 require('../container-CpuiLsZM.js');
@@ -26,7 +26,7 @@ require('../EventWorkerContext-BAKiTqJz.js');
 require('../resolve-file-url-ifwdwqmq.js');
 require('../MessageCommandParser-D02-wpZN.js');
 require('../signals-scJdEbly.js');
-require('../constants-Do7znYzW.js');
+require('../constants-DWe181uQ.js');
 require('../types-package-CTSNSM93.js');
 require('../CommandsRouter-BHaPno8o.js');
 require('../EventsRouter-CqnrlbjN.js');

package/dist/plugins/plugin-runtime/CommandKitPluginRuntime.js

@@ -1,7 +1,7 @@
 require('../../colors-Cd4Oz-r-.js');
 require('../../ActionRow-CmTHbo2t.js');
 require('../../error-codes-C_UO39jz.js');
-const require_CommandKit = require('../../CommandKit-czUX38Mz.js');
+const require_CommandKit = require('../../CommandKit-D8HJegdh.js');
 require('../../common-CcfjYnPG.js');
 require('../../common-CeO-vn8Y.js');
 require('../../container-CpuiLsZM.js');
@@ -26,7 +26,7 @@ require('../../EventWorkerContext-BAKiTqJz.js');
 require('../../resolve-file-url-ifwdwqmq.js');
 require('../../MessageCommandParser-D02-wpZN.js');
 require('../../signals-scJdEbly.js');
-require('../../constants-Do7znYzW.js');
+require('../../constants-DWe181uQ.js');
 require('../../types-package-CTSNSM93.js');
 require('../../CommandsRouter-BHaPno8o.js');
 require('../../EventsRouter-CqnrlbjN.js');

package/dist/plugins/plugin-runtime/builtin/CommonDirectiveTransformer.js

@@ -1,7 +1,7 @@
 require('../../../colors-Cd4Oz-r-.js');
 require('../../../ActionRow-CmTHbo2t.js');
 require('../../../error-codes-C_UO39jz.js');
-const require_CommandKit = require('../../../CommandKit-czUX38Mz.js');
+const require_CommandKit = require('../../../CommandKit-D8HJegdh.js');
 require('../../../common-CcfjYnPG.js');
 require('../../../common-CeO-vn8Y.js');
 require('../../../container-CpuiLsZM.js');
@@ -26,7 +26,7 @@ require('../../../EventWorkerContext-BAKiTqJz.js');
 require('../../../resolve-file-url-ifwdwqmq.js');
 require('../../../MessageCommandParser-D02-wpZN.js');
 require('../../../signals-scJdEbly.js');
-require('../../../constants-Do7znYzW.js');
+require('../../../constants-DWe181uQ.js');
 require('../../../types-package-CTSNSM93.js');
 require('../../../CommandsRouter-BHaPno8o.js');
 require('../../../EventsRouter-CqnrlbjN.js');

package/dist/plugins/plugin-runtime/builtin/MacroPlugin.js

@@ -1,7 +1,7 @@
 require('../../../colors-Cd4Oz-r-.js');
 require('../../../ActionRow-CmTHbo2t.js');
 require('../../../error-codes-C_UO39jz.js');
-const require_CommandKit = require('../../../CommandKit-czUX38Mz.js');
+const require_CommandKit = require('../../../CommandKit-D8HJegdh.js');
 require('../../../common-CcfjYnPG.js');
 require('../../../common-CeO-vn8Y.js');
 require('../../../container-CpuiLsZM.js');
@@ -26,7 +26,7 @@ require('../../../EventWorkerContext-BAKiTqJz.js');
 require('../../../resolve-file-url-ifwdwqmq.js');
 require('../../../MessageCommandParser-D02-wpZN.js');
 require('../../../signals-scJdEbly.js');
-require('../../../constants-Do7znYzW.js');
+require('../../../constants-DWe181uQ.js');
 require('../../../types-package-CTSNSM93.js');
 require('../../../CommandsRouter-BHaPno8o.js');
 require('../../../EventsRouter-CqnrlbjN.js');

package/dist/utils/dev-hooks.js

@@ -1,7 +1,7 @@
 require('../colors-Cd4Oz-r-.js');
 require('../ActionRow-CmTHbo2t.js');
 require('../error-codes-C_UO39jz.js');
-const require_CommandKit = require('../CommandKit-czUX38Mz.js');
+const require_CommandKit = require('../CommandKit-D8HJegdh.js');
 require('../common-CcfjYnPG.js');
 require('../common-CeO-vn8Y.js');
 require('../container-CpuiLsZM.js');
@@ -26,7 +26,7 @@ require('../EventWorkerContext-BAKiTqJz.js');
 require('../resolve-file-url-ifwdwqmq.js');
 require('../MessageCommandParser-D02-wpZN.js');
 require('../signals-scJdEbly.js');
-require('../constants-Do7znYzW.js');
+require('../constants-DWe181uQ.js');
 require('../types-package-CTSNSM93.js');
 require('../CommandsRouter-BHaPno8o.js');
 require('../EventsRouter-CqnrlbjN.js');

package/dist/utils/utilities.js

@@ -1,7 +1,7 @@
 require('../colors-Cd4Oz-r-.js');
 require('../ActionRow-CmTHbo2t.js');
 require('../error-codes-C_UO39jz.js');
-const require_CommandKit = require('../CommandKit-czUX38Mz.js');
+const require_CommandKit = require('../CommandKit-D8HJegdh.js');
 require('../common-CcfjYnPG.js');
 require('../common-CeO-vn8Y.js');
 require('../container-CpuiLsZM.js');
@@ -26,7 +26,7 @@ require('../EventWorkerContext-BAKiTqJz.js');
 require('../resolve-file-url-ifwdwqmq.js');
 require('../MessageCommandParser-D02-wpZN.js');
 require('../signals-scJdEbly.js');
-require('../constants-Do7znYzW.js');
+require('../constants-DWe181uQ.js');
 require('../types-package-CTSNSM93.js');
 require('../CommandsRouter-BHaPno8o.js');
 require('../EventsRouter-CqnrlbjN.js');

package/dist/{version-Cxwx9WK4.js → version-C9ijCrHf.js}

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

package/dist/{version-Cxwx9WK4.js.map → version-C9ijCrHf.js.map}

@@ -1 +1 @@
-{"version":3,"file":"version-Cxwx9WK4.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-C9ijCrHf.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-Cxwx9WK4.js');
+const require_version = require('./version-C9ijCrHf.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.20250605143740",
+  "version": "1.0.0-dev.20250606020134",
   "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.20250605143740"
+    "tsconfig": "0.0.0-dev.20250606020134"
   },
   "peerDependencies": {
     "discord.js": "^14"

package/dist/constants-Do7znYzW.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants-Do7znYzW.js","names":[],"sources":["../src/analytics/constants.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nexport const DO_NOT_TRACK_KEY = `COMMANDKIT_ANALYTICS__DO_NOT_TRACK::${randomUUID()}`;\n\nexport const AnalyticsEvents = {\n  COMMAND_EXECUTION: 'command_execution',\n  // @commandkit/cache\n  CACHE_HIT: 'cache_hit',\n  CACHE_MISS: 'cache_miss',\n  CACHE_REVALIDATED: 'cache_revalidated',\n} as const;\n\nexport type AnalyticsEvent =\n  (typeof AnalyticsEvents)[keyof typeof AnalyticsEvents];\n"],"mappings":";;;;AAEA,MAAa,oBAAoB,sCAAsC,6BAAY,CAAC;AAEpF,MAAa,kBAAkB;CAC7B,mBAAmB;CAEnB,WAAW;CACX,YAAY;CACZ,mBAAmB;AACpB"}

package/dist/feature-flags-2jhIRnS6.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"feature-flags-2jhIRnS6.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';\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: '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: '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":";;;;AA0EA,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;IACN,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;IACN,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"}