@tahminator/sapling 1.5.4 → 1.5.5

package/package.json

@@ -1,13 +1,23 @@
 {
   "name": "@tahminator/sapling",
-  "version": "1.5.4",
+  "version": "1.5.5",
   "author": "Tahmid Ahmed",
   "description": "A library to help you write cleaner Express.js code",
   "repository": {
     "url": "git+https://github.com/tahminator/sapling.git"
   },
   "scripts": {
-    "test": "pnpm run build",
+    "test": "pnpm run typecheck && pnpm run lint && pnpm run fmt && pnpm run vt && pnpm run build",
+    "vt": "vitest run",
+    "fmt": "pnpm run prettier",
+    "fmt:fix": "pnpm run prettier:fix",
+    "lint": "pnpm run eslint",
+    "lint:fix": "pnpm run eslint:fix",
+    "eslint": "eslint .",
+    "eslint:fix": "eslint . --fix",
+    "prettier": "NODE_OPTIONS=\"--experimental-strip-types\" prettier --check .",
+    "prettier:fix": "NODE_OPTIONS=\"--experimental-strip-types\" prettier --write .",
+    "typecheck": "tsc -b --noEmit",
     "build": "rm -rf dist && tsc"
   },
   "main": "./dist/index.js",
@@ -29,5 +39,20 @@
   "dependencies": {
     "@types/express": "^5.0.6",
     "express": "^5.2.1"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/supertest": "^7.2.0",
+    "@vitest/coverage-istanbul": "^4.1.2",
+    "eslint": "^10.1.0",
+    "eslint-plugin-perfectionist": "^5.7.0",
+    "globals": "^17.4.0",
+    "jiti": "^2.6.1",
+    "jsdom": "^29.0.1",
+    "prettier": "^3.8.1",
+    "supertest": "^7.2.2",
+    "typescript-eslint": "^8.57.2",
+    "vite-tsconfig-paths": "^6.1.1",
+    "vitest": "^4.1.2"
   }
 }

package/dist/index.d.ts

@@ -1 +0,0 @@
-export * from "./src";

package/dist/index.js

@@ -1 +0,0 @@
-export * from "./src";

package/dist/lib/weakmap.d.ts

@@ -1,15 +0,0 @@
-/**
- * WeakMap that is iterable.
- */
-export declare class IterableWeakMap<K extends object, V> {
-    #private;
-    constructor(iterable?: Iterable<[K, V]>);
-    set(key: K, value: V): this;
-    get(key: K): V | undefined;
-    delete(key: K): boolean;
-    [Symbol.iterator](): IterableIterator<[K, V]>;
-    entries(): IterableIterator<[K, V]>;
-    keys(): IterableIterator<K>;
-    values(): IterableIterator<V>;
-    forEach(callback: (value: V, key: K, map: this) => void, thisArg?: any): void;
-}

package/dist/lib/weakmap.js

@@ -1,77 +0,0 @@
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var _a, _IterableWeakMap_weakMap, _IterableWeakMap_refSet, _IterableWeakMap_finalizationGroup, _IterableWeakMap_cleanup;
-/**
- * WeakMap that is iterable.
- */
-export class IterableWeakMap {
-    constructor(iterable) {
-        _IterableWeakMap_weakMap.set(this, new WeakMap());
-        _IterableWeakMap_refSet.set(this, new Set());
-        _IterableWeakMap_finalizationGroup.set(this, new FinalizationRegistry(__classPrivateFieldGet(_a, _a, "m", _IterableWeakMap_cleanup)));
-        if (iterable) {
-            for (const [key, value] of iterable) {
-                this.set(key, value);
-            }
-        }
-    }
-    set(key, value) {
-        const ref = new WeakRef(key);
-        __classPrivateFieldGet(this, _IterableWeakMap_weakMap, "f").set(key, { value, ref });
-        __classPrivateFieldGet(this, _IterableWeakMap_refSet, "f").add(ref);
-        __classPrivateFieldGet(this, _IterableWeakMap_finalizationGroup, "f").register(key, {
-            set: __classPrivateFieldGet(this, _IterableWeakMap_refSet, "f"),
-            ref,
-        }, ref);
-        return this;
-    }
-    get(key) {
-        const entry = __classPrivateFieldGet(this, _IterableWeakMap_weakMap, "f").get(key);
-        return entry === null || entry === void 0 ? void 0 : entry.value;
-    }
-    delete(key) {
-        const entry = __classPrivateFieldGet(this, _IterableWeakMap_weakMap, "f").get(key);
-        if (!entry) {
-            return false;
-        }
-        __classPrivateFieldGet(this, _IterableWeakMap_weakMap, "f").delete(key);
-        __classPrivateFieldGet(this, _IterableWeakMap_refSet, "f").delete(entry.ref);
-        __classPrivateFieldGet(this, _IterableWeakMap_finalizationGroup, "f").unregister(entry.ref);
-        return true;
-    }
-    *[(_IterableWeakMap_weakMap = new WeakMap(), _IterableWeakMap_refSet = new WeakMap(), _IterableWeakMap_finalizationGroup = new WeakMap(), _IterableWeakMap_cleanup = function _IterableWeakMap_cleanup(heldValue) {
-        heldValue.set.delete(heldValue.ref);
-    }, Symbol.iterator)]() {
-        for (const ref of __classPrivateFieldGet(this, _IterableWeakMap_refSet, "f")) {
-            const key = ref.deref();
-            if (!key)
-                continue;
-            const entry = __classPrivateFieldGet(this, _IterableWeakMap_weakMap, "f").get(key);
-            if (entry) {
-                yield [key, entry.value];
-            }
-        }
-    }
-    entries() {
-        return this[Symbol.iterator]();
-    }
-    *keys() {
-        for (const [key] of this) {
-            yield key;
-        }
-    }
-    *values() {
-        for (const [, value] of this) {
-            yield value;
-        }
-    }
-    forEach(callback, thisArg) {
-        for (const [key, value] of this) {
-            callback.call(thisArg, value, key, this);
-        }
-    }
-}
-_a = IterableWeakMap;

