@buenojs/bueno 0.8.10 → 0.8.11

package/dist/config/validation.js

@@ -0,0 +1,548 @@
+/**
+ * Configuration validation for Bueno Framework
+ * Supports Standard Schema validators (Zod, Valibot, ArkType)
+ */
+/**
+ * Check if a value is a Standard Schema
+ */
+export function isStandardSchema(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "~standard" in value &&
+        typeof value["~standard"] === "object" &&
+        typeof value["~standard"].validate === "function");
+}
+/**
+ * Validate config against a Standard Schema
+ */
+export async function validateWithSchema(config, schema) {
+    const result = await schema["~standard"].validate(config);
+    if (result.issues === undefined) {
+        return {
+            valid: true,
+            errors: [],
+            warnings: [],
+        };
+    }
+    const errors = result.issues.map((issue) => ({
+        message: issue.message,
+        path: formatPath(issue.path),
+        issue,
+    }));
+    return {
+        valid: false,
+        errors,
+        warnings: [],
+    };
+}
+/**
+ * Format a path from Standard Schema issues
+ */
+function formatPath(path) {
+    if (!path || path.length === 0) {
+        return undefined;
+    }
+    return path
+        .map((segment) => {
+        if (typeof segment === "object" && "key" in segment) {
+            return String(segment.key);
+        }
+        return String(segment);
+    })
+        .join(".");
+}
+/**
+ * Default validation rules for BuenoConfig
+ */
+const DEFAULT_RULES = [
+    {
+        path: "server.port",
+        validate: (value) => {
+            if (value === undefined)
+                return { valid: true };
+            if (typeof value !== "number") {
+                return { valid: false, message: "Port must be a number" };
+            }
+            if (value < 0 || value > 65535) {
+                return { valid: false, message: "Port must be between 0 and 65535" };
+            }
+            return { valid: true };
+        },
+    },
+    {
+        path: "database.poolSize",
+        validate: (value) => {
+            if (value === undefined)
+                return { valid: true };
+            if (typeof value !== "number") {
+                return { valid: false, message: "Pool size must be a number" };
+            }
+            if (value < 1) {
+                return { valid: false, message: "Pool size must be at least 1" };
+            }
+            return { valid: true };
+        },
+    },
+    {
+        path: "database.slowQueryThreshold",
+        validate: (value) => {
+            if (value === undefined)
+                return { valid: true };
+            if (typeof value !== "number") {
+                return {
+                    valid: false,
+                    message: "Slow query threshold must be a number",
+                };
+            }
+            if (value < 0) {
+                return {
+                    valid: false,
+                    message: "Slow query threshold must be non-negative",
+                };
+            }
+            return { valid: true };
+        },
+    },
+    {
+        path: "cache.ttl",
+        validate: (value) => {
+            if (value === undefined)
+                return { valid: true };
+            if (typeof value !== "number") {
+                return { valid: false, message: "TTL must be a number" };
+            }
+            if (value < 0) {
+                return { valid: false, message: "TTL must be non-negative" };
+            }
+            return { valid: true };
+        },
+    },
+    {
+        path: "cache.driver",
+        validate: (value) => {
+            if (value === undefined)
+                return { valid: true };
+            if (value !== "redis" && value !== "memory") {
+                return {
+                    valid: false,
+                    message: 'Cache driver must be "redis" or "memory"',
+                    expected: '"redis" | "memory"',
+                    received: value,
+                };
+            }
+            return { valid: true };
+        },
+    },
+    {
+        path: "logger.level",
+        validate: (value) => {
+            if (value === undefined)
+                return { valid: true };
+            const validLevels = ["debug", "info", "warn", "error", "fatal"];
+            if (!validLevels.includes(value)) {
+                return {
+                    valid: false,
+                    message: `Logger level must be one of: ${validLevels.join(", ")}`,
+                    expected: validLevels.join(" | "),
+                    received: value,
+                };
+            }
+            return { valid: true };
+        },
+    },
+    {
+        path: "telemetry.sampleRate",
+        validate: (value) => {
+            if (value === undefined)
+                return { valid: true };
+            if (typeof value !== "number") {
+                return { valid: false, message: "Sample rate must be a number" };
+            }
+            if (value < 0 || value > 1) {
+                return { valid: false, message: "Sample rate must be between 0 and 1" };
+            }
+            return { valid: true };
+        },
+    },
+    {
+        path: "metrics.collectInterval",
+        validate: (value) => {
+            if (value === undefined)
+                return { valid: true };
+            if (typeof value !== "number") {
+                return { valid: false, message: "Collect interval must be a number" };
+            }
+            if (value < 0) {
+                return {
+                    valid: false,
+                    message: "Collect interval must be non-negative",
+                };
+            }
+            return { valid: true };
+        },
+    },
+    {
+        path: "jobs.driver",
+        validate: (value) => {
+            if (value === undefined)
+                return { valid: true };
+            if (value !== "redis" && value !== "memory") {
+                return {
+                    valid: false,
+                    message: 'Jobs driver must be "redis" or "memory"',
+                    expected: '"redis" | "memory"',
+                    received: value,
+                };
+            }
+            return { valid: true };
+        },
+    },
+    {
+        path: "jobs.concurrency",
+        validate: (value) => {
+            if (value === undefined)
+                return { valid: true };
+            if (typeof value !== "number") {
+                return { valid: false, message: "Concurrency must be a number" };
+            }
+            if (value < 1) {
+                return { valid: false, message: "Concurrency must be at least 1" };
+            }
+            return { valid: true };
+        },
+    },
+    {
+        path: "jobs.maxRetries",
+        validate: (value) => {
+            if (value === undefined)
+                return { valid: true };
+            if (typeof value !== "number") {
+                return { valid: false, message: "Max retries must be a number" };
+            }
+            if (value < 0) {
+                return { valid: false, message: "Max retries must be non-negative" };
+            }
+            return { valid: true };
+        },
+    },
+    {
+        path: "jobs.retryDelay",
+        validate: (value) => {
+            if (value === undefined)
+                return { valid: true };
+            if (typeof value !== "number") {
+                return { valid: false, message: "Retry delay must be a number" };
+            }
+            if (value < 0) {
+                return { valid: false, message: "Retry delay must be non-negative" };
+            }
+            return { valid: true };
+        },
+    },
+    {
+        path: "jobs.batchSize",
+        validate: (value) => {
+            if (value === undefined)
+                return { valid: true };
+            if (typeof value !== "number") {
+                return { valid: false, message: "Batch size must be a number" };
+            }
+            if (value < 1) {
+                return { valid: false, message: "Batch size must be at least 1" };
+            }
+            return { valid: true };
+        },
+    },
+    {
+        path: "jobs.pollInterval",
+        validate: (value) => {
+            if (value === undefined)
+                return { valid: true };
+            if (typeof value !== "number") {
+                return { valid: false, message: "Poll interval must be a number" };
+            }
+            if (value < 100) {
+                return {
+                    valid: false,
+                    message: "Poll interval must be at least 100ms",
+                };
+            }
+            return { valid: true };
+        },
+    },
+    {
+        path: "jobs.jobTimeout",
+        validate: (value) => {
+            if (value === undefined)
+                return { valid: true };
+            if (typeof value !== "number") {
+                return { valid: false, message: "Job timeout must be a number" };
+            }
+            if (value < 1000) {
+                return { valid: false, message: "Job timeout must be at least 1000ms" };
+            }
+            return { valid: true };
+        },
+    },
+    {
+        path: "notification.email.driver",
+        validate: (value) => {
+            if (value === undefined)
+                return { valid: true };
+            const validDrivers = ["smtp", "sendgrid", "brevo", "resend"];
+            if (!validDrivers.includes(value)) {
+                return {
+                    valid: false,
+                    message: `Email driver must be one of: ${validDrivers.join(", ")}`,
+                    expected: validDrivers.join(" | "),
+                    received: value,
+                };
+            }
+            return { valid: true };
+        },
+    },
+    {
+        path: "notification.email.from",
+        validate: (value) => {
+            if (value === undefined)
+                return { valid: true };
+            if (typeof value !== "string") {
+                return { valid: false, message: "From email must be a string" };
+            }
+            if (!value.includes("@")) {
+                return {
+                    valid: false,
+                    message: "From email must be a valid email address",
+                    received: value,
+                };
+            }
+            return { valid: true };
+        },
+    },
+    {
+        path: "notification.email.smtp.port",
+        validate: (value) => {
+            if (value === undefined)
+                return { valid: true };
+            if (typeof value !== "number") {
+                return { valid: false, message: "SMTP port must be a number" };
+            }
+            if (value < 1 || value > 65535) {
+                return {
+                    valid: false,
+                    message: "SMTP port must be between 1 and 65535",
+                };
+            }
+            return { valid: true };
+        },
+    },
+    {
+        path: "notification.sms.driver",
+        validate: (value) => {
+            if (value === undefined)
+                return { valid: true };
+            const validDrivers = ["twilio", "aws-sns", "custom"];
+            if (!validDrivers.includes(value)) {
+                return {
+                    valid: false,
+                    message: `SMS driver must be one of: ${validDrivers.join(", ")}`,
+                    expected: validDrivers.join(" | "),
+                    received: value,
+                };
+            }
+            return { valid: true };
+        },
+    },
+    {
+        path: "notification.whatsapp.driver",
+        validate: (value) => {
+            if (value === undefined)
+                return { valid: true };
+            const validDrivers = ["twilio", "custom"];
+            if (!validDrivers.includes(value)) {
+                return {
+                    valid: false,
+                    message: `WhatsApp driver must be one of: ${validDrivers.join(", ")}`,
+                    expected: validDrivers.join(" | "),
+                    received: value,
+                };
+            }
+            return { valid: true };
+        },
+    },
+    {
+        path: "notification.push.driver",
+        validate: (value) => {
+            if (value === undefined)
+                return { valid: true };
+            const validDrivers = ["firebase", "apns", "custom"];
+            if (!validDrivers.includes(value)) {
+                return {
+                    valid: false,
+                    message: `Push driver must be one of: ${validDrivers.join(", ")}`,
+                    expected: validDrivers.join(" | "),
+                    received: value,
+                };
+            }
+            return { valid: true };
+        },
+    },
+];
+/**
+ * Get a value from an object using dot notation path
+ */
+function getValueByPath(obj, path) {
+    const parts = path.split(".");
+    let current = obj;
+    for (const part of parts) {
+        if (current === null || current === undefined) {
+            return undefined;
+        }
+        if (typeof current !== "object") {
+            return undefined;
+        }
+        current = current[part];
+    }
+    return current;
+}
+/**
+ * Validate config using default rules
+ */
+export function validateConfigDefaults(config) {
+    const errors = [];
+    const warnings = [];
+    for (const rule of DEFAULT_RULES) {
+        const value = getValueByPath(config, rule.path);
+        const result = rule.validate(value, config);
+        if (!result.valid) {
+            errors.push({
+                message: result.message || "Validation failed",
+                path: rule.path,
+                expected: result.expected,
+                received: result.received,
+            });
+        }
+    }
+    // Add warnings for potentially missing critical config
+    if (!config.database?.url && !process.env.DATABASE_URL) {
+        warnings.push({
+            message: "No database URL configured",
+            path: "database.url",
+        });
+    }
+    if (config.cache?.driver === "redis" &&
+        !config.cache.url &&
+        !process.env.REDIS_URL) {
+        warnings.push({
+            message: "Redis cache driver selected but no Redis URL configured",
+            path: "cache.url",
+        });
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+/**
+ * Validate configuration
+ * Supports both Standard Schema and default validation rules
+ */
+export async function validateConfig(config, schema) {
+    // If a schema is provided, use it
+    if (schema && isStandardSchema(schema)) {
+        return validateWithSchema(config, schema);
+    }
+    // Otherwise, use default validation
+    return validateConfigDefaults(config);
+}
+/**
+ * Validate configuration synchronously
+ * Note: Standard Schema validation may be async, so this only works with default rules
+ */
+export function validateConfigSync(config) {
+    return validateConfigDefaults(config);
+}
+/**
+ * Create a validation error with helpful message
+ */
+export function createConfigError(result) {
+    if (result.errors.length === 0) {
+        return {
+            message: "Unknown validation error",
+        };
+    }
+    // Return the first error with context
+    const firstError = result.errors[0];
+    return {
+        message: firstError.message,
+        path: firstError.path,
+        expected: firstError.expected,
+        received: firstError.received,
+    };
+}
+/**
+ * Format validation errors for display
+ */
+export function formatValidationErrors(errors) {
+    if (errors.length === 0) {
+        return "No errors";
+    }
+    const lines = errors.map((error, index) => {
+        let line = `${index + 1}. ${error.message}`;
+        if (error.path) {
+            line += ` (at ${error.path})`;
+        }
+        if (error.expected) {
+            line += `\n   Expected: ${error.expected}`;
+        }
+        if (error.received !== undefined) {
+            line += `\n   Received: ${JSON.stringify(error.received)}`;
+        }
+        return line;
+    });
+    return `Configuration validation failed:\n${lines.join("\n")}`;
+}
+/**
+ * Assert that configuration is valid
+ * Throws an error if validation fails
+ */
+export async function assertValidConfig(config, schema) {
+    const result = await validateConfig(config, schema);
+    if (!result.valid) {
+        const errorMessage = formatValidationErrors(result.errors);
+        throw new Error(errorMessage);
+    }
+    // Log warnings
+    if (result.warnings.length > 0) {
+        for (const warning of result.warnings) {
+            console.warn(`Config warning: ${warning.message}${warning.path ? ` (at ${warning.path})` : ""}`);
+        }
+    }
+}
+/**
+ * Add custom validation rules
+ */
+export function createCustomValidator(rules) {
+    return (config) => {
+        const errors = [];
+        for (const rule of rules) {
+            const value = getValueByPath(config, rule.path);
+            const result = rule.validate(value, config);
+            if (!result.valid) {
+                errors.push({
+                    message: result.message || "Validation failed",
+                    path: rule.path,
+                    expected: result.expected,
+                    received: result.received,
+                });
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings: [],
+        };
+    };
+}
+//# sourceMappingURL=validation.js.map

package/dist/config/validation.js.map

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

package/dist/container/forward-ref.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Forward Reference for Circular Dependencies
+ *
+ * Provides a way to resolve circular dependencies by deferring the resolution
+ * of a dependency until it's actually needed. This allows two or more services
+ * to depend on each other without causing infinite loops during instantiation.
+ */
+/**
+ * Forward reference container for lazy resolution of circular dependencies.
+ *
+ * @template T - The type of the referenced value
+ *
+ * @example
+ * ```typescript
+ * // Creating a forward reference
+ * const ref = forwardRef(() => ServiceB);
+ *
+ * // Using with @Inject decorator
+ * @Injectable()
+ * class ServiceA {
+ *   constructor(
+ *     @Inject(forwardRef(() => ServiceB))
+ *     private serviceB: ServiceB
+ *   ) {}
+ * }
+ * ```
+ */
+export interface ForwardRef<T> {
+    /**
+     * The unique symbol identifying this as a ForwardRef
+     */
+    readonly __forwardRef: unique symbol;
+    /**
+     * Factory function that returns the actual value when called.
+     * This is invoked lazily when the dependency is first accessed.
+     */
+    forwardRef: () => T;
+}
+/**
+ * Create a forward reference for circular dependency resolution.
+ *
+ * The provided factory function is called lazily when the dependency
+ * is actually resolved, allowing the referenced class to be defined
+ * later in the module loading process.
+ *
+ * @template T - The type of the referenced value
+ * @param fn - Factory function that returns the actual token or value
+ * @returns A ForwardRef object that can be used with @Inject()
+ *
+ * @example
+ * ```typescript
+ * // service-a.ts
+ * @Injectable()
+ * export class ServiceA {
+ *   constructor(
+ *     @Inject(forwardRef(() => ServiceB))
+ *     private serviceB: ServiceB
+ *   ) {}
+ *
+ *   doSomething() {
+ *     return this.serviceB.help();
+ *   }
+ * }
+ *
+ * // service-b.ts
+ * @Injectable()
+ * export class ServiceB {
+ *   constructor(
+ *     @Inject(forwardRef(() => ServiceA))
+ *     private serviceA: ServiceA
+ *   ) {}
+ *
+ *   help() {
+ *     return 'helping';
+ *   }
+ * }
+ * ```
+ */
+export declare function forwardRef<T>(fn: () => T): ForwardRef<T>;
+/**
+ * Type guard to check if a value is a ForwardRef.
+ *
+ * @param value - The value to check
+ * @returns True if the value is a ForwardRef, false otherwise
+ *
+ * @example
+ * ```typescript
+ * const ref = forwardRef(() => MyService);
+ * if (isForwardRef(ref)) {
+ *   const actualToken = resolveForwardRef(ref);
+ * }
+ * ```
+ */
+export declare function isForwardRef(value: unknown): value is ForwardRef<unknown>;
+/**
+ * Resolve a forward reference to its actual value.
+ *
+ * If the provided value is a ForwardRef, this function calls its
+ * factory function to get the actual value. If it's not a ForwardRef,
+ * the value is returned as-is.
+ *
+ * @template T - The expected type of the resolved value
+ * @param ref - Either a ForwardRef or a direct value
+ * @returns The resolved value
+ *
+ * @example
+ * ```typescript
+ * const token = Token<ServiceB>('ServiceB');
+ * const ref = forwardRef(() => token);
+ *
+ * // Resolves to the token
+ * const actualToken = resolveForwardRef(ref);
+ * ```
+ */
+export declare function resolveForwardRef<T>(ref: ForwardRef<T> | T): T;
+//# sourceMappingURL=forward-ref.d.ts.map

package/dist/container/forward-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forward-ref.d.ts","sourceRoot":"","sources":["../../src/container/forward-ref.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC5B;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,OAAO,MAAM,CAAC;IAErC;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC,CAAC;CACpB;AAOD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAKxD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAAC,OAAO,CAAC,CAQzE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAK9D"}