@spirobel/mininext 0.2.27 → 0.3.0

package/dist/mininext.d.ts

@@ -1,9 +1,15 @@
+/// <reference types="bun-types" />
+/// <reference types="bun-types" />
 import { url, Mini, type HtmlHandler } from "./url";
 import { isError, HtmlString, head, commonHead, cssReset } from "./html";
+import type { Server, WebSocketHandler } from "bun";
 declare global {
     var PROJECT_ROOT: string | undefined;
 }
 declare function build(backendPath?: string): Promise<void>;
 declare const standardDevReloader: HtmlString;
-declare function makeEntrypoint(): Promise<(w: any) => Promise<Response>>;
+declare function makeEntrypoint(): Promise<{
+    fetch: (req: Request, server: Server) => Promise<Response>;
+    websocket: WebSocketHandler;
+}>;
 export { url, head, build, makeEntrypoint, isError, HtmlString, type HtmlHandler, Mini, standardDevReloader, commonHead, cssReset, };

package/dist/mininext.js

@@ -156,6 +156,6 @@ async function makeEntrypoint() {
         // @ts-ignore
         module = await import(backendImportPath);
     }
-    return module.default;
+    return module.default();
 }
 export { url, head, build, makeEntrypoint, isError, HtmlString, Mini, standardDevReloader, commonHead, cssReset, };

package/dist/url.d.ts

