@buenojs/bueno 0.8.10 → 0.8.11

package/dist/modules/pipes.js

@@ -0,0 +1,443 @@
+/**
+ * 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 { validate, } from "../validation";
+// WeakMap for storing pipes metadata on method prototypes
+const pipesMethodMetadata = new WeakMap();
+/**
+ * Set pipes metadata on a method
+ */
+function setMethodPipes(target, propertyKey, metadata) {
+    if (!pipesMethodMetadata.has(target)) {
+        pipesMethodMetadata.set(target, new Map());
+    }
+    pipesMethodMetadata.get(target)?.set(propertyKey, metadata);
+}
+/**
+ * Get pipes metadata from a method
+ */
+export function getMethodPipes(target, propertyKey) {
+    return pipesMethodMetadata.get(target)?.get(propertyKey);
+}
+// ============= Pipe Decorator =============
+/**
+ * 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 function UsePipes(...pipes) {
+    return (target, propertyKey, parameterIndex) => {
+        if (propertyKey === undefined) {
+            throw new Error("UsePipes can only be used on method parameters");
+        }
+        const targetObj = target;
+        const existing = getMethodPipes(targetObj, propertyKey) ?? [];
+        // Find existing metadata for this parameter or create new
+        const existingParam = existing.find((p) => p.index === parameterIndex);
+        if (existingParam) {
+            existingParam.pipes.push(...pipes);
+        }
+        else {
+            existing.push({
+                index: parameterIndex,
+                decorator: "custom",
+                pipes: [...pipes],
+            });
+        }
+        setMethodPipes(targetObj, propertyKey, existing);
+    };
+}
+// ============= Parameter Decorators =============
+/**
+ * Extract and optionally validate request body.
+ *
+ * @param schema - Optional Standard Schema for validation
+ * @returns ParameterDecorator
+ *
+ * @example
+ * ```typescript
+ * @Post()
+ * createUser(@Body(userSchema) body: User) {}
+ * ```
+ */
+export function Body(schema) {
+    return (target, propertyKey, parameterIndex) => {
+        if (propertyKey === undefined) {
+            throw new Error("Body can only be used on method parameters");
+        }
+        const targetObj = target;
+        const existing = getMethodPipes(targetObj, propertyKey) ?? [];
+        existing.push({
+            index: parameterIndex,
+            decorator: "body",
+            schema,
+            pipes: schema ? [new ValidationPipe(schema)] : [],
+        });
+        setMethodPipes(targetObj, propertyKey, existing);
+    };
+}
+/**
+ * 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 function Query(key, schema) {
+    return (target, propertyKey, parameterIndex) => {
+        if (propertyKey === undefined) {
+            throw new Error("Query can only be used on method parameters");
+        }
+        const targetObj = target;
+        const existing = getMethodPipes(targetObj, propertyKey) ?? [];
+        existing.push({
+            index: parameterIndex,
+            decorator: "query",
+            key,
+            schema,
+            pipes: schema ? [new ValidationPipe(schema)] : [],
+        });
+        setMethodPipes(targetObj, propertyKey, existing);
+    };
+}
+/**
+ * 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 function Param(key, ...pipes) {
+    return (target, propertyKey, parameterIndex) => {
+        if (propertyKey === undefined) {
+            throw new Error("Param can only be used on method parameters");
+        }
+        const targetObj = target;
+        const existing = getMethodPipes(targetObj, propertyKey) ?? [];
+        existing.push({
+            index: parameterIndex,
+            decorator: "param",
+            key,
+            pipes: [...pipes],
+        });
+        setMethodPipes(targetObj, propertyKey, existing);
+    };
+}
+// ============= Built-in Pipes =============
+/**
+ * ValidationPipe - Validates using Standard Schema
+ *
+ * @example
+ * ```typescript
+ * @Body(userSchema) body: User
+ * // or explicitly
+ * @UsePipes(new ValidationPipe(userSchema))
+ * ```
+ */
+export class ValidationPipe {
+    schema;
+    constructor(schema) {
+        this.schema = schema;
+    }
+    async transform(value, context) {
+        const result = await validate(this.schema, value);
+        if (result.success) {
+            return result.data;
+        }
+        // Validation failed
+        const failedResult = result;
+        const error = new Error("Validation failed");
+        error.issues = [...failedResult.issues];
+        throw error;
+    }
+}
+/**
+ * ParseIntPipe - Transforms string to integer
+ *
+ * @example
+ * ```typescript
+ * @Param('id', ParseIntPipe) id: number
+ * ```
+ */
+export class ParseIntPipe {
+    transform(value, context) {
+        const parsed = Number.parseInt(value, 10);
+        if (isNaN(parsed)) {
+            throw new Error(`Validation failed: "${value}" is not a valid integer`);
+        }
+        return parsed;
+    }
+}
+/**
+ * ParseFloatPipe - Transforms string to float
+ *
+ * @example
+ * ```typescript
+ * @Param('price', ParseFloatPipe) price: number
+ * ```
+ */
+export class ParseFloatPipe {
+    transform(value, context) {
+        const parsed = Number.parseFloat(value);
+        if (isNaN(parsed)) {
+            throw new Error(`Validation failed: "${value}" is not a valid number`);
+        }
+        return parsed;
+    }
+}
+/**
+ * ParseBoolPipe - Transforms string to boolean
+ *
+ * @example
+ * ```typescript
+ * @Query('active', ParseBoolPipe) active: boolean
+ * ```
+ */
+export class ParseBoolPipe {
+    truthyValues = ["true", "1", "yes", "on"];
+    falsyValues = ["false", "0", "no", "off"];
+    transform(value, context) {
+        const lower = value.toLowerCase();
+        if (this.truthyValues.includes(lower)) {
+            return true;
+        }
+        if (this.falsyValues.includes(lower)) {
+            return false;
+        }
+        throw new Error(`Validation failed: "${value}" is not a valid boolean`);
+    }
+}
+/**
+ * DefaultValuePipe - Provides default value when input is undefined or null
+ *
+ * @example
+ * ```typescript
+ * @Query('limit', new DefaultValuePipe(10), ParseIntPipe) limit: number
+ * ```
+ */
+export class DefaultValuePipe {
+    defaultValue;
+    constructor(defaultValue) {
+        this.defaultValue = defaultValue;
+    }
+    transform(value, context) {
+        if (value === undefined || value === null) {
+            return this.defaultValue;
+        }
+        return value;
+    }
+}
+/**
+ * TrimPipe - Trims string whitespace
+ *
+ * @example
+ * ```typescript
+ * @Query('name', TrimPipe) name: string
+ * ```
+ */
+export class TrimPipe {
+    transform(value, context) {
+        if (typeof value !== "string") {
+            throw new Error("Value must be a string");
+        }
+        return value.trim();
+    }
+}
+/**
+ * ParseJsonPipe - Parses JSON string to object
+ *
+ * @example
+ * ```typescript
+ * @Query('data', ParseJsonPipe) data: MyObject
+ * ```
+ */
+export class ParseJsonPipe {
+    transform(value, context) {
+        try {
+            return JSON.parse(value);
+        }
+        catch {
+            throw new Error(`Validation failed: "${value}" is not valid JSON`);
+        }
+    }
+}
+/**
+ * ParseArrayPipe - Transforms comma-separated string to array
+ *
+ * @example
+ * ```typescript
+ * @Query('tags', ParseArrayPipe) tags: string[]
+ * ```
+ */
+export class ParseArrayPipe {
+    separator;
+    constructor(separator = ",") {
+        this.separator = separator;
+    }
+    transform(value, context) {
+        if (typeof value !== "string") {
+            throw new Error("Value must be a string");
+        }
+        return value
+            .split(this.separator)
+            .map((s) => s.trim())
+            .filter((s) => s.length > 0);
+    }
+}
+/**
+ * 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 async function executePipes(value, context, options) {
+    const { globalPipes = [], parameterPipes = [], resolvePipe } = options;
+    // Combine all pipes in execution order
+    const allPipes = [...globalPipes, ...parameterPipes];
+    let currentValue = value;
+    // Execute each pipe in order
+    for (const pipe of allPipes) {
+        let pipeInstance = null;
+        // Resolve the pipe
+        if (typeof pipe === "function") {
+            // Check if it's a pipe function or a class constructor
+            const funcPipe = pipe;
+            if (funcPipe.prototype &&
+                typeof funcPipe.prototype === "object" &&
+                "transform" in funcPipe.prototype) {
+                // It's a class constructor - try to resolve from container or create instance
+                pipeInstance = resolvePipe ? resolvePipe(pipe) : null;
+                if (!pipeInstance) {
+                    // Create a new instance if not in container
+                    const PipeClass = pipe;
+                    pipeInstance = new PipeClass();
+                }
+            }
+            else {
+                // It's a pipe function
+                pipeInstance = pipe;
+            }
+        }
+        else if (typeof pipe === "object" && pipe !== null) {
+            // It's a token or already an instance
+            const objPipe = pipe;
+            if ("transform" in objPipe && typeof objPipe.transform === "function") {
+                // It's already a PipeTransform instance
+                pipeInstance = pipe;
+            }
+            else {
+                // It's a token - try to resolve
+                pipeInstance = resolvePipe ? resolvePipe(pipe) : null;
+            }
+        }
+        if (!pipeInstance) {
+            console.warn("Pipe could not be resolved:", pipe);
+            continue;
+        }
+        // Execute the pipe
+        if (typeof pipeInstance === "function") {
+            // Pipe function
+            currentValue = await pipeInstance(currentValue, context);
+        }
+        else {
+            // PipeTransform instance
+            currentValue = await pipeInstance.transform(currentValue, context);
+        }
+    }
+    return currentValue;
+}
+// ============= Parameter Value Extractor =============
+/**
+ * Extract parameter value from context based on decorator type
+ */
+export async function extractParameterValue(context, metadata) {
+    switch (metadata.decorator) {
+        case "body":
+            return await context.body();
+        case "query":
+            if (metadata.key) {
+                return context.query[metadata.key];
+            }
+            return context.query;
+        case "param":
+            if (metadata.key) {
+                return context.params[metadata.key];
+            }
+            return context.params;
+        case "custom":
+        default:
+            return undefined;
+    }
+}
+// ============= Error Response =============
+/**
+ * Create a 400 Bad Request response for pipe errors
+ */
+export function createBadRequestResponse(error) {
+    const issues = error.issues;
+    return new Response(JSON.stringify({
+        statusCode: 400,
+        error: "Bad Request",
+        message: error.message,
+        ...(issues && { issues }),
+    }), {
+        status: 400,
+        headers: {
+            "Content-Type": "application/json",
+        },
+    });
+}
+// ============= Type Guards =============
+/**
+ * Check if a value is a PipeTransform instance
+ */
+export function isPipeTransform(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "transform" in value &&
+        typeof value.transform === "function");
+}
+/**
+ * Check if a value is a pipe function
+ */
+export function isPipeFn(value) {
+    return typeof value === "function" && !isPipeTransform(value);
+}
+//# sourceMappingURL=pipes.js.map

