@sapphire/plugin-api 7.0.0-next.03b2a90 → 7.0.0-next.26d4b68

package/dist/cjs/index.cjs

@@ -12,16 +12,18 @@ var MediaParserStore_cjs = require('./lib/structures/MediaParserStore.cjs');
 var Middleware_cjs = require('./lib/structures/Middleware.cjs');
 var MiddlewareStore_cjs = require('./lib/structures/MiddlewareStore.cjs');
 var Route_cjs = require('./lib/structures/Route.cjs');
+var RouterBranch_cjs = require('./lib/structures/router/RouterBranch.cjs');
+var RouterNode_cjs = require('./lib/structures/router/RouterNode.cjs');
+var RouterRoot_cjs = require('./lib/structures/router/RouterRoot.cjs');
 var RouteStore_cjs = require('./lib/structures/RouteStore.cjs');
 var MimeTypes_cjs = require('./lib/utils/MimeTypes.cjs');
-var RouteData_cjs = require('./lib/utils/RouteData.cjs');
 var _load_cjs = require('./listeners/_load.cjs');
 var _load_cjs$1 = require('./mediaParsers/_load.cjs');
 var _load_cjs$2 = require('./middlewares/_load.cjs');
 var _load_cjs$3 = require('./routes/_load.cjs');
 
 // src/index.ts
-var version = "7.0.0-next.03b2a90";
+var version = "7.0.0-next.26d4b68";
 
 Object.defineProperty(exports, "loadListeners", {
   enumerable: true,
@@ -112,22 +114,34 @@ Object.keys(Route_cjs).forEach(function (k) {
     get: function () { return Route_cjs[k]; }
   });
 });
-Object.keys(RouteStore_cjs).forEach(function (k) {
+Object.keys(RouterBranch_cjs).forEach(function (k) {
   if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
     enumerable: true,
-    get: function () { return RouteStore_cjs[k]; }
+    get: function () { return RouterBranch_cjs[k]; }
   });
 });
-Object.keys(MimeTypes_cjs).forEach(function (k) {
+Object.keys(RouterNode_cjs).forEach(function (k) {
   if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
     enumerable: true,
-    get: function () { return MimeTypes_cjs[k]; }
+    get: function () { return RouterNode_cjs[k]; }
+  });
+});
+Object.keys(RouterRoot_cjs).forEach(function (k) {
+  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+    enumerable: true,
+    get: function () { return RouterRoot_cjs[k]; }
   });
 });
-Object.keys(RouteData_cjs).forEach(function (k) {
+Object.keys(RouteStore_cjs).forEach(function (k) {
+  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+    enumerable: true,
+    get: function () { return RouteStore_cjs[k]; }
+  });
+});
+Object.keys(MimeTypes_cjs).forEach(function (k) {
   if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
     enumerable: true,
-    get: function () { return RouteData_cjs[k]; }
+    get: function () { return MimeTypes_cjs[k]; }
   });
 });
 //# sourceMappingURL=out.js.map

package/dist/cjs/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/index.ts"],"names":[],"mappings":";AAKA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAEd,SAAS,qBAAqB;AAC9B,SAAS,wBAAwB;AACjC,SAAS,uBAAuB;AAChC,SAAS,kBAAkB;AA+BpB,IAAM,UAAkB","sourcesContent":["import type { Server, ServerOptions } from './lib/structures/http/Server';\nimport type { MediaParserStore } from './lib/structures/MediaParserStore';\nimport type { MiddlewareStore } from './lib/structures/MiddlewareStore';\nimport type { RouteStore } from './lib/structures/RouteStore';\n\nexport * from './lib/structures/api/ApiRequest';\nexport * from './lib/structures/api/ApiResponse';\nexport * from './lib/structures/api/CookieStore';\nexport * from './lib/structures/http/Auth';\nexport * from './lib/structures/http/HttpCodes';\nexport * from './lib/structures/http/HttpMethods';\nexport * from './lib/structures/http/Server';\nexport * from './lib/structures/MediaParser';\nexport * from './lib/structures/MediaParserStore';\nexport * from './lib/structures/Middleware';\nexport * from './lib/structures/MiddlewareStore';\nexport * from './lib/structures/Route';\nexport * from './lib/structures/RouteStore';\nexport * from './lib/utils/MimeTypes';\nexport * from './lib/utils/RouteData';\n\nexport { loadListeners } from './listeners/_load';\nexport { loadMediaParsers } from './mediaParsers/_load';\nexport { loadMiddlewares } from './middlewares/_load';\nexport { loadRoutes } from './routes/_load';\n\ndeclare module 'discord.js' {\n\tinterface Client {\n\t\tserver: Server;\n\t}\n\n\tinterface ClientOptions {\n\t\tapi?: ServerOptions;\n\t}\n}\n\ndeclare module '@sapphire/pieces' {\n\tinterface StoreRegistryEntries {\n\t\troutes: RouteStore;\n\t\tmediaParsers: MediaParserStore;\n\t\tmiddlewares: MiddlewareStore;\n\t}\n\n\tinterface Container {\n\t\tserver: Server;\n\t}\n}\n\n/**\n * The [@sapphire/plugin-api](https://github.com/sapphiredev/plugins/blob/main/packages/api) version that you are currently using.\n * An example use of this is showing it of in a bot information command.\n *\n * Note to Sapphire developers: This needs to explicitly be `string` so it is not typed as the string that gets replaced by esbuild\n */\n// eslint-disable-next-line @typescript-eslint/no-inferrable-types\nexport const version: string = '7.0.0-next.03b2a90';\n"]}
+{"version":3,"sources":["../../src/index.ts"],"names":[],"mappings":";AAKA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAEd,SAAS,qBAAqB;AAC9B,SAAS,wBAAwB;AACjC,SAAS,uBAAuB;AAChC,SAAS,kBAAkB;AA+BpB,IAAM,UAAkB","sourcesContent":["import type { Server, ServerOptions } from './lib/structures/http/Server';\nimport type { MediaParserStore } from './lib/structures/MediaParserStore';\nimport type { MiddlewareStore } from './lib/structures/MiddlewareStore';\nimport type { RouteStore } from './lib/structures/RouteStore';\n\nexport * from './lib/structures/api/ApiRequest';\nexport * from './lib/structures/api/ApiResponse';\nexport * from './lib/structures/api/CookieStore';\nexport * from './lib/structures/http/Auth';\nexport * from './lib/structures/http/HttpCodes';\nexport * from './lib/structures/http/HttpMethods';\nexport * from './lib/structures/http/Server';\nexport * from './lib/structures/MediaParser';\nexport * from './lib/structures/MediaParserStore';\nexport * from './lib/structures/Middleware';\nexport * from './lib/structures/MiddlewareStore';\nexport * from './lib/structures/Route';\nexport * from './lib/structures/router/RouterBranch';\nexport * from './lib/structures/router/RouterNode';\nexport * from './lib/structures/router/RouterRoot';\nexport * from './lib/structures/RouteStore';\nexport * from './lib/utils/MimeTypes';\n\nexport { loadListeners } from './listeners/_load';\nexport { loadMediaParsers } from './mediaParsers/_load';\nexport { loadMiddlewares } from './middlewares/_load';\nexport { loadRoutes } from './routes/_load';\n\ndeclare module 'discord.js' {\n\tinterface Client {\n\t\tserver: Server;\n\t}\n\n\tinterface ClientOptions {\n\t\tapi?: ServerOptions;\n\t}\n}\n\ndeclare module '@sapphire/pieces' {\n\tinterface StoreRegistryEntries {\n\t\troutes: RouteStore;\n\t\tmediaParsers: MediaParserStore;\n\t\tmiddlewares: MiddlewareStore;\n\t}\n\n\tinterface Container {\n\t\tserver: Server;\n\t}\n}\n\n/**\n * The [@sapphire/plugin-api](https://github.com/sapphiredev/plugins/blob/main/packages/api) version that you are currently using.\n * An example use of this is showing it of in a bot information command.\n *\n * Note to Sapphire developers: This needs to explicitly be `string` so it is not typed as the string that gets replaced by esbuild\n */\n// eslint-disable-next-line @typescript-eslint/no-inferrable-types\nexport const version: string = '7.0.0-next.26d4b68';\n"]}

