exisjs 0.5.10 → 0.5.12

package/dist/docs/reference/testing.mdx

@@ -0,0 +1,145 @@
+---
+title: "Testing"
+description: "Strict API Reference for all Testing utilities and mocking objects."
+---
+
+# Testing (`exisjs/testing`)
+
+This document provides the strict API signatures and TypeScript interfaces exported by the `exisjs/testing` module. For high-level testing guides, see the [Testing Guide](/docs/testing).
+
+---
+
+## Native Node Runner Exports
+
+ExisJS fully re-exports the native `node:test` runner methods, ensuring maximum IDE compatibility while providing powerful internal enhancements (like `.each()`).
+
+```typescript
+export function test(name: string, fn?: TestFunction): void
+export function test(name: string, options: TestOptions, fn?: TestFunction): void
+
+export function describe(name: string, fn?: TestFunction): void
+export function it(name: string, fn?: TestFunction): void
+
+export function before(fn: HookFunction): void
+export function after(fn: HookFunction): void
+export function beforeEach(fn: HookFunction): void
+export function afterEach(fn: HookFunction): void
+```
+
+### Parametrized Tests (`.each`)
+All test blocks (`test`, `describe`, `it`) support a Jest-like `.each()` signature.
+
+```typescript
+test.each([
+  [1, 1, 2],
+  [2, 3, 5]
+])('adds %d and %d to equal %d', (a, b, expected) => {
+  assert.equal(a + b, expected)
+})
+```
+
+---
+
+## Context Management
+
+### `createTestContext`
+Automatically handles booting an ExisJS `App`, processing its startup hooks, and safely closing all database and worker connections. Returns a `TestApp` client for performing HTTP requests.
+
+```typescript
+function createTestContext(app: App | typeof Class): TestApp
+```
+
+### `registerCleanup`
+Allows third-party plugins or custom test setups to register a global cleanup function that will be executed when the test runner terminates.
+
+```typescript
+function registerCleanup(fn: () => Promise<void> | void): void
+```
+
+---
+
+## HTTP Client (TestApp & TestRequest)
+
+The `TestApp` interface provides a fluent API for making HTTP requests directly against your application without binding to a network port.
+
+### `TestApp`
+```typescript
+interface TestApp {
+  get(path: string): TestRequest
+  post(path: string): TestRequest
+  put(path: string): TestRequest
+  patch(path: string): TestRequest
+  delete(path: string): TestRequest
+  options(path: string): TestRequest
+  head(path: string): TestRequest
+  request(method: string, path: string): TestRequest
+}
+```
+
+### `TestRequest`
+Supports chaining headers, bodies, and assertions. Once `.execute()` is called (or awaited), it returns a `TestResponse`.
+
+```typescript
+class TestRequest {
+  send(body: unknown): this
+  set(header: string, value: string): this
+  
+  // Assertions
+  expect(status: number): this
+  expect(header: string, value: string | RegExp): this
+  expect(body: unknown): this
+  
+  // Execution
+  execute(): Promise<TestResponse>
+  then<T>(onfulfilled: (res: TestResponse) => T): Promise<T>
+}
+```
+
+### `TestResponse`
+```typescript
+interface TestResponse {
+  status: number
+  headers: Record<string, string | string[] | undefined>
+  body: any      // The parsed JSON payload (if applicable)
+  text: string   // The raw string response
+}
+```
+
+---
+
+## Mocks & Spies (`ex`)
+
+The `ex` object provides a Jest-compatible API wrapper over the native `node:test` mocking utilities.
+
+```typescript
+const ex = {
+  // Spies
+  fn: (impl?: Function) => MockFunction,
+  spyOn: (obj: any, methodName: string) => MockFunction,
+  
+  // Modules
+  mock: (specifier: string, factory?: () => any) => void,
+  
+  // Timers
+  setSystemTime: (time: number | Date) => void,
+  advanceTimersByTime: (ms: number) => void,
+  useFakeTimers: () => void,
+  useRealTimers: () => void,
+  
+  clearAllMocks: () => void
+}
+```
+
+### `MockFunction` Extensions
+ExisJS extends the native `MockFunction` returned by `ex.fn()` and `ex.spyOn()` with Jest-like helpers:
+
+```typescript
+interface MockFunction {
+  mockRestore(): void
+  mockImplementation(impl: Function): this
+  mockResolvedValue(val: any): this
+  mockReturnValue(val: any): this
+  mockRejectedValue(err: any): this
+  mockClear(): void
+}
+```

