@warlock.js/core 4.0.48 → 4.0.59

package/esm/index.js

@@ -1,28 +1 @@
-export { env } from '@mongez/dotenv';
-import './validation/init';
-export { colors } from '@mongez/copper';
-export * from './application';
-export * from './bootstrap';
-export * from './bootstrap/setup';
-export * from './cache';
-export * from './cli';
-export * from './config';
-export * from './database';
-export * from './dev2-server/connectors';
-export * from './dev2-server/health-checker';
-export * from './http';
-export * from './image';
-export * from './logger';
-export * from './mail';
-export * from './react';
-export * from './repositories';
-export * from './resource';
-export * from './restful';
-export * from './router';
-export * from './storage';
-export * from './store';
-export * from './utils';
-export * from './validation';
-export * from './warlock-config';
-//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map
+export{env}from'@mongez/dotenv';import'./validation/init.js';export{colors}from'@mongez/copper';export{bootstrap}from'./bootstrap.js';export{displayEnvironmentMode}from'./bootstrap/setup.js';import'./cache/index.js';export{CLICommand,command}from'./cli/cli-command.js';export{config}from'./config/config-getter.js';export{registerAppConfig,registerLogConfig,registerMailConfig}from'./config/config-handlers.js';export{ConfigSpecialHandlers,configSpecialHandlers}from'./config/config-special-handlers.js';export{DatabaseLogModel}from'./database/models/database-log/database-log.js';export{seeder}from'./database/seeds/seeder.js';export{useComputedModel,useComputedSlug,useHashedPassword}from'./database/utils.js';export{BaseConnector}from'./dev2-server/connectors/base-connector.js';export{CacheConnector}from'./dev2-server/connectors/cache-connector.js';export{ConnectorsManager,connectorsManager}from'./dev2-server/connectors/connectors-manager.js';export{DatabaseConnector}from'./dev2-server/connectors/database-connector.js';export{HttpConnector}from'./dev2-server/connectors/http-connector.js';export{StorageConnector}from'./dev2-server/connectors/storage.connector.js';export{ConnectorPriority}from'./dev2-server/connectors/types.js';export{BaseHealthChecker}from'./dev2-server/health-checker/checkers/base-health-checker.js';export{EslintHealthChecker}from'./dev2-server/health-checker/checkers/eslint-health-checker.js';export{TypescriptHealthChecker}from'./dev2-server/health-checker/checkers/typescript-health-checker.js';import'./dev2-server/health-checker/workers/eslint-health.worker.js';import'./dev2-server/health-checker/workers/ts-health.worker.js';export{defaultHttpConfigurations,httpConfig}from'./http/config.js';export{createHttpApplication,stopHttpApplication}from'./http/createHttpApplication.js';export{RequestLog}from'./http/database/RequestLog.js';export{logResponse,wrapResponseInDataKey}from'./http/events.js';export{RequestController}from'./http/request-controller.js';export{UploadedFile}from'./http/uploaded-file.js';export{UPLOADS_DEFAULTS,uploadsConfig}from'./http/uploads-config.js';export{BadRequestError,ForbiddenError,ResourceNotFoundError,ServerError,UnAuthorizedError}from'./http/errors/resource-not-found.error.js';export{cacheMiddleware}from'./http/middleware/cache-response-middleware.js';export{createRequestStore,fromRequest,t}from'./http/middleware/inject-request-context.js';export{registerHttpPlugins}from'./http/plugins.js';export{Request}from'./http/request.js';export{Response,ResponseStatus}from'./http/response.js';export{getServer,startServer}from'./http/server.js';export{requestContext,useCurrentUser,useRequest,useRequestStore}from'./http/context/request-context.js';export{Image}from'./image/image.js';export{setLogConfigurations}from'./logger/logger.js';export{getDefaultMailConfig,getMailMode,getMailerConfig,isDevelopmentMode,isProductionMode,isTestMode,resetMailConfig,resolveMailConfig,setMailConfigurations,setMailMode}from'./mail/config.js';export{MAIL_EVENTS,generateMailId,getMailEventName,mailEvents}from'./mail/events.js';export{closeAllMailers,closeMailer,getMailer,getPoolStats,verifyMailer}from'./mail/mailer-pool.js';export{renderReactMail}from'./mail/react-mail.js';export{sendMail}from'./mail/send-mail.js';export{Mail}from'./mail/mail.js';export{assertMailCount,assertMailSent,captureMail,clearTestMailbox,findMailsBySubject,findMailsTo,getLastMail,getMailboxSize,getTestMailbox,wasMailSentTo,wasMailSentWithSubject}from'./mail/test-mailbox.js';export{MailError}from'./mail/types.js';export{renderReact}from'./react/index.js';export{CascadeAdapter}from'./repositories/adapters/cascade/cascade-adapter.js';export{CascadeQueryBuilder}from'./repositories/adapters/cascade/cascade-query-builder.js';export{RepositoryManager}from'./repositories/repository.manager.js';export{defineResource}from'./resource/define-resource.js';export{Resource}from'./resource/resource.js';export{ResourceFieldBuilder}from'./resource/resource-field-builder.js';export{Restful}from'./restful/restful.js';export{Router,router}from'./router/router.js';export{route}from'./router/utils.js';export{storageConfig,storageConfigurations}from'./storage/config.js';export{ScopedStorage}from'./storage/scoped-storage.js';export{Storage,storage}from'./storage/storage.js';export{StorageFile}from'./storage/storage-file.js';export{storageDriverContext}from'./storage/context/storage-driver-context.js';export{MimeTypes,getMimeType}from'./storage/utils/mime.js';export{CloudDriver}from'./storage/drivers/cloud-driver.js';export{DOSpacesDriver}from'./storage/drivers/do-spaces-driver.js';export{LocalDriver}from'./storage/drivers/local-driver.js';export{R2Driver}from'./storage/drivers/r2-driver.js';export{S3Driver}from'./storage/drivers/s3-driver.js';export{createStore,useStore}from'./store/index.js';export{appLog}from'./utils/app-log.js';export{DatabaseLog}from'./utils/database-log.js';export{environment,setEnvironment}from'./utils/environment.js';export{getLocalized}from'./utils/get-localized.js';export{appPath,cachePath,configPath,consolePath,publicPath,rootPath,sanitizePath,srcPath,storagePath,tempPath,uploadsPath,warlockPath}from'./utils/paths.js';export{promiseAllObject}from'./utils/promise-all-object.js';export{Queue}from'./utils/queue.js';export{sleep}from'./utils/sleep.js';export{sluggable}from'./utils/sluggable.js';export{toJson}from'./utils/to-json.js';export{assetsUrl,publicUrl,setBaseUrl,uploadsUrl,url}from'./utils/urls.js';export{FileValidator,uploadedFileMetadataSchema}from'./validation/validators/file-validator.js';export{existsRule}from'./validation/database/exists.js';export{existsExceptCurrentIdRule}from'./validation/database/exists-except-current-id.js';export{existsExceptCurrentUserRule}from'./validation/database/exists-except-current-user.js';export{uniqueRule}from'./validation/database/unique.js';export{uniqueExceptCurrentIdRule}from'./validation/database/unique-except-current-id.js';export{uniqueExceptCurrentUserRule}from'./validation/database/unique-except-current-user.js';export{fileExtensionRule,fileRule,fileTypeRule,imageRule}from'./validation/file/file.js';export{v}from'@warlock.js/seal';export{defineConfig}from'./warlock-config/define-config.js';export{WarlockConfigManager,warlockConfigManager}from'./warlock-config/warlock-config.manager.js';export{DatabaseCacheDriver}from'./cache/database-cache-driver.js';//# sourceMappingURL=index.js.map

