discord-embed-router 0.1.0 → 0.2.2

package/README.md

@@ -1,3 +1,3 @@
 # discord-embed-router
 
-A url-based router for discord.js interaction messages
+A url path based router for discord.js interaction messages

package/dist/index.d.mts

@@ -1,19 +1,23 @@
 import { ParamData, Path, MatchFunction, MatchResult, TokenData } from 'path-to-regexp';
-import { Interaction, InteractionEditReplyOptions, ButtonInteraction, InteractionReplyOptions, ButtonBuilder } from 'discord.js';
+import { Interaction, InteractionEditReplyOptions, ButtonInteraction, AnySelectMenuInteraction, InteractionReplyOptions, ButtonBuilder, APIButtonComponent, StringSelectMenuOptionBuilder, StringSelectMenuBuilder, StringSelectMenuComponentData, APIStringSelectComponent, RestOrArray, ChannelSelectMenuBuilder, ChannelSelectMenuComponentData, APIChannelSelectComponent, RoleSelectMenuBuilder, RoleSelectMenuComponentData, APIRoleSelectComponent, UserSelectMenuBuilder, UserSelectMenuComponentData, APIUserSelectComponent } from 'discord.js';
 
-type State<P extends ParamData> = MatchResult<P> & {
-    searchParams: URLSearchParams;
+type State<L, P extends ParamData = ParamData> = MatchResult<P> & {
+    embedRouter: EmbedRouter<L>;
+    locals?: L | undefined;
+    query: URLSearchParams;
 };
 type RouteResponse = InteractionEditReplyOptions;
-type RouteHandler<P extends ParamData> = (interaction: Interaction, state: State<P>) => RouteResponse;
-type CompiledRoute<P extends ParamData> = {
+type RouteHandler<L, P extends ParamData = ParamData> = (interaction: Interaction, state: State<L, P>) => Promise<RouteResponse> | RouteResponse;
+type Method = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+type CompiledRoute<L, P extends ParamData = ParamData> = {
+    method: Method;
     path: Path[];
     matchFunction: MatchFunction<P>;
-    handler: RouteHandler<P>;
+    handler: RouteHandler<L, P>;
 };
-type ResolvedRoute<P extends ParamData> = {
-    state: State<P>;
-    handler: RouteHandler<P>;
+type ResolvedRoute<L, P extends ParamData = ParamData> = {
+    state: State<L, P>;
+    handler: RouteHandler<L, P>;
 };
 
 type TakeIdentifier<T extends string, Name extends string = ""> = T extends `${infer Char}${infer Rest}` ? Char extends "/" | ":" | "*" | "{" | "}" ? [Name, T] : TakeIdentifier<Rest, `${Name}${Char}`> : [Name, T];
@@ -28,49 +32,97 @@ type ExtractParams<T extends string | TokenData, Depth extends string = ""> = T
     [K in Name]?: string;
 }) & ExtractParams<After, Depth> : ExtractParams<Rest, Depth> : Char extends "{" ? ExtractParams<Rest, `${Depth}1`> : Char extends "}" ? ExtractParams<Rest, Depth extends `1${infer Rest2}` ? Rest2 : Depth> : ExtractParams<Rest, Depth> : object : never;
 
-declare class EmbedRouter {
-    private static usedIdentifiers;
-    private static generateUniqueIdentifier;
-    private idPrefix;
+declare class EmbedRouter<L> {
+    #private;
     getIdPrefix(): string;
-    private routes;
     /**
      *
+     * @param name the name to give the router. ensures buttons stay connected across restarts
      * @param idPrefix the prefix for RouteButtonBuilder customIds
      */
-    constructor(idPrefix?: string);
+    constructor({ name, idPrefix, }?: {
+        name?: string | undefined;
+        idPrefix?: string | undefined;
+    });
     /**
      * Registers a path with the router
      *
      * @param routePath path to match with
      * @param handler function that generates the message when a path is matched
      */
-    on<P extends Path = Path>(routePath: P | P[], handler: RouteHandler<ExtractParams<P>>): void;
+    get<P extends Path = Path>(routePath: P | P[], handler: RouteHandler<L, ExtractParams<P>>): void;
+    /**
+     * Registers a path with the router
+     *
+     * @param routePath path to match with
+     * @param handler function that generates the message when a path is matched
+     */
+    post<P extends Path = Path>(routePath: P | P[], handler: RouteHandler<L, ExtractParams<P>>): void;
+    /**
+     * Registers a path with the router
+     *
+     * @param routePath path to match with
+     * @param handler function that generates the message when a path is matched
+     */
+    put<P extends Path = Path>(routePath: P | P[], handler: RouteHandler<L, ExtractParams<P>>): void;
+    /**
+     * Registers a path with the router
+     *
+     * @param routePath path to match with
+     * @param handler function that generates the message when a path is matched
+     */
+    patch<P extends Path = Path>(routePath: P | P[], handler: RouteHandler<L, ExtractParams<P>>): void;
+    /**
+     * Registers a path with the router
+     *
+     * @param routePath path to match with
+     * @param handler function that generates the message when a path is matched
+     */
+    delete<P extends Path = Path>(routePath: P | P[], handler: RouteHandler<L, ExtractParams<P>>): void;
     /**
      * Adds a subrouter to the router
      *
      * @param routePath path of the router
      * @param embedRouter router to add at the path
      */
-    use<P extends Path = Path>(routePath: P, embedRouter: EmbedRouter): void;
+    use<P extends Path = Path>(routePath: P, embedRouter: EmbedRouter<L>): void;
     /**
      * Must be attached to "interactionCreate" event for RouteButtonBuilder to work
      *
      * @param interaction interactions from "interactionCreate" (filter for ButtonInteractions)
      */
-    listener(interaction: ButtonInteraction): Promise<void>;
+    listener(interaction: ButtonInteraction | AnySelectMenuInteraction, locals?: L | undefined): Promise<void>;
     /**
      * Connect or update an interaction message to a path
      *
      * @param interaction interaction to connect to
      * @param path path to route the interaction to
+     * @param method method to send to route
      * @param flags optional discord flags to send with message (only allowed on first reply)
      */
-    dispatch<P extends Path = Path>(interaction: Interaction, path: P, flags?: InteractionReplyOptions["flags"]): Promise<void>;
-    private resolve;
+    dispatch<P extends Path = Path>({ interaction, method, path, flags, locals, }: {
+        interaction: Interaction;
+        method?: Method;
+        path: P;
+        flags?: InteractionReplyOptions["flags"] | undefined;
+        locals?: L | undefined;
+    }): Promise<void>;
 }
 
-declare class RouteButtonBuilder extends ButtonBuilder {
+type SetOptions<P extends Path> = {
+    method?: Method;
+    path: P;
+    query?: ConstructorParameters<typeof URLSearchParams>[0] | undefined;
+};
+
+declare class RouteButtonBuilder<L> extends ButtonBuilder {
+    #private;
+    /**
+     *
+     * @param embedRouter the router you want to route with
+     * @param data the data to construct a component out of
+     */
+    constructor(embedRouter: EmbedRouter<L>, data?: Omit<Partial<APIButtonComponent>, "custom_id" | "url"> | undefined);
     /**
      * Not supported for RouteButtonBuilder
      *
@@ -79,19 +131,202 @@ declare class RouteButtonBuilder extends ButtonBuilder {
      */
     setURL(): this;
     /**
-     * Not supported for RouteButtonBuilder (setTo uses customId)
+     * Not supported for RouteButtonBuilder (use setTo)
+     *
+     * @remarks
+     * @param
+     */
+    setCustomId(): this;
+    /**
+     * Sets the path to route to when clicked
+     *
+     * @param path the path to route to
+     * @param query any query parameters you want to add
+     * @param method method to send to route
+     */
+    setTo<P extends Path>({ method, path, query }: SetOptions<P>): this;
+    /**
+     * Sets the path to route to when clicked
+     *
+     * @param path the path to route to
+     */
+    setTo<P extends Path>(path: P): this;
+}
+
+declare class RouteStringSelectMenuOptionBuilder extends StringSelectMenuOptionBuilder {
+    /**
+     * Not supported for RouteStringSelectMenuOptionBuilder (use setTo)
+     *
+     * @remarks
+     * @param
+     */
+    setValue(): this;
+    /**
+     * Sets the path to route to when clicked
+     *
+     * @param path the path to route to
+     * @param query any query parameters you want to add
+     * @param method method to send to route
+     */
+    setTo<P extends Path>({ method, path, query }: SetOptions<P>): this;
+    /**
+     * Sets the path to route to when clicked
+     *
+     * @param path the path to route to
+     */
+    setTo<P extends Path>(path: P): this;
+}
+
+declare class RouteStringSelectMenuBuilder<L> extends StringSelectMenuBuilder {
+    #private;
+    /**
+     *
+     * @param embedRouter the router you want to route with
+     * @param path the path to redirect to, :to or *to in path will be replaced with the selected user's id
+     * @param query any query parameters you want to add, :to will be replaced with the selected user's id
+     * @param data the data to construct a component out of
+     */
+    constructor(embedRouter: EmbedRouter<L>, data?: Partial<StringSelectMenuComponentData | APIStringSelectComponent> | undefined);
+    /**
+     * Not supported for RouteStringSelectMenuBuilder (customId set from embedRouter)
      *
      * @remarks
      * @param
      */
     setCustomId(): this;
+    /**
+     * Not supported for RouteStringSelectMenuBuilder (use addTos)
+     *
+     * @remarks
+     * @param
+     */
+    addOptions(): this;
+    /**
+     * Not supported for RouteStringSelectMenuBuilder (use setTos)
+     *
+     * @remarks
+     * @param
+     */
+    setOptions(): this;
+    /**
+     * Adds route select menu options to builder
+     *
+     * @param tos the list of route select menu options
+     */
+    addTos(...tos: RestOrArray<RouteStringSelectMenuOptionBuilder | ConstructorParameters<typeof RouteStringSelectMenuOptionBuilder>[0]>): this;
+    /**
+     * Sets route select menu options to builder
+     *
+     * @param tos the list of route select menu options
+     */
+    setTos(...tos: RestOrArray<RouteStringSelectMenuOptionBuilder | ConstructorParameters<typeof RouteStringSelectMenuOptionBuilder>[0]>): this;
+    /**
+     * Sets the pattern to redirect to (Required)
+     *
+     * @param path the path to redirect to, :to or *to in path will be replaced with the selected user's id
+     * @param query any query parameters you want to add, :to will be replaced with the selected user's id
+     * @param method method to send to route
+     */
+    setPattern<P extends Path>({ method, path, query, }: SetOptions<P>): this;
+    /**
+     * Sets the path to route to when clicked
+     *
+     * @param path the path to route to
+     */
+    setPattern<P extends Path>(path: P): this;
+}
+
+declare class RouteChannelSelectMenuBuilder<L> extends ChannelSelectMenuBuilder {
+    #private;
+    /**
+     *
+     * @param embedRouter the router you want to route with
+     * @param data the data to construct a component out of
+     */
+    constructor(embedRouter: EmbedRouter<L>, data?: Partial<ChannelSelectMenuComponentData | APIChannelSelectComponent> | undefined);
+    /**
+     * Not supported for RouteChannelSelectMenuBuilder (customId set from embedRouter)
+     *
+     * @remarks
+     * @param
+     */
+    setCustomId(): this;
+    /**
+     * Sets the pattern to redirect to (Required)
+     *
+     * @param path the path to redirect to, :channelId in path will be replaced with the selected user's id
+     * @param query any query parameters you want to add, :channelId will be replaced with the selected user's id
+     * @param method method to send to route
+     */
+    setPattern<P extends Path>({ method, path, query, }: SetOptions<P>): this;
+    /**
+     * Sets the path to route to when clicked
+     *
+     * @param path the path to route to
+     */
+    setPattern<P extends Path>(path: P): this;
+}
+
+declare class RouteRoleSelectMenuBuilder<L> extends RoleSelectMenuBuilder {
+    #private;
+    /**
+     *
+     * @param embedRouter the router you want to route with
+     * @param data the data to construct a component out of
+     */
+    constructor(embedRouter: EmbedRouter<L>, data?: Partial<RoleSelectMenuComponentData | APIRoleSelectComponent> | undefined);
+    /**
+     * Not supported for RouteRoleSelectMenuBuilder (customId set from embedRouter)
+     *
+     * @remarks
+     * @param
+     */
+    setCustomId(): this;
+    /**
+     * Sets the pattern to redirect to (Required)
+     *
+     * @param path the path to redirect to, :roleId in path will be replaced with the selected user's id
+     * @param query any query parameters you want to add, :roleId will be replaced with the selected user's id
+     * @param method method to send to route
+     */
+    setPattern<P extends Path>({ method, path, query, }: SetOptions<P>): this;
+    /**
+     * Sets the path to route to when clicked
+     *
+     * @param path the path to route to
+     */
+    setPattern<P extends Path>(path: P): this;
+}
+
+declare class RouteUserSelectMenuBuilder<L> extends UserSelectMenuBuilder {
+    #private;
+    /**
+     *
+     * @param embedRouter the router you want to route with
+     * @param data the data to construct a component out of
+     */
+    constructor(embedRouter: EmbedRouter<L>, data?: Partial<UserSelectMenuComponentData | APIUserSelectComponent> | undefined);
+    /**
+     * Not supported for RouteUserSelectMenuBuilder (customId set from embedRouter)
+     *
+     * @remarks
+     * @param
+     */
+    setCustomId(): this;
+    /**
+     * Sets the pattern to redirect to (Required)
+     *
+     * @param path the path to redirect to, :userId in path will be replaced with the selected user's id
+     * @param query any query parameters you want to add, :userId will be replaced with the selected user's id
+     * @param method method to send to route
+     */
+    setPattern<P extends Path>({ method, path, query, }: SetOptions<P>): this;
     /**
      * Sets the path to route to when clicked
      *
      * @param path the path to route to
-     * @param idPrefix the prefix to add before the custom_id
      */
-    setTo<P extends Path>(embedRouter: EmbedRouter, path: P): void;
+    setPattern<P extends Path>(path: P): this;
 }
 
-export { type CompiledRoute, EmbedRouter, type ResolvedRoute, RouteButtonBuilder, type RouteHandler, type RouteResponse, type State };
+export { type CompiledRoute, EmbedRouter, type Method, type ResolvedRoute, RouteButtonBuilder, RouteChannelSelectMenuBuilder, type RouteHandler, type RouteResponse, RouteRoleSelectMenuBuilder, RouteStringSelectMenuBuilder, RouteStringSelectMenuOptionBuilder, RouteUserSelectMenuBuilder, type State };