X Modules

Simple CORS header management. Automatically registers as outbound global middleware. Provides a preflight handler for OPTIONS requests. See XCors for full configuration.

import { X } from "@ozanarslan/corpus";

new X.Cors({
	allowedOrigins: ["https://app.example.com"],
	allowedMethods: ["GET", "POST"],
	credentials: true,
});

Intelligent rate limiting with tiered identification and multiple storage backends.

import { X } from "@ozanarslan/corpus";

// Default: memory store, 120/60/20 requests per minute
new X.RateLimiter();

Automatically classifies requests by trust level: authenticated users (JWT), IP addresses, or browser fingerprints. See XRateLimiter for details.

File system abstraction with MIME type detection.

import { C, X } from "@ozanarslan/corpus";

const file = new X.File("assets/report.pdf");

if (await file.exists()) {
	console.log(file.mimeType); // "application/pdf"
	return C.Response.file(file.path);
}

See XFile for streaming and full API.

Abstract base class for database repositories.

import { X } from "@ozanarslan/corpus";

class UserRepository extends X.Repository {
	async findById(id: number) {
		return this.db.query("SELECT * FROM users WHERE id = ?", [id]);
	}
}

Extend DatabaseClientInterface via module augmentation for type safety. See XRepository.

Helper type for inferring all schemas from a single object containing multiple RouteModels. Useful when you prefer to colocate all your route schemas in one place.

import { C, X } from "@ozanarslan/corpus";

class UserModel {
	static entity = z.object({
		id: z.number(),
		name: z.string(),
	});

	static create = {
		body: z.object({ name: z.string() }),
		response: this.entity,
	};
}

type M = X.InferModel<typeof UserModel>;
// M["create"] = { body: { name: string }, response: { id: number, name: string } }

See Model for more on route validation and type inference.