package/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js","sourcesContent":[]}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/esm/logger/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./logger";
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

package/esm/logger/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/logger/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC"}

package/esm/logger/logger.d.ts

@@ -0,0 +1,3 @@
+import type { LogConfigurations } from "./types";
+export declare function setLogConfigurations(options: LogConfigurations): void;
+//# sourceMappingURL=logger.d.ts.map

package/esm/logger/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logger/logger.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,QAoB9D"}

package/esm/logger/logger.js

@@ -0,0 +1,16 @@
+import {logger}from'@warlock.js/logger';import'../database/models/database-log/database-log.js';import {environment}from'../utils/environment.js';import'../http/context/request-context.js';import'@mongez/config';import'path';import'@mongez/slug';import'@mongez/supportive-is';import'@mongez/reinforcements';function setLogConfigurations(options) {
+    // log configurations
+    const channels = [];
+    const env = environment();
+    const envChannels = options[env]?.channels;
+    const defaultChannels = options.channels;
+    if (defaultChannels) {
+        channels.push(...defaultChannels);
+    }
+    if (envChannels) {
+        channels.push(...envChannels);
+    }
+    logger.configure({
+        channels,
+    });
+}export{setLogConfigurations};//# sourceMappingURL=logger.js.map

package/esm/logger/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sources":["../../src/logger/logger.ts"],"sourcesContent":[null],"names":[],"mappings":"mTAKM,SAAU,oBAAoB,CAAC,OAA0B,EAAA;;IAE7D,MAAM,QAAQ,GAAiB,EAAE,CAAC;AAElC,IAAA,MAAM,GAAG,GAAG,WAAW,EAAE,CAAC;IAE1B,MAAM,WAAW,GAAG,OAAO,CAAC,GAAmC,CAAC,EAAE,QAAQ,CAAC;AAC3E,IAAA,MAAM,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC;AAEzC,IAAA,IAAI,eAAe,EAAE;AACnB,QAAA,QAAQ,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,CAAC;AACnC,KAAA;AAED,IAAA,IAAI,WAAW,EAAE;AACf,QAAA,QAAQ,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC;AAC/B,KAAA;IAED,MAAM,CAAC,SAAS,CAAC;QACf,QAAQ;AACT,KAAA,CAAC,CAAC;AACL"}