package/dist/modules/pipes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipes.js","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/base.js

@@ -0,0 +1,37 @@
+/**
+ * Base Channel Service
+ *
+ * Abstract base class for all channel implementations
+ */
+// ============= Abstract Base Channel Service =============
+export class BaseChannelService {
+    configSchema;
+    /**
+     * Get health status
+     */
+    async getHealth() {
+        return {
+            status: "healthy",
+            message: "Channel is operational",
+            checkedAt: new Date(),
+        };
+    }
+    /**
+     * Validate that value matches expected type
+     */
+    validateField(value, expectedType, fieldName) {
+        const actualType = typeof value;
+        if (actualType !== expectedType) {
+            throw new Error(`Invalid ${this.name} message: ${fieldName} must be ${expectedType}, got ${actualType}`);
+        }
+    }
+    /**
+     * Validate that required field exists
+     */
+    validateRequired(value, fieldName) {
+        if (value === undefined || value === null) {
+            throw new Error(`Invalid ${this.name} message: ${fieldName} is required`);
+        }
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/notification/channels/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/notification/channels/base.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,4DAA4D;AAE5D,MAAM,OAAgB,kBAAkB;IAK9B,YAAY,CAAW;IAahC;;OAEG;IACH,KAAK,CAAC,SAAS;QACd,OAAO;YACN,MAAM,EAAE,SAAS;YACjB,OAAO,EAAE,wBAAwB;YACjC,SAAS,EAAE,IAAI,IAAI,EAAE;SACrB,CAAC;IACH,CAAC;IAED;;OAEG;IACO,aAAa,CACtB,KAAc,EACd,YAAoB,EACpB,SAAiB;QAEjB,MAAM,UAAU,GAAG,OAAO,KAAK,CAAC;QAChC,IAAI,UAAU,KAAK,YAAY,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CACd,WAAW,IAAI,CAAC,IAAI,aAAa,SAAS,YAAY,YAAY,SAAS,UAAU,EAAE,CACvF,CAAC;QACH,CAAC;IACF,CAAC;IAED;;OAEG;IACO,gBAAgB,CAAC,KAAc,EAAE,SAAiB;QAC3D,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,CAAC,IAAI,aAAa,SAAS,cAAc,CAAC,CAAC;QAC3E,CAAC;IACF,CAAC;CACD"}

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/email.js

@@ -0,0 +1,85 @@
+/**
+ * Email Channel Service
+ *
+ * Sends notifications via email through various drivers
+ * (SMTP, Sendgrid, Brevo, Resend)
+ */
+import { BaseChannelService } from "./base";
+// ============= Email Channel Service =============
+export class EmailChannelService extends BaseChannelService {
+    name = "email";
+    config;
+    sentCount = 0;
+    failureCount = 0;
+    constructor(config) {
+        super();
+        this.config = config;
+    }
+    /**
+     * Validate email message structure
+     */
+    validate(message) {
+        if (typeof message !== "object" || message === null) {
+            throw new Error("Invalid email message: must be an object");
+        }
+        const msg = message;
+        // Check required fields
+        if (msg.channel !== "email") {
+            throw new Error('Invalid email message: channel must be "email"');
+        }
+        if (typeof msg.recipient !== "string" || !msg.recipient.includes("@")) {
+            throw new Error("Invalid email message: recipient must be a valid email");
+        }
+        if (typeof msg.subject !== "string" || msg.subject.length === 0) {
+            throw new Error("Invalid email message: subject is required");
+        }
+        // Check that at least one of html or text is present
+        if (!msg.html && !msg.text) {
+            throw new Error("Invalid email message: either html or text must be provided");
+        }
+    }
+    /**
+     * Send email message
+     */
+    async send(message) {
+        try {
+            if (this.config.dryRun) {
+                console.log(`[EmailChannel] Would send email to: ${message.recipient}`);
+                console.log(`  Subject: ${message.subject}`);
+                this.sentCount++;
+                return this._generateMessageId();
+            }
+            // In a real implementation, delegate to appropriate driver
+            // For now, simulate sending
+            const messageId = this._generateMessageId();
+            console.log(`[EmailChannel] Email sent: ${messageId} to ${message.recipient}`);
+            this.sentCount++;
+            return messageId;
+        }
+        catch (error) {
+            this.failureCount++;
+            throw new Error(`Failed to send email: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Get email channel metrics
+     */
+    getMetrics() {
+        const total = this.sentCount + this.failureCount;
+        return {
+            sent: this.sentCount,
+            failed: this.failureCount,
+            total,
+            successRate: total > 0 ? this.sentCount / total : 0,
+        };
+    }
+    /**
+     * Generate a message ID
+     */
+    _generateMessageId() {
+        const timestamp = Date.now();
+        const random = Math.random().toString(36).substring(2, 15);
+        return `${timestamp}.${random}@bueno.local`;
+    }
+}
+//# sourceMappingURL=email.js.map

package/dist/notification/channels/email.js.map

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