@moostjs/event-http 0.6.48 → 0.6.49

package/dist/index.cjs

@@ -528,6 +528,46 @@ const setStatusInterceptor = (code, opts) => ({
 * @param n - Timeout duration in milliseconds.
 */ const BodyReadTimeoutMs = (n) => (0, moost.Intercept)(globalBodyReadTimeoutMs(n));
 
+//#endregion
+//#region packages/event-http/src/decorators/compress.decorator.ts
+/**
+* Overrides response compression for a handler or a whole controller.
+*
+* Calls `useResponse().setCompression(value)` before guards, argument resolution and the
+* handler run, so the override also applies to error responses (401, 400, …).
+* A method-level `@Compress` wins over a class-level one.
+*
+* - `true` (default) — compress with the app settings (`new MoostHttp({ compression })`),
+*   or the defaults when the app has compression off.
+* - `false` — never compress this response (e.g. a body that mixes a secret with
+*   reflected input — see BREACH).
+* - options object — compress with these settings layered over the app settings.
+*
+* ```ts
+* import { Compress, Get } from '@moostjs/event-http'
+* import { Controller } from 'moost'
+*
+* @Controller()
+* export class ReportsController {
+*   @Get('report')
+*   @Compress({ brotliQuality: 6 })
+*   report() {
+*     return buildReport()
+*   }
+*
+*   @Get('session')
+*   @Compress(false)
+*   session() {
+*     return { token, echo: query }
+*   }
+* }
+* ```
+*
+* @param value compression override, defaults to `true`
+*/ const Compress = (value = true) => (0, moost.Intercept)((0, moost.defineBeforeInterceptor)(() => {
+	(0, _wooksjs_event_http.useResponse)().setCompression(value);
+}, moost.TInterceptorPriority.BEFORE_ALL));
+
 //#endregion
 //#region packages/event-http/src/event-http.ts
 function _define_property(obj, key, value) {
@@ -754,7 +794,7 @@ const LOGGER_TITLE = "moost-http";
 			image: "https://moost.org/moost-full-logo.svg",
 			link: "https://moost.org/",
 			poweredBy: "moostjs",
-			version: "0.6.48"
+			version: "0.6.49"
 		});
 		if (httpApp && httpApp instanceof _wooksjs_event_http.WooksHttp) this.httpApp = httpApp;
 		else if (httpApp) this.httpApp = (0, _wooksjs_event_http.createHttpApp)({
@@ -817,6 +857,7 @@ exports.Authorization = Authorization;
 exports.Body = Body;
 exports.BodyReadTimeoutMs = BodyReadTimeoutMs;
 exports.BodySizeLimit = BodySizeLimit;
+exports.Compress = Compress;
 exports.CompressedBodySizeLimit = CompressedBodySizeLimit;
 exports.Cookie = Cookie;
 exports.CookieAttrsRef = CookieAttrsRef;
@@ -862,6 +903,12 @@ Object.defineProperty(exports, 'httpKind', {
     return _wooksjs_event_http.httpKind;
   }
 });
+Object.defineProperty(exports, 'isCompressibleType', {
+  enumerable: true,
+  get: function () {
+    return _wooksjs_event_http.isCompressibleType;
+  }
+});
 Object.defineProperty(exports, 'prerenderJson', {
   enumerable: true,
   get: function () {

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 import * as moost from 'moost';
 import { TInterceptorPriority, TOvertakeFn, TInterceptorDef, TClassConstructor, TMoostAdapter, MOOST_ADAPTER_BRAND, TIsolatedSlot, EventContext, Moost, TConsoleBase, TMoostAdapterOptions } from 'moost';
 import * as _wooksjs_event_http from '@wooksjs/event-http';
-import { TCookieAttributes as TCookieAttributes$1, TCookieAttributesInput, WooksHttp, TWooksHttpOptions } from '@wooksjs/event-http';
-export { HttpError, TCacheControl, TCookieAttributesInput, TPrerenderJsonOptions, TSetCookieData, httpKind, prerenderJson, useHttpContext } from '@wooksjs/event-http';
+import { TCookieAttributes as TCookieAttributes$1, TCookieAttributesInput, THttpCompressionOptions, WooksHttp, TWooksHttpOptions } from '@wooksjs/event-http';
+export { HttpError, TCacheControl, TCookieAttributesInput, THttpCompressionEncoding, THttpCompressionOptions, TPrerenderJsonOptions, TSetCookieData, httpKind, isCompressibleType, prerenderJson, useHttpContext } from '@wooksjs/event-http';
 import { IncomingMessage, ServerResponse } from 'http';
 import { Buffer } from 'buffer';
 import { ListenOptions } from 'net';
@@ -366,6 +366,43 @@ declare const CompressedBodySizeLimit: (n: number) => ClassDecorator & MethodDec
  */
 declare const BodyReadTimeoutMs: (n: number) => ClassDecorator & MethodDecorator;
 
+/**
+ * Overrides response compression for a handler or a whole controller.
+ *
+ * Calls `useResponse().setCompression(value)` before guards, argument resolution and the
+ * handler run, so the override also applies to error responses (401, 400, …).
+ * A method-level `@Compress` wins over a class-level one.
+ *
+ * - `true` (default) — compress with the app settings (`new MoostHttp({ compression })`),
+ *   or the defaults when the app has compression off.
+ * - `false` — never compress this response (e.g. a body that mixes a secret with
+ *   reflected input — see BREACH).
+ * - options object — compress with these settings layered over the app settings.
+ *
+ * ```ts
+ * import { Compress, Get } from '@moostjs/event-http'
+ * import { Controller } from 'moost'
+ *
+ * @Controller()
+ * export class ReportsController {
+ *   @Get('report')
+ *   @Compress({ brotliQuality: 6 })
+ *   report() {
+ *     return buildReport()
+ *   }
+ *
+ *   @Get('session')
+ *   @Compress(false)
+ *   session() {
+ *     return { token, echo: query }
+ *   }
+ * }
+ * ```
+ *
+ * @param value compression override, defaults to `true`
+ */
+declare const Compress: (value?: boolean | THttpCompressionOptions) => ClassDecorator & MethodDecorator;
+
 type TPathBuilder<ParamsType = Record<string, string | string[]>> = (params?: ParamsType) => string;
 /** Handler metadata for HTTP events, carrying the HTTP method and route path. */
 interface THttpHandlerMeta {
@@ -526,5 +563,5 @@ declare class MoostHttp implements TMoostAdapter<THttpHandlerMeta> {
  */
 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 { All, AuthGuard, Authenticate, Authorization, Body, BodyReadTimeoutMs, BodySizeLimit, Compress, 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, TMoostHttpInvokeOptions, TStatusRef };

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { current } from "@wooksjs/event-core";
-import { HttpError, HttpError as HttpError$1, WooksHttp, WooksHttpResponse, createHttpApp, httpKind, httpKind as httpKind$1, prerenderJson, useAuthorization, useCookies, useHeaders, useHttpContext, useRequest, useResponse, useUrlParams } from "@wooksjs/event-http";
+import { HttpError, HttpError as HttpError$1, WooksHttp, WooksHttpResponse, createHttpApp, httpKind, httpKind as httpKind$1, isCompressibleType, prerenderJson, useAuthorization, useCookies, useHeaders, useHttpContext, useRequest, useResponse, useUrlParams } from "@wooksjs/event-http";
 import { Before, Intercept, Interceptor, MOOST_ADAPTER_BRAND, Overtake, Resolve, TInterceptorPriority, current as current$1, defineBeforeInterceptor, defineMoostEventHandler, forkEventContext, getMoostMate, globalKey, run } from "moost";
 import { seedBody, useBody } from "@wooksjs/http-body";
 import { createProvideRegistry } from "@prostojs/infact";
@@ -527,6 +527,46 @@ const setStatusInterceptor = (code, opts) => ({
 * @param n - Timeout duration in milliseconds.
 */ const BodyReadTimeoutMs = (n) => Intercept(globalBodyReadTimeoutMs(n));
 
+//#endregion
+//#region packages/event-http/src/decorators/compress.decorator.ts
+/**
+* Overrides response compression for a handler or a whole controller.
+*
+* Calls `useResponse().setCompression(value)` before guards, argument resolution and the
+* handler run, so the override also applies to error responses (401, 400, …).
+* A method-level `@Compress` wins over a class-level one.
+*
+* - `true` (default) — compress with the app settings (`new MoostHttp({ compression })`),
+*   or the defaults when the app has compression off.
+* - `false` — never compress this response (e.g. a body that mixes a secret with
+*   reflected input — see BREACH).
+* - options object — compress with these settings layered over the app settings.
+*
+* ```ts
+* import { Compress, Get } from '@moostjs/event-http'
+* import { Controller } from 'moost'
+*
+* @Controller()
+* export class ReportsController {
+*   @Get('report')
+*   @Compress({ brotliQuality: 6 })
+*   report() {
+*     return buildReport()
+*   }
+*
+*   @Get('session')
+*   @Compress(false)
+*   session() {
+*     return { token, echo: query }
+*   }
+* }
+* ```
+*
+* @param value compression override, defaults to `true`
+*/ const Compress = (value = true) => Intercept(defineBeforeInterceptor(() => {
+	useResponse().setCompression(value);
+}, TInterceptorPriority.BEFORE_ALL));
+
 //#endregion
 //#region packages/event-http/src/event-http.ts
 function _define_property(obj, key, value) {
@@ -753,7 +793,7 @@ const LOGGER_TITLE = "moost-http";
 			image: "https://moost.org/moost-full-logo.svg",
 			link: "https://moost.org/",
 			poweredBy: "moostjs",
-			version: "0.6.48"
+			version: "0.6.49"
 		});
 		if (httpApp && httpApp instanceof WooksHttp) this.httpApp = httpApp;
 		else if (httpApp) this.httpApp = createHttpApp({
@@ -804,4 +844,4 @@ function isLocalOrigin(url) {
 }
 
 //#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, prerenderJson, useHttpContext };
+export { All, AuthGuard, Authenticate, Authorization, Body, BodyReadTimeoutMs, BodySizeLimit, Compress, 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, isCompressibleType, prerenderJson, useHttpContext };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moostjs/event-http",
-  "version": "0.6.48",
+  "version": "0.6.49",
   "description": "@moostjs/event-http",
   "keywords": [
     "composables",
@@ -38,16 +38,16 @@
     }
   },
   "dependencies": {
-    "@wooksjs/event-http": "^0.7.27",
-    "@wooksjs/http-body": "^0.7.27"
+    "@wooksjs/event-http": "^0.7.28",
+    "@wooksjs/http-body": "^0.7.28"
   },
   "devDependencies": {
     "vitest": "3.2.7"
   },
   "peerDependencies": {
     "@prostojs/infact": "^0.6.1",
-    "@wooksjs/event-core": "^0.7.27",
-    "moost": "^0.6.48"
+    "@wooksjs/event-core": "^0.7.28",
+    "moost": "^0.6.49"
   },
   "scripts": {
     "pub": "pnpm publish --access public",