package/esm/logger/types.d.ts

@@ -0,0 +1,39 @@
+import type { LogChannel } from "@warlock.js/logger";
+type EnvironmentConfigurations = {
+    /**
+     * List of logging channels
+     */
+    channels: LogChannel[];
+    /**
+     * Enable logging
+     *
+     * @default true
+     */
+    enabled?: boolean;
+};
+export type LogConfigurations = {
+    /**
+     * Channels list
+     * It will be used in all environments
+     */
+    channels?: LogChannel[];
+    /**
+     * Enable logging
+     */
+    enabled?: boolean;
+    /**
+     * Development environment configurations
+     * This will override the default configurations
+     */
+    development?: EnvironmentConfigurations;
+    /**
+     * Test environment configurations
+     */
+    test?: EnvironmentConfigurations;
+    /**
+     * Production environment configurations
+     */
+    production?: EnvironmentConfigurations;
+};
+export {};
+//# sourceMappingURL=types.d.ts.map

package/esm/logger/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/logger/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,KAAK,yBAAyB,GAAG;IAC/B;;OAEG;IACH,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AACF,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;;OAGG;IACH,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;IACxB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,WAAW,CAAC,EAAE,yBAAyB,CAAC;IACxC;;OAEG;IACH,IAAI,CAAC,EAAE,yBAAyB,CAAC;IACjC;;OAEG;IACH,UAAU,CAAC,EAAE,yBAAyB,CAAC;CACxC,CAAC"}

package/esm/mail/config.d.ts

@@ -0,0 +1,83 @@
+import type { MailConfigurations, MailersConfig, MailMode } from "./types";
+/**
+ * Set the mail mode
+ *
+ * @param mode "production" | "development" | "test"
+ *
+ * - **production**: Actually sends emails via SMTP
+ * - **development**: Logs emails to console without sending
+ * - **test**: Captures emails to test mailbox for assertions
+ *
+ * @example
+ * ```typescript
+ * // In test setup
+ * setMailMode("test");
+ *
+ * // In development
+ * setMailMode("development");
+ * ```
+ */
+export declare function setMailMode(mode: MailMode): void;
+/**
+ * Get the current mail mode
+ */
+export declare function getMailMode(): MailMode;
+/**
+ * Check if in production mode
+ */
+export declare function isProductionMode(): boolean;
+/**
+ * Check if in development mode
+ */
+export declare function isDevelopmentMode(): boolean;
+/**
+ * Check if in test mode
+ */
+export declare function isTestMode(): boolean;
+/**
+ * Set mail configurations
+ *
+ * Supports both simple config and named mailers.
+ *
+ * @example
+ * ```typescript
+ * // Simple config (sets as default)
+ * setMailConfigurations({
+ *   host: "smtp.gmail.com",
+ *   port: 587,
+ *   username: "...",
+ *   password: "...",
+ * });
+ *
+ * // Named mailers
+ * setMailConfigurations({
+ *   default: { host: "smtp.sendgrid.net", ... },
+ *   mailers: {
+ *     marketing: { host: "smtp.mailchimp.com", ... },
+ *     transactional: { host: "smtp.postmark.com", ... },
+ *   },
+ * });
+ * ```
+ */
+export declare function setMailConfigurations(config: MailConfigurations | MailersConfig): void;
+/**
+ * Get the default mail configuration
+ */
+export declare function getDefaultMailConfig(): MailConfigurations;
+/**
+ * Get a named mailer configuration
+ */
+export declare function getMailerConfig(name: string): MailConfigurations | undefined;
+/**
+ * Resolve configuration from options
+ * Priority: config > mailer > default
+ */
+export declare function resolveMailConfig(options: {
+    config?: MailConfigurations;
+    mailer?: string;
+}): MailConfigurations;
+/**
+ * Reset all configurations (useful for testing)
+ */
+export declare function resetMailConfig(): void;
+//# sourceMappingURL=config.d.ts.map