package/dist/src/annotation/controller.d.ts

@@ -1,21 +0,0 @@
-import { Router } from "express";
-import { Class } from "../types";
-export declare const _ControllerRegistry: WeakMap<Function, Router>;
-type ControllerProps = {
-    /**
-     * Optional URL prefix applied to all routes in the controller. Defaults to "".
-     */
-    prefix?: string;
-    /**
-     * Optional array of dependencies to be injected into the constructor that are `@Injectable`
-     */
-    deps?: Array<Class<any>>;
-} | undefined;
-/**
- * Registers a class as an HTTP controller and registers its routes.
- *
- * @param [prefix] Optional URL prefix applied to all routes in the controller. Defaults to "".
- * @param [deps] Optional array of dependencies to be injected into the constructor that are `@Injectable`
- */
-export declare function Controller({ prefix, deps }?: ControllerProps): ClassDecorator;
-export {};

package/dist/src/annotation/controller.js

@@ -1,79 +0,0 @@
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-import { Router } from "express";
-import { _InjectableDeps, _resolve } from "./injectable";
-import { methodResolve } from "../types";
-import { _getRoutes } from "./route";
-import { Sapling } from "../helper/sapling";
-import { Html404ErrorPage } from "../html/404";
-import { ResponseEntity, RedirectView } from "../helper";
-export const _ControllerRegistry = new WeakMap();
-/**
- * Registers a class as an HTTP controller and registers its routes.
- *
- * @param [prefix] Optional URL prefix applied to all routes in the controller. Defaults to "".
- * @param [deps] Optional array of dependencies to be injected into the constructor that are `@Injectable`
- */
-export function Controller({ prefix = "", deps = [] } = {
-    prefix: "",
-    deps: [],
-}) {
-    return (target) => {
-        const targetClass = target;
-        const router = Router();
-        const routes = _getRoutes(target);
-        const usedRoutes = new Set();
-        _InjectableDeps.set(targetClass, deps);
-        const controllerInstance = _resolve(targetClass);
-        for (const { method, path, fnName } of routes) {
-            const fn = controllerInstance[fnName];
-            if (typeof fn !== "function")
-                continue;
-            // When path is a RegExp, use it directly without prefix
-            // When path is a string, prepend the prefix
-            const fp = path instanceof RegExp ? path : prefix + path;
-            const routeKey = method + " " + (path instanceof RegExp ? path.source : fp);
-            // Only check for duplicates on non-middleware routes
-            // Middleware (USE) can have duplicate paths, and different HTTP methods can share paths
-            if (method !== "USE" && usedRoutes.has(routeKey)) {
-                throw new Error(`Duplicate route [${method}] "${path instanceof RegExp ? path.source : fp}" detected in controller "${target.name}"`);
-            }
-            if (method !== "USE") {
-                usedRoutes.add(routeKey);
-            }
-            const methodName = methodResolve[method];
-            router[methodName](fp, (request, response, next) => __awaiter(this, void 0, void 0, function* () {
-                const result = yield fn.bind(controllerInstance)(request, response, next);
-                // Middleware (USE) should not send responses, just call next()
-                if (method === "USE") {
-                    return;
-                }
-                if (result instanceof ResponseEntity) {
-                    response
-                        .contentType("application/json")
-                        .status(result.getStatusCode())
-                        .set(result.getHeaders())
-                        .send(Sapling.serialize(result.getBody()));
-                    return;
-                }
-                if (result instanceof RedirectView) {
-                    response.redirect(result.getUrl());
-                    return;
-                }
-                if (!response.writableEnded) {
-                    response
-                        .status(404)
-                        .send(Html404ErrorPage(`Cannot ${methodName.toUpperCase()} ${path instanceof RegExp ? path.source : fp}`));
-                }
-            }));
-        }
-        _ControllerRegistry.set(targetClass, router);
-    };
-}

package/dist/src/annotation/index.d.ts

@@ -1,4 +0,0 @@
-export * from "./controller";
-export * from "./injectable";
-export * from "./route";
-export * from "./middleware";

package/dist/src/annotation/index.js

@@ -1,4 +0,0 @@
-export * from "./controller";
-export * from "./injectable";
-export * from "./route";
-export * from "./middleware";

package/dist/src/annotation/injectable.d.ts

@@ -1,25 +0,0 @@
-import { IterableWeakMap } from "../../lib/weakmap";
-import { Class } from "../types";
-export declare const _InjectableRegistry: WeakMap<Class<any>, any>;
-export declare const _InjectableDeps: IterableWeakMap<Class<any>, Class<any>[]>;
-/**
- * Mark the class as an injectable to be handled by Sapling. The class can now be
- * be injected into other classes, as well as allow the class to inject other `@Injectable` classes.
- *
- * @argument deps - An optional array to define any dependencies that this class may require.
- */
-export declare function Injectable(deps?: Array<Class<any>>): ClassDecorator;
-/**
- * Resolves and instantiates a class along with all of it's transitive dependencies.
- *
- * Uses topological sort (Kahn's algorithm) to ensure that the dependency graph is created
- * in a correct order.
- *
- * When `resolve` is first called (usually during controller registration),
- * it will compute the dependency graph of all `@Injectable` classes and instantiates
- * them in the correct order.
- *
- * Subsequent calls to dependencies that have already been resolved are cached, so they will
- * re-use the created singletons instead of re-instantiation.
- */
-export declare function _resolve<T>(ctor: Class<T>): T;

package/dist/src/annotation/injectable.js