package/dist/docs/reference/validator.mdx

@@ -0,0 +1,186 @@
+---
+title: "Validation"
+description: "API Reference for ExisJS built-in Schema Validator (tex)."
+---
+
+# Validation (`tex`)
+
+ExisJS ships with a blazingly fast, zero-dependency validation library out of the box, exposed as `tex` from `exisjs/validator`. It is powered by a high-performance Rust engine, fully isomorphic, and deeply integrated with TypeScript and OpenAPI (Swagger).
+
+---
+
+## Core Types
+
+The `tex` object provides factory functions for every common primitive and data structure.
+
+- `tex.string()`: Validates a string.
+- `tex.number()`: Validates a number.
+- `tex.boolean()`: Validates a boolean.
+- `tex.email()`: Validates standard email formatting.
+- `tex.enum(['A', 'B'])`: Validates against a specific set of allowed strings.
+
+### Objects & Arrays
+
+- `tex.object({ ... })`: Validates an object against a strict shape.
+- `tex.array(schema)`: Validates an array of items matching the given schema.
+
+```typescript
+const UserProfile = tex.object({
+  id: tex.string(),
+  tags: tex.array(tex.string()),
+  role: tex.enum(['admin', 'user'])
+})
+```
+
+---
+
+## Usage in Routes
+
+ExisJS tightly integrates the `tex` validator directly into its routing layer, providing immediate TypeScript inference for `ctx.body`, `@Body()`, and other parameters.
+
+**Class-Based (OOP)**
+```typescript filename="src/http/users/route.ts"
+import { Controller, Post, Body } from 'exisjs/decorators'
+import { tex } from 'exisjs/validator'
+
+const CreateUserSchema = tex.object({ email: tex.email() })
+
+@Controller('/users')
+export default class UserController {
+  @Post('/', { body: CreateUserSchema })
+  createUser(@Body() body: any) {
+    return { success: true, email: body.email }
+  }
+}
+```
+
+**Functional**
+```typescript filename="src/http/users/route.ts"
+import { controller, route } from 'exisjs/router'
+import { tex } from 'exisjs/validator'
+
+const CreateUserSchema = tex.object({ email: tex.email() })
+
+export default controller({
+  createUser: route.post('/users', {
+    body: CreateUserSchema,
+    async handle(ctx) {
+      // ctx.body is strictly inferred as { email: string }
+      return { success: true, email: ctx.body.email }
+    }
+  })
+})
+```
+
+---
+
+## Type Options
+
+All validators accept an options object that allows you to configure validation constraints and behaviors.
+
+- `optional`: Marks the field as optional (allows `undefined`).
+- `coerce`: Instructs the ultra-fast Rust engine to automatically convert types when possible before validating. For example, converting `"123"` into a number, or `3000` into a string.
+
+```typescript
+// Type Conversion Examples using { coerce: true }
+const EnvSchema = tex.object({
+  // Converts string "3000" from process.env to number 3000
+  PORT: tex.number({ coerce: true }),
+  
+  // Converts boolean 'false' or number '0' to string "false" / "0"
+  ID_AS_STRING: tex.string({ coerce: true }),
+
+  // Converts string "true" or number '1' to boolean true
+  ENABLE_FEATURE: tex.boolean({ coerce: true })
+})
+```
+
+### String Options
+- `min`: Enforces a minimum string length.
+- `max`: Enforces a maximum string length.
+
+### Number Options
+- `min`: Enforces a minimum numeric value.
+- `max`: Enforces a maximum numeric value.
+
+```typescript
+const User = tex.object({ 
+  id: tex.string(), 
+  email: tex.email(), 
+  password: tex.string({ min: 8, max: 100 }),
+  age: tex.number({ min: 13, optional: true })
+})
+```
+
+---
+
+## Custom Data Manipulation
+
+### `.sanitize(...fns)`
+Runs one or more synchronous sanitization functions over the data **before** the Rust validation executes. Use this for complex object transformations or string formatting. ExisJS provides a rich suite of built-in sanitizers through the `exisjs/sanitize` module.
+
+```typescript
+import { sanitize } from 'exisjs/sanitize'
+
+// Built-in sanitization
+const CleanString = tex.string().sanitize(sanitize.trim, sanitize.toLowerCase)
+
+// Custom data transformation
+const WhiteListIPs = tex.array(tex.string())
+  .sanitize((val) => typeof val === 'string' ? val.split(',') : val)
+```
+
+### `.refine(fn, message)`
+Runs custom validation logic **after** the Rust validation executes. Useful for complex business logic that cannot be expressed purely with basic schema types.
+
+```typescript
+const PasswordConfirm = tex.object({
+  password: tex.string(),
+  confirm: tex.string()
+}).refine((data) => data.password === data.confirm, "Passwords must match")
+```
+
+---
+
+## Type Inference
+
+You can extract the raw TypeScript interface directly from any schema using the `ResolveSchema` utility.
+
+```typescript
+import { tex, type ResolveSchema } from 'exisjs/validator'
+
+const ProfileSchema = tex.object({
+  name: tex.string(),
+  age: tex.number({ optional: true })
+})
+
+// Resolves to: { name: string; age?: number | undefined }
+type Profile = ResolveSchema<typeof ProfileSchema>
+```
+
+---
+
+## Integrations
+
+Because the ExisJS Validator is native to the framework, it is tightly coupled with our database and documentation adapters.
+
+### OpenAPI Generation
+The `TexEngine` automatically converts validation schemas into strictly compliant OpenAPI/Swagger JSON schemas when attached to routes. This powers the zero-config ExisJS Swagger integration without any manual YAML authoring.
+
+---
+
+## Environment Validation
+
+You can safely parse and validate your environment variables at startup using the standard `.parse()` method.
+
+```typescript filename="env.ts"
+import { tex } from 'exisjs/validator'
+
+// Validates process.env synchronously. Crashes the app on boot with a 
+// beautiful error message if validation fails.
+export const env = tex.object({
+  PORT: tex.number({ coerce: true, optional: true }),
+  DATABASE_URL: tex.string(),
+  JWT_SECRET: tex.string({ min: 32 })
+}).parse(process.env)
+```