package/esm/mail/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/mail/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAoB3E;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAEhD;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,kBAAkB,GAAG,aAAa,GAAG,IAAI,CAUtF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,kBAAkB,CAKzD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAc5E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IACzC,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,kBAAkB,CAoBrB;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAGtC"}

package/esm/mail/config.js

@@ -0,0 +1,152 @@
+/**
+ * Default mail configurations
+ */
+const defaultConfigurations = {
+    secure: true,
+    tls: true,
+};
+/**
+ * Current mail mode
+ */
+let currentMode = "production";
+/**
+ * Registered mailers configuration
+ */
+let mailersConfig = {};
+/**
+ * Set the mail mode
+ *
+ * @param mode "production" | "development" | "test"
+ *
+ * - **production**: Actually sends emails via SMTP
+ * - **development**: Logs emails to console without sending
+ * - **test**: Captures emails to test mailbox for assertions
+ *
+ * @example
+ * ```typescript
+ * // In test setup
+ * setMailMode("test");
+ *
+ * // In development
+ * setMailMode("development");
+ * ```
+ */
+function setMailMode(mode) {
+    currentMode = mode;
+}
+/**
+ * Get the current mail mode
+ */
+function getMailMode() {
+    return currentMode;
+}
+/**
+ * Check if in production mode
+ */
+function isProductionMode() {
+    return currentMode === "production";
+}
+/**
+ * Check if in development mode
+ */
+function isDevelopmentMode() {
+    return currentMode === "development";
+}
+/**
+ * Check if in test mode
+ */
+function isTestMode() {
+    return currentMode === "test";
+}
+/**
+ * Set mail configurations
+ *
+ * Supports both simple config and named mailers.
+ *
+ * @example
+ * ```typescript
+ * // Simple config (sets as default)
+ * setMailConfigurations({
+ *   host: "smtp.gmail.com",
+ *   port: 587,
+ *   username: "...",
+ *   password: "...",
+ * });
+ *
+ * // Named mailers
+ * setMailConfigurations({
+ *   default: { host: "smtp.sendgrid.net", ... },
+ *   mailers: {
+ *     marketing: { host: "smtp.mailchimp.com", ... },
+ *     transactional: { host: "smtp.postmark.com", ... },
+ *   },
+ * });
+ * ```
+ */
+function setMailConfigurations(config) {
+    // Check if it's a MailersConfig (has 'default' or 'mailers' key)
+    if ("default" in config || "mailers" in config) {
+        mailersConfig = config;
+    }
+    else {
+        // Simple config - set as default
+        mailersConfig = {
+            default: config,
+        };
+    }
+}
+/**
+ * Get the default mail configuration
+ */
+function getDefaultMailConfig() {
+    return {
+        ...defaultConfigurations,
+        ...mailersConfig.default,
+    };
+}
+/**
+ * Get a named mailer configuration
+ */
+function getMailerConfig(name) {
+    if (name === "default") {
+        return getDefaultMailConfig();
+    }
+    const config = mailersConfig.mailers?.[name];
+    if (!config) {
+        return undefined;
+    }
+    return {
+        ...defaultConfigurations,
+        ...config,
+    };
+}
+/**
+ * Resolve configuration from options
+ * Priority: config > mailer > default
+ */
+function resolveMailConfig(options) {
+    // Direct config takes highest priority
+    if (options.config) {
+        return {
+            ...defaultConfigurations,
+            ...options.config,
+        };
+    }
+    // Named mailer
+    if (options.mailer) {
+        const config = getMailerConfig(options.mailer);
+        if (!config) {
+            throw new Error(`Mailer "${options.mailer}" not found in configuration`);
+        }
+        return config;
+    }
+    // Default
+    return getDefaultMailConfig();
+}
+/**
+ * Reset all configurations (useful for testing)
+ */
+function resetMailConfig() {
+    currentMode = "production";
+    mailersConfig = {};
+}export{getDefaultMailConfig,getMailMode,getMailerConfig,isDevelopmentMode,isProductionMode,isTestMode,resetMailConfig,resolveMailConfig,setMailConfigurations,setMailMode};//# sourceMappingURL=config.js.map