@@ -1,66 +0,0 @@
-import { IterableWeakMap } from "../../lib/weakmap";
-export const _InjectableRegistry = new WeakMap();
-export const _InjectableDeps = new IterableWeakMap();
-/**
- * Mark the class as an injectable to be handled by Sapling. The class can now be
- * be injected into other classes, as well as allow the class to inject other `@Injectable` classes.
- *
- * @argument deps - An optional array to define any dependencies that this class may require.
- */
-export function Injectable(deps = []) {
-    return function (target) {
-        _InjectableRegistry.set(target, null);
-        _InjectableDeps.set(target, deps);
-    };
-}
-/**
- * Resolves and instantiates a class along with all of it's transitive dependencies.
- *
- * Uses topological sort (Kahn's algorithm) to ensure that the dependency graph is created
- * in a correct order.
- *
- * When `resolve` is first called (usually during controller registration),
- * it will compute the dependency graph of all `@Injectable` classes and instantiates
- * them in the correct order.
- *
- * Subsequent calls to dependencies that have already been resolved are cached, so they will
- * re-use the created singletons instead of re-instantiation.
- */
-export function _resolve(ctor) {
-    const inDegree = new Map();
-    const graph = new Map();
-    _InjectableDeps.forEach((deps, node) => {
-        inDegree.set(node, inDegree.get(node) || 0);
-        deps.forEach((dep) => {
-            inDegree.set(dep, inDegree.get(dep) || 0);
-            inDegree.set(node, inDegree.get(node) + 1);
-            if (!graph.has(dep))
-                graph.set(dep, []);
-            graph.get(dep).push(node);
-        });
-    });
-    const queue = [];
-    inDegree.forEach((deg, node) => {
-        if (deg === 0)
-            queue.push(node);
-    });
-    while (queue.length) {
-        const current = queue.shift();
-        if (!_InjectableRegistry.get(current)) {
-            const deps = _InjectableDeps.get(current) || [];
-            const params = deps.map((dep) => _InjectableRegistry.get(dep));
-            const instance = new current(...params);
-            _InjectableRegistry.set(current, instance);
-        }
-        (graph.get(current) || []).forEach((neighbor) => {
-            var _a;
-            inDegree.set(neighbor, ((_a = inDegree.get(neighbor)) !== null && _a !== void 0 ? _a : 0) - 1);
-            if (inDegree.get(neighbor) === 0)
-                queue.push(neighbor);
-        });
-    }
-    if (!_InjectableRegistry.get(ctor)) {
-        throw new Error("Circular dependency detected or injectable not registered");
-    }
-    return _InjectableRegistry.get(ctor);
-}

package/dist/src/annotation/middleware.d.ts

@@ -1,9 +0,0 @@
-import { Controller } from "./controller";
-/**
- * Used to define a middleware-only class.
- *
- * __NOTE:__ `@MiddlewareClass` works exactly the same as `@Controller`. As such, you
- * can still register `@Route` and `@Middleware` methods, though you very well should not
- * for the sake of semantics.
- */
-export declare function MiddlewareClass(...args: Parameters<typeof Controller>): ClassDecorator;

package/dist/src/annotation/middleware.js

@@ -1,11 +0,0 @@
-import { Controller } from "./controller";
-/**
- * Used to define a middleware-only class.
- *
- * __NOTE:__ `@MiddlewareClass` works exactly the same as `@Controller`. As such, you
- * can still register `@Route` and `@Middleware` methods, though you very well should not
- * for the sake of semantics.
- */
-export function MiddlewareClass(...args) {
-    return Controller(...args);
-}

package/dist/src/annotation/route.d.ts

@@ -1,45 +0,0 @@
-import { RouteDefinition, ExpressRouterMethodKey } from "../types";
-/**
- * Custom annotation that will store all routes inside of a map,
- * which can then be used to initialize all the routes to the router.
- */
-export declare function _Route({ method, path, }: {
-    method: ExpressRouterMethodKey;
-    path: string | RegExp | undefined;
-}): MethodDecorator;
-/**
- * Register GET route on the given path (default "") for the given controller.
- */
-export declare const GET: (path?: string | RegExp | undefined) => MethodDecorator;
-/**
- * Register POST route on the given path (default "") for the given controller.
- */
-export declare const POST: (path?: string | RegExp | undefined) => MethodDecorator;
-/**
- * Register PUT route on the given path (default "") for the given controller.
- */
-export declare const PUT: (path?: string | RegExp | undefined) => MethodDecorator;
-/**
- * Register DELETE route on the given path (default "") for the given controller.
- */
-export declare const DELETE: (path?: string | RegExp | undefined) => MethodDecorator;
-/**
- * Register OPTIONS route on the given path (default "") for the given controller.
- */
-export declare const OPTIONS: (path?: string | RegExp | undefined) => MethodDecorator;
-/**
- * Register PATCH route on the given path (default "") for the given controller.
- */
-export declare const PATCH: (path?: string | RegExp | undefined) => MethodDecorator;
-/**
- * Register HEAD route on the given path (default "") for the given controller.
- */
-export declare const HEAD: (path?: string | RegExp | undefined) => MethodDecorator;
-/**
- * Register a middleware route on the given path (default "") for the given controller.
- */
-export declare const Middleware: (path?: string | RegExp | undefined) => MethodDecorator;
-/**
- * Given a class constructor, fetch all the routes attached.
- */
-export declare function _getRoutes(ctor: Function): readonly RouteDefinition[];

package/dist/src/annotation/route.js