package/dist/index.d.ts

@@ -5,6 +5,10 @@ export { defineConfig } from './utils/config';
 export { createLogger } from './utils/logger';
 export { parseEnv, loadEnv } from './utils/env';
 export { CircuitBreaker, CircuitBreakerError, CircuitState, } from './utils/circuit-breaker';
+export { db, createDatabase, DatabaseManager } from './database';
+export { Migrator } from './database/migration';
+export { QueryBuilder } from './database/query-builder';
+export type { DatabaseConfig, DatabaseDialect, DatabaseAdapter, QueryResult, ExecuteResult, Transaction, } from './database/types';
 export type { ExisConfig, ExisPlugin, ExisPluginInstance, Logger, CorsConfig, LoggerConfig, HookRequest, } from './types';
 export interface ExisUser {
 }

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,CAAA;AAGpB,OAAO,EAAE,SAAS,IAAI,IAAI,EAAE,MAAM,iBAAiB,CAAA;AACnD,OAAO,EAAE,KAAK,GAAG,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAG7C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAE7C,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAI/C,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,YAAY,GACb,MAAM,yBAAyB,CAAA;AAGhC,YAAY,EACV,UAAU,EACV,UAAU,EACV,kBAAkB,EAClB,MAAM,EACN,UAAU,EACV,YAAY,EACZ,WAAW,GACZ,MAAM,SAAS,CAAA;AAGhB,MAAM,WAAW,QAAQ;CAAG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,CAAA;AAGpB,OAAO,EAAE,SAAS,IAAI,IAAI,EAAE,MAAM,iBAAiB,CAAA;AACnD,OAAO,EAAE,KAAK,GAAG,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAG7C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAE7C,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAI/C,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,YAAY,GACb,MAAM,yBAAyB,CAAA;AAGhC,OAAO,EAAE,EAAE,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AACvD,YAAY,EACV,cAAc,EACd,eAAe,EACf,eAAe,EACf,WAAW,EACX,aAAa,EACb,WAAW,GACZ,MAAM,kBAAkB,CAAA;AAGzB,YAAY,EACV,UAAU,EACV,UAAU,EACV,kBAAkB,EAClB,MAAM,EACN,UAAU,EACV,YAAY,EACZ,WAAW,GACZ,MAAM,SAAS,CAAA;AAGhB,MAAM,WAAW,QAAQ;CAAG"}

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CircuitState = exports.CircuitBreakerError = exports.CircuitBreaker = exports.loadEnv = exports.parseEnv = exports.createLogger = exports.defineConfig = exports.getActiveApp = exports.exis = void 0;
+exports.QueryBuilder = exports.Migrator = exports.DatabaseManager = exports.createDatabase = exports.db = exports.CircuitState = exports.CircuitBreakerError = exports.CircuitBreaker = exports.loadEnv = exports.parseEnv = exports.createLogger = exports.defineConfig = exports.getActiveApp = exports.exis = void 0;
 require("./utils/env");
 // ─── Core ─────────────────────────────────────────────────────────────────────
 var define_1 = require("./server/define");
