@moostjs/event-http 0.6.2 → 0.6.3

package/README.md

@@ -76,6 +76,49 @@ class UsersController { ... }
 
 Supported transports: `bearer`, `basic`, `apiKey` (header/query/cookie), `cookie`.
 
+## Programmatic Fetch (SSR)
+
+`MoostHttp` exposes `fetch()` and `request()` methods for in-process route invocation with the full Moost pipeline (DI, interceptors, pipes, validation) — no TCP round-trip.
+
+```ts
+const http = new MoostHttp()
+app.adapter(http)
+await app.init()
+
+// Web Standard fetch API
+const response = await http.fetch(new Request('http://localhost/api/hello/world'))
+
+// Convenience form
+const response = await http.request('/api/hello/world')
+const response = await http.request('/api/users', {
+  method: 'POST',
+  body: JSON.stringify({ name: 'Alice' }),
+  headers: { 'content-type': 'application/json' },
+})
+```
+
+Returns `Response | null` — `null` means no route matched.
+
+When called from within an existing HTTP context (e.g. during SSR), identity headers (`authorization`, `cookie`) are automatically forwarded.
+
+### `enableLocalFetch`
+
+Patches `globalThis.fetch` so that local paths are routed in-process through Moost. External URLs pass through to the original `fetch`. Falls back to original `fetch` if no route matches.
+
+```ts
+import { enableLocalFetch } from '@moostjs/event-http'
+
+const teardown = enableLocalFetch(http)
+
+// Now any fetch('/api/...') goes through Moost in-process
+const res = await fetch('/api/hello/world')
+
+// Restore original fetch
+teardown()
+```
+
+This is wired up automatically by `@moostjs/vite` (see `ssrFetch` option).
+
 ## [Official Documentation](https://moost.org/webapp/)
 
 ## AI Agent Skills

package/dist/index.cjs

@@ -597,8 +597,27 @@ const CONTEXT_TYPE = "HTTP";
 	getHttpApp() {
 		return this.httpApp;
 	}
-	getServerCb() {
-		return this.httpApp.getServerCb();
+	getServerCb(onNoMatch) {
+		return this.httpApp.getServerCb(onNoMatch);
+	}
+	/**
+	* Programmatic route invocation using the Web Standard fetch API.
+	* Goes through the full Moost pipeline: DI scoping, interceptors,
+	* argument resolution, pipes, validation, and handler execution.
+	*
+	* When called from within an existing HTTP context (e.g. during SSR),
+	* identity headers (authorization, cookie) are automatically forwarded.
+	*/ fetch(request) {
+		return this.httpApp.fetch(request);
+	}
+	/**
+	* Convenience wrapper for programmatic route invocation.
+	* Accepts a URL string (relative paths auto-prefixed with `http://localhost`),
+	* URL object, or Request, plus optional `RequestInit`.
+	*
+	* Returns `null` when no route matches the request.
+	*/ request(input, init) {
+		return this.httpApp.request(input, init);
 	}
 	listen(port, hostname, backlog, listeningListener) {
 		return this.httpApp.listen(port, hostname, backlog, listeningListener);
@@ -675,7 +694,7 @@ const CONTEXT_TYPE = "HTTP";
 			image: "https://moost.org/moost-full-logo.svg",
 			link: "https://moost.org/",
 			poweredBy: "moostjs",
-			version: "0.6.1"
+			version: "0.6.2"
 		});
 		if (httpApp && httpApp instanceof __wooksjs_event_http.WooksHttp) this.httpApp = httpApp;
 		else if (httpApp) this.httpApp = (0, __wooksjs_event_http.createHttpApp)({
@@ -686,6 +705,47 @@ const CONTEXT_TYPE = "HTTP";
 	}
 };
 