@@ -1,77 +0,0 @@
-const _routeStore = new WeakMap();
-/**
- * Custom annotation that will store all routes inside of a map,
- * which can then be used to initialize all the routes to the router.
- */
-export function _Route({ method, path = "", }) {
-    return (target, propertyKey) => {
-        var _a;
-        const ctor = target.constructor;
-        const list = (_a = _routeStore.get(ctor)) !== null && _a !== void 0 ? _a : [];
-        list.push({ method, path: path !== null && path !== void 0 ? path : "", fnName: String(propertyKey) });
-        _routeStore.set(ctor, list);
-    };
-}
-/**
- * Register GET route on the given path (default "") for the given controller.
- */
-export const GET = (path = "") => _Route({
-    method: "GET",
-    path,
-});
-/**
- * Register POST route on the given path (default "") for the given controller.
- */
-export const POST = (path = "") => _Route({
-    method: "POST",
-    path,
-});
-/**
- * Register PUT route on the given path (default "") for the given controller.
- */
-export const PUT = (path = "") => _Route({
-    method: "PUT",
-    path,
-});
-/**
- * Register DELETE route on the given path (default "") for the given controller.
- */
-export const DELETE = (path = "") => _Route({
-    method: "DELETE",
-    path,
-});
-/**
- * Register OPTIONS route on the given path (default "") for the given controller.
- */
-export const OPTIONS = (path = "") => _Route({
-    method: "OPTIONS",
-    path,
-});
-/**
- * Register PATCH route on the given path (default "") for the given controller.
- */
-export const PATCH = (path = "") => _Route({
-    method: "PATCH",
-    path,
-});
-/**
- * Register HEAD route on the given path (default "") for the given controller.
- */
-export const HEAD = (path = "") => _Route({
-    method: "HEAD",
-    path,
-});
-/**
- * Register a middleware route on the given path (default "") for the given controller.
- */
-export const Middleware = (path = "") => _Route({
-    method: "USE",
-    path,
-});
-/**
- * Given a class constructor, fetch all the routes attached.
- */
-export function _getRoutes(ctor) {
-    var _a;
-    return (_a = _routeStore.get(ctor)) !== null && _a !== void 0 ? _a : [];
-}

package/dist/src/enum/http.d.ts

@@ -1,68 +0,0 @@
-/**
- * Enum of every valid HTTP status code mapped to a specific enum member.
- *
- * @see {@link ResponseEntity}
- */
-export declare enum HttpStatus {
-    CONTINUE = 100,
-    SWITCHING_PROTOCOLS = 101,
-    PROCESSING = 102,
-    EARLY_HINTS = 103,
-    OK = 200,
-    CREATED = 201,
-    ACCEPTED = 202,
-    NON_AUTHORITATIVE_INFORMATION = 203,
-    NO_CONTENT = 204,
-    RESET_CONTENT = 205,
-    PARTIAL_CONTENT = 206,
-    MULTI_STATUS = 207,
-    ALREADY_REPORTED = 208,
-    IM_USED = 226,
-    MULTIPLE_CHOICES = 300,
-    MOVED_PERMANENTLY = 301,
-    FOUND = 302,
-    SEE_OTHER = 303,
-    NOT_MODIFIED = 304,
-    TEMPORARY_REDIRECT = 307,
-    PERMANENT_REDIRECT = 308,
-    BAD_REQUEST = 400,
-    UNAUTHORIZED = 401,
-    PAYMENT_REQUIRED = 402,
-    FORBIDDEN = 403,
-    NOT_FOUND = 404,
-    METHOD_NOT_ALLOWED = 405,
-    NOT_ACCEPTABLE = 406,
-    PROXY_AUTHENTICATION_REQUIRED = 407,
-    REQUEST_TIMEOUT = 408,
-    CONFLICT = 409,
-    GONE = 410,
-    LENGTH_REQUIRED = 411,
-    PRECONDITION_FAILED = 412,
-    PAYLOAD_TOO_LARGE = 413,
-    URI_TOO_LONG = 414,
-    UNSUPPORTED_MEDIA_TYPE = 415,
-    REQUESTED_RANGE_NOT_SATISFIABLE = 416,
-    EXPECTATION_FAILED = 417,
-    I_AM_A_TEAPOT = 418,
-    UNPROCESSABLE_ENTITY = 422,
-    LOCKED = 423,
-    FAILED_DEPENDENCY = 424,
-    TOO_EARLY = 425,
-    UPGRADE_REQUIRED = 426,
-    PRECONDITION_REQUIRED = 428,
-    TOO_MANY_REQUESTS = 429,
-    REQUEST_HEADER_FIELDS_TOO_LARGE = 431,
-    UNAVAILABLE_FOR_LEGAL_REASONS = 451,
-    INTERNAL_SERVER_ERROR = 500,
-    NOT_IMPLEMENTED = 501,
-    BAD_GATEWAY = 502,
-    SERVICE_UNAVAILABLE = 503,
-    GATEWAY_TIMEOUT = 504,
-    HTTP_VERSION_NOT_SUPPORTED = 505,
-    VARIANT_ALSO_NEGOTIATES = 506,
-    INSUFFICIENT_STORAGE = 507,
-    LOOP_DETECTED = 508,
-    BANDWIDTH_LIMIT_EXCEEDED = 509,
-    NOT_EXTENDED = 510,
-    NETWORK_AUTHENTICATION_REQUIRED = 511
-}

package/dist/src/enum/http.js