@@ -20,4 +20,13 @@ var circuit_breaker_1 = require("./utils/circuit-breaker");
 Object.defineProperty(exports, "CircuitBreaker", { enumerable: true, get: function () { return circuit_breaker_1.CircuitBreaker; } });
 Object.defineProperty(exports, "CircuitBreakerError", { enumerable: true, get: function () { return circuit_breaker_1.CircuitBreakerError; } });
 Object.defineProperty(exports, "CircuitState", { enumerable: true, get: function () { return circuit_breaker_1.CircuitState; } });
+// ─── Database ─────────────────────────────────────────────────────────────────
+var database_1 = require("./database");
+Object.defineProperty(exports, "db", { enumerable: true, get: function () { return database_1.db; } });
+Object.defineProperty(exports, "createDatabase", { enumerable: true, get: function () { return database_1.createDatabase; } });
+Object.defineProperty(exports, "DatabaseManager", { enumerable: true, get: function () { return database_1.DatabaseManager; } });
+var migration_1 = require("./database/migration");
+Object.defineProperty(exports, "Migrator", { enumerable: true, get: function () { return migration_1.Migrator; } });
+var query_builder_1 = require("./database/query-builder");
+Object.defineProperty(exports, "QueryBuilder", { enumerable: true, get: function () { return query_builder_1.QueryBuilder; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,uBAAoB;AAEpB,iFAAiF;AACjF,0CAAmD;AAA1C,8FAAA,SAAS,OAAQ;AAC1B,oCAAqD;AAAlC,mGAAA,YAAY,OAAA;AAC/B,yCAA6C;AAApC,sGAAA,YAAY,OAAA;AAErB,iFAAiF;AACjF,yCAA6C;AAApC,sGAAA,YAAY,OAAA;AAErB,mCAA+C;AAAtC,+FAAA,QAAQ,OAAA;AAAE,8FAAA,OAAO,OAAA;AAE1B,8EAA8E;AAE9E,2DAIgC;AAH9B,iHAAA,cAAc,OAAA;AACd,sHAAA,mBAAmB,OAAA;AACnB,+GAAA,YAAY,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,uBAAoB;AAEpB,iFAAiF;AACjF,0CAAmD;AAA1C,8FAAA,SAAS,OAAQ;AAC1B,oCAAqD;AAAlC,mGAAA,YAAY,OAAA;AAC/B,yCAA6C;AAApC,sGAAA,YAAY,OAAA;AAErB,iFAAiF;AACjF,yCAA6C;AAApC,sGAAA,YAAY,OAAA;AAErB,mCAA+C;AAAtC,+FAAA,QAAQ,OAAA;AAAE,8FAAA,OAAO,OAAA;AAE1B,8EAA8E;AAE9E,2DAIgC;AAH9B,iHAAA,cAAc,OAAA;AACd,sHAAA,mBAAmB,OAAA;AACnB,+GAAA,YAAY,OAAA;AAGd,iFAAiF;AACjF,uCAAgE;AAAvD,8FAAA,EAAE,OAAA;AAAE,0GAAA,cAAc,OAAA;AAAE,2GAAA,eAAe,OAAA;AAC5C,kDAA+C;AAAtC,qGAAA,QAAQ,OAAA;AACjB,0DAAuD;AAA9C,6GAAA,YAAY,OAAA"}

package/dist/middleware/compression.d.ts

@@ -1,3 +1,15 @@
 import type { Handler } from '../types';
+/**
+ * Compression middleware — optimized to avoid monkey-patching ServerResponse methods.
+ *
+ * Previous implementation replaced res.raw.write/end/setHeader/writeHead with new closures
+ * on every request, which:
+ * 1. Created 5+ closure objects per request (GC pressure)
+ * 2. Destroyed V8's hidden class optimization for ServerResponse
+ *
+ * This version hooks into the ExisResponse's _onFinish callback and overrides the
+ * high-level json()/send()/end() methods on ExisResponse instead. Since ExisResponse
+ * is our own object (and already pooled), modifying it doesn't deoptimize Node internals.
+ */
 export declare function compression(): Handler;
 //# sourceMappingURL=compression.d.ts.map

package/dist/middleware/compression.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compression.d.ts","sourceRoot":"","sources":["../../src/middleware/compression.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAqB,MAAM,UAAU,CAAA;AAE1D,wBAAgB,WAAW,IAAI,OAAO,CA8JrC"}
+{"version":3,"file":"compression.d.ts","sourceRoot":"","sources":["../../src/middleware/compression.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAqB,MAAM,UAAU,CAAA;AAE1D;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAiFrC"}

package/dist/middleware/compression.js

@@ -5,6 +5,18 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.compression = compression;
 const node_zlib_1 = __importDefault(require("node:zlib"));
+/**
+ * Compression middleware — optimized to avoid monkey-patching ServerResponse methods.
+ *
+ * Previous implementation replaced res.raw.write/end/setHeader/writeHead with new closures
+ * on every request, which:
+ * 1. Created 5+ closure objects per request (GC pressure)
+ * 2. Destroyed V8's hidden class optimization for ServerResponse
+ *
+ * This version hooks into the ExisResponse's _onFinish callback and overrides the
+ * high-level json()/send()/end() methods on ExisResponse instead. Since ExisResponse
+ * is our own object (and already pooled), modifying it doesn't deoptimize Node internals.
+ */
 function compression() {
     return (req, res, next) => {
         const acceptEncoding = req.headers['accept-encoding'] || '';
@@ -19,115 +31,65 @@ function compression() {
         if (!encoding || req.method === 'HEAD') {
             return next();
         }
-        let stream = null;
-        const originalWrite = res.raw.write.bind(res.raw);
-        const originalEnd = res.raw.end.bind(res.raw);
-        const originalRawSetHeader = res.raw.setHeader.bind(res.raw);
-        const originalRawWriteHead = res.raw.writeHead
-            ? res.raw.writeHead.bind(res.raw)
-            : undefined;
-        res.raw.setHeader = function (name, value) {
-            if (name.toLowerCase() === 'content-length') {
-                return this;
-            }
-            return originalRawSetHeader(name, value);
-        };
-        if (originalRawWriteHead) {
-            res.raw.writeHead = function (statusCode, reasonOrHeaders, headers) {
-                const actualHeaders = headers || reasonOrHeaders;
-                if (actualHeaders && typeof actualHeaders === 'object') {
-                    const cleaned = {};
-                    for (const [k, v] of Object.entries(actualHeaders)) {
-                        if (k.toLowerCase() !== 'content-length') {
-                            cleaned[k] = v;
-                        }
-                    }
-                    if (headers) {
-                        reasonOrHeaders = cleaned;
-                    }
-                    else {
-                        reasonOrHeaders = cleaned;
-                    }
-                }
-                return originalRawWriteHead(statusCode, reasonOrHeaders, headers);
-            };
-        }
-        let onFinishCallback;
-        const startCompression = () => {
-            if (stream)
-                return; // already started
-            originalRawSetHeader('Content-Encoding', encoding);
-            originalRawSetHeader('Vary', 'Accept-Encoding');
-            if (encoding === 'br') {
-                stream = node_zlib_1.default.createBrotliCompress();
-            }
-            else if (encoding === 'gzip') {
-                stream = node_zlib_1.default.createGzip();
-            }
-            else if (encoding === 'deflate') {
-                stream = node_zlib_1.default.createDeflate();
-            }
-            if (stream) {
-                stream.on('data', (chunk) => {
-                    originalWrite(chunk);
-                });
-                stream.on('end', () => {
-                    originalEnd(undefined, undefined, onFinishCallback);
-                });
-            }
-        };
-        res.raw.write = function (chunk, encodingOrCb, cb) {
+        // Store originals from the ExisResponse wrapper (our own object — safe to override)
+        const originalEnd = res.end.bind(res);
+        const selectedEncoding = encoding;
+        // Override ExisResponse.end() to compress the final payload in a single pass.
+        // This avoids touching ServerResponse's hidden class entirely.
+        res.end = function (data) {
             if (res.raw.writableEnded)
-                return false;
-            if (!stream)
-                startCompression();
-            if (stream) {
-                return stream.write(chunk, encodingOrCb, cb);
-            }
-            return originalWrite(chunk, encodingOrCb, cb);
-        };
-        let ended = false;
-        res.raw.end = function (chunk, encodingOrCb, cb) {
-            if (res.raw.writableEnded || ended)
-                return this;
-            ended = true;
-            let callback;
-            let encodingArg;
-            if (typeof chunk === 'function') {
-                callback = chunk;
-                chunk = undefined;
-            }
-            else if (typeof encodingOrCb === 'function') {
-                callback = encodingOrCb;
-                encodingOrCb = undefined;
-            }
-            else if (typeof cb === 'function') {
-                callback = cb;
+                return;
+            // Skip compression for empty responses
+            if (!data) {
+                originalEnd(data);
+                return;
             }
-            if (typeof encodingOrCb === 'string') {
-                encodingArg = encodingOrCb;
+            const buf = typeof data === 'string'
+                ? Buffer.from(data, 'utf8')
+                : Buffer.isBuffer(data)
+                    ? data
+                    : Buffer.from(String(data), 'utf8');
+            // For small payloads (< 1KB), compression overhead outweighs savings
+            if (buf.length < 1024) {
+                originalEnd(data);
+                return;
             }
-            if (callback) {
-                onFinishCallback = callback;
-            }
-            if (chunk) {
-                if (!stream)
-                    startCompression();
-                if (stream) {
-                    stream.write(chunk, encodingArg);
+            // Set encoding headers
+            res.raw.setHeader('Content-Encoding', selectedEncoding);
+            res.raw.setHeader('Vary', 'Accept-Encoding');
+            // Remove Content-Length since compressed size will differ
+            res.raw.removeHeader('Content-Length');
+            // Compress synchronously for small-to-medium payloads to avoid extra async overhead
+            let compressed;
+            try {
+                if (selectedEncoding === 'br') {
+                    compressed = node_zlib_1.default.brotliCompressSync(buf);
+                }
+                else if (selectedEncoding === 'gzip') {
+                    compressed = node_zlib_1.default.gzipSync(buf);
                 }
                 else {
-                    originalWrite(chunk, encodingArg);
+                    compressed = node_zlib_1.default.deflateSync(buf);
                 }
             }
-            if (stream) {
-                stream.end();
-                stream = null;
+            catch {
+                // If compression fails, send uncompressed
+                originalEnd(data);
+                return;
+            }
+            res.raw.setHeader('Content-Length', compressed.length);
+            // Fire _onFinish callbacks via the original end path
+            if (res._onFinish.length > 0) {
+                res.raw.end(compressed, () => {
+                    // eslint-disable-next-line @typescript-eslint/prefer-for-of
+                    for (let i = 0; i < res._onFinish.length; i++) {
+                        res._onFinish[i]();
+                    }
+                });
             }
             else {
-                originalEnd(chunk, encodingArg, callback);
+                res.raw.end(compressed);
             }
-            return this;
         };
         next();
     };

package/dist/middleware/compression.js.map

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

package/dist/middleware/middleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/middleware/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACzE,OAAO,EACL,eAAe,EAEhB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,SAAS,EAEV,MAAM,kBAAkB,CAAA;AAKzB,wBAAgB,IAAI,CAAC,MAAM,GAAE,UAAe,GAAG,OAAO,CAwFrD;AAMD,wBAAgB,SAAS,IAAI,OAAO,CAenC;AAID,wBAAgB,aAAa,CAC3B,cAAc,GAAE,MAAM,GAAG,YAAiB,GACzC,OAAO,CAoCT;AAID,eAAO,MAAM,QAAQ,EAAE,OAQtB,CAAA;AAID,OAAO,EAAE,WAAW,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAA;AACvD,OAAO,EACL,MAAM,EACN,IAAI,EACJ,OAAO,EACP,GAAG,EACH,aAAa,EACb,UAAU,GACX,MAAM,YAAY,CAAA;AACnB,YAAY,EACV,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,aAAa,GACd,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AACpD,OAAO,EAAE,eAAe,IAAI,KAAK,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAE,gBAAgB,IAAI,MAAM,EAAE,MAAM,UAAU,CAAA;AACrD,OAAO,EAAE,sBAAsB,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAA;AACvE,OAAO,EAAE,kBAAkB,IAAI,QAAQ,EAAE,MAAM,aAAa,CAAA;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAC/C,cAAc,SAAS,CAAA;AACvB,cAAc,QAAQ,CAAA;AAEtB,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAChC,OAAO,CA0ET;AAID,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,eAAe,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAA;IAE5C,KAAK,CAAC,EAAE,eAAe,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAA;IAE7C,MAAM,CAAC,EAAE,eAAe,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAA;CAC/C;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAiCxD;AAID,wBAAgB,cAAc,IAAI,OAAO,CAKxC;AAED,cAAc,eAAe,CAAA"}
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/middleware/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACzE,OAAO,EACL,eAAe,EAEhB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,SAAS,EAEV,MAAM,kBAAkB,CAAA;AAKzB,wBAAgB,IAAI,CAAC,MAAM,GAAE,UAAe,GAAG,OAAO,CAwFrD;AAMD,wBAAgB,SAAS,IAAI,OAAO,CAenC;AAID,wBAAgB,aAAa,CAC3B,cAAc,GAAE,MAAM,GAAG,YAAiB,GACzC,OAAO,CAqDT;AAID,eAAO,MAAM,QAAQ,EAAE,OAQtB,CAAA;AAID,OAAO,EAAE,WAAW,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAA;AACvD,OAAO,EACL,MAAM,EACN,IAAI,EACJ,OAAO,EACP,GAAG,EACH,aAAa,EACb,UAAU,GACX,MAAM,YAAY,CAAA;AACnB,YAAY,EACV,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,aAAa,GACd,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AACpD,OAAO,EAAE,eAAe,IAAI,KAAK,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAE,gBAAgB,IAAI,MAAM,EAAE,MAAM,UAAU,CAAA;AACrD,OAAO,EAAE,sBAAsB,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAA;AACvE,OAAO,EAAE,kBAAkB,IAAI,QAAQ,EAAE,MAAM,aAAa,CAAA;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAC/C,cAAc,SAAS,CAAA;AACvB,cAAc,QAAQ,CAAA;AAEtB,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAChC,OAAO,CA0ET;AAID,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,eAAe,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAA;IAE5C,KAAK,CAAC,EAAE,eAAe,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAA;IAE7C,MAAM,CAAC,EAAE,eAAe,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAA;CAC/C;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAiCxD;AAID,wBAAgB,cAAc,IAAI,OAAO,CAKxC;AAED,cAAc,eAAe,CAAA"}