@buenojs/bueno 0.8.6 → 0.8.8

package/dist/modules/metadata.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Metadata Storage
+ *
+ * Isolated metadata storage and decorators to avoid circular dependencies.
+ * This module has no dependencies on other module files.
+ */
+import type { Provider, Token } from "../container";
+type Constructor = new (...args: unknown[]) => unknown;
+export interface ModuleMetadata {
+    imports?: Constructor[];
+    providers?: Provider[];
+    controllers?: Constructor[];
+    exports?: Token[];
+}
+export declare function setMetadata(target: Constructor, key: string, value: unknown): void;
+export declare function getMetadata<T>(target: Constructor, key: string): T | undefined;
+export declare function setPrototypeMetadata(target: object, key: string, value: unknown): void;
+export declare function getPrototypeMetadata<T>(target: object, key: string): T | undefined;
+/**
+ * Mark a class as injectable
+ */
+export declare function Injectable(): ClassDecorator;
+/**
+ * Mark a class as a controller with a base path
+ */
+export declare function Controller(path?: string): ClassDecorator;
+/**
+ * Define a module with metadata
+ */
+export declare function Module(metadata: ModuleMetadata): ClassDecorator;
+export type { Constructor };
+//# sourceMappingURL=metadata.d.ts.map

package/dist/modules/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/modules/metadata.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAGpD,KAAK,WAAW,GAAG,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;AAIvD,MAAM,WAAW,cAAc;IAC9B,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,WAAW,EAAE,CAAC;IAC5B,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC;CAClB;AAOD,wBAAgB,WAAW,CAC1B,MAAM,EAAE,WAAW,EACnB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,GACZ,IAAI,CAKN;AAED,wBAAgB,WAAW,CAAC,CAAC,EAC5B,MAAM,EAAE,WAAW,EACnB,GAAG,EAAE,MAAM,GACT,CAAC,GAAG,SAAS,CAEf;AAKD,wBAAgB,oBAAoB,CACnC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,GACZ,IAAI,CAKN;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EACrC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACT,CAAC,GAAG,SAAS,CAEf;AAID;;GAEG;AACH,wBAAgB,UAAU,IAAI,cAAc,CAK3C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,SAAK,GAAG,cAAc,CAMpD;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,QAAQ,EAAE,cAAc,GAAG,cAAc,CAK/D;AAGD,YAAY,EAAE,WAAW,EAAE,CAAC"}

package/dist/modules/pipes.d.ts