@@ -1,69 +0,0 @@
-/**
- * Enum of every valid HTTP status code mapped to a specific enum member.
- *
- * @see {@link ResponseEntity}
- */
-export var HttpStatus;
-(function (HttpStatus) {
-    HttpStatus[HttpStatus["CONTINUE"] = 100] = "CONTINUE";
-    HttpStatus[HttpStatus["SWITCHING_PROTOCOLS"] = 101] = "SWITCHING_PROTOCOLS";
-    HttpStatus[HttpStatus["PROCESSING"] = 102] = "PROCESSING";
-    HttpStatus[HttpStatus["EARLY_HINTS"] = 103] = "EARLY_HINTS";
-    HttpStatus[HttpStatus["OK"] = 200] = "OK";
-    HttpStatus[HttpStatus["CREATED"] = 201] = "CREATED";
-    HttpStatus[HttpStatus["ACCEPTED"] = 202] = "ACCEPTED";
-    HttpStatus[HttpStatus["NON_AUTHORITATIVE_INFORMATION"] = 203] = "NON_AUTHORITATIVE_INFORMATION";
-    HttpStatus[HttpStatus["NO_CONTENT"] = 204] = "NO_CONTENT";
-    HttpStatus[HttpStatus["RESET_CONTENT"] = 205] = "RESET_CONTENT";
-    HttpStatus[HttpStatus["PARTIAL_CONTENT"] = 206] = "PARTIAL_CONTENT";
-    HttpStatus[HttpStatus["MULTI_STATUS"] = 207] = "MULTI_STATUS";
-    HttpStatus[HttpStatus["ALREADY_REPORTED"] = 208] = "ALREADY_REPORTED";
-    HttpStatus[HttpStatus["IM_USED"] = 226] = "IM_USED";
-    HttpStatus[HttpStatus["MULTIPLE_CHOICES"] = 300] = "MULTIPLE_CHOICES";
-    HttpStatus[HttpStatus["MOVED_PERMANENTLY"] = 301] = "MOVED_PERMANENTLY";
-    HttpStatus[HttpStatus["FOUND"] = 302] = "FOUND";
-    HttpStatus[HttpStatus["SEE_OTHER"] = 303] = "SEE_OTHER";
-    HttpStatus[HttpStatus["NOT_MODIFIED"] = 304] = "NOT_MODIFIED";
-    HttpStatus[HttpStatus["TEMPORARY_REDIRECT"] = 307] = "TEMPORARY_REDIRECT";
-    HttpStatus[HttpStatus["PERMANENT_REDIRECT"] = 308] = "PERMANENT_REDIRECT";
-    HttpStatus[HttpStatus["BAD_REQUEST"] = 400] = "BAD_REQUEST";
-    HttpStatus[HttpStatus["UNAUTHORIZED"] = 401] = "UNAUTHORIZED";
-    HttpStatus[HttpStatus["PAYMENT_REQUIRED"] = 402] = "PAYMENT_REQUIRED";
-    HttpStatus[HttpStatus["FORBIDDEN"] = 403] = "FORBIDDEN";
-    HttpStatus[HttpStatus["NOT_FOUND"] = 404] = "NOT_FOUND";
-    HttpStatus[HttpStatus["METHOD_NOT_ALLOWED"] = 405] = "METHOD_NOT_ALLOWED";
-    HttpStatus[HttpStatus["NOT_ACCEPTABLE"] = 406] = "NOT_ACCEPTABLE";
-    HttpStatus[HttpStatus["PROXY_AUTHENTICATION_REQUIRED"] = 407] = "PROXY_AUTHENTICATION_REQUIRED";
-    HttpStatus[HttpStatus["REQUEST_TIMEOUT"] = 408] = "REQUEST_TIMEOUT";
-    HttpStatus[HttpStatus["CONFLICT"] = 409] = "CONFLICT";
-    HttpStatus[HttpStatus["GONE"] = 410] = "GONE";
-    HttpStatus[HttpStatus["LENGTH_REQUIRED"] = 411] = "LENGTH_REQUIRED";
-    HttpStatus[HttpStatus["PRECONDITION_FAILED"] = 412] = "PRECONDITION_FAILED";
-    HttpStatus[HttpStatus["PAYLOAD_TOO_LARGE"] = 413] = "PAYLOAD_TOO_LARGE";
-    HttpStatus[HttpStatus["URI_TOO_LONG"] = 414] = "URI_TOO_LONG";
-    HttpStatus[HttpStatus["UNSUPPORTED_MEDIA_TYPE"] = 415] = "UNSUPPORTED_MEDIA_TYPE";
-    HttpStatus[HttpStatus["REQUESTED_RANGE_NOT_SATISFIABLE"] = 416] = "REQUESTED_RANGE_NOT_SATISFIABLE";
-    HttpStatus[HttpStatus["EXPECTATION_FAILED"] = 417] = "EXPECTATION_FAILED";
-    HttpStatus[HttpStatus["I_AM_A_TEAPOT"] = 418] = "I_AM_A_TEAPOT";
-    HttpStatus[HttpStatus["UNPROCESSABLE_ENTITY"] = 422] = "UNPROCESSABLE_ENTITY";
-    HttpStatus[HttpStatus["LOCKED"] = 423] = "LOCKED";
-    HttpStatus[HttpStatus["FAILED_DEPENDENCY"] = 424] = "FAILED_DEPENDENCY";
-    HttpStatus[HttpStatus["TOO_EARLY"] = 425] = "TOO_EARLY";
-    HttpStatus[HttpStatus["UPGRADE_REQUIRED"] = 426] = "UPGRADE_REQUIRED";
-    HttpStatus[HttpStatus["PRECONDITION_REQUIRED"] = 428] = "PRECONDITION_REQUIRED";
-    HttpStatus[HttpStatus["TOO_MANY_REQUESTS"] = 429] = "TOO_MANY_REQUESTS";
-    HttpStatus[HttpStatus["REQUEST_HEADER_FIELDS_TOO_LARGE"] = 431] = "REQUEST_HEADER_FIELDS_TOO_LARGE";
-    HttpStatus[HttpStatus["UNAVAILABLE_FOR_LEGAL_REASONS"] = 451] = "UNAVAILABLE_FOR_LEGAL_REASONS";
-    HttpStatus[HttpStatus["INTERNAL_SERVER_ERROR"] = 500] = "INTERNAL_SERVER_ERROR";
-    HttpStatus[HttpStatus["NOT_IMPLEMENTED"] = 501] = "NOT_IMPLEMENTED";
-    HttpStatus[HttpStatus["BAD_GATEWAY"] = 502] = "BAD_GATEWAY";
-    HttpStatus[HttpStatus["SERVICE_UNAVAILABLE"] = 503] = "SERVICE_UNAVAILABLE";
-    HttpStatus[HttpStatus["GATEWAY_TIMEOUT"] = 504] = "GATEWAY_TIMEOUT";
-    HttpStatus[HttpStatus["HTTP_VERSION_NOT_SUPPORTED"] = 505] = "HTTP_VERSION_NOT_SUPPORTED";
-    HttpStatus[HttpStatus["VARIANT_ALSO_NEGOTIATES"] = 506] = "VARIANT_ALSO_NEGOTIATES";
-    HttpStatus[HttpStatus["INSUFFICIENT_STORAGE"] = 507] = "INSUFFICIENT_STORAGE";
-    HttpStatus[HttpStatus["LOOP_DETECTED"] = 508] = "LOOP_DETECTED";
-    HttpStatus[HttpStatus["BANDWIDTH_LIMIT_EXCEEDED"] = 509] = "BANDWIDTH_LIMIT_EXCEEDED";
-    HttpStatus[HttpStatus["NOT_EXTENDED"] = 510] = "NOT_EXTENDED";
-    HttpStatus[HttpStatus["NETWORK_AUTHENTICATION_REQUIRED"] = 511] = "NETWORK_AUTHENTICATION_REQUIRED";
-})(HttpStatus || (HttpStatus = {}));