package/esm/mail/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sources":["../../src/mail/config.ts"],"sourcesContent":[null],"names":[],"mappings":"AAEA;;AAEG;AACH,MAAM,qBAAqB,GAAgC;AACzD,IAAA,MAAM,EAAE,IAAI;AACZ,IAAA,GAAG,EAAE,IAAI;CACV,CAAC;AAEF;;AAEG;AACH,IAAI,WAAW,GAAa,YAAY,CAAC;AAEzC;;AAEG;AACH,IAAI,aAAa,GAAkB,EAAE,CAAC;AAEtC;;;;;;;;;;;;;;;;;AAiBG;AACG,SAAU,WAAW,CAAC,IAAc,EAAA;IACxC,WAAW,GAAG,IAAI,CAAC;AACrB,CAAC;AAED;;AAEG;SACa,WAAW,GAAA;AACzB,IAAA,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;AAEG;SACa,gBAAgB,GAAA;IAC9B,OAAO,WAAW,KAAK,YAAY,CAAC;AACtC,CAAC;AAED;;AAEG;SACa,iBAAiB,GAAA;IAC/B,OAAO,WAAW,KAAK,aAAa,CAAC;AACvC,CAAC;AAED;;AAEG;SACa,UAAU,GAAA;IACxB,OAAO,WAAW,KAAK,MAAM,CAAC;AAChC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;AAwBG;AACG,SAAU,qBAAqB,CAAC,MAA0C,EAAA;;AAE9E,IAAA,IAAI,SAAS,IAAI,MAAM,IAAI,SAAS,IAAI,MAAM,EAAE;QAC9C,aAAa,GAAG,MAAuB,CAAC;AACzC,KAAA;AAAM,SAAA;;AAEL,QAAA,aAAa,GAAG;AACd,YAAA,OAAO,EAAE,MAA4B;SACtC,CAAC;AACH,KAAA;AACH,CAAC;AAED;;AAEG;SACa,oBAAoB,GAAA;IAClC,OAAO;AACL,QAAA,GAAG,qBAAqB;QACxB,GAAG,aAAa,CAAC,OAAO;KACzB,CAAC;AACJ,CAAC;AAED;;AAEG;AACG,SAAU,eAAe,CAAC,IAAY,EAAA;IAC1C,IAAI,IAAI,KAAK,SAAS,EAAE;QACtB,OAAO,oBAAoB,EAAE,CAAC;AAC/B,KAAA;IAED,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAC7C,IAAI,CAAC,MAAM,EAAE;AACX,QAAA,OAAO,SAAS,CAAC;AAClB,KAAA;IAED,OAAO;AACL,QAAA,GAAG,qBAAqB;AACxB,QAAA,GAAG,MAAM;KACV,CAAC;AACJ,CAAC;AAED;;;AAGG;AACG,SAAU,iBAAiB,CAAC,OAGjC,EAAA;;IAEC,IAAI,OAAO,CAAC,MAAM,EAAE;QAClB,OAAO;AACL,YAAA,GAAG,qBAAqB;YACxB,GAAG,OAAO,CAAC,MAAM;SAClB,CAAC;AACH,KAAA;;IAGD,IAAI,OAAO,CAAC,MAAM,EAAE;QAClB,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM,EAAE;YACX,MAAM,IAAI,KAAK,CAAC,CAAA,QAAA,EAAW,OAAO,CAAC,MAAM,CAA8B,4BAAA,CAAA,CAAC,CAAC;AAC1E,SAAA;AACD,QAAA,OAAO,MAAM,CAAC;AACf,KAAA;;IAGD,OAAO,oBAAoB,EAAE,CAAC;AAChC,CAAC;AAED;;AAEG;SACa,eAAe,GAAA;IAC7B,WAAW,GAAG,YAAY,CAAC;IAC3B,aAAa,GAAG,EAAE,CAAC;AACrB"}