@@ -0,0 +1,287 @@
+/**
+ * Pipes System
+ *
+ * Pipes run after guards in the request pipeline and can transform/validate
+ * data before it reaches the handler.
+ *
+ * Execution Order:
+ * Incoming Request → Guards → Pipes → Handler
+ *
+ * Pipes can:
+ * - Transform data (e.g., string to number)
+ * - Validate data (e.g., using Standard Schema)
+ * - Provide default values
+ */
+import type { Token } from "../container";
+import type { Context } from "../context";
+import type { StandardSchema } from "../types";
+/**
+ * Parameter metadata available to pipes
+ */
+export interface ParameterMetadata {
+    /** Parameter index */
+    index: number;
+    /** Parameter name if available */
+    name?: string;
+    /** Decorator type (body, query, param, etc.) */
+    decorator?: string;
+}
+/**
+ * Context available to pipes during transformation
+ */
+export interface PipeContext {
+    /** The request context */
+    context: Context;
+    /** Parameter metadata */
+    metadata?: ParameterMetadata;
+    /** Target type information */
+    type?: unknown;
+}
+/**
+ * Pipe interface for data transformation
+ *
+ * @example
+ * ```typescript
+ * class ParseIntPipe implements PipeTransform<string, number> {
+ *   transform(value: string, context: PipeContext): number {
+ *     const parsed = parseInt(value, 10);
+ *     if (isNaN(parsed)) {
+ *       throw new Error('Validation failed');
+ *     }
+ *     return parsed;
+ *   }
+ * }
+ * ```
+ */
+export interface PipeTransform<T = unknown, R = unknown> {
+    transform(value: T, context: PipeContext): R | Promise<R>;
+}
+/**
+ * Pipe function type (for functional pipes)
+ *
+ * @example
+ * ```typescript
+ * const trimPipe: PipeFn<string, string> = (value) => value.trim();
+ * ```
+ */
+export type PipeFn<T = unknown, R = unknown> = (value: T, context: PipeContext) => R | Promise<R>;
+/**
+ * Pipe type - can be:
+ * - A token for a pipe class registered in the container
+ * - A pipe class instance
+ * - A pipe function
+ */
+export type Pipe<T = unknown, R = unknown> = Token<PipeTransform<T, R>> | PipeTransform<T, R> | PipeFn<T, R>;
+/**
+ * Metadata for a parameter with pipes
+ */
+export interface ParameterPipeMetadata {
+    /** Parameter index */
+    index: number;
+    /** Parameter decorator type */
+    decorator: "body" | "query" | "param" | "custom";
+    /** Key for query/param decorators */
+    key?: string;
+    /** Schema for validation */
+    schema?: StandardSchema;
+    /** Pipes to apply */
+    pipes: Pipe[];
+}
+/**
+ * Get pipes metadata from a method
+ */
+export declare function getMethodPipes(target: object, propertyKey: string | symbol): ParameterPipeMetadata[] | undefined;
+/**
+ * Decorator to apply pipes to a parameter.
+ * Pipes are executed in the order they are provided.
+ *
+ * @param pipes - Pipes to apply
+ * @returns ParameterDecorator
+ *
+ * @example
+ * ```typescript
+ * @Get(':id')
+ * getUser(@Param('id', ParseIntPipe) id: number) {}
+ * ```
+ */
+export declare function UsePipes(...pipes: Pipe[]): ParameterDecorator;
+/**
+ * Extract and optionally validate request body.
+ *
+ * @param schema - Optional Standard Schema for validation
+ * @returns ParameterDecorator
+ *
+ * @example
+ * ```typescript
+ * @Post()
+ * createUser(@Body(userSchema) body: User) {}
+ * ```
+ */
+export declare function Body(schema?: StandardSchema): ParameterDecorator;
+/**
+ * Extract and optionally validate query parameter.
+ *
+ * @param key - Query parameter key (optional, if omitted returns all query params)
+ * @param schema - Optional Standard Schema for validation
+ * @returns ParameterDecorator
+ *
+ * @example
+ * ```typescript
+ * @Get()
+ * search(@Query('q') query: string) {}
+ *
+ * @Get()
+ * search(@Query('limit', limitSchema) limit: number) {}
+ * ```
+ */
+export declare function Query(key?: string, schema?: StandardSchema): ParameterDecorator;
+/**
+ * Extract and transform route parameter.
+ *
+ * @param key - Route parameter key (optional, if omitted returns all params)
+ * @param pipes - Pipes to apply for transformation
+ * @returns ParameterDecorator
+ *
+ * @example
+ * ```typescript
+ * @Get(':id')
+ * getUser(@Param('id', ParseIntPipe) id: number) {}
+ * ```
+ */
+export declare function Param(key?: string, ...pipes: Pipe[]): ParameterDecorator;
+/**
+ * ValidationPipe - Validates using Standard Schema
+ *
+ * @example
+ * ```typescript
+ * @Body(userSchema) body: User
+ * // or explicitly
+ * @UsePipes(new ValidationPipe(userSchema))
+ * ```
+ */
+export declare class ValidationPipe<T = unknown> implements PipeTransform<unknown, T> {
+    private schema;
+    constructor(schema: StandardSchema<unknown, T>);
+    transform(value: unknown, context: PipeContext): Promise<T>;
+}
+/**
+ * ParseIntPipe - Transforms string to integer
+ *
+ * @example
+ * ```typescript
+ * @Param('id', ParseIntPipe) id: number
+ * ```
+ */
+export declare class ParseIntPipe implements PipeTransform<string, number> {
+    transform(value: string, context: PipeContext): number;
+}
+/**
+ * ParseFloatPipe - Transforms string to float
+ *
+ * @example
+ * ```typescript
+ * @Param('price', ParseFloatPipe) price: number
+ * ```
+ */
+export declare class ParseFloatPipe implements PipeTransform<string, number> {
+    transform(value: string, context: PipeContext): number;
+}
+/**
+ * ParseBoolPipe - Transforms string to boolean
+ *
+ * @example
+ * ```typescript
+ * @Query('active', ParseBoolPipe) active: boolean
+ * ```
+ */
+export declare class ParseBoolPipe implements PipeTransform<string, boolean> {
+    private readonly truthyValues;
+    private readonly falsyValues;
+    transform(value: string, context: PipeContext): boolean;
+}
+/**
+ * DefaultValuePipe - Provides default value when input is undefined or null
+ *
+ * @example
+ * ```typescript
+ * @Query('limit', new DefaultValuePipe(10), ParseIntPipe) limit: number
+ * ```
+ */
+export declare class DefaultValuePipe<T> implements PipeTransform<unknown, T> {
+    private defaultValue;
+    constructor(defaultValue: T);
+    transform(value: unknown, context: PipeContext): T;
+}
+/**
+ * TrimPipe - Trims string whitespace
+ *
+ * @example
+ * ```typescript
+ * @Query('name', TrimPipe) name: string
+ * ```
+ */
+export declare class TrimPipe implements PipeTransform<string, string> {
+    transform(value: string, context: PipeContext): string;
+}
+/**
+ * ParseJsonPipe - Parses JSON string to object
+ *
+ * @example
+ * ```typescript
+ * @Query('data', ParseJsonPipe) data: MyObject
+ * ```
+ */
+export declare class ParseJsonPipe<T = unknown> implements PipeTransform<string, T> {
+    transform(value: string, context: PipeContext): T;
+}
+/**
+ * ParseArrayPipe - Transforms comma-separated string to array
+ *
+ * @example
+ * ```typescript
+ * @Query('tags', ParseArrayPipe) tags: string[]
+ * ```
+ */
+export declare class ParseArrayPipe implements PipeTransform<string, string[]> {
+    private separator;
+    constructor(separator?: string);
+    transform(value: string, context: PipeContext): string[];
+}
+/**
+ * Pipe executor options
+ */
+export interface PipeExecutorOptions {
+    /** Global pipes applied to all parameters */
+    globalPipes?: Pipe[];
+    /** Pipes from parameter decorator */
+    parameterPipes?: Pipe[];
+    /** Container for resolving pipe instances */
+    resolvePipe?: (pipe: Pipe) => PipeTransform | PipeFn | null;
+}
+/**
+ * Execute pipes in order and return the transformed value
+ *
+ * @param value - Initial value to transform
+ * @param context - Pipe context
+ * @param options - Pipe executor options
+ * @returns Transformed value
+ * @throws Error if any pipe fails
+ */
+export declare function executePipes<T = unknown>(value: unknown, context: PipeContext, options: PipeExecutorOptions): Promise<T>;
+/**
+ * Extract parameter value from context based on decorator type
+ */
+export declare function extractParameterValue(context: Context, metadata: ParameterPipeMetadata): Promise<unknown>;
+/**
+ * Create a 400 Bad Request response for pipe errors
+ */
+export declare function createBadRequestResponse(error: Error): Response;
+/**
+ * Check if a value is a PipeTransform instance
+ */
+export declare function isPipeTransform(value: unknown): value is PipeTransform;
+/**
+ * Check if a value is a pipe function
+ */
+export declare function isPipeFn(value: unknown): value is PipeFn;
+//# sourceMappingURL=pipes.d.ts.map