package/dist/src/enum/index.d.ts

@@ -1 +0,0 @@
-export * from "./http";

package/dist/src/enum/index.js

@@ -1 +0,0 @@
-export * from "./http";

package/dist/src/helper/error.d.ts

@@ -1,10 +0,0 @@
-import { HttpStatus } from "../enum";
-/**
- * Ensure that you define a middleware that can handle this error.
- *
- * @see {@link Sapling.loadResponseStatusErrorMiddleware}
- */
-export declare class ResponseStatusError extends Error {
-    readonly status: HttpStatus;
-    constructor(status: HttpStatus, message?: string);
-}

package/dist/src/helper/error.js

@@ -1,17 +0,0 @@
-import { HttpStatus } from "../enum";
-/**
- * Ensure that you define a middleware that can handle this error.
- *
- * @see {@link Sapling.loadResponseStatusErrorMiddleware}
- */
-export class ResponseStatusError extends Error {
-    constructor(status, message) {
-        super(message !== null && message !== void 0 ? message : "Something went wrong.");
-        this.status = status;
-        Object.setPrototypeOf(this, new.target.prototype);
-        this.name = `HttpError(${HttpStatus[status]})`;
-        if (Error.captureStackTrace) {
-            Error.captureStackTrace(this, ResponseStatusError);
-        }
-    }
-}

package/dist/src/helper/importer.d.ts

@@ -1 +0,0 @@
-export declare const getControllers: () => any;

package/dist/src/helper/importer.js

@@ -1,5 +0,0 @@
-// @ts-expect-error
-import * as controllers from "**/*.controller.ts";
-export const getControllers = () => {
-    return controllers;
-};

package/dist/src/helper/index.d.ts

@@ -1,4 +0,0 @@
-export * from "./redirect";
-export * from "./response";
-export * from "./error";
-export * from "./sapling";

package/dist/src/helper/index.js

@@ -1,4 +0,0 @@
-export * from "./redirect";
-export * from "./response";
-export * from "./error";
-export * from "./sapling";

package/dist/src/helper/redirect.d.ts

@@ -1,14 +0,0 @@
-/**
- * Generic HTTP redirect wrapped modeled after Spring's `RedirectView`.
- *
- * You can either return `new RedirectView(url)` or `RedirectView.redirect(url)` inside of a controller method.
- */
-export declare class RedirectView {
-    _url: string;
-    constructor(url: string);
-    getUrl(): string;
-    /**
-     * Instantiate `RedirectView` with the given `url`.
-     */
-    static redirect(url: string): RedirectView;
-}

package/dist/src/helper/redirect.js

@@ -1,19 +0,0 @@
-/**
- * Generic HTTP redirect wrapped modeled after Spring's `RedirectView`.
- *
- * You can either return `new RedirectView(url)` or `RedirectView.redirect(url)` inside of a controller method.
- */
-export class RedirectView {
-    constructor(url) {
-        this._url = url;
-    }
-    getUrl() {
-        return this._url;
-    }
-    /**
-     * Instantiate `RedirectView` with the given `url`.
-     */
-    static redirect(url) {
-        return new RedirectView(url);
-    }
-}

package/dist/src/helper/response.d.ts

@@ -1,68 +0,0 @@
-import { HttpHeaders } from "../types";
-/**
- * Generic HTTP response wrapper modeled after Spring's `ResponseEntity`.
- *
- * Provides status code, headers, and an optional typed body.
- * The body is serialized through `Spring.serialize`.
- *
- * @typeParam T - the type of the response body
- */
-export declare class ResponseEntity<T> {
-    private _statusCode;
-    private _headers;
-    private _body;
-    constructor(body: T, headers?: HttpHeaders, statusCode?: number);
-    /**
-     * Create a builder with a 200 status code.
-     *
-     * @example```ts
-     * return ResponseEntity.ok().body({ success: true });
-     * ```
-     */
-    static ok(): ResponseEntityBuilder;
-    /**
-     * Create a builder with a custom status code.
-     *
-     * @example```ts
-     * return ResponseEntity.status(HttpStatus.BAD_REQUEST).body({ success: false });
-     * ```
-     *
-     * @see {@link HttpStatus}
-     */
-    static status(statusCode: number): ResponseEntityBuilder;
-    /**
-     * Return status code.
-     */
-    getStatusCode(): number;
-    /**
-     * Return headers.
-     */
-    getHeaders(): HttpHeaders;
-    /**
-     * Return the response body.
-     */
-    getBody(): T;
-}
-/**
- * Builder for {@link ResponseEntity}.
- *
- * Forces the status code to be set first, then headers and body,
- * ensuring type safety when constructing the response.
- */
-export declare class ResponseEntityBuilder {
-    private _statusCode;
-    private _headers;
-    constructor(statusCode: number);
-    /**
-     * Set all headers as an object with keys and values.
-     */
-    headers(headers: HttpHeaders): this;
-    /**
-     * Add/override a single key and value to the headers.
-     */
-    setHeader(key: string, value: string): this;
-    /**
-     * Set the response body.
-     */
-    body<T>(body: T): ResponseEntity<T>;
-}

package/dist/src/helper/response.js

