commandkit 0.1.11-dev.20250214040728 → 0.1.11-dev.20250215105847

package/dist/index.d.mts

@@ -1187,6 +1187,7 @@ interface ContextParameters<T extends CommandExecutionMode> {
     message: T extends 'message' ? Message : never;
     forwarded?: boolean;
     messageCommandParser?: T extends 'message' ? MessageCommandParser : never;
+    store?: Map<string, any>;
 }
 type MessageCommandContext = Context<'message'>;
 type InteractionCommandContext = Context<'autocomplete' | 'chatInput' | 'messageContextMenu' | 'userContextMenu'>;
@@ -1202,6 +1203,7 @@ type UserContextMenuCommandContext = Context<'userContextMenu'>;
 type UserContextMenuCommandMiddlewareContext = MiddlewareContext<'userContextMenu'>;
 type CommandContextOptions<T extends CommandExecutionMode> = T extends 'message' ? MessageCommandOptions : T extends 'chatInput' ? ChatInputCommandInteraction['options'] : T extends 'autocomplete' ? AutocompleteInteraction['options'] : T extends 'messageContextMenu' ? MessageContextMenuCommandInteraction['options'] : T extends 'userContextMenu' ? UserContextMenuCommandInteraction['options'] : never;
 declare class Context<ExecutionMode extends CommandExecutionMode = CommandExecutionMode> {
+    #private;
     readonly commandkit: CommandKit;
     private readonly config;
     /**
@@ -1219,6 +1221,11 @@ declare class Context<ExecutionMode extends CommandExecutionMode = CommandExecut
      * @param config The context parameters.
      */
     constructor(commandkit: CommandKit, config: ContextParameters<ExecutionMode>);
+    /**
+     * The shared key-value store for this context. This can be used to store data that needs to be shared between middlewares or commands.
+     * This store is shared across all contexts in the same command execution, including the cloned contexts and middleware contexts.
+     */
+    get store(): Map<string, any>;
     get commandName(): string;
     get options(): CommandContextOptions<ExecutionMode>;
     /**
@@ -1292,6 +1299,29 @@ declare class Context<ExecutionMode extends CommandExecutionMode = CommandExecut
     clone(config?: Partial<ContextParameters<ExecutionMode>>): Context<ExecutionMode>;
     isMiddleware(): this is MiddlewareContext<ExecutionMode>;
     args(): string[];
+    /**
+     * Stops upcoming middleware or current command execution.
+     * If this is called inside pre-stage middleware, the next run will be the actual command, skipping all other pre-stage middlewares.
+     * If this is called inside a command itself, it will skip all post-stage middlewares.
+     * If this is called inside post-stage middleware, it will skip all other post-stage middlewares.
+     */
+    exit(): void;
+    /**
+     * Defers the given function to be executed after this command's execution.
+     * @param fn The function to defer.
+     * @returns A unique identifier for the deferred function.
+     */
+    defer(fn: GenericFunction<[CommandKitEnvironment]>): string;
+    /**
+     * Cancels the deferred function with the given identifier.
+     * @param id The identifier of the deferred function.
+     */
+    cancelDeferred(id: string): void;
+    /**
+     * Validates if the given function is a cached function.
+     * @param fn The function to validate.
+     */
+    isCached(fn: GenericFunction): boolean;
 }
 declare class MiddlewareContext<T extends CommandExecutionMode = CommandExecutionMode> extends Context<T> {
     #private;
@@ -1364,6 +1394,15 @@ declare class CommandKit extends EventEmitter {
      * @see {@link https://commandkit.js.org/docs/guide/commandkit-setup}
      */
     constructor(options: CommandKitOptions);
+    /**
+     * Starts the commandkit application.
+     * @param token The application token to connect to the discord gateway. If not provided, it will use the `TOKEN` or `DISCORD_TOKEN` environment variable. If set to `false`, it will not login.
+     */
+    start(token?: string | false): Promise<void>;
+    /**
+     * Whether or not the commandkit application has started.
+     */
+    get started(): boolean;
     /**
      * Sets the prefix resolver for the command handler.
      * @param resolver The resolver function.
@@ -1515,58 +1554,114 @@ declare class MemoryCache extends CacheProvider {
     expire(key: string, ttl: number): Promise<void>;
 }
 
-type AsyncFunction<R extends any[] = any[], T = any> = (...args: R) => Promise<T>;
-interface CacheTag {
-    tag: string;
-    ttl: number | string;
-}
-interface CacheParams extends CacheTag {
-    target: GenericFunction;
-    memo: GenericFunction;
+/**
+ * Context for managing cache operations within an async scope
+ */
+interface CacheContext {
+    params: {
+        /** Custom name for the cache entry */
+        name?: string;
+        /** Time-to-live in milliseconds */
+        ttl?: number;
+    };
 }
 /**
- * Cache a function with a specific tag and time-to-live.
- * @param fn The function to cache.
- * @param params The cache tag and time-to-live.
- * @returns The memoized function.
+ * Represents an async function that can be cached
+ * @template R - Array of argument types
+ * @template T - Return type
+ */
+type AsyncFunction<R extends any[] = any[], T = any> = (...args: R) => Promise<T>;
+/**
+ * Configuration options for cache behavior
  */
-declare function cache<R extends any[], F extends AsyncFunction<R>>(fn: F, params?: Partial<CacheTag>): F;
+interface CacheMetadata {
+    /** Time-to-live duration in milliseconds or as a string (e.g., '1h', '5m') */
+    ttl?: number | string;
+    /** Custom name for the cache entry */
+    name?: string;
+}
 /**
- * **DO NOT USE THIS FUNCTION DIRECTLY**
+ * Internal cache implementation
  * @internal
  * @private
  */
-declare function useCache<R extends any[], F extends AsyncFunction<R>>(fn: F, id?: string, tag?: CacheTag): F;
+declare function useCache<R extends any[], F extends AsyncFunction<R>>(fn: F, id?: string, params?: CacheMetadata): F;
 /**
- * Tags the current function with the given cache tag name
- * @param tag The cache tag name.
+ * Wraps an async function with caching capability
+ * @template R - Array of argument types
+ * @template F - Type of the async function
+ * @param fn - The async function to cache
+ * @param params - Optional cache configuration
+ * @returns The wrapped function with caching behavior
+ * @example
+ * ```ts
+ * const cachedFetch = cache(async (id: string) => {
+ *   return await db.findOne(id);
+ * }, { ttl: '1h' });
+ * ```
  */
-declare function cacheTag(tag: string): void;
+declare function cache<R extends any[], F extends AsyncFunction<R>>(fn: F, params?: CacheMetadata): F;
 /**
- * Tags the current function with the given cache tag parameters.
- * @param tag The cache tag parameters.
+ * Sets a custom identifier for the current cache operation
+ * @param tag - The custom cache tag
+ * @throws {Error} When called outside a cached function or without a tag
+ * @example
+ * ```ts
+ * const fetchUser = cache(async (id: string) => {
+ *   cacheTag(`user:${id}`);
+ *   return await db.users.findOne(id);
+ * });
+ * ```
  */
-declare function cacheTag(tag: CacheTag): void;
+declare function cacheTag(tag: string): void;
 /**
- * Sets the time-to-live for the current cache tag.
- * @param life The time-to-live value in milliseconds or a string.
+ * Sets the TTL for the current cache operation
+ * @param ttl - Time-to-live in milliseconds or as a string (e.g., '1h', '5m')
+ * @throws {Error} When called outside a cached function or with invalid TTL
+ * @example
+ * ```ts
+ * const fetchData = cache(async () => {
+ *   cacheLife('30m');
+ *   return await expensiveOperation();
+ * });
+ * ```
  */
-declare function cacheLife(life: string): void;
-declare function cacheLife(life: number): void;
+declare function cacheLife(ttl: number | string): void;
 /**
- * Invalidates the cache with the given tag.
- * This will immediately remove the cache entry. The next time cache is requested, it will be re-fetched.
- * @param tag The cache tag to invalidate.
+ * Removes a cached value by its tag
+ * @param tag - The cache tag to invalidate
+ * @throws {Error} When the cache key is not found
+ * @example
+ * ```ts
+ * await invalidate('user:123');
+ * ```
  */
 declare function invalidate(tag: string): Promise<void>;
 /**
- * Revalidates the cache with the given tag.
- * This will immediately remove the cache entry and re-fetch the value.
- * @param tag The cache tag to revalidate.
- * @param args The arguments to pass to the memoized function (if any).
- * @returns The new value of the cache.
+ * Forces a refresh of cached data by its tag (on-demand revalidation)
+ * @template T - Type of the cached value
+ * @param tag - The cache tag to revalidate
+ * @param args - Arguments to pass to the cached function
+ * @returns Fresh data from the cached function
+ * @throws {Error} When the cache key or function is not found
+ * @example
+ * ```ts
+ * const freshData = await revalidate('user:123');
+ * ```
  */
-declare function revalidate<R = any>(tag: string, ...args: any[]): Promise<R | undefined>;
+declare function revalidate<T = unknown>(tag: string, ...args: any[]): Promise<T>;
+/**
+ * Checks if a function is wrapped with cache functionality
+ * @param fn - Function to check
+ * @returns True if the function is cached
+ * @example
+ * ```ts
+ * if (isCachedFunction(myFunction)) {
+ *   console.log('Function is cached');
+ * }
+ * ```
+ */
+declare function isCachedFunction(fn: GenericFunction): boolean;
 
 declare class DefaultLocalizationStrategy implements LocalizationStrategy {
     private readonly commandkit;
@@ -1591,6 +1686,53 @@ declare function exitMiddleware(): never;
  * @param error The error to rethrow.
  */
 declare function rethrow(error: unknown): void;
+/**
+ * Stops current command assuming it has been redirected to another command.
+ */
+declare function redirect(): never;
+
+interface ILogger {
+    log(...args: any[]): void;
+    error(...args: any[]): void;
+    warn(...args: any[]): void;
+    info(...args: any[]): void;
+    debug(...args: any[]): void;
+}
+
+declare class DefaultLogger implements ILogger {
+    stdout: NodeJS.WriteStream & {
+        fd: 1;
+    };
+    stderr: NodeJS.WriteStream & {
+        fd: 2;
+    };
+    private logger;
+    constructor(stdout?: NodeJS.WriteStream & {
+        fd: 1;
+    }, stderr?: NodeJS.WriteStream & {
+        fd: 2;
+    });
+    private _getContext;
+    private _getPrefix;
+    private _log;
+    debug(...args: any[]): void;
+    error(...args: any[]): void;
+    log(...args: any[]): void;
+    info(...args: any[]): void;
+    warn(...args: any[]): void;
+}
+
+interface CommandKitLoggerOptions {
+    /**
+     * The logger provider to use.
+     */
+    provider: ILogger;
+}
+interface LoggerImpl extends ILogger {
+    configure(options: CommandKitLoggerOptions): void;
+}
+declare function createLogger(options: CommandKitLoggerOptions): LoggerImpl;
+declare const Logger: LoggerImpl;
 
 /**
  * Creates a command line interface for CommandKit.
@@ -1604,4 +1746,4 @@ declare function bootstrapCommandkitCLI(argv: string[], options?: commander.Pars
  */
 declare const version: string;
 
-export { ActionRow, type ActionRowProps, type AnyCommandKitElement, AppCommandHandler, type AsyncFunction, type AutocompleteCommandContext, type AutocompleteCommandMiddlewareContext, type AutocompleteProps, Button, type ButtonChildrenLike, ButtonKit, type ButtonKitPredicate, type ButtonProps, type CacheEntry, type CacheParams, CacheProvider, type CacheTag, type CommandContext, type CommandContextOptions, type CommandData, CommandExecutionMode, type CommandFileObject, CommandKit, type CommandKitButtonBuilderInteractionCollectorDispatch, type CommandKitButtonBuilderInteractionCollectorDispatchContextData, type CommandKitButtonBuilderOnEnd, type CommandKitConfig, type CommandKitConfiguration, type CommandKitData, type CommandKitElement, type CommandKitElementData, CommandKitEnvironment, type CommandKitEnvironmentInternalData, CommandKitEnvironmentType, type CommandKitModalBuilderInteractionCollectorDispatch, type CommandKitModalBuilderInteractionCollectorDispatchContextData, type CommandKitModalBuilderOnEnd, type CommandKitOptions, type CommandObject, type CommandOptions, type CommandProps, Context, type ContextMenuCommandProps, type ContextParameters, DefaultLocalizationStrategy, ElementType, EventInterceptor, type EventInterceptorContextData, type EventInterceptorErrorHandler, Fragment, type FragmentElementProps, type GenericFunction, type InteractionCommandContext, type InteractionCommandMiddlewareContext, Localization, type LocalizationConfig, type LocalizationStrategy, type LocalizationTranslationRequest, type MaybeArray, MemoryCache, type MessageCommandContext, type MessageCommandMiddlewareContext, MessageCommandOptions, type MessageCommandOptionsSchema, MessageCommandParser, type MessageContextMenuCommandContext, type MessageContextMenuCommandMiddlewareContext, type MessageContextMenuCommandProps, MiddlewareContext, Modal, ModalKit, type ModalKitPredicate, type ModalProps, type OnButtonKitClick, type OnButtonKitEnd, type OnModalKitEnd, type OnModalKitSubmit, ParagraphInput, type ParsedMessageCommand, type PreparedAppCommandExecution, type ReloadOptions, ReloadType, ShortInput, type SlashCommandContext, type SlashCommandMiddlewareContext, type SlashCommandProps, TextInput, type TextInputProps, type TranslatableArguments, type TranslatableCommand, type TranslatableCommandOptions, type Translation, type TranslationResult, type Translator, type UserContextMenuCommandContext, type UserContextMenuCommandMiddlewareContext, type UserContextMenuCommandProps, type ValidationProps, afterCommand, bootstrapCommandkitCLI, cache, cacheLife, cacheTag, cancelAfterCommand, createElement, CommandKit as default, defineConfig, dmOnly, exitContext, exitMiddleware, getCommandKit, getConfig, getContext, getElement, guildOnly, invalidate, isCommandKitElement, makeContextAwareFunction, rethrow, revalidate, useCache as super_duper_secret_internal_for_use_cache_directive_of_commandkit_cli_do_not_use_it_directly_or_you_will_be_fired_from_your_job_kthxbai, useEnvironment, version };
+export { ActionRow, type ActionRowProps, type AnyCommandKitElement, AppCommandHandler, type AsyncFunction, type AutocompleteCommandContext, type AutocompleteCommandMiddlewareContext, type AutocompleteProps, Button, type ButtonChildrenLike, ButtonKit, type ButtonKitPredicate, type ButtonProps, type CacheContext, type CacheEntry, type CacheMetadata, CacheProvider, type CommandContext, type CommandContextOptions, type CommandData, CommandExecutionMode, type CommandFileObject, CommandKit, type CommandKitButtonBuilderInteractionCollectorDispatch, type CommandKitButtonBuilderInteractionCollectorDispatchContextData, type CommandKitButtonBuilderOnEnd, type CommandKitConfig, type CommandKitConfiguration, type CommandKitData, type CommandKitElement, type CommandKitElementData, CommandKitEnvironment, type CommandKitEnvironmentInternalData, CommandKitEnvironmentType, type CommandKitLoggerOptions, type CommandKitModalBuilderInteractionCollectorDispatch, type CommandKitModalBuilderInteractionCollectorDispatchContextData, type CommandKitModalBuilderOnEnd, type CommandKitOptions, type CommandMatchResult, type CommandObject, type CommandOptions, type CommandProps, CommandsRouter, type CommandsRouterMatcher, type CommandsRouterMatchersMap, type CommandsRouterOptions, type CommandsTree, Context, type ContextMenuCommandProps, type ContextParameters, DefaultLocalizationStrategy, DefaultLogger, ElementType, EventInterceptor, type EventInterceptorContextData, type EventInterceptorErrorHandler, EventsRouter, type EventsRouterOptions, type EventsTree, Fragment, type FragmentElementProps, type GenericFunction, type ILogger, type InteractionCommandContext, type InteractionCommandMiddlewareContext, Localization, type LocalizationConfig, type LocalizationStrategy, type LocalizationTranslationRequest, Logger, type LoggerImpl, type MaybeArray, MemoryCache, type MessageCommandContext, type MessageCommandMiddlewareContext, MessageCommandOptions, type MessageCommandOptionsSchema, MessageCommandParser, type MessageContextMenuCommandContext, type MessageContextMenuCommandMiddlewareContext, type MessageContextMenuCommandProps, MiddlewareContext, Modal, ModalKit, type ModalKitPredicate, type ModalProps, type OnButtonKitClick, type OnButtonKitEnd, type OnModalKitEnd, type OnModalKitSubmit, ParagraphInput, type ParsedCommand, type ParsedEvent, type ParsedMessageCommand, type ParsedMiddleware, type PreparedAppCommandExecution, type ReloadOptions, ReloadType, ShortInput, type SlashCommandContext, type SlashCommandMiddlewareContext, type SlashCommandProps, TextInput, type TextInputProps, type TranslatableArguments, type TranslatableCommand, type TranslatableCommandOptions, type Translation, type TranslationResult, type Translator, type UserContextMenuCommandContext, type UserContextMenuCommandMiddlewareContext, type UserContextMenuCommandProps, type ValidationProps, afterCommand, bootstrapCommandkitCLI, cache, cacheLife, cacheTag, cancelAfterCommand, createElement, createLogger, CommandKit as default, defineConfig, dmOnly, exitContext, exitMiddleware, getCommandKit, getConfig, getContext, getElement, guildOnly, invalidate, isCachedFunction, isCommandKitElement, makeContextAwareFunction, redirect, rethrow, revalidate, useCache as super_duper_secret_internal_for_use_cache_directive_of_commandkit_cli_do_not_use_it_directly_or_you_will_be_fired_from_your_job_kthxbai, useEnvironment, version };

package/dist/index.d.ts

@@ -1187,6 +1187,7 @@ interface ContextParameters<T extends CommandExecutionMode> {
     message: T extends 'message' ? Message : never;
     forwarded?: boolean;
     messageCommandParser?: T extends 'message' ? MessageCommandParser : never;
+    store?: Map<string, any>;
 }
 type MessageCommandContext = Context<'message'>;
 type InteractionCommandContext = Context<'autocomplete' | 'chatInput' | 'messageContextMenu' | 'userContextMenu'>;
@@ -1202,6 +1203,7 @@ type UserContextMenuCommandContext = Context<'userContextMenu'>;
 type UserContextMenuCommandMiddlewareContext = MiddlewareContext<'userContextMenu'>;
 type CommandContextOptions<T extends CommandExecutionMode> = T extends 'message' ? MessageCommandOptions : T extends 'chatInput' ? ChatInputCommandInteraction['options'] : T extends 'autocomplete' ? AutocompleteInteraction['options'] : T extends 'messageContextMenu' ? MessageContextMenuCommandInteraction['options'] : T extends 'userContextMenu' ? UserContextMenuCommandInteraction['options'] : never;
 declare class Context<ExecutionMode extends CommandExecutionMode = CommandExecutionMode> {
+    #private;
     readonly commandkit: CommandKit;
     private readonly config;
     /**
@@ -1219,6 +1221,11 @@ declare class Context<ExecutionMode extends CommandExecutionMode = CommandExecut
      * @param config The context parameters.
      */
     constructor(commandkit: CommandKit, config: ContextParameters<ExecutionMode>);
+    /**
+     * The shared key-value store for this context. This can be used to store data that needs to be shared between middlewares or commands.
+     * This store is shared across all contexts in the same command execution, including the cloned contexts and middleware contexts.
+     */
+    get store(): Map<string, any>;
     get commandName(): string;
     get options(): CommandContextOptions<ExecutionMode>;
     /**
@@ -1292,6 +1299,29 @@ declare class Context<ExecutionMode extends CommandExecutionMode = CommandExecut
     clone(config?: Partial<ContextParameters<ExecutionMode>>): Context<ExecutionMode>;
     isMiddleware(): this is MiddlewareContext<ExecutionMode>;
     args(): string[];
+    /**
+     * Stops upcoming middleware or current command execution.
+     * If this is called inside pre-stage middleware, the next run will be the actual command, skipping all other pre-stage middlewares.
+     * If this is called inside a command itself, it will skip all post-stage middlewares.
+     * If this is called inside post-stage middleware, it will skip all other post-stage middlewares.
+     */
+    exit(): void;
+    /**
+     * Defers the given function to be executed after this command's execution.
+     * @param fn The function to defer.
+     * @returns A unique identifier for the deferred function.
+     */
+    defer(fn: GenericFunction<[CommandKitEnvironment]>): string;
+    /**
+     * Cancels the deferred function with the given identifier.
+     * @param id The identifier of the deferred function.
+     */
+    cancelDeferred(id: string): void;
+    /**
+     * Validates if the given function is a cached function.
+     * @param fn The function to validate.
+     */
+    isCached(fn: GenericFunction): boolean;
 }
 declare class MiddlewareContext<T extends CommandExecutionMode = CommandExecutionMode> extends Context<T> {
     #private;
@@ -1364,6 +1394,15 @@ declare class CommandKit extends EventEmitter {
      * @see {@link https://commandkit.js.org/docs/guide/commandkit-setup}
      */
     constructor(options: CommandKitOptions);
+    /**
+     * Starts the commandkit application.
+     * @param token The application token to connect to the discord gateway. If not provided, it will use the `TOKEN` or `DISCORD_TOKEN` environment variable. If set to `false`, it will not login.
+     */
+    start(token?: string | false): Promise<void>;
+    /**
+     * Whether or not the commandkit application has started.
+     */
+    get started(): boolean;
     /**
      * Sets the prefix resolver for the command handler.
      * @param resolver The resolver function.
@@ -1515,58 +1554,114 @@ declare class MemoryCache extends CacheProvider {
     expire(key: string, ttl: number): Promise<void>;
 }
 
-type AsyncFunction<R extends any[] = any[], T = any> = (...args: R) => Promise<T>;
-interface CacheTag {
-    tag: string;
-    ttl: number | string;
-}
-interface CacheParams extends CacheTag {
-    target: GenericFunction;
-    memo: GenericFunction;
+/**
+ * Context for managing cache operations within an async scope
+ */
+interface CacheContext {
+    params: {
+        /** Custom name for the cache entry */
+        name?: string;
+        /** Time-to-live in milliseconds */
+        ttl?: number;
+    };
 }
 /**
- * Cache a function with a specific tag and time-to-live.
- * @param fn The function to cache.
- * @param params The cache tag and time-to-live.
- * @returns The memoized function.
+ * Represents an async function that can be cached
+ * @template R - Array of argument types
+ * @template T - Return type
+ */
+type AsyncFunction<R extends any[] = any[], T = any> = (...args: R) => Promise<T>;
+/**
+ * Configuration options for cache behavior
  */
-declare function cache<R extends any[], F extends AsyncFunction<R>>(fn: F, params?: Partial<CacheTag>): F;
+interface CacheMetadata {
+    /** Time-to-live duration in milliseconds or as a string (e.g., '1h', '5m') */
+    ttl?: number | string;
+    /** Custom name for the cache entry */
+    name?: string;
+}
 /**
- * **DO NOT USE THIS FUNCTION DIRECTLY**
+ * Internal cache implementation
  * @internal
  * @private
  */
-declare function useCache<R extends any[], F extends AsyncFunction<R>>(fn: F, id?: string, tag?: CacheTag): F;
+declare function useCache<R extends any[], F extends AsyncFunction<R>>(fn: F, id?: string, params?: CacheMetadata): F;
 /**
- * Tags the current function with the given cache tag name
- * @param tag The cache tag name.
+ * Wraps an async function with caching capability
+ * @template R - Array of argument types
+ * @template F - Type of the async function
+ * @param fn - The async function to cache
+ * @param params - Optional cache configuration
+ * @returns The wrapped function with caching behavior
+ * @example
+ * ```ts
+ * const cachedFetch = cache(async (id: string) => {
+ *   return await db.findOne(id);
+ * }, { ttl: '1h' });
+ * ```
  */
-declare function cacheTag(tag: string): void;
+declare function cache<R extends any[], F extends AsyncFunction<R>>(fn: F, params?: CacheMetadata): F;
 /**
- * Tags the current function with the given cache tag parameters.
- * @param tag The cache tag parameters.
+ * Sets a custom identifier for the current cache operation
+ * @param tag - The custom cache tag
+ * @throws {Error} When called outside a cached function or without a tag
+ * @example
+ * ```ts
+ * const fetchUser = cache(async (id: string) => {
+ *   cacheTag(`user:${id}`);
+ *   return await db.users.findOne(id);
+ * });
+ * ```
  */
-declare function cacheTag(tag: CacheTag): void;
+declare function cacheTag(tag: string): void;
 /**
- * Sets the time-to-live for the current cache tag.
- * @param life The time-to-live value in milliseconds or a string.
+ * Sets the TTL for the current cache operation
+ * @param ttl - Time-to-live in milliseconds or as a string (e.g., '1h', '5m')
+ * @throws {Error} When called outside a cached function or with invalid TTL
+ * @example
+ * ```ts
+ * const fetchData = cache(async () => {
+ *   cacheLife('30m');
+ *   return await expensiveOperation();
+ * });
+ * ```
  */
-declare function cacheLife(life: string): void;
-declare function cacheLife(life: number): void;
+declare function cacheLife(ttl: number | string): void;
 /**
- * Invalidates the cache with the given tag.
- * This will immediately remove the cache entry. The next time cache is requested, it will be re-fetched.
- * @param tag The cache tag to invalidate.
+ * Removes a cached value by its tag
+ * @param tag - The cache tag to invalidate
+ * @throws {Error} When the cache key is not found
+ * @example
+ * ```ts
+ * await invalidate('user:123');
+ * ```
  */
 declare function invalidate(tag: string): Promise<void>;
 /**
- * Revalidates the cache with the given tag.
- * This will immediately remove the cache entry and re-fetch the value.
- * @param tag The cache tag to revalidate.
- * @param args The arguments to pass to the memoized function (if any).
- * @returns The new value of the cache.
+ * Forces a refresh of cached data by its tag (on-demand revalidation)
+ * @template T - Type of the cached value
+ * @param tag - The cache tag to revalidate
+ * @param args - Arguments to pass to the cached function
+ * @returns Fresh data from the cached function
+ * @throws {Error} When the cache key or function is not found
+ * @example
+ * ```ts
+ * const freshData = await revalidate('user:123');
+ * ```
  */
-declare function revalidate<R = any>(tag: string, ...args: any[]): Promise<R | undefined>;
+declare function revalidate<T = unknown>(tag: string, ...args: any[]): Promise<T>;
+/**
+ * Checks if a function is wrapped with cache functionality
+ * @param fn - Function to check
+ * @returns True if the function is cached
+ * @example
+ * ```ts
+ * if (isCachedFunction(myFunction)) {
+ *   console.log('Function is cached');
+ * }
+ * ```
+ */
+declare function isCachedFunction(fn: GenericFunction): boolean;
 
 declare class DefaultLocalizationStrategy implements LocalizationStrategy {
     private readonly commandkit;
@@ -1591,6 +1686,53 @@ declare function exitMiddleware(): never;
  * @param error The error to rethrow.
  */
 declare function rethrow(error: unknown): void;
+/**
+ * Stops current command assuming it has been redirected to another command.
+ */
+declare function redirect(): never;
+
+interface ILogger {
+    log(...args: any[]): void;
+    error(...args: any[]): void;
+    warn(...args: any[]): void;
+    info(...args: any[]): void;
+    debug(...args: any[]): void;
+}
+
+declare class DefaultLogger implements ILogger {
+    stdout: NodeJS.WriteStream & {
+        fd: 1;
+    };
+    stderr: NodeJS.WriteStream & {
+        fd: 2;
+    };
+    private logger;
+    constructor(stdout?: NodeJS.WriteStream & {
+        fd: 1;
+    }, stderr?: NodeJS.WriteStream & {
+        fd: 2;
+    });
+    private _getContext;
+    private _getPrefix;
+    private _log;
+    debug(...args: any[]): void;
+    error(...args: any[]): void;
+    log(...args: any[]): void;
+    info(...args: any[]): void;
+    warn(...args: any[]): void;
+}
+
+interface CommandKitLoggerOptions {
+    /**
+     * The logger provider to use.
+     */
+    provider: ILogger;
+}
+interface LoggerImpl extends ILogger {
+    configure(options: CommandKitLoggerOptions): void;
+}
+declare function createLogger(options: CommandKitLoggerOptions): LoggerImpl;
+declare const Logger: LoggerImpl;
 
 /**
  * Creates a command line interface for CommandKit.
@@ -1604,4 +1746,4 @@ declare function bootstrapCommandkitCLI(argv: string[], options?: commander.Pars
  */
 declare const version: string;
 
-export { ActionRow, type ActionRowProps, type AnyCommandKitElement, AppCommandHandler, type AsyncFunction, type AutocompleteCommandContext, type AutocompleteCommandMiddlewareContext, type AutocompleteProps, Button, type ButtonChildrenLike, ButtonKit, type ButtonKitPredicate, type ButtonProps, type CacheEntry, type CacheParams, CacheProvider, type CacheTag, type CommandContext, type CommandContextOptions, type CommandData, CommandExecutionMode, type CommandFileObject, CommandKit, type CommandKitButtonBuilderInteractionCollectorDispatch, type CommandKitButtonBuilderInteractionCollectorDispatchContextData, type CommandKitButtonBuilderOnEnd, type CommandKitConfig, type CommandKitConfiguration, type CommandKitData, type CommandKitElement, type CommandKitElementData, CommandKitEnvironment, type CommandKitEnvironmentInternalData, CommandKitEnvironmentType, type CommandKitModalBuilderInteractionCollectorDispatch, type CommandKitModalBuilderInteractionCollectorDispatchContextData, type CommandKitModalBuilderOnEnd, type CommandKitOptions, type CommandObject, type CommandOptions, type CommandProps, Context, type ContextMenuCommandProps, type ContextParameters, DefaultLocalizationStrategy, ElementType, EventInterceptor, type EventInterceptorContextData, type EventInterceptorErrorHandler, Fragment, type FragmentElementProps, type GenericFunction, type InteractionCommandContext, type InteractionCommandMiddlewareContext, Localization, type LocalizationConfig, type LocalizationStrategy, type LocalizationTranslationRequest, type MaybeArray, MemoryCache, type MessageCommandContext, type MessageCommandMiddlewareContext, MessageCommandOptions, type MessageCommandOptionsSchema, MessageCommandParser, type MessageContextMenuCommandContext, type MessageContextMenuCommandMiddlewareContext, type MessageContextMenuCommandProps, MiddlewareContext, Modal, ModalKit, type ModalKitPredicate, type ModalProps, type OnButtonKitClick, type OnButtonKitEnd, type OnModalKitEnd, type OnModalKitSubmit, ParagraphInput, type ParsedMessageCommand, type PreparedAppCommandExecution, type ReloadOptions, ReloadType, ShortInput, type SlashCommandContext, type SlashCommandMiddlewareContext, type SlashCommandProps, TextInput, type TextInputProps, type TranslatableArguments, type TranslatableCommand, type TranslatableCommandOptions, type Translation, type TranslationResult, type Translator, type UserContextMenuCommandContext, type UserContextMenuCommandMiddlewareContext, type UserContextMenuCommandProps, type ValidationProps, afterCommand, bootstrapCommandkitCLI, cache, cacheLife, cacheTag, cancelAfterCommand, createElement, CommandKit as default, defineConfig, dmOnly, exitContext, exitMiddleware, getCommandKit, getConfig, getContext, getElement, guildOnly, invalidate, isCommandKitElement, makeContextAwareFunction, rethrow, revalidate, useCache as super_duper_secret_internal_for_use_cache_directive_of_commandkit_cli_do_not_use_it_directly_or_you_will_be_fired_from_your_job_kthxbai, useEnvironment, version };
+export { ActionRow, type ActionRowProps, type AnyCommandKitElement, AppCommandHandler, type AsyncFunction, type AutocompleteCommandContext, type AutocompleteCommandMiddlewareContext, type AutocompleteProps, Button, type ButtonChildrenLike, ButtonKit, type ButtonKitPredicate, type ButtonProps, type CacheContext, type CacheEntry, type CacheMetadata, CacheProvider, type CommandContext, type CommandContextOptions, type CommandData, CommandExecutionMode, type CommandFileObject, CommandKit, type CommandKitButtonBuilderInteractionCollectorDispatch, type CommandKitButtonBuilderInteractionCollectorDispatchContextData, type CommandKitButtonBuilderOnEnd, type CommandKitConfig, type CommandKitConfiguration, type CommandKitData, type CommandKitElement, type CommandKitElementData, CommandKitEnvironment, type CommandKitEnvironmentInternalData, CommandKitEnvironmentType, type CommandKitLoggerOptions, type CommandKitModalBuilderInteractionCollectorDispatch, type CommandKitModalBuilderInteractionCollectorDispatchContextData, type CommandKitModalBuilderOnEnd, type CommandKitOptions, type CommandMatchResult, type CommandObject, type CommandOptions, type CommandProps, CommandsRouter, type CommandsRouterMatcher, type CommandsRouterMatchersMap, type CommandsRouterOptions, type CommandsTree, Context, type ContextMenuCommandProps, type ContextParameters, DefaultLocalizationStrategy, DefaultLogger, ElementType, EventInterceptor, type EventInterceptorContextData, type EventInterceptorErrorHandler, EventsRouter, type EventsRouterOptions, type EventsTree, Fragment, type FragmentElementProps, type GenericFunction, type ILogger, type InteractionCommandContext, type InteractionCommandMiddlewareContext, Localization, type LocalizationConfig, type LocalizationStrategy, type LocalizationTranslationRequest, Logger, type LoggerImpl, type MaybeArray, MemoryCache, type MessageCommandContext, type MessageCommandMiddlewareContext, MessageCommandOptions, type MessageCommandOptionsSchema, MessageCommandParser, type MessageContextMenuCommandContext, type MessageContextMenuCommandMiddlewareContext, type MessageContextMenuCommandProps, MiddlewareContext, Modal, ModalKit, type ModalKitPredicate, type ModalProps, type OnButtonKitClick, type OnButtonKitEnd, type OnModalKitEnd, type OnModalKitSubmit, ParagraphInput, type ParsedCommand, type ParsedEvent, type ParsedMessageCommand, type ParsedMiddleware, type PreparedAppCommandExecution, type ReloadOptions, ReloadType, ShortInput, type SlashCommandContext, type SlashCommandMiddlewareContext, type SlashCommandProps, TextInput, type TextInputProps, type TranslatableArguments, type TranslatableCommand, type TranslatableCommandOptions, type Translation, type TranslationResult, type Translator, type UserContextMenuCommandContext, type UserContextMenuCommandMiddlewareContext, type UserContextMenuCommandProps, type ValidationProps, afterCommand, bootstrapCommandkitCLI, cache, cacheLife, cacheTag, cancelAfterCommand, createElement, createLogger, CommandKit as default, defineConfig, dmOnly, exitContext, exitMiddleware, getCommandKit, getConfig, getContext, getElement, guildOnly, invalidate, isCachedFunction, isCommandKitElement, makeContextAwareFunction, redirect, rethrow, revalidate, useCache as super_duper_secret_internal_for_use_cache_directive_of_commandkit_cli_do_not_use_it_directly_or_you_will_be_fired_from_your_job_kthxbai, useEnvironment, version };