context-router 0.0.1

package/LICENSE

@@ -0,0 +1,7 @@
+ISC License
+
+Copyright 2026 Octoth0rpe
+
+Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,7 @@
+# context-router
+
+A lightweight HTTP router with URL pattern matching and context support for Node.js/TypeScript.
+
+## License
+
+ISC

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+type HttpMethod = 'GET' | 'POST' | 'DELETE' | 'PATCH' | 'PUT';
+export type HandlerParams<Context extends Record<string, any> = {}> = {
+    body: string;
+    urlParams: Record<string, string | undefined>;
+    searchParams: URLSearchParams;
+} & Context;
+export type Handler<Context extends Record<string, any> = {}> = (params: HandlerParams<Context>) => Response | Promise<Response>;
+export declare class Router<Context extends Record<string, any> = {}> {
+    private routes;
+    add: (method: HttpMethod, pathname: string, handler: Handler<Context>) => Router<Context>;
+    match: (request: Request, context: Context) => Promise<Response>;
+}
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AACA,KAAK,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,KAAK,CAAA;AAG7D,MAAM,MAAM,aAAa,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,EAAE,IAAI;IACrE,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;IAC7C,YAAY,EAAE,eAAe,CAAA;CAC7B,GAAG,OAAO,CAAA;AAGX,MAAM,MAAM,OAAO,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,EAAE,IAAI,CAC/D,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,KAC1B,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;AAGjC,qBAAa,MAAM,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,EAAE;IAC3D,OAAO,CAAC,MAAM,CAMb;IAGD,GAAG,GAAI,QAAQ,UAAU,EAAE,UAAU,MAAM,EAAE,SAAS,OAAO,CAAC,OAAO,CAAC,KAAG,MAAM,CAAC,OAAO,CAAC,CAGvF;IAGD,KAAK,GAAU,SAAS,OAAO,EAAE,SAAS,OAAO,KAAG,OAAO,CAAC,QAAQ,CAAC,CAmBpE;CACD"}

package/dist/index.js