@@ -1,88 +0,0 @@
-/**
- * Generic HTTP response wrapper modeled after Spring's `ResponseEntity`.
- *
- * Provides status code, headers, and an optional typed body.
- * The body is serialized through `Spring.serialize`.
- *
- * @typeParam T - the type of the response body
- */
-export class ResponseEntity {
-    constructor(body, headers = {}, statusCode = 200) {
-        this._headers = {};
-        this._body = body;
-        this._headers = headers;
-        this._statusCode = statusCode;
-    }
-    /**
-     * Create a builder with a 200 status code.
-     *
-     * @example```ts
-     * return ResponseEntity.ok().body({ success: true });
-     * ```
-     */
-    static ok() {
-        return new ResponseEntityBuilder(200);
-    }
-    /**
-     * Create a builder with a custom status code.
-     *
-     * @example```ts
-     * return ResponseEntity.status(HttpStatus.BAD_REQUEST).body({ success: false });
-     * ```
-     *
-     * @see {@link HttpStatus}
-     */
-    static status(statusCode) {
-        return new ResponseEntityBuilder(statusCode);
-    }
-    /**
-     * Return status code.
-     */
-    getStatusCode() {
-        return this._statusCode;
-    }
-    /**
-     * Return headers.
-     */
-    getHeaders() {
-        return this._headers;
-    }
-    /**
-     * Return the response body.
-     */
-    getBody() {
-        return this._body;
-    }
-}
-/**
- * Builder for {@link ResponseEntity}.
- *
- * Forces the status code to be set first, then headers and body,
- * ensuring type safety when constructing the response.
- */
-export class ResponseEntityBuilder {
-    constructor(statusCode) {
-        this._headers = {};
-        this._statusCode = statusCode;
-    }
-    /**
-     * Set all headers as an object with keys and values.
-     */
-    headers(headers) {
-        this._headers = headers;
-        return this;
-    }
-    /**
-     * Add/override a single key and value to the headers.
-     */
-    setHeader(key, value) {
-        this._headers[key] = value;
-        return this;
-    }
-    /**
-     * Set the response body.
-     */
-    body(body) {
-        return new ResponseEntity(body, this._headers, this._statusCode);
-    }
-}

package/dist/src/helper/sapling.d.ts

@@ -1,100 +0,0 @@
-import e, { Router } from "express";
-import { Class, ExpressMiddlewareFn } from "../types";
-import { ResponseStatusError } from "./error";
-/**
- * Collection of utility functions which are essential for Sapling to function.
- */
-export declare class Sapling {
-    /**
-     * If you would prefer to manually resolve your controllers instead, call resolve
-     * on the controller class.
-     *
-     * @example```ts
-     * import { Sapling } from "@tahminator/sapling";
-     * import TestController from "./path/to/test.controller";
-     *
-     * const app = express();
-     *
-     * const router = Sapling.resolve(TestController);
-     * app.use(router);
-     * ```
-     */
-    static resolve<TClass>(this: void, clazz: Class<TClass>): Router;
-    /**
-     * Register this function as a middleware in order to utilize Sapling's `deserialize` function.
-     *
-     * @example```ts
-     * import { Sapling } from "@tahminator/sapling";
-     * import express from "express";
-     *
-     * const app = express();
-     *
-     * app.use(Sapling.json());
-     * ```
-     */
-    static json(this: void): ExpressMiddlewareFn;
-    /**
-     * Register your application with all the necessary middlewares and logics for Sapling to function.
-     *
-     * @example```ts
-     * import { Sapling } from "@tahminator/sapling";
-     * import express from "express";
-     *
-     * const app = express();
-     *
-     * app.registerApp(app);
-     * ```
-     */
-    static registerApp(app: e.Express): void;
-    /**
-     * Register a middleware that will handle {@link ResponseStatusError}.
-     *
-     * This middleware will chain to the next middleware if it does not catch {@link ResponseStatusError}.
-     * You may still define middleware to handle all other errors in a separate `app.use` call.
-     *
-     * @example
-     * ```ts
-     * import express from "express";
-     * import { Sapling } from "@tahminator/sapling";
-     *
-     * const app = express();
-     *
-     * Sapling.loadResponseStatusErrorMiddleware(app, (err, req, res, next) => {
-     *   // `err` is guaranteed to be of type ResponseStatusError
-     *   res.status(err.status).json({
-     *     success: false,
-     *     message: err.message,
-     *   });
-     * });
-     * ```
-     */
-    static loadResponseStatusErrorMiddleware(this: void, app: e.Express, fn: (err: ResponseStatusError, request: e.Request, response: e.Response, next: e.NextFunction) => void): void;
-    /**
-     * Serialize a value into a JSON string.
-     *
-     * This function is used in {@link ResponseEntity} to serialize the `body`.
-     *
-     * Use `setSerializeFn` to override underlying implementation.
-     *
-     * @defaultValue `JSON.stringify`
-     */
-    static serialize(this: void, value: any): string;
-    /**
-     * Replace the function used for `serialize`.
-     */
-    static setSerializeFn(this: void, fn: (value: any) => string): void;
-    /**
-     * De-serialize a JSON string back to a JavaScript object.
-     *
-     * This function is used to de-serialize a string into a `body`.
-     *
-     * Use `setDeserializeFn` to override underlying implementation.
-     *
-     * @defaultValue `JSON.parse`
-     */
-    static deserialize<T = any>(this: void, value: string): T;
-    /**
-     * Replace the function used for `deserialize`
-     */
-    static setDeserializeFn(this: void, fn: (value: string) => any): void;
-}

package/dist/src/helper/sapling.js