package/dist/cjs/index.d.cts

@@ -1,11 +1,33 @@
-import { EventEmitter } from 'node:events';
+import { AsyncEventEmitter } from '@vladfrangu/async_event_emitter';
 import { IncomingMessage, ServerResponse, Server as Server$1, ServerOptions as ServerOptions$1 } from 'node:http';
 import { ListenOptions } from 'node:net';
 import { Piece, Store } from '@sapphire/pieces';
 import { Awaitable } from '@sapphire/utilities';
 import { Gunzip } from 'zlib';
-import { Snowflake, OAuth2Scopes, RESTGetAPICurrentUserResult, RESTGetAPICurrentUserGuildsResult, RESTGetAPICurrentUserConnectionsResult, Collection } from 'discord.js';
 import { Readable } from 'node:stream';
+import { Snowflake, OAuth2Scopes, RESTGetAPICurrentUserResult, RESTGetAPICurrentUserGuildsResult, RESTGetAPICurrentUserConnectionsResult } from 'discord.js';
+
+declare enum MimeTypes {
+    ApplicationFormUrlEncoded = "application/x-www-form-urlencoded",
+    ApplicationJson = "application/json",
+    AudioOgg = "audio/ogg",
+    AudioOpus = "audio/opus",
+    AudioWebm = "audio/webm",
+    ImageGif = "image/gif",
+    ImageJpg = "image/jpeg",
+    ImagePng = "image/png",
+    ImageWebp = "image/webp",
+    ImageXIcon = "image/x-icon",
+    TextPlain = "text/plain",
+    TextHtml = "text/html",
+    VideoMp4 = "video/mp4",
+    VideoMpeg = "video/mpeg",
+    VideoOgg = "video/ogg",
+    VideoWebm = "video/webm"
+}
+
+type MethodName = (typeof MethodNames)[number];
+declare const MethodNames: readonly ["ACL", "BIND", "CHECKOUT", "CONNECT", "COPY", "DELETE", "GET", "HEAD", "LINK", "LOCK", "M-SEARCH", "MERGE", "MKACTIVITY", "MKCALENDAR", "MKCOL", "MOVE", "NOTIFY", "OPTIONS", "PATCH", "POST", "PROPFIND", "PROPPATCH", "PURGE", "PUT", "REBIND", "REPORT", "SEARCH", "SOURCE", "SUBSCRIBE", "TRACE", "UNBIND", "UNLINK", "UNLOCK", "UNSUBSCRIBE"];
 
 declare class Auth {
     #private;
@@ -167,82 +189,6 @@ interface LoginDataTransformer<T extends LoginData = LoginData> {
     (data: LoginData): Awaitable<T>;
 }
 
-declare class ApiRequest extends IncomingMessage {
-    /**
-     * The query parameters.
-     */
-    query: Record<string, string | string[]>;
-    /**
-     * The URI parameters.
-     */
-    params: Record<string, string>;
-    /**
-     * The body that was sent by the user.
-     */
-    body?: unknown;
-    /**
-     * The authorization information. This field indicates three possible values:
-     *
-     * - `undefined`: The authorization middleware has not been executed yet.
-     * - `null`: The user is not authorized.
-     * - `AuthData`: The user is authorized.
-     */
-    auth?: AuthData | null;
-}
-
-/**
- * @since 1.0.0
- */
-declare enum TypeState {
-    /**
-     * @since 1.0.0
-     */
-    Static = 0,
-    /**
-     * @since 1.0.0
-     */
-    Dynamic = 1
-}
-type MatchData = Record<string, string> | null;
-declare class RouteData {
-    readonly path: string;
-    private readonly static;
-    private readonly parts;
-    constructor(path: string);
-    match(split: readonly string[]): MatchData;
-    /**
-     * @since 1.0.0
-     */
-    private static parsePart;
-    /**
-     * @since 1.0.0
-     */
-    private static split;
-}
-interface ParsedPart {
-    value: string;
-    type: TypeState;
-}
-
-declare enum MimeTypes {
-    ApplicationFormUrlEncoded = "application/x-www-form-urlencoded",
-    ApplicationJson = "application/json",
-    AudioOgg = "audio/ogg",
-    AudioOpus = "audio/opus",
-    AudioWebm = "audio/webm",
-    ImageGif = "image/gif",
-    ImageJpg = "image/jpeg",
-    ImagePng = "image/png",
-    ImageWebp = "image/webp",
-    ImageXIcon = "image/x-icon",
-    TextPlain = "text/plain",
-    TextHtml = "text/html",
-    VideoMp4 = "video/mp4",
-    VideoMpeg = "video/mpeg",
-    VideoOgg = "video/ogg",
-    VideoWebm = "video/webm"
-}
-
 declare class CookieStore extends Map<string, string> {
     protected request: ApiRequest;
     protected response: ApiResponse;
@@ -307,6 +253,10 @@ declare class ApiResponse<Request extends IncomingMessage = IncomingMessage> ext
      * @since 1.0.0
      */
     notFound(data?: unknown): void;
+    /**
+     * @since 7.0.0
+     */
+    methodNotAllowed(data?: unknown): void;
     /**
      * @since 1.0.0
      */
@@ -350,9 +300,6 @@ declare class ApiResponse<Request extends IncomingMessage = IncomingMessage> ext
     setContentType(contentType: MimeTypes): this;
 }
 
-type MethodName = (typeof MethodNames)[number];
-declare const MethodNames: readonly ["ACL", "BIND", "CHECKOUT", "CONNECT", "COPY", "DELETE", "GET", "HEAD", "LINK", "LOCK", "M-SEARCH", "MERGE", "MKACTIVITY", "MKCALENDAR", "MKCOL", "MOVE", "NOTIFY", "OPTIONS", "PATCH", "POST", "PROPFIND", "PROPPATCH", "PURGE", "PUT", "REBIND", "REPORT", "SEARCH", "SOURCE", "SUBSCRIBE", "TRACE", "UNBIND", "UNLINK", "UNLOCK", "UNSUBSCRIBE"];
-
 interface RouteOptions extends Piece.Options {
     /**
      * The route the piece should represent.
@@ -441,9 +388,9 @@ declare abstract class Route<Options extends Route.Options = Route.Options> exte
      */
     readonly acceptedContentMimeTypes: readonly MimeTypeWithoutParameters[] | null;
     /**
-     * The route information.
+     * The path this route represents.
      */
-    readonly router: RouteData;
+    readonly path: readonly string[];
     /**
      * The methods this route accepts.
      */
@@ -462,6 +409,141 @@ declare namespace Route {
     type Response = ApiResponse;
 }
 
+declare class RouterBranch {
+    /**
+     * The name of the branch.
+     */
+    readonly name: string;
+    /**
+     * Whether or not the branch is dynamic.
+     */
+    readonly dynamic: boolean;
+    /**
+     * The parent branch, if any.
+     */
+    readonly parent: RouterBranch | null;
+    /**
+     * The node this branch is associated with.
+     */
+    readonly node: RouterNode;
+    /**
+     * The methods supported by the branch's node or any of its children.
+     */
+    supportedMethods: readonly string[];
+    private _staticChildren;
+    private _dynamicChild;
+    constructor(name: string, dynamic: boolean, parent: RouterBranch | null);
+    /**
+     * The path representing this branch
+     * @version 7.0.0
+     */
+    get path(): string;
+    /**
+     * The branches the branch is associated with
+     * @version 7.0.0
+     */
+    get children(): RouterBranch[];
+    /**
+     * Whether or not the branch is empty
+     * @version 7.0.0
+     */
+    get empty(): boolean;
+    /**
+     * Tries to find a branch given a path
+     * @version 7.0.0
+     *
+     * @param parts The parts of a path to find a node from
+     * @returns The branch found, or null if not found
+     */
+    find(parts: readonly string[]): RouterBranch | null;
+    /**
+     * Checks if the given name matches the branch
+     * @version 7.0.0
+     *
+     * @param name The name to match
+     * @returns Whether or not the branch matches the name
+     */
+    matches(name: string): boolean;
+    /**
+     * Returns the string representation of the branch
+     * @version 7.0.0
+     *
+     * @returns The string representation of the branch
+     */
+    toString(): string;
+    nodes(): IterableIterator<RouterNode>;
+    protected _add(parts: readonly string[], index: number, route: Route): RouterNode;
+    protected _remove(parts: readonly string[], index: number, route: Route): boolean;
+    protected _performAdd(parts: readonly string[], index: number, route: Route): RouterNode;
+    protected _performRemove(parts: readonly string[], index: number, route: Route): boolean;
+    protected _find(parts: readonly string[], index: number): RouterBranch | null;
+    protected _updateSupportedChildrenMethods(): void;
+}
+
+declare class RouterNode {
+    #private;
+    /**
+     * The branch containing this node.
+     */
+    readonly parent: RouterBranch;
+    constructor(parent: RouterBranch);
+    get path(): string;
+    extractParameters(parts: readonly string[]): Record<string, string>;
+    get(method: MethodName): Route | null;
+    set(method: MethodName, route: Route): this;
+    delete(method: MethodName, route: Route): boolean;
+    methods(): IterableIterator<MethodName>;
+}
+
+declare class ApiRequest extends IncomingMessage {
+    /**
+     * The query parameters.
+     */
+    query: Record<string, string | string[]>;
+    /**
+     * The URI parameters.
+     */
+    params: Record<string, string>;
+    /**
+     * The body that was sent by the user.
+     */
+    body?: unknown;
+    /**
+     * The authorization information. This field indicates three possible values:
+     *
+     * - `undefined`: The authorization middleware has not been executed yet.
+     * - `null`: The user is not authorized.
+     * - `AuthData`: The user is authorized.
+     */
+    auth?: AuthData | null;
+    /**
+     * The router node that matched the request. The field indicates three
+     * possible values:
+     *
+     * - `undefined`: The router handler has not been executed yet.
+     * - `null`: The router handler has been executed, but no node matched the
+     *   request.
+     * - `RouterNode`: The router handler has been executed and a node matched
+     *   the request.
+     *
+     * @since 7.0.0
+     */
+    routerNode?: RouterNode | null;
+    /**
+     * The route that matched the request. The field indicates three possible
+     * values:
+     *
+     * - `undefined`: The router handler has not been executed yet.
+     * - `null`: The router handler has been executed, but no route matched the
+     *   request.
+     * - `Route`: The router handler has been executed and a route matched the
+     *   request.
+     *
+     * @since 7.0.0
+     */
+    route?: Route | null;
+}
+
 /**
  * A media parser
  * @since 1.3.0
@@ -554,7 +636,7 @@ declare abstract class Middleware<Options extends Middleware.Options = Middlewar
      * @param response The server's response.
      * @param route The route that matched this request, will be `null` if none matched.
      */
-    abstract run(request: Middleware.Request, response: Middleware.Response, route: Route | null): Awaitable<unknown>;
+    abstract run(request: Middleware.Request, response: Middleware.Response): Awaitable<unknown>;
 }
 declare namespace Middleware {
     /** @deprecated Use {@linkcode LoaderContext} instead. */
@@ -576,36 +658,68 @@ declare class MiddlewareStore extends Store<Middleware, 'middlewares'> {
      */
     readonly sortedMiddlewares: Middleware[];
     constructor();
-    run(request: Middleware.Request, response: Middleware.Response, route: Route | null): Promise<void>;
+    run(request: Middleware.Request, response: Middleware.Response): Promise<void>;
     set(key: string, value: Middleware): this;
     delete(key: string): boolean;
     clear(): void;
 }
 
+declare class RouterRoot extends RouterBranch {
+    constructor();
+    /**
+     * Adds a route to the branch
+     *
+     * @param route The route to add
+     * @returns The node the route was added to
+     */
+    add(route: Route): RouterNode;
+    /**
+     * Removes a route from the branch
+     *
+     * @param route The route to remove
+     * @returns Whether or not the route was removed
+     */
+    remove(route: Route): boolean;
+    get path(): string;
+    toString(): string;
+    static normalize(path: string | null | undefined): string[];
+    static extractMethod(path: readonly string[]): MethodName | null;
+}
+
 /**
  * @since 1.0.0
  */
 declare class RouteStore extends Store<Route, 'routes'> {
-    readonly methods: Collection<"ACL" | "BIND" | "CHECKOUT" | "CONNECT" | "COPY" | "DELETE" | "GET" | "HEAD" | "LINK" | "LOCK" | "M-SEARCH" | "MERGE" | "MKACTIVITY" | "MKCALENDAR" | "MKCOL" | "MOVE" | "NOTIFY" | "OPTIONS" | "PATCH" | "POST" | "PROPFIND" | "PROPPATCH" | "PURGE" | "PUT" | "REBIND" | "REPORT" | "SEARCH" | "SOURCE" | "SUBSCRIBE" | "TRACE" | "UNBIND" | "UNLINK" | "UNLOCK" | "UNSUBSCRIBE", Collection<Route<RouteOptions>, RouteData>>;
+    readonly router: RouterRoot;
     constructor();
-    match(request: Route.Request): Route | null;
-    private parseURL;
 }
 
-declare enum ServerEvents {
+declare enum ServerEvent {
     Error = "error",
     Request = "request",
-    Match = "match",
-    NoMatch = "noMatch",
+    RouterBranchNotFound = "routerBranchNotFound",
+    RouterBranchMethodNotAllowed = "routerBranchMethodNotAllowed",
+    RouterFound = "routerFound",
     RouteError = "routeError",
     MiddlewareFailure = "middlewareFailure",
     MiddlewareError = "middlewareError",
     MiddlewareSuccess = "middlewareSuccess"
 }
+interface ServerEvents {
+    [ServerEvent.Error]: [error: Error, request: ApiRequest, response: ApiResponse];
+    [ServerEvent.Request]: [request: ApiRequest, response: ApiResponse];
+    [ServerEvent.RouterBranchNotFound]: [request: ApiRequest, response: ApiResponse];
+    [ServerEvent.RouterBranchMethodNotAllowed]: [request: ApiRequest, response: ApiResponse, node: RouterBranch];
+    [ServerEvent.RouterFound]: [request: ApiRequest, response: ApiResponse];
+    [ServerEvent.RouteError]: [error: Error, request: ApiRequest, response: ApiResponse];
+    [ServerEvent.MiddlewareFailure]: [request: ApiRequest, response: ApiResponse];
+    [ServerEvent.MiddlewareSuccess]: [request: Route.Request, response: Route.Response, route: Route];
+    [ServerEvent.MiddlewareError]: [error: Error, request: ApiRequest, response: ApiResponse];
+}
 /**
  * @since 1.0.0
  */
-declare class Server extends EventEmitter {
+declare class Server extends AsyncEventEmitter<ServerEvents> {
     /**
      * The routes this server holds.
      * @since 1.0.0
@@ -738,27 +852,6 @@ interface ServerOptions {
  * @since 1.0.0
  */
 type AuthLessServerOptions = Omit<ServerOptions, 'auth'>;
-/**
- * The context sent in the error events.
- * @since 1.2.0
- */
-interface MiddlewareErrorContext {
-    /**
-     * The erroneous request.
-     * @since 1.2.0
-     */
-    request: ApiRequest;
-    /**
-     * The server's response.
-     * @since 1.2.0
-     */
-    response: ApiResponse;
-    /**
-     * The route match.
-     * @since 1.2.0
-     */
-    route: Route;
-}
 
 declare enum HttpCodes {
     /**
@@ -1172,4 +1265,4 @@ declare module '@sapphire/pieces' {
  */
 declare const version: string;
 
-export { ApiRequest, ApiResponse, Auth, type AuthData, type AuthLessServerOptions, type ContentTypeParameter, type ContentTypeType, CookieStore, HttpCodes, type LoginData, type LoginDataTransformer, type MatchData, MediaParser, MediaParserStore, type MethodName, MethodNames, Middleware, type MiddlewareErrorContext, type MiddlewareOptions, MiddlewareStore, type MimeType, type MimeTypeWithoutParameters, MimeTypes, type ParsedPart, Route, RouteData, type RouteOptions, RouteStore, type SecureCookieStoreSetOptions, Server, ServerEvents, type ServerOptions, type ServerOptionsAuth, TypeState, loadListeners, loadMediaParsers, loadMiddlewares, loadRoutes, version };
+export { ApiRequest, ApiResponse, Auth, type AuthData, type AuthLessServerOptions, type ContentTypeParameter, type ContentTypeType, CookieStore, HttpCodes, type LoginData, type LoginDataTransformer, MediaParser, MediaParserStore, type MethodName, MethodNames, Middleware, type MiddlewareOptions, MiddlewareStore, type MimeType, type MimeTypeWithoutParameters, MimeTypes, Route, type RouteOptions, RouteStore, RouterBranch, RouterNode, RouterRoot, type SecureCookieStoreSetOptions, Server, ServerEvent, type ServerEvents, type ServerOptions, type ServerOptionsAuth, loadListeners, loadMediaParsers, loadMiddlewares, loadRoutes, version };

package/dist/cjs/lib/structures/Middleware.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/structures/Middleware.ts"],"names":[],"mappings":";;;;;;AAAA,SAAS,aAAa;AASf,IAAe,cAAf,MAAe,oBAA4E,MAA8B;AAAA,EAaxH,YAAY,SAAmC,UAAmB,CAAC,GAAc;AACvF,UAAM,SAAS,OAAO;AAHvB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,wBAAgB;AAIf,SAAK,WAAW,QAAQ,YAAY;AAAA,EACrC;AASD;AAzBgI;AAAzH,IAAe,aAAf","sourcesContent":["import { Piece } from '@sapphire/pieces';\nimport type { Awaitable } from '@sapphire/utilities';\nimport type { Route } from './Route';\nimport type { ApiRequest } from './api/ApiRequest';\nimport type { ApiResponse } from './api/ApiResponse';\n\n/**\n * @since 1.0.0\n */\nexport abstract class Middleware<Options extends Middleware.Options = Middleware.Options> extends Piece<Options, 'middlewares'> {\n\t/**\n\t * The position the middleware has. The {@link MiddlewareStore} will run all middlewares with lower position than\n\t * this one.\n\t *\n\t * The built-in middlewares follow the following positions:\n\t * - headers: 10\n\t * - body: 20\n\t * - cookies: 30\n\t * - auth: 40\n\t */\n\tpublic readonly position: number;\n\n\tpublic constructor(context: Middleware.LoaderContext, options: Options = {} as Options) {\n\t\tsuper(context, options);\n\t\tthis.position = options.position ?? 1000;\n\t}\n\n\t/**\n\t * The method to be overridden by other middlewares.\n\t * @param request The client's request.\n\t * @param response The server's response.\n\t * @param route The route that matched this request, will be `null` if none matched.\n\t */\n\tpublic abstract run(request: Middleware.Request, response: Middleware.Response, route: Route | null): Awaitable<unknown>;\n}\n\n/**\n * The options for all middlewares.\n */\nexport interface MiddlewareOptions extends Piece.Options {\n\t/**\n\t * The position to insert the middleware at.\n\t * @see Middleware#position\n\t * @default 1000\n\t */\n\tposition?: number;\n}\n\nexport namespace Middleware {\n\t/** @deprecated Use {@linkcode LoaderContext} instead. */\n\texport type Context = LoaderContext;\n\texport type LoaderContext = Piece.LoaderContext<'middlewares'>;\n\texport type Options = MiddlewareOptions;\n\texport type JSON = Piece.JSON;\n\texport type LocationJSON = Piece.LocationJSON;\n\n\texport type Request = ApiRequest;\n\texport type Response = ApiResponse;\n}\n"]}
+{"version":3,"sources":["../../../../src/lib/structures/Middleware.ts"],"names":[],"mappings":";;;;;;AAAA,SAAS,aAAa;AAQf,IAAe,cAAf,MAAe,oBAA4E,MAA8B;AAAA,EAaxH,YAAY,SAAmC,UAAmB,CAAC,GAAc;AACvF,UAAM,SAAS,OAAO;AAHvB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,wBAAgB;AAIf,SAAK,WAAW,QAAQ,YAAY;AAAA,EACrC;AASD;AAzBgI;AAAzH,IAAe,aAAf","sourcesContent":["import { Piece } from '@sapphire/pieces';\nimport type { Awaitable } from '@sapphire/utilities';\nimport type { ApiRequest } from './api/ApiRequest';\nimport type { ApiResponse } from './api/ApiResponse';\n\n/**\n * @since 1.0.0\n */\nexport abstract class Middleware<Options extends Middleware.Options = Middleware.Options> extends Piece<Options, 'middlewares'> {\n\t/**\n\t * The position the middleware has. The {@link MiddlewareStore} will run all middlewares with lower position than\n\t * this one.\n\t *\n\t * The built-in middlewares follow the following positions:\n\t * - headers: 10\n\t * - body: 20\n\t * - cookies: 30\n\t * - auth: 40\n\t */\n\tpublic readonly position: number;\n\n\tpublic constructor(context: Middleware.LoaderContext, options: Options = {} as Options) {\n\t\tsuper(context, options);\n\t\tthis.position = options.position ?? 1000;\n\t}\n\n\t/**\n\t * The method to be overridden by other middlewares.\n\t * @param request The client's request.\n\t * @param response The server's response.\n\t * @param route The route that matched this request, will be `null` if none matched.\n\t */\n\tpublic abstract run(request: Middleware.Request, response: Middleware.Response): Awaitable<unknown>;\n}\n\n/**\n * The options for all middlewares.\n */\nexport interface MiddlewareOptions extends Piece.Options {\n\t/**\n\t * The position to insert the middleware at.\n\t * @see Middleware#position\n\t * @default 1000\n\t */\n\tposition?: number;\n}\n\nexport namespace Middleware {\n\t/** @deprecated Use {@linkcode LoaderContext} instead. */\n\texport type Context = LoaderContext;\n\texport type LoaderContext = Piece.LoaderContext<'middlewares'>;\n\texport type Options = MiddlewareOptions;\n\texport type JSON = Piece.JSON;\n\texport type LocationJSON = Piece.LocationJSON;\n\n\texport type Request = ApiRequest;\n\texport type Response = ApiResponse;\n}\n"]}

package/dist/cjs/lib/structures/MiddlewareStore.cjs

@@ -15,10 +15,10 @@ var _MiddlewareStore = class _MiddlewareStore extends pieces.Store {
      */
     __publicField(this, "sortedMiddlewares", []);
   }
-  async run(request, response, route) {
+  async run(request, response) {
     for (const middleware of this.sortedMiddlewares) {
       if (response.writableEnded) return;
-      if (middleware.enabled) await middleware.run(request, response, route);
+      if (middleware.enabled) await middleware.run(request, response);
     }
   }
   set(key, value) {

package/dist/cjs/lib/structures/MiddlewareStore.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/structures/MiddlewareStore.ts"],"names":[],"mappings":";;;;;;AAAA,SAAS,aAAa;AACtB,SAAS,kBAAkB;AAMpB,IAAM,mBAAN,MAAM,yBAAwB,MAAiC;AAAA,EAM9D,cAAc;AACpB,UAAM,YAAY,EAAE,MAAM,cAAc,CAAC;AAH1C;AAAA;AAAA;AAAA,wBAAgB,qBAAkC,CAAC;AAAA,EAInD;AAAA,EAEA,MAAa,IAAI,SAA6B,UAA+B,OAAoC;AAChH,eAAW,cAAc,KAAK,mBAAmB;AAChD,UAAI,SAAS,cAAe;AAC5B,UAAI,WAAW,QAAS,OAAM,WAAW,IAAI,SAAS,UAAU,KAAK;AAAA,IACtE;AAAA,EACD;AAAA,EAEgB,IAAI,KAAa,OAAyB;AACzD,UAAM,QAAQ,KAAK,kBAAkB,UAAU,CAAC,eAAe,WAAW,YAAY,MAAM,QAAQ;AAGpG,QAAI,UAAU,GAAI,MAAK,kBAAkB,KAAK,KAAK;AAAA,QAC9C,MAAK,kBAAkB,OAAO,OAAO,GAAG,KAAK;AAElD,WAAO,MAAM,IAAI,KAAK,KAAK;AAAA,EAC5B;AAAA,EAEgB,OAAO,KAAsB;AAC5C,UAAM,QAAQ,KAAK,kBAAkB,UAAU,CAAC,eAAe,WAAW,SAAS,GAAG;AAGtF,QAAI,UAAU,GAAI,MAAK,kBAAkB,OAAO,OAAO,CAAC;AAExD,WAAO,MAAM,OAAO,GAAG;AAAA,EACxB;AAAA,EAEgB,QAAc;AAC7B,SAAK,kBAAkB,SAAS;AAChC,WAAO,MAAM,MAAM;AAAA,EACpB;AACD;AAxCsE;AAA/D,IAAM,kBAAN","sourcesContent":["import { Store } from '@sapphire/pieces';\nimport { Middleware } from './Middleware';\nimport type { Route } from './Route';\n\n/**\n * @since 1.0.0\n */\nexport class MiddlewareStore extends Store<Middleware, 'middlewares'> {\n\t/**\n\t * The sorted middlewares, in ascending order of see {@link Middleware.position}.\n\t */\n\tpublic readonly sortedMiddlewares: Middleware[] = [];\n\n\tpublic constructor() {\n\t\tsuper(Middleware, { name: 'middlewares' });\n\t}\n\n\tpublic async run(request: Middleware.Request, response: Middleware.Response, route: Route | null): Promise<void> {\n\t\tfor (const middleware of this.sortedMiddlewares) {\n\t\t\tif (response.writableEnded) return;\n\t\t\tif (middleware.enabled) await middleware.run(request, response, route);\n\t\t}\n\t}\n\n\tpublic override set(key: string, value: Middleware): this {\n\t\tconst index = this.sortedMiddlewares.findIndex((middleware) => middleware.position >= value.position);\n\n\t\t// If a middleware with lower priority wasn't found, push to the end of the array\n\t\tif (index === -1) this.sortedMiddlewares.push(value);\n\t\telse this.sortedMiddlewares.splice(index, 0, value);\n\n\t\treturn super.set(key, value);\n\t}\n\n\tpublic override delete(key: string): boolean {\n\t\tconst index = this.sortedMiddlewares.findIndex((middleware) => middleware.name === key);\n\n\t\t// If the middleware was found, remove it\n\t\tif (index !== -1) this.sortedMiddlewares.splice(index, 1);\n\n\t\treturn super.delete(key);\n\t}\n\n\tpublic override clear(): void {\n\t\tthis.sortedMiddlewares.length = 0;\n\t\treturn super.clear();\n\t}\n}\n"]}
+{"version":3,"sources":["../../../../src/lib/structures/MiddlewareStore.ts"],"names":[],"mappings":";;;;;;AAAA,SAAS,aAAa;AACtB,SAAS,kBAAkB;AAKpB,IAAM,mBAAN,MAAM,yBAAwB,MAAiC;AAAA,EAM9D,cAAc;AACpB,UAAM,YAAY,EAAE,MAAM,cAAc,CAAC;AAH1C;AAAA;AAAA;AAAA,wBAAgB,qBAAkC,CAAC;AAAA,EAInD;AAAA,EAEA,MAAa,IAAI,SAA6B,UAA8C;AAC3F,eAAW,cAAc,KAAK,mBAAmB;AAChD,UAAI,SAAS,cAAe;AAC5B,UAAI,WAAW,QAAS,OAAM,WAAW,IAAI,SAAS,QAAQ;AAAA,IAC/D;AAAA,EACD;AAAA,EAEgB,IAAI,KAAa,OAAyB;AACzD,UAAM,QAAQ,KAAK,kBAAkB,UAAU,CAAC,eAAe,WAAW,YAAY,MAAM,QAAQ;AAGpG,QAAI,UAAU,GAAI,MAAK,kBAAkB,KAAK,KAAK;AAAA,QAC9C,MAAK,kBAAkB,OAAO,OAAO,GAAG,KAAK;AAElD,WAAO,MAAM,IAAI,KAAK,KAAK;AAAA,EAC5B;AAAA,EAEgB,OAAO,KAAsB;AAC5C,UAAM,QAAQ,KAAK,kBAAkB,UAAU,CAAC,eAAe,WAAW,SAAS,GAAG;AAGtF,QAAI,UAAU,GAAI,MAAK,kBAAkB,OAAO,OAAO,CAAC;AAExD,WAAO,MAAM,OAAO,GAAG;AAAA,EACxB;AAAA,EAEgB,QAAc;AAC7B,SAAK,kBAAkB,SAAS;AAChC,WAAO,MAAM,MAAM;AAAA,EACpB;AACD;AAxCsE;AAA/D,IAAM,kBAAN","sourcesContent":["import { Store } from '@sapphire/pieces';\nimport { Middleware } from './Middleware';\n\n/**\n * @since 1.0.0\n */\nexport class MiddlewareStore extends Store<Middleware, 'middlewares'> {\n\t/**\n\t * The sorted middlewares, in ascending order of see {@link Middleware.position}.\n\t */\n\tpublic readonly sortedMiddlewares: Middleware[] = [];\n\n\tpublic constructor() {\n\t\tsuper(Middleware, { name: 'middlewares' });\n\t}\n\n\tpublic async run(request: Middleware.Request, response: Middleware.Response): Promise<void> {\n\t\tfor (const middleware of this.sortedMiddlewares) {\n\t\t\tif (response.writableEnded) return;\n\t\t\tif (middleware.enabled) await middleware.run(request, response);\n\t\t}\n\t}\n\n\tpublic override set(key: string, value: Middleware): this {\n\t\tconst index = this.sortedMiddlewares.findIndex((middleware) => middleware.position >= value.position);\n\n\t\t// If a middleware with lower priority wasn't found, push to the end of the array\n\t\tif (index === -1) this.sortedMiddlewares.push(value);\n\t\telse this.sortedMiddlewares.splice(index, 0, value);\n\n\t\treturn super.set(key, value);\n\t}\n\n\tpublic override delete(key: string): boolean {\n\t\tconst index = this.sortedMiddlewares.findIndex((middleware) => middleware.name === key);\n\n\t\t// If the middleware was found, remove it\n\t\tif (index !== -1) this.sortedMiddlewares.splice(index, 1);\n\n\t\treturn super.delete(key);\n\t}\n\n\tpublic override clear(): void {\n\t\tthis.sortedMiddlewares.length = 0;\n\t\treturn super.clear();\n\t}\n}\n"]}

package/dist/cjs/lib/structures/Route.cjs

@@ -1,7 +1,8 @@
 'use strict';
 
 var pieces = require('@sapphire/pieces');
-var RouteData_cjs = require('../utils/RouteData.cjs');
+var utilities = require('@sapphire/utilities');
+var RouterRoot_cjs = require('./router/RouterRoot.cjs');
 
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
@@ -19,25 +20,27 @@ var _Route = class _Route extends pieces.Piece {
      */
     __publicField(this, "acceptedContentMimeTypes");
     /**
-     * The route information.
+     * The path this route represents.
      */
-    __publicField(this, "router");
+    __publicField(this, "path");
     /**
      * The methods this route accepts.
      */
     __publicField(this, "methods");
     const api = this.container.server.options;
-    const prefix = api.prefix ? api.prefix.endsWith("/") ? api.prefix : `${api.prefix}/` : "";
-    let path = options.route ?? (this.location.virtual ? this.name : this.location.directories.concat(this.name).join("/"));
+    const path = [].concat(
+      RouterRoot_cjs.RouterRoot.normalize(api.prefix),
+      RouterRoot_cjs.RouterRoot.normalize(options.route ?? (this.location.virtual ? this.name : this.location.directories.concat(this.name).join("/")))
+    );
     const methods = new Set(options.methods);
-    const methodIndex = path.lastIndexOf(".");
-    if (methodIndex !== -1) {
-      const method = path.slice(methodIndex + 1).toUpperCase();
-      if (!methods.has(method)) methods.add(method);
-      path = path.slice(0, methodIndex);
+    const implied = RouterRoot_cjs.RouterRoot.extractMethod(path);
+    if (!utilities.isNullish(implied)) {
+      const lastIndex = path.length - 1;
+      path[lastIndex] = path[lastIndex].slice(0, path[lastIndex].length - implied.length - 1);
+      methods.add(implied);
     }
+    this.path = path;
     this.methods = methods;
-    this.router = new RouteData_cjs.RouteData(`${prefix}${path}`);
     this.maximumBodyLength = options.maximumBodyLength ?? api.maximumBodyLength ?? 1024 * 1024 * 50;
     this.acceptedContentMimeTypes = options.acceptedContentMimeTypes ?? api.acceptedContentMimeTypes ?? null;
   }

package/dist/cjs/lib/structures/Route.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/structures/Route.ts"],"names":[],"mappings":";;;;;;AAAA,SAAS,aAAa;AAEtB,SAAS,iBAAiB;AA2CnB,IAAe,SAAf,MAAe,eAA6D,MAAyB;AAAA,EAqBpG,YAAY,SAA8B,UAAmB,CAAC,GAAc;AAClF,UAAM,SAAS,OAAO;AAlBvB;AAAA;AAAA;AAAA,wBAAgB;AAKhB;AAAA;AAAA;AAAA,wBAAgB;AAKhB;AAAA;AAAA;AAAA,wBAAgB;AAKhB;AAAA;AAAA;AAAA,wBAAgB;AAKf,UAAM,MAAM,KAAK,UAAU,OAAO;AAElC,UAAM,SAAS,IAAI,SAAU,IAAI,OAAO,SAAS,GAAG,IAAI,IAAI,SAAS,GAAG,IAAI,MAAM,MAAO;AAIzF,QAAI,OAAO,QAAQ,UAAU,KAAK,SAAS,UAAU,KAAK,OAAO,KAAK,SAAS,YAAY,OAAO,KAAK,IAAI,EAAE,KAAK,GAAG;AAErH,UAAM,UAAU,IAAI,IAAI,QAAQ,OAAO;AAEvC,UAAM,cAAc,KAAK,YAAY,GAAG;AACxC,QAAI,gBAAgB,IAAI;AAEvB,YAAM,SAAS,KAAK,MAAM,cAAc,CAAC,EAAE,YAAY;AACvD,UAAI,CAAC,QAAQ,IAAI,MAAM,EAAG,SAAQ,IAAI,MAAM;AAG5C,aAAO,KAAK,MAAM,GAAG,WAAW;AAAA,IACjC;AAEA,SAAK,UAAU;AACf,SAAK,SAAS,IAAI,UAAU,GAAG,MAAM,GAAG,IAAI,EAAE;AAC9C,SAAK,oBAAoB,QAAQ,qBAAqB,IAAI,qBAAqB,OAAO,OAAO;AAC7F,SAAK,2BAA2B,QAAQ,4BAA4B,IAAI,4BAA4B;AAAA,EACrG;AAGD;AAnD4G;AAArG,IAAe,QAAf","sourcesContent":["import { Piece } from '@sapphire/pieces';\nimport type { Awaitable } from '@sapphire/utilities';\nimport { RouteData } from '../utils/RouteData';\nimport type { ApiRequest } from './api/ApiRequest';\nimport type { ApiResponse } from './api/ApiResponse';\nimport type { MethodName } from './http/HttpMethods';\nimport type { MimeTypeWithoutParameters } from './http/Server';\n\n/**\n * @since 1.0.0\n *\n * @example A simple GET route that returns a JSON response:\n * ```typescript\n * // hello.get.ts\n * import { Route } from '@sapphire/plugin-api';\n *\n * export class MyRoute extends Route {\n *   public run(request: Route.Request, response: Route.Response) {\n *     return response.json({ message: 'Hello, World!' });\n *   }\n * }\n * ```\n *\n * ```bash\n * $ curl http://localhost:4000/hello\n * {\"message\":\"Hello, World!\"}\n * ```\n *\n * @example A simple POST route that reads the body and returns it:\n * ```typescript\n * // echo.post.ts\n * import { Route } from '@sapphire/plugin-api';\n *\n * export class MyRoute extends Route {\n *   public run(request: Route.Request, response: Route.Response) {\n *     return response.json(request.params);\n *   }\n * }\n * ```\n *\n * ```bash\n * $ curl -X POST -H \"Content-Type: application/json\" -d '{\"hello\":\"world\"}' http://localhost:4000/echo\n * {\"hello\":\"world\"}\n * ```\n */\nexport abstract class Route<Options extends Route.Options = Route.Options> extends Piece<Options, 'routes'> {\n\t/**\n\t * (RFC 7230 3.3.2) The maximum decimal number of octets.\n\t */\n\tpublic readonly maximumBodyLength: number;\n\n\t/**\n\t * The accepted content types.\n\t */\n\tpublic readonly acceptedContentMimeTypes: readonly MimeTypeWithoutParameters[] | null;\n\n\t/**\n\t * The route information.\n\t */\n\tpublic readonly router: RouteData;\n\n\t/**\n\t * The methods this route accepts.\n\t */\n\tpublic readonly methods: ReadonlySet<MethodName>;\n\n\tpublic constructor(context: Route.LoaderContext, options: Options = {} as Options) {\n\t\tsuper(context, options);\n\n\t\tconst api = this.container.server.options;\n\t\t// Concat a `/` to the prefix if it does not end with it\n\t\tconst prefix = api.prefix ? (api.prefix.endsWith('/') ? api.prefix : `${api.prefix}/`) : '';\n\t\t// Use the defined route, otherwise:\n\t\t// - If the location is virtual, use the name.\n\t\t// - Otherwise, use the directories and the name.\n\t\tlet path = options.route ?? (this.location.virtual ? this.name : this.location.directories.concat(this.name).join('/'));\n\n\t\tconst methods = new Set(options.methods);\n\t\t// If the path contains a method (e.g. `/users.get`), extract it and add it to the methods set:\n\t\tconst methodIndex = path.lastIndexOf('.');\n\t\tif (methodIndex !== -1) {\n\t\t\t// Extract the method from the path:\n\t\t\tconst method = path.slice(methodIndex + 1).toUpperCase() as MethodName;\n\t\t\tif (!methods.has(method)) methods.add(method);\n\n\t\t\t// Update the path to remove the method:\n\t\t\tpath = path.slice(0, methodIndex);\n\t\t}\n\n\t\tthis.methods = methods;\n\t\tthis.router = new RouteData(`${prefix}${path}`);\n\t\tthis.maximumBodyLength = options.maximumBodyLength ?? api.maximumBodyLength ?? 1024 * 1024 * 50;\n\t\tthis.acceptedContentMimeTypes = options.acceptedContentMimeTypes ?? api.acceptedContentMimeTypes ?? null;\n\t}\n\n\tpublic abstract run(request: Route.Request, response: Route.Response): Awaitable<unknown>;\n}\n\nexport interface RouteOptions extends Piece.Options {\n\t/**\n\t * The route the piece should represent.\n\t * @since 1.0.0\n\t *\n\t * @defaultValue The filesystem-based path, or the name if the location is virtual.\n\t *\n\t * @example\n\t * ```typescript\n\t * '/users'\n\t * // request.params -> {}\n\t * ```\n\t * @example\n\t * ```typescript\n\t * '/guilds/[guild]/members/[member]'\n\t * // request.params -> { guild: '...', member: '...' }\n\t * ```\n\t */\n\troute?: string;\n\n\t/**\n\t * (RFC 7230 3.3.2) The maximum decimal number of octets.\n\t * @since 1.0.0\n\t *\n\t * @defaultValue this.context.server.options.maximumBodyLength ?? 1024 * 1024 * 50\n\t */\n\tmaximumBodyLength?: number;\n\n\t/**\n\t * The accepted content types for this route. If set to null, the route will accept any data.\n\t * @since 1.3.0\n\t *\n\t * @defaultValue this.context.server.options.acceptedContentMimeTypes ?? null\n\t */\n\tacceptedContentMimeTypes?: readonly MimeTypeWithoutParameters[] | null;\n\n\t/**\n\t * The methods this route accepts.\n\t * @since 7.0.0\n\t *\n\t * @defaultValue The method defined in the piece name, or none if not set.\n\t */\n\tmethods?: readonly MethodName[];\n}\n\nexport namespace Route {\n\t/** @deprecated Use {@linkcode LoaderContext} instead. */\n\texport type Context = LoaderContext;\n\texport type LoaderContext = Piece.LoaderContext<'routes'>;\n\texport type Options = RouteOptions;\n\texport type JSON = Piece.JSON;\n\texport type LocationJSON = Piece.LocationJSON;\n\n\texport type Request = ApiRequest;\n\texport type Response = ApiResponse;\n}\n"]}
+{"version":3,"sources":["../../../../src/lib/structures/Route.ts"],"names":[],"mappings":";;;;;;AAAA,SAAS,aAAa;AACtB,SAAS,iBAAiC;AAK1C,SAAS,kBAAkB;AAuCpB,IAAe,SAAf,MAAe,eAA6D,MAAyB;AAAA,EAqBpG,YAAY,SAA8B,UAAmB,CAAC,GAAc;AAClF,UAAM,SAAS,OAAO;AAlBvB;AAAA;AAAA;AAAA,wBAAgB;AAKhB;AAAA;AAAA;AAAA,wBAAgB;AAKhB;AAAA;AAAA;AAAA,wBAAgB;AAKhB;AAAA;AAAA;AAAA,wBAAgB;AAKf,UAAM,MAAM,KAAK,UAAU,OAAO;AAClC,UAAM,OAAQ,CAAC,EAAe;AAAA,MAC7B,WAAW,UAAU,IAAI,MAAM;AAAA,MAC/B,WAAW,UAAU,QAAQ,UAAU,KAAK,SAAS,UAAU,KAAK,OAAO,KAAK,SAAS,YAAY,OAAO,KAAK,IAAI,EAAE,KAAK,GAAG,EAAE;AAAA,IAClI;AAEA,UAAM,UAAU,IAAI,IAAI,QAAQ,OAAO;AACvC,UAAM,UAAU,WAAW,cAAc,IAAI;AAC7C,QAAI,CAAC,UAAU,OAAO,GAAG;AACxB,YAAM,YAAY,KAAK,SAAS;AAChC,WAAK,SAAS,IAAI,KAAK,SAAS,EAAE,MAAM,GAAG,KAAK,SAAS,EAAE,SAAS,QAAQ,SAAS,CAAC;AACtF,cAAQ,IAAI,OAAqB;AAAA,IAClC;AAEA,SAAK,OAAO;AACZ,SAAK,UAAU;AACf,SAAK,oBAAoB,QAAQ,qBAAqB,IAAI,qBAAqB,OAAO,OAAO;AAC7F,SAAK,2BAA2B,QAAQ,4BAA4B,IAAI,4BAA4B;AAAA,EACrG;AAGD;AA7C4G;AAArG,IAAe,QAAf","sourcesContent":["import { Piece } from '@sapphire/pieces';\nimport { isNullish, type Awaitable } from '@sapphire/utilities';\nimport type { ApiRequest } from './api/ApiRequest';\nimport type { ApiResponse } from './api/ApiResponse';\nimport type { MethodName } from './http/HttpMethods';\nimport type { MimeTypeWithoutParameters } from './http/Server';\nimport { RouterRoot } from './router/RouterRoot';\n\n/**\n * @since 1.0.0\n *\n * @example A simple GET route that returns a JSON response:\n * ```typescript\n * // hello.get.ts\n * import { Route } from '@sapphire/plugin-api';\n *\n * export class MyRoute extends Route {\n *   public run(request: Route.Request, response: Route.Response) {\n *     return response.json({ message: 'Hello, World!' });\n *   }\n * }\n * ```\n *\n * ```bash\n * $ curl http://localhost:4000/hello\n * {\"message\":\"Hello, World!\"}\n * ```\n *\n * @example A simple POST route that reads the body and returns it:\n * ```typescript\n * // echo.post.ts\n * import { Route } from '@sapphire/plugin-api';\n *\n * export class MyRoute extends Route {\n *   public run(request: Route.Request, response: Route.Response) {\n *     return response.json(request.params);\n *   }\n * }\n * ```\n *\n * ```bash\n * $ curl -X POST -H \"Content-Type: application/json\" -d '{\"hello\":\"world\"}' http://localhost:4000/echo\n * {\"hello\":\"world\"}\n * ```\n */\nexport abstract class Route<Options extends Route.Options = Route.Options> extends Piece<Options, 'routes'> {\n\t/**\n\t * (RFC 7230 3.3.2) The maximum decimal number of octets.\n\t */\n\tpublic readonly maximumBodyLength: number;\n\n\t/**\n\t * The accepted content types.\n\t */\n\tpublic readonly acceptedContentMimeTypes: readonly MimeTypeWithoutParameters[] | null;\n\n\t/**\n\t * The path this route represents.\n\t */\n\tpublic readonly path: readonly string[];\n\n\t/**\n\t * The methods this route accepts.\n\t */\n\tpublic readonly methods: ReadonlySet<MethodName>;\n\n\tpublic constructor(context: Route.LoaderContext, options: Options = {} as Options) {\n\t\tsuper(context, options);\n\n\t\tconst api = this.container.server.options;\n\t\tconst path = ([] as string[]).concat(\n\t\t\tRouterRoot.normalize(api.prefix),\n\t\t\tRouterRoot.normalize(options.route ?? (this.location.virtual ? this.name : this.location.directories.concat(this.name).join('/')))\n\t\t);\n\n\t\tconst methods = new Set(options.methods);\n\t\tconst implied = RouterRoot.extractMethod(path);\n\t\tif (!isNullish(implied)) {\n\t\t\tconst lastIndex = path.length - 1;\n\t\t\tpath[lastIndex] = path[lastIndex].slice(0, path[lastIndex].length - implied.length - 1);\n\t\t\tmethods.add(implied as MethodName);\n\t\t}\n\n\t\tthis.path = path;\n\t\tthis.methods = methods;\n\t\tthis.maximumBodyLength = options.maximumBodyLength ?? api.maximumBodyLength ?? 1024 * 1024 * 50;\n\t\tthis.acceptedContentMimeTypes = options.acceptedContentMimeTypes ?? api.acceptedContentMimeTypes ?? null;\n\t}\n\n\tpublic abstract run(request: Route.Request, response: Route.Response): Awaitable<unknown>;\n}\n\nexport interface RouteOptions extends Piece.Options {\n\t/**\n\t * The route the piece should represent.\n\t * @since 1.0.0\n\t *\n\t * @defaultValue The filesystem-based path, or the name if the location is virtual.\n\t *\n\t * @example\n\t * ```typescript\n\t * '/users'\n\t * // request.params -> {}\n\t * ```\n\t * @example\n\t * ```typescript\n\t * '/guilds/[guild]/members/[member]'\n\t * // request.params -> { guild: '...', member: '...' }\n\t * ```\n\t */\n\troute?: string;\n\n\t/**\n\t * (RFC 7230 3.3.2) The maximum decimal number of octets.\n\t * @since 1.0.0\n\t *\n\t * @defaultValue this.context.server.options.maximumBodyLength ?? 1024 * 1024 * 50\n\t */\n\tmaximumBodyLength?: number;\n\n\t/**\n\t * The accepted content types for this route. If set to null, the route will accept any data.\n\t * @since 1.3.0\n\t *\n\t * @defaultValue this.context.server.options.acceptedContentMimeTypes ?? null\n\t */\n\tacceptedContentMimeTypes?: readonly MimeTypeWithoutParameters[] | null;\n\n\t/**\n\t * The methods this route accepts.\n\t * @since 7.0.0\n\t *\n\t * @defaultValue The method defined in the piece name, or none if not set.\n\t */\n\tmethods?: readonly MethodName[];\n}\n\nexport namespace Route {\n\t/** @deprecated Use {@linkcode LoaderContext} instead. */\n\texport type Context = LoaderContext;\n\texport type LoaderContext = Piece.LoaderContext<'routes'>;\n\texport type Options = RouteOptions;\n\texport type JSON = Piece.JSON;\n\texport type LocationJSON = Piece.LocationJSON;\n\n\texport type Request = ApiRequest;\n\texport type Response = ApiResponse;\n}\n"]}

package/dist/cjs/lib/structures/RouteLoaderStrategy.cjs

@@ -1,23 +1,15 @@
 'use strict';
 
 var pieces = require('@sapphire/pieces');
-var discord_js = require('discord.js');
 
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 var _RouteLoaderStrategy = class _RouteLoaderStrategy extends pieces.LoaderStrategy {
   onLoad(store, piece) {
-    for (const method of piece.methods) {
-      store.methods.ensure(method, () => new discord_js.Collection()).set(piece, piece.router);
-    }
+    store.router.add(piece);
   }
   onUnload(store, piece) {
-    for (const method of piece.methods) {
-      const methods = store.methods.get(method);
-      if (typeof methods === "undefined") continue;
-      methods.delete(piece);
-      if (methods.size === 0) store.methods.delete(method);
-    }
+    store.router.remove(piece);
   }
 };
 __name(_RouteLoaderStrategy, "RouteLoaderStrategy");

package/dist/cjs/lib/structures/RouteLoaderStrategy.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/structures/RouteLoaderStrategy.ts"],"names":[],"mappings":";;;;AAAA,SAAS,sBAAsB;AAC/B,SAAS,kBAAkB;AAIpB,IAAM,uBAAN,MAAM,6BAA4B,eAAsB;AAAA,EAC9C,OAAO,OAAmB,OAAoB;AAC7D,eAAW,UAAU,MAAM,SAAS;AACnC,YAAM,QAAQ,OAAO,QAAQ,MAAM,IAAI,WAAW,CAAC,EAAE,IAAI,OAAO,MAAM,MAAM;AAAA,IAC7E;AAAA,EACD;AAAA,EAEgB,SAAS,OAAmB,OAAoB;AAC/D,eAAW,UAAU,MAAM,SAAS;AACnC,YAAM,UAAU,MAAM,QAAQ,IAAI,MAAM;AACxC,UAAI,OAAO,YAAY,YAAa;AAEpC,cAAQ,OAAO,KAAK;AACpB,UAAI,QAAQ,SAAS,EAAG,OAAM,QAAQ,OAAO,MAAM;AAAA,IACpD;AAAA,EACD;AACD;AAhB+D;AAAxD,IAAM,sBAAN","sourcesContent":["import { LoaderStrategy } from '@sapphire/pieces';\nimport { Collection } from 'discord.js';\nimport type { Route } from './Route';\nimport type { RouteStore } from './RouteStore';\n\nexport class RouteLoaderStrategy extends LoaderStrategy<Route> {\n\tpublic override onLoad(store: RouteStore, piece: Route): void {\n\t\tfor (const method of piece.methods) {\n\t\t\tstore.methods.ensure(method, () => new Collection()).set(piece, piece.router);\n\t\t}\n\t}\n\n\tpublic override onUnload(store: RouteStore, piece: Route): void {\n\t\tfor (const method of piece.methods) {\n\t\t\tconst methods = store.methods.get(method);\n\t\t\tif (typeof methods === 'undefined') continue;\n\n\t\t\tmethods.delete(piece);\n\t\t\tif (methods.size === 0) store.methods.delete(method);\n\t\t}\n\t}\n}\n"]}
+{"version":3,"sources":["../../../../src/lib/structures/RouteLoaderStrategy.ts"],"names":[],"mappings":";;;;AAAA,SAAS,sBAAsB;AAIxB,IAAM,uBAAN,MAAM,6BAA4B,eAAsB;AAAA,EAC9C,OAAO,OAAmB,OAAoB;AAC7D,UAAM,OAAO,IAAI,KAAK;AAAA,EACvB;AAAA,EAEgB,SAAS,OAAmB,OAAoB;AAC/D,UAAM,OAAO,OAAO,KAAK;AAAA,EAC1B;AACD;AAR+D;AAAxD,IAAM,sBAAN","sourcesContent":["import { LoaderStrategy } from '@sapphire/pieces';\nimport type { Route } from './Route';\nimport type { RouteStore } from './RouteStore';\n\nexport class RouteLoaderStrategy extends LoaderStrategy<Route> {\n\tpublic override onLoad(store: RouteStore, piece: Route): void {\n\t\tstore.router.add(piece);\n\t}\n\n\tpublic override onUnload(store: RouteStore, piece: Route): void {\n\t\tstore.router.remove(piece);\n\t}\n}\n"]}