package/esm/mail/events.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Generate a unique mail ID for event namespacing
+ */
+export declare function generateMailId(): string;
+/**
+ * Mail event names (global events)
+ */
+export declare const MAIL_EVENTS: {
+    readonly BEFORE_SENDING: "mail.beforeSending";
+    readonly SENT: "mail.sent";
+    readonly SUCCESS: "mail.success";
+    readonly ERROR: "mail.error";
+};
+/**
+ * Get namespaced event name for a specific mail
+ * @param mailId Unique mail identifier
+ * @param event Event type
+ * @returns Namespaced event name (e.g., "mail.abc123.success")
+ */
+export declare function getMailEventName(mailId: string, event: "beforeSending" | "sent" | "success" | "error"): string;
+/**
+ * Mail events wrapper
+ *
+ * Supports two event patterns:
+ * 1. Global events: `mail.success` - fires for ALL emails
+ * 2. Specific events: `mail.$mailId.success` - fires for ONE email
+ *
+ * ## Usage
+ *
+ * ```typescript
+ * // Global listener - all emails
+ * mailEvents.onSuccess((mail, result) => {
+ *   console.log("Any mail sent:", result.messageId);
+ * });
+ *
+ * // Specific listener - one email by ID
+ * const mailId = generateMailId();
+ * mailEvents.onMailSuccess(mailId, (mail, result) => {
+ *   console.log("This specific mail sent:", result.messageId);
+ * });
+ *
+ * await sendMail({
+ *   id: mailId, // Use the same ID
+ *   to: "user@example.com",
+ *   subject: "Hello",
+ *   html: "<p>World</p>",
+ * });
+ * ```
+ */
+export declare const mailEvents: {
+    /**
+     * Trigger a global mail event
+     */
+    trigger: (eventName: keyof typeof MAIL_EVENTS, ...args: any[]) => any;
+    /**
+     * Trigger a specific mail event (by mail ID)
+     */
+    triggerForMail: (mailId: string, event: "beforeSending" | "sent" | "success" | "error", ...args: any[]) => any;
+    /**
+     * Subscribe to global mail events
+     */
+    on: (eventName: keyof typeof MAIL_EVENTS, callback: (...args: any[]) => void) => import("@mongez/events").EventSubscription;
+    /**
+     * Subscribe to beforeSending event (all mails)
+     */
+    onBeforeSending: (callback: (mail: any) => void | Promise<void> | false | Promise<false>) => import("@mongez/events").EventSubscription;
+    /**
+     * Subscribe to sent event (all mails, after attempt)
+     */
+    onSent: (callback: (mail: any, result: any, error: any) => void | Promise<void>) => import("@mongez/events").EventSubscription;
+    /**
+     * Subscribe to success event (all mails)
+     */
+    onSuccess: (callback: (mail: any, result: any) => void | Promise<void>) => import("@mongez/events").EventSubscription;
+    /**
+     * Subscribe to error event (all mails)
+     */
+    onError: (callback: (mail: any, error: any) => void | Promise<void>) => import("@mongez/events").EventSubscription;
+    /**
+     * Subscribe to beforeSending event for a specific mail
+     */
+    onMailBeforeSending: (mailId: string, callback: (mail: any) => void | Promise<void> | false | Promise<false>) => import("@mongez/events").EventSubscription;
+    /**
+     * Subscribe to sent event for a specific mail
+     */
+    onMailSent: (mailId: string, callback: (mail: any, result: any, error: any) => void | Promise<void>) => import("@mongez/events").EventSubscription;
+    /**
+     * Subscribe to success event for a specific mail
+     */
+    onMailSuccess: (mailId: string, callback: (mail: any, result: any) => void | Promise<void>) => import("@mongez/events").EventSubscription;
+    /**
+     * Subscribe to error event for a specific mail
+     */
+    onMailError: (mailId: string, callback: (mail: any, error: any) => void | Promise<void>) => import("@mongez/events").EventSubscription;
+};
+//# sourceMappingURL=events.d.ts.map

package/esm/mail/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/mail/events.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;CAKd,CAAC;AAEX;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,eAAe,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GACpD,MAAM,CAER;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,UAAU;IACrB;;OAEG;yBACkB,MAAM,kBAAkB,WAAW,GAAG,EAAE;IAI7D;;OAEG;6BAEO,MAAM,SACP,eAAe,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,WAC5C,GAAG,EAAE;IAKhB;;OAEG;oBACa,MAAM,kBAAkB,sBAAsB,GAAG,EAAE,KAAK,IAAI;IAM5E;;OAEG;uCACgC,GAAG,KAAK,IAAI,GAAG,QAAQ,IAAI,CAAC,GAAG,KAAK,GAAG,QAAQ,KAAK,CAAC;IAIxF;;OAEG;8BACuB,GAAG,UAAU,GAAG,SAAS,GAAG,KAAK,IAAI,GAAG,QAAQ,IAAI,CAAC;IAI/E;;OAEG;iCAC0B,GAAG,UAAU,GAAG,KAAK,IAAI,GAAG,QAAQ,IAAI,CAAC;IAItE;;OAEG;+BACwB,GAAG,SAAS,GAAG,KAAK,IAAI,GAAG,QAAQ,IAAI,CAAC;IAMnE;;OAEG;kCAEO,MAAM,mBACG,GAAG,KAAK,IAAI,GAAG,QAAQ,IAAI,CAAC,GAAG,KAAK,GAAG,QAAQ,KAAK,CAAC;IAKxE;;OAEG;yBAEO,MAAM,mBACG,GAAG,UAAU,GAAG,SAAS,GAAG,KAAK,IAAI,GAAG,QAAQ,IAAI,CAAC;IAKxE;;OAEG;4BACqB,MAAM,mBAAmB,GAAG,UAAU,GAAG,KAAK,IAAI,GAAG,QAAQ,IAAI,CAAC;IAI1F;;OAEG;0BACmB,MAAM,mBAAmB,GAAG,SAAS,GAAG,KAAK,IAAI,GAAG,QAAQ,IAAI,CAAC;CAGxF,CAAC"}

