@morojs/moro 1.8.12 → 1.8.14

package/dist/core/middleware/built-in/body-parsers/index.d.ts

@@ -17,3 +17,21 @@ export declare function urlencoded(_options?: {
     extended?: boolean;
     limit?: number | string;
 }): Middleware;
+/**
+ * Raw body-parser middleware (Express `raw()` idiom). MoroJS already keeps
+ * binary bodies as Buffers, so this only converts a body that was decoded to
+ * a string back to its exact bytes for the matching content types (default
+ * `application/octet-stream`). `req.rawBody` is always available regardless.
+ */
+export declare function raw(options?: {
+    type?: string | string[];
+    limit?: number | string;
+}): Middleware;
+/**
+ * Text body-parser middleware (Express `text()` idiom): decodes a Buffer body
+ * to a UTF-8 string for the matching content types (default `text/plain`).
+ */
+export declare function text(options?: {
+    type?: string | string[];
+    limit?: number | string;
+}): Middleware;

package/dist/core/middleware/built-in/body-parsers/index.js

@@ -35,4 +35,45 @@ export function urlencoded(_options) {
         next();
     };
 }
+function typeMatches(contentType, wanted) {
+    const ct = contentType.toLowerCase().split(';')[0]?.trim() ?? '';
+    for (const t of Array.isArray(wanted) ? wanted : [wanted]) {
+        const w = t.toLowerCase();
+        if (w === '*/*' || w === ct)
+            return true;
+        if (w.endsWith('/*') && ct.startsWith(w.slice(0, -1)))
+            return true;
+    }
+    return false;
+}
+/**
+ * Raw body-parser middleware (Express `raw()` idiom). MoroJS already keeps
+ * binary bodies as Buffers, so this only converts a body that was decoded to
+ * a string back to its exact bytes for the matching content types (default
+ * `application/octet-stream`). `req.rawBody` is always available regardless.
+ */
+export function raw(options) {
+    const wanted = options?.type ?? 'application/octet-stream';
+    return function moroRawBodyParser(req, _res, next) {
+        const ct = (req.headers['content-type'] || '');
+        if (typeof req.body === 'string' && typeMatches(ct, wanted)) {
+            req.body = req.rawBody ?? Buffer.from(req.body, 'utf8');
+        }
+        next();
+    };
+}
+/**
+ * Text body-parser middleware (Express `text()` idiom): decodes a Buffer body
+ * to a UTF-8 string for the matching content types (default `text/plain`).
+ */
+export function text(options) {
+    const wanted = options?.type ?? 'text/plain';
+    return function moroTextBodyParser(req, _res, next) {
+        const ct = (req.headers['content-type'] || '');
+        if (Buffer.isBuffer(req.body) && typeMatches(ct, wanted)) {
+            req.body = req.body.toString('utf8');
+        }
+        next();
+    };
+}
 //# sourceMappingURL=index.js.map