@@ -0,0 +1,37 @@
+// HTTP router with URLPattern-based matching and context injection
+export class Router {
+    constructor() {
+        this.routes = {
+            GET: [],
+            POST: [],
+            DELETE: [],
+            PATCH: [],
+            PUT: [],
+        };
+        // Register route: creates URLPattern, stores handler, enables chaining
+        this.add = (method, pathname, handler) => {
+            this.routes[method].push({ pattern: new URLPattern({ pathname }), handler });
+            return this;
+        };
+        // Match request: iterate routes by method, invoke first match with merged params
+        this.match = async (request, context) => {
+            const method = request.method.toUpperCase();
+            const possibleRoutes = this.routes[method] || [];
+            const body = await request.text();
+            const { searchParams, pathname } = new URL(request.url);
+            for (const route of possibleRoutes) {
+                const result = route.pattern.exec({ pathname });
+                if (result !== null) {
+                    return route.handler({
+                        body,
+                        urlParams: result.pathname.groups,
+                        searchParams,
+                        ...context,
+                    });
+                }
+            }
+            return new Response('Not Found', { status: 404 });
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAeA,mEAAmE;AACnE,MAAM,OAAO,MAAM;IAAnB;QACS,WAAM,GAA6E;YAC1F,GAAG,EAAE,EAAE;YACP,IAAI,EAAE,EAAE;YACR,MAAM,EAAE,EAAE;YACV,KAAK,EAAE,EAAE;YACT,GAAG,EAAE,EAAE;SACP,CAAA;QAED,uEAAuE;QACvE,QAAG,GAAG,CAAC,MAAkB,EAAE,QAAgB,EAAE,OAAyB,EAAmB,EAAE;YAC1F,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,UAAU,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAA;YAC5E,OAAO,IAAI,CAAA;QACZ,CAAC,CAAA;QAED,iFAAiF;QACjF,UAAK,GAAG,KAAK,EAAE,OAAgB,EAAE,OAAgB,EAAqB,EAAE;YACvE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,EAAgB,CAAA;YACzD,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAA;YAChD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,CAAA;YACjC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;YAEvD,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;gBACpC,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAA;gBAC/C,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;oBACrB,OAAO,KAAK,CAAC,OAAO,CAAC;wBACpB,IAAI;wBACJ,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;wBACjC,YAAY;wBACZ,GAAG,OAAO;qBACV,CAAC,CAAA;gBACH,CAAC;YACF,CAAC;YAED,OAAO,IAAI,QAAQ,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAA;QAClD,CAAC,CAAA;IACF,CAAC;CAAA"}

package/dist/router.d.ts

@@ -0,0 +1,21 @@
+type HttpMethod = "GET" | "POST" | "DELETE" | "PATCH" | "PUT";
+export type HandlerParams<Context extends Record<string, any> = {}> = {
+    body: string;
+    urlParams: Record<string, string | undefined>;
+    searchParams: URLSearchParams;
+} & Context;
+export type Handler<Context extends Record<string, any> = {}> = (params: HandlerParams<Context>) => Response | Promise<Response>;
+export declare class Router<Context extends Record<string, any> = {}> {
+    private routes;
+    private notFoundHandler;
+    setNotFoundHandler: (handler: Handler<Context>) => this;
+    add: (method: HttpMethod, pathname: string, handler: Handler<Context>) => Router<Context>;
+    match: (request: Request, context: Context) => Promise<Response>;
+    get: (pathname: string, handler: Handler<Context>) => Router<Context>;
+    post: (pathname: string, handler: Handler<Context>) => Router<Context>;
+    put: (pathname: string, handler: Handler<Context>) => Router<Context>;
+    patch: (pathname: string, handler: Handler<Context>) => Router<Context>;
+    delete: (pathname: string, handler: Handler<Context>) => Router<Context>;
+}
+export {};
+//# sourceMappingURL=router.d.ts.map

package/dist/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA,KAAK,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,KAAK,CAAC;AAG9D,MAAM,MAAM,aAAa,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,EAAE,IAAI;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAC9C,YAAY,EAAE,eAAe,CAAC;CAC9B,GAAG,OAAO,CAAC;AAGZ,MAAM,MAAM,OAAO,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,EAAE,IAAI,CAC/D,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,KAC1B,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;AAGlC,qBAAa,MAAM,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,EAAE;IAC3D,OAAO,CAAC,MAAM,CASZ;IAEF,OAAO,CAAC,eAAe,CAEyB;IAGhD,kBAAkB,GAAI,SAAS,OAAO,CAAC,OAAO,CAAC,UAG7C;IAGF,GAAG,GACF,QAAQ,UAAU,EAClB,UAAU,MAAM,EAChB,SAAS,OAAO,CAAC,OAAO,CAAC,KACvB,MAAM,CAAC,OAAO,CAAC,CAMhB;IAGF,KAAK,GAAU,SAAS,OAAO,EAAE,SAAS,OAAO,KAAG,OAAO,CAAC,QAAQ,CAAC,CAwBnE;IAGF,GAAG,GAAI,UAAU,MAAM,EAAE,SAAS,OAAO,CAAC,OAAO,CAAC,KAAG,MAAM,CAAC,OAAO,CAAC,CAElE;IAGF,IAAI,GAAI,UAAU,MAAM,EAAE,SAAS,OAAO,CAAC,OAAO,CAAC,KAAG,MAAM,CAAC,OAAO,CAAC,CAEnE;IAGF,GAAG,GAAI,UAAU,MAAM,EAAE,SAAS,OAAO,CAAC,OAAO,CAAC,KAAG,MAAM,CAAC,OAAO,CAAC,CAElE;IAGF,KAAK,GAAI,UAAU,MAAM,EAAE,SAAS,OAAO,CAAC,OAAO,CAAC,KAAG,MAAM,CAAC,OAAO,CAAC,CAEpE;IAGF,MAAM,GAAI,UAAU,MAAM,EAAE,SAAS,OAAO,CAAC,OAAO,CAAC,KAAG,MAAM,CAAC,OAAO,CAAC,CAErE;CACF"}

package/dist/router.js

@@ -0,0 +1,71 @@
+// HTTP router with URLPattern-based matching and context injection
+export class Router {
+    constructor() {
+        this.routes = {
+            GET: [],
+            POST: [],
+            DELETE: [],
+            PATCH: [],
+            PUT: [],
+        };
+        this.notFoundHandler = (_params) => new Response("Not Found", { status: 404 });
+        // Override the not found handler
+        this.setNotFoundHandler = (handler) => {
+            this.notFoundHandler = handler;
+            return this;
+        };
+        // Register route: creates URLPattern, stores handler, enables chaining
+        this.add = (method, pathname, handler) => {
+            this.routes[method].push({
+                pattern: new URLPattern({ pathname }),
+                handler,
+            });
+            return this;
+        };
+        // Match request: iterate routes by method, invoke first match
+        this.match = async (request, context) => {
+            const method = request.method.toUpperCase();
+            const possibleRoutes = this.routes[method] || [];
+            const body = await request.text();
+            const { searchParams, pathname } = new URL(request.url);
+            for (const route of possibleRoutes) {
+                const result = route.pattern.exec({ pathname });
+                if (result !== null) {
+                    return route.handler({
+                        body,
+                        urlParams: result.pathname.groups,
+                        searchParams,
+                        ...context,
+                    });
+                }
+            }
+            return this.notFoundHandler({
+                body,
+                urlParams: {},
+                searchParams,
+                ...context,
+            });
+        };
+        // Helper method for GET requests
+        this.get = (pathname, handler) => {
+            return this.add("GET", pathname, handler);
+        };
+        // Helper method for POST requests
+        this.post = (pathname, handler) => {
+            return this.add("POST", pathname, handler);
+        };
+        // Helper method for PUT requests
+        this.put = (pathname, handler) => {
+            return this.add("PUT", pathname, handler);
+        };
+        // Helper method for PATCH requests
+        this.patch = (pathname, handler) => {
+            return this.add("PATCH", pathname, handler);
+        };
+        // Helper method for DELETE requests
+        this.delete = (pathname, handler) => {
+            return this.add("DELETE", pathname, handler);
+        };
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"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"}

package/dist/router.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=router.test.d.ts.map

package/dist/router.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.test.d.ts","sourceRoot":"","sources":["../src/router.test.ts"],"names":[],"mappings":""}