package/esm/mail/events.js

@@ -0,0 +1,123 @@
+import events from'@mongez/events';import {Random}from'@mongez/reinforcements';/**
+ * Generate a unique mail ID for event namespacing
+ */
+function generateMailId() {
+    return "M" + Random.int(32);
+}
+/**
+ * Mail event names (global events)
+ */
+const MAIL_EVENTS = {
+    BEFORE_SENDING: "mail.beforeSending",
+    SENT: "mail.sent",
+    SUCCESS: "mail.success",
+    ERROR: "mail.error",
+};
+/**
+ * Get namespaced event name for a specific mail
+ * @param mailId Unique mail identifier
+ * @param event Event type
+ * @returns Namespaced event name (e.g., "mail.abc123.success")
+ */
+function getMailEventName(mailId, event) {
+    return `mail.${mailId}.${event}`;
+}
+/**
+ * Mail events wrapper
+ *
+ * Supports two event patterns:
+ * 1. Global events: `mail.success` - fires for ALL emails
+ * 2. Specific events: `mail.$mailId.success` - fires for ONE email
+ *
+ * ## Usage
+ *
+ * ```typescript
+ * // Global listener - all emails
+ * mailEvents.onSuccess((mail, result) => {
+ *   console.log("Any mail sent:", result.messageId);
+ * });
+ *
+ * // Specific listener - one email by ID
+ * const mailId = generateMailId();
+ * mailEvents.onMailSuccess(mailId, (mail, result) => {
+ *   console.log("This specific mail sent:", result.messageId);
+ * });
+ *
+ * await sendMail({
+ *   id: mailId, // Use the same ID
+ *   to: "user@example.com",
+ *   subject: "Hello",
+ *   html: "<p>World</p>",
+ * });
+ * ```
+ */
+const mailEvents = {
+    /**
+     * Trigger a global mail event
+     */
+    trigger: (eventName, ...args) => {
+        return events.trigger(MAIL_EVENTS[eventName], ...args);
+    },
+    /**
+     * Trigger a specific mail event (by mail ID)
+     */
+    triggerForMail: (mailId, event, ...args) => {
+        return events.trigger(getMailEventName(mailId, event), ...args);
+    },
+    /**
+     * Subscribe to global mail events
+     */
+    on: (eventName, callback) => {
+        return events.subscribe(MAIL_EVENTS[eventName], callback);
+    },
+    // === GLOBAL EVENT HELPERS ===
+    /**
+     * Subscribe to beforeSending event (all mails)
+     */
+    onBeforeSending: (callback) => {
+        return events.subscribe(MAIL_EVENTS.BEFORE_SENDING, callback);
+    },
+    /**
+     * Subscribe to sent event (all mails, after attempt)
+     */
+    onSent: (callback) => {
+        return events.subscribe(MAIL_EVENTS.SENT, callback);
+    },
+    /**
+     * Subscribe to success event (all mails)
+     */
+    onSuccess: (callback) => {
+        return events.subscribe(MAIL_EVENTS.SUCCESS, callback);
+    },
+    /**
+     * Subscribe to error event (all mails)
+     */
+    onError: (callback) => {
+        return events.subscribe(MAIL_EVENTS.ERROR, callback);
+    },
+    // === SPECIFIC MAIL EVENT HELPERS ===
+    /**
+     * Subscribe to beforeSending event for a specific mail
+     */
+    onMailBeforeSending: (mailId, callback) => {
+        return events.subscribe(getMailEventName(mailId, "beforeSending"), callback);
+    },
+    /**
+     * Subscribe to sent event for a specific mail
+     */
+    onMailSent: (mailId, callback) => {
+        return events.subscribe(getMailEventName(mailId, "sent"), callback);
+    },
+    /**
+     * Subscribe to success event for a specific mail
+     */
+    onMailSuccess: (mailId, callback) => {
+        return events.subscribe(getMailEventName(mailId, "success"), callback);
+    },
+    /**
+     * Subscribe to error event for a specific mail
+     */
+    onMailError: (mailId, callback) => {
+        return events.subscribe(getMailEventName(mailId, "error"), callback);
+    },
+};export{MAIL_EVENTS,generateMailId,getMailEventName,mailEvents};//# sourceMappingURL=events.js.map