package/dist/core/middleware/built-in/body-parsers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/middleware/built-in/body-parsers/index.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,IAAI,CAAC,QAAwD;IAC3E,OAAO,SAAS,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI;QACjD,IAAI,EAAE,CAAC;IACT,CAAC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,QAA0D;IACnF,OAAO,SAAS,wBAAwB,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI;QACtD,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,EAAE,CAAW,CAAC;QACzD,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,mCAAmC,CAAC,EAAE,CAAC;YACtE,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC;QACD,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACjC,MAAM,MAAM,GAA2B,EAAE,CAAC;YAC1C,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAClC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,CAAC,IAAI;oBAAE,SAAS;gBACpB,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBAC7B,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACnD,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;gBAClD,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,kBAAkB,CACpE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CACtB,CAAC;YACJ,CAAC;YACD,GAAG,CAAC,IAAI,GAAG,MAAM,CAAC;QACpB,CAAC;QACD,IAAI,EAAE,CAAC;IACT,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import type { Middleware } from '../../../../types/http.js';\n\n/**\n * JSON body-parser middleware. MoroJS auto-parses JSON bodies on POST/PUT/PATCH\n * requests upstream, so this middleware is effectively a pass-through. It exists\n * so code written in the `app.use(json())` idiom works verbatim without rewrites.\n */\nexport function json(_options?: { limit?: number | string; strict?: boolean }): Middleware {\n  return function moroJsonBodyParser(_req, _res, next) {\n    next();\n  };\n}\n\n/**\n * URL-encoded body-parser middleware. Parses `application/x-www-form-urlencoded`\n * request bodies when the automatic parser left them as strings, populating\n * `req.body` with the decoded object.\n */\nexport function urlencoded(_options?: { extended?: boolean; limit?: number | string }): Middleware {\n  return function moroUrlencodedBodyParser(req, _res, next) {\n    const ct = (req.headers['content-type'] || '') as string;\n    if (!ct.toLowerCase().startsWith('application/x-www-form-urlencoded')) {\n      return next();\n    }\n    if (typeof req.body === 'string') {\n      const parsed: Record<string, string> = {};\n      const pairs = req.body.split('&');\n      for (const pair of pairs) {\n        if (!pair) continue;\n        const eq = pair.indexOf('=');\n        const k = eq === -1 ? pair : pair.substring(0, eq);\n        const v = eq === -1 ? '' : pair.substring(eq + 1);\n        parsed[decodeURIComponent(k.replace(/\\+/g, ' '))] = decodeURIComponent(\n          v.replace(/\\+/g, ' ')\n        );\n      }\n      req.body = parsed;\n    }\n    next();\n  };\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/middleware/built-in/body-parsers/index.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,IAAI,CAAC,QAAwD;IAC3E,OAAO,SAAS,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI;QACjD,IAAI,EAAE,CAAC;IACT,CAAC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,QAA0D;IACnF,OAAO,SAAS,wBAAwB,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI;QACtD,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,EAAE,CAAW,CAAC;QACzD,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,mCAAmC,CAAC,EAAE,CAAC;YACtE,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC;QACD,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACjC,MAAM,MAAM,GAA2B,EAAE,CAAC;YAC1C,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAClC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,CAAC,IAAI;oBAAE,SAAS;gBACpB,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBAC7B,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACnD,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;gBAClD,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,kBAAkB,CACpE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CACtB,CAAC;YACJ,CAAC;YACD,GAAG,CAAC,IAAI,GAAG,MAAM,CAAC;QACpB,CAAC;QACD,IAAI,EAAE,CAAC;IACT,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,WAAmB,EAAE,MAAyB;IACjE,MAAM,EAAE,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACjE,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1D,MAAM,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QAC1B,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,EAAE;YAAE,OAAO,IAAI,CAAC;QACzC,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;IACrE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,GAAG,CAAC,OAA+D;IACjF,MAAM,MAAM,GAAG,OAAO,EAAE,IAAI,IAAI,0BAA0B,CAAC;IAC3D,OAAO,SAAS,iBAAiB,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI;QAC/C,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,EAAE,CAAW,CAAC;QACzD,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,WAAW,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC;YAC5D,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,EAAE,CAAC;IACT,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,IAAI,CAAC,OAA+D;IAClF,MAAM,MAAM,GAAG,OAAO,EAAE,IAAI,IAAI,YAAY,CAAC;IAC7C,OAAO,SAAS,kBAAkB,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI;QAChD,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,EAAE,CAAW,CAAC;QACzD,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC;YACzD,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACvC,CAAC;QACD,IAAI,EAAE,CAAC;IACT,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import type { Middleware } from '../../../../types/http.js';\n\n/**\n * JSON body-parser middleware. MoroJS auto-parses JSON bodies on POST/PUT/PATCH\n * requests upstream, so this middleware is effectively a pass-through. It exists\n * so code written in the `app.use(json())` idiom works verbatim without rewrites.\n */\nexport function json(_options?: { limit?: number | string; strict?: boolean }): Middleware {\n  return function moroJsonBodyParser(_req, _res, next) {\n    next();\n  };\n}\n\n/**\n * URL-encoded body-parser middleware. Parses `application/x-www-form-urlencoded`\n * request bodies when the automatic parser left them as strings, populating\n * `req.body` with the decoded object.\n */\nexport function urlencoded(_options?: { extended?: boolean; limit?: number | string }): Middleware {\n  return function moroUrlencodedBodyParser(req, _res, next) {\n    const ct = (req.headers['content-type'] || '') as string;\n    if (!ct.toLowerCase().startsWith('application/x-www-form-urlencoded')) {\n      return next();\n    }\n    if (typeof req.body === 'string') {\n      const parsed: Record<string, string> = {};\n      const pairs = req.body.split('&');\n      for (const pair of pairs) {\n        if (!pair) continue;\n        const eq = pair.indexOf('=');\n        const k = eq === -1 ? pair : pair.substring(0, eq);\n        const v = eq === -1 ? '' : pair.substring(eq + 1);\n        parsed[decodeURIComponent(k.replace(/\\+/g, ' '))] = decodeURIComponent(\n          v.replace(/\\+/g, ' ')\n        );\n      }\n      req.body = parsed;\n    }\n    next();\n  };\n}\n\nfunction typeMatches(contentType: string, wanted: string | string[]): boolean {\n  const ct = contentType.toLowerCase().split(';')[0]?.trim() ?? '';\n  for (const t of Array.isArray(wanted) ? wanted : [wanted]) {\n    const w = t.toLowerCase();\n    if (w === '*/*' || w === ct) return true;\n    if (w.endsWith('/*') && ct.startsWith(w.slice(0, -1))) return true;\n  }\n  return false;\n}\n\n/**\n * Raw body-parser middleware (Express `raw()` idiom). MoroJS already keeps\n * binary bodies as Buffers, so this only converts a body that was decoded to\n * a string back to its exact bytes for the matching content types (default\n * `application/octet-stream`). `req.rawBody` is always available regardless.\n */\nexport function raw(options?: { type?: string | string[]; limit?: number | string }): Middleware {\n  const wanted = options?.type ?? 'application/octet-stream';\n  return function moroRawBodyParser(req, _res, next) {\n    const ct = (req.headers['content-type'] || '') as string;\n    if (typeof req.body === 'string' && typeMatches(ct, wanted)) {\n      req.body = req.rawBody ?? Buffer.from(req.body, 'utf8');\n    }\n    next();\n  };\n}\n\n/**\n * Text body-parser middleware (Express `text()` idiom): decodes a Buffer body\n * to a UTF-8 string for the matching content types (default `text/plain`).\n */\nexport function text(options?: { type?: string | string[]; limit?: number | string }): Middleware {\n  const wanted = options?.type ?? 'text/plain';\n  return function moroTextBodyParser(req, _res, next) {\n    const ct = (req.headers['content-type'] || '') as string;\n    if (Buffer.isBuffer(req.body) && typeMatches(ct, wanted)) {\n      req.body = req.body.toString('utf8');\n    }\n    next();\n  };\n}\n"]}

package/dist/core/middleware/built-in/cache/adapters/cache/redis.d.ts

@@ -1,19 +1,43 @@
 import { CacheAdapter } from '../../../../../../types/cache.js';
+export interface RedisCacheOptions {
+    /** redis[s]://[[user][:password]@]host[:port][/db] - wins over host/port */
+    url?: string;
+    host?: string;
+    port?: number;
+    password?: string;
+    db?: number;
+    /** Prepended to every key (default 'moro:cache:'); clear() only touches prefixed keys */
+    keyPrefix?: string;
+    /** An existing node-redis client; the adapter connects it if it is not open */
+    client?: any;
+}
 export declare class RedisCacheAdapter implements CacheAdapter {
     private client;
-    constructor(options?: {
-        host?: string;
-        port?: number;
-        password?: string;
-        db?: number;
-        keyPrefix?: string;
-    });
-    private initPromise;
+    private readonly keyPrefix;
+    private readonly ready;
+    private initError;
+    /** True when the adapter created the client and therefore owns its lifetime */
+    private ownsClient;
+    constructor(options?: RedisCacheOptions);
     private initialize;
+    /** Resolves to the connected client, or throws the initialization error. */
+    private connected;
+    private key;
     get(key: string): Promise<any>;
     set(key: string, value: any, ttl?: number): Promise<void>;
     del(key: string): Promise<void>;
+    /**
+     * Remove this adapter's keys. With a prefix that is a SCAN over
+     * `<prefix>*` (a shared Redis is not flushed wholesale); with an empty
+     * prefix every key is this adapter's and FLUSHDB is the cheap equivalent.
+     */
     clear(): Promise<void>;
     exists(key: string): Promise<boolean>;
     ttl(key: string): Promise<number>;
+    /**
+     * Close the connection. A client the adapter created is quit (it would
+     * otherwise keep the process alive); a caller-supplied client belongs to
+     * its owner and is left open. Later calls answer as misses.
+     */
+    close(): Promise<void>;
 }

package/dist/core/middleware/built-in/cache/adapters/cache/redis.js

@@ -3,34 +3,73 @@ import { resolveUserPackage } from '../../../../../utilities/package-utils.js';
 const logger = createFrameworkLogger('RedisCacheAdapter');
 export class RedisCacheAdapter {
     client;
+    keyPrefix;
+    ready;
+    initError = null;
+    /** True when the adapter created the client and therefore owns its lifetime */
+    ownsClient = false;
     constructor(options = {}) {
-        this.initPromise = this.initialize(options);
+        this.keyPrefix = options.keyPrefix ?? 'moro:cache:';
+        // The failure is kept and rethrown per call (each method logs and returns
+        // its miss value); it must not surface as an unhandled rejection here.
+        this.ready = this.initialize(options).catch((err) => {
+            this.initError = err instanceof Error ? err : new Error(String(err));
+            logger.error('Redis cache adapter failed to initialize', 'RedisCache', {
+                error: this.initError.message,
+            });
+        });
     }
-    initPromise;
     async initialize(options) {
-        try {
-            const redisPath = resolveUserPackage('redis');
-            const redis = await import(redisPath);
-            this.client = redis.default.createClient({
-                host: options.host || 'localhost',
-                port: options.port || 6379,
-                password: options.password,
-                db: options.db || 0,
-                key_prefix: options.keyPrefix || 'moro:cache:',
-            });
-            this.client.on('error', (err) => {
+        let client = options.client;
+        if (!client) {
+            this.ownsClient = true;
+            let redis;
+            try {
+                redis = await import(resolveUserPackage('redis'));
+            }
+            catch {
+                throw new Error('Redis package not installed. Run: npm install redis');
+            }
+            const createClient = redis.createClient ?? redis.default?.createClient;
+            if (typeof createClient !== 'function') {
+                throw new Error('The installed "redis" package does not export createClient (node-redis 4+ required)');
+            }
+            client = options.url
+                ? createClient({ url: options.url })
+                : createClient({
+                    socket: { host: options.host || 'localhost', port: options.port || 6379 },
+                    ...(options.password !== undefined && { password: options.password }),
+                    ...(options.db !== undefined && { database: options.db }),
+                });
+        }
+        // Never let the client's own error events crash the process
+        if (typeof client.on === 'function') {
+            client.on('error', (err) => {
                 logger.error('Redis cache error', 'RedisCache', { error: err.message });
             });
-            logger.info('Redis cache adapter initialized', 'RedisCache');
         }
-        catch {
-            logger.error('Redis not available, falling back to memory cache', 'RedisCache');
-            throw new Error('Redis package not installed. Run: npm install redis');
+        // node-redis 4+ needs an explicit connect(); a caller-supplied client may
+        // already be open (isOpen), and an ioredis-style client has no isOpen at all
+        if (typeof client.connect === 'function' && client.isOpen === false) {
+            await client.connect();
         }
+        this.client = client;
+        logger.info('Redis cache adapter initialized', 'RedisCache');
+    }
+    /** Resolves to the connected client, or throws the initialization error. */
+    async connected() {
+        await this.ready;
+        if (this.initError)
+            throw this.initError;
+        return this.client;
+    }
+    key(key) {
+        return this.keyPrefix + key;
     }
     async get(key) {
         try {
-            const value = await this.client.get(key);
+            const client = await this.connected();
+            const value = await client.get(this.key(key));
             return value ? JSON.parse(value) : null;
         }
         catch (error) {
@@ -40,12 +79,14 @@ export class RedisCacheAdapter {
     }
     async set(key, value, ttl = 3600) {
         try {
+            const client = await this.connected();
             const serialized = JSON.stringify(value);
             if (ttl > 0) {
-                await this.client.setex(key, ttl, serialized);
+                // PX keeps sub-second TTLs (EX rounds to whole seconds and rejects 0)
+                await client.set(this.key(key), serialized, { PX: Math.max(1, Math.round(ttl * 1000)) });
             }
             else {
-                await this.client.set(key, serialized);
+                await client.set(this.key(key), serialized);
             }
             logger.debug(`Cached item in Redis: ${key} (TTL: ${ttl}s)`, 'RedisCache');
         }
@@ -55,16 +96,43 @@ export class RedisCacheAdapter {
     }
     async del(key) {
         try {
-            await this.client.del(key);
+            const client = await this.connected();
+            await client.del(this.key(key));
             logger.debug(`Deleted Redis cache item: ${key}`, 'RedisCache');
         }
         catch (error) {
             logger.error('Redis del error', 'RedisCache', { key, error });
         }
     }
+    /**
+     * Remove this adapter's keys. With a prefix that is a SCAN over
+     * `<prefix>*` (a shared Redis is not flushed wholesale); with an empty
+     * prefix every key is this adapter's and FLUSHDB is the cheap equivalent.
+     */
     async clear() {
         try {
-            await this.client.flushdb();
+            const client = await this.connected();
+            if (!this.keyPrefix) {
+                await (client.flushDb ?? client.flushdb).call(client);
+            }
+            else {
+                const batch = [];
+                const flush = async () => {
+                    if (batch.length === 0)
+                        return;
+                    await client.del(batch.splice(0, batch.length));
+                };
+                for await (const item of client.scanIterator({ MATCH: `${this.keyPrefix}*`, COUNT: 500 })) {
+                    // node-redis 4 yields one key per iteration, 5 yields a page of keys
+                    if (Array.isArray(item))
+                        batch.push(...item);
+                    else
+                        batch.push(item);
+                    if (batch.length >= 500)
+                        await flush();
+                }
+                await flush();
+            }
             logger.debug('Cleared all Redis cache items', 'RedisCache');
         }
         catch (error) {
@@ -73,8 +141,9 @@ export class RedisCacheAdapter {
     }
     async exists(key) {
         try {
-            const exists = await this.client.exists(key);
-            return exists === 1;
+            const client = await this.connected();
+            const count = await client.exists(this.key(key));
+            return Number(count) > 0;
         }
         catch (error) {
             logger.error('Redis exists error', 'RedisCache', { key, error });
@@ -83,12 +152,35 @@ export class RedisCacheAdapter {
     }
     async ttl(key) {
         try {
-            return await this.client.ttl(key);
+            const client = await this.connected();
+            return await client.ttl(this.key(key));
         }
         catch (error) {
             logger.error('Redis TTL error', 'RedisCache', { key, error });
             return -1;
         }
     }
+    /**
+     * Close the connection. A client the adapter created is quit (it would
+     * otherwise keep the process alive); a caller-supplied client belongs to
+     * its owner and is left open. Later calls answer as misses.
+     */
+    async close() {
+        await this.ready;
+        const client = this.client;
+        this.client = null;
+        this.initError = new Error('Redis cache adapter is closed');
+        if (!client || !this.ownsClient)
+            return;
+        try {
+            if (typeof client.quit === 'function')
+                await client.quit();
+            else if (typeof client.disconnect === 'function')
+                await client.disconnect();
+        }
+        catch (error) {
+            logger.error('Redis close error', 'RedisCache', { error });
+        }
+    }
 }
 //# sourceMappingURL=redis.js.map

package/dist/core/middleware/built-in/cache/adapters/cache/redis.js.map

@@ -1 +1 @@
-{"version":3,"file":"redis.js","sourceRoot":"","sources":["../../../../../../../src/core/middleware/built-in/cache/adapters/cache/redis.ts"],"names":[],"mappings":"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","sourcesContent":["// Redis Cache Adapter\nimport { CacheAdapter } from '../../../../../../types/cache.js';\nimport { createFrameworkLogger } from '../../../../../logger/index.js';\nimport { resolveUserPackage } from '../../../../../utilities/package-utils.js';\n\nconst logger = createFrameworkLogger('RedisCacheAdapter');\n\nexport class RedisCacheAdapter implements CacheAdapter {\n  private client: any;\n\n  constructor(\n    options: {\n      host?: string;\n      port?: number;\n      password?: string;\n      db?: number;\n      keyPrefix?: string;\n    } = {}\n  ) {\n    this.initPromise = this.initialize(options);\n  }\n\n  private initPromise: Promise<void>;\n\n  private async initialize(options: {\n    host?: string;\n    port?: number;\n    password?: string;\n    db?: number;\n    keyPrefix?: string;\n  }): Promise<void> {\n    try {\n      const redisPath = resolveUserPackage('redis');\n      const redis = await import(redisPath);\n      this.client = redis.default.createClient({\n        host: options.host || 'localhost',\n        port: options.port || 6379,\n        password: options.password,\n        db: options.db || 0,\n        key_prefix: options.keyPrefix || 'moro:cache:',\n      });\n\n      this.client.on('error', (err: Error) => {\n        logger.error('Redis cache error', 'RedisCache', { error: err.message });\n      });\n\n      logger.info('Redis cache adapter initialized', 'RedisCache');\n    } catch {\n      logger.error('Redis not available, falling back to memory cache', 'RedisCache');\n      throw new Error('Redis package not installed. Run: npm install redis');\n    }\n  }\n\n  async get(key: string): Promise<any> {\n    try {\n      const value = await this.client.get(key);\n      return value ? JSON.parse(value) : null;\n    } catch (error) {\n      logger.error('Redis get error', 'RedisCache', { key, error });\n      return null;\n    }\n  }\n\n  async set(key: string, value: any, ttl: number = 3600): Promise<void> {\n    try {\n      const serialized = JSON.stringify(value);\n      if (ttl > 0) {\n        await this.client.setex(key, ttl, serialized);\n      } else {\n        await this.client.set(key, serialized);\n      }\n      logger.debug(`Cached item in Redis: ${key} (TTL: ${ttl}s)`, 'RedisCache');\n    } catch (error) {\n      logger.error('Redis set error', 'RedisCache', { key, error });\n    }\n  }\n\n  async del(key: string): Promise<void> {\n    try {\n      await this.client.del(key);\n      logger.debug(`Deleted Redis cache item: ${key}`, 'RedisCache');\n    } catch (error) {\n      logger.error('Redis del error', 'RedisCache', { key, error });\n    }\n  }\n\n  async clear(): Promise<void> {\n    try {\n      await this.client.flushdb();\n      logger.debug('Cleared all Redis cache items', 'RedisCache');\n    } catch (error) {\n      logger.error('Redis clear error', 'RedisCache', { error });\n    }\n  }\n\n  async exists(key: string): Promise<boolean> {\n    try {\n      const exists = await this.client.exists(key);\n      return exists === 1;\n    } catch (error) {\n      logger.error('Redis exists error', 'RedisCache', { key, error });\n      return false;\n    }\n  }\n\n  async ttl(key: string): Promise<number> {\n    try {\n      return await this.client.ttl(key);\n    } catch (error) {\n      logger.error('Redis TTL error', 'RedisCache', { key, error });\n      return -1;\n    }\n  }\n}\n"]}
+{"version":3,"file":"redis.js","sourceRoot":"","sources":["../../../../../../../src/core/middleware/built-in/cache/adapters/cache/redis.ts"],"names":[],"mappings":"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","sourcesContent":["// Redis Cache Adapter (node-redis 4+)\n//\n// Targets the node-redis v4/v5 API: createClient({ url } | { socket }),\n// an explicit connect(), and the SET ... PX form for TTLs. Every command\n// awaits the connection first, so a call issued right after construction\n// waits for the import + connect instead of racing them.\nimport { CacheAdapter } from '../../../../../../types/cache.js';\nimport { createFrameworkLogger } from '../../../../../logger/index.js';\nimport { resolveUserPackage } from '../../../../../utilities/package-utils.js';\n\nconst logger = createFrameworkLogger('RedisCacheAdapter');\n\nexport interface RedisCacheOptions {\n  /** redis[s]://[[user][:password]@]host[:port][/db] - wins over host/port */\n  url?: string;\n  host?: string;\n  port?: number;\n  password?: string;\n  db?: number;\n  /** Prepended to every key (default 'moro:cache:'); clear() only touches prefixed keys */\n  keyPrefix?: string;\n  /** An existing node-redis client; the adapter connects it if it is not open */\n  client?: any;\n}\n\nexport class RedisCacheAdapter implements CacheAdapter {\n  private client: any;\n  private readonly keyPrefix: string;\n  private readonly ready: Promise<void>;\n  private initError: Error | null = null;\n  /** True when the adapter created the client and therefore owns its lifetime */\n  private ownsClient = false;\n\n  constructor(options: RedisCacheOptions = {}) {\n    this.keyPrefix = options.keyPrefix ?? 'moro:cache:';\n    // The failure is kept and rethrown per call (each method logs and returns\n    // its miss value); it must not surface as an unhandled rejection here.\n    this.ready = this.initialize(options).catch((err: unknown) => {\n      this.initError = err instanceof Error ? err : new Error(String(err));\n      logger.error('Redis cache adapter failed to initialize', 'RedisCache', {\n        error: this.initError.message,\n      });\n    });\n  }\n\n  private async initialize(options: RedisCacheOptions): Promise<void> {\n    let client = options.client;\n    if (!client) {\n      this.ownsClient = true;\n      let redis: any;\n      try {\n        redis = await import(resolveUserPackage('redis'));\n      } catch {\n        throw new Error('Redis package not installed. Run: npm install redis');\n      }\n      const createClient = redis.createClient ?? redis.default?.createClient;\n      if (typeof createClient !== 'function') {\n        throw new Error(\n          'The installed \"redis\" package does not export createClient (node-redis 4+ required)'\n        );\n      }\n      client = options.url\n        ? createClient({ url: options.url })\n        : createClient({\n            socket: { host: options.host || 'localhost', port: options.port || 6379 },\n            ...(options.password !== undefined && { password: options.password }),\n            ...(options.db !== undefined && { database: options.db }),\n          });\n    }\n\n    // Never let the client's own error events crash the process\n    if (typeof client.on === 'function') {\n      client.on('error', (err: Error) => {\n        logger.error('Redis cache error', 'RedisCache', { error: err.message });\n      });\n    }\n    // node-redis 4+ needs an explicit connect(); a caller-supplied client may\n    // already be open (isOpen), and an ioredis-style client has no isOpen at all\n    if (typeof client.connect === 'function' && client.isOpen === false) {\n      await client.connect();\n    }\n\n    this.client = client;\n    logger.info('Redis cache adapter initialized', 'RedisCache');\n  }\n\n  /** Resolves to the connected client, or throws the initialization error. */\n  private async connected(): Promise<any> {\n    await this.ready;\n    if (this.initError) throw this.initError;\n    return this.client;\n  }\n\n  private key(key: string): string {\n    return this.keyPrefix + key;\n  }\n\n  async get(key: string): Promise<any> {\n    try {\n      const client = await this.connected();\n      const value = await client.get(this.key(key));\n      return value ? JSON.parse(value) : null;\n    } catch (error) {\n      logger.error('Redis get error', 'RedisCache', { key, error });\n      return null;\n    }\n  }\n\n  async set(key: string, value: any, ttl: number = 3600): Promise<void> {\n    try {\n      const client = await this.connected();\n      const serialized = JSON.stringify(value);\n      if (ttl > 0) {\n        // PX keeps sub-second TTLs (EX rounds to whole seconds and rejects 0)\n        await client.set(this.key(key), serialized, { PX: Math.max(1, Math.round(ttl * 1000)) });\n      } else {\n        await client.set(this.key(key), serialized);\n      }\n      logger.debug(`Cached item in Redis: ${key} (TTL: ${ttl}s)`, 'RedisCache');\n    } catch (error) {\n      logger.error('Redis set error', 'RedisCache', { key, error });\n    }\n  }\n\n  async del(key: string): Promise<void> {\n    try {\n      const client = await this.connected();\n      await client.del(this.key(key));\n      logger.debug(`Deleted Redis cache item: ${key}`, 'RedisCache');\n    } catch (error) {\n      logger.error('Redis del error', 'RedisCache', { key, error });\n    }\n  }\n\n  /**\n   * Remove this adapter's keys. With a prefix that is a SCAN over\n   * `<prefix>*` (a shared Redis is not flushed wholesale); with an empty\n   * prefix every key is this adapter's and FLUSHDB is the cheap equivalent.\n   */\n  async clear(): Promise<void> {\n    try {\n      const client = await this.connected();\n      if (!this.keyPrefix) {\n        await (client.flushDb ?? client.flushdb).call(client);\n      } else {\n        const batch: string[] = [];\n        const flush = async () => {\n          if (batch.length === 0) return;\n          await client.del(batch.splice(0, batch.length));\n        };\n        for await (const item of client.scanIterator({ MATCH: `${this.keyPrefix}*`, COUNT: 500 })) {\n          // node-redis 4 yields one key per iteration, 5 yields a page of keys\n          if (Array.isArray(item)) batch.push(...item);\n          else batch.push(item);\n          if (batch.length >= 500) await flush();\n        }\n        await flush();\n      }\n      logger.debug('Cleared all Redis cache items', 'RedisCache');\n    } catch (error) {\n      logger.error('Redis clear error', 'RedisCache', { error });\n    }\n  }\n\n  async exists(key: string): Promise<boolean> {\n    try {\n      const client = await this.connected();\n      const count = await client.exists(this.key(key));\n      return Number(count) > 0;\n    } catch (error) {\n      logger.error('Redis exists error', 'RedisCache', { key, error });\n      return false;\n    }\n  }\n\n  async ttl(key: string): Promise<number> {\n    try {\n      const client = await this.connected();\n      return await client.ttl(this.key(key));\n    } catch (error) {\n      logger.error('Redis TTL error', 'RedisCache', { key, error });\n      return -1;\n    }\n  }\n\n  /**\n   * Close the connection. A client the adapter created is quit (it would\n   * otherwise keep the process alive); a caller-supplied client belongs to\n   * its owner and is left open. Later calls answer as misses.\n   */\n  async close(): Promise<void> {\n    await this.ready;\n    const client = this.client;\n    this.client = null;\n    this.initError = new Error('Redis cache adapter is closed');\n    if (!client || !this.ownsClient) return;\n    try {\n      if (typeof client.quit === 'function') await client.quit();\n      else if (typeof client.disconnect === 'function') await client.disconnect();\n    } catch (error) {\n      logger.error('Redis close error', 'RedisCache', { error });\n    }\n  }\n}\n"]}

package/dist/core/middleware/built-in/compression/core.d.ts

@@ -4,12 +4,19 @@ export interface CompressionOptions {
     threshold?: number;
     level?: number;
     encodings?: Encoding[];
+    /**
+     * Bodies at or below this size are compressed on the calling thread and
+     * sent with a Content-Length; larger ones go to the threadpool and stream
+     * chunked. 0 sends every body through the pool. Default 16384.
+     */
+    maxInlineBytes?: number;
     filter?: (req: HttpRequest, res: HttpResponse) => boolean;
 }
 export declare class CompressionCore {
     private threshold;
     private level;
     private encodings;
+    private maxInlineBytes;
     private filter?;
     constructor(options?: CompressionOptions);
     shouldCompress(req: HttpRequest, res: HttpResponse): boolean;

package/dist/core/middleware/built-in/compression/core.js

@@ -1,13 +1,15 @@
-import { compressBuffer, negotiateEncoding, isCompressible, DEFAULT_ENCODINGS, } from '../../../http/utils/compression.js';
+import { compressBuffer, compressBufferSync, negotiateEncoding, isCompressible, DEFAULT_ENCODINGS, DEFAULT_MAX_INLINE_BYTES, } from '../../../http/utils/compression.js';
 export class CompressionCore {
     threshold;
     level;
     encodings;
+    maxInlineBytes;
     filter;
     constructor(options = {}) {
         this.threshold = options.threshold || 1024; // 1KB default
         this.level = options.level || 6; // Default compression level
         this.encodings = options.encodings || DEFAULT_ENCODINGS;
+        this.maxInlineBytes = options.maxInlineBytes ?? DEFAULT_MAX_INLINE_BYTES;
         this.filter = options.filter;
     }
     shouldCompress(req, res) {
@@ -25,6 +27,7 @@ export class CompressionCore {
         const level = this.level;
         const threshold = this.threshold;
         const encodings = this.encodings;
+        const maxInline = this.maxInlineBytes;
         const filterOk = this.filter ? this.filter(req, res) : true;
         const compressResponse = (data, isJson, contentType) => {
             const content = isJson ? JSON.stringify(data) : data;
@@ -50,11 +53,39 @@ export class CompressionCore {
                 return originalSend.call(res, data);
             }
             const buffer = Buffer.isBuffer(content) ? content : Buffer.from(content ?? '');
+            // A small body is compressed here and now: cheaper than the round trip
+            // through the threadpool, and the response carries a Content-Length
+            // instead of streaming chunked. A failure falls back to the plain body.
+            if (maxInline > 0 && byteLength <= maxInline && !res.headersSent) {
+                let compressed;
+                try {
+                    compressed = compressBufferSync(buffer, encoding, level);
+                }
+                catch {
+                    if (isJson) {
+                        res.setHeader('Content-Length', byteLength);
+                        res.end(content);
+                        return;
+                    }
+                    return originalSend.call(res, data);
+                }
+                res.setHeader('Content-Encoding', encoding);
+                const vary = res.getHeader ? res.getHeader('vary') : undefined;
+                res.setHeader('Vary', vary ? `${vary}, Accept-Encoding` : 'Accept-Encoding');
+                res.setHeader('Content-Length', compressed.length);
+                res.end(compressed);
+                return res;
+            }
             // Commit the response headers synchronously, BEFORE the asynchronous
             // compression. This marks headersSent the moment send/json is called, so
             // the "no route matched" fallback can't 404 the response mid-compress.
             // The compressed length isn't known yet, so the body streams (chunked).
             if (!res.headersSent) {
+                // A Content-Length set for the uncompressed body would truncate (or
+                // hang) the compressed one; the compressed body streams chunked.
+                if (typeof res.removeHeader === 'function') {
+                    res.removeHeader('Content-Length');
+                }
                 res.setHeader('Content-Encoding', encoding);
                 const vary = res.getHeader ? res.getHeader('vary') : undefined;
                 res.setHeader('Vary', vary ? `${vary}, Accept-Encoding` : 'Accept-Encoding');

package/dist/core/middleware/built-in/compression/core.js.map

@@ -1 +1 @@
-{"version":3,"file":"core.js","sourceRoot":"","sources":["../../../../../src/core/middleware/built-in/compression/core.ts"],"names":[],"mappings":"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","sourcesContent":["// Compression Core Logic\n//\n// The global compression middleware wraps res.json/res.send uniformly across\n// EVERY runtime (Node, uWS, HTTP/2, engine), so it is the single source of\n// response compression parity. It delegates encoding choice and content-type\n// filtering to the shared utility (utils/compression) so brotli, q-value\n// negotiation, and the compressible-type allowlist behave identically here and\n// in the per-server fallback paths.\nimport { HttpRequest, HttpResponse } from '../../../../types/http.js';\nimport {\n  compressBuffer,\n  negotiateEncoding,\n  isCompressible,\n  DEFAULT_ENCODINGS,\n  type Encoding,\n} from '../../../http/utils/compression.js';\n\nexport interface CompressionOptions {\n  threshold?: number;\n  level?: number;\n  encodings?: Encoding[];\n  filter?: (req: HttpRequest, res: HttpResponse) => boolean;\n}\n\nexport class CompressionCore {\n  private threshold: number;\n  private level: number;\n  private encodings: Encoding[];\n  private filter?: ((req: HttpRequest, res: HttpResponse) => boolean) | undefined;\n\n  constructor(options: CompressionOptions = {}) {\n    this.threshold = options.threshold || 1024; // 1KB default\n    this.level = options.level || 6; // Default compression level\n    this.encodings = options.encodings || DEFAULT_ENCODINGS;\n    this.filter = options.filter;\n  }\n\n  shouldCompress(req: HttpRequest, res: HttpResponse): boolean {\n    // Check custom filter\n    if (this.filter && !this.filter(req, res)) {\n      return false;\n    }\n\n    // Check if client accepts any encoding we offer\n    const acceptEncoding = (req.headers['accept-encoding'] as string) || '';\n    return negotiateEncoding(acceptEncoding, this.encodings) !== null;\n  }\n\n  wrapResponse(req: HttpRequest, res: HttpResponse): void {\n    const originalSend = res.send;\n    const acceptEncoding = (req.headers['accept-encoding'] as string) || '';\n    const level = this.level;\n    const threshold = this.threshold;\n    const encodings = this.encodings;\n    const filterOk = this.filter ? this.filter(req, res) : true;\n\n    const compressResponse = (data: any, isJson: boolean, contentType?: string) => {\n      const content = isJson ? JSON.stringify(data) : data;\n      const byteLength = Buffer.isBuffer(content)\n        ? content.length\n        : Buffer.byteLength(content ?? '');\n      const ctHeader =\n        contentType ??\n        (res.getHeader ? (res.getHeader('content-type') as string | undefined) : undefined);\n      const encoding = filterOk ? negotiateEncoding(acceptEncoding, encodings) : null;\n\n      // Skip compression when: below threshold, client accepts nothing we\n      // offer, or the content type isn't worth compressing (already-compressed\n      // binary - images, video, octet-stream). For JSON we already have the\n      // serialized string; ending with it here avoids re-entering res.json,\n      // which would JSON.stringify the same data a second time.\n      if (byteLength < threshold || !encoding || !isCompressible(ctHeader)) {\n        if (isJson) {\n          if (res.headersSent) return;\n          res.setHeader('Content-Length', byteLength);\n          res.end(content);\n          return;\n        }\n        return originalSend.call(res, data);\n      }\n\n      const buffer = Buffer.isBuffer(content) ? content : Buffer.from(content ?? '');\n\n      // Commit the response headers synchronously, BEFORE the asynchronous\n      // compression. This marks headersSent the moment send/json is called, so\n      // the \"no route matched\" fallback can't 404 the response mid-compress.\n      // The compressed length isn't known yet, so the body streams (chunked).\n      if (!res.headersSent) {\n        res.setHeader('Content-Encoding', encoding);\n        const vary = res.getHeader ? (res.getHeader('vary') as string | undefined) : undefined;\n        res.setHeader('Vary', vary ? `${vary}, Accept-Encoding` : 'Accept-Encoding');\n        (res as any).writeHead((res as any).statusCode || 200);\n      }\n\n      compressBuffer(buffer, encoding, level)\n        .then(compressed => res.end(compressed))\n        .catch(() => res.end()); // headers already committed - can't fall back to raw\n\n      return res;\n    };\n\n    res.json = function (data: any) {\n      if (!this.getHeader('Content-Type')) {\n        this.setHeader('Content-Type', 'application/json; charset=utf-8');\n      }\n      compressResponse(data, true, 'application/json');\n      return this;\n    };\n\n    res.send = function (data: any) {\n      compressResponse(data, false);\n      return this;\n    };\n  }\n\n  getThreshold(): number {\n    return this.threshold;\n  }\n\n  getLevel(): number {\n    return this.level;\n  }\n}\n"]}
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../../../../src/core/middleware/built-in/compression/core.ts"],"names":[],"mappings":"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","sourcesContent":["// Compression Core Logic\n//\n// The global compression middleware wraps res.json/res.send uniformly across\n// EVERY runtime (Node, uWS, HTTP/2, engine), so it is the single source of\n// response compression parity. It delegates encoding choice and content-type\n// filtering to the shared utility (utils/compression) so brotli, q-value\n// negotiation, and the compressible-type allowlist behave identically here and\n// in the per-server fallback paths.\nimport { HttpRequest, HttpResponse } from '../../../../types/http.js';\nimport {\n  compressBuffer,\n  compressBufferSync,\n  negotiateEncoding,\n  isCompressible,\n  DEFAULT_ENCODINGS,\n  DEFAULT_MAX_INLINE_BYTES,\n  type Encoding,\n} from '../../../http/utils/compression.js';\n\nexport interface CompressionOptions {\n  threshold?: number;\n  level?: number;\n  encodings?: Encoding[];\n  /**\n   * Bodies at or below this size are compressed on the calling thread and\n   * sent with a Content-Length; larger ones go to the threadpool and stream\n   * chunked. 0 sends every body through the pool. Default 16384.\n   */\n  maxInlineBytes?: number;\n  filter?: (req: HttpRequest, res: HttpResponse) => boolean;\n}\n\nexport class CompressionCore {\n  private threshold: number;\n  private level: number;\n  private encodings: Encoding[];\n  private maxInlineBytes: number;\n  private filter?: ((req: HttpRequest, res: HttpResponse) => boolean) | undefined;\n\n  constructor(options: CompressionOptions = {}) {\n    this.threshold = options.threshold || 1024; // 1KB default\n    this.level = options.level || 6; // Default compression level\n    this.encodings = options.encodings || DEFAULT_ENCODINGS;\n    this.maxInlineBytes = options.maxInlineBytes ?? DEFAULT_MAX_INLINE_BYTES;\n    this.filter = options.filter;\n  }\n\n  shouldCompress(req: HttpRequest, res: HttpResponse): boolean {\n    // Check custom filter\n    if (this.filter && !this.filter(req, res)) {\n      return false;\n    }\n\n    // Check if client accepts any encoding we offer\n    const acceptEncoding = (req.headers['accept-encoding'] as string) || '';\n    return negotiateEncoding(acceptEncoding, this.encodings) !== null;\n  }\n\n  wrapResponse(req: HttpRequest, res: HttpResponse): void {\n    const originalSend = res.send;\n    const acceptEncoding = (req.headers['accept-encoding'] as string) || '';\n    const level = this.level;\n    const threshold = this.threshold;\n    const encodings = this.encodings;\n    const maxInline = this.maxInlineBytes;\n    const filterOk = this.filter ? this.filter(req, res) : true;\n\n    const compressResponse = (data: any, isJson: boolean, contentType?: string) => {\n      const content = isJson ? JSON.stringify(data) : data;\n      const byteLength = Buffer.isBuffer(content)\n        ? content.length\n        : Buffer.byteLength(content ?? '');\n      const ctHeader =\n        contentType ??\n        (res.getHeader ? (res.getHeader('content-type') as string | undefined) : undefined);\n      const encoding = filterOk ? negotiateEncoding(acceptEncoding, encodings) : null;\n\n      // Skip compression when: below threshold, client accepts nothing we\n      // offer, or the content type isn't worth compressing (already-compressed\n      // binary - images, video, octet-stream). For JSON we already have the\n      // serialized string; ending with it here avoids re-entering res.json,\n      // which would JSON.stringify the same data a second time.\n      if (byteLength < threshold || !encoding || !isCompressible(ctHeader)) {\n        if (isJson) {\n          if (res.headersSent) return;\n          res.setHeader('Content-Length', byteLength);\n          res.end(content);\n          return;\n        }\n        return originalSend.call(res, data);\n      }\n\n      const buffer = Buffer.isBuffer(content) ? content : Buffer.from(content ?? '');\n\n      // A small body is compressed here and now: cheaper than the round trip\n      // through the threadpool, and the response carries a Content-Length\n      // instead of streaming chunked. A failure falls back to the plain body.\n      if (maxInline > 0 && byteLength <= maxInline && !res.headersSent) {\n        let compressed: Buffer;\n        try {\n          compressed = compressBufferSync(buffer, encoding, level);\n        } catch {\n          if (isJson) {\n            res.setHeader('Content-Length', byteLength);\n            res.end(content);\n            return;\n          }\n          return originalSend.call(res, data);\n        }\n        res.setHeader('Content-Encoding', encoding);\n        const vary = res.getHeader ? (res.getHeader('vary') as string | undefined) : undefined;\n        res.setHeader('Vary', vary ? `${vary}, Accept-Encoding` : 'Accept-Encoding');\n        res.setHeader('Content-Length', compressed.length);\n        res.end(compressed);\n        return res;\n      }\n\n      // Commit the response headers synchronously, BEFORE the asynchronous\n      // compression. This marks headersSent the moment send/json is called, so\n      // the \"no route matched\" fallback can't 404 the response mid-compress.\n      // The compressed length isn't known yet, so the body streams (chunked).\n      if (!res.headersSent) {\n        // A Content-Length set for the uncompressed body would truncate (or\n        // hang) the compressed one; the compressed body streams chunked.\n        if (typeof (res as any).removeHeader === 'function') {\n          (res as any).removeHeader('Content-Length');\n        }\n        res.setHeader('Content-Encoding', encoding);\n        const vary = res.getHeader ? (res.getHeader('vary') as string | undefined) : undefined;\n        res.setHeader('Vary', vary ? `${vary}, Accept-Encoding` : 'Accept-Encoding');\n        (res as any).writeHead((res as any).statusCode || 200);\n      }\n\n      compressBuffer(buffer, encoding, level)\n        .then(compressed => res.end(compressed))\n        .catch(() => res.end()); // headers already committed - can't fall back to raw\n\n      return res;\n    };\n\n    res.json = function (data: any) {\n      if (!this.getHeader('Content-Type')) {\n        this.setHeader('Content-Type', 'application/json; charset=utf-8');\n      }\n      compressResponse(data, true, 'application/json');\n      return this;\n    };\n\n    res.send = function (data: any) {\n      compressResponse(data, false);\n      return this;\n    };\n  }\n\n  getThreshold(): number {\n    return this.threshold;\n  }\n\n  getLevel(): number {\n    return this.level;\n  }\n}\n"]}

package/dist/core/middleware/built-in/session/core.d.ts

@@ -3,6 +3,7 @@ import { HttpRequest, HttpResponse } from '../../../../types/http.js';
 export interface SessionOptions {
     store?: 'memory' | 'redis' | 'file' | CacheAdapter;
     storeOptions?: {
+        url?: string;
         host?: string;
         port?: number;
         password?: string;