@@ -1,153 +0,0 @@
-import e from "express";
-import { _ControllerRegistry } from "../annotation/controller";
-import { ResponseStatusError } from "./error";
-const settings = {
-    serialize: JSON.stringify,
-    deserialize: JSON.parse,
-};
-/**
- * Collection of utility functions which are essential for Sapling to function.
- */
-export class Sapling {
-    /**
-     * If you would prefer to manually resolve your controllers instead, call resolve
-     * on the controller class.
-     *
-     * @example```ts
-     * import { Sapling } from "@tahminator/sapling";
-     * import TestController from "./path/to/test.controller";
-     *
-     * const app = express();
-     *
-     * const router = Sapling.resolve(TestController);
-     * app.use(router);
-     * ```
-     */
-    static resolve(clazz) {
-        const router = _ControllerRegistry.get(clazz);
-        if (!router) {
-            throw new Error("Controller cannot be found");
-        }
-        return router;
-    }
-    /**
-     * Register this function as a middleware in order to utilize Sapling's `deserialize` function.
-     *
-     * @example```ts
-     * import { Sapling } from "@tahminator/sapling";
-     * import express from "express";
-     *
-     * const app = express();
-     *
-     * app.use(Sapling.json());
-     * ```
-     */
-    static json() {
-        return (request, _response, next) => {
-            try {
-                if (!request.body) {
-                    return next();
-                }
-                if (request.headers["content-type"] !== "application/json") {
-                    return next();
-                }
-                if (typeof request.body === "string") {
-                    request.body = Sapling.deserialize(request.body);
-                }
-                else if (typeof request.body === "object") {
-                    // override `express.json()` middleware, if ran, and use Sapling's `deserialize` instead.
-                    const raw = JSON.stringify(request.body);
-                    request.body = Sapling.deserialize(raw);
-                }
-                next();
-            }
-            catch (err) {
-                next(err);
-            }
-        };
-    }
-    /**
-     * Register your application with all the necessary middlewares and logics for Sapling to function.
-     *
-     * @example```ts
-     * import { Sapling } from "@tahminator/sapling";
-     * import express from "express";
-     *
-     * const app = express();
-     *
-     * app.registerApp(app);
-     * ```
-     */
-    static registerApp(app) {
-        app.use(e.text({ type: "application/json" }));
-        app.use(Sapling.json());
-    }
-    /**
-     * Register a middleware that will handle {@link ResponseStatusError}.
-     *
-     * This middleware will chain to the next middleware if it does not catch {@link ResponseStatusError}.
-     * You may still define middleware to handle all other errors in a separate `app.use` call.
-     *
-     * @example
-     * ```ts
-     * import express from "express";
-     * import { Sapling } from "@tahminator/sapling";
-     *
-     * const app = express();
-     *
-     * Sapling.loadResponseStatusErrorMiddleware(app, (err, req, res, next) => {
-     *   // `err` is guaranteed to be of type ResponseStatusError
-     *   res.status(err.status).json({
-     *     success: false,
-     *     message: err.message,
-     *   });
-     * });
-     * ```
-     */
-    static loadResponseStatusErrorMiddleware(app, fn) {
-        app.use(((err, req, res, next) => {
-            if (err instanceof ResponseStatusError) {
-                fn(err, req, res, next);
-            }
-            else {
-                next(err);
-            }
-        }));
-    }
-    /**
-     * Serialize a value into a JSON string.
-     *
-     * This function is used in {@link ResponseEntity} to serialize the `body`.
-     *
-     * Use `setSerializeFn` to override underlying implementation.
-     *
-     * @defaultValue `JSON.stringify`
-     */
-    static serialize(value) {
-        return settings.serialize(value);
-    }
-    /**
-     * Replace the function used for `serialize`.
-     */
-    static setSerializeFn(fn) {
-        settings.serialize = fn;
-    }
-    /**
-     * De-serialize a JSON string back to a JavaScript object.
-     *
-     * This function is used to de-serialize a string into a `body`.
-     *
-     * Use `setDeserializeFn` to override underlying implementation.
-     *
-     * @defaultValue `JSON.parse`
-     */
-    static deserialize(value) {
-        return settings.deserialize(value);
-    }
-    /**
-     * Replace the function used for `deserialize`
-     */
-    static setDeserializeFn(fn) {
-        settings.deserialize = fn;
-    }
-}

package/dist/src/html/404.d.ts

@@ -1,4 +0,0 @@
-/**
- * Default Express.js 404 error page, as a string.
- */
-export declare const Html404ErrorPage: (error: string) => string;

package/dist/src/html/404.js

@@ -1,15 +0,0 @@
-/**
- * Default Express.js 404 error page, as a string.
- */
-export const Html404ErrorPage = (error) => `
-<!DOCTYPE html>
-<html lang="en">
-<head>
-<meta charset="utf-8">
-<title>Error</title>
-</head>
-<body>
-<pre>${error}</pre>
-</body>
-</html>
-`;

package/dist/src/html/index.d.ts

@@ -1 +0,0 @@
-export * from "./404";

package/dist/src/html/index.js

@@ -1 +0,0 @@
-export * from "./404";

package/dist/src/index.d.ts

@@ -1,5 +0,0 @@
-export * from "./html";
-export * from "./annotation";
-export * from "./helper";
-export * from "./enum";
-export * from "./types";

package/dist/src/index.js

@@ -1,5 +0,0 @@
-export * from "./html";
-export * from "./annotation";
-export * from "./helper";
-export * from "./enum";
-export * from "./types";

package/dist/src/types.d.ts

@@ -1,21 +0,0 @@
-import { NextFunction, Request, Response } from "express";
-export type ExpressRouterMethodKey = "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "OPTIONS" | "HEAD" | "USE";
-export type ExpressRouterMethods = Lowercase<ExpressRouterMethodKey>;
-export declare const methodResolve: Record<ExpressRouterMethodKey, ExpressRouterMethods>;
-export type RouteDefinition = {
-    /**
-     * Express.js HTTP method.
-     */
-    method: ExpressRouterMethodKey;
-    /**
-     * The path to define the route on. Can be a string or RegExp.
-     */
-    path: string | RegExp;
-    /**
-     * The name of the function the `@Route` annotation was applied on.
-     */
-    fnName: string;
-};
-export type Class<T> = new (...args: any[]) => T;
-export type HttpHeaders = Record<string, string>;
-export type ExpressMiddlewareFn = ($1: Request, $2: Response, $3: NextFunction) => void;

package/dist/src/types.js

@@ -1,11 +0,0 @@
-// all exported types
-export const methodResolve = {
-    GET: "get",
-    PUT: "put",
-    POST: "post",
-    DELETE: "delete",
-    OPTIONS: "options",
-    PATCH: "patch",
-    HEAD: "head",
-    USE: "use",
-};