@spirobel/mininext 0.4.0 → 0.4.2

package/dist/url.d.ts

@@ -152,6 +152,18 @@ export declare class url {
      */
     static set<K extends string>(entries: [K, HtmlHandler][]): void;
     static set(urlPath: string, handler: HtmlHandler): void;
+    /**
+     * use this to remove routes.
+     * @param urlPath - the route to remove
+     * @example
+     * ``` js
+     * let perma_link_defined_by_editor_or_admin_user_that_changed = "/haha"
+     * url.remove(perma_link_defined_by_editor_or_admin_user_that_changed);
+     * // add new url after removing the old one (that might come from a sqlite db)
+     * url.set("/huhu", (mini)=> mini.html`huhu`)
+     * ```
+     */
+    static remove(urlPath: string): void;
     /**
      * wrap your handlers in this if you mutate something to prevent CSRF issues.
      * @param handler - normal html handler with mini as the argument
@@ -187,12 +199,21 @@ export declare class url {
     static link<X>(Url: string, qs?: string[] | string, settings?: LinkSettings): (mini: Mini<X>) => string;
     static currylink(Url: string, qs: string[] | string, req: Request, settings?: LinkSettings): string;
     /**
-     * This method retrieves a url from the urls array. If the url does not exist in the urls array, an error will be thrown.
+     * users expect links to work with or without a trailing slash.
+     * Developers expect that that links work with or without a preceding slash.
+     * We make sure that these expectations are met when using url.set and url.get.
+     * (by adding all the variations to the url.direct_handlers Map)
+     * @param {string} inputString - the url
+     * @returns {string[]} - returns array of variations (added slash in the beginning, added, removed slash at the end)
+     */
+    static generateVariations(inputString: string): string[];
+    /**
+     * This method retrieves a url from the urls array. If the url does not exist in the urls array, null will be returned.
      * @param {string} Url - The url to retrieve.
      * @return {string} - The retrieved url.
      * @throws Will throw an Error if the provided url is not found in the urls array.
      */
-    static get(Url: string): string;
+    static get(Url: string): string | null;
     static match(req: Request, reqPath?: string): Promise<Response | undefined>;
     /**
      * user this to set the Websocket object. Check out [the bun docs](https://bun.sh/docs/api/websockets) for more details.

package/dist/url.js

@@ -52,7 +52,7 @@ export class url {
     static websocket = undefined;
     static server;
     // direct mapping of "url string" -> function leads to Html Response
-    static direct_handlers_html;
+    static direct_handlers_html = new Map();
     // An array of the uncompiled frontend files, example frontends[0] = "index.tsx" -> frontend/index.tsx (from the project root)
     static frontends = [];
     static svgs = new Map();
@@ -175,16 +175,34 @@ export class url {
         };
     }
     static set(entries, handler) {
-        if (typeof entries === "string" && handler) {
-            if (url.direct_handlers_html) {
-                url.direct_handlers_html.set(entries, handler);
-            }
-            else {
-                url.direct_handlers_html = new Map([[entries, handler]]);
+        function addUrl(entryUrl, entryHandler) {
+            for (const u of url.generateVariations(entryUrl)) {
+                url.direct_handlers_html.set(u, entryHandler);
             }
         }
+        if (typeof entries === "string" && handler) {
+            addUrl(entries, handler);
+        }
         if (typeof entries !== "string")
-            url.direct_handlers_html = new Map(entries);
+            for (const [entryUrl, entryHandler] of entries) {
+                addUrl(entryUrl, entryHandler);
+            }
+    }
+    /**
+     * use this to remove routes.
+     * @param urlPath - the route to remove
+     * @example
+     * ``` js
+     * let perma_link_defined_by_editor_or_admin_user_that_changed = "/haha"
+     * url.remove(perma_link_defined_by_editor_or_admin_user_that_changed);
+     * // add new url after removing the old one (that might come from a sqlite db)
+     * url.set("/huhu", (mini)=> mini.html`huhu`)
+     * ```
+     */
+    static remove(urlPath) {
+        for (const u of url.generateVariations(urlPath)) {
+            url.direct_handlers_html.delete(u);
+        }
     }
     /**
      * wrap your handlers in this if you mutate something to prevent CSRF issues.
@@ -280,7 +298,7 @@ export class url {
         // Create a new URL object from the current location
         // https://github.com/whatwg/url/issues/531#issuecomment-1337050285
         const GOOFY_HACK = "http://goofyhack.com";
-        const updatedUrl = new URL(url.get(Url), GOOFY_HACK);
+        const updatedUrl = new URL(url.get(Url) || "/url_not_found_error", GOOFY_HACK);
         for (const q of qs) {
             // Use URLSearchParams to set the name query parameter
             const reqParam = new URL(req.url).searchParams.get(q);
@@ -298,15 +316,47 @@ export class url {
         return updatedUrl.toString().slice(GOOFY_HACK.length);
     }
     /**
-     * This method retrieves a url from the urls array. If the url does not exist in the urls array, an error will be thrown.
+     * users expect links to work with or without a trailing slash.
+     * Developers expect that that links work with or without a preceding slash.
+     * We make sure that these expectations are met when using url.set and url.get.
+     * (by adding all the variations to the url.direct_handlers Map)
+     * @param {string} inputString - the url
+     * @returns {string[]} - returns array of variations (added slash in the beginning, added, removed slash at the end)
+     */
+    static generateVariations(inputString) {
+        const variations = [];
+        // Special case for the index route
+        if (inputString === "/") {
+            variations.push("/");
+            return variations;
+        }
+        // Check if the string starts with a slash and add/remove variations accordingly
+        if (inputString.startsWith("/")) {
+            variations.push(inputString); // With leading slash
+        }
+        else {
+            inputString = "/" + inputString;
+            variations.push(inputString); // With leading slash
+        }
+        // Check if the string ends with a slash and add/remove variations accordingly
+        if (inputString.endsWith("/")) {
+            variations.push(inputString.slice(0, -1)); // Without trailing slash
+        }
+        else {
+            variations.push(inputString + "/"); // With trailing slash
+        }
+        return variations;
+    }
+    /**
+     * This method retrieves a url from the urls array. If the url does not exist in the urls array, null will be returned.
      * @param {string} Url - The url to retrieve.
      * @return {string} - The retrieved url.
      * @throws Will throw an Error if the provided url is not found in the urls array.
      */
     static get(Url) {
-        const foundUrl = url.direct_handlers_html.get(Url);
+        const foundUrl = url.direct_handlers_html.get(url.generateVariations(Url)[0]);
         if (!foundUrl) {
-            throw new Error(`URL "${html `${Url}`}" was not set.`);
+            return null;
         }
         return Url;
     }
@@ -432,10 +482,6 @@ export class url {
                 return res;
             //handle svg file serving
             res = url.serveSvg(req);
-            if (res)
-                return res;
-            // go through all the Htmlhandlers again with added slash at the end.
-            res = await url.match(req, new URL(req.url).pathname + "/");
             if (res)
                 return res;
             return new Response("No matching url found", { status: 404 });

package/package.json

@@ -11,7 +11,7 @@
     "clean":"rm -rf ./dist"
   },
   "files": ["dist"],
-  "version": "0.4.0",
+  "version": "0.4.2",
   "devDependencies": {
     "@types/bun": "latest"
   },