@@ -1,3 +1,6 @@
+/// <reference types="bun-types" />
+/// <reference types="bun-types" />
+import type { Server, WebSocketHandler } from "bun";
 import { html, json, dangerjson, HtmlString } from "./html";
 import type { DangerJsonInHtml, JsonString, JsonStringValues } from "./html";
 export type Form = {
@@ -68,6 +71,8 @@ interface LinkSettings {
     [key: string]: string | null | undefined;
 }
 export declare class url {
+    static websocket: WebSocketHandler | undefined;
+    static server: Server;
     static direct_handlers_html: ReadonlyMap<string, HtmlHandler>;
     private static frontends;
     private static svgs;
@@ -146,7 +151,7 @@ export declare class url {
      * @param handler - normal html handler with mini as the argument
      * @returns a wrapped html handler that will only be called when the request is post
      */
-    static post<Y = unknown>(handler: HtmlHandler<Y>): (mini: Mini<Y>) => LazyHandlerReturnType;
+    static post(handler: HtmlHandler): (mini: Mini) => LazyHandlerReturnType;
     /**
      * wrap your handlers in this if you mutate something to prevent CSRF issues.
      * @param handler - normal html handler with mini as the argument
@@ -183,11 +188,19 @@ export declare class url {
      */
     static get(Url: string): string;
     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.
+     * @param wsObject the websocketsocket object {@link WebSocketHandler}
+     */
+    static setWebsocket<T = undefined>(wsObject: WebSocketHandler<T>): void;
     /**
      * Fetch handler that is called by the server when a request is made to any of the urls.
      * @param {Request} req - The Request object.
      * @return {Promise<Response>} - The Response object.
      */
-    static install(req: Request): Promise<Response>;
+    static install(): {
+        fetch: (req: Request, server: Server) => Promise<Response>;
+        websocket: WebSocketHandler<undefined> | undefined;
+    };
 }
 export {};

package/dist/url.js

@@ -47,6 +47,8 @@ export class Mini {
     }
 }
 export class url {
+    static websocket = undefined;
+    static server;
     // direct mapping of "url string" -> function leads to Html Response
     static direct_handlers_html;
     // An array of the uncompiled frontend files, example frontends[0] = "index.tsx" -> frontend/index.tsx (from the project root)
@@ -386,29 +388,41 @@ export class url {
             return htmlResponder(mini, unresolved, handlerHead, handlerOptions);
         }
     }
+    /**
+     * user this to set the Websocket object. Check out [the bun docs](https://bun.sh/docs/api/websockets) for more details.
+     * @param wsObject the websocketsocket object {@link WebSocketHandler}
+     */
+    static setWebsocket(wsObject) {
+        url.websocket = wsObject;
+    }
     /**
      * Fetch handler that is called by the server when a request is made to any of the urls.
      * @param {Request} req - The Request object.
      * @return {Promise<Response>} - The Response object.
      */
-    static async install(req) {
-        //go through all the Htmlhandlers and see if there is a match
-        let res = await url.match(req);
-        if (res)
-            return res;
-        //handle frontend js file serving
-        res = url.serveFrontend(req);
-        if (res)
-            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 });
+    static install() {
+        async function fetchFunction(req, server) {
+            if (!url.server)
+                url.server = server;
+            //go through all the Htmlhandlers and see if there is a match
+            let res = await url.match(req);
+            if (res)
+                return res;
+            //handle frontend js file serving
+            res = url.serveFrontend(req);
+            if (res)
+                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 });
+        }
+        return { fetch: fetchFunction, websocket: url.websocket };
     }
 }
 const no_post_warning = html `<div style="color:red;">

package/mininext/mininext.ts

@@ -1,5 +1,6 @@
 import { url, Mini, type HtmlHandler } from "./url";
 import { html, isError, HtmlString, head, commonHead, cssReset } from "./html";
+import type { BunPlugin, Server, WebSocketHandler } from "bun";
 import { watch } from "fs/promises";
 import * as path from "path";
 function projectRoot() {
@@ -14,7 +15,6 @@ async function build(backendPath: string = "backend/backend.ts") {
     await devServer();
   }
 }
-import type { BunPlugin } from "bun";
 
 const myPlugin: BunPlugin = {
   name: "node buffer in the frontend",
@@ -168,7 +168,10 @@ async function makeEntrypoint() {
     // @ts-ignore
     module = await import(backendImportPath);
   }
-  return module.default as (w: any) => Promise<Response>;
+  return module.default() as {
+    fetch: (req: Request, server: Server) => Promise<Response>;
+    websocket: WebSocketHandler;
+  };
 }
 export {
   url,

package/mininext/url.ts

@@ -1,3 +1,4 @@
+import type { Server, WebSocketHandler } from "bun";
 import { htmlResponder, html, json, dangerjson, HtmlString } from "./html";
 import type { DangerJsonInHtml, JsonString, JsonStringValues } from "./html";
 export type Form = {
@@ -116,6 +117,9 @@ interface LinkSettings {
   [key: string]: string | null | undefined;
 }
 export class url {
+  static websocket: WebSocketHandler | undefined = undefined;
+  static server: Server;
+
   // direct mapping of "url string" -> function leads to Html Response
   static direct_handlers_html: ReadonlyMap<string, HtmlHandler>;
 
@@ -272,8 +276,8 @@ export class url {
    * @param handler - normal html handler with mini as the argument
    * @returns a wrapped html handler that will only be called when the request is post
    */
-  static post<Y = unknown>(handler: HtmlHandler<Y>) {
-    return (mini: Mini<Y>) => {
+  static post(handler: HtmlHandler) {
+    return (mini: Mini) => {
       if (mini.form.post) {
         return handler(mini);
       } else {
@@ -486,28 +490,39 @@ export class url {
       return htmlResponder(mini, unresolved, handlerHead, handlerOptions);
     }
   }
+  /**
+   * user this to set the Websocket object. Check out [the bun docs](https://bun.sh/docs/api/websockets) for more details.
+   * @param wsObject the websocketsocket object {@link WebSocketHandler}
+   */
+  static setWebsocket<T = undefined>(wsObject: WebSocketHandler<T>) {
+    url.websocket = wsObject as WebSocketHandler;
+  }
 
   /**
    * Fetch handler that is called by the server when a request is made to any of the urls.
    * @param {Request} req - The Request object.
    * @return {Promise<Response>} - The Response object.
    */
-  static async install(req: Request) {
-    //go through all the Htmlhandlers and see if there is a match
-    let res = await url.match(req);
-    if (res) return res;
+  static install() {
+    async function fetchFunction(req: Request, server: Server) {
+      if (!url.server) url.server = server;
+      //go through all the Htmlhandlers and see if there is a match
+      let res = await url.match(req);
+      if (res) return res;
 
-    //handle frontend js file serving
-    res = url.serveFrontend(req);
-    if (res) 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;
+      //handle frontend js file serving
+      res = url.serveFrontend(req);
+      if (res) 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 });
+      return new Response("No matching url found", { status: 404 });
+    }
+    return { fetch: fetchFunction, websocket: url.websocket };
   }
 }
 

package/package.json

@@ -12,7 +12,7 @@
 
   },
   "files": ["dist", "mininext"],
-  "version": "0.2.27",
+  "version": "0.3.0",
   "devDependencies": {
     "@types/bun": "latest"
   },