exisjs 0.5.9 → 0.5.11

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/backpressure.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backpressure.d.ts","sourceRoot":"","sources":["../../src/middleware/backpressure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAmC,MAAM,UAAU,CAAA;AAGxE,MAAM,WAAW,mBAAmB;IAClC,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,sBAAsB,CACpC,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAwET"}
+{"version":3,"file":"backpressure.d.ts","sourceRoot":"","sources":["../../src/middleware/backpressure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAmC,MAAM,UAAU,CAAA;AAGxE,MAAM,WAAW,mBAAmB;IAClC,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,sBAAsB,CACpC,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAqFT"}

package/dist/middleware/backpressure.js

@@ -13,6 +13,11 @@ function backpressureMiddleware(options = {}) {
             const queued = queue.shift();
             if (queued) {
                 clearTimeout(queued.timer);
+                // O(1) skip if the request timed out
+                if (queued.isCancelled) {
+                    process.nextTick(processNext);
+                    return;
+                }
                 activeCount++;
                 // Use _onFinish to decrement activeCount when done
                 queued.res._onFinish.push(() => {
@@ -37,19 +42,23 @@ function backpressureMiddleware(options = {}) {
             // Return 503 Service Unavailable immediately
             return next(errors_1.HttpError.serviceUnavailable('Server is at capacity. Please try again later.'));
         }
-        const timer = setTimeout(() => {
-            // Remove from queue
-            const index = queue.findIndex((q) => q.req === req);
-            if (index !== -1) {
-                queue.splice(index, 1);
-                next(errors_1.HttpError.serviceUnavailable('Request timed out in queue.'));
-            }
-        }, timeoutMs);
-        // Allow process to exit if only this timer remains
-        if (timer.unref) {
-            timer.unref();
+        const queuedReq = {
+            req,
+            res,
+            next,
+            timer: null,
+            isCancelled: false,
+        };
+        const timeoutCallback = () => {
+            queuedReq.isCancelled = true;
+            next(errors_1.HttpError.serviceUnavailable('Request timed out in queue.'));
+        };
+        // Refresh timer logic
+        queuedReq.timer = setTimeout(timeoutCallback, timeoutMs);
+        if (queuedReq.timer.unref) {
+            queuedReq.timer.unref();
         }
-        queue.push({ req, res, next, timer });
+        queue.push(queuedReq);
     };
 }
 //# sourceMappingURL=backpressure.js.map

package/dist/middleware/backpressure.js.map

@@ -1 +1 @@
-{"version":3,"file":"backpressure.js","sourceRoot":"","sources":["../../src/middleware/backpressure.ts"],"names":[],"mappings":";;AAYA,wDA0EC;AArFD,4CAA2C;AAW3C,SAAgB,sBAAsB,CACpC,UAA+B,EAAE;IAEjC,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,IAAI,CAAA;IACnD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,GAAG,CAAA;IACxC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAA;IAE5C,IAAI,WAAW,GAAG,CAAC,CAAA;IASnB,MAAM,KAAK,GAAoB,EAAE,CAAA;IAEjC,MAAM,WAAW,GAAG,GAAG,EAAE;QACvB,IAAI,WAAW,GAAG,aAAa,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpD,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,EAAE,CAAA;YAC5B,IAAI,MAAM,EAAE,CAAC;gBACX,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;gBAC1B,WAAW,EAAE,CAAA;gBAEb,mDAAmD;gBACnD,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE;oBAC7B,WAAW,EAAE,CAAA;oBACb,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAA;gBAC/B,CAAC,CAAC,CAAA;gBAEF,MAAM,CAAC,IAAI,EAAE,CAAA;YACf,CAAC;QACH,CAAC;IACH,CAAC,CAAA;IAED,OAAO,CAAC,GAAY,EAAE,GAAa,EAAE,IAAkB,EAAE,EAAE;QACzD,IAAI,WAAW,GAAG,aAAa,EAAE,CAAC;YAChC,WAAW,EAAE,CAAA;YAEb,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE;gBACtB,WAAW,EAAE,CAAA;gBACb,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAA;YAC/B,CAAC,CAAC,CAAA;YAEF,OAAO,IAAI,EAAE,CAAA;QACf,CAAC;QAED,sCAAsC;QACtC,IAAI,KAAK,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;YAC7B,6CAA6C;YAC7C,OAAO,IAAI,CACT,kBAAS,CAAC,kBAAkB,CAC1B,gDAAgD,CACjD,CACF,CAAA;QACH,CAAC;QAED,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,oBAAoB;YACpB,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAA;YACnD,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;gBACjB,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;gBACtB,IAAI,CAAC,kBAAS,CAAC,kBAAkB,CAAC,6BAA6B,CAAC,CAAC,CAAA;YACnE,CAAC;QACH,CAAC,EAAE,SAAS,CAAC,CAAA;QAEb,mDAAmD;QACnD,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,KAAK,CAAC,KAAK,EAAE,CAAA;QACf,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IACvC,CAAC,CAAA;AACH,CAAC"}
+{"version":3,"file":"backpressure.js","sourceRoot":"","sources":["../../src/middleware/backpressure.ts"],"names":[],"mappings":";;AAYA,wDAuFC;AAlGD,4CAA2C;AAW3C,SAAgB,sBAAsB,CACpC,UAA+B,EAAE;IAEjC,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,IAAI,CAAA;IACnD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,GAAG,CAAA;IACxC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAA;IAE5C,IAAI,WAAW,GAAG,CAAC,CAAA;IAUnB,MAAM,KAAK,GAAoB,EAAE,CAAA;IAEjC,MAAM,WAAW,GAAG,GAAG,EAAE;QACvB,IAAI,WAAW,GAAG,aAAa,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpD,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,EAAE,CAAA;YAC5B,IAAI,MAAM,EAAE,CAAC;gBACX,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;gBAE1B,qCAAqC;gBACrC,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;oBACvB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAA;oBAC7B,OAAM;gBACR,CAAC;gBAED,WAAW,EAAE,CAAA;gBAEb,mDAAmD;gBACnD,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE;oBAC7B,WAAW,EAAE,CAAA;oBACb,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAA;gBAC/B,CAAC,CAAC,CAAA;gBAEF,MAAM,CAAC,IAAI,EAAE,CAAA;YACf,CAAC;QACH,CAAC;IACH,CAAC,CAAA;IAED,OAAO,CAAC,GAAY,EAAE,GAAa,EAAE,IAAkB,EAAE,EAAE;QACzD,IAAI,WAAW,GAAG,aAAa,EAAE,CAAC;YAChC,WAAW,EAAE,CAAA;YAEb,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE;gBACtB,WAAW,EAAE,CAAA;gBACb,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAA;YAC/B,CAAC,CAAC,CAAA;YAEF,OAAO,IAAI,EAAE,CAAA;QACf,CAAC;QAED,sCAAsC;QACtC,IAAI,KAAK,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;YAC7B,6CAA6C;YAC7C,OAAO,IAAI,CACT,kBAAS,CAAC,kBAAkB,CAC1B,gDAAgD,CACjD,CACF,CAAA;QACH,CAAC;QAED,MAAM,SAAS,GAAkB;YAC/B,GAAG;YACH,GAAG;YACH,IAAI;YACJ,KAAK,EAAE,IAAW;YAClB,WAAW,EAAE,KAAK;SACnB,CAAA;QAED,MAAM,eAAe,GAAG,GAAG,EAAE;YAC3B,SAAS,CAAC,WAAW,GAAG,IAAI,CAAA;YAC5B,IAAI,CAAC,kBAAS,CAAC,kBAAkB,CAAC,6BAA6B,CAAC,CAAC,CAAA;QACnE,CAAC,CAAA;QAED,sBAAsB;QACtB,SAAS,CAAC,KAAK,GAAG,UAAU,CAAC,eAAe,EAAE,SAAS,CAAC,CAAA;QACxD,IAAI,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YAC1B,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;QACzB,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IACvB,CAAC,CAAA;AACH,CAAC"}

package/dist/middleware/cache.d.ts

@@ -10,6 +10,12 @@ export interface CacheOptions {
      * Override this for user-scoped caching (e.g. `(req) => req.user.id + req.path`).
      */
     keyGenerator?: (req: Request) => string;
+    /**
+     * Stale-While-Revalidate duration in milliseconds.
+     * If the cache is older than ttlMs but younger than ttlMs + swrMs,
+     * stale data is served instantly while it revalidates in the background.
+     */
+    swrMs?: number;
 }
 export declare function cacheMiddleware(options: CacheOptions): Handler;
 //# sourceMappingURL=cache.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/middleware/cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAA0B,MAAM,UAAU,CAAA;AACxE,OAAO,EAAiB,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAE/D,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,UAAU,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,EAAE,CAAC,CAAA;IAC9C;;;;OAIG;IACH,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,CAAA;CACxC;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAsH9D"}
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/middleware/cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAA0B,MAAM,UAAU,CAAA;AACxE,OAAO,EAAiB,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAE/D,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,UAAU,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,EAAE,CAAC,CAAA;IAC9C;;;;OAIG;IACH,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,CAAA;IACvC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAKD,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CA4K9D"}

package/dist/middleware/cache.js

@@ -2,6 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.cacheMiddleware = cacheMiddleware;
 const store_1 = require("../cache/store");
+// Global in-flight requests map to prevent Cache Stampedes (Dogpile effect)
+const inFlightRequests = new Map();
 function cacheMiddleware(options) {
     const ttlMs = options.ttlMs;
     if (!options || typeof options.keyGenerator !== 'function') {
@@ -17,37 +19,74 @@ function cacheMiddleware(options) {
         try {
             const cached = await store.get(key);
             if (cached) {
-                if (cached.data.contentType) {
-                    res.set('Content-Type', cached.data.contentType);
+                const isStale = ttlMs && Date.now() - cached.createdAt > ttlMs;
+                // If it's stale and we have no SWR allowance, we act as a miss
+                if (isStale &&
+                    (!options.swrMs ||
+                        Date.now() - cached.createdAt > ttlMs + options.swrMs)) {
+                    // Treated as miss
                 }
-                res.set('X-Exis-Cache', 'HIT');
-                let bodyToSend = cached.data.body;
-                // Handle Buffer reconstruction for Redis
-                if (typeof cached.data.body === 'string' && cached.data.isBuffer) {
-                    bodyToSend = Buffer.from(cached.data.body, 'base64');
-                }
-                // For JSON responses, replay via res.json() so middleware chains
-                // (interceptor, dedupe) receive the correct type instead of raw strings
-                const ct = cached.data.contentType || '';
-                if (ct.includes('application/json') && typeof bodyToSend === 'string') {
-                    try {
-                        res.status(cached.data.statusCode).json(JSON.parse(bodyToSend));
+                else {
+                    // Handle Buffer reconstruction for Redis
+                    if (cached.data.contentType) {
+                        res.set('Content-Type', cached.data.contentType);
+                    }
+                    res.set('X-Exis-Cache', isStale ? 'STALE' : 'HIT');
+                    let bodyToSend = cached.data.body;
+                    if (typeof cached.data.body === 'string' && cached.data.isBuffer) {
+                        bodyToSend = Buffer.from(cached.data.body, 'base64');
+                    }
+                    if (cached.data.contentType?.includes('application/json') &&
+                        typeof bodyToSend === 'string') {
+                        try {
+                            res.status(cached.data.statusCode).json(JSON.parse(bodyToSend));
+                        }
+                        catch {
+                            res.status(cached.data.statusCode).send(bodyToSend);
+                        }
                     }
-                    catch {
-                        // If parsing fails, fall back to send
+                    else {
                         res.status(cached.data.statusCode).send(bodyToSend);
                     }
+                    if (!isStale) {
+                        return;
+                    }
+                    // If it was stale, we returned the response already. Now we fall through
+                    // to trigger a background revalidation! We MUST NOT return here if stale.
                 }
-                else {
-                    res.status(cached.data.statusCode).send(bodyToSend);
-                }
-                return;
             }
         }
         catch {
             // Fallback to normal execution if cache read fails
         }
-        res.set('X-Exis-Cache', 'MISS');
+        // --- Cache Stampede Prevention ---
+        // If another request is currently resolving this exact same cache key, we just wait for it.
+        if (!res.headersSent) {
+            if (inFlightRequests.has(key)) {
+                res.set('X-Exis-Cache', 'DEDUPED');
+                const dedupeResponse = await inFlightRequests.get(key);
+                if (dedupeResponse.contentType) {
+                    res.set('Content-Type', dedupeResponse.contentType);
+                }
+                if (dedupeResponse.contentType?.includes('application/json') &&
+                    typeof dedupeResponse.body === 'string') {
+                    return res
+                        .status(dedupeResponse.statusCode)
+                        .json(JSON.parse(dedupeResponse.body));
+                }
+                return res.status(dedupeResponse.statusCode).send(dedupeResponse.body);
+            }
+        }
+        // Set headers if not already sent (by SWR)
+        if (!res.headersSent) {
+            res.set('X-Exis-Cache', 'MISS');
+        }
+        let resolveInFlight;
+        const inFlightPromise = new Promise((resolve) => {
+            resolveInFlight = resolve;
+        });
+        inFlightRequests.set(key, inFlightPromise);
+        // --- End Stampede Prevention ---
         // Intercept send/json
         const originalSend = res.send.bind(res);
         const originalJson = res.json.bind(res);
@@ -60,19 +99,27 @@ function cacheMiddleware(options) {
                 else if (options.tags) {
                     tags = options.tags;
                 }
-                // Fire and forget caching
-                Promise.resolve(store.set(key, {
+                const payload = {
                     body,
                     contentType: typeof res.getHeader === 'function'
                         ? res.getHeader('content-type')
                         : undefined,
                     statusCode: res.statusCode,
                     isBuffer: Buffer.isBuffer(body),
-                }, tags, ttlMs)).catch(() => {
+                };
+                Promise.resolve(store.set(key, payload, tags, ttlMs)).catch(() => {
                     /* noop */
                 });
+                resolveInFlight(payload);
+                inFlightRequests.delete(key);
+            }
+            else {
+                resolveInFlight({});
+                inFlightRequests.delete(key);
+            }
+            if (!res.headersSent) {
+                return originalSend(body);
             }
-            return originalSend(body);
         };
         res.json = function (data) {
             if (res.statusCode >= 200 && res.statusCode < 300) {
@@ -83,16 +130,25 @@ function cacheMiddleware(options) {
                 else if (options.tags) {
                     tags = options.tags;
                 }
-                Promise.resolve(store.set(key, {
+                const payload = {
                     body: JSON.stringify(data),
                     contentType: 'application/json; charset=utf-8',
                     statusCode: res.statusCode,
                     isBuffer: false,
-                }, tags, ttlMs)).catch(() => {
+                };
+                Promise.resolve(store.set(key, payload, tags, ttlMs)).catch(() => {
                     /* noop */
                 });
+                resolveInFlight(payload);
+                inFlightRequests.delete(key);
+            }
+            else {
+                resolveInFlight({});
+                inFlightRequests.delete(key);
+            }
+            if (!res.headersSent) {
+                return originalJson(data);
             }
-            return originalJson(data);
         };
         next();
     };

package/dist/middleware/cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/middleware/cache.ts"],"names":[],"mappings":";;AAeA,0CAsHC;AApID,0CAA+D;AAc/D,SAAgB,eAAe,CAAC,OAAqB;IACnD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAA;IAC3B,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,CAAC,YAAY,KAAK,UAAU,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CACb,qKAAqK,CACtK,CAAA;IACH,CAAC;IACD,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAA;IAEzC,OAAO,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,IAAkB,EAAE,EAAE;QAC/D,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YACzB,OAAO,IAAI,EAAE,CAAA;QACf,CAAC;QAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,IAAA,qBAAa,GAAE,CAAA;QAC9C,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC,CAAA;QAE7B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;YACnC,IAAI,MAAM,EAAE,CAAC;gBACX,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;oBAC5B,GAAG,CAAC,GAAG,CAAC,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;gBAClD,CAAC;gBACD,GAAG,CAAC,GAAG,CAAC,cAAc,EAAE,KAAK,CAAC,CAAA;gBAE9B,IAAI,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAA;gBACjC,yCAAyC;gBACzC,IAAI,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACjE,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;gBACtD,CAAC;gBAED,iEAAiE;gBACjE,wEAAwE;gBACxE,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAA;gBACxC,IAAI,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;oBACtE,IAAI,CAAC;wBACH,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAA;oBACjE,CAAC;oBAAC,MAAM,CAAC;wBACP,sCAAsC;wBACtC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;oBACrD,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;gBACrD,CAAC;gBACD,OAAM;YACR,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,mDAAmD;QACrD,CAAC;QAED,GAAG,CAAC,GAAG,CAAC,cAAc,EAAE,MAAM,CAAC,CAAA;QAE/B,sBAAsB;QACtB,MAAM,YAAY,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACvC,MAAM,YAAY,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAEvC,GAAG,CAAC,IAAI,GAAG,UAAU,IAAqB;YACxC,IAAI,GAAG,CAAC,UAAU,IAAI,GAAG,IAAI,GAAG,CAAC,UAAU,GAAG,GAAG,EAAE,CAAC;gBAClD,IAAI,IAAI,GAAa,EAAE,CAAA;gBACvB,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;oBACvC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;gBAC1B,CAAC;qBAAM,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;oBACxB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAA;gBACrB,CAAC;gBAED,0BAA0B;gBAC1B,OAAO,CAAC,OAAO,CACb,KAAK,CAAC,GAAG,CACP,GAAG,EACH;oBACE,IAAI;oBACJ,WAAW,EACT,OAAQ,GAAW,CAAC,SAAS,KAAK,UAAU;wBAC1C,CAAC,CAAE,GAAW,CAAC,SAAS,CAAC,cAAc,CAAC;wBACxC,CAAC,CAAC,SAAS;oBACf,UAAU,EAAE,GAAG,CAAC,UAAU;oBAC1B,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;iBAChC,EACD,IAAI,EACJ,KAAK,CACN,CACF,CAAC,KAAK,CAAC,GAAG,EAAE;oBACX,UAAU;gBACZ,CAAC,CAAC,CAAA;YACJ,CAAC;YACD,OAAO,YAAY,CAAC,IAAI,CAAC,CAAA;QAC3B,CAAC,CAAA;QAED,GAAG,CAAC,IAAI,GAAG,UAAU,IAAa;YAChC,IAAI,GAAG,CAAC,UAAU,IAAI,GAAG,IAAI,GAAG,CAAC,UAAU,GAAG,GAAG,EAAE,CAAC;gBAClD,IAAI,IAAI,GAAa,EAAE,CAAA;gBACvB,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;oBACvC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;gBAC1B,CAAC;qBAAM,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;oBACxB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAA;gBACrB,CAAC;gBAED,OAAO,CAAC,OAAO,CACb,KAAK,CAAC,GAAG,CACP,GAAG,EACH;oBACE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;oBAC1B,WAAW,EAAE,iCAAiC;oBAC9C,UAAU,EAAE,GAAG,CAAC,UAAU;oBAC1B,QAAQ,EAAE,KAAK;iBAChB,EACD,IAAI,EACJ,KAAK,CACN,CACF,CAAC,KAAK,CAAC,GAAG,EAAE;oBACX,UAAU;gBACZ,CAAC,CAAC,CAAA;YACJ,CAAC;YACD,OAAO,YAAY,CAAC,IAAI,CAAC,CAAA;QAC3B,CAAC,CAAA;QAED,IAAI,EAAE,CAAA;IACR,CAAC,CAAA;AACH,CAAC"}
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/middleware/cache.ts"],"names":[],"mappings":"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"}