+//#endregion
+//#region packages/event-http/src/local-fetch.ts
+/**
+* Patches `globalThis.fetch` so that requests to local paths (starting with `/`)
+* are routed through `MoostHttp` in-process instead of making a network request.
+* Falls back to the original `fetch` when no Moost route matches.
+*
+* Useful for SSR scenarios where server-side code needs to call its own API endpoints
+* without the overhead of a TCP round-trip.
+*
+* @returns A teardown function that restores the original `globalThis.fetch`.
+*/ function enableLocalFetch(http$1) {
+	const originalFetch = globalThis.fetch;
+	globalThis.fetch = async (input, init) => {
+		if (typeof input === "string") {
+			if (input.startsWith("/")) {
+				const response = await http$1.request(input, init);
+				if (response) return response;
+			}
+		} else if (input instanceof URL) {
+			if (isLocalOrigin(input)) {
+				const response = await http$1.request(input, init);
+				if (response) return response;
+			}
+		} else {
+			const url = new URL(input.url);
+			if (isLocalOrigin(url)) {
+				const response = await http$1.fetch(input);
+				if (response) return response;
+			}
+		}
+		return originalFetch(input, init);
+	};
+	return () => {
+		globalThis.fetch = originalFetch;
+	};
+}
+function isLocalOrigin(url) {
+	return url.hostname === "localhost" || url.hostname === "127.0.0.1";
+}
+
 //#endregion
 exports.All = All;
 Object.defineProperty(exports, 'AuthGuard', {
@@ -733,6 +793,7 @@ exports.StatusRef = StatusRef;
 exports.Upgrade = Upgrade;
 exports.Url = Url;
 exports.defineAuthGuard = defineAuthGuard;
+exports.enableLocalFetch = enableLocalFetch;
 exports.extractTransports = extractTransports;
 exports.globalBodyReadTimeoutMs = globalBodyReadTimeoutMs;
 exports.globalBodySizeLimit = globalBodySizeLimit;

package/dist/index.d.ts

@@ -400,7 +400,24 @@ declare class MoostHttp implements TMoostAdapter<THttpHandlerMeta> {
     protected httpApp: WooksHttp;
     constructor(httpApp?: WooksHttp | TWooksHttpOptions);
     getHttpApp(): WooksHttp;
-    getServerCb(): (req: http.IncomingMessage, res: http.ServerResponse) => void;
+    getServerCb(onNoMatch?: (req: http.IncomingMessage, res: http.ServerResponse) => void): (req: http.IncomingMessage, res: http.ServerResponse) => void;
+    /**
+     * Programmatic route invocation using the Web Standard fetch API.
+     * Goes through the full Moost pipeline: DI scoping, interceptors,
+     * argument resolution, pipes, validation, and handler execution.
+     *
+     * When called from within an existing HTTP context (e.g. during SSR),
+     * identity headers (authorization, cookie) are automatically forwarded.
+     */
+    fetch(request: Request): Promise<Response | null>;
+    /**
+     * Convenience wrapper for programmatic route invocation.
+     * Accepts a URL string (relative paths auto-prefixed with `http://localhost`),
+     * URL object, or Request, plus optional `RequestInit`.
+     *
+     * Returns `null` when no route matches the request.
+     */
+    request(input: string | URL | Request, init?: RequestInit): Promise<Response | null>;
     listen(port?: number, hostname?: string, backlog?: number, listeningListener?: () => void): Promise<void>;
     listen(port?: number, hostname?: string, listeningListener?: () => void): Promise<void>;
     listen(port?: number, backlog?: number, listeningListener?: () => void): Promise<void>;
@@ -425,5 +442,17 @@ declare class MoostHttp implements TMoostAdapter<THttpHandlerMeta> {
     bindHandler<T extends object = object>(opts: TMoostAdapterOptions<THttpHandlerMeta, T>): void;
 }
 
-export { All, AuthGuard, Authenticate, Authorization, Body, BodyReadTimeoutMs, BodySizeLimit, CompressedBodySizeLimit, Cookie, CookieAttrsRef, CookieRef, Delete, Get, Header, HeaderRef, HttpMethod, Ip, IpList, Method, MoostHttp, Patch, Post, Put, Query, RawBody, Req, ReqId, Res, SetCookie, SetHeader, SetStatus, StatusRef, Upgrade, Url, defineAuthGuard, extractTransports, globalBodyReadTimeoutMs, globalBodySizeLimit, globalCompressedBodySizeLimit };
+/**
+ * Patches `globalThis.fetch` so that requests to local paths (starting with `/`)
+ * are routed through `MoostHttp` in-process instead of making a network request.
+ * Falls back to the original `fetch` when no Moost route matches.
+ *
+ * Useful for SSR scenarios where server-side code needs to call its own API endpoints
+ * without the overhead of a TCP round-trip.
+ *
+ * @returns A teardown function that restores the original `globalThis.fetch`.
+ */
+declare function enableLocalFetch(http: MoostHttp): () => void;
+
+export { All, AuthGuard, Authenticate, Authorization, Body, BodyReadTimeoutMs, BodySizeLimit, CompressedBodySizeLimit, Cookie, CookieAttrsRef, CookieRef, Delete, Get, Header, HeaderRef, HttpMethod, Ip, IpList, Method, MoostHttp, Patch, Post, Put, Query, RawBody, Req, ReqId, Res, SetCookie, SetHeader, SetStatus, StatusRef, Upgrade, Url, defineAuthGuard, enableLocalFetch, extractTransports, globalBodyReadTimeoutMs, globalBodySizeLimit, globalCompressedBodySizeLimit };
 export type { TAuthGuardClass, TAuthGuardDef, TAuthGuardHandler, TAuthTransportApiKey, TAuthTransportBasic, TAuthTransportBearer, TAuthTransportCookie, TAuthTransportDeclaration, TAuthTransportValues, TCookieAttributes, TCookieRef, THeaderRef, THttpHandlerMeta, TStatusRef };

package/dist/index.mjs

@@ -574,8 +574,27 @@ const CONTEXT_TYPE = "HTTP";
 	getHttpApp() {
 		return this.httpApp;
 	}
-	getServerCb() {
-		return this.httpApp.getServerCb();
+	getServerCb(onNoMatch) {
+		return this.httpApp.getServerCb(onNoMatch);
+	}
+	/**
+	* Programmatic route invocation using the Web Standard fetch API.
+	* Goes through the full Moost pipeline: DI scoping, interceptors,
+	* argument resolution, pipes, validation, and handler execution.
+	*
+	* When called from within an existing HTTP context (e.g. during SSR),
+	* identity headers (authorization, cookie) are automatically forwarded.
+	*/ fetch(request) {
+		return this.httpApp.fetch(request);
+	}
+	/**
+	* Convenience wrapper for programmatic route invocation.
+	* Accepts a URL string (relative paths auto-prefixed with `http://localhost`),
+	* URL object, or Request, plus optional `RequestInit`.
+	*
+	* Returns `null` when no route matches the request.
+	*/ request(input, init) {
+		return this.httpApp.request(input, init);
 	}
 	listen(port, hostname, backlog, listeningListener) {
 		return this.httpApp.listen(port, hostname, backlog, listeningListener);
@@ -652,7 +671,7 @@ const CONTEXT_TYPE = "HTTP";
 			image: "https://moost.org/moost-full-logo.svg",
 			link: "https://moost.org/",
 			poweredBy: "moostjs",
-			version: "0.6.1"
+			version: "0.6.2"
 		});
 		if (httpApp && httpApp instanceof WooksHttp) this.httpApp = httpApp;
 		else if (httpApp) this.httpApp = createHttpApp({
@@ -664,4 +683,45 @@ const CONTEXT_TYPE = "HTTP";
 };
 
 //#endregion
-export { All, AuthGuard, Authenticate, Authorization, Body, BodyReadTimeoutMs, BodySizeLimit, CompressedBodySizeLimit, Cookie, CookieAttrsRef, CookieRef, Delete, Get, Header, HeaderRef, HttpError, HttpMethod, Ip, IpList, Method, MoostHttp, Patch, Post, Put, Query, RawBody, Req, ReqId, Res, SetCookie, SetHeader, SetStatus, StatusRef, Upgrade, Url, defineAuthGuard, extractTransports, globalBodyReadTimeoutMs, globalBodySizeLimit, globalCompressedBodySizeLimit, httpKind, useHttpContext };
+//#region packages/event-http/src/local-fetch.ts
+/**
+* Patches `globalThis.fetch` so that requests to local paths (starting with `/`)
+* are routed through `MoostHttp` in-process instead of making a network request.
+* Falls back to the original `fetch` when no Moost route matches.
+*
+* Useful for SSR scenarios where server-side code needs to call its own API endpoints
+* without the overhead of a TCP round-trip.
+*
+* @returns A teardown function that restores the original `globalThis.fetch`.
+*/ function enableLocalFetch(http) {
+	const originalFetch = globalThis.fetch;
+	globalThis.fetch = async (input, init) => {
+		if (typeof input === "string") {
+			if (input.startsWith("/")) {
+				const response = await http.request(input, init);
+				if (response) return response;
+			}
+		} else if (input instanceof URL) {
+			if (isLocalOrigin(input)) {
+				const response = await http.request(input, init);
+				if (response) return response;
+			}
+		} else {
+			const url = new URL(input.url);
+			if (isLocalOrigin(url)) {
+				const response = await http.fetch(input);
+				if (response) return response;
+			}
+		}
+		return originalFetch(input, init);
+	};
+	return () => {
+		globalThis.fetch = originalFetch;
+	};
+}
+function isLocalOrigin(url) {
+	return url.hostname === "localhost" || url.hostname === "127.0.0.1";
+}
+
+//#endregion
+export { All, AuthGuard, Authenticate, Authorization, Body, BodyReadTimeoutMs, BodySizeLimit, CompressedBodySizeLimit, Cookie, CookieAttrsRef, CookieRef, Delete, Get, Header, HeaderRef, HttpError, HttpMethod, Ip, IpList, Method, MoostHttp, Patch, Post, Put, Query, RawBody, Req, ReqId, Res, SetCookie, SetHeader, SetStatus, StatusRef, Upgrade, Url, defineAuthGuard, enableLocalFetch, extractTransports, globalBodyReadTimeoutMs, globalBodySizeLimit, globalCompressedBodySizeLimit, httpKind, useHttpContext };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moostjs/event-http",
-  "version": "0.6.2",
+  "version": "0.6.3",
   "description": "@moostjs/event-http",
   "keywords": [
     "composables",
@@ -43,16 +43,16 @@
     }
   },
   "dependencies": {
-    "@wooksjs/event-http": "^0.7.4",
-    "@wooksjs/http-body": "^0.7.4"
+    "@wooksjs/event-http": "^0.7.7",
+    "@wooksjs/http-body": "^0.7.7"
   },
   "devDependencies": {
     "vitest": "3.2.4"
   },
   "peerDependencies": {
     "@prostojs/infact": "^0.4.1",
-    "@wooksjs/event-core": "^0.7.4",
-    "moost": "^0.6.2"
+    "@wooksjs/event-core": "^0.7.7",
+    "moost": "^0.6.3"
   },
   "scripts": {
     "pub": "pnpm publish --access public",