package/dist/modules/pipes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipes.d.ts","sourceRoot":"","sources":["../../src/modules/pipes.ts"],"names":[],"mappings":"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"}

package/dist/notification/channels/base.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Base Channel Service
+ *
+ * Abstract base class for all channel implementations
+ */
+import type { ChannelHealth, ChannelService, NotificationMessage } from "../types";
+export declare abstract class BaseChannelService<T extends NotificationMessage = NotificationMessage> implements ChannelService<T> {
+    abstract readonly name: string;
+    readonly configSchema?: unknown;
+    /**
+     * Validate message structure
+     * Should throw if message is invalid
+     */
+    abstract validate(message: unknown): asserts message is T;
+    /**
+     * Send a notification message
+     */
+    abstract send(message: T): Promise<string | undefined>;
+    /**
+     * Get health status
+     */
+    getHealth(): Promise<ChannelHealth>;
+    /**
+     * Validate that value matches expected type
+     */
+    protected validateField(value: unknown, expectedType: string, fieldName: string): void;
+    /**
+     * Validate that required field exists
+     */
+    protected validateRequired(value: unknown, fieldName: string): void;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/notification/channels/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/notification/channels/base.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACX,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,MAAM,UAAU,CAAC;AAIlB,8BAAsB,kBAAkB,CACvC,CAAC,SAAS,mBAAmB,GAAG,mBAAmB,CAClD,YAAW,cAAc,CAAC,CAAC,CAAC;IAE7B,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAEhC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC;IAEzD;;OAEG;IACH,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAEtD;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,aAAa,CAAC;IAQzC;;OAEG;IACH,SAAS,CAAC,aAAa,CACtB,KAAK,EAAE,OAAO,EACd,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,GACf,IAAI;IASP;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;CAKnE"}

package/dist/notification/channels/email.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Email Channel Service
+ *
+ * Sends notifications via email through various drivers
+ * (SMTP, Sendgrid, Brevo, Resend)
+ */
+import type { EmailChannelConfig, EmailMessage } from "../types";
+import { BaseChannelService } from "./base";
+export declare class EmailChannelService extends BaseChannelService<EmailMessage> {
+    readonly name = "email";
+    private config;
+    private sentCount;
+    private failureCount;
+    constructor(config: EmailChannelConfig);
+    /**
+     * Validate email message structure
+     */
+    validate(message: unknown): asserts message is EmailMessage;
+    /**
+     * Send email message
+     */
+    send(message: EmailMessage): Promise<string | undefined>;
+    /**
+     * Get email channel metrics
+     */
+    getMetrics(): {
+        sent: number;
+        failed: number;
+        total: number;
+        successRate: number;
+    };
+    /**
+     * Generate a message ID
+     */
+    private _generateMessageId;
+}
+//# sourceMappingURL=email.d.ts.map

package/dist/notification/channels/email.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../../src/notification/channels/email.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAI5C,qBAAa,mBAAoB,SAAQ,kBAAkB,CAAC,YAAY,CAAC;IACxE,QAAQ,CAAC,IAAI,WAAW;IACxB,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,YAAY,CAAK;gBAEb,MAAM,EAAE,kBAAkB;IAKtC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,YAAY;IA4B3D;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IA0B9D;;OAEG;IACH,UAAU;;;;;;IAUV;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAK1B"}

package/dist/notification/channels/push.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Push Notification Channel Service
+ *
+ * Sends notifications via push through various drivers
+ * (Firebase, APNS, custom)
+ */
+import type { PushChannelConfig, PushNotificationMessage } from "../types";
+import { BaseChannelService } from "./base";
+export declare class PushNotificationChannelService extends BaseChannelService<PushNotificationMessage> {
+    readonly name = "push";
+    private config;
+    private sentCount;
+    private failureCount;
+    constructor(config: PushChannelConfig);
+    /**
+     * Validate push notification message structure
+     */
+    validate(message: unknown): asserts message is PushNotificationMessage;
+    /**
+     * Send push notification message
+     */
+    send(message: PushNotificationMessage): Promise<string | undefined>;
+    /**
+     * Get push channel metrics
+     */
+    getMetrics(): {
+        sent: number;
+        failed: number;
+        total: number;
+        successRate: number;
+    };
+    /**
+     * Generate a message ID
+     */
+    private _generateMessageId;
+}
+//# sourceMappingURL=push.d.ts.map

package/dist/notification/channels/push.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.d.ts","sourceRoot":"","sources":["../../../src/notification/channels/push.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAI5C,qBAAa,8BAA+B,SAAQ,kBAAkB,CAAC,uBAAuB,CAAC;IAC9F,QAAQ,CAAC,IAAI,UAAU;IACvB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,YAAY,CAAK;gBAEb,MAAM,EAAE,iBAAiB;IAKrC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,uBAAuB;IA0BtE;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IA2BzE;;OAEG;IACH,UAAU;;;;;;IAUV;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAK1B"}

package/dist/notification/channels/sms.d.ts

@@ -0,0 +1,37 @@
+/**
+ * SMS Channel Service
+ *
+ * Sends notifications via SMS through various drivers
+ * (Twilio, AWS SNS, custom)
+ */
+import type { SMSChannelConfig, SMSMessage } from "../types";
+import { BaseChannelService } from "./base";
+export declare class SMSChannelService extends BaseChannelService<SMSMessage> {
+    readonly name = "sms";
+    private config;
+    private sentCount;
+    private failureCount;
+    constructor(config: SMSChannelConfig);
+    /**
+     * Validate SMS message structure
+     */
+    validate(message: unknown): asserts message is SMSMessage;
+    /**
+     * Send SMS message
+     */
+    send(message: SMSMessage): Promise<string | undefined>;
+    /**
+     * Get SMS channel metrics
+     */
+    getMetrics(): {
+        sent: number;
+        failed: number;
+        total: number;
+        successRate: number;
+    };
+    /**
+     * Generate a message ID
+     */
+    private _generateMessageId;
+}
+//# sourceMappingURL=sms.d.ts.map

package/dist/notification/channels/sms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sms.d.ts","sourceRoot":"","sources":["../../../src/notification/channels/sms.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAI5C,qBAAa,iBAAkB,SAAQ,kBAAkB,CAAC,UAAU,CAAC;IACpE,QAAQ,CAAC,IAAI,SAAS;IACtB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,YAAY,CAAK;gBAEb,MAAM,EAAE,gBAAgB;IAKpC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,UAAU;IA4BzD;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IA0B5D;;OAEG;IACH,UAAU;;;;;;IAUV;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAK1B"}

package/dist/notification/channels/whatsapp.d.ts

@@ -0,0 +1,37 @@
+/**
+ * WhatsApp Channel Service
+ *
+ * Sends notifications via WhatsApp through various drivers
+ * (Twilio, custom)
+ */
+import type { WhatsAppChannelConfig, WhatsAppMessage } from "../types";
+import { BaseChannelService } from "./base";
+export declare class WhatsAppChannelService extends BaseChannelService<WhatsAppMessage> {
+    readonly name = "whatsapp";
+    private config;
+    private sentCount;
+    private failureCount;
+    constructor(config: WhatsAppChannelConfig);
+    /**
+     * Validate WhatsApp message structure
+     */
+    validate(message: unknown): asserts message is WhatsAppMessage;
+    /**
+     * Send WhatsApp message
+     */
+    send(message: WhatsAppMessage): Promise<string | undefined>;
+    /**
+     * Get WhatsApp channel metrics
+     */
+    getMetrics(): {
+        sent: number;
+        failed: number;
+        total: number;
+        successRate: number;
+    };
+    /**
+     * Generate a message ID
+     */
+    private _generateMessageId;
+}
+//# sourceMappingURL=whatsapp.d.ts.map

package/dist/notification/channels/whatsapp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whatsapp.d.ts","sourceRoot":"","sources":["../../../src/notification/channels/whatsapp.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAI5C,qBAAa,sBAAuB,SAAQ,kBAAkB,CAAC,eAAe,CAAC;IAC9E,QAAQ,CAAC,IAAI,cAAc;IAC3B,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,YAAY,CAAK;gBAEb,MAAM,EAAE,qBAAqB;IAKzC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,eAAe;IAsB9D;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IA+BjE;;OAEG;IACH,UAAU;;;;;;IAUV;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAK1B"}

package/dist/notification/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Notification Module
+ *
+ * Multi-channel notification system with support for email, SMS, WhatsApp,
+ * push notifications, and custom channels. Uses registry pattern for
+ * dynamic channel registration.
+ */
+export type { NotificationChannel, NotificationMessage, EmailRecipient, EmailRecipients, EmailAttachment, EmailMessage, SMSMessage, WhatsAppMessage, PushNotificationMessage, BuiltInNotification, Notifiable, ChannelHealth, ChannelService, BaseChannelConfig, EmailChannelConfig, SMSChannelConfig, WhatsAppChannelConfig, PushChannelConfig, ChannelConfig, NotificationServiceConfig, ChannelMetrics, NotificationEvent, NotificationEventType, NotificationValidationResult, StandardSchema, } from "./types";
+export { NotificationService, createNotificationService } from "./service";
+export { BaseChannelService } from "./channels/base";
+export { EmailChannelService } from "./channels/email";
+export { SMSChannelService } from "./channels/sms";
+export { WhatsAppChannelService } from "./channels/whatsapp";
+export { PushNotificationChannelService } from "./channels/push";
+//# sourceMappingURL=index.d.ts.map

package/dist/notification/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/notification/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EACX,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,eAAe,EACf,YAAY,EACZ,UAAU,EACV,eAAe,EACf,uBAAuB,EACvB,mBAAmB,EACnB,UAAU,EACV,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,aAAa,EACb,yBAAyB,EACzB,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACrB,4BAA4B,EAC5B,cAAc,GACd,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAC;AAG3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAGrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,8BAA8B,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/notification/service.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Notification Service
+ *
+ * Core notification service with registry-based channel management.
+ * Supports dynamic channel registration and multi-channel notification sending.
+ */
+import type { ChannelHealth, ChannelMetrics, ChannelService, Notifiable, NotificationChannel, NotificationMessage, NotificationServiceConfig } from "./types";
+export declare class NotificationService {
+    private channels;
+    private config;
+    private metrics;
+    constructor(config?: NotificationServiceConfig);
+    /**
+     * Register a channel service
+     * @param service Channel service to register
+     * @throws Error if channel is already registered
+     */
+    registerChannel<T extends NotificationMessage>(service: ChannelService<T>): void;
+    /**
+     * Unregister a channel service
+     * @param channelName Name of the channel to unregister
+     */
+    unregisterChannel(channelName: NotificationChannel): void;
+    /**
+     * Get a registered channel service
+     * @param channelName Name of the channel
+     * @returns Channel service or null if not found
+     */
+    getChannel(channelName: NotificationChannel): ChannelService | null;
+    /**
+     * Get all registered channel names
+     */
+    getChannels(): NotificationChannel[];
+    /**
+     * Check if a channel is registered
+     */
+    hasChannel(channelName: NotificationChannel): boolean;
+    /**
+     * Send a notification via specified channel
+     * @param message Notification message
+     * @returns Message ID or undefined
+     * @throws Error if channel not found or message invalid
+     */
+    send(message: NotificationMessage): Promise<string | undefined>;
+    /**
+     * Send multiple notifications (potentially different channels)
+     * @param messages Array of notification messages
+     * @returns Array of message IDs
+     */
+    sendBatch(messages: NotificationMessage[]): Promise<(string | undefined)[]>;
+    /**
+     * Send a notification from a Notifiable
+     * @param notifiable Notifiable instance
+     * @param channel Optional specific channel (otherwise uses buildAll or default)
+     * @returns Message ID(s)
+     */
+    sendNotifiable(notifiable: Notifiable, channel?: NotificationChannel): Promise<string | undefined>;
+    /**
+     * Queue a notification for async sending (requires job queue integration)
+     * @param message Notification message
+     * @returns Job ID or undefined
+     */
+    queue(message: NotificationMessage): Promise<string | undefined>;
+    /**
+     * Get health status for a channel
+     * @param channelName Name of the channel
+     */
+    getChannelHealth(channelName: NotificationChannel): Promise<ChannelHealth | null>;
+    /**
+     * Get health status for all channels
+     */
+    getHealthStatus(): Promise<Record<NotificationChannel, ChannelHealth>>;
+    /**
+     * Get metrics for a specific channel
+     * @param channelName Name of the channel
+     */
+    getChannelMetrics(channelName: NotificationChannel): ChannelMetrics | null;
+    /**
+     * Get metrics for all channels
+     */
+    getAllMetrics(): Record<NotificationChannel, ChannelMetrics>;
+    /**
+     * Resolve TemplateRef objects in message fields to rendered strings
+     */
+    private _resolveTemplates;
+    /**
+     * Assert that no TemplateRef fields exist in the message
+     * Throws if a TemplateRef is found but no templateEngine is configured
+     */
+    private _assertNoTemplateRefs;
+    /**
+     * Update metrics for a channel
+     */
+    private _updateMetrics;
+}
+/**
+ * Factory function to create notification service
+ */
+export declare function createNotificationService(config?: NotificationServiceConfig): NotificationService;
+//# sourceMappingURL=service.d.ts.map

package/dist/notification/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/notification/service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACX,aAAa,EACb,cAAc,EACd,cAAc,EACd,UAAU,EACV,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EAEzB,MAAM,SAAS,CAAC;AAKjB,qBAAa,mBAAmB;IAC/B,OAAO,CAAC,QAAQ,CAAuD;IACvE,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,OAAO,CAAuD;gBAE1D,MAAM,GAAE,yBAA8B;IAIlD;;;;OAIG;IACH,eAAe,CAAC,CAAC,SAAS,mBAAmB,EAC5C,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GACxB,IAAI;IAmBP;;;OAGG;IACH,iBAAiB,CAAC,WAAW,EAAE,mBAAmB,GAAG,IAAI;IAKzD;;;;OAIG;IACH,UAAU,CAAC,WAAW,EAAE,mBAAmB,GAAG,cAAc,GAAG,IAAI;IAInE;;OAEG;IACH,WAAW,IAAI,mBAAmB,EAAE;IAIpC;;OAEG;IACH,UAAU,CAAC,WAAW,EAAE,mBAAmB,GAAG,OAAO;IAIrD;;;;;OAKG;IACG,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAkCrE;;;;OAIG;IACG,SAAS,CACd,QAAQ,EAAE,mBAAmB,EAAE,GAC7B,OAAO,CAAC,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC;IAelC;;;;;OAKG;IACG,cAAc,CACnB,UAAU,EAAE,UAAU,EACtB,OAAO,CAAC,EAAE,mBAAmB,GAC3B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAuB9B;;;;OAIG;IACG,KAAK,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAMtE;;;OAGG;IACG,gBAAgB,CACrB,WAAW,EAAE,mBAAmB,GAC9B,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAahC;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,mBAAmB,EAAE,aAAa,CAAC,CAAC;IAa5E;;;OAGG;IACH,iBAAiB,CAAC,WAAW,EAAE,mBAAmB,GAAG,cAAc,GAAG,IAAI;IAI1E;;OAEG;IACH,aAAa,IAAI,MAAM,CAAC,mBAAmB,EAAE,cAAc,CAAC;IAU5D;;OAEG;YACW,iBAAiB;IAsD/B;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAU7B;;OAEG;IACH,OAAO,CAAC,cAAc;CAqBtB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACxC,MAAM,CAAC,EAAE,yBAAyB,GAChC,mBAAmB,CAErB"}