package/esm/mail/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sources":["../../src/mail/events.ts"],"sourcesContent":[null],"names":[],"mappings":"+EAGA;;AAEG;SACa,cAAc,GAAA;IAC5B,OAAO,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAC9B,CAAC;AAED;;AAEG;AACU,MAAA,WAAW,GAAG;AACzB,IAAA,cAAc,EAAE,oBAAoB;AACpC,IAAA,IAAI,EAAE,WAAW;AACjB,IAAA,OAAO,EAAE,cAAc;AACvB,IAAA,KAAK,EAAE,YAAY;EACV;AAEX;;;;;AAKG;AACa,SAAA,gBAAgB,CAC9B,MAAc,EACd,KAAqD,EAAA;AAErD,IAAA,OAAO,CAAQ,KAAA,EAAA,MAAM,CAAI,CAAA,EAAA,KAAK,EAAE,CAAC;AACnC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BG;AACU,MAAA,UAAU,GAAG;AACxB;;AAEG;AACH,IAAA,OAAO,EAAE,CAAC,SAAmC,EAAE,GAAG,IAAW,KAAI;AAC/D,QAAA,OAAO,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;KACxD;AAED;;AAEG;IACH,cAAc,EAAE,CACd,MAAc,EACd,KAAqD,EACrD,GAAG,IAAW,KACZ;AACF,QAAA,OAAO,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;KACjE;AAED;;AAEG;AACH,IAAA,EAAE,EAAE,CAAC,SAAmC,EAAE,QAAkC,KAAI;QAC9E,OAAO,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,CAAC;KAC3D;;AAID;;AAEG;AACH,IAAA,eAAe,EAAE,CAAC,QAAsE,KAAI;QAC1F,OAAO,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;KAC/D;AAED;;AAEG;AACH,IAAA,MAAM,EAAE,CAAC,QAAsE,KAAI;QACjF,OAAO,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;KACrD;AAED;;AAEG;AACH,IAAA,SAAS,EAAE,CAAC,QAA0D,KAAI;QACxE,OAAO,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;KACxD;AAED;;AAEG;AACH,IAAA,OAAO,EAAE,CAAC,QAAyD,KAAI;QACrE,OAAO,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;KACtD;;AAID;;AAEG;AACH,IAAA,mBAAmB,EAAE,CACnB,MAAc,EACd,QAAsE,KACpE;AACF,QAAA,OAAO,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,MAAM,EAAE,eAAe,CAAC,EAAE,QAAQ,CAAC,CAAC;KAC9E;AAED;;AAEG;AACH,IAAA,UAAU,EAAE,CACV,MAAc,EACd,QAAsE,KACpE;AACF,QAAA,OAAO,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAC;KACrE;AAED;;AAEG;AACH,IAAA,aAAa,EAAE,CAAC,MAAc,EAAE,QAA0D,KAAI;AAC5F,QAAA,OAAO,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,QAAQ,CAAC,CAAC;KACxE;AAED;;AAEG;AACH,IAAA,WAAW,EAAE,CAAC,MAAc,EAAE,QAAyD,KAAI;AACzF,QAAA,OAAO,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;KACtE;"}

package/esm/mail/index.d.ts

@@ -0,0 +1,10 @@
+export { getDefaultMailConfig, getMailMode, getMailerConfig, isDevelopmentMode, isProductionMode, isTestMode, resetMailConfig, resolveMailConfig, setMailConfigurations, setMailMode, } from "./config";
+export { MAIL_EVENTS, generateMailId, getMailEventName, mailEvents } from "./events";
+export { closeAllMailers, closeMailer, getMailer, getPoolStats, verifyMailer } from "./mailer-pool";
+export { renderReactMail } from "./react-mail";
+export { sendMail } from "./send-mail";
+export { Mail } from "./mail";
+export { assertMailCount, assertMailSent, captureMail, clearTestMailbox, findMailsBySubject, findMailsTo, getLastMail, getMailboxSize, getTestMailbox, wasMailSentTo, wasMailSentWithSubject, } from "./test-mailbox";
+export type { CapturedMail, MailAddress, MailAttachment, MailConfigurations, MailErrorCode, MailEvents, MailMode, MailOptions, MailPriority, MailResult, MailersConfig, NormalizedMail, } from "./types";
+export { MailError } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/esm/mail/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mail/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,oBAAoB,EACpB,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,WAAW,GACZ,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGrF,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGpG,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAG/C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAG9B,OAAO,EACL,eAAe,EACf,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,WAAW,EACX,cAAc,EACd,cAAc,EACd,aAAa,EACb,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EACV,YAAY,EACZ,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,UAAU,EACV,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,UAAU,EACV,aAAa,EACb,cAAc,GACf,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC"}