@morojs/moro 1.6.8 → 1.7.0

package/dist/core/mail/template-engine.js

@@ -0,0 +1,239 @@
+// Email Template Engine
+// ESM-first module with support for Moro, Handlebars, and EJS
+import fs from 'fs/promises';
+import path from 'path';
+import { isPackageAvailable, resolveUserPackage } from '../utilities/package-utils.js';
+/**
+ * Moro built-in template engine
+ * Supports: {{variable}}, {{#if}}, {{#each}}, partials
+ */
+class MoroTemplateEngine {
+    compiled = new Map();
+    partials = new Map();
+    async render(template, data) {
+        // Replace partials first
+        let processed = this.processPartials(template);
+        // Process conditionals
+        processed = this.processConditionals(processed, data);
+        // Process loops
+        processed = this.processLoops(processed, data);
+        // Process variables
+        processed = this.processVariables(processed, data);
+        return processed;
+    }
+    compile(template) {
+        return (data) => {
+            let processed = this.processPartials(template);
+            processed = this.processConditionals(processed, data);
+            processed = this.processLoops(processed, data);
+            processed = this.processVariables(processed, data);
+            return processed;
+        };
+    }
+    registerPartial(name, template) {
+        this.partials.set(name, template);
+    }
+    processPartials(template) {
+        return template.replace(/\{\{>\s*(\w+)\s*\}\}/g, (_, name) => {
+            return this.partials.get(name) || '';
+        });
+    }
+    processConditionals(template, data) {
+        return template.replace(/\{\{#if\s+(\w+)\}\}([\s\S]*?)(?:\{\{else\}\}([\s\S]*?))?\{\{\/if\}\}/g, (_, condition, truthy, falsy = '') => {
+            const value = this.getValue(data, condition);
+            return value ? truthy : falsy;
+        });
+    }
+    processLoops(template, data) {
+        return template.replace(/\{\{#each\s+(\w+)\}\}([\s\S]*?)\{\{\/each\}\}/g, (_, arrayName, body) => {
+            const array = this.getValue(data, arrayName);
+            if (!Array.isArray(array)) {
+                return '';
+            }
+            return array
+                .map((item) => {
+                let itemBody = body;
+                if (typeof item === 'object') {
+                    for (const [key, value] of Object.entries(item)) {
+                        const regex = new RegExp(`\\{\\{${key}\\}\\}`, 'g');
+                        itemBody = itemBody.replace(regex, String(value));
+                    }
+                }
+                else {
+                    itemBody = itemBody.replace(/\{\{this\}\}/g, String(item));
+                }
+                return itemBody;
+            })
+                .join('');
+        });
+    }
+    processVariables(template, data) {
+        return template.replace(/\{\{(\w+(?:\.\w+)*)\}\}/g, (_, key) => {
+            const value = this.getValue(data, key);
+            return value !== undefined && value !== null ? String(value) : '';
+        });
+    }
+    getValue(data, path) {
+        const keys = path.split('.');
+        let value = data;
+        for (const key of keys) {
+            if (!value || typeof value !== 'object') {
+                return undefined;
+            }
+            value = value[key];
+        }
+        return value;
+    }
+}
+/**
+ * Main template engine manager
+ */
+export class TemplateEngineManager {
+    config;
+    engine;
+    cache = new Map();
+    engineType;
+    constructor(config = {}) {
+        this.config = {
+            engine: 'moro',
+            cache: true,
+            ...config,
+        };
+        this.engineType = this.config.engine || 'moro';
+        this.engine = this.createEngine(this.engineType);
+    }
+    /**
+     * Create template engine instance
+     */
+    createEngine(type) {
+        if (type === 'moro') {
+            return new MoroTemplateEngine();
+        }
+        throw new Error(`Template engine "${type}" will be lazy loaded when needed`);
+    }
+    /**
+     * Render a template file with data
+     */
+    async renderFile(templateName, data) {
+        if (!this.config.path) {
+            throw new Error('Template path not configured');
+        }
+        const cacheKey = `${templateName}:${this.engineType}`;
+        if (!this.config.cache || !this.cache.has(cacheKey)) {
+            const templatePath = path.join(this.config.path, `${templateName}.html`);
+            try {
+                const template = await fs.readFile(templatePath, 'utf-8');
+                if (this.config.cache && this.engine.compile) {
+                    this.cache.set(cacheKey, this.engine.compile(template));
+                }
+            }
+            catch {
+                throw new Error(`Template file not found: ${templatePath}`);
+            }
+        }
+        if (this.config.cache && this.cache.has(cacheKey)) {
+            const compiled = this.cache.get(cacheKey);
+            const html = compiled(data);
+            return { html };
+        }
+        const templatePath = path.join(this.config.path, `${templateName}.html`);
+        const template = await fs.readFile(templatePath, 'utf-8');
+        const html = await this.engine.render(template, data);
+        return { html };
+    }
+    /**
+     * Render a template string with data
+     */
+    async renderString(template, data) {
+        return await this.engine.render(template, data);
+    }
+    /**
+     * Load external template engine (Handlebars, EJS)
+     */
+    async loadExternalEngine(type) {
+        if (type === 'moro') {
+            return;
+        }
+        if (type === 'handlebars') {
+            if (!isPackageAvailable('handlebars')) {
+                throw new Error('Handlebars is not installed.\n' + 'Install it with: npm install handlebars');
+            }
+            const handlebarsPath = resolveUserPackage('handlebars');
+            const Handlebars = await import(handlebarsPath);
+            this.engine = {
+                render: async (template, data) => {
+                    const compiledTemplate = Handlebars.default.compile(template);
+                    return compiledTemplate(data);
+                },
+                compile: (template) => {
+                    return Handlebars.default.compile(template);
+                },
+                registerHelper: (name, fn) => {
+                    Handlebars.default.registerHelper(name, fn);
+                },
+                registerPartial: (name, template) => {
+                    Handlebars.default.registerPartial(name, template);
+                },
+            };
+        }
+        else if (type === 'ejs') {
+            if (!isPackageAvailable('ejs')) {
+                throw new Error('EJS is not installed.\n' + 'Install it with: npm install ejs');
+            }
+            const ejsPath = resolveUserPackage('ejs');
+            const ejs = await import(ejsPath);
+            this.engine = {
+                render: async (template, data) => {
+                    return ejs.default.render(template, data);
+                },
+                compile: (template) => {
+                    return ejs.default.compile(template);
+                },
+            };
+        }
+    }
+    /**
+     * Register a helper function
+     */
+    registerHelper(name, fn) {
+        if (this.engine.registerHelper) {
+            this.engine.registerHelper(name, fn);
+        }
+    }
+    /**
+     * Register a partial template
+     */
+    registerPartial(name, template) {
+        if (this.engine.registerPartial) {
+            this.engine.registerPartial(name, template);
+        }
+    }
+    /**
+     * Clear template cache
+     */
+    clearCache() {
+        this.cache.clear();
+    }
+    /**
+     * Load partials from directory
+     */
+    async loadPartials() {
+        if (!this.config.partials) {
+            return;
+        }
+        try {
+            const files = await fs.readdir(this.config.partials);
+            for (const file of files) {
+                if (file.endsWith('.html')) {
+                    const name = file.replace('.html', '');
+                    const content = await fs.readFile(path.join(this.config.partials, file), 'utf-8');
+                    this.registerPartial(name, content);
+                }
+            }
+        }
+        catch {
+            // Partials directory doesn't exist or can't be read
+        }
+    }
+}
+//# sourceMappingURL=template-engine.js.map

package/dist/core/mail/template-engine.js.map

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

package/dist/core/mail/types.d.ts

@@ -0,0 +1,237 @@
+/**
+ * Email address representation
+ */
+export interface EmailAddress {
+    name?: string;
+    email: string;
+}
+/**
+ * Email attachment
+ */
+export interface EmailAttachment {
+    filename: string;
+    content: Buffer | string;
+    encoding?: string;
+    contentType?: string;
+    cid?: string;
+}
+/**
+ * Core email options
+ */
+export interface MailOptions {
+    to: string | string[] | EmailAddress | EmailAddress[];
+    from?: string | EmailAddress;
+    subject: string;
+    text?: string;
+    html?: string;
+    template?: string;
+    data?: Record<string, any>;
+    cc?: string | string[] | EmailAddress | EmailAddress[];
+    bcc?: string | string[] | EmailAddress | EmailAddress[];
+    replyTo?: string | EmailAddress;
+    attachments?: EmailAttachment[];
+    headers?: Record<string, string>;
+    priority?: 'high' | 'normal' | 'low';
+    messageId?: string;
+    references?: string | string[];
+    inReplyTo?: string;
+    sender?: string | EmailAddress;
+    returnPath?: string;
+    listUnsubscribe?: string | string[];
+    listUnsubscribePost?: string;
+    listId?: string;
+    listHelp?: string;
+    listSubscribe?: string;
+    listOwner?: string;
+    listArchive?: string;
+    dsn?: {
+        notify?: 'never' | 'success' | 'failure' | 'delay';
+        returnFull?: boolean;
+        returnHeaders?: boolean;
+    };
+    encoding?: string;
+    textEncoding?: string;
+    date?: Date;
+    messageIdDomain?: string;
+    tags?: string[];
+    metadata?: Record<string, string>;
+    scheduledAt?: Date;
+}
+/**
+ * Email send result
+ */
+export interface MailResult {
+    success: boolean;
+    messageId?: string;
+    error?: string;
+    accepted?: string[];
+    rejected?: string[];
+    response?: string;
+}
+/**
+ * Adapter types
+ */
+export type MailAdapterType = 'nodemailer' | 'sendgrid' | 'ses' | 'resend' | 'console';
+/**
+ * Template engine types
+ */
+export type TemplateEngine = 'moro' | 'handlebars' | 'ejs';
+/**
+ * Template configuration
+ */
+export interface TemplateConfig {
+    path?: string;
+    engine?: TemplateEngine;
+    cache?: boolean;
+    partials?: string;
+    layouts?: string;
+    helpers?: Record<string, (...args: any[]) => any>;
+}
+/**
+ * Queue configuration for async email sending
+ */
+export interface MailQueueConfig {
+    enabled?: boolean;
+    name?: string;
+    priority?: number;
+    delay?: number;
+    attempts?: number;
+}
+/**
+ * Mail manager configuration
+ */
+export interface MailConfig {
+    adapter?: MailAdapterType | string;
+    from?: string | EmailAddress;
+    connection?: any;
+    templates?: TemplateConfig;
+    queue?: MailQueueConfig;
+    debug?: boolean;
+}
+/**
+ * Nodemailer-specific connection options
+ */
+export interface NodemailerConnection {
+    host?: string;
+    port?: number;
+    secure?: boolean;
+    auth?: {
+        user: string;
+        pass: string;
+    };
+    service?: string;
+    pool?: boolean;
+    maxConnections?: number;
+    maxMessages?: number;
+}
+/**
+ * SendGrid-specific connection options
+ */
+export interface SendGridConnection {
+    apiKey: string;
+    sandboxMode?: boolean;
+}
+/**
+ * AWS SES-specific connection options
+ */
+export interface SESConnection {
+    region: string;
+    accessKeyId?: string;
+    secretAccessKey?: string;
+    credentials?: any;
+    configurationSet?: string;
+}
+/**
+ * Resend-specific connection options
+ */
+export interface ResendConnection {
+    apiKey: string;
+}
+/**
+ * Template render result
+ */
+export interface TemplateResult {
+    html?: string;
+    text?: string;
+}
+/**
+ * Base mail adapter interface
+ */
+export interface MailAdapter {
+    /**
+     * Initialize the adapter with configuration
+     */
+    initialize(config: any): Promise<void>;
+    /**
+     * Send an email
+     */
+    send(options: MailOptions): Promise<MailResult>;
+    /**
+     * Send multiple emails in bulk
+     */
+    sendBulk?(options: MailOptions[]): Promise<MailResult[]>;
+    /**
+     * Verify adapter connection
+     */
+    verify?(): Promise<boolean>;
+    /**
+     * Close adapter connections
+     */
+    close?(): Promise<void>;
+    /**
+     * Get adapter name
+     */
+    getName(): string;
+}
+/**
+ * Template engine interface
+ */
+export interface TemplateEngineInterface {
+    /**
+     * Render a template with data
+     */
+    render(template: string, data: Record<string, any>): Promise<string>;
+    /**
+     * Compile a template for caching
+     */
+    compile?(template: string): any;
+    /**
+     * Register a helper function
+     */
+    registerHelper?(name: string, fn: (...args: any[]) => any): void;
+    /**
+     * Register a partial template
+     */
+    registerPartial?(name: string, template: string): void;
+}
+/**
+ * Mail events
+ */
+export interface MailEvents {
+    'mail:configured': {
+        config: MailConfig;
+    };
+    'mail:sending': {
+        options: MailOptions;
+    };
+    'mail:sent': {
+        result: MailResult;
+        options: MailOptions;
+    };
+    'mail:failed': {
+        error: Error;
+        options: MailOptions;
+    };
+    'mail:queued': {
+        jobId: string;
+        options: MailOptions;
+    };
+    'template:rendered': {
+        template: string;
+        data: Record<string, any>;
+    };
+    'template:error': {
+        error: Error;
+        template: string;
+    };
+}

package/dist/core/mail/types.js

@@ -0,0 +1,4 @@
+// Email System Types
+// ESM-first module with full TypeScript support
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/mail/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/mail/types.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,gDAAgD"}

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

@@ -0,0 +1,12 @@
+import { HttpRequest, HttpResponse } from '../../../../types/http.js';
+export interface BodySizeOptions {
+    limit?: string | number;
+}
+export declare class BodySizeCore {
+    private limitBytes;
+    constructor(options?: BodySizeOptions);
+    private parseSize;
+    checkBodySize(req: HttpRequest, res: HttpResponse): boolean;
+    private formatSize;
+    getLimit(): number;
+}

package/dist/core/middleware/built-in/body-size/core.js

@@ -0,0 +1,52 @@
+export class BodySizeCore {
+    limitBytes;
+    constructor(options = {}) {
+        this.limitBytes = this.parseSize(options.limit || '10mb');
+    }
+    parseSize(size) {
+        if (typeof size === 'number') {
+            return size;
+        }
+        const units = {
+            b: 1,
+            kb: 1024,
+            mb: 1024 * 1024,
+            gb: 1024 * 1024 * 1024,
+        };
+        const match = size.toLowerCase().match(/^(\d+(?:\.\d+)?)\s*(b|kb|mb|gb)?$/);
+        if (!match)
+            return 10 * 1024 * 1024; // Default 10MB
+        const value = parseFloat(match[1]);
+        const unit = match[2] || 'b';
+        return Math.round(value * units[unit]);
+    }
+    checkBodySize(req, res) {
+        const contentLength = parseInt(req.headers['content-length'] || '0');
+        if (contentLength > this.limitBytes) {
+            res.status(413).json({
+                success: false,
+                error: 'Request entity too large',
+                limit: this.formatSize(this.limitBytes),
+                received: this.formatSize(contentLength),
+            });
+            return false;
+        }
+        return true;
+    }
+    formatSize(bytes) {
+        if (bytes >= 1024 * 1024 * 1024) {
+            return `${(bytes / (1024 * 1024 * 1024)).toFixed(2)}GB`;
+        }
+        else if (bytes >= 1024 * 1024) {
+            return `${(bytes / (1024 * 1024)).toFixed(2)}MB`;
+        }
+        else if (bytes >= 1024) {
+            return `${(bytes / 1024).toFixed(2)}KB`;
+        }
+        return `${bytes}B`;
+    }
+    getLimit() {
+        return this.limitBytes;
+    }
+}
+//# sourceMappingURL=core.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../../../../src/core/middleware/built-in/body-size/core.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,YAAY;IACf,UAAU,CAAS;IAE3B,YAAY,UAA2B,EAAE;QACvC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC,CAAC;IAC5D,CAAC;IAEO,SAAS,CAAC,IAAqB;QACrC,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,KAAK,GAA8B;YACvC,CAAC,EAAE,CAAC;YACJ,EAAE,EAAE,IAAI;YACR,EAAE,EAAE,IAAI,GAAG,IAAI;YACf,EAAE,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI;SACvB,CAAC;QAEF,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;QAC5E,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,eAAe;QAEpD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;QAE7B,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,aAAa,CAAC,GAAgB,EAAE,GAAiB;QAC/C,MAAM,aAAa,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,GAAG,CAAC,CAAC;QAErE,IAAI,aAAa,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YACpC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBACnB,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,0BAA0B;gBACjC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC;gBACvC,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC;aACzC,CAAC,CAAC;YACH,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,UAAU,CAAC,KAAa;QAC9B,IAAI,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC;YAChC,OAAO,GAAG,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;QAC1D,CAAC;aAAM,IAAI,KAAK,IAAI,IAAI,GAAG,IAAI,EAAE,CAAC;YAChC,OAAO,GAAG,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;QACnD,CAAC;aAAM,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;YACzB,OAAO,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;QAC1C,CAAC;QACD,OAAO,GAAG,KAAK,GAAG,CAAC;IACrB,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;CACF"}

package/dist/core/middleware/built-in/body-size/hook.d.ts

@@ -0,0 +1,2 @@
+import { BodySizeOptions } from './core.js';
+export declare function registerBodySizeHooks(hookManager: any, options?: BodySizeOptions): void;

package/dist/core/middleware/built-in/body-size/hook.js

@@ -0,0 +1,12 @@
+// Body Size Hook Integration
+import { BodySizeCore } from './core.js';
+export function registerBodySizeHooks(hookManager, options = {}) {
+    const core = new BodySizeCore(options);
+    hookManager.on('request', async (context) => {
+        const { request, response } = context;
+        if (!request || !response)
+            return;
+        core.checkBodySize(request, response);
+    });
+}
+//# sourceMappingURL=hook.js.map

package/dist/core/middleware/built-in/body-size/hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.js","sourceRoot":"","sources":["../../../../../src/core/middleware/built-in/body-size/hook.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,OAAO,EAAE,YAAY,EAAmB,MAAM,WAAW,CAAC;AAE1D,MAAM,UAAU,qBAAqB,CAAC,WAAgB,EAAE,UAA2B,EAAE;IACnF,MAAM,IAAI,GAAG,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC;IAEvC,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,OAAY,EAAE,EAAE;QAC/C,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;QACtC,IAAI,CAAC,OAAO,IAAI,CAAC,QAAQ;YAAE,OAAO;QAElC,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,6 @@
+export { BodySizeCore } from './core.js';
+export type { BodySizeOptions } from './core.js';
+export { createBodySizeMiddleware } from './middleware.js';
+export { registerBodySizeHooks } from './hook.js';
+import { createBodySizeMiddleware } from './middleware.js';
+export declare const bodySize: typeof createBodySizeMiddleware;

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

@@ -0,0 +1,7 @@
+// Body Size Middleware - Centralized Exports
+export { BodySizeCore } from './core.js';
+export { createBodySizeMiddleware } from './middleware.js';
+export { registerBodySizeHooks } from './hook.js';
+import { createBodySizeMiddleware } from './middleware.js';
+export const bodySize = createBodySizeMiddleware;
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/middleware/built-in/body-size/index.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAElD,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,MAAM,CAAC,MAAM,QAAQ,GAAG,wBAAwB,CAAC"}

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

@@ -0,0 +1,14 @@
+import { Middleware } from '../../../../types/http.js';
+import { BodySizeOptions } from './core.js';
+/**
+ * Create body size limit middleware
+ *
+ * @example
+ * ```typescript
+ * import { bodySize } from '@morojs/moro';
+ *
+ * app.use(bodySize({ limit: '10mb' }));
+ * app.use(bodySize({ limit: 1024 * 1024 * 5 })); // 5MB
+ * ```
+ */
+export declare function createBodySizeMiddleware(options?: BodySizeOptions): Middleware;

package/dist/core/middleware/built-in/body-size/middleware.js

@@ -0,0 +1,22 @@
+import { BodySizeCore } from './core.js';
+/**
+ * Create body size limit middleware
+ *
+ * @example
+ * ```typescript
+ * import { bodySize } from '@morojs/moro';
+ *
+ * app.use(bodySize({ limit: '10mb' }));
+ * app.use(bodySize({ limit: 1024 * 1024 * 5 })); // 5MB
+ * ```
+ */
+export function createBodySizeMiddleware(options = {}) {
+    const core = new BodySizeCore(options);
+    return (req, res, next) => {
+        if (!core.checkBodySize(req, res)) {
+            return; // Request rejected
+        }
+        next();
+    };
+}
+//# sourceMappingURL=middleware.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../../../../src/core/middleware/built-in/body-size/middleware.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAmB,MAAM,WAAW,CAAC;AAE1D;;;;;;;;;;GAUG;AACH,MAAM,UAAU,wBAAwB,CAAC,UAA2B,EAAE;IACpE,MAAM,IAAI,GAAG,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC;IAEvC,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QACxB,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;YAClC,OAAO,CAAC,mBAAmB;QAC7B,CAAC;QACD,IAAI,EAAE,CAAC;IACT,CAAC,CAAC;AACJ,CAAC"}

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

@@ -1,5 +1,24 @@
 import { HttpRequest, HttpResponse } from '../../../../types/http.js';
-export interface CacheConfig {
+/**
+ * HTTP Caching Options for Cache-Control, ETags, etc.
+ */
+export interface HttpCachingOptions {
+    /** Enable HTTP caching headers (default: true) */
+    httpCaching?: boolean;
+    /** Default max-age for Cache-Control header (seconds) */
+    maxAge?: number;
+    /** Cache-Control header (overrides maxAge if provided) */
+    cacheControl?: string;
+    /** Vary header for proper caching */
+    vary?: string[];
+    /** Enable ETag generation (default: true) */
+    etag?: boolean | 'strong' | 'weak';
+    /** Enable conditional request handling (default: true) */
+    conditionalRequests?: boolean;
+    /** Custom ETag generator function */
+    generateETag?: (content: string, type?: string) => string;
+}
+export interface CacheConfig extends HttpCachingOptions {
     ttl: number;
     key?: string;
     tags?: string[];