@morojs/moro 1.6.8 → 1.7.1

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[];

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

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

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

@@ -1,13 +1,14 @@
 import { MiddlewareInterface } from '../../../../types/hooks.js';
 import { CacheOptions } from '../../../../types/cache.js';
 /**
- * Advanced cache hook with pluggable storage adapters
+ * Advanced cache hook with pluggable storage adapters and HTTP caching
  * Registers with the hooks system for global usage
  *
  * @example
  * ```ts
  * import { cache } from '@/middleware/built-in/cache';
  *
+ * // Server-side caching with Redis
  * app.use(cache({
  *   adapter: 'redis',
  *   defaultTtl: 3600,
@@ -15,6 +16,42 @@ import { CacheOptions } from '../../../../types/cache.js';
  *     '/api/.*': { ttl: 60 }
  *   }
  * }));
+ *
+ * // HTTP caching with ETags and conditional requests
+ * app.use(cache({
+ *   httpCaching: true,
+ *   maxAge: 300,
+ *   etag: 'strong',
+ *   conditionalRequests: true
+ * }));
+ *
+ * // Combined server-side + HTTP caching
+ * app.use(cache({
+ *   adapter: 'memory',
+ *   defaultTtl: 3600,
+ *   httpCaching: true,
+ *   maxAge: 300,
+ *   strategies: {
+ *     '/api/users': { ttl: 300, maxAge: 60 },
+ *     '/api/posts': { ttl: 1800, maxAge: 300 }
+ *   }
+ * }));
+ *
+ * // Redis server-side caching only
+ * app.use(cache({
+ *   adapter: 'redis',
+ *   defaultTtl: 3600,
+ *   httpCaching: false, // Disable HTTP caching
+ *   strategies: { '/api/.*': { ttl: 60 } }
+ * }));
+ *
+ * // HTTP caching only (no server-side storage)
+ * app.use(cache({
+ *   httpCaching: true,
+ *   maxAge: 300,
+ *   etag: 'strong',
+ *   vary: ['Accept-Language', 'User-Agent']
+ * }));
  * ```
  */
 export declare const cache: (options?: CacheOptions) => MiddlewareInterface;